From dd0ce8120daa0c440d126d1df05b02bcad3dff8c Mon Sep 17 00:00:00 2001 From: John MacFarlane Date: Thu, 2 Dec 2010 22:36:22 -0800 Subject: Added --bibliography and --csl to pandoc man page. --- man/man1/pandoc.1.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) (limited to 'man') diff --git a/man/man1/pandoc.1.md b/man/man1/pandoc.1.md index d6f188276..a18b5e83f 100644 --- a/man/man1/pandoc.1.md +++ b/man/man1/pandoc.1.md @@ -268,6 +268,28 @@ should pipe input and output through `iconv`: -T *STRING*, \--title-prefix=*STRING* : Specify *STRING* as a prefix to the HTML window title. +\--bibliography=*FILE* +: Specify bibliography database to be used in resolving + citations. The database type will be determined from the + extension of *FILE*, which may be `.xml` (MODS format), + `.bib` (BibTeX format), or `.json` (citeproc JSON). + +\--csl=*FILE* +: Specify [CSL] style to be used in formatting citations and + the bibliography. If *FILE* is not found, pandoc will look + for it in + + $HOME/.csl + + in unix and + + C:\Documents And Settings\USERNAME\Applicaiton Data\csl + + in Windows. If the `--csl` option is not specified, pandoc + will use a default style: either `default.csl` in the + user data directory (see `--data-dir`), or, if that is + not present, the Chicago author-date style. + \--data-dir*=DIRECTORY* : Specify the user data directory to search for pandoc data files. If this option is not specified, the default user data directory @@ -397,3 +419,5 @@ The *README* file distributed with Pandoc contains full documentation. The Pandoc source code and all documentation may be downloaded from . +[CSL]: CitationStyles.org + -- cgit v1.2.3 From becd9a81cc05470ac25b17e27b09c8382905bfe1 Mon Sep 17 00:00:00 2001 From: John MacFarlane Date: Thu, 2 Dec 2010 22:42:25 -0800 Subject: Added --bibliography, --csl, --data-dir to markdown2pdf man page. --- man/man1/markdown2pdf.1.md | 40 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) (limited to 'man') diff --git a/man/man1/markdown2pdf.1.md b/man/man1/markdown2pdf.1.md index 3947ef8da..3fbd4b76f 100644 --- a/man/man1/markdown2pdf.1.md +++ b/man/man1/markdown2pdf.1.md @@ -75,6 +75,46 @@ packages are not included in your latex setup, they can be obtained from : Use contents of *FILE* as the document header. *Note: This option is deprecated. Users should transition to using `--template` instead.* +\--bibliography=*FILE* +: Specify bibliography database to be used in resolving + citations. The database type will be determined from the + extension of *FILE*, which may be `.xml` (MODS format), + `.bib` (BibTeX format), or `.json` (citeproc JSON). + +\--csl=*FILE* +: Specify [CSL] style to be used in formatting citations and + the bibliography. If *FILE* is not found, pandoc will look + for it in + + $HOME/.csl + + in unix and + + C:\Documents And Settings\USERNAME\Applicaiton Data\csl + + in Windows. If the `--csl` option is not specified, pandoc + will use a default style: either `default.csl` in the + user data directory (see `--data-dir`), or, if that is + not present, the Chicago author-date style. + +\--data-dir*=DIRECTORY* +: Specify the user data directory to search for pandoc data files. + If this option is not specified, the default user data directory + will be used: + + $HOME/.pandoc + + in unix and + + C:\Documents And Settings\USERNAME\Application Data\pandoc + + in Windows. A `reference.odt`, `epub.css`, `templates` directory, + or `s5` directory placed in this directory will override pandoc's + normal defaults. + # SEE ALSO `pandoc`(1), `pdflatex`(1) + +[CSL]: CitationStyles.org + -- cgit v1.2.3 From 38bc3f23166cc3b2088eebb8a234a3f5f5e65bbb Mon Sep 17 00:00:00 2001 From: John MacFarlane Date: Fri, 3 Dec 2010 23:05:20 -0800 Subject: More documentation for citeproc features (still incomplete). --- README | 28 ++++++++++++++++++++++++++++ man/man1/markdown2pdf.1.md | 2 +- man/man1/pandoc.1.md | 2 +- 3 files changed, 30 insertions(+), 2 deletions(-) (limited to 'man') diff --git a/README b/README index f24b4efe3..6440272ad 100644 --- a/README +++ b/README @@ -414,6 +414,28 @@ For further documentation, see the `pandoc(1)` man page. `perl,numberLines` or `haskell`. Multiple classes may be separated by spaces or commas. +`--bibliography`*=FILE* +: specifies bibliography database to be used in resolving + citations. The database type will be determined from the + extension of *FILE*, which may be `.xml` (MODS format), + `.bib` (BibTeX format), or `.json` (citeproc JSON). + +`--csl`*=FILE* +: specifies [CSL] style to be used in formatting citations and + the bibliography. If *FILE* is not found, pandoc will look + for it in + + $HOME/.csl + + in unix and + + C:\Documents And Settings\USERNAME\Application Data\csl + + in Windows. If the `--csl` option is not specified, pandoc + will use a default style: either `default.csl` in the + user data directory (see `--data-dir`), or, if that is + not present, the Chicago author-date style. + `--data-dir`*=directory* : specifies the user data directory to search for pandoc data files. If this option is not specified, the default user data directory @@ -469,6 +491,7 @@ For further documentation, see the `pandoc(1)` man page. [gladTeX]: http://www.math.uio.no/~martingu/gladtex/index.html [mimeTeX]: http://www.forkosh.com/mimetex.html [Dublin Core elements]: http://dublincore.org/documents/dces/ +[CSL]: http://CitationStyles.org Templates ========= @@ -1288,6 +1311,11 @@ LaTeX, not as markdown. Inline LaTeX is ignored in output formats other than Markdown, LaTeX, and ConTeXt. +Citations +--------- + + + Producing HTML slide shows with Pandoc ====================================== diff --git a/man/man1/markdown2pdf.1.md b/man/man1/markdown2pdf.1.md index 3fbd4b76f..80acdb678 100644 --- a/man/man1/markdown2pdf.1.md +++ b/man/man1/markdown2pdf.1.md @@ -90,7 +90,7 @@ packages are not included in your latex setup, they can be obtained from in unix and - C:\Documents And Settings\USERNAME\Applicaiton Data\csl + C:\Documents And Settings\USERNAME\Application Data\csl in Windows. If the `--csl` option is not specified, pandoc will use a default style: either `default.csl` in the diff --git a/man/man1/pandoc.1.md b/man/man1/pandoc.1.md index a18b5e83f..f6cb7e3a6 100644 --- a/man/man1/pandoc.1.md +++ b/man/man1/pandoc.1.md @@ -283,7 +283,7 @@ should pipe input and output through `iconv`: in unix and - C:\Documents And Settings\USERNAME\Applicaiton Data\csl + C:\Documents And Settings\USERNAME\Application Data\csl in Windows. If the `--csl` option is not specified, pandoc will use a default style: either `default.csl` in the -- cgit v1.2.3