Pena/docs/1-fonctionnel/1.2-Fonctionnalites.md

Fonctionnalités

Cette page liste l'ensemble des fonctionnalités visibles par l'utilisateur, regroupées par thème.

1. Ouverture de documents

Ouvrir un fichier Markdown

• Bouton « Ouvrir un fichier Markdown » sur l'écran d'accueil.
• Ouvre un sélecteur de fichiers natif, filtré sur l'extension .md.
• Une fois le fichier ouvert, la barre latérale liste tous les .md du dossier parent, ce qui permet de basculer entre fichiers voisins.

Ouvrir un dossier wiki

• Bouton « Ouvrir un dossier wiki » sur l'écran d'accueil.
• Ouvre un sélecteur de dossier natif.
• Tous les fichiers .md du dossier et de ses sous-dossiers sont listés (récursivement).
• Les fichiers et dossiers cachés (commençant par .) sont ignorés.
• Si un fichier Home.md ou home.md est présent à la racine, il est affiché en premier ; sinon, c'est le premier fichier par ordre alphabétique.

2. Documents récents

• L'écran d'accueil affiche une section « Récents » (masquée si vide).
• Chaque entrée affiche une icône (📁 pour un dossier, 📄 pour un fichier), le nom et le chemin parent.
• Un clic réouvre directement le fichier ou le dossier.
• Jusqu'à 8 entrées sont conservées, sans doublon, dans le stockage local (localStorage, clé pena_recents).

3. Navigation dans la documentation

Barre latérale en arborescence

• Affiche la structure complète du dossier ouvert sous forme d'arbre.
• Les dossiers sont des sections repliables/dépliables (chevron).
• Fichiers et dossiers sont triés par ordre naturel : les préfixes numériques sont comparés comme des nombres (10 vient après 9, et non après 1).
• Dossiers et fichiers partagent la même typographie (taille et graisse) ; seul le chevron ▶ distingue visuellement un dossier.
• Si un dossier contient un home.md, son nom devient un lien cliquable.
• Le document actuellement affiché est surligné, et les dossiers parents sont automatiquement dépliés.
• Plusieurs niveaux de profondeur sont gérés avec une indentation progressive.

Liens entre documents

• Les liens Markdown relatifs vers d'autres fichiers .md (ex. [autre page](../section/page.md)) sont fonctionnels : un clic charge le document cible dans Pena, sans quitter l'application. Les chemins relatifs (../, ./) sont résolus correctement.
• Les liens externes (http://, https://) s'ouvrent dans le navigateur par défaut (nouvel onglet, avec rel="noopener noreferrer").
• Les ancres internes (#section) restent des ancres de page.

4. Rendu Markdown

Le rendu prend en charge le standard CommonMark ainsi que les extensions suivantes :

Extension	Exemple
Tableaux	| col A | col B |
Texte barré	~~barré~~
Liens automatiques	une URL nue devient un lien cliquable
Listes de tâches	- [ ] à faire / - [x] fait

Autres éléments rendus : titres h1–h6, code inline, blocs de code, citations (blockquotes), listes, images (largeur adaptée), et liens.

5. Coloration syntaxique du code

• Les blocs de code délimités par triple backtick sont colorés syntaxiquement via syntect.
• Le thème de coloration intégré est base16-ocean.dark.
• La syntaxe TypeScript est fournie en plus des syntaxes par défaut.

Bouton « Copier » sur les blocs de code

• Chaque bloc de code affiche un bouton « Copier » en haut à droite.
• Un clic copie le contenu du bloc dans le presse-papiers.
• Un retour visuel temporaire (« Copié ! ») confirme l'action.

6. Personnalisation de l'apparence

Voir la page dédiée Thèmes et personnalisation. En résumé :

• 6 thèmes rapides prêts à l'emploi (Défaut, Mode sombre, Sépia, Grand texte, Accent émeraude, Shell Indigo).
• Un éditeur CSS intégré, organisé en 4 onglets thématiques, permettant d'écrire son propre CSS appliqué au rendu.
• Les choix sont persistés localement et réappliqués au démarrage suivant.

7. Fenêtre et barre de titre personnalisée

• L'application utilise une barre de titre maison (la décoration native est désactivée).
• Elle affiche le titre du document courant et propose les boutons réduire, agrandir / restaurer et fermer.
• La fenêtre se déplace en glissant la barre de titre.

8. Rechargement automatique (live-reload)

• À l'ouverture d'un fichier ou d'un dossier, l'application surveille en continu son contenu sur le disque.
• Quand le document affiché est modifié (par un éditeur externe, un git pull, etc.), il est rechargé automatiquement — plus besoin de revenir à l'accueil et de rouvrir le dossier.
• Quand un fichier .md est ajouté ou supprimé dans le dossier ouvert, la sidebar se met à jour automatiquement pour refléter la nouvelle arborescence (le dossier du document courant reste déplié).
• La surveillance s'arrête au retour à l'accueil et se réinitialise à chaque nouvelle ouverture. Détails techniques : Surveillance de fichiers.

Voir aussi

• Interface
• Thèmes et personnalisation
• Vue d'ensemble