update dev_nouvel_ig

Author: nriss

input/pagecontent/dev_nouvel_ig.md

@@ -1,14 +1,8 @@
-### Mise en place du repo GitHub
+### Création d'un nouveau projet
 
-Prérequis : suivre la [documentation](https://ansforge.github.io/Documentation) pour créer un compte GitHub et l'associer à l'organisation ANS.
+Dans le cas de la création d'un nouveau projet , il faut créer un répertoire GitHub ([cf documentation](./github.html)) en utilisant le template ansforge/IG-modele et paramétrer l'IG.
 
-Ce nouveau projet doit utiliser le GitHub template ansforge/IG-modele et doit respecter la convention de nommage indiquée dans la [documentation de création des 
-répetoires GitHub](https://ansforge.github.io/Documentation/pages/docs/creationprojet.html) tout en étant préfixé par "IG-..." (Exemple : IG-fhir-partage-de-documents-de-sante). 
-En cas de doute, l'équipe interopérabilité de l'ANS se tient disponible pour avis. 
-
-Une fois l'IG créé, il est nécessaire de le personnaliser pour le projet dédié.
-
-### Paramétrage de l'IG
+#### Paramétrage de l'IG
 
 Lors de la création d'un IG, il y a une première phase de paramétrage à effectuer. Il faut remplir:
 
@@ -23,14 +17,14 @@ Lors de la création d'un IG, il y a une première phase de paramétrage à effe
 
 Il faudra également mettre à jour le fichier readme.md à la racine du repository.
 
-### Paramétrage du menu de navigation de l'IG
+##### Paramétrage du menu de navigation de l'IG
 
 Une des plus importantes parties de l'IG est la documentation narrative, celle-ci est écrite en [kramdown](https://kramdown.gettalong.org/).
 Ces pages sont à ajouter dans input/pagecontent avec l'extension .md. A noter que ces pages doivent être directement contenues dans le dossier pagecontent et ne peuvent pas avoir d'arborescence de dossiers.
 
 Une fois une page créée et rédigée, pour l'ajouter au menu, il faut éditer le fichier sushi-config.yaml. Celui-ci contient deux parties : la partie pages et la partie menu
 
-#### La partie pages
+###### La partie pages
 
 La partie pages est optionnelle, mais elle permet de donner un titre aux pages (par défaut, c'est le nom du fichier qui est utilisé). A noter, il faut utiliser l'extension .md ici.
 
@@ -46,7 +40,7 @@ pages:
             title: Ajout d'un lot de documents
 ```
 
-#### La partie menu
+###### La partie menu
 
 La partie menu permet de définir le menu de navigation dans le header. A noter, il faut utiliser l'extension .html.
 
@@ -62,23 +56,23 @@ menu:
   Spécifications fonctionnelles:
 ```
 
-### Développement de l'IG
-
-Le développement de l'IG se fait essentiellement dans le dossier [input](https://build.fhir.org/ig/FHIR/ig-guidance/using-templates.html#igroot-input).
-
 Lien vers quelques exemples :
 [https://github.com/HL7/US-Core/blob/master/sushi-config.yaml]
 [https://github.com/ansforge/FIG_ans-ig-PDSm/blob/main/sushi-config.yaml]
 
+### Développement de l'IG
+
+Le développement de l'IG se fait essentiellement dans le dossier [input](https://build.fhir.org/ig/FHIR/ig-guidance/using-templates.html#igroot-input). Celui-ci contient les pages kramdown ainsi que les artéfacts FHIR (profils, exemples, terminologies, ...)
+
 ### Installer les dépendances
 
-### Windows
+#### Windows
 
 Prérequis :
 
 * Avoir les droits administrateur
 
-#### Etape 1. Installer VS CODE et les plugins
+##### Etape 1. Installer VS CODE et les plugins
 
 https://code.visualstudio.com/
 
@@ -91,24 +85,24 @@ https://code.visualstudio.com/
 1. Lancer VS Code
 2. Aller dans le menu extension (les 4 carrés dont un qui se décolle à gauche), chercher et installer "FHIR Shorthand"
 
-#### Etape 2. Installer NodeJS
+##### Etape 2. Installer NodeJS
 
 [https://nodejs.org/en/]
 
 La case "Automatically install the necessary tools" peut être cochée.
 
-#### Etape 3. Installer SUSHI
+##### Etape 3. Installer SUSHI
 
 1. Lancer l'invite de commande (windows > "invite de commande")
 2. Ecrire et lancer la commande `npm install -g fsh-sushi`
 
-#### Etape 4. Installer les dépendances de l'IG Publisher
+##### Etape 4. Installer les dépendances de l'IG Publisher
 
 * JAVA JDK: https://www.oracle.com/fr/java/technologies/downloads/#jdk19-windows (installer, au format .exe)
 * Ruby: https://rubyinstaller.org/downloads (with devkit). Installer le "MSYS2 base installation".
 * Jekyll et bundler: lancer l'invite de commande en mode administrateur et lancer la commande `gem install jekyll bundler`
 
-#### Etape 5. Lancer l'IG Publisher
+##### Etape 5. Lancer l'IG Publisher
 
 Télécharger le repository [ansforge/FIG_ans-ig-sample](https://github.com/ansforge/FIG_ans-ig-sample) : code > download zip.
 Décompresser le dossier, et le mettre dans un chemin où il n'y a pas d'espace (exemple : C:\Users\nriss\Documents).
@@ -125,11 +119,11 @@ Vous pouvez maintenant commencer à développer votre implementation guide ! :)
 * Documentation vers FSH : https://build.fhir.org/ig/HL7/fhir-shorthand/reference.html
 * Documentation sur l'IG Publisher : https://confluence.hl7.org/pages/viewpage.action?pageId=35718627#IGPublisherDocumentation-QuickStart
 
-### MAC / Linux
+#### MAC / Linux
 
-#### Prérequis : NodeJS, Java, Ruby et Jekyll
+##### Prérequis : NodeJS, Java, Ruby et Jekyll
 
-##### NodeJS
+###### NodeJS
 
 Pour installer [NodeJS](https://nodejs.org/), vous pouvez suivre la documentation d'installation officielle.
 
@@ -141,7 +135,7 @@ sudo apt install nodejs
 
 Il est aussi possible de l'installer via [`nvm` (Node Version Manager)](https://github.com/nvm-sh/nvm), qui vous permettra de changer de version de NodeJS en fonction des requis de vos projets.
 
-##### Java
+###### Java
 
 Pour installer Java, vous pouvez vous tourner vers le [JDK officiel sur la page d'Oracle](https://www.oracle.com/fr/java/technologies/downloads/). Vous y trouverez un `.deb` ou un `.rpm` à installer facilement sur votre distribution.
 Vous pouvez aussi utiliser [`openjdk`](https://openjdk.org/) pour une implémentation open-source de la plateforme Java.
@@ -150,7 +144,7 @@ Vous pouvez aussi utiliser [`openjdk`](https://openjdk.org/) pour une implément
 sudo apt install openjdk-17-jre
 ```
 
-##### Ruby et Jekyll
+###### Ruby et Jekyll
 
 Pour installer Ruby sur une distribution Linux basée sur Debian, vous pouvez le faire via votre package-manager :
 
@@ -174,7 +168,7 @@ Vous trouverez davantage d'informations sur le [confluence d'hl7](https://conflu
 
 Des difficultés pour installer ruby et jekyll peuvent survenir sur mac M1, M2 : lancer le [terminal avec rosetta](https://apple.stackexchange.com/questions/428768/on-apple-m1-with-rosetta-how-to-open-entire-terminal-iterm-in-x86-64-architec) et suivre [cette procédure](https://github.com/jekyll/jekyll/issues/8576#issuecomment-798080994) permet de régler les problèmes.
 
-#### Installer SUSHI
+##### Installer SUSHI
 
 Sushi permet de convertir la [grammaire FSH](https://build.fhir.org/ig/HL7/fhir-shorthand/) 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.
@@ -185,7 +179,7 @@ npm install -g fsh-sushi
 
 Pour information, [GoFSH](https://github.com/FHIR/GoFSH) permet de faire la transformation inverse : transformer une StructureDefinition au format FSH.
 
-#### Générer l'IG
+##### Générer l'IG
 
 ```bash
 bash _updatePublisher.sh # Mise à jour du publisher java

input/pagecontent/index.md

@@ -44,33 +44,3 @@ Un lien est également disponible sous chaque guide d'implémentation pour accé
 <img width="100%" alt="image" src="new_issue.png">
 
 L'issue doit contenir un titre, et une description la plus détaillée possible avec idéalement une proposition de changement pour faciliter et améliorer la qualité des modifications apportées.
-
-### Les outils utilisés dans ce guide
-
-#### FSH
-
-FSH est la grammaire de définition des ressources FHIR (instance, StructureDefinition, SearchParameter, CapabilityStatement, ImplementationGuide, ...)
-
-#### SUSHI
-
-Sushi est le logiciel permettant de générer les ressources au format json ou xml à partir de la grammaire FSH.
-Il est disponible en ligne sur [le site FSHSchool](https://fshschool.org/) ou en [invite de commande](https://www.npmjs.com/package/fsh-sushi)
-
-Par défaut, sushi ne génère que les differential. Pour générer les snapshots, il faut utiliser l'option `sushi -s .`
-
-#### GOFSH
-
-GoFSH permet de faire la transformation inverse StructureDefinition --> FSH. Il permet de faciliter la prise en main et la conversion d'anciens projets json dans la syntaxe FSH.
-De la même manière qu'FSH, GoFSH est également disponible en ligne sur [le site FSHSchool](https://fshschool.org/) ou en [invite de commande](https://www.npmjs.com/package/gofsh)
-
-Par défaut, GoFSH ne traite que les fichiers json. Il va falloir rajouter l'option `goFSH -t json-and-xml .` pour traiter les deux.
-
-A noter, la fonction fshing-trip lancée avec la commande `gofsh --fshing-trip` permet de lancer goFSH puis sushi et de générer une comparaison entre le json initial et le json généré avec sushi visualisable sous la forme d'une page html.
-
-#### IG Publisher
-
-L'IG publisher est l'outil permettant de générer les pages web de l'implementation guide (usage de jekyll, java, ...).
-Il prend en entrée une arborescence de dossiers / fichiers bien définis, contenant : des pages en markdown, des fichiers fsh, des ressources FHIR au format json ou xml, des images...
-
-Vous pouvez vous référer à [la documentation officielle de l'IG publisher](https://confluence.hl7.org/display/FHIR/IG+Publisher+Documentation).
-