Documentation Officielle

Guide d'Utilisation & Prise en Main

Découvrez comment Sites Faciles Mali simplifie la création, l'édition et le déploiement de portails institutionnels conformes à la charte DSML.

1

Vocation & Mission de Sites Faciles

Sites Faciles Mali a été conçu pour résoudre un défi récurrent des administrations publiques : la création rapide de sites web modernes, sécurisés et visuellement cohérents sans réinventer la roue.

  • Conformité au Design System Mali (DSML) : L'intégration native du Design System Mali (la charte graphique et ergonomique officielle des sites publics du Mali) assure le respect des couleurs, typographies et pictogrammes officiels.
  • Édition sans code : Les agents et rédacteurs peuvent modifier les contenus directement depuis l'interface grâce au CMS inline.
  • Déploiement Git automatisé : Publication des contenus en temps réel via des commits Git automatiques sur Dokploy/GitHub.
2

Mode Édition & CMS Inline

Le mode édition permet d'éditer le texte directement sur les pages sans passer par un tableau de bord complexe.

  1. Rendez-vous sur la page d'administration /admin pour déverrouiller l'accès.
  2. Activez l'interrupteur "Mode Édition" dans le bandeau supérieur d'administration.
  3. Survolez n'importe quel élément entouré d'un pointillé bleu pour cliquer et modifier son contenu.
  4. Cliquez sur "Publier les modifications" dans le bandeau supérieur pour valider et enregistrer.
3

Guide Développeur & Méthodes d'Installation

Pour créer un nouveau portail institutionnel ou intégrer Sites Faciles Mali, trois approches adaptées à votre flux de travail sont disponibles :

Méthode 1 — Cloner / Copier le dépôt complet monorépo

Pour développer le moteur, modifier les composants cœurs de @malihub/sites-core ou disposer d'un environnement monorépo complet.

# Cloner et installer
git clone https://github.com/malibub-digital/sites.git mon-site
cd mon-site && npm install
npm run dev

Méthode 2 — Copier le dossier template d'amorçage

Pour démarrer un projet autonome avec toutes les pages d'exemple, les fiches démarches et la configuration CMS préinstallées.

# Copier le template & installer
cp -r sites/template mon-nouveau-site
cd mon-nouveau-site && npm install
npm run dev

Méthode 3 — Installer le package @malihub/sites-core via NPM

Pour ajouter le moteur CMS et les composants certifiés DSML dans une application Astro existante.

npm install @malihub/sites-core @malihub/dsml-core
---
import { BaseLayout, Header, Footer, Hero, ServiceCard } from '@malihub/sites-core';
import siteConfig from '../site.config.json';
---
<BaseLayout title={siteConfig.title}>
<Header slot="header" title={siteConfig.title} institution={siteConfig.institution} />
<main id="main-content" class="py-12">
<Hero title="Bienvenue" subtitle="Portail Officiel" />
</main>
<Footer slot="footer" institution={siteConfig.institution} contact={siteConfig.contact} />
</BaseLayout>

Composants Cœurs Disponibles dans @malihub/sites-core :

BaseLayout — Layout HTML5 universel DSML + SEO + CMS
Header — En-tête républicain & navigation
Footer — Pied de page institutionnel & liens
Hero — Bannière d'accueil & accès rapide
ServiceCard — Carte de démarche réutilisable
EmergencyBanner — Alerte urgente sticky
4

Protocole pour Assistants de Code & LLM

Le projet fournit des directives et des inventaires standards pour alimenter vos assistants de code (Cursor, Windsurf, Copilot, Antigravity...) :

  • Fichier AI_RULES.md : Règles d'architecture, découpage des bindings data-cms-bind et configurations d'IDE.
  • Fichier /llms.txt : Guide standardisé exposé publiquement à la racine du domaine pour tout agent ou LLM externe.
Consulter le fichier /llms.txt en direct →

Prêt à explorer la bibliothèque ?

Découvrez l'ensemble des palettes et des éléments UI certifiés DSML.

Bibliothèque de Composants →