Problème sur la génération des pages HTML
Re, Je n'arrive pas a voir les fichiers HTML mis à jour en suivant :
Pour reconstruire la documentation en local et mettre à jour les htmls :
- installer les requirements -- plus d'infos sur Sphinx
pip install sphinx sphinx_rtd_theme recommonmark
-
make html
pour faire l'export html -
git add _build
pour prendre en compte les fichiers exportés -
git commit -m "build: mise à jour"
pour valider et documenter l'export -
git push
pour envoyer vers le serveur (gitlab)
J'ai :
spouyllau@cchum-kvm-legarage:~/HN/documentation$ make html
Sphinx v3.4.3 en cours d'exécution
Chargement des traductions [fr]... fait
WARNING: l'entrée html_static_path '_static' n'existe pas
chargement de l'environnement pickled... fait
construction en cours [mo]:cibles pour les fichiers po 0 qui sont périmées
construction [html]:cibles pour les fichiers sources 1 qui sont périmées
mise-à-jour de l'environnement :0 ajouté, 1 modifié, 0 supprimé
/home/spouyllau/.local/lib/python3.8/site-packages/recommonmark/parser.py:75: UserWarning: Container node skipped: type=document
warn("Container node skipped: type={0}".format(mdnode.t))
recherche des fichiers périmés... aucun résultat
environnement de sérialisation... fait
vérification de la cohérence... /home/spouyllau/HN/documentation/README.md: WARNING: Le document n'est inclut dans aucune table des matières de l'arborescence.
fait
document en préparation... fait
écriture... [100%] index
/home/spouyllau/HN/documentation/ISIDORE.md:501: WARNING: None:any référence cible non trouvée : /content/12/54/fr/comment-faire-pour-que-des-donnees-soient-referencees-par-isidore-.html
/home/spouyllau/HN/documentation/ISIDORE.md:503: WARNING: None:any référence cible non trouvée : /content/12/75/fr/comment-signaler-ses-donnees-dans-isidore-avec-des-metadonnees-et-le-protocole-oai_pmh-.html
/home/spouyllau/HN/documentation/ISIDORE.md:: WARNING: Le nom du lexeur Pygments '{.language-markup}' est inconnu
/home/spouyllau/HN/documentation/ISIDORE.md:: WARNING: Le nom du lexeur Pygments '{.language-markup}' est inconnu
/home/spouyllau/HN/documentation/ISIDORE.md:: WARNING: Le nom du lexeur Pygments '{.language-markup}' est inconnu
/home/spouyllau/HN/documentation/ISIDORE.md:: WARNING: Le nom du lexeur Pygments '{.language-markup}' est inconnu
/home/spouyllau/HN/documentation/ISIDORE.md:: WARNING: Le nom du lexeur Pygments '{.language-markup}' est inconnu
/home/spouyllau/HN/documentation/ISIDORE.md:: WARNING: Le nom du lexeur Pygments '{.language-markup}' est inconnu
generating indices... genindex fait
writing additional pages... search fait
copying static files... fait
copying extra files... fait
dumping search index in French (code: fr)... fait
dumping object inventory... fait
build a réussi, 10 warnings.
Les pages HTML sont dans _build/html .
spouyllau@cchum-kvm-legarage:~/HN/documentation$ git add _build
spouyllau@cchum-kvm-legarage:~/HN/documentation$ git commit -m "build: mise à jour"
[master b245cd9] build: mise à jour
5 files changed, 3 insertions(+), 3 deletions(-)
rewrite _build/doctrees/environment.pickle (86%)
spouyllau@cchum-kvm-legarage:~/HN/documentation$ git push
Énumération des objets: 19, fait.
Décompte des objets: 100% (19/19), fait.
Compression par delta en utilisant jusqu'à 4 fils d'exécution
Compression des objets: 100% (10/10), fait.
Écriture des objets: 100% (10/10), 17.86 Kio | 5.95 Mio/s, fait.
Total 10 (delta 7), réutilisés 0 (delta 0)
To gitlab.huma-num.fr:huma-num/documentation.git
0dbe3d1..b245cd9 master -> master
S.