**This is an old revision of the document!**
part of the GtC documentation
Different editing techniques
We want you as a curator to be able to edit pages most comfortably. This is likely to depend on your past experience editing wikis and similar, if any.
Unlike systems like Google Docs, which allows you to edit things just as you see them,1) DokuWiki and many other similar systems use what is called a “lightweight markup language” for editing, and you switch between viewing and editing. Unfortunately, different lightweight markup languages are different though similar, so you need to take care.
All lightweight markup languages aspire to help us write in plain text what can be translated into a nicely formatted web page (in HTML). Trouble is, there isn't just one way of doing this.
DokuWiki editing
If you don't have any experience, we suggest you make use of the editing toolbar, which appears just above the edit window when you have opened a page to edit. Using the edit toolbar will give you native DokuWiki markup. The notes on following pages will have a section “Menu bar”. As you become familiar, you may find it quicker simply to write in the DokuWiki code.
If you are already experienced with DokuWiki, go right ahead as you are used to!
If this is your preferred approach, skip the rest of this page and you are good to go: see the following pages.
Markdown
If you are familiar with Markdown, but not DokuWiki, we have included a plugin to allow many things to be written in Markdown. On each page below we include a section for people familiar with Markdown, on what you can use and what not.
MediaWiki including Wikipedia
Only read this if you are familiar with MediaWiki syntax.
If you are familiar with using a MediaWiki system, including Wikipedia, again the lightweight markup language is different. If you are also familiar with Markdown, see above; if not, here is a table of the equivalents in MediaWiki and DokuWiki. You can come back here, or see the notes on each of the following pages.
| Syntax Examples | MediaWiki | DokuWiki | result |
|---|---|---|---|
| Internal Link | [[a link]] [[a link|with title]] | [[start]] [[ints:start]] [[ints:start|a long list]] | start ints a long list |
| External Link | [http://example.org The title] | [[http://example.com]] [[http://example.com|With a Title]] |
|
| Headlines | ==Section (level 2)== ===Subsection (level 3)=== ====Sub-subsection (level 4)==== | ====== Level 1 ====== ===== Level 2 ===== ==== Level 3 ==== === Level 4 === == Level 5 == |
|
| Bold Format | '''bold''' | **bold** | bold |
| Italics Format | ''italic'' | //italics// | italics |
| Underline Format | <u>underlined</u> | __underlined__ | underlined |
| Monospace Format | <tt>monospace</tt> | ''monospace'' | monospace |
| Strikethrough Format | <s>strikethrough</s> | <del>strikethrough</del> | |
| Superscript Format | <sup>superscript</sup> | <sup>superscript</sup> | superscript |
| Subscript Format | <sub>subscript</sub> | <sub>subscript</sub> | subscript |
| Images | [[Image:wiki.png]] | {{local.jpg}}, {{http://foo.bar/baz.jpg}} | |
| Aligning Text | <center>Centered</center> | Plugin | |
| Text Indentation | : indented line | N/A | |
| Bulleted Lists | * Bulleted point ** sub-point * another bulleted point | * indented 2 spaces
* indented 4 spaces
* indented two spaces again
| |
| Numbered Lists | # Item 1 ## Item 1.2 # Item 2 | - indented 2 spaces
- indented 4 spaces
- indented two spaces again
| |
| Horizontal Rule | ---- | ---- | |
Note the spaces in front of the * or - characters in DokuWiki syntax for lists. Top level list items have two spaces in front of the list item character; next level have 4 spaces, etc.