YAMLResume arrive sur Homebrew

YAMLResume vient d'être accepté par Homebrew, le gestionnaire de paquets le plus populaire sur macOS. Cela signifie que les utilisateurs macOS peuvent désormais installer et garder YAMLResume à jour avec une seule commande fiable—sans installation globale manuelle de Node.js, sans gymnastique de chemins. Cet article présente une configuration pas à pas plus détaillée de YAMLResume avec Homebrew et un moteur de composition pour une sortie PDF optimale.

Pourquoi c'est important

Auparavant, le chemin typique pour obtenir le CLI YAMLResume sur macOS était :

1. installer Node.js,
2. installer le CLI yamlresume via un gestionnaire de paquets Node.js (npm/pnpm/yarn/bun)
3. installer un moteur de composition afin de générer le PDF

Une formule Homebrew peut fusionner les étapes 1 et 2, puisque Homebrew gère pour vous la dépendance Node.js. Cela réduit les dérives d'environnement et simplifie les mises à jour (brew upgrade yamlresume).

Installation rapide

brew install yamlresume

Homebrew installera Node.js comme dépendance si vous ne l'avez pas encore.

Puis vérifiez :

$ yamlresume help
Usage: yamlresume [options] [command]

YAMLResume — Resume as Code in YAML

 __   __ _    __  __ _     ____
 \ \ / // \  |  \/  | |   |  _ \ ___  ___ _   _ ___  ___   ___
  \ V // _ \ | |\/| | |   | |_) / _ \/ __| | | / _ \/ _ \ / _ \
   | |/ ___ \| |  | | |___|  _ <  __/\__ \ |_| | | | | | |  __/
   |_/_/   \_\_|  |_|_____|_| \_\___||___/\____|_| |_| |_|\___|


Options:
  -V, --version                  output the version number
  -v, --verbose                  verbose output
  -h, --help                     display help for command

Commands:
  new [filename]                 create a new resume
  build [options] <resume-path>  build a resume to LaTeX and PDF
  dev [options] <resume-path>    build a resume on file changes (watch mode)
  languages                      i18n and l10n support
  templates                      manage resume templates
  validate <resume-path>         validate a resume against the YAMLResume schema
  help [command]                 display help for command

Si vous voyez l'aide, le binaire du CLI est disponible dans votre PATH.

YAMLResume dépend d'un moteur de composition pour générer le PDF ; vous pouvez installer MacTeX ou Tectonic via Homebrew.

Option A : TeX Live complet (XeTeX)

Installation via le cask MacTeX (inclut XeTeX) :

# install the full mactex
brew install mactex
# or if you want to save some disk space
brew install mactex-no-gui

Après installation, assurez-vous que les binaires TeX sont dans le PATH (Homebrew crée généralement des liens symboliques sous /Library/TeX/texbin). Test :

$ xelatex --version
XeTeX 3.141592653-2.6-0.999994 (TeX Live 2022)
kpathsea version 6.3.4
Copyright 2022 SIL International, Jonathan Kew and Khaled Hosny.
There is NO warranty.  Redistribution of this software is
covered by the terms of both the XeTeX copyright and
the Lesser GNU General Public License.
For more information about these matters, see the file
named COPYING and the XeTeX source.
Primary author of XeTeX: Jonathan Kew.
Compiled with ICU version 70.1; using 70.1
Compiled with zlib version 1.2.11; using 1.2.11
Compiled with FreeType2 version 2.11.1; using 2.11.1
Compiled with Graphite2 version 1.3.14; using 1.3.14
Compiled with HarfBuzz version 3.4.0; using 3.4.0
Compiled with libpng version 1.6.37; using 1.6.37
Compiled with pplib version v2.05 less toxic i hope
Using Mac OS X Core Text and Cocoa frameworks

Option B : Tectonic (léger)

$ brew install tectonic
$ tectonic --version

Quel moteur choisir ?

En cas de problèmes LaTeX inexpliqués ou de gestion avancée de polices, revenez à XeTeX.

Créer et construire un CV

Créez un CV YAML de départ :

$ yamlresume new my-resume.yml
✔ Created my-resume.yml successfully.

Modifiez my-resume.yml puis construisez le PDF :

$ yamlresume build my-resume.yml
◐ Generating resume PDF with command: xelatex -halt-on-error my-resume.tex...
✔ Generated resume PDF successfully.

Interne :

1. transformation de my-resume.yml en LaTeX (my-resume.tex)
2. invocation du moteur (xelatex ou tectonic)
3. production de my-resume.pdf

Mise à jour

Restez à jour (nouveaux templates, correctifs, améliorations i18n) :

$ brew update
$ brew upgrade yamlresume

Désinstallation

$ brew uninstall yamlresume

Ne supprimez les dépendances optionnelles (polices, moteur TeX, etc.) que si elles ne sont plus nécessaires.

Dépannage

Le mode verbeux aide à diagnostiquer les problèmes de génération :

$ yamlresume build --verbose my-resume.yml

Correctifs courants :

• moteur manquant : installer MacTeX ou utiliser Tectonic.
• permissions d'écriture refusées : vérifier que le répertoire courant est accessible en écriture (éviter les chemins système).
• erreurs LaTeX étranges avec Tectonic : revenir à XeTeX (brew install mactex).

Notes finales

Être inclus dans Homebrew abaisse la barrière d'entrée et signale la maturité du projet. Pour tout cas particulier, ouvrez une issue ou une discussion — nous itérons rapidement. Bon hacking, et que vos CV soient toujours pixel perfect !

Enfin, merci à @chenrui333 pour son premier PR qui a permis l'inclusion de YAMLResume dans Homebrew.