s1kd-neutralize(1)                s1kd-tools                s1kd-neutralize(1)

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 in‐
       cludes:

       · 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 mod‐
              ule 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 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 <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>

AUTHORS
       khzae.net.

                                  2021-04-16                s1kd-neutralize(1)