git.iko.soy/typeable/pandoc
on master help sign in
Update manual date, readme, man page.
commitb6d564696f5e68252c357b620a07ed41c55a91c5 authorJohn MacFarlane <jgm@berkeley.edu> dateTue 11 Jun 2019, 21:50 (7 years ago) parent5042c79
3 files changed+67−13
MANUAL.txt+1−1 README.md+3 man/pandoc.1+63−12
MANUAL.txt+1−1
@@ -1,6 +1,6 @@
11% Pandoc User's Guide
22% John MacFarlane
3−% April 5, 2019
3+% June 11, 2019
44
55Synopsis
66========
README.md+3
@@ -111,6 +111,9 @@ It can convert *to*
111111 - `ipynb` ([Jupyter
112112 notebook](https://nbformat.readthedocs.io/en/latest/))
113113 - `jats` ([JATS](https://jats.nlm.nih.gov) XML)
114+ - `jira`
115+ ([Jira](https://jira.atlassian.com/secure/WikiRendererHelpAction.jspa?section=all)
116+ wiki markup)
114117 - `json` (JSON version of native AST)
115118 - `latex` ([LaTeX](http://latex-project.org))
116119 - `man` ([roff
man/pandoc.1+63−12
@@ -1,5 +1,5 @@
11.\"t
2−.TH PANDOC 1 "April 5, 2019" "pandoc 2.7.2"
2+.TH PANDOC 1 "June 11, 2019" "pandoc 2.7.3"
33.SH NAME
44pandoc - general markup converter
55.SH SYNOPSIS
@@ -339,6 +339,8 @@ HTML5/XHTML polyglot markup)
339339.IP \[bu] 2
340340\f[C]jats\f[R] (JATS XML)
341341.IP \[bu] 2
342+\f[C]jira\f[R] (Jira wiki markup)
343+.IP \[bu] 2
342344\f[C]json\f[R] (JSON version of native AST)
343345.IP \[bu] 2
344346\f[C]latex\f[R] (LaTeX)
@@ -765,6 +767,13 @@ to create one) in the output document.
765767This option has no effect unless \f[C]-s/--standalone\f[R] is used, and
766768it has no effect on \f[C]man\f[R], \f[C]docbook4\f[R],
767769\f[C]docbook5\f[R], or \f[C]jats\f[R] output.
770+.RS
771+.PP
772+Note that if you are producing a PDF via \f[C]ms\f[R], the table of
773+contents will appear at the beginning of the document, before the title.
774+If you would prefer it to be at the end of the document, use the option
775+\f[C]--pdf-engine-opt=--no-toc-relocation\f[R].
776+.RE
768777.TP
769778.B \f[C]--toc-depth=\f[R]\f[I]NUMBER\f[R]
770779Specify the number of section levels to include in the table of
@@ -1493,6 +1502,13 @@ author:
14931502\&...
14941503\f[R]
14951504.fi
1505+.PP
1506+Note that if you just want to set PDF or HTML metadata, without
1507+including a title block in the document itself, you can set the
1508+\f[C]title-meta\f[R], \f[C]author-meta\f[R], and \f[C]date-meta\f[R]
1509+variables.
1510+(By default these are set automatically, based on \f[C]title\f[R],
1511+\f[C]author\f[R], and \f[C]date\f[R].)
14961512.RE
14971513.TP
14981514.B \f[C]subtitle\f[R]
@@ -2649,7 +2665,7 @@ information.
26492665Identifiers, classes, and key/value attributes are used in HTML and
26502666HTML-based formats such as EPUB and slidy.
26512667Identifiers are used for labels and link anchors in the LaTeX, ConTeXt,
2652−Textile, and AsciiDoc writers.
2668+Textile, Jira markup, and AsciiDoc writers.
26532669.PP
26542670Headings with the class \f[C]unnumbered\f[R] will not be numbered, even
26552671if \f[C]--number-sections\f[R] is specified.
@@ -4132,7 +4148,7 @@ delimiters (\f[C]$..$\f[R] and \f[C]\[rs][..\[rs]]\f[R]) are omitted.
41324148.B Texinfo
41334149It will be rendered inside a \f[C]\[at]math\f[R] command.
41344150.TP
4135−.B roff man
4151+.B roff man, Jira markup
41364152It will be rendered verbatim without \f[C]$\f[R]\[aq]s.
41374153.TP
41384154.B MediaWiki, DokuWiki
@@ -5820,27 +5836,37 @@ T}@T{
58205836frontmatter
58215837T}
58225838T{
5823−foreword
5839+credits
58245840T}@T{
58255841frontmatter
58265842T}
58275843T{
5828−halftitle,
5844+keywords
58295845T}@T{
58305846frontmatter
58315847T}
58325848T{
5833−introduction
5849+imprint
58345850T}@T{
58355851frontmatter
58365852T}
58375853T{
5838−preface
5854+contributors
58395855T}@T{
58405856frontmatter
58415857T}
58425858T{
5843−seriespage
5859+other-credits
5860+T}@T{
5861+frontmatter
5862+T}
5863+T{
5864+errata
5865+T}@T{
5866+frontmatter
5867+T}
5868+T{
5869+revision-history
58445870T}@T{
58455871frontmatter
58465872T}
@@ -5850,9 +5876,34 @@ T}@T{
58505876frontmatter
58515877T}
58525878T{
5853−afterword
5879+halftitlepage
58545880T}@T{
5855−backmatter
5881+frontmatter
5882+T}
5883+T{
5884+seriespage
5885+T}@T{
5886+frontmatter
5887+T}
5888+T{
5889+foreword
5890+T}@T{
5891+frontmatter
5892+T}
5893+T{
5894+preface
5895+T}@T{
5896+frontmatter
5897+T}
5898+T{
5899+seriespage
5900+T}@T{
5901+frontmatter
5902+T}
5903+T{
5904+titlepage
5905+T}@T{
5906+frontmatter
58565907T}
58575908T{
58585909appendix
@@ -5865,12 +5916,12 @@ T}@T{
58655916backmatter
58665917T}
58675918T{
5868−conclusion
5919+bibliography
58695920T}@T{
58705921backmatter
58715922T}
58725923T{
5873−epigraph
5924+index
58745925T}@T{
58755926backmatter
58765927T}