moxygen | Doxygen XML to Markdown converter
kandi X-RAY | moxygen Summary
kandi X-RAY | moxygen Summary
Moxygen is a Doxygen XML to Markdown converter for C++ developers who want a minimal and beautiful solution for documentating their projects. Moxygen is currently used in conjunction with GitBook to generate the API documentation for LibSourcey.
Support
Quality
Security
License
Reuse
Top functions reviewed by kandi - BETA
- Convert an element to Markdown
- Set the summary
- A list of compounds
- Trims whitespace characters
- Copies a property from the source object to the destination object .
moxygen Key Features
moxygen Examples and Code Snippets
Community Discussions
Trending Discussions on moxygen
QUESTION
I am trying to create a documentation for a complex c++ project.
To do so, i started using Doxygen, which is appropriate for my usage because i just have to comment the headers of my project to get a full documentation in HTML. This documentation in is perfectly working and has a good style.
But here is my problem I want to get this documentation in a Markdown file to be able to push it on Gitlab.
I tried to use moxygen to convert the xml files to a md file. It works but not as properly as I want: the anchors generated automatically by moxygen are not working. The presentation is also a problem for example it puts the definition list on the top of the file which is very long and not the most useful in the documentation.
I would like to know then if there is a way to document my code as simply as using Doxygen but getting a proper markdown file ( anchors working and better template) .
I know the markdown syntax is simple but i can't write the whole markdown by myself because the project is big and is going to be updated often so i need a generic method to get documentation in markdown from a C++ project.
...ANSWER
Answered 2018-Apr-03 at 23:06I ran into a similar problem some time ago, and it was not easy to solve. Basically what I did is to convert the documentation to LaTeX, and from there, to markdown. Check this to the LaTeX->Markdown passage (other tools existe as well).
You can automate the process using make/latexmke to some point, but I personally have not been able to make the process easy and I still need to step in sometimes. Also note that you might need to use other tools, like flex, to make your LaTeX document into one big tex
file. Some conversion programs do not accept split tex
files.
This is not perfect, but it might give you another angle at this. Hope it helps.
Community Discussions, Code Snippets contain sources that include Stack Exchange Network
Vulnerabilities
No vulnerabilities reported
Install moxygen
Support
Reuse Trending Solutions
Find, review, and download reusable Libraries, Code Snippets, Cloud APIs from over 650 million Knowledge Items
Find more librariesStay Updated
Subscribe to our newsletter for trending solutions and developer bootcamps
Share this Page