[Rfc-markdown] 1.4.4: refcontent, 1.4.5: add issue numbers in doilit
Carsten Bormann <cabo@tzi.org> Thu, 29 April 2021 05:41 UTC
Return-Path: <cabo@tzi.org>
X-Original-To: rfc-markdown@ietfa.amsl.com
Delivered-To: rfc-markdown@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1])
by ietfa.amsl.com (Postfix) with ESMTP id 575DB3A30D4
for <rfc-markdown@ietfa.amsl.com>; Wed, 28 Apr 2021 22:41:52 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.919
X-Spam-Level:
X-Spam-Status: No, score=-1.919 tagged_above=-999 required=5
tests=[BAYES_00=-1.9, RCVD_IN_MSPIKE_H4=-0.01,
RCVD_IN_MSPIKE_WL=-0.01, SPF_HELO_NONE=0.001, SPF_PASS=-0.001,
URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Received: from mail.ietf.org ([4.31.198.44])
by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024)
with ESMTP id Te-TAQXBWcKa for <rfc-markdown@ietfa.amsl.com>;
Wed, 28 Apr 2021 22:41:47 -0700 (PDT)
Received: from gabriel-vm-2.zfn.uni-bremen.de (gabriel-vm-2.zfn.uni-bremen.de
[134.102.50.17])
(using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits))
(No client certificate requested)
by ietfa.amsl.com (Postfix) with ESMTPS id B0CFA3A30CB
for <rfc-markdown@ietf.org>; Wed, 28 Apr 2021 22:41:47 -0700 (PDT)
Received: from [192.168.217.112] (p548dcb12.dip0.t-ipconnect.de
[84.141.203.18])
(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
(No client certificate requested)
by gabriel-vm-2.zfn.uni-bremen.de (Postfix) with ESMTPSA id 4FW4BJ2l06zyVg;
Thu, 29 Apr 2021 07:41:44 +0200 (CEST)
From: Carsten Bormann <cabo@tzi.org>
Content-Type: text/plain;
charset=utf-8
Content-Transfer-Encoding: quoted-printable
Mime-Version: 1.0 (Mac OS X Mail 14.0 \(3654.60.0.2.21\))
Date: Thu, 29 Apr 2021 07:41:43 +0200
Message-Id: <D519AE09-7AB9-446A-B46E-273AC263A36C@tzi.org>
To: RFC Markdown <rfc-markdown@ietf.org>
X-Mailer: Apple Mail (2.3654.60.0.2.21)
Archived-At: <https://mailarchive.ietf.org/arch/msg/rfc-markdown/JwqmqregJ7Afk9LWRJZhv_I2w1w>
Subject: [Rfc-markdown] 1.4.4: refcontent, 1.4.5: add issue numbers in doilit
X-BeenThere: rfc-markdown@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "rfc-markdown is a discussion list for people writing I-Ds and RFCs
in Markdown and the authors of the tools used for that."
<rfc-markdown.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/rfc-markdown>,
<mailto:rfc-markdown-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/rfc-markdown/>
List-Post: <mailto:rfc-markdown@ietf.org>
List-Help: <mailto:rfc-markdown-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/rfc-markdown>,
<mailto:rfc-markdown-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 29 Apr 2021 05:41:54 -0000
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
- [Rfc-markdown] 1.4.4: refcontent, 1.4.5: add issu… Carsten Bormann