Traitement de la micro typographie française dans les pages générées par Hugo
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Aris 3ce41c20e0 Credit pour Jekyll Microtypo + @ fautif 2 months ago
README.md Credit pour Jekyll Microtypo + @ fautif 2 months ago
micro-typo.html Premier commit (on dit comment en français ?) 2 months ago

README.md

Hugo Micro-typographie

Modèle de page inclus (partial) pour un traitement automatisé de la micro typographie française dans les pages générées par Hugo.

Corrections

Les espaces typographiques :

  • Insécable ou fine insécable devant les signes de ponctuation qui le nécessitent (:,;,?,!).
  • Fine insécable pour les guillemets français (« et »), mais pas pour les guillemets anglais ( et ).
  • Insécable entre le montant et les symbole de monnaies (, $, £).
  • Insécable ou fine insécable entre des chiffres et certaines unités (km, % par exemple).

Les caractères typographiques :

  • Le caractère caractère x est remplacé par un signe × (&time;) dans les multiplications.
  • Le signe degré (°) est remplacé par un o en exposant (par exemple no3).
  • Les ordinnaux (1er, 2e, 3ème, etc.) sont remplacés par 1er, 2e ou 3ème.

Ne sont par contre pas traités :

  1. Les doubles quotes (") à remplacer par des guillemets à la française (« et »).
  2. Les simples quotes (') à remplacer par une apostrophe typographique ().
  3. L’ajout d’une espace insécable après (ou avant, suivant les cas) un tiret long ou moyen.
  4. Le remplacement des ponctuations spéciales (?!, !?, !!) par le signe approprié (⁈, ⁉, ‼).
  5. Les trois points consécutifs (...) à remplacer par une véritable éllipse typographique ().
  6. La génération de caractères spéciaux comme ©, ®, ™ ou ℗ en utilisant une lettre entourée de parenthèses.

Remarque : une bonne partie des éléments ci-dessus (apostrophes, élipses, etc.) sont en fait corrigés par défaut par les fonctions typographiques intégrées de Goldmark, le parseur Markdown de Hugo.

Installation

Il suffit de copier le fichier micro-typo.html dans le sous-répertoire partials/ du répertoire layouts/ qui est à la racine de votre site Hugo. Si nécessaire créer ces deux dossiers.

Dans une version ultérieure il devrait peut-être être possible de l’installer directement comme module. Je ne suis par ailleurs pas vraiment certains que cela apporte quelque chose.

Usage

Dans les modèles de pages Hugo (templates) où l’on souhaite appliquer la correction de la micro typographie française, il faut remplacer l’appel {{ . }} par une inclusion de notre fichier :

{{ partial "micro-typo" .Content }}

Le traitement de la micro typographie peut en fait s’appliquer à n’importe quel contenu de notre page. Par exemple, pour corriger aussi le titre, il suffit de remplacer l’appel {{ .Title }} par :

{{ partial "micro-typo" .Title }}

Crédits

L’essentiel du code utilisé ici est repris depuis le module Hugo Microtypo développé par Jean-Yves Gastaud (@jygastaud) et Frank Taillandier (@DirtyF), qui s’inspire lui-même du plugin Jekyll Microtypo par Boris Schapira (@borisschapira).

Ce que j’ai modifié :

  • Modification du nom du partial : micro-typo plutôt que content qui me semble préter à confusion.
  • Ajout du traitement des guillemets français par un rechercher/remplacer, pas très élégant mais fonctionnel.
  • Commentaires dans le code en français... puisque c’est de micro typographie française dont il est question.

Licence

Rien ;-)