Administration

L'interface d'administration est accessible à l'adresse /admin/ de votre instance. Seul le mot de passe administrateur configuré dans config.local.php est requis pour s'y connecter.

Connexion

Accédez à /admin/ et entrez le mot de passe administrateur. La session reste active jusqu'à la déconnexion ou l'expiration.

Tableau de bord

Le tableau de bord affiche l'ensemble de vos documents organisés par projets (dossiers). Une arborescence sur la gauche permet de naviguer dans la structure des fichiers.

Informations affichées

Pour chaque document, le tableau affiche :

Les documents non encore indexés apparaissent en gris dans l'arborescence.

Gestion des projets

Créer un projet

Cliquez sur Nouveau projet dans la barre d'actions. Donnez un nom au dossier : il sera créé dans data/documents/.

Supprimer un projet

Cliquez sur l'icône de suppression dans l'arborescence. Une confirmation vous sera demandée.

Attention : La suppression d'un projet supprime le dossier et tous les fichiers qu'il contient.

Gestion des documents

Téléverser un document

1. Cliquez sur Téléverser dans la barre d'actions
2. Sélectionnez un fichier .md
3. Choisissez le projet (dossier) de destination
4. Le document est automatiquement indexé

Indexer un document existant

Si vous avez copié des fichiers manuellement dans data/documents/, ils apparaissent dans l'arborescence en gris (non indexés). Cliquez sur un document pour l'indexer : MarginaliaMD lui attribue un hash public et le rend accessible.

En mode documentation ou hybride, l'indexation se fait aussi automatiquement lors de la navigation publique.

Indexation en masse (CLI)

Pour indexer tous les documents d'un coup :

php cli/index-documents.php

Ce script parcourt récursivement data/documents/, analyse le front matter YAML de chaque fichier .md et met à jour la base de données et l'index de recherche.

Copier le lien de partage

Cliquez sur l'icône de copie dans le tableau des documents. Le lien public est copié dans le presse-papier. En mode revue, ce lien contient le hash du document. En mode documentation, c'est une URL propre basée sur le chemin du fichier.

Activer / désactiver un document

Le statut actif/inactif contrôle l'accessibilité publique du document. Un document inactif reste visible dans l'administration mais n'est plus accessible aux visiteurs.

Supprimer un document

L'icône de suppression retire le document de la base de données. Vous avez le choix de supprimer aussi le fichier physique sur le disque.

Versions

Chaque modification du contenu d'un document crée automatiquement une nouvelle version. Le détail des versions est accessible via l'icône de versions dans le tableau des documents.

La page des versions affiche :

• La date de création de chaque version
• Le hash de contenu (SHA256)
• Le nombre d'annotations liées à chaque version

Les annotations sont toujours associées à la version du document sur laquelle elles ont été créées.

Protection par mot de passe

Vous pouvez protéger l'accès à un document individuel avec un mot de passe. Cette protection s'ajoute au mécanisme de hash : même avec le lien, le visiteur doit entrer le mot de passe pour consulter le contenu.

La protection par mot de passe se configure via l'API de mise à jour du document (endpoint PUT). Le mot de passe est stocké en hash bcrypt.

Vérifications système

La page Vérifications (/admin/checks.php) contrôle l'état de votre installation :

Paramètres du site

Accessible via le menu Paramètres du site, cette page permet de configurer le nom du site, le message de bienvenue, les liens du pied de page et l'attribution. Voir la page Configuration pour le détail des paramètres.