How to use the wiki

Homepage

The homepage is default the homepage.md file, this can’t be changed. If this file doesn’t exist create it in de wiki folder.

Plugins (beta)

The plugins are used to extend the functionality of the wiki. Most of them are accessible through the use of tags. For now there are only a few supported.

  • [[draw]] Allows you to add an interactive drawio drawing to the wiki.
  • [[info]], [[warning]], [[danger]], [[success]] Adds a nice alert message.

Latex

It’s possible to use latex syntax inside your markdown because the markdown is first converted to latex and after that to html. This means you have a lot more flexibility.

Change image size

![](https://i.ibb.co/Dzp0SfC/download.jpg){width="50%"}

Image references

![\label{test}](https://i.ibb.co/Dzp0SfC/download.jpg){width="50%"}

Inside picture \ref{landscape picture} you can see a nice mountain.
picture
picture

Clickable reference in picture \(\ref{landscape picture}\).

Math

\begin{align}
y(x) &= \int_0^\infty x^{2n} e^{-a x^2}\,dx\\
&= \frac{2n-1}{2a} \int_0^\infty x^{2(n-1)} e^{-a x^2}\,dx\\
&= \frac{(2n-1)!!}{2^{n+1}} \sqrt{\frac{\pi}{a^{2n+1}}}\\
&= \frac{(2n)!}{n! 2^{2n+1}} \sqrt{\frac{\pi}{a^{2n+1}}}
\end{align}

\[\begin{align} y(x) &= \int_0^\infty x^{2n} e^{-a x^2}\,dx\\ &= \frac{2n-1}{2a} \int_0^\infty x^{2(n-1)} e^{-a x^2}\,dx\\ &= \frac{(2n-1)!!}{2^{n+1}} \sqrt{\frac{\pi}{a^{2n+1}}}\\ &= \frac{(2n)!}{n! 2^{2n+1}} \sqrt{\frac{\pi}{a^{2n+1}}} \end{align}\]

You can also use $inline$ math to show $a=2$ and $b=8$

You can also use \(inline\) math to show \(a=2\) and \(b=8\)

And many other latex functions.

Converting the files

Open the wiki folder of your instance.

|- static
|- templates
|- wiki \(\leftarrow\) This folder
|- wiki.py

In this folder all the markdownfiles are listed. Editing the files will be visible in the web-version.

|- homepage.md
|- How to use the wiki.md
|- Markdown cheatsheet.md

The advantage is that u can use the commandline to process some data. For example using pandoc:

$ pandoc -f markdown -t latex homepage.md How\ to\ use\ the\ wiki.md -o file.pdf --pdf-engine=xelatex

This creates a nice pdf version of your article. Its possible you have to create a yml header on top of your document to set the margins etc better

---
title: titlepage
author: your name
date: 05-11-2020
geometry: margin=2.5cm
header-includes: |
        \usepackage{caption}
        \usepackage{subcaption}
lof: true
---

For more information you have to read the pandoc documentation.

Using the version control system


Last modified: Mon Sep 25 23:08:28 2023