search

asciidoctor / asciidoctor.org

:globe_with_meridians: Asciidoctor project site. Composed in AsciiDoc. Baked with Awestruct.
https://asciidoctor.org
Other
322 stars 805 forks source link

Sub-folders starting with underscore are not processed when using -sourcedirectory #800

Closed rockyallen closed 3 years ago

rockyallen commented 6 years ago

"In the Asciidoctor ecosystem, a leading underscore is consider a marker for a hidden file or folder (but, again, only if the segment is in the part of the path that is relative to the source directory)." Add to cli section.

mojavelinux commented 6 years ago

This doesn't apply to the CLI. It's a convention used by the build plugins such as Asciidoctor Maven, Asciidoctor Gradle, and site generators such as Jekyll AsciiDoc and Middleman AsciiDoc. In contrast, the CLI just processes whatever files you tell it to process.

mojavelinux commented 5 years ago

The Build Integrations and Implementations chapter (https://asciidoctor.org/docs/user-manual/#build-integrations-and-implementations) needs an introduction. This is where we might be able to slide this tidbit. It can talk about how the build plugins are designed for processing a suite of AsciiDoc files and related assets. One of the conventions those plugins follow is to ignore files and folders that begin with either a dot (.) or underscore (_) (aka hidden files).

mojavelinux commented 3 years ago

This topic is now being addressed by the Maven plugin. See https://github.com/asciidoctor/asciidoctor-maven-plugin/issues/549