WordPreSt adds a reStructuredText input mode to the WordPress post\/page \neditor. Once installed, reStructuredText may be input directly into the\neditor and converted to HTML with the click of a mouse. The reSt source \nis saved with each post\/page for future edits. The rendered HTML output \nis stored as the actual post content to allow modification after \nrendering if desired. Plugin settings control the features of the reSt \nconvertor and include automatic table of contents links, post title \ngeneration from reSt, header level customization, and others. A \"View \ndocument source\" link is also (optionally) available for each post.<\/p>\n\n
WordPreSt requires no template modifications and every effort has been \nmade to ensure a truly seamless integration into WordPress.<\/p>\n\n\n
Install Docutils<\/a> on your \nWordPress hosting server.<\/p><\/li>\n Download the latest stable WordPreSt release from the \nGitHub page<\/a>.<\/p><\/li>\n Unzip the plugin package into the Activate the plugin through the \"Plugins\" admin menu in WordPress.<\/p><\/li>\n Configure the WordPreSt settings (in the \"Settings\" admin menu) and \nprovide an absolute path to the Docutils Straight from the horses mouth:<\/p>\n\n \"reStructuredText is an easy-to-read, what-you-see-is-what-you-get \n plaintext markup syntax and parser system. It is useful for in-line \n program documentation (such as Python docstrings), for quickly \n creating simple web pages, and for standalone documents. reStructuredText \n is designed for extensibility for specific application domains. The \n reStructuredText parser is a component of \n Docutils<\/a>. reStructuredText \n is a revision and reinterpretation of the \n StructuredText<\/a> \n and Setext<\/a>\n lightweight markup systems.<\/p>\n \n -- reStructuredText Home Page<\/a><\/p>\n<\/blockquote><\/dd>\n Markdown<\/a> is a great text \nformat (and conversion tool) and I'm a huge Gruber<\/a> \nfan and all, but it's really quite limited in the grand scheme\nof document management. Markdown is not multi-document aware, meaning it\nonly knows about the one file it is parsing at a time, and lacks the\nability to link between internal references across files. A few of its\nfeatures are add-ons requiring plugins, which are not available in every\nimplementation of Markdown either. It's a generally less-configurable\nformat as well, where reSt provides extensive optional settings for\nvarious elements.<\/p>\n\n Perhaps most importantly though, reStructuredText has many output convertors\nallowing you to write once, parse a thousand times, into almost any conceivable\nformat out there. If the output format you desire does not exist, it's \n(fairly) trivial to create your own. Markdown is strictly an (X)HTML \nconvertor which severely limits your options if you want to publish your\ndocuments across different media.<\/p><\/dd>\n If you have shell access to your hosting server, you may be able to simply run\n easy_install docutils. If Wow, I'm flattered! I'm also very broke, so that works out perfectly! Of course\nI'll accept donations, and the guys over at GitHub<\/a> have \nbeen nice enough to hook me up with a Pledgie account<\/a> \nto make it incredibly easy for you to show your gratitude for my hard work. \nAny amount would be greatly appreciated.<\/p><\/dd>\n\n<\/dl>\n\n\n\/wp-content\/plugins\/<\/code> directory. The \nzip file will automatically extract into a wordprest<\/code> subdirectory.<\/p><\/li>\nrst2html.py<\/code> script. \nWordPreSt does its best to locate the script automatically, but \noften requires manual configuration.<\/p><\/li>\n<\/ol>\n\n\n\n
\n
easy_install<\/code> is not available, you will need \nto download and install Docutils according to the instructions on the \nDocutils<\/a> home page.<\/p><\/dd>\n1.0<\/h4>\n\n
\n