1UNRTF(1) General Commands Manual UNRTF(1)
2
6 UnRTF - converts document in RTF format to other formats
7
9 unrtf [options] [file...]
10 Options: [--nopict] [--noremap] [-P config_search_path] [--html]
12 [--text] [--vt] [--rtf] [--latex] [--help] [--verbose] [--quiet]
13 [--version] [-t tags_file]
14
16 The program unrtf is a converter from Rich Text Format (RTF) to a grow‐
17 ing number of document formats. At present it supports Hypertext
18 Markup Language (HTML), plain text, text with VT100 codes, LaTeX, and
19 RTF itself. It is possible to produce troff files with macro calls; an
20 example configuration for troff and the mm macro package is provided.
21 All output formats except HTML are "alpha" i.e. limited and development
22 has just begun. However with HTML, the program supports tables, fonts,
23 hyperlinks, and paragraph alignment. Font support includes face and
24 size changes, as well as typical attributes such as italic, bold,
25 underlining, strikethrough, smallcaps, allcaps, expand, compress and
26 both foreground and background colors. Images are always stored to
27 separate files in the current directory, or they can be ignored.
28 Starting with version 0.21.0, all control of unrtf output is through
30 runtime configuration files. This makes it easy for users to fine-tune
31 the output, and/or define new output formats. The configuration files
32 can be read from the distributed ones, or from user files, searched for
33 in the config_search_path . Note that the order of the -P and output
34 arguments is important. The search path must be set before any argu‐
35 ment that will load a configuration file if that file is not in the
36 standard place.
37 Code page conversion is performed with the iconv(3) package.
39
41 --nopict
42 disables the automatic storing of embedded pictures to the cur‐
43 rent directory.
44 --noremap
46 disables charset conversion (currently only works for 8-bit
47 charsets).
48 --html selects HTML output (default).
50 --rtf selects RTF output. The resulting output will often be much
52 smaller than the input.
53 --text selects plain ASCII text output.
55 --vt selects text output with VT100 escape codes.
57 --latex
59 selects output of a LaTeX document.
60 --verbose
62 prints additional information.
63 --quiet
65 suppress output of leading comments
66 --version
68 prints the program version.
69 -t tags_file
71 specifies the tags output configuration file to be used. The
72 command "unrtf -t html" is functionally identical to "unrtf
73 --html". The configuration files are a simple format. To
74 change the behaviour of unrtf, a local copy of a system configu‐
75 ration file can be be made and edited. The most complete con‐
76 figuration file and hence the best starting point is
77 /usr/share/unrtf/html.conf.
78 -P config_search_path
80 specifies the directories in which the configuration file for
81 the specified format will be sought. The path can be provided
82 as a single directory or a list of colon separated directories.
83 The default is /usr/share/unrtf where distributed output config‐
84 uration files are installed.
85
87 /usr/share/unrtf/*.conf
88 – run time output configuration files.
89 /usr/share/unrtf/SYMBOL.charmap
91 – UTF encoding of the SYMBOL font used in many RTF files.
92 Unfortunately the iconv package does not include font encodings.
93 The format is identical to iconv code page files.
94
96 ⟨http://www.gnu.org/software/unrtf/unrtf.html⟩
97
99 Report bugs in the program to http://savannah.gnu.org/projects/unrtf/
100 GNU UnRTF 0.21.9 UNRTF(1)