Hi All,
I like restructuredtext (RST) markup more than markdown as its a proper specification backed by docutils.
Sphinx-doc in python use docutils and helps in managing documentation and books. So thought to write similar tool in odin language.
But when I embarked on writing it, first started just with porting docutils to odin and later implemented guidedoc engine and build a complete system and called it guidedog on top of it. Along the way on the journey to build encountered few issues related to sphinx dependencies.
I wanted to experiment further and create a single binary which has integrated graphviz and typst. So can replace latex build with typst and use typst markup instead of tex files.
Following is the result:
Project Guidedog
As an example I ported the complete odin language website from hugo to guidedog and you can find it at odindocs. This I did as an example if its possible to use guidedog instead of hugo which is written in golang not odin and still have fantastic performance and provide better markup and PDF generation support.
I did not want guidedog to be dependent on python library or codebase, so implemented many of the libraries in guidedog natively in odin including autodoc to document the API. I have tested guidedog on cpython docs as well as flask the performance is very good and can generate both html and pdf very quickly.
I documented the journey in the form of guidedog discussions (GDS) which you can also find on the project page in github.
Please pardon and let me know if any of these work is against the odin community guidelines, as they are written with extensive use of LLM as we are still novice in odin and learning along the way.
If its unacceptable in odin community for such work let me know and will remove the project from this forum and delete the odin language website github project.