Subject: [Rfc-markdown] 1.4.4: refcontent, 1.4.5: add issue numbers in doilit

From: Carsten Bormann <[email-masked]>
Date: Thu, 29 Apr 2021 07:41:43 +0200

1.4.4 adds refcontent to the bibliography YAML (single string or array of strings, each interpreted as markdown).

1.4.5 adds journal issue numbers to doilit, if available in crossref format.  
(Note that despite the refcontent support, doilit still uses the seriesinfo hack so the bibxml stays v2 compatible.)

Example (twice: first manually specified, then via doilit):

  JITTER:
    title: The Synchronization of Periodic Routing Messages
    author:
      - name: Sally Floyd
      - name: Van Jacobson
    date: 1994-04
    refcontent:
      - IEEE/ACM Transactions on Networking
      - >
        **2**(2), 122-136
    seriesinfo:
      DOI: 10.1109/90.298431
  DOI.10.1109/90.298431:

yielding

   [JITTER]   Floyd, S. and V. Jacobson, "The Synchronization of
              Periodic Routing Messages", IEEE/ACM Transactions on
              Networking, *2*(2), 122-136, DOI 10.1109/90.298431, April
              1994, <https://doi.org/10.1109/90.298431>.
   [DOI.10.1109_90.298431]
              Floyd, S. and V. Jacobson, "The synchronization of
              periodic routing messages", IEEE/ACM Transactions on
              Networking vol. 2, no. 2, pp. 122-136,
              DOI 10.1109/90.298431, April 1994,
              <https://doi.org/10.1109/90.298431>.

(Note that the **2** bold volume number had to be escaped from YAML, here via “>” syntax.
Note also that this doesn’t look great in .txt, which is why doilit is using the verbose form.
Just showing off the embedded markdown in this example… Looks great in HTML, anyway.)

(The doilit update will need to be deployed to the tools servers before the update catches on, and then needs a day to clear the caches.
You also may need to clear your local caches.)

Grüße, Carsten