Wiki Syntax

For documenting with a DokuWiki you will need to learn some basic syntax with which you can format your text documents. We have summarized the most important options for you here. If you want additional options you can look at the complete syntax summary |here.

Within a page, you can organize the information using headings of different levels, just think of chapters, sections, subsections, and paragraphs. By default, headings up to level 3 will be included into the table of contents that is shown at the top of the page. The syntax to generate a heading is simple. A level 1 heading (top level) is generated by placing your heading text between two runs of six equal signs

====== YOUR L1 HEADING ======

Lower ranking headings are generated the same way, just decrease the number of equal signs. Please make sure, that your headings are not too long.

One further option to structure the information is the text format. For example, you have seen above, that we often place information into code blocks. Note, if you place text in a code block, WIKI syntax will not be interpreted, and you see the information as you have typed it. Use the following syntax

''
Enter here your text that should appear in a grey box

''

Once you have spread information across different pages (and probably also across the internet), a creative use of Links can make your DokuWiki a comprehensive knowledge base. We distinguish internal links, i.e. links to pages within the same DokuWiki and external links to any website. See some examples below:

• internal link

  [[:start|internal link]]

• external link

  [[http://www.uni-frankfurt.de|external link]]

• interwiki link (link to the Wikipedia article about Acinetobacter baumannii)

  [[wp>wiki|interwiki link]]

Creating tables in a DokuWiki is straightforward. Cells in a table are just separated by a '|' character. If you want to indicate a cell as a header, just prepend the information with a '^' instead of the '|'.

^   ^Heading1 ^Heading2 ^Heading3 |
^Row1|Value1.1|Value1.2|Value1.3|
^Row2|Value2.1|Value2.2|Value2.3|

DokuWikis have a couple of advantages over traditional paper-based documentations of your work. These are, among others

1. The DokuWiki is easy to use
2. Exhaustive documentation is possible via copy and paste
3. Broad range of text formatting options
4. Extendable via Plugins
5. Subordinate information can be hidden

   WikiCode

   WikiCode

   <hidden WikiCode>
   Display some information only when the user clicks on the words WikiCode
   </hidden>

1. Numbered lists can

   1. help
   2. you
   3. structure
   4. things

      HowToContinueNumbering

      HowToContinueNumbering

      See HERE if your numbering breaks due to intervening images, code, and the like.

   1. exhaustively

   WikiSyntax

   WikiSyntax

     - Numbered lists can<WRAP>
       - help
       - you
       - structure
       - things<WRAP>
   <hidden HowToContinueNumbering>
   See [[general:dokuwiki:wiki_issues#How_to_continue_a_numbered_list|HERE]] if your numbering breaks due to intervening images, code, and the like.
   </hidden>
   </WRAP>
       - exhaustively

1. Text formatting enhances the information transfer

   WikiCode

   WikiCode

   <color blue>Text formatting</color>

   The use of

   <color>...</color>

   requires the plugin color

1. Text can be bold face, italics, bold face italics

   WikiCode

   WikiCode

   Text can be **bold face**, //italics//, **//bold face italics//**

1. Entire code blocks (relevant for bioinformaticians) can be integrated via copy and paste

forloop.sh

for i in `ls`; do echo $i; done

<file bash forloop.sh>
for i in `ls`; do echo $i; done
</file>

1. cross-linking of information via internal links and exernal links is simple

   WikiCode

   WikiCode

   **cross-linking of information via [[:start|internal links]] and [[http://www.dokuwiki.org|exernal links]] is simple**

1. organize and re-organize information using section headings, pages, and links
2. The Media Manager makes the integration of all kinds of media straightforward.
3. Integration of Media into a page is straightforward (Figure 1). Note, the integration of media requires that they first have been uploaded via the Media Manager.

   

   WikiCode

   WikiCode

   **media integration is straightforward** (Figure {{ref>AB}}).
   <figure AB>
   {{:howto:abaumannii.png?200 |}}
   <caption>
   EM Image of //A. baumannii//
   </caption>
   </figure>

1. Information sharing among members of a working group is simple
2. Revisions allow to move back to older versions of the WIKI
3. Change history allows to monitor who changed when a particular page (see bottom right of the page)
4. Backups increase data security
5. Task assignment using the do plugin in combination with the sqlite plugin

   Retire (Assigned to ingo. Due on 2035-05-30)

   Code

   Code

   <do 2035-05-30 ingo>Retire</do>

   1. Placing text with an indent

      This is the indented Text

      WikiCode

      WikiCode

      Placing text with an indent<WRAP>
      <wrap indent>This is the indented Text</wrap>
      </WRAP>

   Obviously, we can show here only a small set of the things that can be done with a DokuWiki. For a more comprehensive overview of the wiki syntax follow this LINK. Feel also free to search the available plugins for further inspirations of how to extend the functionality of a dokuwiki.

   ---

   Disadvantages

   Of course, there are also few drawbacks that come along with using a WIKI

   • You need a computer, and when you access a WIKI via the web, you need an active internet connection
   • Unsaved changes will be lost once you leave the page (or the computer crashes)
   • Web-based access represents a security risk
   • WIKI-set up not straightforward for everybody
   • If you mix editing with the simple DW editor (you have to write the wiki syntax on your own) and with the CKG editor (this is an editor that looks a bit like what you are used to when working with MSOffice), DokuWiki can do funny things. Essentially, it can start to mix the Wiki syntax, which is considerably easy to learn, with way more complex html code.