s1kd-flatten(1) s1kd-tools s1kd-flatten(1) NAME s1kd-flatten - Flatten a publication module for publishing SYNOPSIS s1kd-flatten [-d ] [-I ] [-cDfimNPpqRruvx] [...] DESCRIPTION The s1kd-flatten tool combines a publication module and the data mod‐ ules it references in to a single file for use with a publishing sys‐ tem. Data modules are by default searched for in the current directory using the data module code, language and/or issue info provided in each ref‐ erence. OPTIONS -c, --containers Flatten referenced container data modules by copying the refer‐ ences inside the container directly in to the publication mod‐ ule. The copied references will also be flattened, unless the -m option is specified. -D, --remove Remove unresolved references. -d, --dir Directory to start search in. By default, the current directory is used. -f, --overwrite Overwrite input publication module instead of writing to stdout. -h, -?, --help Show help/usage message. -I, --include Add to the list of directories that the tool will search when resolving references. -i, --ignore-issue Always match the latest issue of an object found, regardless of the issue specified in the reference. -l, --list Treat input (stdin or arguments) as lists of CSDB objects, rather than CSDB objects themselves. This option only applies to the simple "flat" format (-p/--simple). -m, --modify Modify the references in the publication module without flatten‐ ing them. -N, --omit-issue Assume that the files representing the referenced data modules do not include the issue info in their filenames, i.e. they were created using the -N option of the s1kd-new* tools. -P, --only-pm-refs Only flatten PM references, leaving DM references alone. -p, --simple Instead of the hierarchical PM-based format, use a simpler "flat" format. -q, --quiet Quiet mode. Errors are not printed. -R, --recursively Recursively flatten referenced publication modules, copying their content in to the "master" publication module. -r, --recursive Search directories recursively. -u, --unique Remove duplicate references within the PM content. -v, --verbose Verbose output. Specify multiple times to increase the verbosi‐ ty. -x, --use-xinclude Use XInclude rather than copying each data module's contents di‐ rectly inside the publication module. DTD entities in data mod‐ ules will only be carried over to the final publication when us‐ ing this option, otherwise they do not carry over when copying the data module. --version Show version information. ... When using the -p option, the filenames to include can be speci‐ fied manually as additional arguments instead of searching for them in the current directory. When not using the -p option, additional arguments are ignored. The publication module to flatten. In addition, the following options allow configuration of the XML pars‐ er: --dtdload Load the external DTD. --huge Remove any internal arbitrary parser limits. --net Allow network access to load external DTD and entities. --noent Resolve entities. --parser-errors Emit errors from parser. --parser-warnings Emit warnings from parser. --xinclude Do XInclude processing. --xml-catalog Use an XML catalog when resolving entities. Multiple catalogs may be loaded by specifying this option multiple times. EXIT STATUS 0 No errors. 1 The publication module specified is malformed. 2 An encoding error occurred. EXAMPLE $ s1kd-flatten -x PMC-EX-12345-00001-00_001-00_EN-CA.XML > Book.xml AUTHORS khzae.net. 2021-07-06 s1kd-flatten(1)