'FILE' contains a list resources (one per line). Manifest 'FILE'
- entries are
treated just like *--resource* option arguments.
+ entries are ted just like *--resource* option arguments.
- The file name of the docbook-xsl CSS stylesheet file. Defaults to
- 'docbook-xsl.css'. The stylesheet must reside in a valid <<X3,
- resource file>> location.
+ The file name of the CSS stylesheet file that is used to style HTML
+ output generated by docbook-xsl. Defaults to 'docbook-xsl.css'. The
+ stylesheet must reside in a valid <<X3, resource file>> location.
Applies to HTML formats: 'xhtml', 'epub', 'chunked', 'htmlhelp'
. The 'SOURCE_FILE' directory.
-. Resource directories (specified by *--resource* and
- *--resource-manifest* options) are searched recursively.
-. The 'asciidoc(1)' `images` and `stylesheets` configuration file
- directories are searched recursively.
+. Resource directories specified by the *--resource* option (searched
+. Resource directories specified by the *--resource-manifest* option
+ (searched recursively in the order they appear in the manifest
+. The stock `images` and `stylesheets` directories in the
+ 'asciidoc(1)' configuration files directories (searched
. The destination directory.
-When a resource is found it is copied to the correct relative
-destination directory. Destination sub-directories are created
+When a resource file is found it is copied to the correct relative
+destination directory. Missing destination sub-directories are created
-A resource specifier (*--resource* option 'RESOURCE_SPEC') can specify
-a single resource file or a directory to be recursively searched for
-resource files. A resource specifier can be either of the following
+There are two distinct mechanisms for specifying additional resources:
+. A resource directory which will be searched recursively for missing
+. A resouce file which will be copied to the output destination
+Resources are defined by the *--resource* option value and can be
+either of the following two formats:
Specifies a directory (absolute or relative to the 'SOURCE_FILE')
- which is searched recursively for resource files.
+ which is searched recursively for missing resource files. To
+ eliminate ambiguity the `<resource_dir>` name should end with a
+ directory separator character.
Specifies a resource file (absolute or relative to the
- 'SOURCE_FILE') which
is copied to `<destination_file>`. If
+ 'SOURCE_FILE') which copied to `<destination_file>`. If
`<destination_file>` is not specified then it is the same as the
Specifies the destination of the copied source file. The
`<destination_file>` path is relative to the destination directory
- (absolute paths are not allowed). The destination directory is
- format dependent (see the <<X4,*OUTPUT FILES*>> section for
+ (absolute paths are not allowed). The location of the destination
+ directory depends on the output 'FORMAT' (see the <<X4,*OUTPUT
+ FILES*>> section for details):
- chunked, htmlhelp;; The chunked directory.
+ chunked, htmlhelp;; The chunked directory.
epub;; The archived `OEBPS` directory.
- xhtml;; The *DESTINATION_DIR*.
+ xhtml;; The *DESTINATION_DIR*.
Resource specifier examples: