Table of Contents

How to Edit Capri Wiki

Each chapter has an edit button (right of the text), which allows for the editing of the whole chapter. This button will only be visible to authors. At the end of each section is another edit button which will only open the specific section. To create a new chapter navigate to the sidebar. Open any chapter select Backlinks (under edit) choose sidebar. Here, create a new chapter by editing the side bar and wirting [ [ Chaptername ] ]. Save the edit, click on the newly created link and create the page (same location as the edit button). Further reading: https://www.dokuwiki.org/manual

Special Requirements

As this Wiki gets regularly exported to PDF special requirements must be met to ensure easy export of the format.

directory paths

Backslashes in directory paths cause errors in the export. Replace all “\” in the text with “/”

Titles and Captions

Table(tablenumber): and Figure(figurenumber): written in bold will be captured and linked to the next Figure or Table.
Source: under a Table or Figure will be captured in the caption of the Table or Figure.

Tables

Do not use linebreaks (\\) in Tables as this will cause a new line in the PDFtable and will render the table useless.

playground:test1

Convert Word documents to the dokuwiki format

Technical documents on new model developments are often prepared in Word format. To disseminate their information content, those documents can be converted to the dokuwiki format and be included into the CAPRI wiki. This section provides a few tips on how to do the conversion of Word documents.

pandoc -i some.docx - o mydoku -t dokuwiki 
{{:wiki:picture.png?nolink|}}

Equation editing in the wiki

In the doku wiki we are using the a plugin called MathJax (https://www.mathjax.org/) which is parsing equations in TeX math expressions in wiki pages. The plugin use is described here: https://www.dokuwiki.org/plugin:mathjax with some more links. The plug in also includes automatic equation numbering.

\begin{equation}
\text{min} \quad hp=1000 \sum_{1<t<T-1}({y_{t+1}^*-y_{t-1}^*})^2 + \sum_{t}({y_t^*-y_t})^2
\end{equation}
 
\begin{equation}
\left(
    \begin{array}{c}
      n \\
      r
    \end{array}
  \right) = \frac{n!}{r!(n-r)!}
\end{equation}

which is rendered as:

\begin{equation} \text{min} \quad hp=1000 \sum_{1<t<T-1}({y_{t+1}^*-y_{t-1}^*})^2 + \sum_{t}({y_t^*-y_t})^2 \end{equation}

\begin{equation} \left( \begin{array}{c} n \\ r \end{array} \right) = \frac{n!}{r!(n-r)!} \end{equation}

How to write a formular see: https://en.wikibooks.org/wiki/LaTeX/Mathematics

CAPRI documentation as PDF

Necessary Programs:

  1. Any LateXenvironment capable of LuaLaTex e.g. https://www.tug.org/texlive/

Executing the Pythonscript creates the folder “mmddyyCapri”, in which the content of the Wiki gets downloaded. The tex.files get modified to allow for LuaLaTeX PDFexport, to do so open the “mmddyyCapri.tex” in the created directory and choose LuaLaTeX then start PDF generation. Table of content and intradocument references will display correctly after second run of LuaLaTeX. This creates “mmddyyCapri.pdf” in the “mmddyyCapri” directory (the current Wikicontent in PDFformat).

### Known Issues (work in progress)### 1. Longtables can be wider then the page (easiest to adapt manually) 3. Cells with rowbreak are not completly outlined (maybe fix manually, will try to catch in the code) 4. figures only seperated by empty line (in the Wiki) appear beside each other not under, results in wrongly scaled figures.

List of CAPRI manuals in pdf format

Version 2022 January

https://svn1.agp.uni-bonn.de/!/#capri/view/r10002/trunk/gams/biofuel/bio_trendsbf2.gms?line=39