WordPress.org

Plugin Directory

!This plugin hasn't been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

WordPreSt

A reStructuredText editor enhancement for WordPress.

What is reStructuredText?

Straight from the horses mouth:

"reStructuredText is an easy-to-read, what-you-see-is-what-you-get plaintext markup syntax and parser system. It is useful for in-line program documentation (such as Python docstrings), for quickly creating simple web pages, and for standalone documents. reStructuredText is designed for extensibility for specific application domains. The reStructuredText parser is a component of Docutils. reStructuredText is a revision and reinterpretation of the StructuredText and Setext lightweight markup systems.

-- reStructuredText Home Page

Why Not Just Use Markdown?

Markdown is a great text format (and conversion tool) and I'm a huge Gruber fan and all, but it's really quite limited in the grand scheme of document management. Markdown is not multi-document aware, meaning it only knows about the one file it is parsing at a time, and lacks the ability to link between internal references across files. A few of its features are add-ons requiring plugins, which are not available in every implementation of Markdown either. It's a generally less-configurable format as well, where reSt provides extensive optional settings for various elements.

Perhaps most importantly though, reStructuredText has many output convertors allowing you to write once, parse a thousand times, into almost any conceivable format out there. If the output format you desire does not exist, it's (fairly) trivial to create your own. Markdown is strictly an (X)HTML convertor which severely limits your options if you want to publish your documents across different media.

How do I install Docutils?

If you have shell access to your hosting server, you may be able to simply run easy_install docutils. If easy_install is not available, you will need to download and install Docutils according to the instructions on the Docutils home page.

This is awesome! Can I Give You Some Money?

Wow, I'm flattered! I'm also very broke, so that works out perfectly! Of course I'll accept donations, and the guys over at GitHub have been nice enough to hook me up with a Pledgie account to make it incredibly easy for you to show your gratitude for my hard work. Any amount would be greatly appreciated.

Requires: 2.7 or higher
Compatible up to: 2.9.2
Last Updated: 2010-1-19
Active Installs: 10+

Ratings

0 out of 5 stars

Support

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,2,2