Handle multiple language sourcesets

[ysb33r]

Allow a task to handle a sourceset for various languages.

Where we are today

Consider that we have a standard setup like

asciidoctor {
    sourceDir 'src/docs/asciidoc'
    sources {
        include 'index.adoc'
    }
    resources {
        include 'images/**'
    }
    outputDir "${buildDir}/asciidoc"
}

This infers a normal layout of

src/docs/asciidoc/index.adoc
                 /images/*.*

The outputs will end up in build/asciidoc (assuming a conventionalbuildDir).

What we want to add

If we now add a DSL keyword such that

asciidoctor {
    languages 'en', 'es'
}

it will imply that we have an English and a Spanish sourceset and that the file layout will now be

src/docs/asciidoc/en/index.adoc
                 /en/images/**
                 /es/index.adoc
                 /es/images/**

Outputs will now end up in

build/asciidoc/en
              /es

We shall need to accommodate the use case where resources could be language specific

asciidoctor {
    resources 'en', {
    }
    resources 'es', {
    }
}

and this will only copy that specific resources when the specific language is being processed.

Keeping current behaviour

If the languages keyword is not used, the bhevaiour will be exactly as it is today.

Dealing with multiple backends

For the case of combining backends and languages

asciidoctor {
    outputOptions {
        backends 'html', 'docbook'
    }

    languages 'en', 'es'
}

the outputs will be

build/asciidoc/en/html
                 /docbook
              /es/html
                 /docbook

Other things to deal with

• Intermediate work directories

[mojavelinux]

Totally agree. Looks good. Languages as a facet is the right way to go.