HelpBrowser:
Filter:
Classes | HelpSystem | GUI > Interfaces

HelpBrowser : Object

Browse the SuperCollider help documentation

Description

HelpBrowser is a GUI help browser that lets you browse the documentation of SuperCollider. It is coupled with SCDoc to allow on-the-fly rendering of HTML help files.

There are two different help browsers in SuperCollider: the help browser built into SCIDE, and this HelpBrowser class implemented with sclang's GUI features. Both are implemented with the same underlying Qt WebEngine browser.

Since the Qt WebEngine dependency is hefty and difficult to install on some systems, it is possible for sclang to have been built without WebView support (using the CMake flag -DSC_USE_QTWEBENGINE=OFF at compile). If so, attempting to invoke this class will throw an error.

Class Methods

HelpBrowser.instance

The singleton HelpBrowser instance.

HelpBrowser.new(aHomeUrl, newWin)

Create a new HelpBrowser instance with given home URL.

HelpBrowser.defaultHomeUrl

HelpBrowser.defaultHomeUrl = value

Get or set the default home URL.

HelpBrowser.openNewWindows

HelpBrowser.openNewWindows = value

Get or set the default for "open in new windows" toggle.

HelpBrowser.goTo(url)

Go to url with singleton instance or a new window, depending on the openNewWindows setting.

HelpBrowser.openHelpFor(text)

Open the relevant help page for given text in the singleton HelpBrowser instance.

HelpBrowser.openSearchPage(text)

Open the help search page with given text in the singleton HelpBrowser instance.

HelpBrowser.openBrowsePage(category)

Open the category browser page in the singleton HelpBrowser instance.

Arguments:

category

An optional String to start at specified category, like "UGens>Filters"

HelpBrowser.openHelpForMethod(method)

Open help for specified method.

Arguments:

method

a Method

Inherited class methods

Undocumented class methods

HelpBrowser.front

HelpBrowser.goHome

Instance Methods

.homeUrl

.homeUrl = value

Get or set the home URL.

.window

The GUI window for this HelpBrowser.

Discussion:

Mainly useful for when you need to show the browser:

.goTo(urlString, brokenAction)

Go to specific URL. If the URL points to a file under SCDoc: *helpTargetDir it will be rendered on demand if needed.

.goHome

Go to the home URL.

.goBack

Go back.

.goForward

Go forward.

Inherited instance methods

Undocumented instance methods

.cmdPeriod

.redirectTextFile(url)