Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Refine document generation #263

Open
redboltz opened this issue May 23, 2024 · 0 comments
Open

Refine document generation #263

redboltz opened this issue May 23, 2024 · 0 comments

Comments

@redboltz
Copy link
Owner

I've read this thread before:
https://lists.boost.org/Archives/boost//2024/01/255621.php

However, I didn't have much time to study Antora at that time because refining code was my priority. So, I used a tool that was easier for me, Asciidoxy. I expected that it would integrate well with Doxygen, but Asciidoxy is not well maintained. Recent or complex Doxygen-generated XML causes Asciidoxy to error out.

Therefore, I generate HTML using Doxygen and add links to the HTML files from the AsciiDocs. That is the current status.

Asciidoxy is used only for creating multiple HTML files from multiple ADocs. For this purpose, Antora would be better. At least, Antora is well maintained.

Now that the code is refined, I will migrate from Asciidoxy to Antora.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant