From a197341252a6149bb1a3234ffcca915fb4ed1498 Mon Sep 17 00:00:00 2001 From: John MacFarlane Date: Wed, 7 Dec 2016 15:39:06 +0100 Subject: MANUAL: better docs on how to create a custom reference.docx. --- MANUAL.txt | 32 ++++++++++++++++++++++++-------- 1 file changed, 24 insertions(+), 8 deletions(-) diff --git a/MANUAL.txt b/MANUAL.txt index 19ed5781b..fc6b65da8 100644 --- a/MANUAL.txt +++ b/MANUAL.txt @@ -795,6 +795,13 @@ Options affecting specific writers `--data-dir`). If this is not found either, sensible defaults will be used. + To produce a custom `reference.odt`, first get a copy of + the default `reference.odt`: `pandoc + --print-default-data-file reference.odt > + custom-reference.odt`. Then open `custom-reference.docx` in + LibreOffice, modify the styles as you wish, and save the + file. + `--reference-docx=`*FILE* : Use the specified file as a style reference in producing a docx file. @@ -805,14 +812,23 @@ Options affecting specific writers reference docx is specified on the command line, pandoc will look for a file `reference.docx` in the user data directory (see `--data-dir`). If this is not found either, sensible defaults will be - used. The following styles are used by pandoc: [paragraph] - Normal, Body Text, First Paragraph, Compact, Title, Subtitle, Author, Date, - Abstract, Bibliography, Heading 1, Heading 2, Heading 3, Heading 4, - Heading 5, Heading 6, Block Text, Footnote Text, Definition Term, - Definition, Caption, Table Caption, Image Caption, Figure, - Figure With Caption, TOC Heading; - [character] Default Paragraph Font, Body Text Char, Verbatim Char, - Footnote Reference, Hyperlink; [table] Normal Table. + used. + + To produce a custom `reference.docx`, first get a copy of + the default `reference.docx`: `pandoc + --print-default-data-file reference.docx > + custom-reference.docx`. Then open `custom-reference.docx` + in Word, modify the styles as you wish, and save the file. + For best results, do not make changes to this file other + than modifying the styles used by pandoc: [paragraph] Normal, + Body Text, First Paragraph, Compact, Title, Subtitle, + Author, Date, Abstract, Bibliography, Heading 1, Heading 2, + Heading 3, Heading 4, Heading 5, Heading 6, Block Text, + Footnote Text, Definition Term, Definition, Caption, Table + Caption, Image Caption, Figure, Figure With Caption, TOC + Heading; [character] Default Paragraph Font, Body Text Char, + Verbatim Char, Footnote Reference, Hyperlink; [table] Normal + Table. `--epub-stylesheet=`*FILE* -- cgit v1.2.3