Man page - t3highlight(1)

Packages contains this manual

Package:  t3highlight
apt-get install t3highlight

Manuals in package:
• t3highlight(1)
Documentations in package:
• t3highlight

Manual

T3HIGHLIGHT

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
FILES
BUGS
AUTHOR
COPYRIGHT

---

NAME

t3highlight - create syntax highlighted document from source file.

SYNOPSIS

t3highlight [OPTION]... [FILE]

DESCRIPTION

t3highlight reads a source file and creates a syntax highlighted document from it.

OPTIONS

t3highlight accepts the following options:
-d type , --document-type = type

For styles which define multiple document types, select a specific type instead of the default. For example, the html style supplied with t3highlight provides the standalone , separate-css and raw styles. By default the first ( standalone ) is chosen. See the -D / --list-document-types option for finding out the available document types.

-D , --list-document-types

Show a list of the available document types for the selected output style, and exit.

-l lang , --language = lang

Use source language lang for highlighting. See the -L / --list option for finding out the available languages.

--language-file = file

Use the file file for highlighting. This option allows loading of highlighting patterns directly from a file, rather than using a named language from the lang.map file. This is particularly useful when developing new highlighting patterns.

-L , --list

Show a list of all the available source languages and output styles, and exit.

-s style , --style = style

Use output style style to create the output document. The default is the esc style, which uses escape sequences to provide colored output to the terminal. See the -L / --list option for finding out the available styles.

-t tag , --tag = tag

The header and footer, as defined by the document style, may contain tag references in the form %{ name }. The tags name and charset are always defined, but a document style may include more. This option allows specification of extra values, or overriding of predefined tags. tag must have the form name = value .

Tags in the header or footer that have not been defined will be removed. An example of a custom tag is the css tag used in the separate-css document style of the html output style. This allows insertion of the desired CSS style sheet URL into the generated file.

-v , --verbose

Print verbose warning messages.

FILES

libt3highlight , which is used by t3highlight to do the highlighting, and t3highlight itself look for their data files in the directory $HOME/.local/share/libt3highlight and /usr/share/libt3highlight ? (where ? is a digit indicating the binary API version). The documentation on how to write highlighting patterns and style files is normally installed in /usr/share/doc/libt3highlight.

BUGS

If you think you have found a bug, please check that you are using the latest version of libt3highlight <http://os.ghalkes.nl/libt3highlight.html>. When reporting bugs, please include a minimal example that demonstrates the problem.

AUTHOR

G.P. Halkes <libt3highlight@ghalkes.nl>

COPYRIGHT

Copyright © 2012 G.P. Halkes
libt3highlight is licensed under the GNU General Public License version 3.
For more details on the license, see the file COPYING in the documentation directory. On Un*x systems this is usually /usr/share/doc/libt3highlight.

---