git.iko.soy/typeable/pandoc
on master help sign in
Clarified need for `-s` to get character encoding info.

Closes #1724, #1725.

commit93b82e8ea6a6ea3263a54b7d2a78e910323505b8 authorJohn MacFarlane <jgm@berkeley.edu> dateTue 28 Oct 2014, 10:21 (12 years ago) parent6084647
1 file changed+14
README+14
README+14
@@ -50,6 +50,15 @@ default (though output to *stdout* is disabled for the `odt`, `docx`,
5050
5151 pandoc -o output.html input.txt
5252
53+By default, pandoc produces a document fragment, not a standalone
54+document with a proper header and footer. To produce a standalone
55+document, use the `-s` or `--standalone` flag:
56+
57+ pandoc -s -o output.html input.txt
58+
59+For more information on how standalone documents are produced, see
60+[Templates](#templates), below.
61+
5362Instead of a file, an absolute URI may be given. In this case
5463pandoc will fetch the content using HTTP:
5564
@@ -95,6 +104,11 @@ should pipe input and output through `iconv`:
95104
96105 iconv -t utf-8 input.txt | pandoc | iconv -f utf-8
97106
107+Note that in some output formats (such as HTML, LaTeX, ConTeXt,
108+RTF, OPML, DocBook, and Texinfo), information about
109+the character encoding is included in the document header, which
110+will only be included if you use the `-s/--standalone` option.
111+
98112Creating a PDF
99113--------------
100114