Re: [Tools-discuss] The Document Citation Tool is (somewhat) broken

Ole Jacobsen <olejacobsen@me.com> Mon, 28 June 2021 20:05 UTC

Return-Path: <olejacobsen@me.com>
X-Original-To: tools-discuss@ietfa.amsl.com
Delivered-To: tools-discuss@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id B67183A0D99 for <tools-discuss@ietfa.amsl.com>; Mon, 28 Jun 2021 13:05:33 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.796
X-Spam-Level:
X-Spam-Status: No, score=-2.796 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=unavailable autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=me.com
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 KEXJUijSwPnG for <tools-discuss@ietfa.amsl.com>; Mon, 28 Jun 2021 13:05:28 -0700 (PDT)
Received: from mr85p00im-hyfv06011401.me.com (mr85p00im-hyfv06011401.me.com [17.58.23.191]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 41A843A0D9C for <tools-discuss@ietf.org>; Mon, 28 Jun 2021 13:05:28 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=me.com; s=1a1hai; t=1624910727; bh=JLT6WvnBwf+THxQVA4JaPBWtHWatwbJE0peRrfjQNj8=; h=Content-Type:Mime-Version:Subject:From:Date:Message-Id:To; b=PD5Rx/qfJ9RQPQtQjYJkFO0x+7IEq4tsEZlK/6i1jng95Pqi3HZsgVrmlFkK9EzO0 mjxP1FUIbGeSf/+jN96qa/VqHVXCaf2rIVO3x+we9y4CLMQvZnwtG0zrNm16QNnyM1 Na0vr5V2XTJmcA+kolE9LK8LZiF2WJ0yUYUpUHtPtYgl4Ua3AqhKmivvc0fp0okRLU t98XMSHlvet/W2q0x7i7iFAdZUXysaPnkvFcu2VjIG/y79EMQFtZiW1Wo6mnuGEIX/ C0NUbKg9cf01Fo/zVSNhcWvyZhItl6O7G2QX6MrZaBb/DwD1t5vKSpT84kGNPZPiXh s3dZZtZeQVP/w==
Received: from smtpclient.apple (157-131-155-250.fiber.dynamic.sonic.net [157.131.155.250]) by mr85p00im-hyfv06011401.me.com (Postfix) with ESMTPSA id 6FE85D20215; Mon, 28 Jun 2021 20:05:27 +0000 (UTC)
Content-Type: text/plain; charset=utf-8
Mime-Version: 1.0 (Mac OS X Mail 14.0 \(3654.100.0.2.22\))
From: Ole Jacobsen <olejacobsen@me.com>
In-Reply-To: <04FA17DA-3A85-422B-B181-F88D278A1135@ietf.org>
Date: Mon, 28 Jun 2021 13:05:26 -0700
Cc: Ole Jacobsen <olejacobsen@me.com>, Tools Discussion <tools-discuss@ietf.org>
Content-Transfer-Encoding: quoted-printable
Message-Id: <88A5738C-CB33-49E4-9B3D-FE64B69651D3@me.com>
References: <1391A159-DD66-413D-BD49-F18056583BE5@me.com> <04FA17DA-3A85-422B-B181-F88D278A1135@ietf.org>
To: Jay Daley <jay@ietf.org>
X-Mailer: Apple Mail (2.3654.100.0.2.22)
X-Proofpoint-Virus-Version: =?UTF-8?Q?vendor=3Dfsecure_engine=3D1.1.170-22c6f66c430a71ce266a39bfe25bc?= =?UTF-8?Q?2903e8d5c8f:6.0.391,18.0.790,17.0.607.475.0000000_definitions?= =?UTF-8?Q?=3D2021-06-28=5F12:2021-06-25=5F01,2021-06-28=5F12,2020-04-07?= =?UTF-8?Q?=5F01_signatures=3D0?=
X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 spamscore=0 clxscore=1015 mlxscore=0 adultscore=0 mlxlogscore=999 phishscore=0 malwarescore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2106280129
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/u63FuaOSHFw8NRFuavCx5-46BBM>
Subject: Re: [Tools-discuss] The Document Citation Tool is (somewhat) broken
X-BeenThere: tools-discuss@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: IETF Tools Discussion <tools-discuss.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tools-discuss/>
List-Post: <mailto:tools-discuss@ietf.org>
List-Help: <mailto:tools-discuss-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 28 Jun 2021 20:05:34 -0000

Hi Jay,

I only use the two output options:

{authors.andlist}, "{doctitle}," {date:%B %Y}, {docname}.

and

{authors.rfclist}, "{doctitle}," {docname}, {date:%B %Y}.

... although I usually set both the the first option {authors.andlist}
and would be more than happy if that was the only option.

Thanks for looking into this!

And: In the interim, perhaps something changed "behind the scenes" that causes this
problem that could be fixed?

Ole


> On Jun 28, 2021, at 13:00, Jay Daley <jay@ietf.org> wrote:
> 
> (moving discussion to tools-discuss)
> 
> Ole
> 
>> On 29/06/2021, at 6:36 AM, Ole Jacobsen <olejacobsen=40me.com@dmarc.ietf.org> wrote:
>> 
>> 
>> Hi,
>> 
>> Several years ago, Henrik set up this wonderful tool that creates citations for
>> IETF documents (IDs and RFCs) in a standard format. The tool is customizable
>> and lives here:
>> 
>> https://tools.ietf.org/tools/citation/
>> 
>> Enter, for example, "7575" in the box and you get:
>> 
>> Clemm, A., Behringer, M., Jiang, S., Pritikin, M., Ciavaglia, L., Bjarnason, S., and B. Carpenter,
>> "Autonomic Networking: Definitions and Design Goals," RFC 7575, June 2015.
>> 
>> It's something I use often to get a consistent list of references in
>> articles.
>> 
>> But, sadly, something is currently broken with this tool, or I suspect something has
>> changed in the back-end (datatracker or tools?) whereby recent RFCs are not recognized,
>> for example: RFC 8890 gives me: "Could not find author data for document 'rfc8990'"
>> 
>> And worse: RFC 8995 returns: "An error occurred at this point in the web-page generation.
>> An error report has been sent to the webmaster. If this error isn't fixed within 48 hours,
>> please contact the web page author directly at webmaster@tools.ietf.org."
>> 
>> I know Henrik is probably no longer maintaining this tool so I am not blaming him
>> or expecting him to fix it, but perhaps someone from the tools/datatracker group could
>> take a look at this? It really is a VERY nice tool and I would hate to see it disabled
>> forever.
>> 
>> Thanks in advance!
> 
> An RFP was recently awarded [1] for a replacement for the citation library generation and access (API and web page) tool. Unfortunately, when writing that RFP I didn’t know about this specific tool and so it is not listed as a deliverable.  However, it should be relatively straightforward to add simple output of this format, though a fully programmable output format is more complex and I’m not sure it is necessary.  Do you use that programmable output functionality?
> 
> Jay
> 
> [1] https://mailarchive.ietf.org/arch/msg/ietf-announce/XPvRg0vSCWUBaSxtX1jSVtsNb3I/
> 
>> 
>> Ole
>> 
>> 
>> Ole J. Jacobsen
>> Editor and Publisher
>> The Internet Protocol Journal
>> Office: +1 415-550-9433
>> Cell:   +1 415-370-4628
>> Web: protocoljournal.org
>> E-mail: olejacobsen@me.com
>> E-mail: ole@protocoljournal.org
>> Skype: organdemo
>> 
>> 
> 
> -- 
> Jay Daley
> IETF Executive Director
> jay@ietf.org
> 

Ole J. Jacobsen
Editor and Publisher
The Internet Protocol Journal
Office: +1 415-550-9433
Cell:   +1 415-370-4628
Web: protocoljournal.org
E-mail: olejacobsen@me.com
E-mail: ole@protocoljournal.org
Skype: organdemo