[Tools-discuss] Fixing our PDF rendering

Watson Ladd <watsonbladd@gmail.com> Sat, 06 April 2024 03:11 UTC

Return-Path: <watsonbladd@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 7E2ACC14F6F6 for <tools-discuss@ietfa.amsl.com>; Fri, 5 Apr 2024 20:11:04 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.098
X-Spam-Level:
X-Spam-Status: No, score=-2.098 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_NONE=-0.0001, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-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 ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 9z3SZ1LKYXfK for <tools-discuss@ietfa.amsl.com>; Fri, 5 Apr 2024 20:11:00 -0700 (PDT)
Received: from mail-wm1-x331.google.com (mail-wm1-x331.google.com [IPv6:2a00:1450:4864:20::331]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 046FFC14F6F0 for <tools-discuss@ietf.org>; Fri, 5 Apr 2024 20:10:59 -0700 (PDT)
Received: by mail-wm1-x331.google.com with SMTP id 5b1f17b1804b1-41638ba5323so808385e9.3 for <tools-discuss@ietf.org>; Fri, 05 Apr 2024 20:10:59 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1712373058; x=1712977858; darn=ietf.org; h=to:subject:message-id:date:from:mime-version:from:to:cc:subject :date:message-id:reply-to; bh=g02caqgvrBKqVKDrKGazNdK6KIT4RybIJpTsWf0V534=; b=WQ/gFq7b5O/lovkhhbsCnfhuMzNa5ls7Jw3bARackNdH3uXF6iGwvFdKYT+a94f4mc n+8ez3Ql4dspH6v+NhMv89OItzzrtbw321QzFJF1jmVnF4WaRYLu1NSy+8JHCVQ4ej8m UQZlVKKXdoIB2J6oIE0zWjj0aGa6zDs9yv3tNXZLg3mnTM0b0bZNQ285O07SZF3R2sAP q46NwsV5pYSV/yLnslR7npLwEQyJcnnf8Kcq1F72g1quoyhzallR2FVnofVdOzCCJoeq 2NtiaU4grJfpCZd3eu168lGpkKCsbzGq93R3RCX7TEBakp4JoOAUbiE1GDUgWfK0DTyq gzdQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1712373058; x=1712977858; h=to:subject:message-id:date:from:mime-version:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=g02caqgvrBKqVKDrKGazNdK6KIT4RybIJpTsWf0V534=; b=XHj90AynzCsgt16quqcydSeK2o/k88OQ3xh61s5Cc0ijc6sbsW10YwMjJAQYuSMU2l vuWNnP3/vazw7op1bRXVJBQv2dQ9RZakTyXopQeJfEmyYGN67xT0024YF8hWr6w+huEH JXuSlPur0ZJHBVHHMwmNW1UjN0jca3wxLmv5ki7ctxtBJEzhc50QhEAj9b1t/JJgsJE8 rfXkJh1BiAGNuQI4P2Ur1+ZZt+PKLME2P8w3H75RJk65xB9vxgKkkFqm7NYfN4Z0R/D0 lbAYzqVVJzfeHnPeL90PYOjUZSEDK9KIRFRlxqwZu2piaRXlRCk7JWKeTNmEm7OQHuex D9ZQ==
X-Gm-Message-State: AOJu0YxjTJ7dv/CzcJ5VkhIgdB1opV7rUWF1NXo0equbY4/C1+IzR782 nfe61V6uvmbpScYR19dHg1+rM1aNSU5cYqKBu0kCQYokBgJ7g80VVRc/G+CSBWP25w5db/P135s kmrhnwjl/3wpDxRICfQeB2vV+AnlIC6Fa
X-Google-Smtp-Source: AGHT+IFJyBNbwSjh3LgG7Ds+bT0xXnPHzyr4hlLIm/vEVMNTq6+j2FoIUlStEfEvMGzySZJViNJZgCyy6PpIIeW4sno=
X-Received: by 2002:a05:600c:a004:b0:414:6981:cc5e with SMTP id jg4-20020a05600ca00400b004146981cc5emr2321576wmb.36.1712373057687; Fri, 05 Apr 2024 20:10:57 -0700 (PDT)
MIME-Version: 1.0
From: Watson Ladd <watsonbladd@gmail.com>
Date: Fri, 05 Apr 2024 20:10:46 -0700
Message-ID: <CACsn0c=iQG4u-p44vGA0SUuX7UoDkqN58Y-bMM81+MamL=efLg@mail.gmail.com>
To: tools-discuss@ietf.org
Content-Type: text/plain; charset="UTF-8"
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/KkaS7cUP0NyehQITxucp0kcAaPQ>
Subject: [Tools-discuss] Fixing our PDF rendering
X-BeenThere: tools-discuss@ietf.org
X-Mailman-Version: 2.1.39
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: Sat, 06 Apr 2024 03:11:04 -0000

Hello,

I'd like to try to improve the way the PDFs look. Right now the ragged
right edges particularly give me grief, but I'm suspicious of the
kerning. More controversially carrying over the header from the text
format really doesn't look good: We could instead of the key: value
format delete the redundant RFC number, put the author below the
title, the ISSN and category in a footnote (or somewhere else
unobtrusive), and use more vertical space for what most readers want
to see: the RFC number, title and authors/contributors. I think there
might be some other tweaks (especially around tables and equations
when we agree what to do) but those two seem simple, easy to fix, and
a big improvement to the reading experience.

WesleyPrint is capable of doing all of this if we coax it the right
way (see the book example), so I'm optimistic we can solve all these
problems. That optimism might be badly misplaced, but I won't know
until I give it a try, Has anyone else given it a try and want to pass
on some lessons?

Sincerely,
Watson Ladd

-- 
Astra mortemque praestare gradatim