Some Tests for the LaTeX Writer =============================== These tests have been written to exercise some unusual combinations of syntax elements which may cause trouble for the LaTeX writer but do not need to be tested with other writers (e.g. the HTML writer). This file is not yet used by any automated test. It is currently only used to control the visual appearance of the output. Block Quotes ------------ This block quote comes directly after the section heading and is followed by a paragraph. This is the second paragraph of the block quote and it contains some more text filling up some space which would otherwise be empty. -- Attribution This is a paragraph. This block quote does not have an attribution. This is another paragraph. Another block quote at the end of the section. More Block Quotes ----------------- Block quote followed by a transition. ---------- Another block quote. Sidebars -------- This paragraph precedes the sidebar. This is some text. This is some text. This is some text. This is some text. This is some text. This is some text. This is some text. This is some text. .. sidebar:: Sidebar Title These are the sidebar contents. These are the sidebar contents. These are the sidebar contents. These are the sidebar contents. These are the sidebar contents. These are the sidebar contents. These are the sidebar contents. These are the sidebar contents. This paragraph follows the sidebar. This is some text. This is some text. This is some text. This is some text. This is some text. This is some text. This is some text. This is some text. This is some text. This is some text. Next Section ------------ This section comes after the sidebar, and this text should float around the sidebar as well. This is some text. This is some text. This is some text. This is some text. This is some text. This is some text. This is some text. This is some text. This is some text. This is some text. This is some text. This is some text. This is some text. This is some text. This is some text. This is some text. This is some text. This is some text. This is some text. This is some text. This is some text. This is some text. This is some text. This is some text. Nested Elements --------------- :Field list: | Line | Block :Field 2: * Bullet * list :Another (longer) field: * Bullet * list :Yet another long field: * .. comment Bullet .. comment * .. comment list .. comment :Field: * This is a * bullet list :Field: * | This is | a bullet * | list with | line blocks :Last field: Last field. Too deeply nested lists fail. TODO: generate an error or provide a workaround. .. * * * * * * * * Deeply nested list. .. 1. 2. 3. 4. 5. 6. 7. 8. Deeply nested list. +-----------------+ | | Line block | | | | * Bullet list | | | | :: | | | | Literal | | block | +-----------------+ | :Field 1: | | Text. | | :Field 2: | | More text. | +-----------------+ | +-------+-----+ | | | A |* foo| | | | nested| | | | | table.|* bar| | | +-------+-----+ | +-----------------+ | This is a | | paragraph. | | | | +-------+-----+ | | | A |* foo| | | | nested| | | | | table.|* bar| | | +-------+-----+ | | | | Another longer | | paragraph. | +-----------------+ | * A list. | | * A list. | | | | +-------+-----+ | | | A |* foo| | | | nested| | | | | table.|* bar| | | +-------+-----+ | | | | * Another list. | | * Another list. | +-----------------+ | Foo | | | | Bar | +-----------------+ | * Foo | | | | * Bar | +-----------------+ | * This is a | | paragraph. | | | | This is a | | paragraph. | | | | * This is a | | paragraph. | | | | This is a | | paragraph. | +-----------------+ Images ------ Image with 20% width: .. image:: ../../../../docs/user/rst/images/title.png :width: 20% Image with 100% width: .. image:: ../../../../docs/user/rst/images/title.png :width: 100% Vertical alignment of inline images ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. |top| image:: ../../../../docs/user/rst/images/biohazard.png :align: top .. |middle| image:: ../../../../docs/user/rst/images/biohazard.png :align: middle .. |bottom| image:: ../../../../docs/user/rst/images/biohazard.png :align: bottom A paragraph containing top |top|, middle |middle|, and bottom |bottom| aligned images. Rowspanning tables ------------------ Several rowspanning cells in a table. .. Problem: In the LaTeX `multicol` package, if there are multirow cells, the "overwritten" cells need to be defined as empty cells. Docutils (similarily to HTML) uses is the "Exchange Table Model" (also known as CALS tables, see docs/ref/soextblx.dtd) which defines only the remaining cells in a row "affected" by multirow cells. Therefore, visit_entry() is only called for the remaining cells and the LaTeX writer needs bookkeeping to write out the required number of extra '&'s. .. class:: standard +-----------+------------+------------------+-----------+ | cell 11 | cell 12 | cell 13 | cell 41 | +-----------+------------+------------------+-----------+ | cell 12 | Cell a | | cell 42 | +-----------+ | +-----------+ | cell 13 | | cell b | cell 43 | +-----------+------------+------------------+-----------+ .. class:: standard +------------+------------------+-----------+ | cell 12 | cell 13 | cell 41 | +------------+------------------+-----------+ | Cell a | | cell 42 | + | +-----------+ | | cell b | cell 43 | +------------+------------------+-----------+ .. class:: standard +-----------+------------+-----------+ | cell 11 | cell 12 | cell 41 | +-----------+------------+-----------+ | cell 12 | Cell a | cell 42 | +-----------+ +-----------+ | cell 13 | | cell 43 | +-----------+------------+-----------+