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

Have you considered antora jointly with asciidoxy ? #36

Open
prudhomm opened this issue Aug 4, 2021 · 3 comments
Open

Have you considered antora jointly with asciidoxy ? #36

prudhomm opened this issue Aug 4, 2021 · 3 comments

Comments

@prudhomm
Copy link

prudhomm commented Aug 4, 2021

Antora is a documentation site generator using asciidoc and asciidoctor.
Have you considered using asciidoxy to generated a component for Antora ?
Some discussions here https://antora.zulipchat.com/#narrow/stream/282400-users/topic/thoughts.20on.20antora.20for.20automated.20reference.20documentation.20.2E.2E.2E (antora zulip chat) after I discovered asciidoxy.
It seems that asciidoxy would be a nice candidate to generate automatically documentation from doxygen and publish it with antora

@silvester747
Copy link
Collaborator

The new feature to generate AsciiDoc output instead of running AsciiDoctor may already make it easier to integrate with Antora. I still have to see what is required for more close integration.

@prudhomm
Copy link
Author

prudhomm commented Nov 3, 2022

@silvester747 any updates on this?

antora has some new tools and extension system that could make it even easier to deal with automated code generation

@prudhomm
Copy link
Author

prudhomm commented Nov 5, 2022

@silvester747 in antora there is now an extension called collector that could be used to collect the intermediate adoc files generated by asciidoxy and incorporate them in an antora site.
The adoc generation is deleguated to asciidoxy and then aggregated into the contentCatalog of antora by the collector extension.
i think that could be worth a try

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

2 participants