TAN catalog files are used to locate relevant TAN files and to support the XSLT
function collection()
. They catalog or index any TAN files within a
local directory and perhaps its subdirectories.
These catalog files must always be named catalog.tan.xml
. They depart
from all other TAN files in their structure. They have no namespace. They have
neither body nor head. Rather, they are patterned off the catalog.xml description
provided by Saxonica (https://www.saxonica.com).
Any XML file passed to the stylesheet applications/create/create TAN catalog
file.xsl
will automatically generate one of these files, cataloging all the
files in the local directory.
The root element of a catalog file is <collection>
, with children <doc>
s that hold simple metadata about the TAN files that are
in a directory and its subdirectories. Only TAN files may be registered in a
<doc>
. A <doc>
may include other material such as
each file's resolved <head>
, but
this is not mandated.