Guide de démarrage rapide

Bienvenue dans la documentation de sansCMS. Ce guide vous aidera à démarrer rapidement avec votre nouveau CMS sans base de données.

💡 Information

Ce guide suppose que vous avez déjà installé sansCMS sur votre serveur. Si ce n'est pas le cas, consultez le guide d'installation.

Qu'est-ce que sansCMS ?

sansCMS est un CMS léger et performant qui utilise des fichiers Markdown au lieu d'une base de données. Cela le rend :

Installation

Prérequis

Avant de commencer, assurez-vous d'avoir :

⚠️ Attention

Le dossier logs/ doit être accessible en écriture pour le cache et les statistiques.

Étapes d'installation

  1. Téléchargez sansCMS depuis le dépôt GitHub
  2. Décompressez l'archive dans votre dossier web
  3. Configurez le fichier config/site.json
  4. Créez votre première page dans pages/
# Exemple de commande
cd /var/www/html
git clone https://github.com/votre-repo/sanscms.git
cd sanscms
chmod -R 755 logs/

Créer votre première page

Créez un fichier 1-home.md dans le dossier pages/ :

---
titre: Ma page d'accueil
permalien: home
description: Bienvenue sur mon site
priver: false
brouillon: false
---

# Bienvenue sur mon site !

Ceci est ma première page avec sansCMS.
✅ Succès

Votre page est maintenant accessible à l'adresse de votre site !

Structure d'un fichier Markdown

Chaque fichier Markdown contient deux parties :

1. Les métadonnées (Front Matter)

Les métadonnées sont définies entre --- au début du fichier :

ChampTypeDescriptionRequis
titrestringTitre de la page✅ Oui
permalienstringURL de la page✅ Oui
descriptionstringMeta description SEO❌ Non
priverbooleanPage protégée par mot de passe❌ Non
brouillonbooleanMasquer la page❌ Non
datedateDate de publication (pour blog)❌ Non
auteurstringAuteur du contenu❌ Non
tagsarrayTags pour catégorisation❌ Non

2. Le contenu

Après les métadonnées, écrivez votre contenu en Markdown :

## Titre de niveau 2

Paragraphe avec du **gras** et de l'*italique*.

- Liste à puces
- Deuxième élément

1. Liste numérotée
2. Deuxième élément

[Lien vers une page](https://example.com)

Configuration

Le fichier config/site.json contient toute la configuration :

{
  "site": {
    "name": "Mon Site",
    "description": "Description de mon site",
    "contact_email": "contact@example.com"
  },
  "theme": {
    "name": "docs",
    "posts_per_page": 10
  },
  "features": {
    "cache_enabled": true,
    "stats_enabled": true
  }
}

Options principales

Cache

Le cache améliore considérablement les performances :

{
  "features": {
    "cache_enabled": true,
    "cache_ttl": {
      "markdown": 3600,
      "pages": 7200
    }
  }
}
🚨 Important

Videz le cache après modification des fichiers Markdown pour voir les changements.

Statistiques

Activez les statistiques pour suivre les visites :

{
  "features": {
    "stats_enabled": true,
    "stats_access_enabled": false
  }
}

Fonctionnalités avancées

Pages privées

Protégez vos pages par mot de passe :

---
titre: Page confidentielle
permalien: secret
priver: true
mot_de_passe: MonMotDePasse123
---

Articles de blog

Créez des articles avec une date :

---
titre: Mon premier article
permalien: mon-premier-article
date: 2025-01-15
auteur: John Doe
tags: [tutoriel, débutant]
---

Table des matières automatique

La TOC est générée automatiquement à partir des titres H2, H3 et H4 de votre contenu.

Composants spéciaux

Callouts (Alertes)

Utilisez des callouts pour mettre en avant des informations :

💡 Info

Ceci est une information importante.

⚠️ Attention

Soyez prudent avec cette fonctionnalité.

🚨 Danger

Action irréversible !

✅ Succès

Opération réussie !

Badges

Ajoutez des badges pour signaler le statut :

NouveauBêtaDéprécié

Prochaines étapes

Maintenant que vous maîtrisez les bases, explorez :

🎉 Félicitations !

Vous êtes maintenant prêt à créer votre site avec sansCMS.

Besoin d'aide ?