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

Map maven-site 'locale' to asciidoctor 'lang' #970

Open abelsromero opened 2 hours ago

abelsromero commented 2 hours ago

What is this issue about?

Description

Support for captioned titles was added in v3.1.0. We can map the locale set in the maven-site-plugin to lang attribute for better integration.

This should include a section in docs too.

abelsromero commented 2 hours ago

Right now it is not possible to know with certainty the locale in use if more than one is present (https://issues.apache.org/jira/browse/DOXIA-755).

But the same as for https://github.com/asciidoctor/asciidoctor-maven-plugin/pull/969, we can support one locale being set. As a workaround, users can run multiple executions of the plugin each one with a unique locale.