User Tools

Site Tools


webteam:draft_guidelines

This is an old revision of the document!


Draft Wiki Guidelines

IMPORTANT! Namespaces!

If you add new schematics, content, tutorials etc, please make sure you put these in their own namespace. Otherwise you will flood the current namespace and maintaining uploaded files will become a mess for the users.

Usually, when you add a link to a page-to-be, you want to add your own namespace too.

You do this by using colons, and if you start your "namespacing" with a dot '.' you make the namespace relative to the current pages namespace, which is standard.

Example: Imagine that you are editing the main Tutorials page and want to add your own tutorial called "How to make a noise". You should then link to it by using the pagename ".How to make a noise:How to make a noise" Such a name (inside a normal internal link) would put the page under the Tutorials:How to make a noise-namespace, and all your uploaded files etc would also end up here.

Please please please try to maintain a good namespace structure, it's really hard to correct it when the error already has been made.

More info: http://wiki.splitbrain.org/wiki:namespaces

Syntax and formatting

First have a look at the wiki syntax.

Try to keep formatting as clean as possible. A pages main title heading should be in H1, headings under that H2, headings under H2's should be H3 etc. Don't use horizontal rulers unless necessary (for instance they are not necessary if there's a heading right above or beneath where you want to mark a "new section").

Example of what a small page could look like, using namespaces for sub pages etc:

====== This is the page ======

And this is the description of this page, regarding what you can find and add here etc.
Remember to use sub pages, and especially namespaces, where appropriate.

===== The first section =====

[[.Another Page:Another Page]]

===== The second section =====

[[.Yet Another Page:Yet Another Page]]

Images

You might want to include rather big screenshots within your articles, but having them displayed full size directly inside the article can make things look bad. Fortunately you can resize the image directly within the article. You can also set the alignment of the picture, examples:

Resize to given width:

{{wiki:dokuwiki-128.png?50}}

And left/center/right alignment like this:

{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}

See images and other files for more info.

Code

You can insert code using the 'code' tag, like this:

<code c> float a; </code>
float a; 
float b;
a = b * 10 + 2 * sin1(x);

There's no specific code syntax highlighting.

Spell Check

Please spell check your work, either with UK or USA English; many visitors do not have English as their primary language.

webteam/draft_guidelines.1300822461.txt.gz · Last modified: 2022/02/10 13:34 (external edit)

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki

© 2008-2022 GPLS and others. Evergreen is open source software, freely licensed under GNU GPLv2 or later.
The Evergreen Project is a U.S. 501(c)3 non-profit organization.