Skip to content

User Guide: DokuWiki

Gabriel Vîjială edited this page Dec 21, 2022 · 7 revisions

This is EIC’s collaborative knowledge base that grows stronger with every EIC project.We organise the EIC wiki pages under directories (namespaces) named after the journalistic projects (e.g. Malta Files, Football Leaks etc). All of these have sub-directories named after the production stage (either info or confrontation or replies or drafts).

Sitemap

First thing, please consult the Sitemap (click on the Sitemap link on the upper right corner) for a complete list of our directories/projects. Search to see if there is other information available on the Wikis. Use the search box on the upper right corner. If there is, make a judgement as to whether your information needs a new standalone Wiki page or can be integrated into the existing Wiki page you found. If you want to collaborate under an existing project, you should choose the directory parent project and consult all the sub-wiki pages grouped under that namespace.

Create a new directory

If you want to start a new directory/project, please go to ‘Create a New Page’ bar in Root and add the name of your directory and related page (use the name of your investigative project, e.g. Nameoftheproject:infopage) and hit the ‘Add page’ button.



Your new directory/project will be displayed in the Sitemap list (blue color). The page associated with it will also be displayed (green color).

For example we have the project ‘wassergate’ that has 3 sub-directories:



  • Annotations that signal interesting findings will be centralized in the information subdirectory
  • Before publication, a page containing confrontation questions will be added under the confrontation subdirectory
  • During the pre-publication stage where journalists share their drafts, a drafts subdirectory will be created

Eventually the finalized product will eventually land into the public domain;https://theblacksea.eu/stories/football-leaks/football-leaks-the-dirty-tricks-of-doyen-sports/



How to construct a Wiki page

Use the ‘Create a New Page’ bar. Choose an existing directory or sub-directory to be the parent of your page (eg. projectname). Please don’t create orphans! Once you click the Add page button, you will be promoted to also add content to the page and Save it.

Check the Sitemap (just below the search box on the upper right corner) and see if your newly created page landed under the right directory. To delete a page or a directory, simply edit the page by clicking the pencil icon and remove all the content from the page body, and then hit Save.

Move a page between directories

If by accident the newly created page landed in an erroneous spot, go to the right side of your page and choose ‘Rename Page’.

Change the names of the directories and subdirectories in the url. For instance the page ‘wassergate_questions’ was erroneously added under the drafts subdirectory.

To move the page under confrontation (where it belongs), simply click on the ‘wassergate_questions’ page and go to the Rename button (on the right side of the page).

Type in the correct URL and hit Rename.

Your page will now show up under the right subdirectory.



Wiki pages labels and names

You should name your wiki exactly what it is: a wedding list of someone, a deal of somebody, a structure of a company, a bio for a person etc. That should be reflected in the wiki title. For inspiration go read some wikipedia articles. Each project starts with a project name (eg. Wassergate) and an information directory (wassergate:information) that has a pitch page (description to convince others to join the project).

Confrontation pages should be created after the drafts are done. The confrontation pages should list ALL people and institutions that need to be confronted with written questions before the story is ready. In confrontation pages, each EIC journo should have the time to add his/her questions.

Replies pages are mirrors of confrontation pages, only they include the exact copy/paste of the questions send, in the original language they were sent, as well as the replies, with the time stamp, email used etc

How to edit a Wiki page

For the syntax used to obtain headers, bold, colours etc, please look at the syntax page: https://www.dokuwiki.org/wiki:syntax

Tips for keeping a clean wiki

  • Write at the top of the Wiki who is the owner of that Wiki and their contact details with the name [OWNER:]. Underneath this, write the names of all the people who have contributed to writing this Wiki with their contact details, with the name [CONTRIBUTOR:]
  • Clearly label the provenance of any information in a URL link at the beginning of every relevant paragraph. Using ((text)) you put that text in a footnote.
  • Clearly label whether information is from a source with [SOURCE:] at the beginning of every relevant paragraph.
  • Clearly label whether information is speculation [SPECULATION:] at the beginning of every relevant paragraph.
  • If you want to write a comment on the Wiki, or dispute a piece of information, or believe something is unclear, use annotations - select that sentence and annotate under the specific group or in public (e.g this does not make sense)

The end resulting information wiki page should be a clear sourced information page that can be fact checked by anybody who reads it for the first time.

Access Control, Group Management, Permissions

See this page for administering the access control, permissions and group management here: Admin Guide: Wiki Permissions for Dokuwiki.


Back to our detailed User Guide.

Clone this wiki locally