search

ConaireD / TolimanWIP

WIP Toliman codes go here before being added to the main TOLIMAN github
Other
0 stars 0 forks source link

Consider `sphinx`. #39

Closed Jordan-Dennis closed 1 year ago

Jordan-Dennis commented 1 year ago

Hi all, As I described in #25 sphinx is an alternative to mkdocs. It looks much nicer and has inbuilt the features I am emulating with mkdocs-simple and pytkdocs. However, it uses reStructureText not Markdown which is a bit of a killer. I'm going to investigate it a little further. Regards Jordan.

Jordan-Dennis commented 1 year ago

So I was wrong and sphinx looks like it is a more powerful, but much more complex tool. It can be configured to use Markdown with MyST but I do not think that it will be worth it.

Jordan-Dennis commented 1 year ago

A good comparison.