IETF Logo Mail Archive

[Tools-discuss] Re: RFCXML / kramdown-rfc Rosetta Stone

Jean Mahoney <jmahoney@staff.rfc-editor.org> Fri, 24 July 2026 08:22 UTC

Return-Path: <jmahoney@staff.rfc-editor.org>
X-Original-To: tools-discuss@mail2.ietf.org
Delivered-To: tools-discuss@mail2.ietf.org
Received: from localhost (localhost [127.0.0.1]) by mail2.ietf.org (Postfix) with ESMTP id 71DDF11DFAC50 for <tools-discuss@mail2.ietf.org>; Fri, 24 Jul 2026 01:22:36 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ietf.org; s=ietf1; t=1784881356; bh=CMgcnLrt11TTgL47UXoAGuK1B4I7DUp54Yc83kwor4Y=; h=Date:Subject:To:Cc:References:Reply-To:From:In-Reply-To; b=CFqyvk1+jJnVCZB6Isj3aaoi+oacX1Swc0n2zK+OkVLkIXZqCw3uEaMSO0etStXfA lyxe9zXw6m9giAJhPT6/4gdpW/iN8+8KbBRMGLJoj791RtSfJF9+dS9Aouwhus1r8L 1xcMgSnwHL0AdQcIcPSub6+UvJtqZ8Ho9qS+s730=
X-Virus-Scanned: amavisd-new at ietf.org
X-Spam-Flag: NO
X-Spam-Score: -1.9
X-Spam-Level:
X-Spam-Status: No, score=-1.9 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001] autolearn=unavailable autolearn_force=no
Authentication-Results: mail2.ietf.org (amavisd-new); dkim=pass (2048-bit key) header.d=staff-rfc-editor-org.20251104.gappssmtp.com
Received: from mail2.ietf.org ([166.84.6.31]) by localhost (mail2.ietf.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id dLJ1AWY2fHRL for <tools-discuss@mail2.ietf.org>; Fri, 24 Jul 2026 01:22:34 -0700 (PDT)
Received: from mail-wr1-x432.google.com (mail-wr1-x432.google.com [IPv6:2a00:1450:4864:20::432]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature ECDSA (P-256) server-digest SHA256) (No client certificate requested) by mail2.ietf.org (Postfix) with ESMTPS id B99A811DFAC3D for <tools-discuss@ietf.org>; Fri, 24 Jul 2026 01:22:34 -0700 (PDT)
Received: by mail-wr1-x432.google.com with SMTP id ffacd0b85a97d-47f59f25ec4so75810f8f.2 for <tools-discuss@ietf.org>; Fri, 24 Jul 2026 01:22:34 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=staff-rfc-editor-org.20251104.gappssmtp.com; s=20251104; t=1784881354; x=1785486154; darn=ietf.org; h=content-transfer-encoding:content-type:in-reply-to:from:reply-to :content-language:references:cc:to:subject:user-agent:mime-version :date:message-id:from:to:cc:subject:date:message-id:reply-to :content-type; bh=4dNyhifHKAhR3Wy/3ssvSm9JS6WqusIC1ZZkfnu6c6Y=; b=dDOArZAUupqwZmkOGfPi1vUVHseNhF2HYourGBUyXgDPTxvPDhcYqJeVDWqfQJrhZz G5KuY+S+OhL5rCxbEcrNlc4nEB/Bgx/aaDp1YcHj2MI5MvTRD/TM5rtkXbzYjKRZbVbN eUoiGqb3lf5223OAG37Mea1YLXevnlb0UW2nC05rTIgqF9An4THt367lg2l2WEESSWLI etrju8o7SzSJPsiuHDZtigrYFjNzadYfi2vL4x0v8utm35QGmADs17O+fj/v1YovIF97 f9FMEd8FY4e30WaQvVT9C88ihglN5gQ4VsW+Yv/BeeOGh2hn/ShQtRZM12sjKcW9OagB 9oVg==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1784881354; x=1785486154; h=content-transfer-encoding:content-type:in-reply-to:from:reply-to :content-language:references:cc:to:subject:user-agent:mime-version :date:message-id:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to:content-type; bh=4dNyhifHKAhR3Wy/3ssvSm9JS6WqusIC1ZZkfnu6c6Y=; b=GXszvdbJ/umk+FB7a5qRaB+dFrvF3QuGXqlC0zXqyZRv42TyU5nthqzd3uao/eiggI ChWoIgP7K22YJsQiJIu9z2zFEXPjuPGQ8Tx9uQzP6iWT1hGWfOyMtL87DP7ZDPDUwpZO jLPCAr3Chv9rCrPifYop8qXRON88xcXQgXbBYDMIF6/ji4VMdv4ooKZcf8jJBkLIgW8q NJVInZnsM6G+V0Qyb71DqCgK8RuhM690yLKKdonfExjfubWLAiKhPF0oT5RSJFd80gY3 BntNphwUKKwJji4iBUeDOemog/W97fVerinHKljChWA4omlVRqFMgWsGjZvxj0n8zGr9 7KmQ==
X-Forwarded-Encrypted: i=1; AHgh+RoaIhZ+jg190LWv2k5myoIoYe9KCO8un0RLC/ppe++BVM/qOuluMXAwnCyWGLytwI6cgfV2Fp30gXMzbx8G@ietf.org
X-Gm-Message-State: AOJu0YzfikCCUaAGgBjK/x1ZKVKbUf26YHy3TMzWdI2yLsj4dHh1IQo1 xyXXAXjRILU2nmKbZj/MiXSPmpMdZpLxQ39JISzx7KlWCCXGaUS+Z5Ik40YbOS1aFRKlozRjhTu BIZyMe9G6Rg==
X-Gm-Gg: AR+sD13Z7gylF8Fb6R2vbGh/dIWLT086GXPSMYfm/0F5/dpsFBNjz14bJOXS8PN1xXz DjAeIYgnRlxzLVIkGp+z7yLVvMzwFLH3kNGTzYS4u3i2WOU6qhHawRbjyLQ7LmccMQAlr2H0Rkt SAJdQntu3Sex5+8OsOXO1eu0Pt7lBFITqqD0oqfGmW8S2+7GSpdYYDDkFFs3bnMn339bTgjAedo h+2Ewi7YZQc5HSJd3ifuiR2U1SyFfMxhsrFJ6c9R/NMsWNBu0zokg05I3Ek7hB2sW7uJSCMTbsW OmHfFvCkyEI6Sz9nYNjYIJi6ESo//eMPijw3l4AUdKAkM78vhB19bZx8OXEIenL72IuD4skuQ1i GpTDo4c+ifY6Rvn1qZbdJDoRNUwNUoUGaD34zQ9psW2scTLRrYHyXQnGiqiztHi2BbKkufLCWDu MZLcooK8SvI8PCMDYrQvLskj7LL2EqzPSwJJZgdfriBwIpbL3aALDw+RiCHX0NSINnIzlnz3mzU 4Mx
X-Received: by 2002:a5d:64c3:0:b0:47f:6a3a:9e6b with SMTP id ffacd0b85a97d-47f8dc8cdd3mr7952290f8f.32.1784881353750; Fri, 24 Jul 2026 01:22:33 -0700 (PDT)
Received: from ?IPV6:2001:67c:370:1998:f4b5:9c98:8e9b:ebbd? ([2001:67c:370:1998:f4b5:9c98:8e9b:ebbd]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-47f85c7880dsm23060609f8f.37.2026.07.24.01.22.33 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Fri, 24 Jul 2026 01:22:33 -0700 (PDT)
Message-ID: <bf3431c9-cc54-4d8b-8a4f-0b4dda888a99@staff.rfc-editor.org>
Date: Fri, 24 Jul 2026 10:22:32 +0200
MIME-Version: 1.0
User-Agent: Mozilla Thunderbird
To: Mark Nottingham <mnot@mnot.net>
References: <7543ba56-c0d0-4d2a-8a78-78bd583e0ceb@staff.rfc-editor.org> <92349DA7-4D6A-428A-A5A6-D176189C3C81@mnot.net>
Content-Language: en-US
From: Jean Mahoney <jmahoney@staff.rfc-editor.org>
In-Reply-To: <92349DA7-4D6A-428A-A5A6-D176189C3C81@mnot.net>
Content-Type: text/plain; charset="UTF-8"; format="flowed"
Content-Transfer-Encoding: 8bit
Message-ID-Hash: EX37SJXABMT5U2QYG7QX3F2GQENYCV7M
X-Message-ID-Hash: EX37SJXABMT5U2QYG7QX3F2GQENYCV7M
X-MailFrom: jmahoney@staff.rfc-editor.org
X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-tools-discuss.ietf.org-0; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header
CC: WG Chairs <wgchairs@ietf.org>, Tools Team Discussion <tools-discuss@ietf.org>, rfc-markdown@ietf.org, "xml2rfc@ietf.org" <xml2rfc@ietf.org>
X-Mailman-Version: 3.3.9rc6
Precedence: list
Reply-To: Tools Team Discussion <tools-discuss@ietf.org>
Subject: [Tools-discuss] Re: RFCXML / kramdown-rfc Rosetta Stone
List-Id: IETF Tools Discussion <tools-discuss.ietf.org>
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/glLnXpXCbwiAljoLADolOkw-XO4>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tools-discuss>
List-Help: <mailto:tools-discuss-request@ietf.org?subject=help>
List-Owner: <mailto:tools-discuss-owner@ietf.org>
List-Post: <mailto:tools-discuss@ietf.org>
List-Subscribe: <mailto:tools-discuss-join@ietf.org>
List-Unsubscribe: <mailto:tools-discuss-leave@ietf.org>

(setting followups to tools-discuss)

On 7/24/26 9:58 AM, Mark Nottingham wrote:
> Hi Jean,
> 
> That's amazing, thanks so much!  Unfortunately the site navigation makes it difficult to use without a lot of horizontal scrolling on a laptop screen -- any way to address that?

[JM] There's an open discussion/issue for wiki.js to add that functionality.

https://github.com/requarks/wiki/discussions/4891

Best regards,
Jean

> 
> Cheers,
> 
> 
>> On 24 Jul 2026, at 9:35 am, Jean Mahoney <jmahoney@staff.rfc-editor.org> wrote:
>>
>> Hi all,
>>
>> We've added a quick reference to authors.ietf.org that shows how to format various document elements, such as references and tables, in both RFCXML and kramdown-rfc:
>>
>>   https://authors.ietf.org/en/rfcxml-markdown-syntax-tables
>>
>> Best regards,
>> Jean
>>
> 
> --
> Mark Nottingham   https://mnot.net/
>

v2.46.0 | Report a Bug | By Email | System Status