..
/
download
xml-trim(1) xml-utils xml-trim(1)
NAME
xml-trim - Trim whitespace in XML elements
SYNOPSIS
xml-trim [-e <elem> ...] [-N <ns=URL> ...] [-fnh?] <src>...
DESCRIPTION
The xml-trim utility trims whitespace around the text contents of spec‐
ified elements.
Whitespace is trimmed according to the following rules:
1. Whitespace characters at the beginning of the first text node child
of the specified elements are removed.
2. Whitespace characters at the end of the last text node child of the
specified elements are removed.
3. If the -n option is given, sequences of whitespace characters in all
text node children of the specified elements are converted to a sin‐
gle space.
OPTIONS
-e, --element <elem>
Elements to trim space on. May include a namespace prefix if
the namespace was registered with -N. <elem> may be either a
simple element name (e.g., "para") which matches all elements
with the same name at any position, or an XPath expression
(e.g., "//section/para") for finer control.
-f, --overwrite
Overwrite input XML files.
-h, -?, --help
Show usage message.
-N, --namespace <ns=URL>
Registers an XML namespace handle for URL, which can then be
used when specifying element names as options. Multiple names‐
paces can be registered by specifying this option multiple
times.
-n, --normalize
Normalize space in the specified elements in addition to trim‐
ming whitespace.
--version
Show version information.
<src> The source XML file(s) containing the elements to trim.
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.
--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.
EXAMPLES
Without namespace
<section>
<para>
Hello world.
</para>
</section>
$ xml-trim -e para example.xml
<section>
<para>Hello world.</para>
</section>
With namespace
<d:section>
<d:para>
Hello world.
</d:para>
</d:section>
$ xml-trim -N d=http://docbook.org/ns/docbook -e d:para example.xml
<d:section>
<d:para>Hello world.</d:para>
</d:section>
Normalizing space
<section>
<para>
This is a <emphasis>long</emphasis>
paragraph with both extra whitespace
before and after the text, and line
breaks entered by the author to wrap
the text on a certain column.
</para>
</section>
$ xml-trim -n -e para example.xml
<section>
<para>This is a <emphasis>long</emphasis> paragraph with both extra whitespace before
and after the text, and line breaks entered by the author to wrap the
text on a certain column.</para>
</section>
AUTHORS
khzae.net.
2020-07-07 xml-trim(1)
gopher://khzae.net/0/s1000d/xml/xml-utils/src/utils/xml-trim/README