Milan
Milan

Reputation: 1750

MOxygen ignoring elements when converting Doxygen documentation to Markdown

I am currently writing a documentation, part of it is the technical documentation generated from the code. As my final output is in Markdown format (for MKDocs), I am using a combination of Doxygen and MOxygen.

Doxygen reads the C# Xml documentation and convert it to html and xml. Then MOxygen converts the generated xml into markdown files.

My problem is that MOxygen is ignoring many items:

I also had issues with Enums and structs but right now they are generated and I can't seems to reproduce the problem.

The html/xml docs are perfectly fine and I just would like MOxygen to properly convert it, its documentation is of course non existent so I can't understand what I am doing wrong and what it needs to work properly. Chatbots are also clueless.

I'd be happy if I at least make static classes work, but I'd also like to understand what is happening with the rest.

I am calling moxygen this way:

f"{moxygen_path} --groups --output {os.path.join(md_output_path, "api%s.md")} ./Documentation/Doxygen/xml"

Generation creates the following warning:

[winston] Attempt to write logs with no transports, which can increase memory usage:

I have been told it is not important, I have been trying to export the log in a log file without success, so I have no idea what would be in the log and if it could help me solve the problems. However while some of the problematic items appears in those warning, not all of them do (one extension classes does while the other does not for instance)

Any help appreciated, I am also open to change tool as long as it can be installed from the windows command line and unix terminal

Upvotes: 0

Views: 14

Answers (0)

Related Questions