329 lines
8.9 KiB
HTML
329 lines
8.9 KiB
HTML
|
<h2>Titles</h2>
|
|||
|
<pre><code>===============
|
|||
|
Section Title
|
|||
|
===============
|
|||
|
|
|||
|
---------------
|
|||
|
Section Title
|
|||
|
---------------
|
|||
|
|
|||
|
Section Title
|
|||
|
=============
|
|||
|
|
|||
|
Section Title
|
|||
|
-------------
|
|||
|
|
|||
|
Section Title
|
|||
|
`````````````
|
|||
|
|
|||
|
Section Title
|
|||
|
'''''''''''''
|
|||
|
|
|||
|
Section Title
|
|||
|
.............
|
|||
|
|
|||
|
Section Title
|
|||
|
~~~~~~~~~~~~~
|
|||
|
|
|||
|
Section Title
|
|||
|
*************
|
|||
|
|
|||
|
Section Title
|
|||
|
+++++++++++++
|
|||
|
|
|||
|
Section Title
|
|||
|
^^^^^^^^^^^^^</code></pre>
|
|||
|
|
|||
|
<h2>Lists</h2>
|
|||
|
<pre><code>- This is the first bullet list item.
|
|||
|
- This is the first paragraph in the second item in the list.
|
|||
|
|
|||
|
This is the second paragraph in the second item in the list.
|
|||
|
|
|||
|
- This is a sublist. The bullet lines up with the left edge of
|
|||
|
the text blocks above.
|
|||
|
|
|||
|
- This is the third item of the main list.
|
|||
|
|
|||
|
This paragraph is not part of the list.
|
|||
|
|
|||
|
1. Item 1 initial text.
|
|||
|
|
|||
|
a) Item 1a.
|
|||
|
b) Item 1b.
|
|||
|
|
|||
|
2. a) Item 2a.
|
|||
|
b) Item 2b.</code></pre>
|
|||
|
|
|||
|
<h2>Field lists</h2>
|
|||
|
<pre><code>:Date: 2001-08-16
|
|||
|
:Version: 1
|
|||
|
:Authors: - Me
|
|||
|
- Myself
|
|||
|
- I
|
|||
|
:Indentation: Since the field marker may be quite long, the second
|
|||
|
and subsequent lines of the field body do not have to line up
|
|||
|
with the first line, but they must be indented relative to the
|
|||
|
field name marker, and they must line up with each other.
|
|||
|
:Parameter i: integer</code></pre>
|
|||
|
|
|||
|
<h2>Option lists</h2>
|
|||
|
<pre><code>-a Output all.
|
|||
|
-b Output both (this description is
|
|||
|
quite long).
|
|||
|
-c arg Output just arg.
|
|||
|
--long Output all day long.
|
|||
|
|
|||
|
-p This option has two paragraphs in the description.
|
|||
|
This is the first.
|
|||
|
|
|||
|
This is the second. Blank lines may be omitted between
|
|||
|
options (as above) or left in (as here and below).
|
|||
|
|
|||
|
--very-long-option A VMS-style option. Note the adjustment for
|
|||
|
the required two spaces.
|
|||
|
|
|||
|
--an-even-longer-option
|
|||
|
The description can also start on the next line.
|
|||
|
|
|||
|
-2, --two This option has two variants.
|
|||
|
|
|||
|
-f FILE, --file=FILE These two options are synonyms; both have
|
|||
|
arguments.
|
|||
|
|
|||
|
/V A VMS/DOS-style option.</code></pre>
|
|||
|
|
|||
|
<h2>Literal blocks</h2>
|
|||
|
<pre><code>::
|
|||
|
|
|||
|
for a in [5,4,3,2,1]: # this is program code, shown as-is
|
|||
|
print a
|
|||
|
print "it's..."
|
|||
|
# a literal block continues until the indentation ends
|
|||
|
|
|||
|
John Doe wrote::
|
|||
|
|
|||
|
>> *Great* idea!
|
|||
|
>
|
|||
|
> Why didn't I think of that?
|
|||
|
|
|||
|
You just did! ;-)</code></pre>
|
|||
|
|
|||
|
<h2>Line blocks</h2>
|
|||
|
<pre><code>| Lend us a couple of bob till Thursday.
|
|||
|
| I'm absolutely skint.
|
|||
|
| But I'm expecting a postal order and I can pay you back
|
|||
|
as soon as it comes.
|
|||
|
| Love, Ewan.
|
|||
|
|
|||
|
Take it away, Eric the Orchestra Leader!
|
|||
|
|
|||
|
| A one, two, a one two three four
|
|||
|
|
|
|||
|
| Half a bee, philosophically,
|
|||
|
| must, *ipso facto*, half not be.
|
|||
|
| But half the bee has got to be,
|
|||
|
| *vis a vis* its entity. D'you see?
|
|||
|
|
|
|||
|
| But can a bee be said to be
|
|||
|
| or not to be an entire bee,
|
|||
|
| when half the bee is not a bee,
|
|||
|
| due to some ancient injury?
|
|||
|
|
|
|||
|
| Singing...</code></pre>
|
|||
|
|
|||
|
<h2>Grid tables and simple tables</h2>
|
|||
|
<pre><code>+------------------------+------------+----------+----------+
|
|||
|
| Header row, column 1 | Header 2 | Header 3 | Header 4 |
|
|||
|
| (header rows optional) | | | |
|
|||
|
+========================+============+==========+==========+
|
|||
|
| body row 1, column 1 | column 2 | column 3 | column 4 |
|
|||
|
+------------------------+------------+----------+----------+
|
|||
|
| body row 2 | Cells may span columns. |
|
|||
|
+------------------------+------------+---------------------+
|
|||
|
| body row 3 | Cells may | - Table cells |
|
|||
|
+------------------------+ span rows. | - contain |
|
|||
|
| body row 4 | | - body elements. |
|
|||
|
+------------------------+------------+---------------------+
|
|||
|
|
|||
|
+--------------+----------+-----------+-----------+
|
|||
|
| row 1, col 1 | column 2 | column 3 | column 4 |
|
|||
|
+--------------+----------+-----------+-----------+
|
|||
|
| row 2 | |
|
|||
|
+--------------+----------+-----------+-----------+
|
|||
|
| row 3 | | | |
|
|||
|
+--------------+----------+-----------+-----------+
|
|||
|
|
|||
|
===== ===== =======
|
|||
|
A B A and B
|
|||
|
===== ===== =======
|
|||
|
False False False
|
|||
|
True False False
|
|||
|
False True False
|
|||
|
True True True
|
|||
|
===== ===== =======
|
|||
|
|
|||
|
===== ===== ======
|
|||
|
Inputs Output
|
|||
|
------------ ------
|
|||
|
A B A or B
|
|||
|
===== ===== ======
|
|||
|
False False False
|
|||
|
True False True
|
|||
|
False True True
|
|||
|
True True True
|
|||
|
===== ===== ======</code></pre>
|
|||
|
|
|||
|
<h2>Footnotes and links</h2>
|
|||
|
<pre><code>.. [1] Body elements go here.
|
|||
|
|
|||
|
If [#note]_ is the first footnote reference, it will show up as
|
|||
|
"[1]". We can refer to it again as [#note]_ and again see
|
|||
|
"[1]". We can also refer to it as note_ (an ordinary internal
|
|||
|
hyperlink reference).
|
|||
|
|
|||
|
.. [#note] This is the footnote labeled "note".
|
|||
|
|
|||
|
Here is a symbolic footnote reference: [*]_.
|
|||
|
|
|||
|
.. [*] This is the footnote.
|
|||
|
|
|||
|
[2]_ will be "2" (manually numbered),
|
|||
|
[#]_ will be "3" (anonymous auto-numbered), and
|
|||
|
[#label]_ will be "1" (labeled auto-numbered).
|
|||
|
|
|||
|
.. [2] This footnote is labeled manually, so its number is fixed.
|
|||
|
|
|||
|
.. [#label] This autonumber-labeled footnote will be labeled "1".
|
|||
|
It is the first auto-numbered footnote and no other footnote
|
|||
|
with label "1" exists. The order of the footnotes is used to
|
|||
|
determine numbering, not the order of the footnote references.
|
|||
|
|
|||
|
.. [#] This footnote will be labeled "3". It is the second
|
|||
|
auto-numbered footnote, but footnote label "2" is already used.
|
|||
|
|
|||
|
Here is a citation reference: [CIT2002]_.
|
|||
|
|
|||
|
.. [CIT2002] This is the citation. It's just like a footnote,
|
|||
|
except the label is textual.
|
|||
|
|
|||
|
.. _hyperlink-name: link-block
|
|||
|
|
|||
|
.. __: anonymous-hyperlink-target-link-block
|
|||
|
|
|||
|
__ anonymous-hyperlink-target-link-block
|
|||
|
|
|||
|
Clicking on this internal hyperlink will take us to the target_
|
|||
|
below.
|
|||
|
|
|||
|
.. _target:
|
|||
|
|
|||
|
The hyperlink target above points to this paragraph.</code></pre>
|
|||
|
|
|||
|
<h2>Directives</h2>
|
|||
|
<pre><code>.. image:: mylogo.jpeg
|
|||
|
|
|||
|
.. figure:: larch.png
|
|||
|
|
|||
|
The larch.
|
|||
|
|
|||
|
.. note:: This is a paragraph
|
|||
|
|
|||
|
- Here is a bullet list.
|
|||
|
|
|||
|
.. figure:: picture.png
|
|||
|
:scale: 50 %
|
|||
|
:alt: map to buried treasure
|
|||
|
|
|||
|
This is the caption of the figure (a simple paragraph).
|
|||
|
|
|||
|
The legend consists of all elements after the caption. In this
|
|||
|
case, the legend consists of this paragraph and the following
|
|||
|
table:
|
|||
|
|
|||
|
+-----------------------+-----------------------+
|
|||
|
| Symbol | Meaning |
|
|||
|
+=======================+=======================+
|
|||
|
| .. image:: tent.png | Campground |
|
|||
|
+-----------------------+-----------------------+
|
|||
|
| .. image:: waves.png | Lake |
|
|||
|
+-----------------------+-----------------------+
|
|||
|
| .. image:: peak.png | Mountain |
|
|||
|
+-----------------------+-----------------------+</code></pre>
|
|||
|
|
|||
|
<h2>Substitutions</h2>
|
|||
|
<pre><code>The |biohazard| symbol must be used on containers used to
|
|||
|
dispose of medical waste.
|
|||
|
|
|||
|
.. |biohazard| image:: biohazard.png
|
|||
|
|
|||
|
|Michael| and |Jon| are our widget-wranglers.
|
|||
|
|
|||
|
.. |Michael| user:: mjones
|
|||
|
.. |Jon| user:: jhl
|
|||
|
|
|||
|
West led the |H| 3, covered by dummy's |H| Q, East's |H| K,
|
|||
|
and trumped in hand with the |S| 2.
|
|||
|
|
|||
|
.. |H| image:: /images/heart.png
|
|||
|
:height: 11
|
|||
|
:width: 11
|
|||
|
.. |S| image:: /images/spade.png
|
|||
|
:height: 11
|
|||
|
:width: 11
|
|||
|
|
|||
|
* |Red light| means stop.
|
|||
|
* |Green light| means go.
|
|||
|
* |Yellow light| means go really fast.
|
|||
|
|
|||
|
.. |Red light| image:: red_light.png
|
|||
|
.. |Green light| image:: green_light.png
|
|||
|
.. |Yellow light| image:: yellow_light.png</code></pre>
|
|||
|
|
|||
|
<h2>Comments</h2>
|
|||
|
<pre><code>.. This is a comment
|
|||
|
|
|||
|
..
|
|||
|
_so: is this!
|
|||
|
|
|||
|
..
|
|||
|
[and] this!
|
|||
|
|
|||
|
..
|
|||
|
this:: too!
|
|||
|
|
|||
|
..
|
|||
|
|even| this:: !</code></pre>
|
|||
|
|
|||
|
<h2>Inline markup</h2>
|
|||
|
<pre><code>This is *emphasized text*.
|
|||
|
This is **strong text**.
|
|||
|
This is `interpreted text`.
|
|||
|
:role:`interpreted text`
|
|||
|
`interpreted text`:role:
|
|||
|
This text is an example of ``inline literals``.
|
|||
|
The regular expression ``[+-]?(\d+(\.\d*)?|\.\d+)`` matches
|
|||
|
floating-point numbers (without exponents).
|
|||
|
|
|||
|
See the `Python home page <http://www.python.org>`_ for info.
|
|||
|
|
|||
|
Oh yes, the _`Norwegian Blue`. What's, um, what's wrong with it?</code></pre>
|
|||
|
|
|||
|
<h2>Known failures</h2>
|
|||
|
<p>There are certain edge cases where Prism will fail.
|
|||
|
There are always such cases in every regex-based syntax highlighter.
|
|||
|
However, Prism dares to be open and honest about them.
|
|||
|
If a failure is listed here, it doesn’t mean it will never be fixed. This is more of a “known bugs” list, just with a certain type of bug.
|
|||
|
</p>
|
|||
|
|
|||
|
<h3>Nothing is highlighted inside table cells</h3>
|
|||
|
<pre><code>+---------------+----------+
|
|||
|
| column 1 | column 2 |
|
|||
|
+--------------+-----------+
|
|||
|
| **bold**? | *italic*? |
|
|||
|
+--------------+-----------+</code></pre>
|
|||
|
|
|||
|
<h3>The inline markup recognition rules are not as strict as they are in the spec</h3>
|
|||
|
<p>No inline markup should be highlighted in the following code.</p>
|
|||
|
<pre><code>2 * x a ** b (* BOM32_* ` `` _ __ |
|
|||
|
"*" '|' (*) [*] {*} <*> ‘*’ ‚*‘ ‘*‚ ’*’ ‚*’ “*” „*“ “*„ ”*” „*” »*« ›*‹ «*» »*» ›*›</code></pre>
|