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

5.8 KiB

% 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
---