reactiverse / es4x

🚀 fast JavaScript 4 Eclipse Vert.x
https://reactiverse.io/es4x/
Apache License 2.0
877 stars 75 forks source link

generate manuals in markdown #559

Open pmlopes opened 2 years ago

pmlopes commented 2 years ago

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.