It's not a whole new story, but I'll join the advent calendar to organize what I've made earlier.
First of all I liked setext (structured text). So of course I like reST. Markdown will do most of the work if you don't say the details, but I use reST to make Office files and make adjustments for printing.
Naturally because it is reST
Is used. The installation method is folded. it's simple.
The first step is "quickly turn the preview".
So I use guard, my favorite Ruby tool that is as good as or better than reST. This is a library for monitoring file changes and doing various things, here
I will have you take on the two tasks of. The following three libraries are actually used.
As a web server, use SimpleHTTPServer of Python or WEBrick of Ruby as appropriate.
is.
reST-writing environment with realtime HTML-preview — Gist
If there is no problem with the content in the preview, this time my work
To use. Git clone this and rename the target rst file to sample.rst. What this guy can do
is. Unfortunately, both the reST file and the odt file have been left untouched for two years with the name sample, and I only use the Mac, thinking that open should use a library that abstracts this. It is as it is because it is not.
After opening the odt file, adjust the style for printing, and if you notice any mistakes at this stage, modify the rst file each time.
rake open
It will be a flow to do.
Finally, I think it's easier to share if you export the PDF from LibreOffice (OpenOffice.org).
It's not very unified, and my rst2odt_stylesheet rake task isn't very complete, but at least I think it's a lot easier to write a document than suddenly writing it in Word.
reST is a very versatile notation because it embodies one of the features of its predecessor, setext, "it is not unnatural to embed it in an email as it is", and the notation of table is also organized. Also, if you convert it to odt in this way and then export it to PDF, the sentence structure will be reflected in the final PDF, so even long documents will be easier to read.
Both cats and scoops are Markdown these days, so why not try writing a document with reST?
What is regrettable is that the processing system is not available in each language like Markdown. Since it is practically for Python only, it can be used with Trac, but I think it is difficult to use it from Redmine. I wonder if anyone will transplant it (flickering)
Recommended Posts