« Github pages » : différence entre les versions

De Wiki ISIG
Aller à la navigation Aller à la recherche
m (mise dans les tutos)
Ligne 15 : Ligne 15 :


* '''depuis RStudio:''' créer un nouveau sous-dossier "docs" dans le dossier correspondant au projet R
* '''depuis RStudio:''' créer un nouveau sous-dossier "docs" dans le dossier correspondant au projet R
* '''depuis RStudio:''' tricoter le .qmd ("render")
* '''depuis RStudio:''' tricoter le .qmd (bouton "render" ou commande `quarto::quarto_render()`)
* '''depuis RStudio:''' commit et push  
* '''depuis RStudio:''' commit et push  
* '''depuis github:''' aller dans ''Settings => Pages'' puis ''Deploy from a branch'' (master a priori). Préciser que les pages se trouvent dans le sous-dossier ''docs''. Puis ''Save''.
* '''depuis github:''' aller dans ''Settings => Pages'' puis ''Deploy from a branch'' (master a priori). Préciser que les pages se trouvent dans le sous-dossier ''docs''. Puis ''Save''.

Version du 17 novembre 2023 à 09:35

Ici je détaille la procédure notamment depuis R/RStudio mais il doit être possible de faire à peu près la même chose depuis Python avec Quarto également...

On peut héberger des pages web sur un repo github en passant par les "Github pages". La production de ces pages est facilitée par l'usage de Quarto via RStudio.

Etapes:

  • depuis github: créer un repo
  • depuis RStudio: créer un repo en local (par exemple à partir du repo distant): le créer comme "projet Quarto" depuis RStudio
  • depuis RStudio: éditer le fichier yaml du projet : `_quarto.yml` pour indiquer:
project:
  type: website
  output-dir: docs
  • depuis RStudio: créer un nouveau sous-dossier "docs" dans le dossier correspondant au projet R
  • depuis RStudio: tricoter le .qmd (bouton "render" ou commande `quarto::quarto_render()`)
  • depuis RStudio: commit et push
  • depuis github: aller dans Settings => Pages puis Deploy from a branch (master a priori). Préciser que les pages se trouvent dans le sous-dossier docs. Puis Save.
  • depuis github: le déploiement du site est documenté dans l'onglet Actions. Le lien vers le site y sera indiqué une fois le déploiement réalisé.


Le lien vers les pages correspond à qqch du genre:

https://{username}.github.io/{repo}/{docname}.html