Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
wiki:editor_notes [2008/11/12 19:12] – preliminary clean-up - to be continued holgerwiki:editor_notes [2013/06/02 13:45] (current) – external edit 127.0.0.1
Line 3: Line 3:
 Editing page content is easy. Please follow the notes above the edit-toolbar (when editing a page) to get you started with dokuwiki. 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. +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. +There is a template of meta-information that we'd like you to fill in. The wiki page can extend as needed.
  
-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.+<note tip> 
 +If you don't know where to start, the [[wiki:editors_lounge|Editors Lounge]] should provide some hints on what needs to be done.
  
-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.  +You could also fulfill some [[wiki:request|user requests]]. 
- +</note>
-The category page corresponding to a tag is **not** automatically generated, but has a generate-template (just click create and save). - look up [[:apps:index|existing category tags]] and extend this list by hand editing after inventing new tags! (this last step will soon be automated.)+
  
 ===== Meta-Information ===== ===== Meta-Information =====
- +The meta-information is used to classify entries and provide specific layout independant information 
-  * 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 should be straight forward to fill in or update most meta links like ''title'', ''desc''(-ription), ''screenshot'', ''link'', ''author'' etc. 
-  * 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.+  * ''Meta:version'': latest //stable// version number 
 +  * ''Meta:releasedate'': 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).  Format: ''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.
  
 ===== Tags ===== ===== Tags =====
  
-Tags are use for navigation, link-structure and feature-display+Tags are use for navigation, link-structure and feature-display. 
 +Tags form categories, the members of which are listed in ''apps/categories///name_of_tag//'', e. g. [[apps:categories:snd]]
  
-Assigning tags is still tricky+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. 
  
-  * every entry can have multiple tags (space separated). +  * every entry can have multiple tags (space separated)
   * cut and paste [[:apps:index|category]] names (feel free to add tags not listed there if you see a need for them)   * cut and paste [[:apps:index|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 +  * use underscores within one tag, use space to separates tags: ''%% {{tag>first_tag second_tag and_a_third forth}} %%'' 
-  * there are some tags which indicate specific features of an application: +  * look up [[:apps:index|existing category tags]] and extend this list by hand editing after inventing new tags (this last step will soon be automated) 
-     * [[apps:categories:jack|JACK]]: JACK-support +    * the category page corresponding to a tag is **not** automatically generated, but has a generate-template (just click create and save). 
-     * [[apps:categories:JACK_Transport|JACK_Transport]]: support for JACK Midi-Transport +
-     * [[apps:categories:JACK_MIDI|JACK_MIDI]]: support for the JACK Midi Interface +
-     * [[apps:categories:DSSI|DSSI]] +
-     * [[apps:categories:LV2|LV2]] +
-     * [[apps:categories:LADSPA|LADSPA]] +
-     * [[apps:categories:Multitrack|Multitrack]] +
-     * etc.+
  
 ===== Creating new entries ===== ===== Creating new entries =====
Line 42: Line 37:
 ==== Bookmarklet - the easy way ==== ==== Bookmarklet - the easy way ====
  
-There is the possibility to use [[site:bookmarklet|this bookmarklet]] to submit new apps more comfortably.+There is the possibility to use [[wiki:bookmarklet|this bookmarklet]] to submit new apps more comfortably.
  
 ==== Manual approach ==== ==== Manual approach ====
  
-  * All applications or projects have their own wiki page in ''/apps:all:''//name//+  * All applications or projects have their own wiki page in ''/apps:all://name//''
   * choose a name for the application   * choose a name for the application
-  * visit the ''/apps:all:''//name// directly (e. g. [[http://apps.linuxaudio.org/apps/all/nonexistant_page]])+  * 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:   * edit the page to create it - we have a button for that, too:
 {{NEWPAGE>apps:all|newpagetemplate=:site:lappstemplate&newpagevars=@TAG@,new}} {{NEWPAGE>apps:all|newpagetemplate=:site:lappstemplate&newpagevars=@TAG@,new}}
wiki/editor_notes.1226517168.txt.gz · Last modified: by holger