Re: [Tools-discuss] The Document Citation Tool is (somewhat) broken
Brian E Carpenter <brian.e.carpenter@gmail.com> Mon, 28 June 2021 21:55 UTC
Return-Path: <brian.e.carpenter@gmail.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 040393A15F0; Mon, 28 Jun 2021 14:55:27 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.435
X-Spam-Level:
X-Spam-Status: No, score=-2.435 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, NICE_REPLY_A=-0.338, RCVD_IN_DNSWL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.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 AF_Z2-jk10VV; Mon, 28 Jun 2021 14:55:22 -0700 (PDT)
Received: from mail-pg1-x52e.google.com (mail-pg1-x52e.google.com [IPv6:2607:f8b0:4864:20::52e]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 065F03A15F2; Mon, 28 Jun 2021 14:55:21 -0700 (PDT)
Received: by mail-pg1-x52e.google.com with SMTP id 80so907331pgg.10; Mon, 28 Jun 2021 14:55:21 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=subject:to:cc:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=DbEf5Sio4f71qWhkr2AaJzctP6RYDtQbX4i2m4G6GCE=; b=vb7iaVM2T8I7OmCGTVCdUJSd2VkN9fkqrxWGdWVYR7nFzMF6/72md4FFJBZ4Z5yYAU fC9681SLYdN/FRhneEoIR52sNqVn/1KI0KAvxS5wax3WUiEw33e7ig1oDlvAjmRfEpa0 dpGnL+5DSZrln21YrirLNMhyjUeTJnv9dspSjKqTEbqkx7xT8Wc2p9iIdHXfyGJ12H9R WgqLU0VfE/LUM9kcY2c/a/khGkbgFKXb6mJxBdQj9vjYH354jdC05RpszSVRF/Gra99Z 5qExs9QQlAR1CNUfT4ZcXzJOC9kR1UYp2q9CTEnxWkqyttbVp0e+hfEH8MWD7B6wMCV/ I+OQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:cc:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=DbEf5Sio4f71qWhkr2AaJzctP6RYDtQbX4i2m4G6GCE=; b=eiDc4uLWwHmp/iPCLv+xA9QRYTF4MktbO85S65zvukeh3PNd+iF1s6D10ZCiAkCSw1 e7p1AOlxrLmev+2Xu1hoeVs82i8L/VGigH55SsyIlNdXRVA3Z9acAfNR2MyrOd4eqz3D uSAo+3yzZQkvBRSLMNJeup5bIdxrzsu4LWAk8xYeFqRpNBtb4U4GvLs/BvOKHhTiDC9M isFPBzE/41cDKmpnL/t4FwUzvda4AQqAbUiHC5/ymXSlW9MoLCDHGV9rbm/kJj7KDqPx 3qy2mpjMxXlfeREMmVYzusuq1zwWd2/9l2R5u9L5axkCkk3jenIty3xn/7qMFLxLu0KJ Yy/A==
X-Gm-Message-State: AOAM532JhDwbSFLn2cSoyipOVl9KqDuFefQ2PES+/RSJY7SRwleufuCC m14/z6hbIF/XENCkfjIS6Ynp9RaFb08x/A==
X-Google-Smtp-Source: ABdhPJypDYuj50RHqu3rBMnsFUkBZBbBL1p2sL8kkKwxQpOnXj6KtG1U6oft+KHoAHEvzUXA0yoSmA==
X-Received: by 2002:a63:1601:: with SMTP id w1mr24963320pgl.116.1624917320884; Mon, 28 Jun 2021 14:55:20 -0700 (PDT)
Received: from ?IPv6:2406:e003:100d:901:80b2:5c79:2266:e431? ([2406:e003:100d:901:80b2:5c79:2266:e431]) by smtp.gmail.com with ESMTPSA id p3sm558957pjt.0.2021.06.28.14.55.18 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 28 Jun 2021 14:55:20 -0700 (PDT)
To: Ole Jacobsen <olejacobsen=40me.com@dmarc.ietf.org>, Jay Daley <jay@ietf.org>
Cc: Ole Jacobsen <olejacobsen@me.com>, Tools Discussion <tools-discuss@ietf.org>
References: <1391A159-DD66-413D-BD49-F18056583BE5@me.com> <04FA17DA-3A85-422B-B181-F88D278A1135@ietf.org> <88A5738C-CB33-49E4-9B3D-FE64B69651D3@me.com>
From: Brian E Carpenter <brian.e.carpenter@gmail.com>
Message-ID: <71c62a48-f2b3-1058-bab9-da72923ccb76@gmail.com>
Date: Tue, 29 Jun 2021 09:55:15 +1200
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:78.0) Gecko/20100101 Thunderbird/78.10.0
MIME-Version: 1.0
In-Reply-To: <88A5738C-CB33-49E4-9B3D-FE64B69651D3@me.com>
Content-Type: text/plain; charset="utf-8"
Content-Language: en-US
Content-Transfer-Encoding: quoted-printable
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/aUnhjZ_F6PJygQ46sbmOfVTXZ7o>
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 21:55:27 -0000
Note that https://www.rfc-editor.org/info/rfc8990 offers "Cite this RFC: TXT | XML". For LaTeX lovers, there are also .bib options around. Regards Brian Carpenter On 29-Jun-21 08:05, Ole Jacobsen wrote: > 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 > > > > ___________________________________________________________ > Tools-discuss mailing list - Tools-discuss@ietf.org > This list is for discussion, not for action requests or bug reports. > * Report datatracker and mailarchive bugs to: datatracker-project@ietf.org > * Report tools.ietf.org bugs to: webmaster@tools.ietf.org > * Report all other bugs or issues to: ietf-action@ietf.org > List info (including how to Unsubscribe): https://www.ietf.org/mailman/listinfo/tools-discuss >
- Re: [Tools-discuss] The Document Citation Tool is… Carsten Bormann
- Re: [Tools-discuss] The Document Citation Tool is… Jay Daley
- Re: [Tools-discuss] The Document Citation Tool is… Ole Jacobsen
- Re: [Tools-discuss] The Document Citation Tool is… Jay Daley
- Re: [Tools-discuss] The Document Citation Tool is… Brian E Carpenter
- Re: [Tools-discuss] The Document Citation Tool is… Larry Masinter