Documentation

Mes notes, procédures et références — personnelles & pro.

✦ docs.rlacube.com MkDocs Material Cloudflare Pages Zero Trust

📝

Markdown pur

Chaque page est un fichier .md. Pas d'interface, pas de CMS — juste un éditeur.

⚡

Déploiement auto

Un git push suffit. Le pipeline CI/CD build et déploie en ~1 min.

🔒

Accès contrôlé

Cloudflare Access protège le site. Seules les adresses email autorisées y ont accès.

📐

Schémas partout

Tous les concepts complexes sont illustrés via Mermaid — style manuscrit.

---

Architecture du système

graph LR
    A[📝 Éditeur\nMarkdown] -->|git push| B[GitLab\nromain.lacube/docs]
    B -->|CI pipeline| C[mkdocs build]
    C -->|wrangler deploy| D[Cloudflare Pages\nrlacube-docs]
    D -->|CNAME proxied| E[docs.rlacube.com]
    E --> F{Cloudflare\nAccess}
    F -->|✅ Email autorisé| G[Documentation]
    F -->|❌ Inconnu| H[Accès refusé]

    style A fill:#f0f9ff,stroke:#0ea5e9
    style G fill:#f0fdf4,stroke:#22c55e
    style H fill:#fff1f2,stroke:#f43f5e
    style F fill:#fefce8,stroke:#eab308

Démarrage rapide

cd ~/documents/docs
# Crée ta page
echo "# Ma page" > docs/ma-section/ma-page.md
# Déclare-la dans mkdocs.yml sous nav:
# Déploie
git add . && git commit -m "doc: ma page" && git push

Ajouter une section

Crée un dossier dans docs/, ajoute tes fichiers .md, puis déclare-les dans mkdocs.yml sous nav:. MkDocs rebuild automatiquement le site à chaque push.