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

generate manuals in markdown #559

Open
pmlopes opened this issue Oct 3, 2021 · 0 comments
Open

generate manuals in markdown #559

pmlopes opened this issue Oct 3, 2021 · 0 comments

Comments

@pmlopes
Copy link
Contributor

pmlopes commented Oct 3, 2021

The vertx toolchain processes manuals written in asciidoc. This project already has a simple codetrans plugin to convert the examples from java to javascript, however the final result is still an asciidoc file.

The problem arises when we try to use these files in the website, as the website uses vuepress and doesn't support asciidoc.

We need a solution to either convert the asciidoc to markdown in a reliable way, or update/enhance vuepress to load the asciidoc files during the build as a preprocess step and feeding some markdown transformation.

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

No branches or pull requests

1 participant