Gabarit de site web Quarto
🔸 Créer un site web Quarto
Ce modèle propose une base complète pour créer un site web Quarto. Il inclut les fichiers essentiels, un style aux couleurs de l’Université Laval, une navigation cohérente et un support du mode sombre.
Le gabarit se trouve dans le dossier quarto-site-template du dépôt, et peut être utilisé avec :
🔧 Installation du gabarit
quarto use template AurelienNicosiaULaval/site_ressources_SSD/quarto-site-templateCette commande copie les fichiers de base dans un nouveau dossier local.
📂 Contenu du gabarit
| Fichier | Rôle |
|---|---|
_quarto.yml |
Configuration principale du site (titre, thème, barre de navigation) |
index.qmd |
Page d’accueil |
about.qmd |
Page “À propos” du site |
page1.qmd |
Page “page1” du menu (vous pouvez ajoutez plusieurs pages) |
styles.css |
Styles personnalisés ULaval, incluant support du mode sombre |
img/logo-ulaval.png |
Logo utilisé dans la barre de navigation |
docs/ |
Répertoire de sortie pour GitHub Pages (généré automatiquement) |
🔨 Développement local
- Modifiez les fichiers
.qmdselon vos besoins (contenu, titres, sections). - Adaptez le thème et les couleurs via le fichier
styles.css. - Pour générer le site :
quarto render- Pour voir votre site avec rechargement automatique :
quarto preview💾 Publication automatique sur GitHub Pages
- Poussez votre projet sur GitHub.
- Allez dans Settings → Pages de votre dépôt.
- Choisissez Deploy from a branch.
- Branche :
main/ Dossier :/docs - Activez la publication.
À chaque git push, GitHub Pages publiera la dernière version de votre site.
🙋♀️ Besoin d’aide ?
Ce gabarit peut être adapté pour créer : - un site de cours (STT-XXXX) - un site de documentation de projet ou laboratoire - une vitrine pour présenter du matériel pédagogique
N’hésitez pas à ouvrir une issue pour proposer des améliorations.