Github pages

Révision datée du 22 février 2023 à 11:28 par Lvaudor (discussion | contributions) (mise dans les tutos)

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 ("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