This page describes the steps required to add your user created SynthMaker content to the wiki. We’ll go through some of the basics and then provide an example of a SynthMaker component being added to the wiki. We hope you already organized your OSM to make it readable, and made the file take as few Kb as possible.
SynthMaker content usually falls under these categories and have had namespaces setup for them accordingly. Please ensure that when you add your page you do so in the correct area and use the correct namespace. There is currently no enforcement policy or mechanism to prevent incorrect namespace usage and it can be bothersome to fix namespace violations after the fact.
|Figure 1. - Namespace Table|
|Type||Description||Top Level Namespace|
|VST/EXE Instruments||SynthMaker VST or EXE||user_creations:instruments:|
|OSM Instruments||SynthMaker OSM||user_creations:instruments:|
Search the WIKI and Forum to ensure there aren’t clones of you .OSM (although a new approach to an old problem is useful, especially when it is faster). Make sure your schematic is readable by strangers who don’t have ESP. To save upload/download/opening time, Reduce the file size as much as you can, removing all unneeded modules. Readme styled documentation may be included in your OSM using a Comment module that includes a short description, uses, warnings, and credits.
This section will describe the process of uploading your piping hot Synthmaker content to the wiki. Details are subject to change but we will endeavor to keep this page up to date. If you notice any omissions feel free to fix them or notify an admin.
Identify your top-level namespace
As you can see in figure 1 we’ve already got a rough idea of what the namespace looks like. Does your component easily fit into it? If so, great! If not it might be a good idea to chat with an admin before establishing a new namespace. For the sake of this tutorial we’ll be using a crossfader component as our example. I think the crossfader could be best categorized as a utility so we’ll create it in the user_creations:utilities: namespace.
Choose your underlying namespace
Since we’ve established that our namespace path will be user_creations:utilities:, we must make a page underneath that namespace. user_creations:utilities:crossfader:crossfader. Why the double name? This allows us to create additional content underneath the user_creations:utilities:crossfader namespace that will be inherently linked. By default we choose the same name for our new page as the namespace it resides under. All content you create for this page should be created underneath this namespace to ensure proper taxonomy.
Create your page
To create a new page, goto the page you wish your page to be created under. For this tutorial that would be the user_creations:utilities:utilities namespace → utilities. Goto the page at the top level of your namespace and edit it using the ‘Edit This Page’ button as indicated in figure 2. This will present you with the wiki-text of the page.
|Figure 2. How to edit?|
|Figure 3. Edit the page|
|Figure 4. Add your link and save|
|Figure 5. Goto your new page and populate it|
As you can see in Figure 3 the format is pretty simple. In Figure 4 we added our new link in for the Crossfader there with a short description of what it does and saved the page. Then on the utilities page utilities a red linked ‘Crossfader’ entry shows that the page is ready to be created. We click the link and are shown the ‘This page does not yet exist’ text. So it’s time to create our new page. In the upper left hand corner click the ‘Create this page’ link and add in the description for your contribution to the wiki. It would help if you followed the style notes.
|Figure 6. Create this page|
|Figure 7. Add your description|
Once you’ve populated your page with the pertienant information its time to upload. This is probably the most confusing part of the process so pay careful attention. On the top of the wiki-code editing box there’s a titlebar with ‘B I U TT S H1 H2 H3’ buttons for formatting. On the right side there’s one that if you squint kind of looks like a picture frame with a pastoral meadow and a little sunset. It’s actually quite a pretty picture of your squint hard enough. That’s how we upload.
|Figure 8. Click the upload button|
|Figure 9. Upload it to the right place!|
As you can see at the top of our upload window the namespace we’re uploading into is :user_creations:utilities:crossfader so we don’t need to make any adjustments. We just select the file and upload it. When complete the file will be available in the upload dialog box. Simply clicking it will include it as a link where ever your cursor currently is in the edit window.
Make sure to upload a screenshot as well so people can know what they’re getting!