You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Currently we use Sphinx to build and render the website with ther myst_parser extension which allows us to write Markdown
documents and include them in the index.rst.
For another project IsoSLAM I've recently switched to using Mkdocs for rendering the website (see here). It uses Markdown natively and was
very easy to setup and configure. In particular setting up versioning is much more straight-forward
than the current system using sphinx-multiversion which
relies on a tweak I had to make to a fork of the action/spinx-docs-to-gh-pages (see ns-rse/action-sphinx-docs-to-gh-pages for that fork).
The rendering of the API in particular is very nice (although it does require excluding the API Markdown files from
being linted by prettier by adding them to .prettierignore).
Low priority (I'm working through #517 components at the moment) but I'd estimate its a few hours work to do this
migration but would be worthwhile as going forward it gives a cleaner system to work with, extend and maintain and worth
doing before my time on TopoStats ends in a few months.
There are plenty of themes to choose from, let me know if there
are any favourites (its simple to switch though).
The text was updated successfully, but these errors were encountered:
Currently we use Sphinx to build and render the website with ther
myst_parser extension which allows us to write Markdown
documents and include them in the
index.rst
.For another project IsoSLAM I've recently switched to using
Mkdocs for rendering the website (see
here). It uses Markdown natively and was
very easy to setup and configure. In particular setting up
versioning is much more straight-forward
than the current system using sphinx-multiversion which
relies on a tweak I had to make to a fork of the
action/spinx-docs-to-gh-pages
(seens-rse/action-sphinx-docs-to-gh-pages for that fork).
The rendering of the API in particular is very nice (although it does require excluding the API Markdown files from
being linted by
prettier
by adding them to.prettierignore
).Low priority (I'm working through #517 components at the moment) but I'd estimate its a few hours work to do this
migration but would be worthwhile as going forward it gives a cleaner system to work with, extend and maintain and worth
doing before my time on TopoStats ends in a few months.
There are plenty of themes to choose from, let me know if there
are any favourites (its simple to switch though).
The text was updated successfully, but these errors were encountered: