Publier ailleurs que sur Host

Le résultat : une doc servie par un autre hébergeur, avec son assistant.

Avant de commencer : une doc qui se construit, un hébergeur qui sert des fichiers statiques sur une adresse https:// publique, et un compte HGDC avec le rôle admin dans l’organisation.

Le site construit par hgdc-docs build est un dossier statique. Tu le déposes où tu veux. Seule la console a besoin de lire deux choses sur ton site : la page d’accueil et /_hgdc/corpus.json.

1. Construire le site

   Lance le build depuis le dossier de la doc :

   npm run build

   Le site est écrit dans dist/, et _hgdc/corpus.json s’y trouve aussi.

2. Le publier

   Dépose le contenu du dossier du site chez ton hébergeur, sur l’adresse que tu veux. Si la doc est servie sous un chemin (par exemple /docs), écris ce chemin dans docs.json avec base avant de construire : le site est alors écrit dans dist/docs/, et c’est ce dossier qu’il faut déposer.

3. Créer le projet dans la console

   Sur https://docs.hgdc.ch, ouvre ton organisation, puis Nouveau projet. Donne le nom, et l’adresse publique du site.

4. Relier le projet

   La console affiche une ligne à copier. Ajoute-la à docs.json, puis reconstruis et republie le site. Le site doit porter l’identifiant de son projet.

5. Synchroniser

   Clique sur Synchroniser dans l’aperçu du projet. Quand l’état passe à À jour, l’assistant répond.

Si ça ne marche pas

• Aucun corpus sur … /_hgdc/corpus.json : le fichier n’est pas à cet endroit sur ton hébergeur. Vérifie le sous-chemin, et que le fichier est bien publié.
• Le docs.json publié n'a pas de champ « project » : tu as republié sans l’identifiant. Ajoute-le, puis republie.
• Le docs.json publié porte l'identifiant d'un autre projet : l’identifiant de docs.json ne correspond pas à ce projet. Recopie celui de la console.

Le message complet et sa solution sont dans Erreurs de synchronisation.