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
- Begin by typing the Namespace and name of the new page into the Search field and search
- Folders in DokuWiki are called namespaces.
- Manuals and Tech Notes do not require a namespace, the CRISP manual uses the name
crisp_manualdirectly. - Commands are in the namespace
commands, see the WHO command for an example.
- In the image below, the namespace is
documentationand the new page name isnew_page_name. - DokuWiki doesn't allow uppercase or whitespace characters in page names.
- DokuWiki then takes you to the search page, and lists all the pages that are similar or relevant. Press the
Create This Pagebutton to create the page.
- Next, DokuWiki creates this page and shows you the Editing interface with a toolbar. Remember to save when done.
Organizing the Wiki
- A Page can have multiple Tags. For example the page CRISP : Continuous Autofocus System has the tags
manualandcrisp - Please give the tag
manualonly to pages that are considered vital for the users to read in order to operate or setup the device. - Another tag that will be common is
tech_note. These pages aren't considered vital for all user to read and are more specific.The following pages are organised withtech_notetag . TN147: Changing Piezo Drive Card's Fast Slow Compensation and Technical Note: CRISP Error Calculation Algorithm - Atm pages that have the
manualortech_notetag will automatically be linked on this Wiki's start page.
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
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
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}}
The Imagebox plugin lets is add [] around the image syntax to show image caption.
[{{ :logo.png |ASI's Logo}}]
More info here
Mermaid Charts
The Mermaid plugin uses Mermaid to support many different kinds of charts and graphs.






