Aller au contenu principal
Recette numéro 182

Recettes · Chapitre 2 · Caractères et texte

Une modification, suppressions barrées et ajouts soulignés

Un texte comparé d’une loi sur le droit d’auteur : mots supprimés barrés, mots ajoutés soulignés, puis le texte modifié dans un encadré aux alinéas en sommaire.

Sur cette page
Sortie
Canvas · PDF
Postext
Testé avec Postext 1.73.0
Nécessite ≥ 1.73.0 · postext-pdf ≥ 1.73.0
Licence
Mis à jour le 10 nov. 2026
Code MIT · Texte CC BY 4.0
  • Exemple en anglais : pas encore d’édition française
  • Format 152 × 229 mm
  • 1 colonne
  • Source Serif 4 10/14
  • Source Sans 3
  • 5 pages
  • Niveau
  • Postext 1.73.0
  • Mis en page en 123 ms
  • 138 lignes de code

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

script.js · lignes 37–64dans le code complet
// 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

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

script.js · lignes 68–82dans le code complet
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é

script.js · lignes 86–98dans le code complet
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

Sandbox
// ═══ 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

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)
SandboxPDF