{{+bindTo:partials.standard_nacl_article}}

Examples of ReST markup for chromesite (Document title)

Document structure

A document starts with a Sphinx target which serves as the document name throughout the tree. It can serve as a link target in other documents that want to link to this one (see the Links section below).

Basic markup

In general, follow the rules from http://sphinx-doc.org/rest.html

Some bold text and italic text and fixed-font text. Non marked-up text can follow these immediately by using a backslash: pexes.

For pleasant collaborative editing, please use the accepted coding guidelines: wrap at 80 columns, no tabs, etc.

Quotes (<blockquote>) are created by indenting the paragraph:

Most good programmers do programming not because they expect to get paid or get adulation by the public, but because it is fun to program. – Linus Torvalds

Here’s an en-dash – and an m-dash — too.

Unicode samples

Copyright sign ©, and uacute Ú.

Images

Please use absolute paths (starting with /) for images:

/native-client/images/NaclBlock.png

Definition lists

Can be used to define a group of related terms. Internal formatting is supported within the definition. No special formatting needs to be done for the definition name/title - it’s handled by the chromesite documentation server.

Apple
The apple is the pomaceous fruit of the apple tree, species Malus domestica in the rose family (Rosaceae).
Fig
The common fig (Ficus carica) is a species of flowering plant in the genus Ficus, from the family Moraceae, known as the common fig (or just the fig), anjeer (Iran, Pakistan), and dumur (Bengali).
Pear
The pear is any of several tree and shrub species of genus Pyrus, in the family Rosaceae.

Notes and Admonitions

The documentation server supports special “notes” that are indented and have a background color. We’ll generate them with the Note directive, providing the class explicitly. The class is one of note, caution, warning, special.

Also:

Source code

Here’s source code that will be pretty-printed. It’s just a plain <pre> that presents pre-formatted code with coloring:

#include <iostream>

int main() {
  char c = 'x';
  std::cout << "Hello world\n";
  return 0;
}

For some code (like shell samples), we want to disable pretty-printing:

$ ls | wc
$ echo "hello world"

By default :prettyprint: is 1.

For short inline code, use fixed-formatting like int x = 2;. Note that this won’t get syntax-highlighted and may be line-wrapped, so keep it very short.

Section heading

Here’s a demonstration of heading nesting levels. This is a top-level section in the document. The document title is the first header and it’s delimited by hash signes (#) from above and below.

Subsection heading

Subsection.

Sub-subsection heading

That’s pretty deep...

Sub-sub-subsection heading

It’s probably not the best idea to go this far (renders to <h5>).

Lists

Auto-numbered ordered lists:

  1. One
  2. Two
  3. Three

Manually numbered ordered lists:

  1. One
  2. Two
  3. Three

Unordered (bullet) lists:

Lists can be nested and mixed too:

Tables

The full scoop on tables is http://sphinx-doc.org/rest.html#tables and the Docutils pages linked from it.

“Simple tables” require less markup but are limited:

A B A and B
False False False
True False False
False True False
True True True

“Grid tables” are versatile but require more markup:

Header row, column 1 (header rows optional) Header 2 Header 3 Header 4
body row 1, column 1 column 2 column 3 column 4
body row 2 ... ...  
{{/partials.standard_nacl_article}}