RayaneKch

!! - Guide du Wiki

4 min read

Guide du Wiki — UMMTO Debate Club

ᴀᴜᴛʜᴏʀ : ʀᴀʏᴀɴᴇᴋᴄʜ

Ce guide documente la procédure pour obtenir l’accès administrateur au wiki du club permettant de le modifier

1. Vue d’ensemble

Le wiki du UMMTO Debate Club est un site statique généré avec Quartz v4 à partir de fichiers locaux .md, hébergé sur Cloudflare Pages, et dont le contenu est géré via un repo GitHub privé.

ComposantOutilURL
ContenuObsidian (fichiers .md)local
DépôtGitHub (privé)https://github.com/ummtodc/wiki
HébergementCloudflare Pageshttps://ummtodc.pages.dev
ThèmeNord (personnalisé)—

Flux de travail résumé :

Obsidian (écriture) → Git (versionnement) → Cloudflare (déploiement automatique)

2. Architecture technique

quartz/
├── content/          ← Les fichiers Markdown (vault Obsidian)
├── quartz/
│   └── styles/
│       └── custom.scss  ← Personnalisation visuelle (thème Nord)
├── quartz.config.ts  ← Configuration principale
└── .github/
    └── workflows/    ← (optionnel si GitHub Pages)

Fichiers importants

  • quartz.config.ts — titre du site, URL de base, plugins activés
  • quartz/styles/custom.scss — couleurs Nord, polices, style des titres
  • content/ — tout le contenu du wiki en Markdown

3. Accéder au wiki

Site public

👉 ummtodc.pages.dev

Dépôt GitHub (privé)

👉 github.com/ummtodc/wiki
Accès réservé aux membres de l’organisation GitHub ummtodc.

Dashboard Cloudflare

👉 dash.cloudflare.com
Se connecter avec le compte RayaneKch, ou switcher vers ce compte depuis le compte to.debate.c@gmail.com

4. Modifier le contenu

Prérequis

  • Avoir Git installé
  • Avoir Node.js installé
  • Avoir accès au repo GitHub ummtodc/wiki

Setup

  • À faire la première fois uniquement

Configurer une clé SSH (première fois)

# Générer la clé
ssh-keygen -t ed25519 -C "to.debate.c@gmail.com"
 
# Afficher la clé publique
cat ~/.ssh/id_ed25519.pub

Copier le résultat et l’ajouter sur GitHub :
Profile → Settings → SSH and GPG keys → New SSH key ou cliquer ici

Tester la connexion :

ssh -T git@github.com
# Réponse attendue : Hi ummtodebateclub! You've successfully authenticated.

Configurer l’identité Git

git config --global user.email "to.debate.c@gmail.com"
git config --global user.name "ummtodebateclub"

Cloner le repo

git clone git@github.com:ummtodc/wiki.git
cd wiki
npm install

Installer quartz

cd wiki
npm install

Modifier le wiki

Modifier un fichier existant

Ouvrir le fichier .md correspondant dans le dossier content/ avec Obsidian ou n’importe quel éditeur Markdown.

Les wikilinks Obsidian [[comme ceci]] sont supportés nativement par Quartz.

Ajouter une nouvelle page

  1. Créer un nouveau fichier .md dans content/
  2. Le nommer de façon claire, ex : 13 - Nouveau Sujet.md
  3. Commencer le fichier avec un titre :
# 13 - Nouveau Sujet
 
Contenu de la page...
  1. Modifier la table des matières

Convention de nommage

  • Les pages principales suivent le format XX - Titre.md (ex: 01 - Cadre Juridique.md). Respecte cette convention pour maintenir l’ordre dans l’explorateur de la sidebar.

Prévisualiser localement

npx quartz build --serve

Ouvrir localhost:8080 pour voir le résultat avant de publier.

Publier les modifications

Une fois tes modifications prêtes et prévisualisées, exécuter :

npx quartz sync --no-pull

Cette commande :

  1. Compile le site
  2. Commit les changements
  3. Push vers GitHub
  4. Déclenche automatiquement un déploiement sur Cloudflare Pages

Le site sera mis à jour en 1 à 2 minutes. Le déploiement peut être suivi dans le dashboard Cloudflare → Workers & Pages → ummtodc → Deployments ou cliquer ici

5. Personnalisation visuelle

Thème

Le wiki utilise le thème Nord adapté depuis Obsidian. Les couleurs sont définies dans quartz/styles/custom.scss.

Palette de couleurs Nord

VariableCouleurUsage
--red#bf616aTitres H1
--orange#d08770Titres H2, H6
--yellow#ebcb8bTitres H3
--green#a3be8cTitres H4
--purple#b48eadTitres H5
--frost0#8fbcbbTags, tableaux
--frost1#88c0d0Code, texte gras

Modifier les couleurs

Éditer les valeurs dans quartz/styles/custom.scss, puis rebuild :

npx quartz build --serve

Modifier la police

Dans quartz.config.ts :

typography: {
  header: "Inter",
  body: "Inter",
  code: "Source Code Pro",
}

6. Gestion des accès

GitHub (contenu)

Pour donner accès au repo GitHub :

  1. Aller sur github.com/ummtodc/wiki
  2. Settings → Collaborators → Add people ou cliquer ici
  3. Rôle recommandé : Write (peut modifier le contenu, ne peut pas supprimer le dépôt)

Cloudflare (déploiement)

Pour donner accès au dashboard Cloudflare :

  1. Aller sur dash.cloudflare.com → compte RayaneKch
  2. Manage Account → Members → Invite Member ou cliquer ici
  3. Rôle recommandé : Cloudflare Pages - Edit

⚠️ Le membre devra switcher vers le compte RayaneKch depuis son propre dashboard pour voir le projet.

7. Dépannage

Le site ne se met pas à jour

  1. Vérifier que le sync s’est bien terminé sans erreur
  2. Aller sur Cloudflare → Deployments et vérifier le statut du dernier déploiement
  3. Si le build a échoué, cliquer sur View details pour voir les logs d’erreur

Prévisualisation locale qui ne fonctionne pas

# Réinstaller les dépendances
npm install
 
# Rebuilder proprement
npx quartz build --serve

Changer l’URL de base

Si l’URL du site change, mettre à jour quartz.config.ts :

baseUrl: "nouvelle-url.pages.dev",

Puis publier :

npx quartz sync --no-pull

Graph View