<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body text="#000000" bgcolor="#FFFFFF">
<p>Hi Jared,</p>
<p>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).</p>
<p>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).</p>
<p>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:<font
face="arial, sans-serif"><br>
</font></p>
<p><font face="arial, sans-serif">Chapter 1 Title</font><font
face="arial, sans-serif"><br>
</font></p>
<p><font face="arial, sans-serif">========================================================</font></p>
<p><font face="arial, sans-serif">Chapter 1.1 Title</font></p>
<p><font face="arial, sans-serif">--------------------------------------------------------------------------------------------------</font></p>
<p><font face="arial, sans-serif"><br>
</font></p>
<div class="moz-cite-prefix">On 6/6/19 6:35 pm, matteo wrote:<br>
</div>
<blockquote type="cite"
cite="mid:7d2f1331-2a13-e0f4-b267-b67ecd0762f5@gmail.com">
<pre class="moz-quote-pre" wrap="">Hi Jared,
</pre>
<blockquote type="cite">
<pre class="moz-quote-pre" wrap=""><a class="moz-txt-link-freetext" href="http://docutils.sourceforge.net/docs/user/rst/quickstart.html">http://docutils.sourceforge.net/docs/user/rst/quickstart.html</a> is the
first one and takes the form of an abridged version
of <a class="moz-txt-link-freetext" href="http://docutils.sourceforge.net/docs/user/rst/quickref.html#section-structure">http://docutils.sourceforge.net/docs/user/rst/quickref.html#section-structure</a>
Both are recommended by writers who need a quick reminder of syntax.
</pre>
</blockquote>
<pre class="moz-quote-pre" wrap="">
thanks for the links.
</pre>
<blockquote type="cite">
<pre class="moz-quote-pre" wrap="">The only thing that grinds my gears about that is that you seem to have
to stuff around with needless decoration to get the headings to display.
Those folks who use writing IDEs like Atom an MS Code, are there good
libraries that take away some of these rough edges?
</pre>
</blockquote>
<pre class="moz-quote-pre" wrap="">
I'm using Atom, but years ago I just used gedit to write rst text. One
thing that IMHO is really good in rst (and also markdown) is that the
syntax is quite linear. You just have to be aware of a few steps
(chapter, cross-references, code, links and images).
Having a small cheatsheet on the table solve almost all the problems :)
Matteo
_______________________________________________
SeasonOfDocs mailing list
<a class="moz-txt-link-abbreviated" href="mailto:SeasonOfDocs@lists.osgeo.org">SeasonOfDocs@lists.osgeo.org</a>
<a class="moz-txt-link-freetext" href="https://lists.osgeo.org/mailman/listinfo/seasonofdocs">https://lists.osgeo.org/mailman/listinfo/seasonofdocs</a>
</pre>
</blockquote>
<pre class="moz-signature" cols="72">--
Cameron Shorter
Technology Demystifier
Open Technologies and Geospatial Consultant
M +61 (0) 419 142 254</pre>
</body>
</html>