En bref
Un court document parlementaire. Il montre l’ancienne rédaction d’une loi avec les mots retirés barrés et les mots nouveaux soulignés, puis toute la section modifiée dans un encadré grisé.
Ce que vous allez composer
Un document de commission comme ceux qui accompagnent un projet de loi : cinq pages qui montrent ce que la section 102 du Sonny Bono Copyright Term Extension Act de 1998 a fait au titre 17 du Code des États-Unis. La loi dit seulement « supprimer “fifty” et insérer “70” » ; ce document donne la loi telle qu’elle était, chaque changement marqué à sa place, les suppressions barrées et les ajouts soulignés, sous la légende que les rédacteurs fédéraux et ceux des États impriment en tête de ces textes, puis la section 302 modifiée dans un encadré teinté, chaque lettre de paragraphe au bord et ses lignes en sommaire sous le texte. L’édition espagnole fait de même pour les trois révisions de la Constitution espagnole, publiées au BOE en 1992, 2011 et 2024.
Cette recette répond à
- Comment montrer une modification avec les mots supprimés barrés et les mots ajoutés soulignés ?
La réponse courte
// In the text, ~~fifty~~ strikes a deleted word and :underline[70] underlines the new one.
// Both lines are painted from the face's own metrics and take no room, so the struck and
// the inserted words justify and hyphenate like any others. The amended text then sits in
// a box whose paragraphs hang: '(a)', a tab, and every turnover line under the text.
const label = { fontFamily: SANS, fontSize: pt(7.5), fontWeight: 700, letterSpacing: pt(1.1),
textTransform: 'uppercase', color: col('accent') };
const clauses = { fontFamily: SERIF, fontSize: pt(9.5), lineHeight: pt(13), color: col('ink'),
boldColor: col('ink'), italicColor: col('ink'), textAlign: 'left', // a box's measure is short
hangingIndent: HANG, // every line but the first starts 7 mm in (postext ≥ 1.71)
tabStops: [{ position: HANG }] }; // and the tab after the marker takes the text there
const pad = (v, h) => ({ top: mm(v), right: mm(h), bottom: mm(v), left: mm(h) });
const calloutStyles = [
// The coding legend: a red rule down its side, the label face.
{ id: 'legend', backgroundEnabled: false,
stripe: { enabled: true, side: 'left', width: pt(2.5), color: col('accent') },
padding: pad(1.5, 3.5), body: { fontFamily: SANS, fontSize: pt(9), lineHeight: pt(12.5),
color: col('ink'), boldColor: col('accent'), firstLineIndent: pt(0), textAlign: 'left' } },
// The bill's own words: a red rule on top, clauses hung, no tint.
{ id: 'bill', backgroundEnabled: false,
stripe: { enabled: true, side: 'top', width: pt(2.5), color: col('accent') },
padding: pad(2.5, 0), body: clauses, keepTogether: false, // it may run on to the next page
// its title keeps its case: "(b)" stays "(b)"
titleStyle: { ...label, textTransform: 'none', letterSpacing: pt(0.2), fontSize: pt(8.5),
color: col('ink') } },
// The text as amended: a tint, the clauses hung the same way.
{ id: 'amended', background: col('tint'), padding: pad(3.5, 4.5), titleStyle: label,
body: clauses },
];
Ingrédients
- Fonctionnalités
- Texte barréTexte soulignéParagraphes en sommaire dans un encadréTaquets de tabulation et points de conduiteEncadrésEncadrés qui se coupent ou restent entiersPalette de couleurs sémantiqueOuvertures composéesAttributs de titreTitres courants et foliosTitres courants selon le rôle de la pageMarges en miroirStyles de paragrapheVeuves, orphelines et fins de paragraphe trop courtesExport PDFPolices intégrées au PDF
- Typographie
- Source Serif 4, Source Sans 3 (SIL OFL 1.1)
- Ressources
- Aucune : chaque image est dessinée en code
Préparation
#1 · Marquer le changement là où il a lieu
Le code est la réponse courte plus haut. Les marques sont dans le Markdown : ~~fifty~~ :underline[70] barre l’ancien mot et souligne le nouveau (texte barré, texte souligné). Aucun des deux traits ne prend de place : une clause barrée de six lignes se justifie et se coupe comme le texte qui l’entoure, et à la page 3 toute l’ancienne sous-section 304(b) est barrée et sa remplaçante soulignée dans un seul paragraphe. Chaque trait suit les mesures de barré et de soulignement de la fonte elle-même, dans la couleur des mots, si bien que les petites capitales d’un intitulé reçoivent leur propre trait, à leur propre hauteur.
#2 · Les clauses en sommaire dans l’encadré
body.hangingIndent dans un style d’encadré met tous les paragraphes de l’encadré en sommaire (typographie dans un encadré) : la première ligne part du bord intérieur et les suivantes 7 mm plus loin. Un taquet de tabulation aux mêmes 7 mm porte le texte qui suit « (a) » ou « (c) » jusqu’à ce bord, quelle que soit la largeur de la lettre ; dans le Markdown, on écrit donc (a):tab In General.—…. Les clauses de la loi et la section modifiée partagent la typographie et ne diffèrent que par leur cadre : un filet rouge au-dessus de la loi, une teinte derrière le texte en vigueur. L’encadré de la loi peut se couper (keepTogether: false), si bien que la page 1 se termine sur ses deux premières clauses.
#3 · Un bandeau pour l’ouverture
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });
const BAND = 66; // mm from the trim top to the foot of the band
const opener = { enabled: true, minHeight: mm(BAND - 22 + 6), marginBottom: pt(0), slot: {
elements: [
{ kind: 'box', id: 'band', style: { backgroundColor: col('band') },
placement: { ...at('bleed', 'top-left'), size: { width: 'fill', height: mm(BAND + 3) } } },
{ kind: 'text', id: 'kicker', content: '{attr.kicker}', ...label, color: col('pale'),
placement: { ...at('container', 'top-left', 0, 6), size: { width: mm(112) } } },
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: SERIF, fontWeight: 700,
fontSize: pt(30), lineHeight: 1.05, color: col('paper'), align: 'left',
placement: { ...at('#kicker', 'below', 0, 3), size: { width: mm(112), height: 'auto' } } },
{ kind: 'text', id: 'dek', content: '{attr.dek}', fontFamily: SERIF, italic: true,
fontSize: pt(10.5), lineHeight: 1.3, color: col('pale'), align: 'left',
placement: { ...at('#title', 'below', 0, 3.5), size: { width: mm(104), height: 'auto' } } },
] } };
Le bandeau bleu marine déborde à fond perdu en haut et des deux côtés, et le surtitre et le chapeau viennent d’attributs de la ligne du titre (attributs de titre). minHeight fixe l’endroit où commence la légende, quelques millimètres sous le bandeau.
#4 · Titres courants selon la parité
const head = (id, content, parity, edge, x, extra = {}) => ({
kind: 'text', id, content, parity, pages: 'body', fontFamily: SANS, fontSize: pt(7.5),
fontWeight: 600, letterSpacing: pt(1.1), textTransform: 'uppercase', color: col('muted'),
placement: { anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(13) } }, ...extra });
const folio = { fontWeight: 700, color: col('ink') };
const header = { elements: [
head('verso-folio', '{pageNumber}', 'even', 'top-left', OUTER, folio),
head('verso-title', '{title}', 'even', 'top-left', OUTER + 8),
head('recto-title', '{firstMark.h2}', 'odd', 'top-right', -(OUTER + 8)),
head('recto-folio', '{pageNumber}', 'odd', 'top-right', -OUTER, folio),
] };
const footer = { elements: [head('drop-folio', '{pageNumber}', 'all', 'top', 0,
{ ...folio, pages: 'opener', placement: at('container', 'top', 0, 9) })] };
La page paire porte le titre du document et la page impaire la partie où elle s’ouvre, lue dans le premier titre de deuxième niveau de la page. pages: 'body' les tient à l’écart de l’ouverture, qui porte un folio en pied de page.
La recette complète
// ═══ Postext Cookbook · Nº 182 · An amendment shown struck through and underlined ═════
// https://postext.dev/en/cookbook/amendment-redline
// Code: MIT · Text: Pub. L. 105-298 and 17 U.S.C. (US Gov., PD); Constitución Española (BOE)
// Fonts: Source Serif 4, Source Sans 3 (SIL OFL 1.1) · Needs postext ≥ 1.73.0
// A comparative print: the law as it stood, each deletion ~~struck through~~ and each
// insertion :underline[underlined], then the amended text in a box whose clauses hang.
import { buildDocumentWithFonts, renderPageToCanvas } from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'amendment-redline';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: a government-print navy, one red for rules and labels
const palette = {
ink: '#1b1d22', // text: a cool near-black
band: '#1f2b47', // the opener's band: navy
accent: '#a1321f', // labels, stripes, the legend's rule
tint: '#eef0f4', // the box of the amended text
rule: '#c7ccd6', // hairlines
muted: '#5d6370', // running heads, notes, colophon
paper: '#ffffff',
pale: '#c9d2e6', // the kicker and the standfirst on the band
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = [
...Object.entries(palette).map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } })),
{ id: 'main-color', name: 'accent (defaults)', value: { hex: palette.accent, model: 'hex' } },
];
// #endregion
const SERIF = 'Source Serif 4', SANS = 'Source Sans 3';
const TRIM = [152, 229], INNER = 20, OUTER = 17; // mm: a 6 × 9 in committee print
const LEAD = 14; // pt: the body leading
const HANG = mm(7); // how far the clauses of a box hang: the width of "(a)" and a space
// #region answer: the marks live in the Markdown; the boxes hang their clauses
// In the text, ~~fifty~~ strikes a deleted word and :underline[70] underlines the new one.
// Both lines are painted from the face's own metrics and take no room, so the struck and
// the inserted words justify and hyphenate like any others. The amended text then sits in
// a box whose paragraphs hang: '(a)', a tab, and every turnover line under the text.
const label = { fontFamily: SANS, fontSize: pt(7.5), fontWeight: 700, letterSpacing: pt(1.1),
textTransform: 'uppercase', color: col('accent') };
const clauses = { fontFamily: SERIF, fontSize: pt(9.5), lineHeight: pt(13), color: col('ink'),
boldColor: col('ink'), italicColor: col('ink'), textAlign: 'left', // a box's measure is short
hangingIndent: HANG, // every line but the first starts 7 mm in (postext ≥ 1.71)
tabStops: [{ position: HANG }] }; // and the tab after the marker takes the text there
const pad = (v, h) => ({ top: mm(v), right: mm(h), bottom: mm(v), left: mm(h) });
const calloutStyles = [
Le script.js composé s’exécute tel quel : collez-le dans le script de module de n’importe quelle page, ou ouvrez la recette sur CodePen. Dossier de la recette sur GitHub ↗ (s’ouvre dans un nouvel onglet)
Variantes
#Écrire les ajouts en ++texte++
Avec plusUnderline activé, ++70++ souligne comme :underline[70], la graphie que Pandoc et markdown-it emploient pour le texte inséré.
textAlign: 'justify', firstLineIndent: mm(4.5), indentAfterHeading: false,
+ plusUnderline: true, // ++texte++ souligne ; C++ s'écrit alors C\+\+ dans le texte#Garder entières les clauses de la loi
Sans keepTogether: false, l’encadré passe entier à la page 2 et la page 1 se termine sur la ligne qui l’annonce.
- padding: pad(2.5, 0), body: clauses, keepTogether: false, // it may run on to the next page
+ padding: pad(2.5, 0), body: clauses,Erreurs fréquentes
- Un paragraphe qui commence par un nombre suivi d’un point (
2. Solamente…) est lu comme un élément de liste, et une barre oblique inverse devant le point s’imprime. L’édition espagnole place un gluon de mots (U+2060) entre le chiffre et le point dans le texte courant et, dans l’encadré, écrit la tabulation juste après le point,1.:tab, qu’aucune marque de liste ne reconnaît. - La couleur seule ne survivrait pas à une photocopie, et c’est souvent ainsi que ces documents circulent ; le barré et le souligné se lisent en noir et blanc, et c’est pour cela que les rédacteurs les ont choisis.
Crédits
- Recette
- Ignacio Ferro
- Texte
- Section 102 of the Sonny Bono Copyright Term Extension Act (Pub. L. 105-298, 112 Stat. 2827, 1998) and sections 302–304 of title 17, United States Code, as in force in 1997 · United States Congress · domaine public
- Articles 13.2, 49 and 135 of the Spanish Constitution in their 1978 wording and the reforms of 1992, 2011 and 2024 (official texts, not subject to copyright under art. 13 LPI) · Cortes Generales, Boletín Oficial del Estado · domaine public
- The editor’s notes, the coding legends and the colophons · Ignacio Ferro · CC BY 4.0
- Polices
- Source Serif 4 (SIL OFL 1.1) · Source Sans 3 (SIL OFL 1.1)
Modifier ce texte ↗ (s’ouvre dans un nouvel onglet)Dossier de la recette sur GitHub ↗ (s’ouvre dans un nouvel onglet)


