diff options
Diffstat (limited to 'paper/lua-filters/pagebreak/README.md')
-rw-r--r-- | paper/lua-filters/pagebreak/README.md | 68 |
1 files changed, 0 insertions, 68 deletions
diff --git a/paper/lua-filters/pagebreak/README.md b/paper/lua-filters/pagebreak/README.md deleted file mode 100644 index b9a5e04..0000000 --- a/paper/lua-filters/pagebreak/README.md +++ /dev/null @@ -1,68 +0,0 @@ -pagebreak -========= - -This filter converts paragraps containing only the LaTeX -`\newpage` or `\pagebreak` command into appropriate pagebreak -markup for other formats. The command must be the only contents -of a raw TeX block in order to be recognized. I.e., for Markdown -the following is sufficient: - - Paragraph before page break - - \newpage - - Paragraph after page break - - -Usage ------ - -Fully supported output formats are: - -- Docx, -- LaTeX, -- HTML, and -- EPUB. - -ODT is supported, but requires additional settings in the -reference document (see below). - -In all other formats, the page break is represented using the -form feed character. - - -### Usage with HTML -If you want to use an HTML class rather than an inline style set -the value of the metadata key `newpage_html_class` or the -environment variable `PANDOC_NEWPAGE_HTML_CLASS` (the metadata -'wins' if both are defined) to the name of the class and use CSS -like this: - - @media all { - .page-break { display: none; } - } - @media print { - .page-break { display: block; page-break-after: always; } - } - - -### Usage with ODT - -To use with ODT you must create a reference ODT with a named -paragraph style called `Pagebreak` (or whatever you set the -metadata field `newpage_odt_style` or the environment variable -`PANDOC_NEWPAGE_ODT_STYLE` to) and define it as having no extra -space before or after but set it to have a pagebreak after it -<https://help.libreoffice.org/Writer/Text_Flow>. - -(There will be an empty dummy paragraph, which means some extra -vertical space, and you probably want that space to go at the -bottom of the page before the break rather than at the top of -the page after the break!) - - -Alternative syntax ------------------- - -The form feed character as the only element in a paragraph is -supported as an alternative to the LaTeX syntax described above. |