pandoc/test/command/biblatex-patent.md
John MacFarlane e0984a43a9 Add built-in citation support using new citeproc library.
This deprecates the use of the external pandoc-citeproc
filter; citation processing is now built in to pandoc.

* Add dependency on citeproc library.
* Add Text.Pandoc.Citeproc module (and some associated unexported
  modules under Text.Pandoc.Citeproc).  Exports `processCitations`.
  [API change]
* Add data files needed for Text.Pandoc.Citeproc:  default.csl
  in the data directory, and a citeproc directory that is just
  used at compile-time.  Note that we've added file-embed as a mandatory
  rather than a conditional depedency, because of the biblatex
  localization files. We might eventually want to use readDataFile
  for this, but it would take some code reorganization.
* Text.Pandoc.Loging: Add `CiteprocWarning` to `LogMessage` and use it
  in `processCitations`. [API change]
* Add tests from the pandoc-citeproc package as command tests (including
  some tests pandoc-citeproc did not pass).
* Remove instructions for building pandoc-citeproc from CI and
  release binary build instructions.  We will no longer distribute
  pandoc-citeproc.
* Markdown reader: tweak abbreviation support.  Don't insert a
  nonbreaking space after a potential abbreviation if it comes right before
  a note or citation.  This messes up several things, including citeproc's
  moving of note citations.
* Add `csljson` as and input and output format. This allows pandoc
  to convert between `csljson` and other bibliography formats,
  and to generate formatted versions of CSL JSON bibliographies.
* Add module Text.Pandoc.Writers.CslJson, exporting `writeCslJson`. [API
  change]
* Add module Text.Pandoc.Readers.CslJson, exporting `readCslJson`. [API
  change]
* Added `bibtex`, `biblatex` as input formats.  This allows pandoc
  to convert between BibLaTeX and BibTeX and other bibliography formats,
  and to generated formatted versions of BibTeX/BibLaTeX bibliographies.
* Add module Text.Pandoc.Readers.BibTeX, exporting `readBibTeX` and
  `readBibLaTeX`. [API change]
* Make "standalone" implicit if output format is a bibliography format.
  This is needed because pandoc readers for bibliography formats put
  the bibliographic information in the `references` field of metadata;
  and unless standalone is specified, metadata gets ignored.
  (TODO: This needs improvement. We should trigger standalone for the
  reader when the input format is bibliographic, and for the writer
  when the output format is markdown.)
* Carry over `citationNoteNum` to `citationNoteNumber`.  This was just
  ignored in pandoc-citeproc.
* Text.Pandoc.Filter: Add `CiteprocFilter` constructor to Filter.
  [API change] This runs the processCitations transformation.
  We need to treat it like a filter so it can be placed
  in the sequence of filter runs (after some, before others).
  In FromYAML, this is parsed from `citeproc` or `{type: citeproc}`,
  so this special filter may be specified either way in a defaults file
  (or by `citeproc: true`, though this gives no control of positioning
  relative to other filters).  TODO: we need to add something to the
  manual section on defaults files for this.
* Add deprecation warning if `upandoc-citeproc` filter is used.
* Add `--citeproc/-C` option to trigger citation processing.
  This behaves like a filter and will be positioned
  relative to filters as they appear on the command line.
* Rewrote the manual on citatations, adding a dedicated Citations
  section which also includes some information formerly found in
  the pandoc-citeproc man page.
* Look for CSL styles in the `csl` subdirectory of the pandoc user data
  directory.  This changes the old pandoc-citeproc behavior, which looked
  in `~/.csl`.  Users can simply symlink `~/.csl` to the `csl`
  subdirectory of their pandoc user data directory if they want
  the old behavior.
* Add support for CSL bibliography entry formatting to LaTeX, HTML,
  Ms writers.  Added CSL-related CSS to styles.html.
2020-09-21 10:15:50 -07:00

158 lines
5.8 KiB
Markdown

```
% pandoc -f biblatex -t markdown -s
@comment{adapted from http://mirrors.ctan.org/macros/latex/contrib/biblatex/doc/examples/biblatex-examples.bib
TODO: Is there a CSL counterpart for the biblatex field "holder"?}
@patent{almendro,
Annotation = {This is a patent entry with a location field. The number is given in the number field. Note the format of the location field in the database file. Compare laufenberg, sorace, and kowalik},
Author = {Almendro, José L. and Martín, Jacinto and Sánchez, Alberto and Nozal, Fernando},
Date = 1998,
Hyphenation = {german},
Location = {countryfr and countryuk and countryde},
Number = {EU-29702195U},
Title = {Elektromagnetisches Signalhorn}}
@patent{kowalik,
Annotation = {This is a patent entry for a French patent request with a full date. The number is given in the number field. Note the format of the type and date fields in the database file. Compare almendro, laufenberg, and sorace},
Author = {Kowalik, F. and Isard, M.},
Date = {1995-01-11},
Hyphenation = {french},
Indextitle = {Estimateur d'un défaut de fonctionnement},
Number = 9500261,
Title = {Estimateur d'un défaut de fonctionnement d'un modulateur en quadrature et étage de modulation l'utilisant},
Type = {patreqfr}}
@patent{laufenberg,
Annotation = {This is a patent entry with a holder field. Note the format of the type and location fields in the database file. Compare almendro, sorace, and kowalik},
Author = {Laufenberg, Xaver and Eynius, Dominique and Suelzle, Helmut and Usbeck, Stephan and Spaeth, Matthias and Neuser-Hoffmann, Miriam and Myrzik, Christian and Schmid, Manfred and Nietfeld, Franz and Thiel, Alexander and Braun, Harald and Ebner, Norbert},
Date = {2006-09-13},
File = {http://v3.espacenet.com/textdoc?IDX=EP1700367},
Holder = {{Robert Bosch GmbH} and {Daimler Chrysler AG} and {Bayerische Motoren Werke AG}},
Hyphenation = {german},
Number = 1700367,
Title = {Elektrische Einrichtung und Betriebsverfahren},
Type = {patenteu},
Abstract = {The invention relates to an electric device comprising a
generator, in particular for use in the vehicle electric
system of a motor vehicle and a controller for controlling the
generator voltage. The device is equipped with a control zone,
in which the voltage is controlled and zones, in which the
torque is controlled. The invention also relates to methods
for operating a device of this type.}}
@patent{sorace,
Annotation = {This is a patent entry with a holder field. Note the format of the type and date fields in the database file. Compare almendro, laufenberg, and kowalik},
Author = {Sorace, Ronald E. and Reinhardt, Victor S. and Vaughn, Steven A.},
Date = {1997-09-16},
Date-Modified = {2013-10-16 13:44:15 +0000},
Holder = {{Hughes Aircraft Company}},
Hyphenation = {american},
Number = 5668842,
Title = {High-Speed Digital-to-{RF} Converter},
Type = {patentus}}
^D
---
nocite: '[@*]'
references:
- annote: 'This is a patent entry with a location field. The number is
given in the number field. Note the format of the location field in
the database file. Compare laufenberg, sorace, and kowalik'
author:
- family: Almendro
given: José L.
- family: Martín
given: Jacinto
- family: Sánchez
given: Alberto
- family: Nozal
given: Fernando
id: almendro
issued: 1998
jurisdiction: France; United Kingdom; Germany
language: 'de-DE'
number: 'EU-29702195U'
title: Elektromagnetisches Signalhorn
type: patent
- annote: 'This is a patent entry for a French patent request with a
full date. The number is given in the number field. Note the format
of the type and date fields in the database file. Compare almendro,
laufenberg, and sorace'
author:
- family: Kowalik
given: F.
- family: Isard
given: M.
genre: French patent request
id: kowalik
issued: '1995-01-11'
language: 'fr-FR'
number: 9500261
title: 'Estimateur d''un défaut de fonctionnement d''un modulateur en
quadrature et étage de modulation l''utilisant'
type: patent
- abstract: 'The invention relates to an electric device comprising a
generator, in particular for use in the vehicle electric system of a
motor vehicle and a controller for controlling the generator
voltage. The device is equipped with a control zone, in which the
voltage is controlled and zones, in which the torque is controlled.
The invention also relates to methods for operating a device of this
type.'
annote: 'This is a patent entry with a holder field. Note the format
of the type and location fields in the database file. Compare
almendro, sorace, and kowalik'
author:
- family: Laufenberg
given: Xaver
- family: Eynius
given: Dominique
- family: Suelzle
given: Helmut
- family: Usbeck
given: Stephan
- family: Spaeth
given: Matthias
- family: 'Neuser-Hoffmann'
given: Miriam
- family: Myrzik
given: Christian
- family: Schmid
given: Manfred
- family: Nietfeld
given: Franz
- family: Thiel
given: Alexander
- family: Braun
given: Harald
- family: Ebner
given: Norbert
genre: European patent
id: laufenberg
issued: '2006-09-13'
language: 'de-DE'
number: 1700367
title: Elektrische Einrichtung und Betriebsverfahren
type: patent
- annote: 'This is a patent entry with a holder field. Note the format
of the type and date fields in the database file. Compare almendro,
laufenberg, and kowalik'
author:
- family: Sorace
given: Ronald E.
- family: Reinhardt
given: Victor S.
- family: Vaughn
given: Steven A.
genre: U.S. patent
id: sorace
issued: '1997-09-16'
language: 'en-US'
number: 5668842
title: 'High-speed digital-to-RF converter'
type: patent
---
```