[SeasonOfDocs] reStructureText Quick Starts and References

[Jared Morgan]

Jared Morgan
M: +61413005479
Google+ <https://plus.google.com/u/0/117309635670089895654/posts/p/pub> |
Twitter <http://twitter.com/!#/jaredmorgs> | Facebook
<http://facebook.com/jaredmorgs>




On Fri, 7 Jun 2019 at 06:17, Cameron Shorter <cameron.shorter at gmail.com>
wrote:

> Hi Jared,
>
> Last time I checked, a few years back, most of our OSGeo projects were
> using RST. So I'd suggest that we should stick with it (at least for this
> round).
>
> Long term I suspect/hope someone will write a WYSIWG tool which allows you
> to save in whatever wiki or doc format your like (and transform between
> formats).
>

If you're willing to use a web-based tool, there is a side by side rST
editor available now at http://rst.ninjs.org/ (which I think was raised by
one of the team in the back channel from the meeting.


> Re heading style, I've seen people use 80 chars of underline for each
> heading. It makes the RST format a bit easier to read:
>
> Chapter 1 Title
>
> ========================================================
>
> Chapter 1.1 Title
>
>
> --------------------------------------------------------------------------------------------------
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/seasonofdocs/attachments/20190607/9090c4db/attachment.html>