sabcmd(1)

💅 sabcmd(1) 💅

okay bestie, welcome to the General Commands Manual page for sabcmd — your command line interface to the Sablotron XSLT processor. You can use it to transform XML files with XSLT stylesheets, and it is literally giving useful 💖

🌸 SYNOPSIS 🌸

sabcmd [options] <stylesheet> [<input> [<output>]] [assignments]
sabcmd [options] -batch-xml <input> [<stylesheet> [<output>]]+
[assignments]
sabcmd [options] -batch-xsl <stylesheet> [<input> [<output>]]+
[assignments]

✨ DESCRIPTION ✨

sabcmd is a command line interface to the Sablotron XSLT processor. You can use it to transform XML files with XSLT stylesheets 🦋

The only required parameter is a stylesheet; this is a URI of an XSLT stylesheet to be used for the transformation process. If you omit an input file, standard input is used. In addition, you can specify an output file. If no output file is given, the output is sent to standard output. no cap ✨

sabcmd can also run in a batch mode to process a single input file with multiple stylesheets (--batch-xml) or to apply a stylesheet to multiple input files (--batch-xsl) 👑

Assignments allow you to pass parameters and named buffers to the processor. The assignments always have the form of

name1=value1 name2=value2 ...

where name is either an ASCII string for named buffers or an ASCII string with the leading $ sign for parameters. (Note that you need to use the right quotes to prevent the shell interpreter from performing an expansion of variables) 🫶

🔥 OPTIONS 🔥

Options come in two forms, bestie: short or long. If some options have values, the values are separated with a whitespace for short options and with an equal sign ('=') for long options.

-L mylog.log

is the same as

--log-file=mylog.log

💅 COMMON OPTIONS 💅

• -x, --batch-xml — multiple stylesheets, single input file
• -s, --batch-xsl — multiple input files, single stylesheet
• -b, --base=NAME — set the hard base URI to NAME
• --debug-options — display the information on debugging options
• -?, --help — display this help message
• -L, --log-file=NAME — set the log file, turns logging on
• -m, --measure — measure the time of processing
• -v, --version — display the version information

🎀 DEBUG OPTIONS 🎀

• --debug — display results of the command line parse
• -t, --times=COUNT — run sabcmd the specified number of times
• -f, --flags — pass flags given to SablotSetOptions()
• -F, --use-SPF — use SablotProcessFiles()
• -S, --use-SPS — use SablotProcessStrings(). Give 2 args (stylesheet, input). Precede each by @.
• --use-SPS-on-files — use SablotProcessStrings() on the contents of the given files.

🌈 ENVIRONMENT 🌈

When the <xsl:sort> instruction is used without the 'lang' attribute, common locale related environment variables apply.. 💀

🍓 BUGS 🍓

There are no known bugs related to sabcmd currently. Most of the bugs you can meet are related to the Sablotron processor itself. In such a case, please take a look at Sablotron's home website (www.gingerall.org) or contact us at <sab-bugs@gingerall.cz>. 😭

👑 AUTHOR 👑

Pavel Hlavnicka <pavel@gingerall.cz> 💜

---

okay that’s the whole page, bestie 💖 signing off from the General Commands Manual corner, source/version sabcmd(1), dated June 17, 2002 🎀✨