Example of HOW-TO

[[mailto:marfin@mail.desy.de][]] :

Dedication

For Docutils users & co-developers.

Abstract

This document is a demonstration of the reStructuredText markup language, containing examples of all basic reStructuredText constructs and many advanced constructs. The topic is relevant for DESY Higgs group

Table of Contents

• 1   Section First (stored in context) * 1.1   Section Title(1)

• 2   Section Second * 2.1   Bullet Lists
• 2.2   Enumerated Lists
• 2.3   Definition Lists

• 3   Section Third * 3.1   Literal Blocks
• 3.2   Block Quotes
• 3.3   Tables

• 4   Section Fourth * 4.1   Citations
• 4.2   Footnotes

• 5   Section Fifth * 5.1   Targets

• 6   Section Sixth * 6.1   More details

That's only EXAMPLE. Please, don't consider it seriously!

   Section First (stored in context)

   Section Title()

Just an example

1 gedit pohl.m
2 ./test.sh
3 printf "%s" "OK"

#include <iostream>
 void test() {
 std::cout<<"test"<<std::endl;
 return ;

 }

1 #include <iostream>
2  void test() {
3  std::cout<<"test"<<std::endl;
4  return ;
5 
6  }

def test():
""" test """
 print "How are you"?

 return

   Section Second

   Bullet Lists

• A bullet list * Nested bullet list.
• Nested item 2.

• Item 2.Paragraph 2 of item 2. * Nested bullet list.
• Nested item 2. * Third level.
• Item 2.

• Nested item 3.

   Enumerated Lists

• Arabic numerals. * lower alpha) * (lower roman) * upper alpha. * upper roman)

• Lists that don't start at 1: * Three
• Four

• C
• D

• iii
• iv

• List items may also be auto-enumerated.

   Definition Lists

TermDefinition

TermclassifierDefinition paragraph 1.

Definition paragraph 2.

TermDefinition

   Section Third

   Literal Blocks

Literal blocks are indicated with a double-colon ("::") at the end of the preceding paragraph (over there -->). They can be indented:

if literal_block:
    text = 'is left as-is'
    spaces_and_linebreaks = 'are preserved'
    markup_processing = None

Or they can be quoted without indentation:

>> Great idea!
>
> Why didn't I think of that?

   Block Quotes

Block quotes consist of indented body elements:

My theory by A. Elk. Brackets Miss, brackets. This theory goes as follows and begins now. All brontosauruses are thin at one end, much much thicker in the middle and then thin again at the far end. That is my theory, it is mine, and belongs to me and I own it, and what it is too.

Anne Elk (Miss)

   Tables

Here's a grid table followed by a simple table:

• contain
• body elements.

|

   Section Fourth

   Citations

CIT2002Citations are text-labeled footnotes. They may be rendered separately and differently from footnotes.

Here's a reference to the above, CIT2002 citation.

   Footnotes

1A footnote contains body elements, consistently indented by at least 3 spaces.

This is the footnote's second paragraph.

2Footnotes may be numbered, either manually (as in 1) or automatically using a "#"-prefixed label. This footnote has a label so it can be referred to from multiple places, both as a footnote reference (2) and as a hyperlink reference (label).

3This footnote is numbered automatically and anonymously using a label of "#" only.

*Footnotes may also use symbols, specified with a "*" label. Here's a reference to the next footnote: *.

†This footnote shows the next symbol in the sequence.

   Section Fifth

   Targets

This paragraph is pointed to by the explicit "example" target. A reference can be found under Section Second, above.

Section headers are implicit targets, referred to by name. See Targets.

Explicit external targets are interpolated into references such as "Python" or such as 4.

4http://www.python.org/

Targets may be indirect and anonymous. Thus this phrase may also refer to the Targets section.

   Section Sixth

   More details

you can find more details here 5 and here 6

5http://docutils.sourceforge.net/docs/user/rst/demo.txt http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.txt http://docutils.sourceforge.net/rst.txt

6http://docutils.sourceforge.net/docs/user/rst/demo.html#inline-markup

Good Luck!