This is a sample template implementing some of the basic styling used on the ONOS wiki. This page is meant to be viewed from the editor so that someone trying to write a page can see the macros and settings that they use. From the editor, double click on any macro to see its settings.
The Table of Contents (ToC) macro is placed near the beginning of the page. It is set to MaxLevel=3, meaning only section headings formatted with up to Heading 3 are included in it.
Major sections are started off with a header formatted with Heading 2 sizing. Subsections will use higher heading levels (Heading 3, Heading 4, and so on)
Like this subsection.
Notice how the subsection title of Heading 3 sizing shows up indented under 'Overview' in the ToC.
And this sub-subsection in Heading 4
Also note how the higher heading sizes aren't captured by the ToC macro, as it has been limited to Heading 3.
Content copied/pasted from a CLI, or bits of code, are added in Code Blocks set to language=text (Syntax highlighting set to 'Plain Text' in the setting dropdown) if syntax highlighting isn't desired.
For large blocks of code, the Code Block can be made collapsible by checking the 'Collapsible' field in its setting, which adds a dropdown that can be clicked to display the full contents:
Images can be added from Insert more Content (the '+') > Image.
A larger image or figure's size is also usually adjusted to about 650px wide by entering a custom size. The settings can be accessed by clicking on the image after it's added.
The list macro is probably the easiest to use if each item is a single line of text. If images, macros, or multiple lines are involved, it can get finicky (e.g. start numbering again from 1). Some tips are:
- Add a line. Hitting enter creates a new bullet or numbered entry.
- If another line is needed under the same number, hit shift+enter
to get to the
next line to prevent it from being numbered or bulleted.
- Repeating shift+enter will continue adding newlines under the current bullet or number.
Macros and images added under a newline created by shift+enter will also be indented.
shift by itself will indent the list. The same technique with shift+enter works for indented portions of a list, with a matching level of indentation.
The list implicitly ends when enter is hit twice.
Any links back to the parent, previous, or next page in the guide book are added as a footer with centered links, between two Horizontal Rule lines, as below: