<html>
<head>
<meta http-equiv="Content-Type" content="text/html;
charset=windows-1252">
</head>
<body>
Then the basic `sphinx-build -En src_dir dst_dir` command is all
they need. Even the `-En` options aren't strictly necessary. They
just increase the warning level and avoid some potential caching
issues.<br>
<br>
<div class="moz-cite-prefix">On 3/22/21 12:14 PM, Brent Fraser
wrote:<br>
</div>
<blockquote type="cite"
cite="mid:db142e0040fb4371872ace40cf556b08@geoanalytic.com">
<meta http-equiv="content-type" content="text/html;
charset=windows-1252">
<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
<a class="moz-txt-link-rfc2396E" href="mailto:klassen.js@gmail.com"><klassen.js@gmail.com></a><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>:
<a class="moz-txt-link-abbreviated" href="mailto:geomoose-psc@lists.osgeo.org">geomoose-psc@lists.osgeo.org</a><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" moz-do-not-send="true">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="">_______________________________________________
geomoose-psc mailing list
<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" moz-do-not-send="true">geomoose-psc@lists.osgeo.org</a>
<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" moz-do-not-send="true">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>
</blockquote>
<br>
</body>
</html>