29 ms·
Ask HN: Which tool for generating aesthetically pleasing C++ reference docs?
Doxygen output is not exactly beautiful or state of the art. Tools that take doxygen XMLs and convert them to something visually pleasing and usable seem to be a mixed bag.
Are there any great projects you'd recommend?
- billconan 8y agoI'm making https://doctory.io https://doctory.io , but it's half baked.
- billconan 8y agodon't use it, cause it is under development.
- billconan 8y agoI do like some feedbacks if you want to try it. you need to add a config file (json) under your project's root directory, like this one: https://github.com/shi-yan/Swiftly/blob/master/doctory.conf https://github.com/shi-yan/Swiftly/blob/master/doctory.conf to specify the folder of your project that contains the doxygen config file.
- starbugs 8y agoLooking for a mature tool, but thanks for posting. I'll give it a try and let you know what we think.
- billconan 8y agosince I'm making a solution, I did do some research. if you are looking for a hosted solution, https://breathe.readthedocs.io/en/latest/readthedocs.html https://breathe.readthedocs.io/en/latest/readthedocs.html readthedocs + breathe might be the best right now. I have seen someone making really good looking doxygen skins, like this http://doc.magnum.graphics/magnum/namespaceMagnum_1_1GL.html#a0f1b8f543578e719e4d68645170dd209abac953e88f6d79514b0b6fc42eb6f3b7 http://doc.magnum.graphics/magnum/namespaceMagnum_1_1GL.html... but I don't know if it is opensource.
- billconan 8y agoI really didn't find too many options. That's why I want to build doctory.io. let me know if you find more.
- starbugs 8y agoI've looked into your tool. To be honest, I don't really get it. How do I get started about creating a documentation?
- stackmad 8y agoI'd recommend having a look at sphinx together with exhale https://exhale.readthedocs.io/en/latest/ https://exhale.readthedocs.io/en/latest/
- IloveHN84 8y agoAsciidoc
- menkoinfo 8y agoinduk