Vuepress: Asciidoctor.js support

[abelsromero]

Feature request

What problem does this feature solve?

Support for other another popular writing format.
Plus, the out-of-the-box search and multi-language vuepress offers (not offered in other static generators) would work wonders to document OS projects in asciidoc.

What does the proposed API look like?

How should this be implemented in your opinion?

I lack the knowledge. But I assume the current engine converts single md files one by one generating the target HTML. I don't it should be easy, but this could be replicated with https://github.com/asciidoctor/asciidoctor.js/ in a similar manner.
I had a look at some vuepress features and:

• All the features provided by Markdown extension are supported out of the box by Asciidoctor, so users won't miss features.
• The search-box, afaik indexes titles (H1, H2,...), asciidoctor respects that.
• Additional Asciidoctor configurations defined in https://vuepress.vuejs.org/guide/markdown.html#advanced-configuration, could also be defined using a similar syntax in an asciidoctor block. Also, asciidoctor. The same native options structure could be used (https://asciidoctor-docs.netlify.com/asciidoctor.js/processor/convert-options/#usage) so that vuepress only passes it.
• Advanced features would need more work, but are doable.

Are you willing to work on this yourself?

I really cannot due to other commitments and lack of JS expertise, but I am curious to know if you think this could be an option.

[f3ltron]

I am not familar with ascii doctor.

But It can be a cool feature to have the possibility to have custom transformation.

Interesting but it could be a bit tricky to add it

[MasterShu]

It would be better have more choice, I hope VuePress supported Asciidoctor too.

[CanadianBeaver]

Please, consider using AsciiDoc in VuePress. Thank you.

[jabby]

Please add this support.
@kefranabg if you want, we can work on this together 😄

[kefranabg]

I'll discuss this topic with the team and we'll consider adding AsciiDoc support on VP.

For now I don't know what the impacts would be on VuePress core, but we have to make sure it's worth it. For example, if we know that AsciiDoc syntax will be used by 0.5% of VuePress users, we'll probably never implement it.

[LukasHirt]

Is there any update on this? I'd be up for contributing to this if you'd be interested.

[hortonelectric]

I am also interested.

[alialjowaher]

I'm also interested as we use asciidoc to documents all of our development projects (Business stuff Feasibility ,charter ,Software Requirements, etc...) in addition to user guides .

[kevinlang]

The great thing about AsciiDoc is that it provides, out of the box, most of the things that VuePress currently uses Markdown Extensions for.

• Custom Containers -> Admonitions
• Line Highlighting -> Highlight select lines
• Import code snippet -> Include directive
• Line numbers (global config, all or nothing) -> Line numbers (configurable per block)