Ceci est exemple d'ImplementationGuide très simplifié qui servira de template pour les prochains développement d'IGs. Pour créer un nouvel IG, il suffit de forker ce document et de mettre à jour :
- sushi-config.yaml
- ig.ini
- input/fsh pour indiquer vos instances, profils, extensions, exemples...
- pagecontent pour créer la documentation en markdown.
Après avoir créé les profil et mis à jour sushi-config, voici la démarche à suivre pour générer l'IG en html.
Sushi permet de convertir la grammaire FSH pour générer des profils, extensions (StructureDefinition) et des exemples / instances FHIR. La prise en main est relativement facile lorsque l'on connaît bien FHIR. Sushi est développé en javascript sous forme de module npm.
npm install -g fsh-sushi
Pour information, GoFSH permet de faire la transformation inverse : transformer une StructureDefinition au format FSH.
Une fois ses outils installés, il faut installer les dépendances de l'IG publisher : Installation de java, ruby et jekyll.
brew install ruby (sur mac)
gem install bundler jekyll
Vous trouverez davantage d'informations sur le confluence d'hl7
Des difficultés pour installer ruby et jekyll peuvent survenir sur mac M1, M2: lancer le terminal avec rosetta et suivre cette procédure permet de régler les problèmes.
bash _updatePublisher.sh // Mise à jour du publisher java
bash _genonce.sh // Génère l'IG
Nicolas Riss nicolas.riss@esante.gouv.fr