Skip to content

Passage au template 2

Nicolas Riss edited this page Jun 24, 2026 · 13 revisions

Modifier le fichier "ig.ini" à la racine du repo

La ligne ci-dessous doit être présente : template = https://github.com/ansforge/IG-template/

Modifier le fichier "sushi-config.yaml" à la racine du repo

Produire les traductions

Un dossier translations est automatiquement généré à la racine de l'IG. Créez des dossiers pour atteindre le répertoire input/translations/en et ajoutez-y les fichiers .po issus du dossier translations présent à la racine. Vous pouvez également rajouter des fichiers md dans input/translations/en/pagecontent pour traduire vos fichiers en markdown

Cf. exemple d'arborescence ici : https://github.com/ansforge/IG-modele/tree/main/input/translations/en

Note :

  • Il n'est pas possible d'avoir un IG uniquement en français pour l'instant, il faut obligatoirement rajouter l'anglais en deuxième langue. Cf. https://github.com/HL7/ig-template-base2/issues/14
  • Une traduction automatique utilisant l'IA, tout en gardant le français comme langue source, de référence, est en projet d'implémentation dans les workflows.
  • [déconseillé] En cas de blocage, vous pouvez fixer le template ig.ini à https://github.com/ansforge/IG-template/pull/32 pour utiliser l'ancienne version du template. La transition devra être faite à terme car le publisher va interdire l'usage du template 1.

Exemples de PR de migration :

Cf message du publisher :

This content depends on fhir.base.template which is no longer considered secure to use
See Security notification at https://www.fhir.org/guides/security-notices/2026-03-npm-dependencies.html

Problématique connue

Dépendances multi-version (npm alias) — bug publisher

Symptôme : erreur Publishing Content Failed: Name 'hl7.fhir.fr.core' already exists lors du build d'un IG utilisant deux versions d'un même package FHIR via la syntaxe npm alias (ex. v110@npm:hl7.fhir.fr.core: 1.1.0).

Cause : Le template ANS active "multilanguage-format": true dans son config.json, ce qui déclenche la génération de paquets NPM de langue dans le publisher. Cette génération crée une copie interne de l'ImplementationGuide (copyToLanguage()) qui perd le flag anti-doublon (IG_DEP_ALIASED) positionné pour les dépendances aliasées — ce flag est stocké dans des UserData Java qui ne sont pas préservées lors d'un copy().

Versions affectées : Toutes les versions publiées du publisher à ce jour (2.0.29 → 2.2.8).

Fix en attente : Issue ouverte sur HL7/fhir-ig-publisher#1321.

Contournement : Passer "multilanguage-format": false dans le config.json du template ANS. Le paramètre i18n-default-lang continue de fonctionner pour le rendu en français.

Analyse complète : IG-fhir-service-acces-aux-soins#130

Erreur sur la page downloads

image

Le changement d'arborescence de fichiers engendré par le support du multilingue crée cette erreur car les fichiers en téléchargement ne sont pas accessibles au même endroit. Il suffit de rajouter "../[...]" devant les noms des fichiers pour résoudre les pbs. Cf. https://github.com/ansforge/IG-modele/blob/main/input/pagecontent/annexe-downloads.md