# NAME
s1kd-neutralize - S1000D IETP neutral translation of CSDB objects
# SYNOPSIS
s1kd-neutralize [-o <file>] [-Dflnqvh?] [<object>...]
# DESCRIPTION
Generates neutral metadata for the specified CSDB objects. This
includes:
- XLink attributes for references, using the S1000D URN scheme.
- RDF and Dublin Core metadata.
# OPTIONS
- \-D, --delete
Remove neutral metadata from the CSDB object.
- \-f, --overwrite
Overwrite specified CSDB object(s) automatically.
- \-h, -?, --help
Show usage message.
- \-l, --list
Treat input (stdin or arguments) as lists of CSDB objects to
neutralize, rather than CSDB objects themselves.
- \-n, --namespace
Include the IETP namespaces for data module and publication module
elements.
- \-o, --out \<file\>
Output neutralized CSDB object XML to \<file\> instead of stdout.
- \-q, --quiet
Quiet mode. Errors are not printed.
- \-v, --verbose
Verbose output.
- \--version
Show version information.
In addition, the following options allow configuration of the XML
parser:
- \--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 \<file\>
Use an XML catalog when resolving entities. Multiple catalogs may be
loaded by specifying this option multiple times.
# EXAMPLE
$ DMOD=DMC-XLINKTEST-A-00-00-00-00A-040A-D_000-01_EN-CA.XML
$ xmllint --xpath "//description/dmRef" $DMOD
<dmRef>
<dmRefIdent>
<dmCode modelIdentCode="XLINKTEST" systemDiffCode="A"
systemCode="00" subSystemCode="0" subSubSystemCode="0" assyCode="01"
disassyCode="00" disassyCodeVariant="A" infoCode="040"
infoCodeVariant="A" itemLocationCode="D"/>
</dmRefIdent>
<dmRefAddressItems>
<dmTitle>
<techName>XLink test</techName>
<infoName>Referenced data module</infoName>
</dmTitle>
</dmRefAddressItems>
</dmRef>
$ s1kd-neutralize $DMOD | xmllint --xpath "//description/dmRef" -
<dmRef xlink:type="simple"
xlink:href="URN:S1000D:DMC-XLINKTEST-A-00-00-01-00A-040A-D"
xlink:title="XLink test - Referenced data module">
[...]
</dmRef>
