Table of Contents

Getting started Creating/Editing Pages in this Wiki

Note: Creating and editing content on this site is restricted to ASI. Please contact ASI if like you would like to request additions to the documentation or report errors.

Creating a New Page

Organizing the Wiki

Style Guide

For second person should I use “we” or “you”? Should I use active voice or passive voice? When in doubt refer to the Google Style Guide. Its free and accessible, written with technical subject in mind.

CE Compliance

To Comply with CE we need to provide user with safety notices, and where possible define them to the user. This is the Safety Notices page. It can be included in your page with the following syntax. These icons are available on the toolbar as Wrap Plugin ()

{{page>safety_notices}}

Safety Notices

This user documentation contains safety notices (Warning, Caution, Notice, etc) concerning the safe use of the product. See definitions below.

Warning: Indicates a hazardous situation which, if not avoided, could result in death or serious injury. It is important not to proceed until all stated conditions are met and clearly understood.

Caution: Indicates a hazardous situation which, if not avoided, could result in minor or moderate injury. It is important not to proceed until all stated conditions are met and clearly understood.

Notice: Indicates instruction that must be followed to avoid damage to the product or other equipment.

Note: A note is used to indicate information that is important for trouble-free and optimal use of the product.

Tip: A tip contains useful information that can improve or optimize your procedures.

Formatting Syntax

Default DokuWiki syntax can be found here Formatting Syntax

Below are some custom syntax we added to this particular wiki.

Serial Block

Here are some options to display Serial commands on your page.

<asi> $ MOVE X=123 Y=-123
:A</asi>

Line beginning with $ is Typeset as command , and lines without $ is typeset as reply.

MOVE X=123 Y=-123
:A

This syntax can be gotten by pressing button also.

<wrap cmd> SERIAL COMMAND </wrap>

SERIAL COMMAND

This syntax can be gotten by pressing button also.

<wrap reply> SERIAL REPLY </wrap>

SERIAL REPLY

This syntax can be gotten by pressing button also.

Math

We have the DokuWiki MathJax plugin installed in this wiki.

\begin{equation}R = \frac{(n_1 – n_2)^2}{(n_1 + n_2)^2}\end{equation}

\begin{equation}R = \frac{(n_1 – n_2)^2}{(n_1 + n_2)^2}\end{equation}

This syntax can be gotten by pressing button also.

For more MathJax syntax visit www.onemathematicalcat.org

More info here

Tags

{{tag>tag_name}}

This syntax can be gotten by pressing button also.

More info here

Table

Give tables the ability to sort, search etc by adding the following syntax

<datatables></datatables>

More info here

Include

Include another wiki page into the current one. More info here

Collapsible sections

The Outliner Plugin used to add collapsible sections to a wiki page.

--> Nested section opened#

Nested content

<--

Nested section opened
Nested content

Used extensively in Command:AFLIM

More info here

Imagebox Plugin

By Default, DokuWiki doesn't show Captions for images. Example:

{{ :logo.png |ASI's Logo}}

ASI's Logo

The Imagebox plugin lets is add [] around the image syntax to show image caption.

[{{ :logo.png |ASI's Logo}}]

ASI's Logo

More info here

Mermaid Charts

The Mermaid plugin uses Mermaid to support many different kinds of charts and graphs.

graph TD A[Enter Chart Definition] --> B(Preview) B --> C{decide} C --> D[Keep] C --> E[Edit Definition] E --> B D --> F[Save Image and Code] F --> B