====================================== ReStructuredTextMoinMoinTestDocument ====================================== ------------------------------------- A senseless ReStructuredText document ------------------------------------- :Author: PascalVolk_ :Date: 2010-01-31 :Version: 0.0.1 :Category: MoinMoinBug_ .. contents:: :backlinks: top Synopsis ======== None Description =========== This document is only for demonstration purpose. IMHO: Currently there are three *missing* or *not fully supported* features for ReStructuredText_-baesd wiki pages. Not supported ============= Lost anchors in definition lists -------------------------------- The examples section contains a definition list with three items. Each list entry has its own unique anchor. If I would convert this document (ReStructuredTextMoinMoinTestDocument.rst_) with **rst2html**, a click on one of following three links would bring me to the corresponding list entry: * example.fortune_one_ * example.fortune_two_ * example.fortune_three_ The anchor for example.searched_words_ will be included in the rendered page. Highlighting of searched words ------------------------------ Assumed a full-text search was performed, and the search yields some results (`Search result links`_), the links of the listed search results contains a query string for highlighting the searched words. But the searched words wouldn't be highlighted. Not translated admonition titles -------------------------------- docutils tools like ``rst2man`` or ``rst2html`` knows the option ``--language=XX``. If this option is given, the admonition titles will be translated in the specified language. For testing purpose I've installed all German help and system pages (shouldn't have been necessary). Set the `Preferred language` in my profile settings to German (shouldn't have been necessary). I've also added the following both processing instructions to the reST-based wiki page:: #format rst #language de But the titles of the admonitions weren't translated. When I use the command ``rst2html --language=de ReStructuredTextMoinMoinTestDocument.rst ReStructuredTextMoinMoinTestDocument.html`` to convert the attached reST file (ReStructuredTextMoinMoinTestDocument.rst_) to HTML, the result will be ReStructuredTextMoinMoinTestDocument.html_. Examples ======== Some examples for the problems described above. Lost anchors ------------ A definition list, with an anchor for each definition term. The links to list items are above (`Lost anchors in definition lists`_). Here comes the definition list: .. _example.fortune_one: ``Fortune № 1`` Be free and open and breezy! Enjoy! Things won't get any better so get used to it. .. _example.fortune_two: ``Fortune № 2`` Don't look back, the lemmings are gaining on you. .. _example.fortune_three: ``Fortune № 3`` There was a phone call for you. Missing highlighting -------------------- Follow the `ReStructuredTextMoinMoinTestDocument` link to reload this page with the `highlight` query string. Search result links ~~~~~~~~~~~~~~~~~~~ Follow this link. http://moinmo.in/FindPage?action=fullsearch&advancedsearch=1&and_terms=Drafts+Sent+Trash+Niewys%C5%82ane+Wys%C5%82ane+%C5%9Amietnik&or_terms=¬_terms=&mtime=&categories=&language=&mimetype= .. _example.searched_words: This paragraph contains the words, which should be highlighted. Common mailbox folder names: Drafts, Sent and Trash. Or in Polish language: Niewysłane, Wysłane and Śmietnik. Additonally it has the ``id="example-searched-words"``-attribute`. Admonitions ----------- .. attention:: The `hint` directive seems not be supported by MoinMoin. And `attention` should be translated to MoinMoin's `warning` admonition. .. hint:: Um aus *Note* (``.. note:: …``) eine *Bemerkung*, aus *Tip* (``.. tip:: …``) einen *Tipp* und aus *Hint* (``.. hint:: …``) einen *Hinweis* zu machen, verpasst man **rst2html** die Option ``--language=de``. .. tip:: Kinder, esst keinen gelben Schnee. .. note:: Es folgt noch mehr sinnloser Text. Aber nur um die Seite etwas in die `Länge zu ziehen`, damit der Klick auf example.searched_words_ auch zum Ziel führt. Nicht etwa weil ich meiner Tastatur ein paar Anschläge schulde. Ein fettes `Lorem Ipsum` sollte dazu sachdienlich sein. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi iaculis vulputate odio, dictum suscipit magna rhoncus non. Sed ligula enim, adipiscing eu rhoncus non, blandit et lectus. Phasellus sit amet magna felis. Suspendisse ac risus ac nisl ultrices consectetur a ac odio. Suspendisse potenti. Vivamus facilisis augue sit amet risus adipiscing mollis. Vestibulum imperdiet malesuada eros eget euismod. Proin eu nunc diam, sed eleifend lacus. Quisque vulputate tincidunt pretium. Vivamus egestas suscipit nunc eu congue. Praesent orci neque, blandit posuere auctor vitae, facilisis vel ante. Fusce facilisis tristique enim in accumsan. Aliquam erat volutpat. Duis rutrum aliquam nulla, a aliquet magna tincidunt sodales. In tempor feugiat diam, eget auctor ante malesuada non. Pellentesque at velit quam. Aliquam dapibus varius erat. Nulla ac purus neque. Suspendisse gravida velit eu elit pellentesque rhoncus. Integer tincidunt dolor eu eros elementum euismod. Cras scelerisque laoreet pulvinar. Fusce eget placerat ante. Aenean a magna magna, nec tempor sapien. Quisque commodo magna sit amet enim auctor iaculis. Nulla quis elementum dui. In rhoncus, urna semper lacinia porttitor, est elit imperdiet diam, et tristique diam tellus sit amet mauris. Vivamus ac quam velit. Proin quis dui ante, ut commodo neque. Praesent in lorem tortor. Suspendisse vel velit mauris. Quisque scelerisque posuere risus, id aliquet est blandit sed. Morbi rutrum lacus ac neque rhoncus facilisis. Donec rutrum nunc vulputate libero volutpat ultrices. Curabitur egestas sollicitudin laoreet. Curabitur dictum leo non tortor elementum ac luctus dui commodo. Maecenas ante elit, mattis non sagittis vitae, posuere eget turpis. Aenean aliquet nisi eget magna tincidunt accumsan. Curabitur sit amet mauris vitae ligula suscipit mollis sed ut odio. Integer laoreet, dolor in scelerisque sollicitudin, erat sem consectetur sem, et pulvinar lorem libero at erat. Nam quis metus eget tellus ultrices viverra. Integer ullamcorper aliquet aliquam. Nam vulputate faucibus mi, in dapibus odio condimentum in. Nunc vestibulum tortor adipiscing justo tempor id pharetra nibh porttitor. Fusce sapien eros, egestas ac porttitor non, aliquam placerat arcu. Aliquam purus mauris, auctor in ornare vel, auctor vitae arcu. Curabitur scelerisque tristique eros sed feugiat. Nam ipsum est, commodo eu dignissim nec, iaculis eget augue. Ut quis elit turpis. Cras eu vehicula sem. Nulla facilisi. Aliquam venenatis eleifend luctus. Integer aliquet accumsan blandit. Donec consectetur consectetur diam, sed porttitor neque ultricies sed. Integer at mollis dolor. Phasellus fringilla iaculis magna a sollicitudin. Nullam id nisi enim. Morbi quis erat sed tellus dapibus placerat fringilla a nisi. Praesent vehicula, lacus vitae vehicula faucibus, est elit tristique lorem, a ornare dolor justo vitae ante. Nam tincidunt iaculis libero non aliquam. Vestibulum rutrum congue pellentesque. Sed tincidunt, urna in lobortis molestie, magna diam cursus purus, et pharetra tortor tortor ut est. .. _MoinMoinBug: http://moinmo.in/CategoryMoinMoinBug .. _PascalVolk: http://moinmo.in/PascalVolk .. _ReStructuredText: http://moinmo.in/ReStructuredText .. _ReStructuredTextMoinMoinTestDocument.rst: ReStructuredTextMoinMoinTestDocument.rst .. _ReStructuredTextMoinMoinTestDocument.html: ReStructuredTextMoinMoinTestDocument.html