Notes for Editors

Editing page content is easy. Please follow the notes above the edit-toolbar (when editing a page) to get you started with dokuwiki.

Most entries are still barebone meta-information (only visible in box or index) with little extras, or few comments.

It should be straight forward to fill in or update meta-tags like screenshot, link, author, etc. and extend the wiki-page with information.

The meta-tag releasedate should contain the release date of the latest version for a project or the date of the last update for a document (e. g. an online article). Recommended format is yyyy-mm-dd (e. g. 2008-11-31). Please add this information to give other users a hint on how old a specific information/app is.

Re-assigning tags is not as easy as we would like to have! At the moment new categories are generated by using a new tag in any wiki page.

The category page corresponding to a tag is not automatically generated, but has a generate-template (just click create and save). - look up existing category tags and extend this list by hand editing after inventing new tags! (this last step will soon be automated.)

• there is a template of meta-information that we'd like you to fill in and the wiki page can extend as needed.

• each meta entry is unique (eg. there can be only one screenshot per entry.)! It is used to classify entries and provide specific layout independant information.

Tags are use for navigation, link-structure and feature-display

Assigning tags is still tricky

• every entry can have multiple tags (space separated).
• cut and paste category names (feel free to add tags not listed there if you see a need for them)
• use underscores within one tag, use space to separates tags
• there are some tags which indicate specific features of an application:
  • JACK: JACK-support
  • JACK_Transport: support for JACK Midi-Transport
  • JACK_MIDI: support for the JACK Midi Interface
  • DSSI
  • LV2
  • LADSPA
  • Multitrack
  • etc.

There is the possibility to use this bookmarklet to submit new apps more comfortably.

• All applications or projects have their own wiki page in /apps:all:name
• choose a name for the application
• visit the /apps:all:name directly (e. g. http://apps.linuxaudio.org/apps/all/nonexistant_page)
• edit the page to create it - we have a button for that, too:

• add tags and meta information as described above

Clear the page to delete it, but consider a redirect if:

• the page could be referenced by other pages
• the page name is an alternative name or shortcut for a project (e. g. clm for Common Lisp Music)

Clear the page (particularly the tags section could cause confusion) and add:

~~REDIRECT>namespace:page~~

E. g. you'd like to redirect “apps:all:sc3” to “apps:all:supercollider”:

~~REDIRECT>apps:all:supercollider~~

We are considering to use dokuwiki also for comments and blogging, but until we decide so, we encourage to add comments directly to a wiki page under an appropriate heading at the bottom.

use the wiki for suggestions or join discussion about ongoing work there.