I highly recommend using Read the Docs <https://readthedocs.org> for the PyFR documentation. It will make it easier for others (including myself) to contribute to the documentation. It can be setup to automatically update the documentation website from the GitHub repo when new changes are pushed. I did this for one of my personal projects (https://chemics.readthedocs.io) and it works well.
On Thursday, September 24, 2020 at 3:04:50 PM UTC-4 Gavin Wiggins wrote: > Using 'sphinxcontrib.tikz' instead of 'tikz' fixes the problem and I'm > able to build the site. Although some warnings appear about deprecated > highlighting. The built Sphinx site looks nothing like your website at > pyfr.org (see attached screenshot). You must be doing some post-Sphinx > steps and CSS after the build. > > [image: screenshot.png] > > > > On Thursday, September 24, 2020 at 2:44:23 PM UTC-4 Gavin Wiggins wrote: > >> I'm trying to build the Sphinx documentation from within the `doc` folder >> using `make html` but I get the following error: >> >> Could not import extension tikz (exception: cannot import name >> 'Directive' from 'sphinx.util.compat' >> (/Users/gavinw/Desktop/GitHub/wigging/PyFR/venv/lib/python3.7/site-packages/sphinx/util/compat.py)) >> >> make: *** [html] Error 2 >> >> Any suggestions on how to build the docs locally? >> >> >> >> >> On Thursday, September 24, 2020 at 11:38:19 AM UTC-4 Vincent, Peter E >> wrote: >> >>> Hi Gavin, >>> >>> Yes, the html version of the docs are hosted on the PyFR website. >>> >>> Peter >>> >>> Professor of Computational Fluid Dynamics and EPSRC Fellow >>> Department of Aeronautics >>> Imperial College London >>> South Kensington >>> London >>> SW7 2AZ >>> UK >>> >>> >>> >>> >>> >>> >>> >>> On 24 Sep 2020, at 15:45, 'Gavin Wiggins' via PyFR Mailing List < >>> pyfrmai...@googlegroups.com> wrote: >>> >>> In the PyFR GitHub repository <https://github.com/PyFR/PyFR> there is a >>> "doc" directory. It looks like this directory is for building the >>> documentation with Sphinx. But where is the documentation hosted? Is it >>> just the main PyFR website at http://www.pyfr.org? >>> >>> -- >>> You received this message because you are subscribed to the Google >>> Groups "PyFR Mailing List" group. >>> To unsubscribe from this group and stop receiving emails from it, send >>> an email to pyfrmailingli...@googlegroups.com. >>> To view this discussion on the web, visit >>> https://groups.google.com/d/msgid/pyfrmailinglist/c12ba651-f8cd-4a51-8698-af7e41d31625n%40googlegroups.com >>> >>> <https://groups.google.com/d/msgid/pyfrmailinglist/c12ba651-f8cd-4a51-8698-af7e41d31625n%40googlegroups.com?utm_medium=email&utm_source=footer> >>> . >>> >>> >>> -- You received this message because you are subscribed to the Google Groups "PyFR Mailing List" group. To unsubscribe from this group and stop receiving emails from it, send an email to pyfrmailinglist+unsubscr...@googlegroups.com. To view this discussion on the web, visit https://groups.google.com/d/msgid/pyfrmailinglist/6108cacf-e25b-424b-bc10-98de40070a9cn%40googlegroups.com.
