.\" Automatically generated by Pandoc 2.9.2.1
.\"
.TH "s1kd-neutralize" "1" "2021-04-16" "" "s1kd-tools"
.hy
.SH NAME
.PP
s1kd-neutralize - S1000D IETP neutral translation of CSDB objects
.SH SYNOPSIS
.IP
.nf
\f[C]
s1kd-neutralize [-o <file>] [-Dflnqvh?] [<object>...]
\f[R]
.fi
.SH DESCRIPTION
.PP
Generates neutral metadata for the specified CSDB objects.
This includes:
.IP \[bu] 2
XLink attributes for references, using the S1000D URN scheme.
.IP \[bu] 2
RDF and Dublin Core metadata.
.SH OPTIONS
.TP
-D, --delete
Remove neutral metadata from the CSDB object.
.TP
-f, --overwrite
Overwrite specified CSDB object(s) automatically.
.TP
-h, -?, --help
Show usage message.
.TP
-l, --list
Treat input (stdin or arguments) as lists of CSDB objects to neutralize,
rather than CSDB objects themselves.
.TP
-n, --namespace
Include the IETP namespaces for data module and publication module
elements.
.TP
-o, --out <file>
Output neutralized CSDB object XML to <file> instead of stdout.
.TP
-q, --quiet
Quiet mode.
Errors are not printed.
.TP
-v, --verbose
Verbose output.
.TP
--version
Show version information.
.PP
In addition, the following options allow configuration of the XML
parser:
.TP
--dtdload
Load the external DTD.
.TP
--huge
Remove any internal arbitrary parser limits.
.TP
--net
Allow network access to load external DTD and entities.
.TP
--noent
Resolve entities.
.TP
--parser-errors
Emit errors from parser.
.TP
--parser-warnings
Emit warnings from parser.
.TP
--xinclude
Do XInclude processing.
.TP
--xml-catalog <file>
Use an XML catalog when resolving entities.
Multiple catalogs may be loaded by specifying this option multiple
times.
.SH EXAMPLE
.IP
.nf
\f[C]
$ DMOD=DMC-XLINKTEST-A-00-00-00-00A-040A-D_000-01_EN-CA.XML
$ xmllint --xpath \[dq]//description/dmRef\[dq] $DMOD
<dmRef>
<dmRefIdent>
<dmCode modelIdentCode=\[dq]XLINKTEST\[dq] systemDiffCode=\[dq]A\[dq]
systemCode=\[dq]00\[dq] subSystemCode=\[dq]0\[dq] subSubSystemCode=\[dq]0\[dq] assyCode=\[dq]01\[dq]
disassyCode=\[dq]00\[dq] disassyCodeVariant=\[dq]A\[dq] infoCode=\[dq]040\[dq]
infoCodeVariant=\[dq]A\[dq] itemLocationCode=\[dq]D\[dq]/>
</dmRefIdent>
<dmRefAddressItems>
<dmTitle>
<techName>XLink test</techName>
<infoName>Referenced data module</infoName>
</dmTitle>
</dmRefAddressItems>
</dmRef>

$ s1kd-neutralize $DMOD | xmllint --xpath \[dq]//description/dmRef\[dq] -
<dmRef xlink:type=\[dq]simple\[dq]
xlink:href=\[dq]URN:S1000D:DMC-XLINKTEST-A-00-00-01-00A-040A-D\[dq]
xlink:title=\[dq]XLink test - Referenced data module\[dq]>
[...]
</dmRef>
\f[R]
.fi
.SH AUTHORS
khzae.net.