This document is written in dokuwiki.

The markup syntax is described here: https://www.dokuwiki.org/wiki:syntax

Embedded images.

• title after vertical bar
• Use white space to specify alignment: left, right, center.
• size as cgi parameter (after question mark)
• non-supported format as cgi parameter

{{ straight_line.png|Straight Line}}
{{straight_line.png|Straight Line }}
{{ straight_line.png|Straight Line }}
{{straight_line.png?300}}
{{straight_line.png?300x100}}
{{straight_line.svg?300&.png}}

We embed local video files uploaded to the media folder.

• Append ?540 to the filename to set the width.
• Beneath the embedded video, add an external link to the original source.

{{:elon_musk_mechanics.mp4?540 | Elon Musk on Mechanics}}
Video source: Joe Rogan podcast #1609, 12 Feb 2021 
[[https://spotify.com?204230984 | on Spotify]]

Note:

• Use OBS to capture the video (mkv)
• Use Blender to crop (mp4)
• Use https://www.videosmaller.com/ to optimize the filesize (mp4)

Also note:

• We tried to use Handbrake to optimize, but they output the (m4v) format and dokuwiki will not accept that.
• We also tried to embed YouTube videos. They do a great job of optimizing the download, but they insert distracting and irrelevant recommendations and other junk.

For math equations, we use the MathJax extension.

$$ \frac{\Delta f(x)}{\Delta x} = \frac{f(x+h)-f(x)}{(x+h)-(x)} = \frac{f(x+h)-f(x)}{h}$$

For upright text, use \text{hello} instead of \textup{hello}.

Align multiple equations like this:

\begin{align}
x   &= 3       & 10    &abc def\\
xyz &= a_2 b_3 & 1000  &xy\\
12  &= 8y^4           && explain\\
y   &= a_1 b_1        && this\\
\end{align}

\begin{align} x &= 3 & 10 &abc def\\ xyz &= a_2 b_3 & 1000 &xy\\ 12 &= 8y^4 && explain\\ y &= a_1 b_1 && this\\ \end{align}

The ampersands split the section into columns.
The columns alternate between right and left alignment.
Two adjacent ampersands skips a column.

\begin{align} x=1 &\iff y = 72 && \text{\iff} \\ x=2 &\therefore y = 43.2 && \text{\therefore} \\ x=3 &\rightarrow y = 25.92 && \text{\rightarrow} \\ x=4 &\Rightarrow y = 15.552 && \text{\Rightarrow} \\ x &= 30^\circ && \text{^\circ} \\ \end{align}

Edit math equations online here:
https://www.codecogs.com/latex/eqneditor.php

Reference list of math symbols:
https://oeis.org/wiki/List_of_LaTeX_mathematical_symbols#Set_and.2For_logic_notation

\chemfig not supported

For chemical formulas and equations we use the mhchem extension to the MathJax extension.

• Embed chemical notation in the \ce{} tag.
• Use the \require{mhchem} tag once on each page that uses \ce{}.

$$\require{mhchem}$$
$$\ce{H2O}$$
$$\ce{HCl (aq) + NaOH (aq) -> H2O (l) + NaCl (aq)}$$

$$\require{mhchem}$$ $$\ce{H2O}$$ $$\ce{HCl (aq) + NaOH (aq) -> H2O (l) + NaCl (aq)}$$

Edit chemical equations online here: http://visualmatheditor.equatheque.net/VisualMathEditor.html

mhchem reference, pdf

Made possible by plugin yalist, as used in ReStructered Text and Sphinx.

Definition List (deflist)

A list of terms and their definitions. Implemented with html dl, dt, and dd tags.

yalist

A plugin for dokuwiki that implements a definition list syntax

ReStructured Text (ReST)

A document format similar to Markdown, used in Python and Blender documentation.

Sphinx

A python software package that implements ReST.

? Definition List (deflist)
: A list of terms and their definitions.  Implemented with html dl, dt, and dd tags.
? yalist
: A plugin for dokuwiki that implements a definition list syntax
? ReStructured Text (ReST)
: A document format similar to Markdown, used in Python and Blender documentation.
? Sphinx
: A python software package that implements ReST.

Note. After installing the yalist plugin for dokuwiki, we modified the style.css file in the lib/plugin/yal/ directory.

We have these namespaces: Draft, UserGuide, Projects, Videos.

The first page in each namespace has the same name as the namespace and serves as the index page for that namespace. Example drafts:drafts.

In Admin-ACL, set permissions to none for @user and @ALL for namespace “draft”.

The word “Un1ion” cannot be used in a dokuwiki page.

https://www.dokuwiki.org/faq:mod_security