
Testing various markup
**********************


Meta markup
===========

*Section author: Georg Brandl*

*Module author: Georg Brandl*


TOC
^^^

* Testing various markup

  * Meta markup

  * Generic reST

    * Body directives

    * Admonitions

  * Inline markup

  * With

  * Tables

  * Figures

  * Version markup

  * Code blocks

  * Misc stuff

  * Index markup

  * Ö... Some strange characters

  * Only directive

  * Any role


Generic reST
============

A global substitution (the definition is in rst_epilog).

   some code

Option list:

-h

help

--help

also help

Line block:

   line1
      line2
         line3
            line4
      line5
   line6
      line7


Body directives
---------------


Title
^^^^^

Topic body.


Sidebar
^^^^^^^

Sidebar subtitle

Sidebar body.

-[ Test rubric ]-

   Epigraph title

   Epigraph body.

   -- Author

   Highlights

   Highlights body.

   Pull-quote

   Pull quote body.

a

b

   with some *markup* inside


Admonitions
-----------

My Admonition: Admonition text.

Note: Note text.

Warning: Warning text.

Tip: Tip text.

Indirect hyperlink targets


Inline markup
=============

*Generic inline markup*

Adding n to test unescaping.

* **command\n**

* *dfn\n*

* guilabel with accelerator and \n

* "kbd\n"

* *mailheader\n*

* **makevar\n**

* *manpage\n*

* *mimetype\n*

* *newsgroup\n*

* **program\n**

* "regexp\n"

* File ‣ Close\n

* File ‣ Print

* "a/*varpart*/b\n"

* "print *i*\n"

*Linking inline markup*

* **PEP 8**

* **Python Enhancement Proposal #8**

* **RFC 1**

* **Request for Comments #1**

* "HOME"

* "with"

* "try statement"

* Admonitions

* here

* there

* My caption of the figure

* My caption of the figure

* my table

* my table

* my ruby code

* my ruby code

* Fig. %s

* Fig. %s

* Table %s

* Table %s

* Listing %s

* Listing %s

* Including in subdir

* ":download:" is tested in includes.txt

* "Python -c option"

* This used to crash: "&option"

Test abbr (abbreviation) and another abbr (abbreviation).

Testing the index role, also available with explicit title.


With
====

(Empty section.)


Tables
======


my table
^^^^^^^^

+------+------------------+------+
| 1    | * Block elems  * | x    |
|      | In table         |      |
+------+------------------+------+
| 2    | Empty cells:     |      |
+------+------------------+------+


empty cell in table header
^^^^^^^^^^^^^^^^^^^^^^^^^^

+-------+--------+
+=======+========+
| 1     | 2      |
+-------+--------+
| 3     | 4      |
+-------+--------+

Tables with multirow and multicol:


Figures
=======

   [image]My caption of the figure

   My description paragraph of the figure.

   Description paragraph is wraped with legend node.

   [image]figure with align option

   [image]figure with align & figwidth option


Version markup
==============

New in version 0.6: Some funny **stuff**.

Changed in version 0.6: Even more funny stuff.

Deprecated since version 0.6: Boring stuff.

New in version 1.2: First paragraph of versionadded.

Changed in version 1.2: First paragraph of versionchanged.Second
paragraph of versionchanged.


Code blocks
===========

my ruby code

   def ruby?
       false
   end

   import sys

   sys.stdout.write('hello world!\n')


Misc stuff
==========

Stuff [1]

Reference lookup: [Ref1] (defined in another file). Reference lookup
underscore: [Ref_1]

See also: something, something else, something more

  Google
     For everything.

* This

* is

* a horizontal

* list

* with several

* items

-[ Side note ]-

This is a side note.

This tests "role names in uppercase".

LICENSE AGREEMENT

Terry Pratchett, Tolkien, Monty Python.

änhlich
   Dinge

boson
   Particle with integer spin.

*fermion*
   Particle with half-integer spin.

tauon
myon
electron
   Examples for fermions.

über
   Gewisse

   try_stmt  ::= try1_stmt | try2_stmt
   try1_stmt ::= "try" ":" suite
                 ("except" [expression ["," target]] ":" suite)+
                 ["else" ":" suite]
                 ["finally" ":" suite]
   try2_stmt ::= "try" ":" suite
                 "finally" ":" suite


Index markup
============

Invalid index markup...

Main


Ö... Some strange characters
============================

Testing öäü...


Only directive
==============


Any role
========

Test referencing to headings and "objects". Also "modules" and
"classes".

More domains:

* "JS"

* "C"

* "myobj" (user markup)

* "n::Array"

* "perl -c"

-[ Footnotes ]-

[1] Like footnotes.
