test/functional/expected/standalone_rst_pseudoxml.txt

   1 <document ids="restructuredtext-test-document doctitle" names="restructuredtext\ test\ document doctitle" source="functional/input/standalone_rst_pseudoxml.txt" title="reStructuredText Test Document">
   2     <title>
   3         reStructuredText Test Document
   4     <subtitle ids="examples-of-syntax-constructs subtitle" names="examples\ of\ syntax\ constructs subtitle">
   5         Examples of Syntax Constructs
   6     <decoration>
   7         <header>
   8             <paragraph>
   9                 Document header
  10         <footer>
  11             <paragraph>
  12                 Document footer
  13     <docinfo>
  14         <author>
  15             David Goodger
  16         <address xml:space="preserve">
  17             123 Example Street
  18             Example, EX  Canada
  19             A1B 2C3
  20         <contact>
  21             <reference refuri="mailto:goodger@python.org">
  22                 goodger@python.org
  23         <authors>
  24             <author>
  25                 Me
  26             <author>
  27                 Myself
  28             <author>
  29                 I
  30         <organization>
  31             humankind
  32         <date>
  33             Now, or yesterday.  Or maybe even
  34             <emphasis>
  35                 before
  36              yesterday.
  37         <status>
  38             This is a "work in progress"
  39         <revision>
  40             is managed by a version control system.
  41         <version>
  42             1
  43         <copyright>
  44             This document has been placed in the public domain. You
  45             may do with it as you wish. You may copy, modify,
  46             redistribute, reattribute, sell, buy, rent, lease,
  47             destroy, or improve it, quote it at length, excerpt,
  48             incorporate, collate, fold, staple, or mutilate it, or do
  49             anything else to it that your or anyone else's heart
  50             desires.
  51         <field>
  52             <field_name>
  53                 field name
  54             <field_body>
  55                 <paragraph>
  56                     This is a "generic bibliographic field".
  57         <field>
  58             <field_name>
  59                 field name "2"
  60             <field_body>
  61                 <paragraph>
  62                     Generic bibliographic fields may contain multiple body elements.
  63                 <paragraph>
  64                     Like this.
  65     <topic classes="dedication">
  66         <title>
  67             Dedication
  68         <paragraph>
  69             For Docutils users & co-developers.
  70     <topic classes="abstract">
  71         <title>
  72             Abstract
  73         <paragraph>
  74             This is a test document, containing at least one example of each
  75             reStructuredText construct.
  76     <comment xml:space="preserve">
  77         This is a comment. Note how any initial comments are moved by
  78         transforms to after the document title, subtitle, and docinfo.
  79     <target refid="doctitle">
  80     <comment xml:space="preserve">
  81         Above is the document title, and below is the subtitle.
  82         They are transformed from section titles after parsing.
  83     <target refid="subtitle">
  84     <comment xml:space="preserve">
  85         bibliographic fields (which also require a transform):
  86     <meta content="reStructuredText, test, parser" name="keywords">
  87     <meta content="A test document, containing at least one example of each reStructuredText construct." lang="en" name="description">
  88     <raw format="latex" xml:space="preserve">
  89         \pagebreak[4] % start ToC on new page
  90     <topic classes="contents" ids="table-of-contents" names="table\ of\ contents">
  91         <title>
  92             Table of Contents
  93         <bullet_list classes="auto-toc">
  94             <list_item>
  95                 <paragraph>
  96                     <reference ids="id34" refid="structural-elements">
  97                         <generated classes="sectnum">
  98                             1
  99                         Structural Elements
 100                 <bullet_list classes="auto-toc">
 101                     <list_item>
 102                         <paragraph>
 103                             <reference ids="id35" refid="section-title">
 104                                 <generated classes="sectnum">
 105                                     1.1
 106                                 Section Title
 107                     <list_item>
 108                         <paragraph>
 109                             <reference ids="id36" refid="empty-section">
 110                                 <generated classes="sectnum">
 111                                     1.2
 112                                 Empty Section
 113                     <list_item>
 114                         <paragraph>
 115                             <reference ids="id37" refid="transitions">
 116                                 <generated classes="sectnum">
 117                                     1.3
 118                                 Transitions
 119             <list_item>
 120                 <paragraph>
 121                     <reference ids="id38" refid="body-elements">
 122                         <generated classes="sectnum">
 123                             2
 124                         Body Elements
 125                 <bullet_list classes="auto-toc">
 126                     <list_item>
 127                         <paragraph>
 128                             <reference ids="id39" refid="paragraphs">
 129                                 <generated classes="sectnum">
 130                                     2.1
 131                                 Paragraphs
 132                         <bullet_list classes="auto-toc">
 133                             <list_item>
 134                                 <paragraph>
 135                                     <reference ids="id40" refid="inline-markup">
 136                                         <generated classes="sectnum">
 137                                             2.1.1
 138                                         Inline Markup
 139                     <list_item>
 140                         <paragraph>
 141                             <reference ids="id41" refid="bullet-lists">
 142                                 <generated classes="sectnum">
 143                                     2.2
 144                                 Bullet Lists
 145                     <list_item>
 146                         <paragraph>
 147                             <reference ids="id42" refid="enumerated-lists">
 148                                 <generated classes="sectnum">
 149                                     2.3
 150                                 Enumerated Lists
 151                     <list_item>
 152                         <paragraph>
 153                             <reference ids="id43" refid="definition-lists">
 154                                 <generated classes="sectnum">
 155                                     2.4
 156                                 Definition Lists
 157                     <list_item>
 158                         <paragraph>
 159                             <reference ids="id44" refid="field-lists">
 160                                 <generated classes="sectnum">
 161                                     2.5
 162                                 Field Lists
 163                     <list_item>
 164                         <paragraph>
 165                             <reference ids="id45" refid="option-lists">
 166                                 <generated classes="sectnum">
 167                                     2.6
 168                                 Option Lists
 169                     <list_item>
 170                         <paragraph>
 171                             <reference ids="id46" refid="literal-blocks">
 172                                 <generated classes="sectnum">
 173                                     2.7
 174                                 Literal Blocks
 175                     <list_item>
 176                         <paragraph>
 177                             <reference ids="id47" refid="line-blocks">
 178                                 <generated classes="sectnum">
 179                                     2.8
 180                                 Line Blocks
 181                     <list_item>
 182                         <paragraph>
 183                             <reference ids="id48" refid="block-quotes">
 184                                 <generated classes="sectnum">
 185                                     2.9
 186                                 Block Quotes
 187                     <list_item>
 188                         <paragraph>
 189                             <reference ids="id49" refid="doctest-blocks">
 190                                 <generated classes="sectnum">
 191                                     2.10
 192                                 Doctest Blocks
 193                     <list_item>
 194                         <paragraph>
 195                             <reference ids="id50" refid="footnotes">
 196                                 <generated classes="sectnum">
 197                                     2.11
 198                                 Footnotes
 199                     <list_item>
 200                         <paragraph>
 201                             <reference ids="id51" refid="citations">
 202                                 <generated classes="sectnum">
 203                                     2.12
 204                                 Citations
 205                     <list_item>
 206                         <paragraph>
 207                             <reference ids="id52" refid="targets">
 208                                 <generated classes="sectnum">
 209                                     2.13
 210                                 Targets
 211                         <bullet_list classes="auto-toc">
 212                             <list_item>
 213                                 <paragraph>
 214                                     <reference ids="id53" refid="duplicate-target-names">
 215                                         <generated classes="sectnum">
 216                                             2.13.1
 217                                         Duplicate Target Names
 218                             <list_item>
 219                                 <paragraph>
 220                                     <reference ids="id54" refid="id21">
 221                                         <generated classes="sectnum">
 222                                             2.13.2
 223                                         Duplicate Target Names
 224                     <list_item>
 225                         <paragraph>
 226                             <reference ids="id55" refid="directives">
 227                                 <generated classes="sectnum">
 228                                     2.14
 229                                 Directives
 230                         <bullet_list classes="auto-toc">
 231                             <list_item>
 232                                 <paragraph>
 233                                     <reference ids="id56" refid="document-parts">
 234                                         <generated classes="sectnum">
 235                                             2.14.1
 236                                         Document Parts
 237                             <list_item>
 238                                 <paragraph>
 239                                     <reference ids="id57" refid="images-and-figures">
 240                                         <generated classes="sectnum">
 241                                             2.14.2
 242                                         Images and Figures
 243                             <list_item>
 244                                 <paragraph>
 245                                     <reference ids="id58" refid="admonitions">
 246                                         <generated classes="sectnum">
 247                                             2.14.3
 248                                         Admonitions
 249                             <list_item>
 250                                 <paragraph>
 251                                     <reference ids="id59" refid="topics-sidebars-and-rubrics">
 252                                         <generated classes="sectnum">
 253                                             2.14.4
 254                                         Topics, Sidebars, and Rubrics
 255                             <list_item>
 256                                 <paragraph>
 257                                     <reference ids="id60" refid="target-footnotes">
 258                                         <generated classes="sectnum">
 259                                             2.14.5
 260                                         Target Footnotes
 261                             <list_item>
 262                                 <paragraph>
 263                                     <reference ids="id61" refid="replacement-text">
 264                                         <generated classes="sectnum">
 265                                             2.14.6
 266                                         Replacement Text
 267                             <list_item>
 268                                 <paragraph>
 269                                     <reference ids="id62" refid="compound-paragraph">
 270                                         <generated classes="sectnum">
 271                                             2.14.7
 272                                         Compound Paragraph
 273                             <list_item>
 274                                 <paragraph>
 275                                     <reference ids="id63" refid="parsed-literal-blocks">
 276                                         <generated classes="sectnum">
 277                                             2.14.8
 278                                         Parsed Literal Blocks
 279                             <list_item>
 280                                 <paragraph>
 281                                     <reference ids="id64" refid="code">
 282                                         <generated classes="sectnum">
 283                                             2.14.9
 284                                         Code
 285                     <list_item>
 286                         <paragraph>
 287                             <reference ids="id65" refid="substitution-definitions">
 288                                 <generated classes="sectnum">
 289                                     2.15
 290                                 Substitution Definitions
 291                     <list_item>
 292                         <paragraph>
 293                             <reference ids="id66" refid="comments">
 294                                 <generated classes="sectnum">
 295                                     2.16
 296                                 Comments
 297                     <list_item>
 298                         <paragraph>
 299                             <reference ids="id67" refid="raw-text">
 300                                 <generated classes="sectnum">
 301                                     2.17
 302                                 Raw text
 303                     <list_item>
 304                         <paragraph>
 305                             <reference ids="id68" refid="container">
 306                                 <generated classes="sectnum">
 307                                     2.18
 308                                 Container
 309                     <list_item>
 310                         <paragraph>
 311                             <reference ids="id69" refid="colspanning-tables">
 312                                 <generated classes="sectnum">
 313                                     2.19
 314                                 Colspanning tables
 315                     <list_item>
 316                         <paragraph>
 317                             <reference ids="id70" refid="rowspanning-tables">
 318                                 <generated classes="sectnum">
 319                                     2.20
 320                                 Rowspanning tables
 321                     <list_item>
 322                         <paragraph>
 323                             <reference ids="id71" refid="complex-tables">
 324                                 <generated classes="sectnum">
 325                                     2.21
 326                                 Complex tables
 327                     <list_item>
 328                         <paragraph>
 329                             <reference ids="id72" refid="list-tables">
 330                                 <generated classes="sectnum">
 331                                     2.22
 332                                 List Tables
 333             <list_item>
 334                 <paragraph>
 335                     <reference ids="id73" refid="error-handling">
 336                         <generated classes="sectnum">
 337                             3
 338                         Error Handling
 339     <section ids="structural-elements" names="structural\ elements">
 340         <title auto="1" refid="id34">
 341             <generated classes="sectnum">
 342                 1
 343             Structural Elements
 344         <section ids="section-title" names="section\ title">
 345             <title auto="1" refid="id35">
 346                 <generated classes="sectnum">
 347                     1.1
 348                 Section Title
 349             <subtitle ids="section-subtitle" names="section\ subtitle">
 350                 Section Subtitle
 351             <paragraph>
 352                 Lone subsections are converted to a section subtitle by a transform
 353                 activated with the
 354                 <literal>
 355                     --section-subtitles
 356                  command line option or the
 357                 <literal>
 358                     sectsubtitle-xform
 359                  configuration value.
 360         <section ids="empty-section" names="empty\ section">
 361             <title auto="1" refid="id36">
 362                 <generated classes="sectnum">
 363                     1.2
 364                 Empty Section
 365         <section ids="transitions" names="transitions">
 366             <title auto="1" refid="id37">
 367                 <generated classes="sectnum">
 368                     1.3
 369                 Transitions
 370             <paragraph>
 371                 Here's a transition:
 372             <transition>
 373             <paragraph>
 374                 It divides the section.  Transitions may also occur between sections:
 375     <transition>
 376     <section ids="body-elements" names="body\ elements">
 377         <title auto="1" refid="id38">
 378             <generated classes="sectnum">
 379                 2
 380             Body Elements
 381         <section ids="paragraphs" names="paragraphs">
 382             <title auto="1" refid="id39">
 383                 <generated classes="sectnum">
 384                     2.1
 385                 Paragraphs
 386             <paragraph>
 387                 A paragraph.
 388             <section ids="inline-markup" names="inline\ markup">
 389                 <title auto="1" refid="id40">
 390                     <generated classes="sectnum">
 391                         2.1.1
 392                     Inline Markup
 393                 <paragraph>
 394                     Paragraphs contain text and may contain inline markup:
 395                     <emphasis>
 396                         emphasis
 397                     ,
 398                     <strong>
 399                         strong emphasis
 400                     ,
 401                     <literal>
 402                         inline literals
 403                     , standalone hyperlinks
 404                     (
 405                     <reference refuri="http://www.python.org">
 406                         http://www.python.org
 407                     ), external hyperlinks (
 408                     <reference name="Python" refuri="http://www.python.org/">
 409                         Python
 410
 411                     <footnote_reference auto="1" ids="id26" refid="id25">
 412                         5
 413                     ), internal
 414                     cross-references (
 415                     <reference name="example" refid="example">
 416                         example
 417                     ), external hyperlinks with embedded URIs
 418                     (
 419                     <reference name="Python web site" refuri="http://www.python.org">
 420                         Python web site
 421                     ),
 422                     <reference anonymous="1" name="anonymous hyperlink references" refuri="http://www.python.org/">
 423                         anonymous hyperlink
 424                         references
 425
 426                     <footnote_reference auto="1" ids="id31" refid="id25">
 427                         5
 428                      (
 429                     <reference anonymous="1" name="a second reference" refuri="http://docutils.sourceforge.net/">
 430                         a second reference
 431
 432                     <footnote_reference auto="1" ids="id33" refid="id32">
 433                         7
 434                     ), footnote references (manually
 435                     numbered
 436                     <footnote_reference ids="id1" refid="id8">
 437                         1
 438                     , anonymous auto-numbered
 439                     <footnote_reference auto="1" ids="id2" refid="id12">
 440                         3
 441                     , labeled auto-numbered
 442                     <footnote_reference auto="1" ids="id3" refid="label">
 443                         2
 444                     , or symbolic
 445                     <footnote_reference auto="*" ids="id4" refid="id13">
 446                         *
 447                     ), citation references (
 448                     <citation_reference ids="id5" refid="cit2002">
 449                         CIT2002
 450                     ),
 451                     substitution references (
 452                     <image alt="EXAMPLE" uri="../../../docs/user/rst/images/biohazard.png">
 453                     ), and
 454                     <target ids="inline-hyperlink-targets" names="inline\ hyperlink\ targets">
 455                         inline hyperlink targets
 456
 457                     (see
 458                     <reference name="Targets" refid="targets">
 459                         Targets
 460                      below for a reference back to here).  Character-level
 461                     inline markup is also possible (although exceedingly ugly!) in
 462                     <emphasis>
 463                         re
 464                     <literal>
 465                         Structured
 466                     <emphasis>
 467                         Text
 468                     .  Problems are indicated by
 469                     <problematic ids="id24" refid="id23">
 470                         |problematic|
 471                      text
 472                     (generated by processing errors; this one is intentional).  Here is a
 473                     reference to the
 474                     <reference name="doctitle" refid="doctitle">
 475                         doctitle
 476                      and the
 477                     <reference name="subtitle" refid="subtitle">
 478                         subtitle
 479                     .
 480                 <target anonymous="1" ids="id6" refuri="http://www.python.org/">
 481                 <target anonymous="1" ids="id7" refuri="http://docutils.sourceforge.net/">
 482                 <paragraph>
 483                     The default role for interpreted text is
 484                     <title_reference>
 485                         Title Reference
 486                     .  Here are
 487                     some explicit interpreted text roles: a PEP reference (
 488                     <reference refuri="http://www.python.org/dev/peps/pep-0287">
 489                         PEP 287
 490                     ); an
 491                     RFC reference (
 492                     <reference refuri="http://www.faqs.org/rfcs/rfc2822.html">
 493                         RFC 2822
 494                     ); an abbreviation (
 495                     <abbreviation>
 496                         abb.
 497                     ), an acronym
 498                     (
 499                     <acronym>
 500                         reST
 501                     ), code (
 502                     <literal classes="code">
 503                         print "hello world"
 504                     ); a
 505                     <subscript>
 506                         subscript
 507                     ;
 508                     a
 509                     <superscript>
 510                         superscript
 511                      and explicit roles for
 512                     <title_reference>
 513                         Docutils
 514                     '
 515                     <emphasis>
 516                         standard
 517
 518                     <strong>
 519                         inline
 520
 521                     <literal>
 522                         markup
 523                     .
 524                 <comment xml:space="preserve">
 525                     DO NOT RE-WRAP THE FOLLOWING PARAGRAPH!
 526                 <paragraph>
 527                     Let's test wrapping and whitespace significance in inline literals:
 528                     <literal>
 529                         This is an example of --inline-literal --text, --including some--
 530                         strangely--hyphenated-words.  Adjust-the-width-of-your-browser-window
 531                         to see how the text is wrapped.  -- ---- --------  Now note    the
 532                         spacing    between the    words of    this sentence    (words
 533                         should    be grouped    in pairs).
 534                 <paragraph>
 535                     If the
 536                     <literal>
 537                         --pep-references
 538                      option was supplied, there should be a
 539                     live link to PEP 258 here.
 540         <section ids="bullet-lists" names="bullet\ lists">
 541             <title auto="1" refid="id41">
 542                 <generated classes="sectnum">
 543                     2.2
 544                 Bullet Lists
 545             <bullet_list bullet="-">
 546                 <list_item>
 547                     <paragraph>
 548                         A bullet list
 549                     <bullet_list bullet="+">
 550                         <list_item>
 551                             <paragraph>
 552                                 Nested bullet list.
 553                         <list_item>
 554                             <paragraph>
 555                                 Nested item 2.
 556                 <list_item>
 557                     <paragraph>
 558                         Item 2.
 559                     <paragraph>
 560                         Paragraph 2 of item 2.
 561                     <bullet_list bullet="*">
 562                         <list_item>
 563                             <paragraph>
 564                                 Nested bullet list.
 565                         <list_item>
 566                             <paragraph>
 567                                 Nested item 2.
 568                             <bullet_list bullet="-">
 569                                 <list_item>
 570                                     <paragraph>
 571                                         Third level.
 572                                 <list_item>
 573                                     <paragraph>
 574                                         Item 2.
 575                         <list_item>
 576                             <paragraph>
 577                                 Nested item 3.
 578                         <list_item>
 579                             <paragraph>
 580                                 This nested list should be compacted by the HTML writer.
 581                             <target ids="target" names="target">
 582                             <comment xml:space="preserve">
 583                                 Even if this item contains a target and a comment.
 584         <section ids="enumerated-lists" names="enumerated\ lists">
 585             <title auto="1" refid="id42">
 586                 <generated classes="sectnum">
 587                     2.3
 588                 Enumerated Lists
 589             <enumerated_list enumtype="arabic" prefix="" suffix=".">
 590                 <list_item>
 591                     <paragraph>
 592                         Arabic numerals.
 593                     <enumerated_list enumtype="loweralpha" prefix="" suffix=")">
 594                         <list_item>
 595                             <paragraph>
 596                                 lower alpha)
 597                             <enumerated_list enumtype="lowerroman" prefix="(" suffix=")">
 598                                 <list_item>
 599                                     <paragraph>
 600                                         (lower roman)
 601                                     <enumerated_list enumtype="upperalpha" prefix="" suffix=".">
 602                                         <list_item>
 603                                             <paragraph>
 604                                                 upper alpha.
 605                                             <enumerated_list enumtype="upperroman" prefix="" suffix=")">
 606                                                 <list_item>
 607                                                     <paragraph>
 608                                                         upper roman)
 609                 <list_item>
 610                     <paragraph>
 611                         Lists that don't start at 1:
 612                     <enumerated_list enumtype="arabic" prefix="" start="3" suffix=".">
 613                         <list_item>
 614                             <paragraph>
 615                                 Three
 616                         <list_item>
 617                             <paragraph>
 618                                 Four
 619                     <enumerated_list enumtype="upperalpha" prefix="" start="3" suffix=".">
 620                         <list_item>
 621                             <paragraph>
 622                                 C
 623                         <list_item>
 624                             <paragraph>
 625                                 D
 626                     <enumerated_list enumtype="lowerroman" prefix="" start="3" suffix=".">
 627                         <list_item>
 628                             <paragraph>
 629                                 iii
 630                         <list_item>
 631                             <paragraph>
 632                                 iv
 633         <section ids="definition-lists" names="definition\ lists">
 634             <title auto="1" refid="id43">
 635                 <generated classes="sectnum">
 636                     2.4
 637                 Definition Lists
 638             <definition_list>
 639                 <definition_list_item>
 640                     <term>
 641                         Term
 642                     <definition>
 643                         <paragraph>
 644                             Definition
 645                 <definition_list_item>
 646                     <term>
 647                         Term
 648                     <classifier>
 649                         classifier
 650                     <definition>
 651                         <paragraph>
 652                             Definition paragraph 1.
 653                         <paragraph>
 654                             Definition paragraph 2.
 655                 <definition_list_item>
 656                     <term>
 657                         Term
 658                     <definition>
 659                         <paragraph>
 660                             Definition
 661                 <definition_list_item>
 662                     <term>
 663                         Term
 664                     <classifier>
 665                         classifier one
 666                     <classifier>
 667                         classifier two
 668                     <definition>
 669                         <paragraph>
 670                             Definition
 671         <section ids="field-lists" names="field\ lists">
 672             <title auto="1" refid="id44">
 673                 <generated classes="sectnum">
 674                     2.5
 675                 Field Lists
 676             <field_list>
 677                 <field>
 678                     <field_name>
 679                         what
 680                     <field_body>
 681                         <paragraph>
 682                             Field lists map field names to field bodies, like database
 683                             records.  They are often part of an extension syntax.  They are
 684                             an unambiguous variant of RFC 2822 fields.
 685                 <field>
 686                     <field_name>
 687                         how arg1 arg2
 688                     <field_body>
 689                         <paragraph>
 690                             The field marker is a colon, the field name, and a colon.
 691                         <paragraph>
 692                             The field body may contain one or more body elements, indented
 693                             relative to the field marker.
 694                 <field>
 695                     <field_name>
 696                         credits
 697                     <field_body>
 698                         <paragraph classes="credits">
 699                             This paragraph has the
 700                             <title_reference>
 701                                 credits
 702                              class set.  (This is actually not
 703                             about credits but just for ensuring that the class attribute
 704                             doesn't get stripped away.)
 705         <section ids="option-lists" names="option\ lists">
 706             <title auto="1" refid="id45">
 707                 <generated classes="sectnum">
 708                     2.6
 709                 Option Lists
 710             <paragraph>
 711                 For listing command-line options:
 712             <option_list>
 713                 <option_list_item>
 714                     <option_group>
 715                         <option>
 716                             <option_string>
 717                                 -a
 718                     <description>
 719                         <paragraph>
 720                             command-line option "a"
 721                 <option_list_item>
 722                     <option_group>
 723                         <option>
 724                             <option_string>
 725                                 -b
 726                             <option_argument delimiter=" ">
 727                                 file
 728                     <description>
 729                         <paragraph>
 730                             options can have arguments
 731                             and long descriptions
 732                 <option_list_item>
 733                     <option_group>
 734                         <option>
 735                             <option_string>
 736                                 --long
 737                     <description>
 738                         <paragraph>
 739                             options can be long also
 740                 <option_list_item>
 741                     <option_group>
 742                         <option>
 743                             <option_string>
 744                                 --input
 745                             <option_argument delimiter="=">
 746                                 file
 747                     <description>
 748                         <paragraph>
 749                             long options can also have
 750                             arguments
 751                 <option_list_item>
 752                     <option_group>
 753                         <option>
 754                             <option_string>
 755                                 --very-long-option
 756                     <description>
 757                         <paragraph>
 758                             The description can also start on the next line.
 759                         <paragraph>
 760                             The description may contain multiple body elements,
 761                             regardless of where it starts.
 762                 <option_list_item>
 763                     <option_group>
 764                         <option>
 765                             <option_string>
 766                                 -x
 767                         <option>
 768                             <option_string>
 769                                 -y
 770                         <option>
 771                             <option_string>
 772                                 -z
 773                     <description>
 774                         <paragraph>
 775                             Multiple options are an "option group".
 776                 <option_list_item>
 777                     <option_group>
 778                         <option>
 779                             <option_string>
 780                                 -v
 781                         <option>
 782                             <option_string>
 783                                 --verbose
 784                     <description>
 785                         <paragraph>
 786                             Commonly-seen: short & long options.
 787                 <option_list_item>
 788                     <option_group>
 789                         <option>
 790                             <option_string>
 791                                 -1
 792                             <option_argument delimiter=" ">
 793                                 file
 794                         <option>
 795                             <option_string>
 796                                 --one
 797                             <option_argument delimiter="=">
 798                                 file
 799                         <option>
 800                             <option_string>
 801                                 --two
 802                             <option_argument delimiter=" ">
 803                                 file
 804                     <description>
 805                         <paragraph>
 806                             Multiple options with arguments.
 807                 <option_list_item>
 808                     <option_group>
 809                         <option>
 810                             <option_string>
 811                                 /V
 812                     <description>
 813                         <paragraph>
 814                             DOS/VMS-style options too
 815             <paragraph>
 816                 There must be at least two spaces between the option and the
 817                 description.
 818         <section ids="literal-blocks" names="literal\ blocks">
 819             <title auto="1" refid="id46">
 820                 <generated classes="sectnum">
 821                     2.7
 822                 Literal Blocks
 823             <paragraph>
 824                 Literal blocks are indicated with a double-colon ("::") at the end of
 825                 the preceding paragraph (over there
 826                 <literal>
 827                     -->
 828                 ).  They can be indented:
 829             <literal_block xml:space="preserve">
 830                 if literal_block:
 831                     text = 'is left as-is'
 832                     spaces_and_linebreaks = 'are preserved'
 833                     markup_processing = None
 834             <paragraph>
 835                 Or they can be quoted without indentation:
 836             <literal_block xml:space="preserve">
 837                 >> Great idea!
 838                 >
 839                 > Why didn't I think of that?
 840         <section ids="line-blocks" names="line\ blocks">
 841             <title auto="1" refid="id47">
 842                 <generated classes="sectnum">
 843                     2.8
 844                 Line Blocks
 845             <paragraph>
 846                 This section tests line blocks.  Line blocks are body elements which
 847                 consist of lines and other line blocks.  Nested line blocks cause
 848                 indentation.
 849             <line_block>
 850                 <line>
 851                     This is a line block.  It ends with a blank line.
 852                 <line_block>
 853                     <line>
 854                         New lines begin with a vertical bar ("|").
 855                     <line>
 856                         Line breaks and initial indent are significant, and preserved.
 857                     <line_block>
 858                         <line>
 859                             Continuation lines are also possible.  A long line that is intended
 860                             to wrap should begin with a space in place of the vertical bar.
 861                     <line>
 862                         The left edge of a continuation line need not be aligned with
 863                         the left edge of the text above it.
 864             <line_block>
 865                 <line>
 866                     This is a second line block.
 867                 <line>
 868                 <line>
 869                     Blank lines are permitted internally, but they must begin with a "|".
 870             <paragraph>
 871                 Another line block, surrounded by paragraphs:
 872             <line_block>
 873                 <line>
 874                     And it's no good waiting by the window
 875                 <line>
 876                     It's no good waiting for the sun
 877                 <line>
 878                     Please believe me, the things you dream of
 879                 <line>
 880                     They don't fall in the lap of no-one
 881             <paragraph>
 882                 Take it away, Eric the Orchestra Leader!
 883             <block_quote>
 884                 <line_block>
 885                     <line>
 886                         A one, two, a one two three four
 887                     <line>
 888                     <line>
 889                         Half a bee, philosophically,
 890                     <line_block>
 891                         <line>
 892                             must,
 893                             <emphasis>
 894                                 ipso facto
 895                             , half not be.
 896                     <line>
 897                         But half the bee has got to be,
 898                     <line_block>
 899                         <line>
 900                             <emphasis>
 901                                 vis a vis
 902                              its entity.  D'you see?
 903                         <line>
 904                     <line>
 905                         But can a bee be said to be
 906                     <line_block>
 907                         <line>
 908                             or not to be an entire bee,
 909                         <line_block>
 910                             <line>
 911                                 when half the bee is not a bee,
 912                             <line_block>
 913                                 <line>
 914                                     due to some ancient injury?
 915                                 <line>
 916                     <line>
 917                         Singing...
 918             <paragraph>
 919                 A line block, like the following poem by Christian Morgenstern, can
 920                 also be centre-aligned:
 921             <line_block classes="language-de align-center">
 922                 <line>
 923                     <strong>
 924                         Die Trichter
 925                 <line>
 926                 <line>
 927                     Zwei Trichter wandeln durch die Nacht.
 928                 <line>
 929                     Durch ihres Rumpfs verengten Schacht
 930                 <line>
 931                     fließt weißes Mondlicht
 932                 <line>
 933                     still und heiter
 934                 <line>
 935                     auf   ihren
 936                 <line>
 937                     Waldweg
 938                 <line>
 939                     u. s.
 940                 <line>
 941                     w.
 942                 <line>
 943         <section ids="block-quotes" names="block\ quotes">
 944             <title auto="1" refid="id48">
 945                 <generated classes="sectnum">
 946                     2.9
 947                 Block Quotes
 948             <paragraph>
 949                 Block quotes consist of indented body elements:
 950             <block_quote>
 951                 <paragraph>
 952                     My theory by A. Elk.  Brackets Miss, brackets.  This theory goes
 953                     as follows and begins now.  All brontosauruses are thin at one
 954                     end, much much thicker in the middle and then thin again at the
 955                     far end.  That is my theory, it is mine, and belongs to me and I
 956                     own it, and what it is too.
 957                 <attribution>
 958                     Anne Elk (Miss)
 959             <paragraph>
 960                 The language of a quote (like any other object) can be specified by
 961                 a class attribute:
 962             <comment xml:space="preserve">
 963             <block_quote classes="language-fr">
 964                 <paragraph>
 965                     ReStructuredText est un langage de balisage léger utilisé
 966                     notamment dans la documentation du langage Python.
 967         <section ids="doctest-blocks" names="doctest\ blocks">
 968             <title auto="1" refid="id49">
 969                 <generated classes="sectnum">
 970                     2.10
 971                 Doctest Blocks
 972             <doctest_block xml:space="preserve">
 973                 >>> print 'Python-specific usage examples; begun with ">>>"'
 974                 Python-specific usage examples; begun with ">>>"
 975                 >>> print '(cut and pasted from interactive Python sessions)'
 976                 (cut and pasted from interactive Python sessions)
 977         <section ids="footnotes" names="footnotes">
 978             <title auto="1" refid="id50">
 979                 <generated classes="sectnum">
 980                     2.11
 981                 Footnotes
 982             <footnote backrefs="id1 id9 id22" ids="id8" names="1">
 983                 <label>
 984                     1
 985                 <paragraph>
 986                     A footnote contains body elements, consistently indented by at
 987                     least 3 spaces.
 988                 <paragraph>
 989                     This is the footnote's second paragraph.
 990             <footnote auto="1" backrefs="id3 id10" ids="label" names="label">
 991                 <label>
 992                     2
 993                 <paragraph>
 994                     Footnotes may be numbered, either manually (as in
 995                     <footnote_reference ids="id9" refid="id8">
 996                         1
 997                     ) or
 998                     automatically using a "#"-prefixed label.  This footnote has a
 999                     label so it can be referred to from multiple places, both as a
1000                     footnote reference (
1001                     <footnote_reference auto="1" ids="id10" refid="label">
1002                         2
1003                     ) and as a
1004                     <reference anonymous="1" name="hyperlink reference" refid="label">
1005                         hyperlink reference
1006                     .
1007                 <target anonymous="1" ids="id11" refid="label">
1008             <footnote auto="1" backrefs="id2" ids="id12" names="3">
1009                 <label>
1010                     3
1011                 <paragraph>
1012                     This footnote is numbered automatically and anonymously using a
1013                     label of "#" only.
1014                 <paragraph>
1015                     This is the second paragraph.
1016                 <paragraph>
1017                     And this is the third paragraph.
1018             <footnote auto="*" backrefs="id4" ids="id13">
1019                 <label>
1020                     *
1021                 <paragraph>
1022                     Footnotes may also use symbols, specified with a "*" label.
1023                     Here's a reference to the next footnote:
1024                     <footnote_reference auto="*" ids="id14" refid="id15">
1025                         †
1026                     .
1027             <footnote auto="*" backrefs="id14" ids="id15">
1028                 <label>
1029                     †
1030                 <paragraph>
1031                     This footnote shows the next symbol in the sequence.
1032             <footnote ids="id16" names="4">
1033                 <label>
1034                     4
1035                 <paragraph>
1036                     Here's an unreferenced footnote, with a reference to a
1037                     nonexistent footnote:
1038                     <problematic ids="id84 id17" refid="id83">
1039                         [5]_
1040                     .
1041         <section ids="citations" names="citations">
1042             <title auto="1" refid="id51">
1043                 <generated classes="sectnum">
1044                     2.12
1045                 Citations
1046             <citation backrefs="id5 id18" ids="cit2002" names="cit2002">
1047                 <label>
1048                     CIT2002
1049                 <paragraph>
1050                     Citations are text-labeled footnotes. They may be
1051                     rendered separately and differently from footnotes.
1052             <paragraph>
1053                 Here's a reference to the above,
1054                 <citation_reference ids="id18" refid="cit2002">
1055                     CIT2002
1056                 , and a
1057                 <problematic ids="id86 id19" refid="id85">
1058                     [nonexistent]_
1059
1060                 citation.
1061             <target refid="another-target">
1062         <section ids="targets another-target" names="targets another\ target">
1063             <title auto="1" refid="id52">
1064                 <generated classes="sectnum">
1065                     2.13
1066                 Targets
1067             <target refid="example">
1068             <paragraph ids="example" names="example">
1069                 This paragraph is pointed to by the explicit "example" target. A
1070                 reference can be found under
1071                 <reference name="Inline Markup" refid="inline-markup">
1072                     Inline Markup
1073                 , above.
1074                 <reference name="Inline hyperlink targets" refid="inline-hyperlink-targets">
1075                     Inline
1076                     hyperlink targets
1077                  are also possible.
1078             <paragraph>
1079                 Section headers are implicit targets, referred to by name. See
1080                 <reference name="Targets" refid="targets">
1081                     Targets
1082                 , which is a subsection of
1083                 <reference name="Body Elements" refid="body-elements">
1084                     Body Elements
1085                 .
1086             <paragraph>
1087                 Explicit external targets are interpolated into references such as
1088                 "
1089                 <reference name="Python" refuri="http://www.python.org/">
1090                     Python
1091
1092                 <footnote_reference auto="1" ids="id27" refid="id25">
1093                     5
1094                 ".
1095             <target ids="python" names="python" refuri="http://www.python.org/">
1096             <paragraph>
1097                 Targets may be indirect and anonymous.  Thus
1098                 <reference anonymous="1" name="this phrase" refid="targets">
1099                     this phrase
1100                  may also
1101                 refer to the
1102                 <reference name="Targets" refid="targets">
1103                     Targets
1104                  section.
1105             <target anonymous="1" ids="id20" refid="targets">
1106             <paragraph>
1107                 Here's a
1108                 <problematic ids="id88" refid="id87">
1109                     `hyperlink reference without a target`_
1110                 , which generates an
1111                 error.
1112             <section dupnames="duplicate\ target\ names" ids="duplicate-target-names">
1113                 <title auto="1" refid="id53">
1114                     <generated classes="sectnum">
1115                         2.13.1
1116                     Duplicate Target Names
1117                 <paragraph>
1118                     Duplicate names in section headers or other implicit targets will
1119                     generate "info" (level-1) system messages.  Duplicate names in
1120                     explicit targets will generate "warning" (level-2) system messages.
1121             <section dupnames="duplicate\ target\ names" ids="id21">
1122                 <title auto="1" refid="id54">
1123                     <generated classes="sectnum">
1124                         2.13.2
1125                     Duplicate Target Names
1126                 <paragraph>
1127                     Since there are two "Duplicate Target Names" section headers, we
1128                     cannot uniquely refer to either of them by name.  If we try to (like
1129                     this:
1130                     <problematic ids="id90" refid="id89">
1131                         `Duplicate Target Names`_
1132                     ), an error is generated.
1133         <section ids="directives" names="directives">
1134             <title auto="1" refid="id55">
1135                 <generated classes="sectnum">
1136                     2.14
1137                 Directives
1138             <topic classes="contents local" ids="contents" names="contents">
1139                 <bullet_list classes="auto-toc">
1140                     <list_item>
1141                         <paragraph>
1142                             <reference ids="id74" refid="document-parts">
1143                                 <generated classes="sectnum">
1144                                     2.14.1
1145                                 Document Parts
1146                     <list_item>
1147                         <paragraph>
1148                             <reference ids="id75" refid="images-and-figures">
1149                                 <generated classes="sectnum">
1150                                     2.14.2
1151                                 Images and Figures
1152                     <list_item>
1153                         <paragraph>
1154                             <reference ids="id76" refid="admonitions">
1155                                 <generated classes="sectnum">
1156                                     2.14.3
1157                                 Admonitions
1158                     <list_item>
1159                         <paragraph>
1160                             <reference ids="id77" refid="topics-sidebars-and-rubrics">
1161                                 <generated classes="sectnum">
1162                                     2.14.4
1163                                 Topics, Sidebars, and Rubrics
1164                     <list_item>
1165                         <paragraph>
1166                             <reference ids="id78" refid="target-footnotes">
1167                                 <generated classes="sectnum">
1168                                     2.14.5
1169                                 Target Footnotes
1170                     <list_item>
1171                         <paragraph>
1172                             <reference ids="id79" refid="replacement-text">
1173                                 <generated classes="sectnum">
1174                                     2.14.6
1175                                 Replacement Text
1176                     <list_item>
1177                         <paragraph>
1178                             <reference ids="id80" refid="compound-paragraph">
1179                                 <generated classes="sectnum">
1180                                     2.14.7
1181                                 Compound Paragraph
1182                     <list_item>
1183                         <paragraph>
1184                             <reference ids="id81" refid="parsed-literal-blocks">
1185                                 <generated classes="sectnum">
1186                                     2.14.8
1187                                 Parsed Literal Blocks
1188                     <list_item>
1189                         <paragraph>
1190                             <reference ids="id82" refid="code">
1191                                 <generated classes="sectnum">
1192                                     2.14.9
1193                                 Code
1194             <paragraph>
1195                 These are just a sample of the many reStructuredText Directives.  For
1196                 others, please see
1197                 <reference refuri="http://docutils.sourceforge.net/docs/ref/rst/directives.html">
1198                     http://docutils.sourceforge.net/docs/ref/rst/directives.html
1199                 .
1200             <section ids="document-parts" names="document\ parts">
1201                 <title auto="1" refid="id74">
1202                     <generated classes="sectnum">
1203                         2.14.1
1204                     Document Parts
1205                 <paragraph>
1206                     An example of the "contents" directive can be seen above this section
1207                     (a local, untitled table of
1208                     <reference name="contents" refid="contents">
1209                         contents
1210                     ) and at the beginning of the
1211                     document (a document-wide
1212                     <reference name="table of contents" refid="table-of-contents">
1213                         table of contents
1214                     ).
1215             <section ids="images-and-figures" names="images\ and\ figures">
1216                 <title auto="1" refid="id75">
1217                     <generated classes="sectnum">
1218                         2.14.2
1219                     Images and Figures
1220                 <paragraph>
1221                     An image directive (also clickable -- a hyperlink reference):
1222                 <reference name="directives" refid="directives">
1223                     <image classes="class1 class2" uri="../../../docs/user/rst/images/title.png">
1224                 <paragraph>
1225                     Image with multiple IDs:
1226                 <target refid="image-target-1">
1227                 <target refid="image-target-2">
1228                 <target refid="image-target-3">
1229                 <image ids="image-target-3 image-target-2 image-target-1" names="image\ target\ 3 image\ target\ 2 image\ target\ 1" uri="../../../docs/user/rst/images/title.png">
1230                 <paragraph>
1231                     A centered image:
1232                 <image align="center" uri="../../../docs/user/rst/images/biohazard.png">
1233                 <paragraph>
1234                     A left-aligned image:
1235                 <image align="left" uri="../../../docs/user/rst/images/biohazard.png">
1236                 <paragraph>
1237                     This paragraph might flow around the image.
1238                     The specific behavior depends upon the style sheet and
1239                     the browser or rendering software used.
1240                 <paragraph>
1241                     A right-aligned image:
1242                 <image align="right" uri="../../../docs/user/rst/images/biohazard.png">
1243                 <paragraph>
1244                     This paragraph might flow around the image.
1245                     The specific behavior depends upon the style sheet and
1246                     the browser or rendering software used.
1247                 <paragraph>
1248                     For inline images see
1249                     <reference name="Substitution Definitions" refid="substitution-definitions">
1250                         Substitution Definitions
1251                     .
1252                 <paragraph>
1253                     Image size:
1254                 <paragraph>
1255                     An image 2 em wide:
1256                 <image uri="../../../docs/user/rst/images/biohazard.png" width="2em">
1257                 <paragraph>
1258                     An image 2 em wide and 15 pixel high:
1259                 <image height="15px" uri="../../../docs/user/rst/images/biohazard.png" width="2em">
1260                 <paragraph>
1261                     An image occupying 50% of the line width:
1262                 <image uri="../../../docs/user/rst/images/title.png" width="50%">
1263                 <paragraph>
1264                     An image 2 cm high:
1265                 <image height="2cm" uri="../../../docs/user/rst/images/biohazard.png">
1266                 <paragraph>
1267                     A
1268                     <emphasis>
1269                         figure
1270                      is an image with a caption and/or a legend.  With page-based output
1271                     media, figures might float to a different position if this helps the page
1272                     layout.
1273                 <figure classes="figclass1 figclass2">
1274                     <image alt="reStructuredText, the markup syntax" classes="class1 class2" uri="../../../docs/user/rst/images/title.png" width="258">
1275                     <caption>
1276                         Plaintext markup syntax and parser system.
1277                     <legend>
1278                         <table>
1279                             <tgroup cols="2">
1280                                 <colspec colwidth="12">
1281                                 <colspec colwidth="47">
1282                                 <tbody>
1283                                     <row>
1284                                         <entry>
1285                                             <paragraph>
1286                                                 re
1287                                         <entry>
1288                                             <paragraph>
1289                                                 Revised, revisited, based on 're' module.
1290                                     <row>
1291                                         <entry>
1292                                             <paragraph>
1293                                                 Structured
1294                                         <entry>
1295                                             <paragraph>
1296                                                 Structure-enhanced text, structuredtext.
1297                                     <row>
1298                                         <entry>
1299                                             <paragraph>
1300                                                 Text
1301                                         <entry>
1302                                             <paragraph>
1303                                                 Well it is, isn't it?
1304                         <paragraph>
1305                             This paragraph is also part of the legend.
1306                 <paragraph>
1307                     A left-aligned figure:
1308                 <figure align="left" classes="figclass1 figclass2" width="70%">
1309                     <image alt="reStructuredText, the markup syntax" classes="class1 class2" uri="../../../docs/user/rst/images/biohazard.png" width="40px">
1310                     <caption>
1311                         This is the caption.
1312                     <legend>
1313                         <paragraph>
1314                             This is the legend.
1315                         <paragraph>
1316                             The legend may consist of several paragraphs.
1317                 <paragraph>
1318                     This paragraph might flow around the figure.
1319                 <paragraph>
1320                     The specific behavior depends upon the style sheet and the browser or
1321                     rendering software used.
1322                 <paragraph>
1323                     A centered figure:
1324                 <figure align="center">
1325                     <image uri="../../../docs/user/rst/images/biohazard.png" width="40px">
1326                     <caption>
1327                         This is the caption.
1328                     <legend>
1329                         <paragraph>
1330                             This is the legend.
1331                         <paragraph>
1332                             The legend may consist of several paragraphs.
1333                 <paragraph>
1334                     This paragraph might flow around the figure.
1335                 <paragraph>
1336                     The specific behavior depends upon the style sheet and the browser or
1337                     rendering software used.
1338                 <paragraph>
1339                     A right-aligned figure:
1340                 <figure align="right">
1341                     <image uri="../../../docs/user/rst/images/biohazard.png" width="40px">
1342                     <caption>
1343                         This is the caption.
1344                     <legend>
1345                         <paragraph>
1346                             This is the legend.
1347                         <paragraph>
1348                             The legend may consist of several paragraphs.
1349                 <paragraph>
1350                     This paragraph might flow around the figure. The specific behavior depends
1351                     upon the style sheet and the browser or rendering software used.
1352             <section ids="admonitions" names="admonitions">
1353                 <title auto="1" refid="id76">
1354                     <generated classes="sectnum">
1355                         2.14.3
1356                     Admonitions
1357                 <attention>
1358                     <paragraph>
1359                         Directives at large.
1360                 <caution>
1361                     <paragraph>
1362                         Don't take any wooden nickels.
1363                 <danger>
1364                     <paragraph>
1365                         Mad scientist at work!
1366                 <error>
1367                     <paragraph>
1368                         Does not compute.
1369                 <hint>
1370                     <paragraph>
1371                         It's bigger than a bread box.
1372                 <important>
1373                     <bullet_list bullet="-">
1374                         <list_item>
1375                             <paragraph>
1376                                 Wash behind your ears.
1377                         <list_item>
1378                             <paragraph>
1379                                 Clean up your room.
1380                         <list_item>
1381                             <paragraph>
1382                                 Call your mother.
1383                         <list_item>
1384                             <paragraph>
1385                                 Back up your data.
1386                 <note>
1387                     <paragraph>
1388                         This is a note.
1389                 <tip>
1390                     <paragraph>
1391                         15% if the service is good.
1392                 <warning>
1393                     <paragraph>
1394                         Strong prose may provoke extreme mental exertion.
1395                         Reader discretion is strongly advised.
1396                 <admonition classes="admonition-and-by-the-way">
1397                     <title>
1398                         And, by the way...
1399                     <paragraph>
1400                         You can make up your own admonition too.
1401                     <target ids="docutils" names="docutils" refuri="http://docutils.sourceforge.net/">
1402             <section ids="topics-sidebars-and-rubrics" names="topics,\ sidebars,\ and\ rubrics">
1403                 <title auto="1" refid="id77">
1404                     <generated classes="sectnum">
1405                         2.14.4
1406                     Topics, Sidebars, and Rubrics
1407                 <paragraph>
1408                     <emphasis>
1409                         Sidebars
1410                      are like miniature, parallel documents.
1411                 <sidebar>
1412                     <title>
1413                         Sidebar Title
1414                     <subtitle>
1415                         Optional Subtitle
1416                     <paragraph>
1417                         This is a sidebar.  It is for text outside the flow of the main
1418                         text.
1419                     <rubric>
1420                         This is a rubric inside a sidebar
1421                     <paragraph>
1422                         Sidebars often appear beside the main text with a border and a different
1423                         background or font color.
1424                 <paragraph>
1425                     A
1426                     <emphasis>
1427                         topic
1428                      is like a block quote with a title, or a self-contained section
1429                     with no subsections.
1430                 <topic>
1431                     <title>
1432                         Topic Title
1433                     <paragraph>
1434                         This is a topic.
1435                 <paragraph>
1436                     A
1437                     <emphasis>
1438                         rubric
1439                      is like an informal heading that doesn't correspond to the
1440                     document's structure. It is typically highlighted in red (hence the name).
1441                 <rubric>
1442                     This is a rubric
1443                 <paragraph>
1444                     Topics and rubrics can be used at places where a
1445                     <reference name="section title" refid="section-title">
1446                         section title
1447                      is not
1448                     allowed (e.g. inside a directive).
1449             <section ids="target-footnotes" names="target\ footnotes">
1450                 <title auto="1" refid="id78">
1451                     <generated classes="sectnum">
1452                         2.14.5
1453                     Target Footnotes
1454                 <footnote auto="1" backrefs="id26 id27 id28 id31" ids="id25" names="TARGET_NOTE:\ id25">
1455                     <label>
1456                         5
1457                     <paragraph>
1458                         <reference refuri="http://www.python.org/">
1459                             http://www.python.org/
1460                 <footnote auto="1" backrefs="id30" ids="id29" names="TARGET_NOTE:\ id29">
1461                     <label>
1462                         6
1463                     <paragraph>
1464                         <reference refuri="http://pygments.org/">
1465                             http://pygments.org/
1466                 <footnote auto="1" backrefs="id33" ids="id32" names="TARGET_NOTE:\ id32">
1467                     <label>
1468                         7
1469                     <paragraph>
1470                         <reference refuri="http://docutils.sourceforge.net/">
1471                             http://docutils.sourceforge.net/
1472             <section ids="replacement-text" names="replacement\ text">
1473                 <title auto="1" refid="id79">
1474                     <generated classes="sectnum">
1475                         2.14.6
1476                     Replacement Text
1477                 <paragraph>
1478                     I recommend you try
1479                     <reference refuri="http://www.python.org/">
1480                         Python,
1481                         <emphasis>
1482                             the
1483                          best language around
1484
1485                     <footnote_reference auto="1" ids="id28" refid="id25">
1486                         5
1487                     .
1488                 <substitution_definition names="Python">
1489                     Python,
1490                     <emphasis>
1491                         the
1492                      best language around
1493             <section ids="compound-paragraph" names="compound\ paragraph">
1494                 <title auto="1" refid="id80">
1495                     <generated classes="sectnum">
1496                         2.14.7
1497                     Compound Paragraph
1498                 <compound classes="some-class">
1499                     <paragraph>
1500                         Compound 1, paragraph 1.
1501                     <paragraph>
1502                         Compound 1, paragraph 2.
1503                     <bullet_list bullet="*">
1504                         <list_item>
1505                             <paragraph>
1506                                 Compound 1, list item one.
1507                         <list_item>
1508                             <paragraph>
1509                                 Compound 1, list item two.
1510                 <paragraph>
1511                     Another compound statement:
1512                 <compound>
1513                     <paragraph>
1514                         Compound 2, a literal block:
1515                     <literal_block xml:space="preserve">
1516                         Compound 2, literal.
1517                     <paragraph>
1518                         Compound 2, this is a test.
1519                 <compound>
1520                     <paragraph>
1521                         Compound 3, only consisting of one paragraph.
1522                 <compound>
1523                     <literal_block xml:space="preserve">
1524                         Compound 4.
1525                         This one starts with a literal block.
1526                     <paragraph>
1527                         Compound 4, a paragraph.
1528                 <paragraph>
1529                     Now something
1530                     <emphasis>
1531                         really
1532                      perverted -- a nested compound block.  This is
1533                     just to test that it works at all; the results don't have to be
1534                     meaningful.
1535                 <compound>
1536                     <paragraph>
1537                         Compound 5, block 1 (a paragraph).
1538                     <compound>
1539                         <paragraph>
1540                             Compound 6, block 2 in compound 5.
1541                         <paragraph>
1542                             Compound 6, another paragraph.
1543                     <paragraph>
1544                         Compound 5, block 3 (a paragraph).
1545                 <compound>
1546                     <paragraph>
1547                         Compound 7, with a table inside:
1548                     <table>
1549                         <tgroup cols="3">
1550                             <colspec colwidth="20">
1551                             <colspec colwidth="20">
1552                             <colspec colwidth="20">
1553                             <tbody>
1554                                 <row>
1555                                     <entry>
1556                                         <paragraph>
1557                                             Left cell, first
1558                                             paragraph.
1559                                         <paragraph>
1560                                             Left cell, second
1561                                             paragraph.
1562                                     <entry>
1563                                         <paragraph>
1564                                             Middle cell,
1565                                             consisting of
1566                                             exactly one
1567                                             paragraph.
1568                                     <entry>
1569                                         <paragraph>
1570                                             Right cell.
1571                                         <paragraph>
1572                                             Paragraph 2.
1573                                         <paragraph>
1574                                             Paragraph 3.
1575                     <paragraph>
1576                         Compound 7, a paragraph after the table.
1577                     <paragraph>
1578                         Compound 7, another paragraph.
1579             <section ids="parsed-literal-blocks" names="parsed\ literal\ blocks">
1580                 <title auto="1" refid="id81">
1581                     <generated classes="sectnum">
1582                         2.14.8
1583                     Parsed Literal Blocks
1584                 <literal_block xml:space="preserve">
1585                     This is a parsed literal block.
1586                         This line is indented.  The next line is blank.
1587
1588                     Inline markup is supported, e.g.
1589                     <emphasis>
1590                         emphasis
1591                     ,
1592                     <strong>
1593                         strong
1594                     ,
1595                     <literal>
1596                         literal
1597                         text
1598                     , footnotes
1599                     <footnote_reference ids="id22" refid="id8">
1600                         1
1601                     ,
1602                     <target ids="hyperlink-targets" names="hyperlink\ targets">
1603                         hyperlink targets
1604                     , and
1605                     <reference name="references" refuri="http://www.python.org/">
1606                         references
1607                     <target ids="references" names="references" refuri="http://www.python.org/">
1608                     .
1609             <section ids="code" names="code">
1610                 <title auto="1" refid="id82">
1611                     <generated classes="sectnum">
1612                         2.14.9
1613                     Code
1614                 <paragraph>
1615                     Blocks of source code can be set with the
1616                     <title_reference>
1617                         code
1618                      directive. If the code
1619                     language is specified, the content is parsed and tagged by the
1620                     <reference name="Pygments" refuri="http://pygments.org/">
1621                         Pygments
1622
1623                     <footnote_reference auto="1" ids="id30" refid="id29">
1624                         6
1625
1626                     syntax highlighter and can be formatted with a style sheet. (Code parsing
1627                     is turned off using the
1628                     <literal>
1629                         syntax-highlight
1630                      config setting in the test
1631                     conversions in order to get identical results with/without installed
1632                     Pygments highlighter.)
1633                 <literal_block classes="code python" xml:space="preserve">
1634                     print 'This is Python code.'
1635                 <paragraph>
1636                     There is an option for line numbers with optional start value:
1637                 <literal_block classes="code python" xml:space="preserve">
1638                     <inline classes="ln">
1639                          8
1640                     # print integers from 0 to 9:
1641                     <inline classes="ln">
1642                          9
1643                     for i in range(10):
1644                     <inline classes="ln">
1645                         10
1646                         print i
1647                 <paragraph>
1648                     For inline code snippets, there is the
1649                     <title_reference>
1650                         code
1651                      role, which can be used
1652                     directly (the code will not be parsed/tagged, as the language is not
1653                     known) or as base for special code roles, e.g.,
1654                 <comment xml:space="preserve">
1655                 <block_quote>
1656                     <paragraph>
1657                         Docutils uses LaTeX syntax for math directives and roles:
1658                         <literal classes="code latex tex">
1659                             \alpha = f(x)
1660                          prints
1661                         <math>
1662                             \alpha = f(x)
1663                         .
1664                 <target ids="pygments" names="pygments" refuri="http://pygments.org/">
1665         <section ids="substitution-definitions" names="substitution\ definitions">
1666             <title auto="1" refid="id65">
1667                 <generated classes="sectnum">
1668                     2.15
1669                 Substitution Definitions
1670             <paragraph>
1671                 An inline image (
1672                 <image alt="EXAMPLE" uri="../../../docs/user/rst/images/biohazard.png">
1673                 ) example:
1674             <substitution_definition names="EXAMPLE">
1675                 <image alt="EXAMPLE" uri="../../../docs/user/rst/images/biohazard.png">
1676             <paragraph>
1677                 (Substitution definitions are not visible in the HTML source.)
1678         <section ids="comments" names="comments">
1679             <title auto="1" refid="id66">
1680                 <generated classes="sectnum">
1681                     2.16
1682                 Comments
1683             <paragraph>
1684                 Here's one:
1685             <comment xml:space="preserve">
1686                 Comments begin with two dots and a space. Anything may
1687                 follow, except for the syntax of footnotes, hyperlink
1688                 targets, directives, or substitution definitions.
1689
1690                 Double-dashes -- "--" -- must be escaped somehow in HTML output.
1691
1692                 Comments may contain non-ASCII characters: ä ö ü æ ø å
1693             <paragraph>
1694                 (View the HTML source to see the comment.)
1695         <section ids="raw-text" names="raw\ text">
1696             <title auto="1" refid="id67">
1697                 <generated classes="sectnum">
1698                     2.17
1699                 Raw text
1700             <paragraph>
1701                 This does not necessarily look nice, because there may be missing white space.
1702             <paragraph>
1703                 It's just there to freeze the behavior.
1704             <raw format="html latex" xml:space="preserve">
1705                 A test.
1706             <raw format="html latex" xml:space="preserve">
1707                 Second test.
1708             <raw classes="myclass" format="html latex" xml:space="preserve">
1709                 Another test with myclass set.
1710             <paragraph>
1711                 This is the
1712                 <raw classes="myrawroleclass" format="html latex" xml:space="preserve">
1713                     fourth test
1714                  with myrawroleclass set.
1715             <raw format="html" xml:space="preserve">
1716                 Fifth test in HTML.<br />Line two.
1717             <raw format="latex" xml:space="preserve">
1718                 Fifth test in LaTeX.\\Line two.
1719         <section ids="container" names="container">
1720             <title auto="1" refid="id68">
1721                 <generated classes="sectnum">
1722                     2.18
1723                 Container
1724             <container classes="custom">
1725                 <paragraph>
1726                     paragraph 1
1727                 <paragraph>
1728                     paragraph 2
1729         <section ids="colspanning-tables" names="colspanning\ tables">
1730             <title auto="1" refid="id69">
1731                 <generated classes="sectnum">
1732                     2.19
1733                 Colspanning tables
1734             <paragraph>
1735                 This table has a cell spanning two columns:
1736             <table>
1737                 <tgroup cols="3">
1738                     <colspec colwidth="5">
1739                     <colspec colwidth="5">
1740                     <colspec colwidth="6">
1741                     <thead>
1742                         <row>
1743                             <entry morecols="1">
1744                                 <paragraph>
1745                                     Inputs
1746                             <entry>
1747                                 <paragraph>
1748                                     Output
1749                         <row>
1750                             <entry>
1751                                 <paragraph>
1752                                     A
1753                             <entry>
1754                                 <paragraph>
1755                                     B
1756                             <entry>
1757                                 <paragraph>
1758                                     A or B
1759                     <tbody>
1760                         <row>
1761                             <entry>
1762                                 <paragraph>
1763                                     False
1764                             <entry>
1765                                 <paragraph>
1766                                     False
1767                             <entry>
1768                                 <paragraph>
1769                                     False
1770                         <row>
1771                             <entry>
1772                                 <paragraph>
1773                                     True
1774                             <entry>
1775                                 <paragraph>
1776                                     False
1777                             <entry>
1778                                 <paragraph>
1779                                     True
1780                         <row>
1781                             <entry>
1782                                 <paragraph>
1783                                     False
1784                             <entry>
1785                                 <paragraph>
1786                                     True
1787                             <entry>
1788                                 <paragraph>
1789                                     True
1790                         <row>
1791                             <entry>
1792                                 <paragraph>
1793                                     True
1794                             <entry>
1795                                 <paragraph>
1796                                     True
1797                             <entry>
1798                                 <paragraph>
1799                                     True
1800         <section ids="rowspanning-tables" names="rowspanning\ tables">
1801             <title auto="1" refid="id70">
1802                 <generated classes="sectnum">
1803                     2.20
1804                 Rowspanning tables
1805             <paragraph>
1806                 Here's a table with cells spanning several rows:
1807             <table>
1808                 <tgroup cols="3">
1809                     <colspec colwidth="24">
1810                     <colspec colwidth="12">
1811                     <colspec colwidth="18">
1812                     <thead>
1813                         <row>
1814                             <entry>
1815                                 <paragraph>
1816                                     Header row, column 1
1817                                     (header rows optional)
1818                             <entry>
1819                                 <paragraph>
1820                                     Header 2
1821                             <entry>
1822                                 <paragraph>
1823                                     Header 3
1824                     <tbody>
1825                         <row>
1826                             <entry>
1827                                 <paragraph>
1828                                     body row 1, column 1
1829                             <entry>
1830                                 <paragraph>
1831                                     column 2
1832                             <entry>
1833                                 <paragraph>
1834                                     column 3
1835                         <row>
1836                             <entry>
1837                                 <paragraph>
1838                                     body row 2
1839                             <entry morerows="1">
1840                                 <paragraph>
1841                                     Cells may
1842                                     span rows.
1843                             <entry morerows="1">
1844                                 <paragraph>
1845                                     Another
1846                                     rowspanning
1847                                     cell.
1848                         <row>
1849                             <entry>
1850                                 <paragraph>
1851                                     body row 3
1852         <section ids="complex-tables" names="complex\ tables">
1853             <title auto="1" refid="id71">
1854                 <generated classes="sectnum">
1855                     2.21
1856                 Complex tables
1857             <paragraph>
1858                 Here's a complex table, which should test all features.
1859             <table>
1860                 <tgroup cols="4">
1861                     <colspec colwidth="24">
1862                     <colspec colwidth="12">
1863                     <colspec colwidth="10">
1864                     <colspec colwidth="10">
1865                     <thead>
1866                         <row>
1867                             <entry>
1868                                 <paragraph>
1869                                     Header row, column 1
1870                                     (header rows optional)
1871                             <entry>
1872                                 <paragraph>
1873                                     Header 2
1874                             <entry>
1875                                 <paragraph>
1876                                     Header 3
1877                             <entry>
1878                                 <paragraph>
1879                                     Header 4
1880                     <tbody>
1881                         <row>
1882                             <entry>
1883                                 <paragraph>
1884                                     body row 1, column 1
1885                             <entry>
1886                                 <paragraph>
1887                                     column 2
1888                             <entry>
1889                                 <paragraph>
1890                                     column 3
1891                             <entry>
1892                                 <paragraph>
1893                                     column 4
1894                         <row>
1895                             <entry>
1896                                 <paragraph>
1897                                     body row 2
1898                             <entry morecols="2">
1899                                 <paragraph>
1900                                     Cells may span columns.
1901                         <row>
1902                             <entry>
1903                                 <paragraph>
1904                                     body row 3
1905                             <entry morerows="1">
1906                                 <paragraph>
1907                                     Cells may
1908                                     span rows.
1909                                 <paragraph>
1910                                     Paragraph.
1911                             <entry morecols="1" morerows="1">
1912                                 <bullet_list bullet="-">
1913                                     <list_item>
1914                                         <paragraph>
1915                                             Table cells
1916                                     <list_item>
1917                                         <paragraph>
1918                                             contain
1919                                     <list_item>
1920                                         <paragraph>
1921                                             body elements.
1922                         <row>
1923                             <entry>
1924                                 <paragraph>
1925                                     body row 4
1926                         <row>
1927                             <entry>
1928                                 <paragraph>
1929                                     body row 5
1930                             <entry morecols="1">
1931                                 <paragraph>
1932                                     Cells may also be
1933                                     empty:
1934                                     <literal>
1935                                         -->
1936                             <entry>
1937         <section ids="list-tables" names="list\ tables">
1938             <title auto="1" refid="id72">
1939                 <generated classes="sectnum">
1940                     2.22
1941                 List Tables
1942             <paragraph>
1943                 Here's a list table exercising all features:
1944             <table classes="test">
1945                 <title>
1946                     list table with integral header
1947                 <tgroup cols="3">
1948                     <colspec colwidth="10" stub="1">
1949                     <colspec colwidth="20">
1950                     <colspec colwidth="30">
1951                     <thead>
1952                         <row>
1953                             <entry>
1954                                 <paragraph>
1955                                     Treat
1956                             <entry>
1957                                 <paragraph>
1958                                     Quantity
1959                             <entry>
1960                                 <paragraph>
1961                                     Description
1962                     <tbody>
1963                         <row>
1964                             <entry>
1965                                 <paragraph>
1966                                     Albatross
1967                             <entry>
1968                                 <paragraph>
1969                                     2.99
1970                             <entry>
1971                                 <paragraph>
1972                                     On a stick!
1973                         <row>
1974                             <entry>
1975                                 <paragraph>
1976                                     Crunchy Frog
1977                             <entry>
1978                                 <paragraph>
1979                                     1.49
1980                             <entry>
1981                                 <paragraph>
1982                                     If we took the bones out, it wouldn't be
1983                                     crunchy, now would it?
1984                         <row>
1985                             <entry>
1986                                 <paragraph>
1987                                     Gannet Ripple
1988                             <entry>
1989                                 <paragraph>
1990                                     1.99
1991                             <entry>
1992                                 <paragraph>
1993                                     On a stick!
1994     <section ids="error-handling" names="error\ handling">
1995         <title auto="1" refid="id73">
1996             <generated classes="sectnum">
1997                 3
1998             Error Handling
1999         <paragraph>
2000             Any errors caught during processing will generate system messages.
2001         <paragraph>
2002             There should be five messages in the following, auto-generated
2003             section, "Docutils System Messages":
2004         <comment xml:space="preserve">
2005             section should be added by Docutils automatically
2006     <section classes="system-messages">
2007         <title>
2008             Docutils System Messages
2009         <system_message backrefs="id24" ids="id23" level="3" line="104" source="functional/input/data/standard.txt" type="ERROR">
2010             <paragraph>
2011                 Undefined substitution referenced: "problematic".
2012         <system_message backrefs="id84" ids="id83" level="3" line="391" source="functional/input/data/standard.txt" type="ERROR">
2013             <paragraph>
2014                 Unknown target name: "5".
2015         <system_message backrefs="id86" ids="id85" level="3" line="400" source="functional/input/data/standard.txt" type="ERROR">
2016             <paragraph>
2017                 Unknown target name: "nonexistent".
2018         <system_message backrefs="id88" ids="id87" level="3" line="427" source="functional/input/data/standard.txt" type="ERROR">
2019             <paragraph>
2020                 Unknown target name: "hyperlink reference without a target".
2021         <system_message backrefs="id90" ids="id89" level="3" line="440" source="functional/input/data/standard.txt" type="ERROR">
2022             <paragraph>
2023                 Duplicate target name, cannot be used as a unique reference: "duplicate target names".