@@ -103,6 +103,21 @@ The shell scripts (described below) automatically convert the input
103103from the local encoding to UTF-8 before running them through `pandoc`,
104104then convert the output back to the local encoding.
105105
106+## LaTeX and UTF-8
107+
108+LaTeX sources produced by Pandoc use `ucs.sty`, which is included in many
109+LaTeX distributions. This allows LaTeX to process UTF-8 characters.
110+If your installation of LaTeX does not include `ucs.sty`, you will get an
111+error when you try to compile a LaTeX file produced by Pandoc, or when
112+you use the `markdown2pdf` script (described below). If this happens,
113+install the [unicode] package from [CTAN]. (Get the `unicode.zip`
114+file from CTAN, unpack it, and copy the whole `unicode` directory into
115+`~/texmf/tex/latex/`. You may also need to run `mktexlsr` or `texhash`
116+before the files can be found by TeX.)
117+
118+[CTAN]: http://www.ctan.org
119+[unicode]: http://www.ctan.org/tex-archive/macros/latex/contrib/unicode/
120+
106121# The shell scripts
107122
108123For convenience, five shell scripts have been included that make it
@@ -139,7 +154,8 @@ is in the path, and some have additional requirements. (For example,
139154
140155 markdown2pdf mytextfile.txt
141156
142− creates a file `mytextfile.pdf`.
157+ creates a file `mytextfile.pdf`. (If you get errors, be sure
158+ your LaTeX installation includes `ucs.sty` -- see above.)
143159
144160If you want to use pandoc's command-line options in these scripts,
145161put the options in the environment variable `PANDOC_OPTS`. For
@@ -154,6 +170,14 @@ To make these options persistent, use `export`:
154170 markdown2html tusks.txt > tusks.html
155171 markdown2html trunk.txt > trunk.html
156172
173+You may also specify options on the command line, separating them
174+from the arguments with `-- `:
175+
176+ markdown2html tusks.txt -- -S -T Elephants
177+
178+Options specified in this way will override any options set in
179+PANDOC_OPTS.
180+
157181# Command-line options
158182
159183Various command-line options can be used to customize the output.