CEC → GNU Info

Convertit le Catéchisme de l'Église catholique publié par le Vatican (IntraText, version française) en manuel GNU Texinfo / Info, PDF et EPUB 3. La sortie Info est directement lisible dans Emacs.

Dépendances (Debian)

sudo apt install python3-bs4 texinfo

pandoc n'est pas nécessaire.

La génération PDF demande également une installation TeX fournissant texi2dvi et un convertisseur DVI vers PDF (par exemple texlive sur Debian).

Le projet peut aussi être installé dans un environnement Python :

python3 -m venv .venv
. .venv/bin/activate
python -m pip install -e .
cec2info --help

Utilisation

make

Le script crée :

• .cec-cache/ : cache local des pages HTML ;
• catechisme.texi : source Texinfo ;
• catechisme.info : manuel GNU Info ;
• catechisme.pdf : version PDF ;
• catechisme.epub : livre EPUB 3 ;
• generation-report.json : rapport de génération exploitable par un outil.

Pour ne produire qu'un format :

make info
make pdf
make epub

Les tests locaux se lancent avec make test.

La génération vérifie que les paragraphes 1 à 2865 sont tous présents une seule fois avant de compiler les formats finaux. Les pages IntraText absentes du sommaire sont récupérées automatiquement grâce aux liens Suivant. Pour un autre corpus, adaptez la borne avec --expected-last-paragraph, ou utilisez la valeur 0 pour désactiver ce contrôle.

Un rapport lisible est toujours affiché à la fin. Pour demander explicitement un rapport JSON avec la commande installée :

cec2info --compile --pdf --epub --report-json generation-report.json

Le JSON contient la source, le nombre d'entrées, les pages liées et orphelines, la couverture des paragraphes, ainsi que le chemin et la taille de chaque sortie.

Pour forcer un nouveau téléchargement :

make refresh

make clean retire les sorties et auxiliaires de compilation ; make distclean retire aussi le cache HTML et les caches Python.

Intégration continue

Le workflow GitHub Actions .github/workflows/ci.yml teste Python 3.10 et 3.13. Il installe le paquet, vérifie la commande cec2info, exécute les tests Info/PDF/EPUB et construit une wheel sans télécharger le corpus du Vatican.

Publication

Un tag vX.Y.Z correspondant à la version de pyproject.toml déclenche les tests, construit le wheel et le paquet source, puis publie une GitHub Release.

La publication PyPI utilise Trusted Publishing (OIDC), sans secret permanent. Le publisher PyPI doit cibler le propriétaire fmaillar, le dépôt cec-info, le workflow release.yml et l'environnement GitHub pypi. La variable de dépôt PYPI_PUBLISH active cette étape lorsqu'elle vaut true.

Lecture dans Emacs

(info "/chemin/vers/catechisme.info")

Installation dans le répertoire Info utilisateur

mkdir -p ~/.local/share/info
cp catechisme.info ~/.local/share/info/
install-info ~/.local/share/info/catechisme.info ~/.local/share/info/dir

Puis, si ce répertoire n'est pas déjà connu d'Emacs :

(add-to-list 'Info-default-directory-list
             (expand-file-name "~/.local/share/info/"))

Ensuite : M-x info, puis m Catéchisme.

Navigation

• n, p, u : suivant, précédent, parent ;
• m : sélectionner une entrée du menu ;
• i RET 2270 RET : aller à l'entrée d'index du § 2270 ;
• s RET eucharistie RET : recherche plein texte.

Le script utilise automatiquement les pages __P*.HTM du système IntraText : ce sont les variantes de lecture sans les milliers de liens de concordance.

Licence et droits sur le texte

Le convertisseur est distribué sous la licence GNU GPL version 3 ou toute version ultérieure. Consultez le fichier LICENSE.

Cette licence ne couvre pas le texte du Catéchisme. Le projet ne distribue que le convertisseur ; le texte est téléchargé depuis le site officiel du Vatican au moment de la génération et reste soumis aux droits indiqués par son éditeur.