Créer GuideBlog : guide pratique de configuration du flux RSS

GuideBlog.md

@@ -0,0 +1,100 @@
+# Guide-Blog
+
+Ce guide explique comment configurer la synchronisation des articles d'un blog académique dans le projet **college-infos**. Cette fonctionnalité est **optionnelle** et **désactivée par défaut** (`BLOG_ENABLED=false`).
+
+Pour une vue d'ensemble des variables disponibles, consultez le tableau complet dans la page [Configuration](Configuration).
+
+---
+
+## WordPress (Blogpeda et blogs académiques)
+
+La plupart des blogs académiques français (Blogpeda Bordeaux, blogs pédagogiques d'autres académies, etc.) utilisent **WordPress** comme CMS. Voici comment trouver l'URL du flux RSS selon la configuration des permaliens :
+
+- **Avec paramètres (pretty permalinks désactivés)** :
+  ```text
+  https://<blog-domain>/<blog-path>/?feed=rss2
+  ```
+
+- **Avec permaliens propres** :
+  ```text
+  https://<blog-domain>/<blog-path>/feed/
+  ```
+  ou
+  ```text
+  https://<blog-domain>/<blog-path>/feed/rss2/
+  ```
+
+**Exemple concret** (valeur par défaut du projet) :
+```text
+https://blogpeda.ac-bordeaux.fr/cjeliote/?feed=rss2
+```
+
+---
+
+## SPIP
+
+SPIP est un CMS largement utilisé dans les sites académiques. Pour ce type de plateforme, les URLs de flux RSS sont généralement les suivantes :
+
+```text
+https://<site-domain>/spip.php?page=backend
+```
+ou
+```text
+https://<site-domain>/backend.xml
+```
+
+---
+
+## Dotclear
+
+Dotclear est un autre CMS de blogging utilisé dans l'éducation. Les URLs des flux RSS pour Dotclear sont :
+
+- **Flux Atom** :
+  ```text
+  https://<blog-domain>/feed/atom
+  ```
+
+- **Flux RSS 2.0** :
+  ```text
+  https://<blog-domain>/feed/rss2
+  ```
+
+---
+
+## Vérifier l'URL du flux RSS
+
+Si vous ne connaissez pas le CMS utilisé ou si vous souhaitez confirmer l'URL du flux RSS, voici une méthode universelle :
+
+1. Ouvrez la page du blog dans votre navigateur.
+2. Affichez le code source de la page (**Ctrl+U** ou clic droit → « Code source »).
+3. Cherchez la ligne contenant :
+   ```html
+   <link rel="alternate" type="application/rss+xml" href="...">
+   ```
+   L'attribut `href` contient l'URL du flux RSS.
+
+4. **Alternative** : De nombreux navigateurs affichent une icône RSS dans la barre d'adresse lorsqu'un flux est détecté. Cliquez sur cette icône pour accéder directement au flux.
+
+---
+
+## Exemple de configuration
+
+Voici comment configurer la synchronisation du blog dans votre fichier `.env` :
+
+### Blog activé
+```ini
+# Blog activé
+BLOG_ENABLED=true
+BLOG_RSS_URL=https://blogpeda.ac-bordeaux.fr/cjeliote/?feed=rss2
+```
+
+### Blog désactivé (par défaut)
+```ini
+# Blog désactivé (par défaut)
+BLOG_ENABLED=false
+# BLOG_RSS_URL conserve sa valeur par défaut
+```
+
+---
+
+→ [Configuration](Configuration) — tableau des variables