Menu
▾
▴
[Docutils-checkins] docutils/docs/user/rst cheatsheet.txt,1.9,1.10
|
From: David G. <go...@us...> - 2004-10-22 01:23:56
|
Update of /cvsroot/docutils/docutils/docs/user/rst In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv29935/rst Modified Files: cheatsheet.txt Log Message: added directive; cleanup Index: cheatsheet.txt =================================================================== RCS file: /cvsroot/docutils/docutils/docs/user/rst/cheatsheet.txt,v retrieving revision 1.9 retrieving revision 1.10 diff -u -d -r1.9 -r1.10 --- cheatsheet.txt 5 Oct 2004 01:22:01 -0000 1.9 +++ cheatsheet.txt 22 Oct 2004 01:23:47 -0000 1.10 @@ -24,27 +24,27 @@ | >>> print 'Doctest block' | | | Doctest block | > Quoted | +--------------------------------+-----------------------------------+ -| | Line blocks preserve line breaks & indents. | +| | Line blocks preserve line breaks & indents. [new in 0.3.6] | | | Useful for addresses, verse, and adornment-free lists; long | | lines can be wrapped with continuation lines. | +--------------------------------------------------------------------+ Simple tables: -================ ==================================================== +================ ============================================================ List Type Examples -================ ==================================================== +================ ============================================================ Bullet list * items begin with "-", "+", or "*" Enumerated list 1. items use any variation of "1.", "A)", and "(i)" Definition list Term is flush-left : optional classifier Definition is indented, no blank line between Field list :field name: field body Option list -o at least 2 spaces between option & description -================ ==================================================== +================ ============================================================ -================ ==================================================== +================ ============================================================ Explicit Markup Examples (visible in the `text source <cheatsheet.txt>`_) -================ ==================================================== +================ ============================================================ Footnote .. [1] Manually numbered or [#] auto-numbered (even [#labelled]) or [*] auto-symbol Citation .. [CIT2002] A citation. @@ -55,7 +55,7 @@ Directive ("::") .. image:: images/biohazard.png Substitution Def .. |substitution| replace:: like an inline directive Comment .. is anything else -================ ==================================================== +================ ============================================================ Inline Markup ============= @@ -69,9 +69,9 @@ ========================= See <http://docutils.sf.net/docs/ref/rst/directives.html> for full info. -================ ==================================================== -Directive Name Description -================ ==================================================== +================ ============================================================ +Directive Name Description (Docutils version added to, in [brackets]) +================ ============================================================ attention Specific admonition; also "caution", "danger", "error", "hint", "important", "note", "tip", "warning" admonition Generic titled admonition: ``.. admonition:: By The Way`` @@ -82,11 +82,12 @@ parsed-literal A literal block with parsed inline markup rubric ``.. rubric:: Informal Heading`` epigraph Block quote with class="epigraph" -highlights Block quote with class="highlights" +highlights Block quote with class="highlights" pull-quote Block quote with class="pull-quote" -table Create a titled table (new in Docutils 0.3.1) -csv-table Create a titled table from CSV data (requires Python 2.3+; - new in Docutils 0.3.4) +compound Compound paragraphs [0.3.6] +table Create a titled table [0.3.1] +csv-table Create a titled table from CSV data (requires Python 2.3+) + [0.3.4] contents Generate a table of contents sectnum Automatically number sections, subsections, etc. target-notes Create an explicit footnote for each external target @@ -96,16 +97,16 @@ replace Replacement text for substitution definitions unicode Unicode character code conversion for substitution defs class Set a "class" attribute on the next element -role Create a custom interpreted text role (new in Docutils 0.3.2) -================ ==================================================== +role Create a custom interpreted text role [0.3.2] +================ ============================================================ Interpreted Text Role Quick Reference ===================================== See <http://docutils.sf.net/docs/ref/rst/roles.html> for full info. -================ ==================================================== +================ ============================================================ Role Name Description -================ ==================================================== +================ ============================================================ emphasis Equivalent to *emphasis* literal Equivalent to ``literal`` but processes backslash escapes PEP Reference to a numbered Python Enhancement Proposal @@ -114,4 +115,4 @@ sub Subscript sup Superscript title Title reference (book, etc.); standard default role -================ ==================================================== +================ ============================================================ |