<div style="font-family: arial; font-size: 14px;"><div fr-original-style="" style="box-sizing: border-box;">I was just thinking of  including a little bit of doc for the new/casual user on how it contribute to the doc:  </div><div fr-original-style="" style="box-sizing: border-box;"><br fr-original-style="" style="box-sizing: border-box;"></div><div fr-original-style="" style="box-sizing: border-box;"><br fr-original-style="" style="box-sizing: border-box;"></div><div fr-original-style="" style="box-sizing: border-box;">Contributing to GeoMoose Documentation</div><div fr-original-style="" style="box-sizing: border-box;">-------------------------------------------------------</div><div fr-original-style="" style="box-sizing: border-box;">Our doc uses reStructureText format....</div><div fr-original-style="" style="box-sizing: border-box;">Clone the repo by ....</div><div fr-original-style="" style="box-sizing: border-box;">To create HTML from .rst install Sphinx...., run make or our make.bat...</div><div fr-original-style="" style="box-sizing: border-box;">Submit a pull request contain your doc contribution....</div><div fr-original-style="" style="box-sizing: border-box;"><br fr-original-style="" style="box-sizing: border-box;"></div><div fr-original-style="" style="box-sizing: border-box;"><br fr-original-style="" style="box-sizing: border-box;"></div><div fr-original-style="" style="box-sizing: border-box;">or something like that.</div><div fr-original-style="" style="box-sizing: border-box;"><br fr-original-style="" style="box-sizing: border-box;"></div><div fr-original-style="" style="box-sizing: border-box;">Brent</div><div fr-original-style="" style="box-sizing: border-box;"><br fr-original-style="" style="box-sizing: border-box;"></div><div fr-original-style="" style="box-sizing: border-box;"><br fr-original-style="" style="box-sizing: border-box;"></div><hr id="previousmessagehr" fr-original-style="" style="box-sizing: border-box; clear: both; user-select: none;"><div fr-original-style="" style="box-sizing: border-box;"><span fr-original-style="" style="box-sizing: border-box;"><strong fr-original-style="" style="box-sizing: border-box; font-weight: 700;">From</strong>: Jim Klassen <klassen.js@gmail.com><br fr-original-style="" style="box-sizing: border-box;"><strong fr-original-style="" style="box-sizing: border-box; font-weight: 700;">Sent</strong>: 3/22/21 9:50 AM<br fr-original-style="" style="box-sizing: border-box;"><strong fr-original-style="" style="box-sizing: border-box; font-weight: 700;">To</strong>: geomoose-psc@lists.osgeo.org<br fr-original-style="" style="box-sizing: border-box;"><strong fr-original-style="" style="box-sizing: border-box; font-weight: 700;">Subject</strong>: Re: [geomoose-psc] GeoMoose Doc building</span></div><div fr-original-style="" style="box-sizing: border-box;"><br fr-original-style="" style="box-sizing: border-box;"></div><div fr-original-style="" style="box-sizing: border-box;">This is what I use to build the docs on the server:</div><div fr-original-style="" style="box-sizing: border-box;"><br fr-original-style="" style="box-sizing: border-box;"></div><div fr-original-style="" style="box-sizing: border-box;">    $SPHINX_VENV/bin/sphinx-build -En $SOURCE_DIR/gm3/docs $HTML_DOCS_DIR/3.x</div><div fr-original-style="" style="box-sizing: border-box;"><br fr-original-style="" style="box-sizing: border-box;"></div><div fr-original-style="" style="box-sizing: border-box;"><br fr-original-style="" style="box-sizing: border-box;"></div><div fr-original-style="" style="box-sizing: border-box;">There are many ways someone could install sphinx that would work: </div><div fr-original-style="" style="box-sizing: border-box;"><br fr-original-style="" style="box-sizing: border-box;"></div><div fr-original-style="" style="box-sizing: border-box;">    <a fr-original-class="moz-txt-link-freetext" fr-original-style="" href="https://www.sphinx-doc.org/en/master/usage/installation.html" rel="noopener noreferrer" style="box-sizing: border-box; color: rgb(0, 102, 147); text-decoration: underline; user-select: auto;" target="_blank" rel="noopener noreferrer">https://www.sphinx-doc.org/en/master/usage/installation.html</a></div><div fr-original-style="" style="box-sizing: border-box;"><br fr-original-style="" style="box-sizing: border-box;"></div><div fr-original-style="" style="box-sizing: border-box;"><br fr-original-style="" style="box-sizing: border-box;"></div><div fr-original-style="" style="box-sizing: border-box;">On the server, I've got it sphinx installed in a virtualenv with pip (pip install sphinx).   The version of sphinx in the distributions (apt-get/yum/dnf/...) tend to be too far out of date so installing from pip/conda/etc. is preferred.  I know that Sphinx 1.6.7 which is packaged with Ubuntu 18.04 is too old.</div><div fr-original-style="" style="box-sizing: border-box;"><br fr-original-style="" style="box-sizing: border-box;"></div><div fr-original-style="" style="box-sizing: border-box;">The server is currently running Sphinx 3.4.2, but newer should work.  Older will probably work to a point.   I don't remember how far back that point is at the moment.</div><div fr-original-style="" style="box-sizing: border-box;"><br fr-original-style="" style="box-sizing: border-box;"></div><div fr-original-style="" style="box-sizing: border-box;"><br fr-original-style="" style="box-sizing: border-box;"></div><div fr-original-style="" style="box-sizing: border-box;"><br fr-original-style="" style="box-sizing: border-box;"></div><div fr-original-style="" style="box-sizing: border-box;"><br fr-original-style="" style="box-sizing: border-box;"></div><div fr-original-class="moz-cite-prefix" fr-original-style="" style="box-sizing: border-box;">On 3/22/21 9:55 AM, Brent Fraser wrote:</div><blockquote cite="mid:290375ea8f64450e801cc6e6723ccb2e@geoanalytic.com" fr-original-style="" style="box-sizing: border-box; border-left: 2px solid rgb(94, 53, 177); margin-left: 0px; padding-left: 5px; color: rgb(94, 53, 177);" type="cite"><div fr-original-style="font-family: arial; font-size: 14px;" style="font-family: arial; font-size: 14px; box-sizing: border-box;"><div fr-original-style="" style="box-sizing: border-box;">Hi All,</div><div fr-original-style="" style="box-sizing: border-box;"><br fr-original-style="" style="box-sizing: border-box;"></div><div fr-original-style="" style="box-sizing: border-box;">  So I thought I would start integrating my Vector Editing doc into the code base at geomoose/gm3/docs.  But there doesn't seem to be any info/scripts in the repo for building our doc.  Should there be?</div><div fr-original-style="" style="box-sizing: border-box;"><br fr-original-style="" style="box-sizing: border-box;"></div><div fr-original-style="" style="box-sizing: border-box;">Thanks!</div><div fr-original-style="" style="box-sizing: border-box;">Brent</div></div><br fr-original-style="" style="box-sizing: border-box;"><fieldset fr-original-class="mimeAttachmentHeader" fr-original-style="" style="box-sizing: border-box;"><br fr-original-style="" style="box-sizing: border-box;"></fieldset><pre fr-original-class="moz-quote-pre" fr-original-style="" style="box-sizing: border-box; white-space: pre-wrap; overflow-wrap: break-word; overflow: visible;" wrap="">_______________________________________________<br fr-original-style="" style="box-sizing: border-box;">geomoose-psc mailing list<br fr-original-style="" style="box-sizing: border-box;"><a fr-original-class="moz-txt-link-abbreviated" fr-original-style="" href="mailto:geomoose-psc@lists.osgeo.org" rel="noopener noreferrer" style="box-sizing: border-box; color: rgb(0, 102, 147); text-decoration: underline; user-select: auto;" target="_blank" rel="noopener noreferrer">geomoose-psc@lists.osgeo.org</a><br fr-original-style="" style="box-sizing: border-box;"><a fr-original-class="moz-txt-link-freetext" fr-original-style="" href="https://lists.osgeo.org/mailman/listinfo/geomoose-psc" rel="noopener noreferrer" style="box-sizing: border-box; color: rgb(0, 102, 147); text-decoration: underline; user-select: auto;" target="_blank" rel="noopener noreferrer">https://lists.osgeo.org/mailman/listinfo/geomoose-psc</a></pre></blockquote><div fr-original-style="" style="box-sizing: border-box;"><br fr-original-style="" style="box-sizing: border-box;"></div></div>