diff options
| -rw-r--r-- | changelog | 420 |
1 files changed, 199 insertions, 221 deletions
@@ -1,66 +1,22 @@ pandoc (2.7.3) - PROVISIONAL - NEEDS EDITING - - * Roll back automatic figure/table numbering in ODT/OpenDocument - (#5474). This was added in pandoc 2.7.2, but it makes it impossible - to use pandoc-crossref. So this has been rolled back for now, - until we find a good solution to make this behavior optional - (or a creative way to let pandoc-crossref and this feature - to coexist). - - * LaTeX reader: pass through unknown listings language as class (#5540). - Previously if the language was not in the list of languages supported - by listings, it would not be added as a class, so highlighting - would not be triggered. - - * PDF via ms/pdfroff: make TOC appear at beginning and in PDF bookmarks - (#5553). Previously the TOC appeared at the end of the document, and - was not bookmarked. To keep it at the end, add - `--pdf-engine-opt=--no-toc-relocation` to your command line. - - * LaTeX writer: Include inline code attributes with `--listings` (#5420). - - * Add jira writer (#2497, Albert Krewinkel). This adds support for Atlassian's - jira markup. - - * Fix typo in lua documentation (#5552). - - * Include trailing `{}`s in raw latex commands (#5439). - Change is in `rawLaTeXInline` in LaTeX reader, but it affects the markdown - reader and other readers that allow raw LaTeX. Previously, trailing `{}` - would be included for unknown commands, but not for known commands. - However, they are sometimes used to avoid a trailing space after the - command. The chances that a `{}` after a LaTeX command is not part of - the command are very small. + * Add `jira` (Atlassian's Jira wiki markup) as output format (#2497, + Albert Krewinkel). - * Docx reader: Add support for `w:rtl` (#5545). Elements with this - property are put into Span inlines with `dir="rtl"`. + * Add `tex_math_dollars` to `multimarkdownExtensions` (#5512). + This form is now supported in multimarkdown, + in addition to `tex_math_double_backslash`. - * Fix document section assignments in EPUB writer (#5546). - For example, introduction should go in bodymatter, not frontmatter, and - epigraph, conclusion, and afterward should go in bodymatter, not - backmatter. For the full list of assignments, see the manual. + * Fix `--self-contained` so it works when output format has extensions. + Previously if you used `--self-contained` with `html-smart` or + `html+smart`, it wouldn't work. - * Update pandoc-citeproc and skylighting versions. + * Add template variable `curdir` with working directory + from which pandoc is run (#5464). * Markdown reader: don't create implicit reference for empty header (#5549). - * Markdown writer: Add backslashes to avoid unwanted interpretation of - definition list terms as other kinds of block (#554). - - * Textile writer: fix closing tag for math output (Albert Krewinkel). - Opening and closing tag for math output match now. - - * Add unicode code point in "Missing character" warning (#5538). - If the character isn't in the console font, the message is pretty useless, - so we show the code point for anything non-ASCII. - - * pandoc.mediabag lua module (Albert Krewinkel): - - + Add function `delete` for deleting a single item. - + Add function `empty` for removing all entries. - + Add function `items` for iterating over mediabag. + * Muse reader: allow images inside link descriptions (Alexander Krotov). * HTML reader: epub related fixes. @@ -69,98 +25,123 @@ pandoc (2.7.3) content to be eaten with the noteref. + Rename `pAnyTag` to `pAny`. + Refactor note resolution. + + Trim definition list terms (Alexander Krotov). - * Lua: add Version type to simplify comparisons (Albert Krewinkel). - Version specifiers like `PANDOC_VERSION` and `PANDOC_API_VERSION` are - turned into `Version` objects. The objects simplify version-appropriate - comparisons while maintaining backward-compatibility. - A function `pandoc.types.Version` is added as part of the newly - introduced module `pandoc.types`, allowing users to create version - objects in scripts. - - * HTML writer: output video and audio elements depending on file - extension of the image path (Mauro Bieg). + * LaTeX reader: - * Text.Pandoc.MIME: add `mediaCategory` [API change] (Mauro Bieg). + + Add braces when resolving `\DeclareMathOperator` + (#5441). These seem to be needed for xelatex but not pdflatex. + + Allow newlines in `\mintinline`. + + Pass through unknown listings language as class (#5540). + Previously if the language was not in the list of languages supported + by listings, it would not be added as a class, so highlighting + would not be triggered. + + `rawLaTeXInline`: Include trailing `{}`s in raw latex commands (#5439). + This change affects the markdown reader and other readers that allow raw + LaTeX. Previously, trailing `{}` would be included for unknown + commands, but not for known commands. However, they are sometimes used + to avoid a trailing space after the command. The chances that a `{}` + after a LaTeX command is not part of the command are very small. - * HTML writer: emit empty alt tag in figures (#5518, Mauro Bieg). - The same text is already in the <figcaption> and - screen-readers would read it twice, see #4737. + * MediaWiki reader: handle multiple attributes in table row (#5471, + chinapedia). - * MANUAL: add note about `title-meta`, `author-meta`, `date-meta` - (#5486). + * Docx reader: Add support for `w:rtl` (#5545). Elements with this + property are put into Span inlines with `dir="rtl"`. - * Fix handling of `file:` URL scheme in `downloadOrRead` (#5517, Mauro Bieg). - Previously `file:/` URLs were handled wrongly and pandoc attempted - to make HTTP requests, which failed. + * Org reader (Albert Krewinkel): - * EPUB writer: don't include 'landmarks' if there aren't any. - Previously we could get an empty ol element, which caused - validation errors with epubcheck. + + Fix planning elements in headers level 3 and higher + (#5494). Planning info is now always placed before + the subtree contents. Previously, the planning info was placed after + the content if the header's subtree was converted to a list, which + happens with headers of level 3 and higher per default. + + Omit, but warn about unknown export options. Unknown export + options are properly ignored and omitted from the output. + + Prefer plain symbols over math symbols (#5483). + Symbols like `\alpha` are output plain and unemphasized, not as math. + + Recognize emphasis after TODO/DONE keyword (#5484). - * Consolidate simple-table detection (#5524, Mauro Bieg). - Add `onlySimpleTableCells` to `Text.Pandoc.Shared` [API change]. - This fixes an inconsistency in the HTML reader, which did not treat - tables with `<p>` inside cells as simple. + * FB2 reader (Alexander Krotov): - * Muse reader: allow images inside link descriptions (Alexander Krotov). + + Parse notes (#5493). + + Internal improvements. - * HTML reader: trim definition list terms (Alexander Krotov). + * OpenDocument writer: Roll back automatic figure/table numbering + (#5474). This was added in pandoc 2.7.2, but it makes it impossible + to use pandoc-crossref. So this has been rolled back for now, + until we find a good solution to make this behavior optional + (or a creative way to let pandoc-crossref and this feature + to coexist). - * Muse writer: do not escape empty line after `<br>` (Alexander Krotov). + * New module Text.Pandoc.Writers.Jira, exporting `writeJira` [API + change] (Albert Krewinkel). - * Disable missing-home-modules warning in `stack.yaml`. - Otherwise `stack ghci` fails. + * EPUB writer: - * Markdown writer: Ensure the code fence is long enough (#5519). - Previously too few backticks were used when the code block - contained an indented line of backticks. (Ditto tildes.) + + Don't include 'landmarks' if there aren't any. + Previously we could get an empty ol element, which caused + validation errors with epubcheck. + + Ensure unique ids for styleesheets in content.opf (#5463). + + Make stylesheet link compatible with kindlegen (#5466, + Eric Schrijver). Pandoc omitted `type="text/css"` from both + `<style>` and `<rel="stylesheet">` elements in all templates, which + is valid according to the spec. However, Amazon’s kindlegen software + relies on this attribute on `<link>` elements when detecting + stylesheets to include. - * Makefile: remove `--resolver=` from targets. - This causes unnecessary recompilation. - * Markdown writer: Handle labels with integer names (Jesse Rosenthal, - #5495). Previously if labels had integer names, it could produce a - conflict with auto-labeled reference links. Now we test for a conflict - and find the next available integer. This involves adding a new state - variable `stPrevRefs` to keep track of refs used in other document - parts when using `--reference-location=block|section` + * HTML writer: - * Improve output of Lua tests (#5499, Albert Krewinkel). - This makes use of tasty-lua, a package to write tests in Lua - and integrate the results into Tasty output. Test output becomes - more informative: individual tests and test groups become visible - in test output. Failures are reported with helpful error messages. + + Output video and audio elements depending on file + extension of the image path (Mauro Bieg). + + Emit empty alt tag in figures (#5518, Mauro Bieg). + The same text is already in the <figcaption> and + screen-readers would read it twice, see #4737. + + Don't add variation selector if it's already there. + This fixes round-trip failures. + + Prevent gratuitious emojification on iOS (#5469). + iOS chooses to render a number of Unicode entities, including '↩', as + big colorful emoji. This can be defeated by appending Unicode VARIATION + SELECTOR-15'/'VARIATION SELECTOR-16'. So we now append this character + when escaping strings, for both '↩' and '↔'. If other characters prove + problematic, they can simply be added to `needsVariationSelector`. + + Add `class="heading"` to level 7+ Headers rendered as `<p>` elements + (#5457). - * Add `tex_math_dollars` to `multimarkdownExtensions` (#5512). - This form is now supported in multimarkdown, - in addition to `tex_math_double_backslash`. + * RST writer: treat Span with no attributes as transparent (#5446). + Previously an Emph inside a Span was being treated as + nested markup and ignored. With this patch, the Span + is just ignored. - * JATS writer: properly handle footnotes (#5511). - "Best Practice: When footnotes are grouped at the end of an article, - wrap them in a `<fn-group>` and use an `<xref>` element in the text, as - usual, to tie each footnote in the list to a particular location in the - text." + * LaTeX writer: - * FB2 writer: do not wrap note references into `<sup>` and brackets - (Alexander Krotov). Existing FB2 readers, such as FBReader, already - display links with type="note" as a superscript. + + Include inline code attributes with `--listings` (#5420). + + Don't produce columns environment unless beamer (#5485). + + Fix footnote in image caption. Regression: the fix for #4683 broke + this case. - * Fix using Beamer with geometry (#5505, Daniel Maslowski). - Beamer already loads geometry, so we need to use the `\geometry` - command to set geometry options. + * EPUB writer: Fix document section assignments (#5546). + For example, introduction should go in bodymatter, not frontmatter, and + epigraph, conclusion, and afterward should go in bodymatter, not + backmatter. For the full list of assignments, see the manual. - * Org reader: fix planning elements in headers level 3 and higher - (#5494, Albert Krewinkel). Planning info is now always placed before - the subtree contents. Previously, the planning info was placed after - the content if the header's subtree was converted to a list, which - happens with headers of level 3 and higher per default. + * Markdown writer: - * Org reader: omit, but warn about unknown export options (Albert - Krewinkel). Unknown export options are properly ignored and omitted - from the output. + + Add backslashes to avoid unwanted interpretation of + definition list terms as other kinds of block (#554). + + Ensure the code fence is long enough (#5519). + Previously too few backticks were used when the code block + contained an indented line of backticks. (Ditto tildes.) + + Handle labels with integer names (Jesse Rosenthal, #5495). + Previously if labels had integer names, it could produce a conflict + with auto-labeled reference links. Now we test for a conflict and + find the next available integer. This involves adding a new state + variable `stPrevRefs` to keep track of refs used in other document + parts when using `--reference-location=block|section` - * add test/tables.xwiki to git and pandoc.cabal (#5498, Mauro Bieg). + * Textile writer: fix closing tag for math output (Albert Krewinkel). + Opening and closing tag for math output match now. * Org writer: always indent src blocks content by 2 spaces (#5440, Albert Krewinkel). Emacs always uses two spaces when indenting the content of @@ -168,66 +149,72 @@ pandoc (2.7.3) indent contents by the space-equivalent of one tab, but now always uses two spaces, too. - * FB2 reader: parse notes (#5493, Alexander Krotov). + * Asciidoc writer: - * FB2 reader: use XML.Light.Input.parseXMLDoc to parse the root element - (Alexander Krotov). + + Use `` `+...+` `` form for inline code. + The old `` `a__b__c` `` yields emphasis inside code in asciidoc. + To get a pure literal code span, use `` `+a__b__c+` ``. + + Use proper smart quotes with asciidoctor (#5487). + Asciidoctor has a different format for smart quotes. - * Reduce the amount of state in FB2 reader (Alexander Krotov). + * JATS writer: - * FB2 reader: use Text.XML.Light.unqual where possible (Alexander Krotov). + + Properly handle footnotes (#5511) according to "best practice." + (Group them at the end in `<fn-group>` and use `<xref>` elements + to link them.) + + Fix citations with PMID so they validate (#5481). This includes + an update to data/jats.csl. - * MANUAL.txt: removes double 'inside' (#5489, Christian Krause). + * FB2 writer: - * Asciidoc writer: use `` `+...+` `` form for inline code. - The old `` `a__b__c` `` yields emphasis inside code in asciidoc. - To get a pure literal code span, use `` `+a__b__c+` ``. + + Do not wrap note references into `<sup>` and brackets + (Alexander Krotov). Existing FB2 readers, such as FBReader, already + display links with type="note" as a superscript. + + Use genre metadata field (#5478). - * Asciidoc writer: use proper smart quotes with asciidoctor (#5487). - Asciidoctor has a different format for smart quotes. + * Muse writer: do not escape empty line after `<br>` (Alexander Krotov). - * LaTeX writer: don't produce columns environment unless beamer (#5485). - The environment is beamer-only and as far as I'm aware there's no latex - package that provides it for non-beamer use. + * Add unicode code point in "Missing character" warning (#5538). + If the character isn't in the console font, the message is pretty useless, + so we show the code point for anything non-ASCII. - * Org reader: prefer plain symbols over math symbols (#5483, Albert - Krewinkel). Symbols like `\alpha` are output plain and unemphasized, - not as math. + * Lua: add Version type to simplify comparisons (Albert Krewinkel). + Version specifiers like `PANDOC_VERSION` and `PANDOC_API_VERSION` are + turned into `Version` objects. The objects simplify version-appropriate + comparisons while maintaining backward-compatibility. + A function `pandoc.types.Version` is added as part of the newly + introduced module `pandoc.types`, allowing users to create version + objects in scripts. - * Org reader: recognize emphasis after TODO/DONE keyword (#5484, - Albert Krewinkel). + * pandoc.mediabag lua module (Albert Krewinkel): - * HTML writer: don't add variation selector if it's already there. - This fixes round-trip failures. + + Add function `delete` for deleting a single item. + + Add function `empty` for removing all entries. + + Add function `items` for iterating over mediabag. - * Add template variable `curdir` with working directory - from which pandoc is run (#5464). + * Text.Pandoc.Class: Fix handling of `file:` URL scheme in + `downloadOrRead` (#5517, Mauro Bieg). Previously `file:/` + URLs were handled wrongly and pandoc attempted to make HTTP + requests, which failed. - * FB2 writer: use genre metadata field (#5478). + * Text.Pandoc.MIME: add `mediaCategory` [API change] (Mauro Bieg). - * JATS writer: fix citations with PMID so they validate (#5481). - This includes an update to data/jats.csl. + * Text.Pandoc.Shared: - * metaToJSON: treat digits starting with 0 as a string, not a number - (#5479). + + Add `onlySimpleTableCells` [API change] + (Mauro Bieg) and use this to consolidate simple-table detection + (#5524). This fixes an inconsistency in the HTML reader, which did not + treat tables with `<p>` inside cells as simple. + + `metaToJSON`: treat digits starting with 0 as a string, not a number + (#5479). This fixes a regression in YAML metadata in pandoc 2.7.2. - * EPUB2/3 templates: Move inline styles to default epub.css (#5466). - Those who use a custom CSS stylesheet with EPUB should - add these lines: - ```css - code{ white-space: pre-wrap; } - span.smallcaps{ font-variant: small-caps; } - span.underline{ text-decoration: underline; } - q { quotes: "“" "”" "‘" "’"; } - div.column{ display: inline-block; vertical-align: top; width: 50%; } - ``` + * Text.Pandoc.Asciify: Add Turkish undotted-i (#5433, Mauro Bieg). - * Epub3 stylesheet link compatible with kindlegen (#5466, - Eric Schrijver). Pandoc omitted `type="text/css"` from both `<style>` - and `<rel="stylesheet">` elements in all templates, which is - valid according to the spec. However, Amazon’s kindlegen software - relies on this attribute on `<link>` elements when detecting - stylesheets to include. + * Improve output of Lua tests (#5499, Albert Krewinkel). + This makes use of tasty-lua, a package to write tests in Lua + and integrate the results into Tasty output. Test output becomes + more informative: individual tests and test groups become visible + in test output. Failures are reported with helpful error messages. * Lua: add `pandoc.system` module (#5468, Albert Krewinkel). The `system` Lua module provides utility functions to interact with the @@ -240,56 +227,51 @@ pandoc (2.7.3) end) ``` - * LaTeX reader: Allow newlines in `\mintinline`. - - * MediaWiki reader: handle multiple attributes in table row (#5471, - chinapedia). - - * Fix broken links in documents (#5473, Shim Myeongseob). - Fix broken links in doc/epub.md, doc/getting-started.md, - doc/customizing-pandoc.md, doc/using-the-pandoc-api.md. - Also, use absolute links to pandoc.org when possible, so that - the links can be followed by people viewing these documents - on GitHub. + * LaTeX template: Add pdflang to hypersetup if lang is set (#5443). - * LaTeX writer: Fix footnote in image caption. Regression: - the fix for #4683 broke this case. + * beamer template: Fix using Beamer with geometry (#5505, Daniel Maslowski). + Beamer already loads geometry, so we need to use the `\geometry` + command to set geometry options. - * reveal.js template: remove reference to head.min.js (#5448, - Winnie Hellmann). - This file has been removed in 3.8.0. - NOTE: users will need to update reveal.js to at least 3.8.0 - for their presentations generated with this version of pandoc - to work correctly. + * EPUB2/3 templates: Move inline styles to default epub.css (#5466). + NOTE: Those who use a custom CSS stylesheet with EPUB should + add these lines: - * HTML writer: prevent gratuitious emojification on iOS (#5469). - iOS chooses to render a number of Unicode entities, - including '↩', as big colorful emoji. This can be defeated by appending - Unicode VARIATION SELECTOR-15'/'VARIATION SELECTOR-16'. So we now append - this character when escaping strings, for both '↩' and '↔'. If other - characters prove problematic, they can simply be added to - `needsVariationSelector`. + code{ white-space: pre-wrap; } + span.smallcaps{ font-variant: small-caps; } + span.underline{ text-decoration: underline; } + q { quotes: "“" "”" "‘" "’"; } + div.column{ display: inline-block; vertical-align: top; width: 50%; } - * Fix `--self-contained` so it works when output format has extensions. - Previously if you used `--self-contained` with `html-smart` or - `html+smart`, it wouldn't work. + * reveal.js template: - * Allow use of `-output-directory` in `--pdf-engine-opt` (#5462). - This is currently possible with `mklatex` and `-outdir`, but - was not yet possible with xelatex and `-output-directory`. + + Updates for revealjs 3.8.0 (#5435, ebiim). + + Remove reference to head.min.js (#5448, Winnie Hellmann). + NOTE: users will need to update reveal.js to at least 3.8.0 + for their presentations generated with this version of pandoc + to work correctly. - * EPUB writer: Ensure unique ids for styleesheets in content.opf (#5463). + * Text.Pandoc.PDF: - * HTML writer: Add `class="heading"` to level 7+ Headers - rendered as `<p>` elements (#5457). + + Replace `</>` with literal `/` (#5451). + We use forward-slash for a directory separator in tmpDir, + even on Windows (because that's what tex likes). So we + should not put a backslash between the tmpDir and the + filename on Windows. This is harmless enough in normal + Windows setups, but it breaks on Cygwin. + Thanks to @cc2x for noticing and diagnosing the problem. + + Allow use of `-output-directory` in `--pdf-engine-opt` (#5462). + This is currently possible with `mklatex` and `-outdir`, but + was not yet possible with xelatex and `-output-directory`. + + For PDF via ms/pdfroff, make TOC appear at beginning and in + PDF bookmarks (#5553). Previously the TOC appeared at the end + of the document, and was not bookmarked. To keep it at the end, + add `--pdf-engine-opt=--no-toc-relocation` to your command line. - * Text.Pandoc.PDF: replace `</>` with literal `/` (#5451). - We use forward-slash for a directory separator in tmpDir, - even on Windows (because that's what tex likes). So we - should not put a backslash between the tmpDir and the - filename on Windows. This is harmless enough in normal - Windows setups, but it breaks on Cygwin. - Thanks to @cc2x for noticing and diagnosing the problem. + * Fix broken links in documents (#5473, Shim Myeongseob). + Also, use absolute links to pandoc.org when possible, so that + the links can be followed by people viewing these documents + on GitHub. * Improved sample lua tikz filter in lua-filters docs (#5445, Matthew Doty). There are three changes: @@ -298,19 +280,15 @@ pandoc (2.7.3) + It uses pdf2svg instead of imagemagick to preserve fidelity + The images produced have transparent backgrounds - * RST writer: treat Span with no attributes as transparent (#5446). - Previously an Emph inside a Span was being treated as - nested markup and ignored. With this patch, the Span - is just ignored. - - * LaTeX template: Add pdflang to hypersetup if lang is set (#5443). + * MANUAL.txt: - * LaTeX reader: add braces when resolving `\DeclareMathOperator` - (#5441). These seem to be needed for xelatex but not pdflatex. + + Add note about `title-meta`, `author-meta`, `date-meta` (#5486). + + Fix typo (#5489, Christian Krause). - * reveal.js template: updates for revealjs 3.8.0 (#5435, ebiim). + * add test/tables.xwiki to git and pandoc.cabal (#5498, Mauro Bieg). - * Asciify.hs: add Turkish undotted-i (#5433, Mauro Bieg). + * Disable missing-home-modules warning in `stack.yaml`. + Otherwise `stack ghci` fails. pandoc (2.7.2) |