Pandoc Zotxt.lua Versions Save

Pandoc filter that looks up bibliographic data for citations in Zotero.

v1.2.0

2 years ago

New features

  • You can now reference environment variables in the zotero-bibliography metadata field, using the ${varname} syntax.
  • The zotero-bibliography file can now be written as BibTeX or BibLaTeX in Pandoc ≥ v2.17. This is not recommended though.
  • Citation key parsing for the Web API is more robust.

Bugs fixed

  • zotxt v6 returns error messages in JSON, whereas previous versions returned them as plain text. As a consequence, pandoc-zotxt.lua crashed if an item could not be found, and with a crytpic error message at that. This has been fixed.
  • Should now run in Pandoc < v2.7.
  • Removed some other cryptic error messages and fixed some typos.
  • Corrected the required version of Pandoc in the README.

Other

When looking up citation keys via the Zotero Web API, they must now be translatable into at least two search terms.

v1.2.0b

2 years ago

New features

  • You can now use environment variables in the zotero-bibliography metadata field, using the ${varname} syntax.
  • The zotero-bibliography file can now be written as BibTeX or BibLaTeX und Pandoc ≥ v2.17. This is not recommended though.
  • Citation key parsing for the Web API is more robust.

Bugs fixed

  • New versions of zotxt return error messages in JSON, rather than as plain text. As a consequence, pandoc-zotxt.lua would abort if an item could not be found, and with a crytpic error message at that. This has been fixed.
  • Should now run in Pandoc < v2.7.
  • Removed the last overly cryptic error messages and fixed some typos.
  • Corrected the required version of Pandoc in the README.

Other

When looking up citation keys via the Zotero Web API, they must now be translatable into at least two search terms.

v1.1.0

2 years ago

New features

  • No longer fetches bibliographic data of sources in the references metadata field or BibTeX, CSL JSON, or CSL YAML bibliography files.
  • Now searches for citations in the document's metadata fields, too; in all of them, this may change in future releases.
  • Support for connecting to Zotero via the Zotero Web API in addition to/instead of via zotxt.
  • Support for pandoc's --resource-path option.
  • Atomic updates of the bibliography file.
  • The bibliography file can now be in CSL YAML format, too.

Bugs fixed

  • Works with all releases of Pandoc ≥ v2.0.2 again.
  • Users can now declare what types of citation keys they use (this fixes issue #6).
  • No longer throws away all but the first bibliography file set in the bibliography metadata field if zotero-bibliography is set.
  • No longer fails to parse the bibliography metadata field if run with Pandoc ≤ v2.11, only a single file is set, and that file is set as a YAML scalar.
  • Now prints meaningful error messages, rather than stack traces (save for a few edge cases).

v1.1.0b9

2 years ago

Dotting the i's before v1.1.

  • Disabled debugging mode.
  • Minor improvements to documentation.
  • Some refactoring.

v1.1.0b7

2 years ago
  • Minor improvements to error handling.

  • Somewhere along the way, pandoc-zotxt.lua stopped parsing the bibliography metadata field if

    1. it was run with Pandoc <v2.11,
    2. only a single bibliography file was given, and
    3. that file was given as a YAML scalar.

    This has been fixed with this release.

  • Made handling of YAML bibliography files more robust.

v1.1.0b6

2 years ago

Bugs fixed

  • If more than one bibliography file was listed in the bibliography metadata field and zotero-bibliography was set, then pandoc-zotxt.lua would discard all but the first of the original bibliography files. This is fixed here.
  • Now works with the development version of Pandoc as of commit 60fc05e.

v1.1.0b4

2 years ago

New features

  • Now supports connecting via the Zotero Web API.

Fixes

  • Restores support for Pandoc <v2.16.
  • Hopefully addresses issue #7.

v1.1.0b3

2 years ago

Features

  • Now only looks up citations if their bibliographic data can be found neither in the document's references metadata field nor in a bibliography file (this addresses issue #4).
  • Now allows users to declare what type(s) of citation keys they want to use by setting the new zotero-citekey-types metadata field (this addresses issue #6).
  • Now also searches for citations in the document's metadata fields -- in all of them; this may change in future versions (this addresses issue #7).

Fixes

  • Better error messages (this addresses another aspect of issue #4).
  • Better handling of temporary files in Pandoc >= v2.8.
  • The test suite now passes for Pandoc >= v2.15.
  • Releases no longer contain the whole repository.

Other

  • Minor improvements to the documentation.
  • Dropped the installer, which turned out to be a bottomless well of complexity.

v1.1.0b2

2 years ago

Improvements

  • Should now parse YAML files even if they start with --- and end with ... or ---.
  • Should now respect formatting if zotero-bibliography is set to a YAML file.
  • The installation script is less experimental.

Fixes

file_write now makes sure to flush the buffer of its file descriptor before closing the file.

Other

A lot of tidying up.

v1.1.0b

3 years ago

Features

  • Can now read item IDs from BibTeX/BibLaTeX files.
  • Can now use YAML bibliography files as zotero-bibliography; this feature is still experimental and needs more testing.
  • Now ships with an installer; the installer is still experimental and needs more testing.
  • Now writes out bibliographic data to a temporary file first, so that updates of the zotero-bibliography file are atomic.
  • Now prints a message when it overwrites its bibliography file.

Bugs fixed

  • New bug reported in issue #4.
  • Now supports pandoc's --resource-path option.
  • Code is more defensive.

Documentation

Various smaller changes, hopefully for the better.