DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:rst

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
plugin:rst [2015-10-07 14:58] – created chrisisbdplugin:rst [2019-09-14 22:20] (current) – Dokuwiki to DokuWiki Aleksandr
Line 2: Line 2:
  
 ---- plugin ---- ---- plugin ----
-description: Allows use of RestructuredText in Dokuwiki +description: Allows use of RestructuredText in DokuWiki 
-author     : chrisisbd  +author     : chrisisbd 
-email      : chris@isbd.co.uk +email      : chris@isbd.co.uk
 type       : syntax type       : syntax
 lastupdate : 2015-10-07 lastupdate : 2015-10-07
 compatible :  compatible : 
-depends    : Docutils+depends    : # refer here only plugins or templates for DokuWiki
 conflicts  conflicts 
 similar    : Markdown, markdownExtra similar    : Markdown, markdownExtra
-tags       : +tags       : rst, RestructuredText,formatting, markup_language 
  
-downloadurl: # eg. http://github.com/chrisisbd/dokuwiki-plugin-rst/zipball/master +downloadurl: https://bitbucket.org/chrisisbd/dokuwiki-plugin-rst/get/ccb6a7581c70.zip 
-bugtracker : # eg. http://github.com/chrisisbd/dokuwiki-plugin-rst/issues +bugtracker : https://bitbucket.org/chrisisbd/dokuwiki-plugin-rst/issues 
-sourcerepo : # eg. http://github.com/chrisisbd/dokuwiki-plugin-rst/+sourcerepo : https://chrisisbd@bitbucket.org/chrisisbd/dokuwiki-plugin-rst
 donationurl:  donationurl: 
  
 screenshot_img :  screenshot_img : 
 ---- ----
- 
-//:!: This template contains various hints on how to fill in data (formatted in italics). Be sure to remove the hints and unwanted sections (Eg. the Syntax/Example section for non-syntax plugins.// 
  
 ===== Installation ===== ===== Installation =====
  
-//[First, last and only chance to warn users before installing (some has already done that before reading this)]//+**External requirements:**
  
-:!: **External requirements:** This plugin requires the following additional components that must be installed separately:  +The rst plugin requires the following additional components that must be installed separately: 
-  * [[A banana]] +
-  * [[Another banana]]+
  
-Install the plugin using the [[plugin:plugin|Plugin Manager]] and the download URL above, which points to latest version of the pluginRefer to [[:Plugins]] on how to install plugins manually.+  * Docutils - see http://docutils.sourceforge.net/
  
-===== Examples/Usage ===== 
  
-//[Most people learn by example, so this goes first]//+Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]on how to install plugins manually.
  
-See the plugin in action [[www.demosite.com|here]]. The sample page shows all the styles available with the plugin.+===== Examples/Usage =====
  
-A simple box:+The plugin accepts all the RestructuredText syntax described at http://docutils.sourceforge.net/. There are  
 +two ways to use it, either with <rst> directives in an existing Dokuwiki page or by creating pages with a .rst  
 +suffix.
  
-  <box> the box contents </box>+==Using directives==
  
-Some more complex boxes+Just wrap the RestructuredText in the directives:-
  
-  <box 80% round orange|a title> the box contents</box+  <rst
-  <box 50% left blue>the box contents</box|a caption> +  This is restructured text 
-  <box 60% round #f99 #fc9 #fcc #f60|title>the box contents></box|caption>+  </rst>
  
-//[Pictures showing the rendered result will help users to understand]//+==Filename with .rst suffix==
  
-===== Syntax =====+Create a new page, if you create a link to a new page called newpage.rst within Dokuwiki the page will 
 +actually have the filename newpage.rst.txt, this will be recognised by the plugin and will be parsed 
 +as RestructuredText.  You can of course create pages by other means, just ensure they are of the form  
 +pagename.rst.txt.
  
-//[Complete syntax]// 
  
-Basic syntax: 
-<code>{{actionlink>action|title}}</code> 
-  * **action** can be one of this: 
-    * //edit//    --- edit/create/show 
-    * //history// --- old revisions 
  
-===== Configuration and Settings ===== 
- 
-//[also CSS style tips]// 
- 
-===== Development ===== 
- 
-//[downloadable blocks, development comments]// 
  
 === Change Log === === Change Log ===
  
-//[preferable GitHub RSS feed or similar]// 
  
-  * **2009-01-01** 
-    * Initial release 
  
 === Known Bugs and Issues === === Known Bugs and Issues ===
  
-//[this section might not be needed in case of external bug manager, or use RSS feed]//+  * Appears to be broken with 2018-04-22b "Greebo" release. The ''<rst></rst>'' block doesn't generate an error but text in the block isn't rendered.
  
 === ToDo/Wish List === === ToDo/Wish List ===
- 
-//[developers roadmap]// 
  
 ===== FAQ ===== ===== FAQ =====
  
-//[discussions should ideally be deleted and turned into FAQ entries along the way]//+
  
 ===== Discussion ===== ===== Discussion =====
  
-//Could be placed on an external page (e.g. plugin:pluginname:discussion) to have a distinction between user comments and author docs// 
  
  
  
plugin/rst.1444222724.txt.gz · Last modified: 2015-10-07 14:58 by chrisisbd

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki