Votre site de cours, à partir d’un gabarit.
Une base courte pour rassembler les consignes, les supports et les ressources.
Pour quoi ? Créer une porte d’entrée pour un cours ou un projet pédagogique.
Prérequis : Quarto. Le gabarit fourni ne nécessite pas R.
Livrable : un site HTML avec trois pages et une navigation.
Télécharger et ouvrir
Télécharger le gabarit de site (.zip)
Décompressez l’archive. Ouvrez le dossier site-cours-quarto dans votre éditeur. Les fichiers proviennent du dossier quarto-site-template/skeleton de ce dépôt.
Personnaliser trois éléments
- Dans
_quarto.yml, remplacez le titre du site et les libellés du menu. - Dans
index.qmd, indiquez par où commencer et ce qui est attendu. - Adaptez
page1.qmdetabout.qmdaux ressources et aux informations de votre cours.
| Fichier | Rôle |
|---|---|
_quarto.yml |
Titre, navigation et options de rendu |
index.qmd |
Point de départ des étudiants |
page1.qmd |
Exemple de page de ressources |
about.qmd |
Informations sur le cours |
styles.css |
Mise en page |
docs/ |
Site généré après le rendu |
Le gabarit ne contient pas de logo institutionnel. Ajoutez uniquement les images que vous êtes autorisé à utiliser.
Prévisualiser et produire le site
Dans le terminal, depuis le dossier décompressé :
quarto previewPour produire toutes les pages :
quarto renderOuvrez ensuite docs/index.html. Testez les liens et la navigation sur téléphone.
Publier sur GitHub Pages
Pour une publication depuis la branche principale :
- Créez un dépôt GitHub et ajoutez les sources ainsi que le dossier
docsgénéré. - Dans « Settings », puis « Pages », choisissez « Deploy from a branch ».
- Sélectionnez la branche
mainet le dossier/docs. - Après chaque modification, refaites
quarto renderet envoyez aussi les fichiers produits dansdocs.
Un envoi des seuls fichiers .qmd ne reconstruit pas le site dans ce mode. La compilation automatique nécessite un workflow distinct. Consultez la documentation officielle de Quarto pour GitHub Pages.
Avant de donner le lien aux étudiants
Vérifiez l’URL publiée dans un navigateur. Les supports publics peuvent être diffusés sur le site ; les remises, les notes individuelles et les corrigés réservés doivent rester dans un espace privé.