Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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

Closed
rockyallen opened this issue Aug 21, 2018 · 3 comments

Comments

@rockyallen
Copy link
Contributor

"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
Copy link
Member

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
Copy link
Member

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
Copy link
Member

This topic is now being addressed by the Maven plugin. See asciidoctor/asciidoctor-maven-plugin#549

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants