#format rst #language en Real title ========== Real subtitle ------------- Above are real reST titles and subtitle. Need to be first in reST to get rendered as such. However, in MoinMoin they are not rendered as titles. Discussion__ .. __: /Talk .. The next lines gives an overview over all subpages automatically Subpages: .. macro:: [[Navigation(children, 1)]] .. contents:: Contents of this page .. StartInclude {{{#!rst A page to play around with design features of reStructuredText. .. _sidebar: .. _sidebars: .. sidebar:: How do sidebars look like? This is what I'm really interested in: * Does a sidebar work? * Where is it rendered to on the output? The standard CSS style sheet does not know about a ``
`` :-( . However, I ``@import``\ed a style sheet for reStructuredText and things work fine :-) . In V1.5.4 there is also a `stylesheets` option which helps here. Main text may contain a sidebar as it is the case here (above this paragraph). Title ===== A title should work as expected. Subtitle -------- And a subtitle as well. .. }}} EndInclude And what about images? The options for images in most Wiki languages are rather reduced. How is it here? .. image:: tuxLiberty.png :alt: Tux of Liberty. :align: right Scaling doesn't work - may be because of a missing PIL library A figure has even more useful options. Do they work as well? .. figure:: tuxLiberty.png :alt: Tux of Liberty. :align: center :figwidth: image Tux of Liberty The crown and the torch are taken from the statue of liberty. The rest is taken from the famous Linux mascot. Alignment seems to work. Including text besides the image if the image is bigger. Things like ``

`` and ``

`` work when CSS support is given. Text in boxes ============= Sidebars work as proven above. The question was whether there are more options to create a box around a text. This means more or less what the CSS says and as such could be changed there. .. highlights:: However, the ``.. highlights::`` directive could be the syntax element we are looking for. * As usual in reStructuredText this should be flexible. * And for instance bulleted lists should be possible. As always the highlighted section ends with the text being indented no more. Well, highlights seem not to be supported by the reStructuredText-CSS currently used. However, simple plain admonitions seem to do what we want: .. admonition:: An title for the admonition Again arbitrary content can go in the body of the admonition. Works :-) . Smilies ======= .. include:: OekonuxWiki/Supplements/RstSmilies |(!)| |:(| |:-(| |:-?| |:o| || |B)| |{*}| |{3}| |{i}| |(./)| |:)| |:-)| |:D| |;)| |<:(| |B-)| |{1}| |{OK}| |{o}| |/!/| |:))| |:-))| |:/| |;-)| |>:>| |X-(| |{2}| |{X}| Links ===== Parent page ----------- 1. `..`__ __ .. 2. `../`__ __ ../ Works well for reStructuredText. 3. `/../`__ __ /../ Works for reStructuredText but only if HTTP/browser contracts path. 4. `wiki:..`__ __ wiki:.. 5. `wiki:../`__ __ wiki:../ 6. `wiki:/../`__ __ wiki:/../ 7. `wiki:Self:..`__ __ wiki:Self:.. 8. `wiki:Self:../`__ __ wiki:Self:../ 9. `wiki:Self:/../`__ __ wiki:Self:/../ 10. `Self:..`__ __ Self:.. 11. `Self:../`__ __ Self:../ 12. `Self:/../`__ __ Self:/../ Other relatives --------------- * `../reSTInclude`__ __ ../reSTInclude Works well. * `../../Oekonux/Introduction`__ __ ../../Oekonux/Introduction Works well. * `../reSTInclude`_ Direct links also work well. * `/Subpage`_ Works well. Anchors on external pages ------------------------- * `../reSTInclude#header-1`_ ``#`` gets URL-encoded normally but works with patch * `../reSTInclude#header-1`__ __ ../reSTInclude#header-1 ``#`` gets URL-encoded normally but works with patch Signatures and the like ======================= Macro substitution generally works. But does it for signatures? |SIG| .. |SIG| macro:: -- StefanMerten [[DateTime(2007-11-17T18:42:05Z)]] Not very well. In particular the macro seems to be rendered as a block in any case. Also the brackets are shown as well. What about multiple |SIG1| substitutions? .. |SIG1| macro:: -- StefanMerten [[DateTime(2007-11-17T18:44:44Z)]] No, multiple substitutions don't work :-( . What would be needed is a real substitution depending on the format. This would also work for creation of good code. Should check whether this idea is already made real in more recent MoinMoin versions. There could be a style in reStructuredText which expands the content as a macro. This would guarantee that it is inline. Then a definition of SIG could be really nice in expanding to a reST link and a macro containing the date. Actually there is another hack working inline: `[[Date(2007-11-18T21:27:36Z)]]`_ (which is actually a "@ DATE @" as a link). However, this does not produce nice output since there is still a

at the beginning of the included HTML. This makes the substitution idea superfluous - though a real style would still be better than this hack. Special body elements ===================== Beyond sidebars_ reST supports a number of other `special body elements`_. How does embedding in MoinMoin work? .. _special body elements: http://docutils.sourceforge.net/docs/ref/rst/directives.html#body-elements .. topic:: A *topic* block A separate block of text not contained in the normal flow. For instance used to explain a notion used in the main text. Some normal text after the topic. .. rubric:: A *rubric* A rubric is like an informal heading that doesn't correspond to the document's structure. .. epigraph:: An *epigraph* is an apposite (suitable, apt, or pertinent) short inscription, often a quotation or poem, at the beginning of a document or section. -- http://docutils.sourceforge.net/docs/ref/rst/directives.html#epigraph Some normal text after the epigraph. .. highlights:: * A *highlights* block is used * to stand out * a couple of key points * for instance Some normal text after the highlights. .. pull-quote:: A *pull-quote* is a small selection of text "pulled out and quoted", typically in a larger typeface. Pull-quotes are used to attract attention, especially in long articles. Some normal text after the pull-quote. .. container:: center This is part of a *container* which in this case has a class *center*. The class, however, needs to be supported by the stylesheet to be useful. Some text after the container.