/usr/share/SuperCollider/HelpSource/Guides/UsingExtensions.schelp is in supercollider-common 1:3.6.3~repack-5.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 | title:: Using Extensions
summary:: Using Extensions
categories:: Internals
related:: Guides/WritingUGens, Guides/UsingQuarks, Guides/WritingClasses
SC supports extensions to its class library, documentation, and server UGen plugins. Extensions should be packaged as a
single folder containing all three (for convenient addition or removal), or any combination, which can then be placed in
platform-specific extension directories in order to be included.
section:: Platform Specific Directories
You can install extensions simply by copying the extensions to the following location. There are different directories
for per-user and system-wide extensions that apply to all users.. The locations can be obtained by running
code::Platform.userExtensionDir:: and code::Platform.systemExtensionDir::.
Typical user-specific extensions directories:
table::
## OSX || ~/Library/Application Support/SuperCollider/Extensions/
## Linux || ~/.local/share/SuperCollider/Extensions/
::
Typical system-wide extension directories:
table::
## OSX || /Library/Application Support/SuperCollider/Extensions/
## Linux || /usr/share/SuperCollider/Extensions/
::
section:: How Extensions Folders Should be Organised
Class files and UGen plugins are recognised by their file extensions. Anything placed within a folder named
teletype::ignore/:: (case insensitive) will be ignored when compiling the class library or loading plugins.
Here is an example folder layout:
teletype::MyExtension::
tree::
## teletype::classes::
tree::
## teletype::myClass.sc::
## teletype::myUGens.sc::
::
## teletype::plugins::
tree::
## teletype::myUGenPlugins.scx::
::
## teletype::HelpSource::
tree::
## teletype::Classes::
tree::
## teletype::MyClass.schelp::
## teletype::MyUGen1.schelp::
## teletype::MyUGen2.schelp::
::
## teletype::Guides::
tree::
## teletype::MyExtensionGuide.schelp::
::
::
::
|