<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">Thanks, I copied the ‘developer’ fold out and comment (#extensions.append('sphinxcontrib.bibtex’) this line, with few copy it works well, (no cite link), for me it enough. <div class=""><br class=""><div class=""><br class=""><div><br class=""><blockquote type="cite" class=""><div class="">On Aug 21, 2020, at 7:32 PM, Patrick Sanan <<a href="mailto:patrick.sanan@gmail.com" class="">patrick.sanan@gmail.com</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><meta http-equiv="Content-Type" content="text/html; charset=utf-8" class=""><div style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class=""><div class="">Note that we have only tested things with Sphinx 2.4.4, because we rely on a custom extension to add the links to man pages. <br class=""><div class=""></div></div><div class=""><br class=""></div>We recently added a helper target in the top-level makefile, which sets up a virtual environment for you with the same packages used for the ReadTheDocs build. Perhaps you can try that, or it can give a hint as to how to set up your own Python environment?<div class=""><br class=""></div><div class=""> cd $PETSC_DIR</div><div class=""> make sphinx-docs-clean</div><div class=""> make sphinx-docs-html</div><div class=""> open src/docs/sphinx_docs/_build/html/index.html<br class=""><div class=""><br class=""></div><div class=""><br class=""></div><div class=""><div class=""><div class=""><br class=""><blockquote type="cite" class=""><div class="">Am 21.08.2020 um 10:39 schrieb huabel <<a href="mailto:hu.ds.abel@icloud.com" class="">hu.ds.abel@icloud.com</a>>:</div><br class="Apple-interchange-newline"><div class=""><meta http-equiv="Content-Type" content="text/html; charset=utf-8" class=""><div style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">Hi <div class=""> I run make dirhtml get some error</div><div class=""><br class=""></div><div class=""><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures; color: #2fb41d" class=""><b class="">➜ </b></span><span style="font-variant-ligatures: no-common-ligatures; color: #2eaebb" class=""><b class="">sphinx_docs</b></span><span style="font-variant-ligatures: no-common-ligatures" class=""> </span><span style="font-variant-ligatures: no-common-ligatures; color: #400bd9" class=""><b class="">git:(</b></span><span style="font-variant-ligatures: no-common-ligatures; color: #b42419" class=""><b class="">maint</b></span><span style="font-variant-ligatures: no-common-ligatures; color: #400bd9" class=""><b class="">)</b></span><span style="font-variant-ligatures: no-common-ligatures" class=""> make dirhtml</span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class=""><b class="">Running Sphinx v3.1.2</b></span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo; min-height: 13px;" class=""><span style="font-variant-ligatures: no-common-ligatures" class=""></span><br class=""></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class="">Found DOT install: /usr/local/bin/dot</span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo; min-height: 13px;" class=""><span style="font-variant-ligatures: no-common-ligatures" class=""></span><br class=""></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo; min-height: 13px;" class=""><span style="font-variant-ligatures: no-common-ligatures" class=""></span><br class=""></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo; color: rgb(252, 33, 24);" class=""><span style="font-variant-ligatures: no-common-ligatures" class="">Extension error:</span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class="">Could not import extension sphinxcontrib.bibtex (exception: No module named 'sphinxcontrib.bibtex')</span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class="">gmake: *** [Makefile:29: dirhtml] Error 2</span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures; color: #b42419" class=""><b class="">➜ </b></span><span style="font-variant-ligatures: no-common-ligatures; color: #2eaebb" class=""><b class="">sphinx_docs</b></span><span style="font-variant-ligatures: no-common-ligatures" class=""> </span><span style="font-variant-ligatures: no-common-ligatures; color: #400bd9" class=""><b class="">git:(</b></span><span style="font-variant-ligatures: no-common-ligatures; color: #b42419" class=""><b class="">maint</b></span><span style="font-variant-ligatures: no-common-ligatures; color: #400bd9" class=""><b class="">)</b></span><span style="font-variant-ligatures: no-common-ligatures" class=""> pip3 show sphinxcontrib-bibtex</span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class="">Name: sphinxcontrib-bibtex</span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class="">Version: 1.0.0</span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class="">Summary: A Sphinx extension for BibTeX style citations.</span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class="">Home-page: <a href="https://github.com/mcmtroffaes/sphinxcontrib-bibtex" class="">https://github.com/mcmtroffaes/sphinxcontrib-bibtex</a></span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class="">Author: Matthias C. M. Troffaes</span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class="">Author-<a href="mailto:matthias.troffaes@gmail.com" class="">email: matthias.troffaes@gmail.com</a></span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class="">License: BSD</span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class="">Location: /usr/local/lib/python3.8/site-packages</span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class="">Requires: oset, Sphinx, pybtex-docutils, pybtex</span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class="">Required-by: </span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures; color: #2fb41d" class=""><b class="">➜ </b></span><span style="font-variant-ligatures: no-common-ligatures; color: #2eaebb" class=""><b class="">sphinx_docs</b></span><span style="font-variant-ligatures: no-common-ligatures" class=""> </span><span style="font-variant-ligatures: no-common-ligatures; color: #400bd9" class=""><b class="">git:(</b></span><span style="font-variant-ligatures: no-common-ligatures; color: #b42419" class=""><b class="">maint</b></span><span style="font-variant-ligatures: no-common-ligatures; color: #400bd9" class=""><b class="">)</b></span><span style="font-variant-ligatures: no-common-ligatures" class=""> brew info graphviz</span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class="">graphviz: stable 2.44.1 (bottled), HEAD</span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class="">Graph visualization software from AT&T and Bell Labs</span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="text-decoration: underline ; font-variant-ligatures: no-common-ligatures" class=""><a href="https://www.graphviz.org/" class="">https://www.graphviz.org/</a></span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class="">/usr/local/Cellar/graphviz/2.44.1 (506 files, 18MB) *</span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class=""> Poured from bottle on 2020-07-12 at 16:47:06</span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class="">From: </span><span style="text-decoration: underline ; font-variant-ligatures: no-common-ligatures" class=""><a href="https://github.com/Homebrew/homebrew-core/blob/HEAD/Formula/graphviz.rb" class="">https://github.com/Homebrew/homebrew-core/blob/HEAD/Formula/graphviz.rb</a></span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class="">License: EPL-1.0</span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures; color: #400bd9" class="">==></span><span style="font-variant-ligatures: no-common-ligatures" class=""> <b class="">Dependencies</b></span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class="">Build: <b class="">autoconf </b></span><span style="font-variant-ligatures: no-common-ligatures; color: #2fb41d" class=""><b class="">✔</b></span><span style="font-variant-ligatures: no-common-ligatures" class="">, <b class="">automake </b></span><span style="font-variant-ligatures: no-common-ligatures; color: #b42419" class=""><b class="">✘</b></span><span style="font-variant-ligatures: no-common-ligatures" class="">, <b class="">pkg-config </b></span><span style="font-variant-ligatures: no-common-ligatures; color: #2fb41d" class=""><b class="">✔</b></span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class="">Required: <b class="">gd </b></span><span style="font-variant-ligatures: no-common-ligatures; color: #2fb41d" class=""><b class="">✔</b></span><span style="font-variant-ligatures: no-common-ligatures" class="">, <b class="">gts </b></span><span style="font-variant-ligatures: no-common-ligatures; color: #2fb41d" class=""><b class="">✔</b></span><span style="font-variant-ligatures: no-common-ligatures" class="">, <b class="">libpng </b></span><span style="font-variant-ligatures: no-common-ligatures; color: #2fb41d" class=""><b class="">✔</b></span><span style="font-variant-ligatures: no-common-ligatures" class="">, <b class="">libtool </b></span><span style="font-variant-ligatures: no-common-ligatures; color: #2fb41d" class=""><b class="">✔</b></span><span style="font-variant-ligatures: no-common-ligatures" class="">, <b class="">pango </b></span><span style="font-variant-ligatures: no-common-ligatures; color: #b42419" class=""><b class="">✘</b></span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures; color: #400bd9" class="">==></span><span style="font-variant-ligatures: no-common-ligatures" class=""> <b class="">Options</b></span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class="">--HEAD</span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class=""><span class="Apple-tab-span" style="white-space:pre"> </span>Install HEAD version</span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures; color: #400bd9" class="">==></span><span style="font-variant-ligatures: no-common-ligatures" class=""> <b class="">Analytics</b></span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class="">install: 59,114 (30 days), 157,762 (90 days), 518,413 (365 days)</span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class="">install-on-request: 48,388 (30 days), 125,480 (90 days), 390,556 (365 days)</span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class="">build-error: 0 (30 days)</span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class=""><br class=""></span></div><div style="margin: 0px; font-stretch: normal; font-size: 11px; line-height: normal; font-family: Menlo;" class=""><span style="font-variant-ligatures: no-common-ligatures" class=""><br class=""></span></div><div class=""><br class=""><blockquote type="cite" class=""><div class="">On Aug 21, 2020, at 3:14 PM, Patrick Sanan <<a href="mailto:patrick.sanan@gmail.com" class="">patrick.sanan@gmail.com</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><div dir="ltr" class=""><div dir="auto" style="word-wrap:break-word;line-break:after-white-space" class=""><div dir="auto" style="word-wrap:break-word;line-break:after-white-space" class=""><div dir="auto" style="word-wrap:break-word;line-break:after-white-space" class="">Hi all - <div class=""><br class=""></div><div class="">We're working on getting the users manual fully migrated to Sphinx, so we can delete the pure-LaTeX version.</div><div class=""><br class=""></div><div class="">So far, we've done most of the groundwork to set things up using Sphinx and ReadTheDocs, and to do some semi-automated conversion of the manual. Most people will access the manual via <a href="http://docs.petsc.org/" class="">docs.petsc.org</a>, but Sphinx also allows you to build a PDF (via LaTeX) of the docs, which we'll maintain so as to have something citable.</div><div class=""><br class=""></div><div class="">Most sections of the manual have a big ugly warning asking for volunteers, e.g. here: <a href="https://docs.petsc.org/en/latest/manual/mat/" target="_blank" class="">https://docs.petsc.org/en/latest/manual/mat/</a> . An expert reading through any of the chapters will certainly find things they can fix or remove as they go through. That said, the main objective for now is simply to provide the existing content in a web-friendly way. The minimal task mostly involves fixing references and tables (use list-table whenever possible). </div><div class=""><br class=""></div><div class="">Probably the best example so far of good formatting is the SNES chapter which Jed has been working on:</div><div class=""><a href="https://docs.petsc.org/en/latest/manual/snes/" target="_blank" class="">https://docs.petsc.org/en/latest/manual/snes/</a> </div><div class=""><br class=""></div><div class="">Regarding Sphinx, tips and useful conventions are being noted here:</div><div class=""><a href="https://docs.petsc.org/en/latest/developers/documentation/#sphinx-documentation-guidelines" target="_blank" class="">https://docs.petsc.org/en/latest/developers/documentation/#sphinx-documentation-guidelines</a></div><div class=""><br class=""></div><div class="">(Note that for small docs changes like this, you can go to the ReadTheDocs drop-down in the bottom right and click a link to directly edit on GitLab)</div><div class=""><br class=""></div></div></div></div></div>
</div></blockquote></div><br class=""></div></div></div></blockquote></div><br class=""></div></div></div></div></div></blockquote></div><br class=""></div></div></body></html>