@@ -72,6 +72,12 @@
7272 which URLs it is fetching, but not giving the full header). In
7373 addition, there are better error messages when fetching a URL fails.
7474
75+ * Citation support is no longer baked in to core pandoc. Users who
76+ need citations will need to install and use a separate filter
77+ (`--filter pandoc-citeproc`). This filter will take `bibliography`,
78+ `csl`, and `citation-abbreviations` from the metadata, though it
79+ may still be specified on the command line as before.
80+
7581 * Previously we used to store the directory of the first input file,
7682 even if it was local, and used this as a base directory for finding
7783 images in ODT, EPUB, Docx, and PDF. This has been confusing to many
@@ -258,7 +264,7 @@
258264 + Skip positional options after `\begin{figure}`.
259265 + Support `\v{}` for hacek (#926).
260266 + Don't add spurious ", " to citation suffixes.
261− This is added when needed in `Text.Pandoc.Biblio` anyway.
267+ This is added when needed in pandoc-citeproc.
262268 + Allow spaces in alignment spec in tables, e.g. `{ l r c }`.
263269 + Improved support for accented characters (thanks to Scott Morrison).
264270 + Parse label after section command and set id (#951).
@@ -506,51 +512,33 @@
506512
507513------------------
508514
509− TODO - metadata changes
510−
511− TODO - json module
512−
513− TODO - walk module
514−
515− TODO - citation changes
516− removed Biblio
517− removed integrated citation support
518− etc.
519− include pandoc-citeproc changes
520−
521515 * citeproc support has been removed from core pandoc (API changes).
522516
523− + The `--bibliography`, `--csl`, and `--citation-abbreviation` options are
524− now implemented as follows:
525− --bibliography FILE => --metadata bibliography=FILE --filter pandoc-citeproc
526− --csl FILE => --metadata csl=FILE
527− --citation-abbreviations FILE => --metadata csl-abbreviations=FILE
528− + Markdown and LaTeX citations as still parsed, but an external
529− filter, `pandoc-citeproc`, is now needed to process
530− them against a bibliography and CSL stylesheet. The bibliography
531− and stylesheet should be specified in the document's YAML metadata
532− (`bibliography` and `csl` fields), and the filter called with
533− `pandoc --filter pandoc-citeproc`.
534− + The `Text.Pandoc.Biblio` module has been removed, and the Markdown
517+ + The `Text.Pandoc.Biblio` module has been removed (API change),
518+ and the Markdown
535519 and LaTeX readers no longer process citations. Users of the
536520 pandoc library who want citation support will need to use
537521 `Text.CSL.Pandoc` from `pandoc-citations`.
522+
538523 + All bibliography-related fields have been removed from
539524 `ReaderOptions` and `WriterOptions`: `writerBiblioFiles`,
540− `readerReferences`, `readerCitationStyle`.
525+ `readerReferences`, `readerCitationStyle`. (API change)
526+
541527 + Note that a Cite element is now created in parsing markdown whether
542528 or not there is a matching reference (indeed, pandoc has no way of
543529 knowing, since the `--bibliography` option has been removed).
544− By default citations will print as `???`.
530+ By default citations will print as `???`. (behavior change)
531+
545532 + The `pandoc-citeproc` script will put the bibliography at the
546533 end of the document, as before. However, it will be put inside a Div
547534 element with class "references", allowing users some control
548535 over the styling of references. A final header, if any, will
549− be included in the Div.
536+ be included in the Div. (behavior change)
537+
550538 * The markdown writer will not print a bibliography if the
551539 `citations` extension is enabled. (If the citations are formatted
552540 as markdown citations, it is redundant to have a bibliography,
553− since one will be generated automatically.)
541+ since one will be generated automatically.) (behavior change)
554542
555543 * Use new flexible metadata type.
556544
@@ -568,11 +556,6 @@
568556 and `<span>` elements; in other formats they will simply pass through
569557 their contents. But they can be targeted by scripts.
570558
571− [ TODO - systematic documentation of pandoc-types API changes,
572− including .JSON, .Walk and changes to .Definition, .Builder.
573− Include the new Format newtype, and the new Span and Div
574− elements.]
575−
576559 * Added `Text.Pandoc.Walk` (in `pandoc-types`), which exports
577560 hand-written tree-walking functions that are orders of magnitude
578561 faster than the SYB functions from `Text.Pandoc.Generic`.
@@ -581,15 +564,20 @@
581564 the generic traversals `bottomUp` and `queryWith`.
582565 (API change.)
583566
584−
567+ * New module `Text.Pandoc.JSON` in pandoc-types.
568+
569+ + This provides `ToJSON` and `FromJSON` instances for the basic
570+ pandoc types. They use GHC generics and should be faster than the
571+ old JSON serialization using `Data.Aeson.Generic`.
572+
585573
586− * `Text.Pandoc.Biblio`
574+ * Citation processing improvements (now part of pandoc-citeproc):
575+ (bug fixes)
587576
588− + Override citeproc-hs's `endWithPunct`.
589− The new version correctly sees a sentence ending in '.)' as ending
590− with punctuation. This fixes a bug which led such sentences to receive
591− an extra period at the end: '.).'. Thanks to Steve Petersen for
592− reporting.
577+ + Fixed `endWithPunct` The new version correctly sees a sentence
578+ ending in '.)' as ending with punctuation. This fixes a bug which
579+ led such sentences to receive an extra period at the end: '.).'.
580+ Thanks to Steve Petersen for reporting.
593581 + Don't interfere with Notes that aren't citation notes.
594582 This fixes a bug in which notes not generated from citations were
595583 being altered (e.g. first letter capitalized) (#898).
@@ -603,12 +591,6 @@
603591 `\citep[23]{item1}` in LaTeX will be interpreted properly,
604592 with '23' treated as a locator of type 'page'.
605593
606− * New module `Text.Pandoc.JSON` in pandoc-types.
607−
608− + This provides `ToJSON` and `FromJSON` instances for the basic
609− pandoc types. They use GHC generics and should be faster than the
610− old JSON serialization using `Data.Aeson.Generic`.
611−
612594pandoc (1.11.1)
613595
614596 * Markdown reader: