howto

# DokuWiki for Pharos-Library

This is a quick guide how to use DokuWiki for Pharos Library. You can test codes using the Playground. For more details, have a look at Dokuwiki, in particular https://www.dokuwiki.org/page and https://www.dokuwiki.org/wiki:syntax.

## Edit a page

To edit a page, you can either click on the small buttons “Edit” (to edit a section), or click on the pencil on the right hand side to edit the whole page.

## Create a new page

Simply put your new keyword (for example “Liouville equation”) in the search bar (in the top right corner). You should get the message “You can find the results of your search below. If you didn't find what you were looking for, you can create or edit the page”. Then click on the red text to create a new page with your keyword.

## Basic content

Here is the basic structure of an entry of the Pharos Library. Copy the text and fill in some details. You can get inspiration on concepts which already exist and look on their source code.

''A short slogan'' (optional)

Short description of the concept

===== Material =====

* Put here the document you want to add to our library

===== Related concepts =====

* related concept

Edit the page where you want to put an image. Then click on the “add pictures” button (a small painting), upload your file and click on “Done”. Then select your image and choose its position, size etc.

A typical example looks like {{:picture.png?200 |Caption text}} . The file is picture.png, its size 200 pixel. The caption text is only visible when the user puts the mouse on the image.

To get a visible caption, just put square brackets: [{{:picture.png?200 |Caption text}}] . This creates a box around the image.

## Math and formulas

We use the plugin MathJax. You can use basic LaTeX formulas, within dollar signs in the text and within double dollar signs for display mode. Don't use commands requiring fancy usepackages.

Example: Consider the function $f: x\mapsto x^2$. We then get $$f' : \left \{\begin{array}{cl} \mathbb{R} \to \mathbb{R} \\ x\mapsto 2x \end{array}\right.$$ Look at the source code to see how these formulas work.

## Create boxes, multiple columns, tables

Use the functionnalities of the Plugin “Wrap”, see https://demo.selfthinker.org/plugin:wrap.

## Change text size, font, color

Use the functionnalities of the Plugin “Typography”, see https://www.dokuwiki.org/plugin:typography.

## How to add a Plugin?

You have to be an administrator. Go to “Admin”, then “Extention Manager”, then “Search and Install”. Type the name of the plugin you want to install.

## Don't find what you want?

Search online with “DokuWiki [describe what you want to do]”. Probably you will find a plugin which can be used to do what you want. If you are not an administrator, write an email to contact at pharos-library.com to ask for the installation of the plugin.