search

asciidoctor / asciidoctor-maven-plugin

A Maven plugin that uses Asciidoctor via JRuby to process AsciiDoc source files within the project.
http://asciidoctor.org
Apache License 2.0
318 stars 122 forks source link

maven-site modules(s) convert internal files (_ prefix) #750

Closed abelsromero closed 2 weeks ago

abelsromero commented 9 months ago

This can be seen in in the example https://github.com/asciidoctor/asciidoctor-maven-examples/tree/main/asciidoc-maven-site-example/src/site/asciidoc where _include and _attributes get converted to the output directory.

image

abelsromero commented 2 weeks ago

This is going to require changes in Doxia https://issues.apache.org/jira/browse/DOXIA-748 😞

abelsromero commented 2 weeks ago

After an interesting conversation, I think that we should enforce the normal Asciidoctor Mojo conventions on the site integration. We can still ignore files with _ via configuration, not folders though, but that's how Site Plugin works.

We need to update the examples and docs accordingly.

abelsromero commented 2 weeks ago

Fun fact, docs already mention the use of moduleExcludes.