PlanCake

Bienvenue dans PlanCake

PlanCake vous permet de lire des fichiers Markdown confortablement et d’y laisser des notes exactement là où elles doivent être. Il affiche un fichier tel qu’il est censé être lu : de vrais titres, des listes, des tableaux et des blocs de code, au lieu de dièses et d’astérisques. Il a été conçu pour les longs plans d’implémentation que rédigent les assistants de codage IA — souvent 800 lignes et plus — mais il fonctionne avec n’importe quel fichier Markdown.

Lire n’est que la moitié de la relecture. L’autre moitié consiste à dire ce que vous en pensez : « cette étape est incorrecte », « faites d’abord celle-ci ». Dans PlanCake, vous cliquez sur le paragraphe, l’élément de liste, le titre, la ligne de tableau ou le bloc de code que vous voulez commenter, ou vous appuyez sur Entrée dessus, puis vous tapez votre note. PlanCake l’écrit directement dans le fichier Markdown, juste après ce bloc, entre une paire de marqueurs. Vous n’avez jamais à compter les lignes ni à déterminer où la note doit aller — PlanCake sait de quelles lignes du fichier provient chaque bloc. Quiconque lit le fichier ensuite, un collègue ou un assistant IA comme Claude, retrouve vos notes exactement là où elles doivent être.

Quelques points à connaître d’emblée. PlanCake n’est pas un éditeur de texte : à part vos notes et les cases à cocher des listes de tâches, il ne modifie jamais le texte d’un document. Il n’y a rien à enregistrer — chaque note se trouve dans le fichier dès que vous la confirmez. PlanCake fonctionne sous Windows 10 et 11 (64 bits), et tout y fonctionne aussi bien à la souris, au clavier seul, qu’avec un lecteur d’écran.

Démarrage rapide

1. Ouvrez un plan : lancez PlanCake depuis le menu Démarrer et faites glisser un fichier Markdown sur sa fenêtre, ou appuyez sur Ctrl+O et choisissez le fichier. Depuis une invite de commandes, plancake plan.md fait la même chose.
2. Lisez-le. Les titres, les listes, les tableaux et le code s’affichent mis en forme ; faites défiler avec la molette de la souris ou les touches fléchées et de pagination.
3. Lorsque vous atteignez un élément que vous voulez commenter, cliquez dessus. Depuis le clavier, appuyez sur Alt+Maj+Flèche bas ou Alt+Maj+Flèche haut pour vous déplacer de bloc en bloc jusqu’à ce qu’il soit entouré, puis appuyez sur Entrée. La boîte de dialogue Ajouter une note s’ouvre avec le curseur dans la zone de note.
4. Tapez votre note et appuyez sur Entrée, ou cliquez sur OK. La note apparaît juste après le bloc, et la barre d’état affiche « Note ajoutée ». Elle se trouve déjà dans le fichier.
5. Continuez à lire et à ajouter des notes. Une fois terminé, fermez la fenêtre — il n’y a rien à enregistrer.

Installer PlanCake

PlanCake se présente sous deux formes : un programme d’installation, qui configure tout pour vous, et une version portable, qui s’exécute depuis n’importe quel dossier, y compris une clé USB. Les deux fonctionnent de la même façon une fois lancées ; elles ne diffèrent que par l’endroit où PlanCake conserve ses paramètres. Téléchargez l’une ou l’autre depuis le site web de PlanCake.

Avec le programme d’installation

Exécutez le programme d’installation et suivez ses étapes. Outre PlanCake lui-même, il s’occupe de ce dont PlanCake a besoin pour fonctionner : il installe le .NET 10 Desktop Runtime et le Microsoft Edge WebView2 Runtime si votre ordinateur ne les possède pas encore. Il ajoute aussi PlanCake à votre PATH, de sorte que la commande plancake fonctionne dans toute nouvelle fenêtre PowerShell ou invite de commandes.

Vos paramètres sont conservés dans %APPDATA%\Oire\PlanCake.

Le programme d’installation ajoute PlanCake au menu Démarrer, avec un raccourci vers ce manuel dans la langue que vous avez choisie pour l’installation.

PlanCake n’est pas signé avec un certificat de signature de code. La première fois que vous lancez le programme d’installation, ou plancake.exe depuis le zip portable, Windows SmartScreen peut afficher « Windows a protégé votre ordinateur » et un éditeur inconnu. Pour continuer, choisissez Informations complémentaires, puis Exécuter quand même.

La version portable

Décompressez le fichier zip dans n’importe quel dossier et exécutez plancake.exe depuis cet endroit. Le zip comprend un dossier vide nommé userdata à côté de plancake.exe ; tant que ce dossier est présent, PlanCake y conserve ses paramètres et n’écrit rien dans votre profil utilisateur. Supprimez ou renommez le dossier userdata et PlanCake revient à l’utilisation de %APPDATA%\Oire\PlanCake.

La version portable n’installe rien, votre ordinateur doit donc déjà disposer du .NET 10 Desktop Runtime et du Microsoft Edge WebView2 Runtime. Windows 11 est livré avec WebView2 ; s’il est absent, PlanCake vous le signale à son démarrage et propose d’ouvrir la page de téléchargement.

Pour utiliser la commande plancake avec la version portable, tapez son chemin complet ou ajoutez vous-même son dossier à votre PATH.

Désinstaller PlanCake

Désinstallez PlanCake depuis Applications dans les Paramètres de Windows, ou avec Désinstaller PlanCake dans le menu Démarrer. Le programme de désinstallation retire PlanCake de votre PATH et demande s’il faut aussi supprimer vos paramètres et vos journaux ; vos fichiers Markdown et les notes qu’ils contiennent ne sont jamais touchés. La version portable n’installe rien : pour la supprimer, supprimez son dossier.

Si vous travaillez avec un compte Windows standard et qu’un administrateur saisit son mot de passe pour autoriser la désinstallation, le programme de désinstallation s’exécute en tant que cet administrateur et cherche les paramètres de l’administrateur, pas les vôtres : il ne pose donc pas la question. Vos paramètres et vos journaux restent alors dans %APPDATA%\Oire\PlanCake et %LOCALAPPDATA%\Oire\PlanCake ; supprimez vous-même ces dossiers si vous n’en avez plus besoin.

Une commande plus courte : pk

Si vous ouvrez des plans depuis la ligne de commande toute la journée, vous pouvez donner à PlanCake un nom de deux lettres. PlanCake ne fait pas cela pour vous ; c’est une ligne à ajouter dans votre propre profil de shell.

• Dans PowerShell, ajoutez cette ligne à votre profil (le fichier dont $PROFILE contient le chemin) :

  Set-Alias pk plancake

• Dans bash, ajoutez cette ligne à votre .bashrc :

  alias pk=plancake

Ensuite, pk plan.md ouvre un plan, et toutes les commandes de Travailler depuis la ligne de commande fonctionnent avec pk à la place de plancake.

La fenêtre principale

La fenêtre comporte une barre de menus en haut, le document à gauche, la liste des notes à droite, et une barre d’état tout en bas. La barre de titre affiche le nom du fichier ouvert, par exemple plan.md - PlanCake.

Pour donner plus de place au document ou à la liste des notes, faites glisser la bordure qui les sépare. Depuis le clavier, choisissez Élargir la liste des notes ou Rétrécir la liste des notes dans le menu Affichage : chacune déplace la bordure d’un dixième de la largeur partagée par les deux, jusqu’à un chiffre rond — à partir de 32 %, par exemple, la liste passe à 40 % de large, ou à 30 %. La barre d’état vous indique la nouvelle répartition, par exemple « Liste des notes 40 % ». Aucun des deux côtés ne peut disparaître : la liste reste large d’au moins 150 pixels environ, et le document d’environ 200. À cette limite, la bordure reste immobile, et la barre d’état répète la répartition actuelle. Les deux commandes sont indisponibles tant que la liste des notes est masquée.

PlanCake retient la taille et la position de la fenêtre, si elle était agrandie, la largeur de la liste des notes et le zoom : la fenêtre suivante s’ouvre de la même façon, sur un écran toujours présent. La toute première fenêtre s’adapte à l’écran sur lequel elle s’ouvre.

Le document

C’est votre fichier Markdown, mis en forme. Quand PlanCake ouvre un fichier, il commence en haut. Vos notes apparaissent aussi à l’intérieur du document, chacune juste après le bloc auquel elle appartient et distincte du texte du plan, afin que vous puissiez voir d’un coup d’œil ce qui vous appartient.

La liste des notes

La liste des notes rassemble toutes les notes du fichier en un seul endroit, dans l’ordre où elles apparaissent. Elle comporte trois colonnes :

Note

La première phrase de la note sur une seule ligne, sans la ponctuation Markdown. La colonne prend toute la largeur que laissent les deux autres. Laissez le pointeur de la souris sur une ligne pour voir la note entière.

Lignes

L’emplacement de la note dans le fichier : 12 pour une note d’une seule ligne, 12-14 pour une note plus longue.

Bloc

La première phrase du bloc que suit la note, pour savoir de quoi il s’agit sans avoir à s’y rendre. Dans les deux colonnes, une phrase très longue est raccourcie si possible à une virgule, un deux-points ou un tiret.

Pour aller à une note dans le document, appuyez sur Entrée sur sa ligne ou double-cliquez dessus ; le focus se déplace vers la note. Pour supprimer une note, sélectionnez-la et appuyez sur Suppr ; la sélection se déplace alors vers la note restante la plus proche, afin que vous ne perdiez jamais votre place dans la liste. Faites un clic droit sur une ligne, ou appuyez sur la touche Applications ou Maj+F10, pour obtenir un menu avec Modifier la note et Supprimer la note.

Si vous préférez disposer de toute la fenêtre pour le document, choisissez Liste des notes dans le menu Affichage. Cela masque la liste, et le choisir à nouveau la réaffiche ; la barre d’état affiche « Liste des notes masquée » ou « Liste des notes affichée ». PlanCake retient ce choix : c’est le même réglage que Afficher la liste des notes dans les paramètres, si bien que les nouvelles fenêtres s’ouvrent de la même façon, et que les autres fenêtres ouvertes suivent dès que vous passez à l’une d’elles.

Se déplacer entre le document et la liste

Cliquez là où vous voulez travailler, ou appuyez sur F6 pour basculer entre le document et la liste des notes. Si la liste ne contient aucune note, la barre d’état affiche « Aucune note ».

Tab fonctionne aussi : appuyer sur Tab après le dernier lien ou la dernière case à cocher du document vous amène dans la liste des notes, et Maj+Tab depuis le premier élément fait de même. Depuis la liste, Tab et Maj+Tab vous ramènent au document.

Quand la liste des notes est masquée, F6 comme Tab vous maintiennent dans le document. F6 déplace le focus ; il ne réaffiche pas une liste masquée. Utilisez pour cela Affichage, Liste des notes.

Messages d’état

Rien de ce que fait PlanCake ne se passe en silence. Chaque changement — une note ajoutée, une tâche cochée, un fichier rechargé, un téléchargement terminé — est confirmé par un court message dans la barre d’état, en bas de la fenêtre, tel que « Note ajoutée » ou « Fichier rechargé ». Le message y reste jusqu’à ce que le suivant le remplace.

Les questions posées par PlanCake

Quand PlanCake vous pose une question par oui ou non — supprimer cette note ? cocher cette tâche ? recharger ce fichier ? — appuyer sur Échap répond Non, tout comme fermer la question avec son bouton de fermeture. Vous pouvez toujours vous retirer sans rien choisir.

Dans les autres boîtes de dialogue — Ajouter une note, Paramètres, Ouvrir depuis un lien — Échap équivaut au bouton Annuler : il ferme la boîte de dialogue et abandonne ce que vous avez tapé. Dans Raccourcis clavier et À propos de PlanCake, Échap les ferme simplement.

Utiliser un lecteur d’écran

PlanCake a été conçu en pensant aux lecteurs d’écran, et quelques détails méritent d’être connus si vous en utilisez un :

• Le document est une page web, vous le lisez donc avec les touches de navigation web habituelles de votre lecteur d’écran — par titre, par liste, par tableau, etc. Pour commenter un bloc, déplacez-vous dessus et appuyez sur Entrée ; vous restez dans votre mode de lecture, au même endroit. Une fois enregistré, vous atterrissez sur la nouvelle note.
• Chaque message d’état est annoncé quel que soit l’endroit où se trouve votre focus, si bien que vous entendez « Note ajoutée », « Plus de notes » ou « Fichier rechargé » sans avoir à chercher la barre d’état. Si vous en manquez un, la commande de votre lecteur d’écran pour lire la barre d’état, ou pour répéter le dernier message, vous le relit.
• Chaque note du document est une région nommée « Note de l’utilisateur », afin que vous puissiez la distinguer du texte propre au plan.
• Le paramètre Langue du document indique à votre lecteur d’écran avec quelle voix lire le plan, indépendamment de la langue de l’interface : un plan en anglais est lu avec une voix anglaise même si Windows et PlanCake sont en russe.
• Quand le fichier est rechargé après une modification extérieure, la page est mise à jour sur place, de sorte que votre position de lecture reste où elle était.
• Ctrl+A ne sélectionne pas tout le document, volontairement : la sélection de texte est laissée aux propres commandes de votre lecteur d’écran.

Ouvrir un fichier

Les plans vous parviennent de multiples façons : un fichier sur le disque, un chemin collé par quelqu’un dans une discussion, un lien vers GitHub. PlanCake peut tous les ouvrir directement, sans que vous ayez à enregistrer quoi que ce soit au préalable. Quelle que soit la méthode utilisée, un fichier nouvellement ouvert commence toujours en haut.

Quand aucun fichier n’est ouvert, la fenêtre indique les façons d’en ouvrir un, avec leurs touches. Un gros fichier peut mettre un moment à s’ouvrir : si cela prend plus d’une demi-seconde, ou si le fichier dépasse 1 Mo, PlanCake affiche la boîte de dialogue Ouverture d’un fichier avec une barre de progression. Appuyez sur Échap ou cliquez sur Annuler pour l’interrompre ; le fichier que vous aviez ouvert reste tel quel.

Depuis la ligne de commande

Tapez plancake suivi du fichier :

plancake docs\plans\001-plan.md

Une fenêtre s’ouvre avec ce fichier. Tapez simplement plancake pour une fenêtre vide. Vous pouvez aussi faire glisser un fichier Markdown sur plancake.exe ou sur un raccourci vers celui-ci.

Depuis la boîte de dialogue Ouvrir ou par glisser-déposer

Faites glisser un fichier Markdown depuis l’Explorateur de fichiers et déposez-le sur la fenêtre de PlanCake. Ou appuyez sur Ctrl+O, ou choisissez Ouvrir dans le menu Fichier : la boîte de dialogue Ouvrir standard de Windows affiche les fichiers Markdown (.md et .markdown) ; passez le type de fichier à Tous les fichiers pour tout voir.

Depuis le presse-papiers

Appuyez sur Ctrl+V dans la fenêtre de PlanCake, ou choisissez Ouvrir depuis le presse-papiers dans le menu Fichier. PlanCake examine ce que vous avez copié :

• Un fichier copié dans l’Explorateur de fichiers : PlanCake l’ouvre. Si vous en avez copié plusieurs, il ouvre le premier fichier Markdown parmi eux.
• Un chemin copié sous forme de texte, avec ou sans guillemets (la commande Copier en tant que chemin d’accès de l’Explorateur de fichiers les ajoute) : PlanCake ouvre ce fichier.
• Un lien web commençant par http:// ou https:// : PlanCake télécharge le fichier et l’ouvre, comme décrit dans la section suivante.

Si le presse-papiers contient autre chose, la barre d’état affiche « Le presse-papiers ne contient ni fichier Markdown ni lien. »

Depuis un lien sur le web

Supposons qu’un collègue vous envoie un lien vers un plan sur GitHub. Appuyez sur Ctrl+L, ou choisissez Ouvrir depuis un lien dans le menu Fichier. La zone Lien est déjà remplie si le presse-papiers contient un lien ; sinon, collez-le ou tapez-le. Appuyez sur Entrée ou cliquez sur OK pour télécharger ; appuyez sur Échap ou cliquez sur Annuler pour renoncer.

La barre d’état affiche « Téléchargement depuis github.com... » puis, une fois le téléchargement terminé, l’endroit où le fichier a été enregistré ; le plan s’ouvre ensuite. Les téléchargements vont dans votre dossier Téléchargements, sous le nom même du fichier, toujours en tant que fichier Markdown : un lien vers un fichier d’un autre type reçoit l’extension .md, si bien que tool.bat est enregistré sous tool.bat.md et ne peut jamais s’exécuter. Comme un navigateur, PlanCake marque le fichier comme téléchargé depuis Internet ; si un fichier de ce nom s’y trouve déjà, PlanCake ajoute un numéro, comme plan (2).md, à la manière d’un navigateur. Comme le fichier téléchargé est un fichier ordinaire sur votre disque, vos notes y sont enregistrées comme dans n’importe quel autre.

Quelques points à connaître sur les liens :

• Vous pouvez coller un lien normal vers une page GitHub d’un fichier ; PlanCake récupère le Markdown brut qui se trouve derrière.
• Un lien vers une page web ordinaire plutôt que vers un fichier Markdown est refusé : « Ce lien mène à une page web, pas à un fichier Markdown. »
• Un téléchargement s’arrête au bout de 30 secondes, et les fichiers de plus de 10 Mo ne sont pas téléchargés.

Une fenêtre par fichier

Chaque fichier dispose de sa propre fenêtre, et un fichier n’est jamais ouvert dans deux fenêtres à la fois. Si vous ouvrez un fichier déjà ouvert dans une autre fenêtre de PlanCake — depuis la ligne de commande, le presse-papiers, n’importe où — PlanCake ramène cette fenêtre au premier plan plutôt que d’en ouvrir une seconde. Ainsi, deux fenêtres ne peuvent jamais écrire des notes contradictoires dans le même fichier.

Lire un document

Se déplacer

Faites défiler avec la molette de la souris ou la barre de défilement, ou utilisez les touches fléchées, Page précédente, Page suivante, Origine et Fin. Tab déplace de lien en lien et de case à cocher en case à cocher. Sélectionnez du texte avec la souris et copiez-le avec Ctrl+C comme dans tout autre programme ; terminer une sélection n’ouvre jamais la boîte de dialogue de note.

Pour travailler sur un bloc particulier depuis le clavier — un paragraphe, un titre, un élément de liste, une ligne de tableau, un bloc de code ou une note — appuyez sur Alt+Maj+Flèche bas pour le bloc suivant et sur Alt+Maj+Flèche haut pour le précédent, ou choisissez Bloc suivant et Bloc précédent dans le menu Notes. Le bloc reçoit un contour et défile pour devenir visible. Appuyez sur Entrée pour lui ajouter une note (ou la modifier, s’il s’agit d’une note), ou sur la touche Applications pour son menu. Au début ou à la fin du document, la barre d’état affiche « Plus de blocs ».

Le déplacement part du bloc ou de la note sur lequel vous avez travaillé ou vous êtes déplacé en dernier. S’il n’y en a pas encore, Alt+Maj+Flèche bas va au premier bloc visible et Alt+Maj+Flèche haut au dernier. Dans la liste des notes, ces touches déplacent vers un bloc du document et vous y placent.

Suivre des liens, revenir en arrière

Cliquez sur un lien, ou appuyez sur Entrée dessus, et PlanCake fait ce qui a du sens selon ce vers quoi il pointe :

• Un lien web s’ouvre dans votre navigateur par défaut.
• Un lien vers un autre fichier Markdown situé à côté de celui-ci ouvre ce fichier dans PlanCake, dans la même fenêtre.
• Un lien vers un dossier l’ouvre dans l’Explorateur de fichiers, et un lien vers un fichier texte, un PDF ou une image l’ouvre avec le programme que Windows lui associe. Tout autre fichier (un programme, un script comme .bat, .js ou .py, ou tout autre type dont l’ouverture pourrait exécuter quelque chose) n’est jamais ouvert depuis un lien, quoi qu’en dise son texte : PlanCake propose plutôt d’afficher le fichier dans l’Explorateur de fichiers. Un lien vers un fichier situé sur le partage réseau d’un autre ordinateur n’est pas suivi.
• Un lien vers un titre du même document vous y amène.
• Si un lien pointe vers un fichier qui n’existe pas, la barre d’état le signale et affiche le chemin.

PlanCake se souvient des fichiers que vous avez ouverts dans une fenêtre et de l’endroit où vous en étiez dans chacun, comme l’historique d’un navigateur. Appuyez sur Alt+Flèche gauche ou Retour arrière, ou choisissez Précédent dans le menu Affichage, pour revenir au fichier précédent, exactement à l’endroit où vous l’avez laissé. Alt+Flèche droite ou Suivant avance de nouveau. Aux extrémités de l’historique, la barre d’état affiche « Aucun fichier précédent » ou « Aucun fichier suivant ». Si un fichier de l’historique a depuis été supprimé, PlanCake le signale et le saute.

Ouvrir un fichier de toute autre manière — avec Ctrl+O, par glisser-déposer, depuis le presse-papiers, depuis un lien — l’ajoute aussi à l’historique, de sorte que Précédent vous ramène toujours à ce que vous lisiez auparavant.

Zoomer

Pour agrandir le texte, appuyez sur Ctrl+Plus ; pour le réduire, appuyez sur Ctrl+Moins. Les touches du pavé numérique fonctionnent aussi, tout comme Zoom avant et Zoom arrière dans le menu Affichage. Chaque étape change la taille de 10 %, entre 50 et 300 %, et la barre d’état affiche la nouvelle taille, par exemple « Zoom 120 % ». Appuyez sur Ctrl+0 pour revenir à 100 %. La prochaine fenêtre que vous ouvrez commence au même zoom.

La langue du document

PlanCake distingue deux langues : la langue de ses menus et boîtes de dialogue, et la langue dans laquelle le document est rédigé. Passer l’interface en français ne rend pas français un plan en anglais. La langue du document compte lorsque le plan est lu à voix haute (voir Utiliser un lecteur d’écran) et aide PlanCake à reconnaître les anciens encodages de fichiers (voir Les fichiers qui ne sont pas en UTF-8).

Les nouveaux documents utilisent la Langue du document définie dans les paramètres, l’anglais à moins que vous ne la changiez. Pour définir une autre langue pour un fichier particulier, choisissez Langue du document dans le menu Affichage et sélectionnez-la. Cela ne s’applique qu’au fichier ouvert ; le prochain fichier que vous ouvrirez utilisera de nouveau la langue des paramètres.

Laisser des notes

Ajouter une note

1. Cliquez sur le paragraphe, le titre, l’élément de liste, la ligne de tableau ou le bloc de code que vous voulez commenter. Le bloc sous le pointeur de la souris est mis en évidence, pour que vous voyiez à quel bloc un clic ajoute une note. Depuis le clavier, déplacez-vous dessus avec Alt+Maj+Flèche bas ou Alt+Maj+Flèche haut (voir Se déplacer) et appuyez sur Entrée. La boîte de dialogue Ajouter une note s’ouvre. Elle affiche le début du bloc sous Note sur, afin que vous puissiez vérifier que vous avez choisi le bon, et place le curseur dans la zone Note.
2. Tapez votre note. Pour y commencer une nouvelle ligne, appuyez sur Ctrl+Entrée.
3. Appuyez sur Entrée ou cliquez sur OK pour enregistrer ; appuyez sur Échap ou cliquez sur Annuler pour renoncer. OK reste indisponible tant que la zone est vide, et un appui sur Entrée indique alors seulement « Saisissez d’abord une note. »

PlanCake écrit aussitôt la note dans le fichier, juste après le bloc. Le document se met à jour, la barre d’état affiche « Note ajoutée », et la nouvelle note se trouve là où vous êtes désormais. Elle apparaît aussi dans la liste des notes.

Un simple clic suffit ; un double-clic ne fait rien de plus qu’un simple clic. Sélectionner du texte avec la souris n’ouvre pas la boîte de dialogue, vous pouvez donc toujours sélectionner et copier du texte comme d’habitude.

Si vous préférez que Entrée crée une nouvelle ligne et que Ctrl+Entrée enregistre, changez Entrée dans la boîte de dialogue de note dans les paramètres. Si vous préférez qu’un clic ou Entrée sur un bloc ouvre un menu plutôt que la boîte de dialogue — par exemple parce que vous cliquez souvent pour vous positionner et ajoutez des notes par accident — changez Entrée ou clic sur un bloc. Les deux sont décrits dans les paramètres de Notes.

Vous pouvez aussi ajouter une note via le menu contextuel : faites un clic droit sur un bloc, ou appuyez sur la touche Applications ou Maj+F10 dessus, et choisissez Ajouter une note.

Modifier une note

Cliquez sur la note dans le document, ou déplacez-vous dessus avec F9 ou Alt+Maj+Flèche bas puis appuyez sur Entrée. La même boîte de dialogue s’ouvre, intitulée Modifier la note et remplie avec le texte de la note. Modifiez-la et enregistrez ; la barre d’état affiche « Note modifiée ».

Vous pouvez aussi ouvrir une note pour la modifier depuis la liste des notes, via le menu contextuel, ou avec Modifier la note dans le menu Notes.

Supprimer des notes

Pour supprimer une note, sélectionnez-la dans la liste des notes et appuyez sur Suppr. Ou faites un clic droit sur la note, dans le document ou dans la liste, ou appuyez sur la touche Applications ou Maj+F10 dessus, et choisissez Supprimer la note. PlanCake demande « Supprimer cette note ? » et affiche son texte ; cliquez sur Oui ou appuyez sur Entrée. La barre d’état affiche « Note supprimée ». Si vous préférez ne pas être sollicité à chaque fois, désactivez Demander avant de supprimer une note dans les paramètres.

Pour supprimer toutes les notes du fichier en une seule fois — par exemple après que l’auteur du plan les a toutes traitées — choisissez Supprimer toutes les notes dans le menu Édition. PlanCake demande toujours confirmation au préalable, avec le nombre de notes, quel que soit le paramètre.

Se déplacer de note en note

Appuyez sur F9 pour la note suivante et sur Maj+F9 pour la précédente, ou utilisez Note suivante et Note précédente dans le menu Notes. Dans le document, cela vous amène à la note ; dans la liste des notes, cela déplace la sélection. Après la dernière note ou avant la première, la barre d’état affiche « Plus de notes ».

Annuler une modification

Appuyez sur Ctrl+Z pour annuler et sur Ctrl+Y pour rétablir, ou utilisez Annuler et Rétablir dans le menu Édition. Cela couvre tout ce que PlanCake écrit : ajouter, modifier et supprimer des notes, supprimer toutes les notes, et cocher ou décocher des tâches. La barre d’état vous indique ce qui a été annulé ou rétabli, par exemple « Ajout de la note annulé » ou « Cochage de la tâche rétabli », et « Rien à annuler » quand il ne reste plus rien.

Annuler ne fonctionne que tant que le fichier contient encore ce que PlanCake a écrit en dernier. Si autre chose a modifié le fichier depuis, PlanCake n’annule pas par-dessus ce changement ; il affiche « Le fichier a changé, il n’y a donc plus rien à annuler ni à rétablir. »

Mise en forme à l’intérieur d’une note

Vous pouvez utiliser Markdown dans une note : emphase, code en ligne, liens, listes, même un bloc de code. Dans le document, la note s’affiche mise en forme, tandis que le fichier conserve exactement ce que vous avez tapé.

Deux exceptions préservent l’intégrité de la structure du plan. Un titre que vous tapez dans une note s’affiche en texte gras, et non comme un véritable titre, afin que vos notes ne se mélangent jamais avec les titres propres au plan. Et les balises HTML que vous tapez s’affichent comme du texte brut.

Une note ne peut pas contenir son propre marqueur de fermeture, [/usernote] par défaut, car cela y mettrait fin prématurément. Si vous utilisez un marqueur unique sans marqueur de fermeture (voir les paramètres de Notes), une note ne peut pas contenir ce marqueur, car cela démarrerait une seconde note. Si vous en tapez un, PlanCake garde la boîte de dialogue ouverte et vous indique pourquoi.

À quoi ressemble une note dans le fichier

Les notes sont du texte brut dans votre fichier Markdown, encadré par deux marqueurs. Une note sur un paragraphe ressemble à ceci :

Sauvegardez la base de données avant d’exécuter la migration.
[usernote]Sauvegardez aussi le dossier des téléversements.[/usernote]

Quiconque ouvre le fichier dans un éditeur de texte, et tout outil qui le lit, voit vos notes. Vous pouvez même écrire des notes à la main sous la même forme, et PlanCake les affiche comme les siennes. Pour utiliser des marqueurs différents, voir les paramètres de Notes.

Les marqueurs à l’intérieur du code ne sont pas des notes : entre accents graves, comme dans `[usernote]`, ou dans un bloc de code. Les marqueurs dans du HTML brut ne sont pas des notes non plus : dans un commentaire HTML, <!-- … -->, ou dans un bloc <pre>, <script>, <style> ou <textarea>, de sa balise ouvrante à sa balise fermante. Si le Marqueur d’ouverture commence lui-même par <!--, les marqueurs à l’intérieur des commentaires restent des notes. Un plan ou un manuel qui montre les marqueurs en exemple les garde tels quels, et ni la fenêtre ni les commandes n’y touchent. PlanCake lui-même n’écrit jamais de note à l’intérieur du code : une note sur un bloc de code va sur la ligne qui le suit.

Copier le texte d’un bloc

Pour copier un paragraphe, un élément de liste ou un autre bloc sans sa ponctuation Markdown, faites un clic droit dessus, ou appuyez sur la touche Applications ou Maj+F10 dessus, et choisissez Copier le texte du bloc. La barre d’état affiche « Texte du bloc copié ».

Cocher des tâches

De nombreux plans contiennent des listes de contrôle — des lignes telles que - [ ] Écrire les tests dans le fichier. PlanCake les affiche comme de vraies cases à cocher, afin que vous puissiez cocher les étapes au fur et à mesure sans ouvrir d’éditeur.

1. Cliquez sur la case à cocher, ou appuyez sur Espace ou Entrée dessus.
2. PlanCake demande « Marquer cette tâche comme terminée ? Le fichier sur le disque sera modifié. » (ou « Marquer cette tâche comme non terminée ? Le fichier sur le disque sera modifié. » pour une tâche cochée) et affiche la tâche. Cliquez sur Oui ou appuyez sur Entrée. Si vous répondez Non, la case à cocher reste exactement comme elle était.
3. PlanCake écrit [x] ou [ ] sur cette seule ligne du fichier. Vous restez sur la case à cocher, et la barre d’état affiche « Tâche cochée » ou « Tâche décochée ».

Si vous cochez souvent des tâches et n’avez pas besoin de la question, désactivez Demander avant de cocher ou de décocher une tâche dans les paramètres. Ctrl+Z annule un cochage comme tout autre changement.

Une tâche comportant des sous-tâches, certaines terminées et d’autres non, s’affiche partiellement cochée. Il ne s’agit que d’un affichage : Markdown n’a pas de troisième état, donc rien n’est écrit pour cela. Cocher une telle tâche ne marque comme terminée que cette tâche elle-même — les lignes de ses sous-tâches ne sont jamais touchées.

Quand le fichier change en dehors de PlanCake

Un plan en cours de relecture reste rarement figé : un assistant IA le met à jour, un collègue le modifie, le contrôle de version apporte une nouvelle révision. PlanCake remarque quand le fichier ouvert change sur le disque et le recharge aussitôt. La barre d’état affiche « Fichier rechargé », et vous restez où vous en étiez dans votre lecture — la page est mise à jour sur place plutôt que de revenir en haut.

Si vous préférez décider vous-même, réglez Quand le fichier change sur le disque sur Demander avant de le recharger dans les paramètres. PlanCake demande alors s’il faut recharger. Si vous répondez Non, il vous indique que F5 recharge le fichier dès que vous êtes prêt.

Si le fichier est supprimé, renommé ou déplacé ailleurs, PlanCake vous le signale, et les commandes de notes deviennent indisponibles jusqu’à ce que le fichier soit de retour. Quand il réapparaît au même endroit, PlanCake indique qu’il est de retour et le recharge.

PlanCake n’écrase jamais un changement qu’il n’a pas vu. Supposons que le fichier change pendant que vous tapez une note. Quand vous enregistrez, PlanCake refuse d’écrire, affiche le fichier tel qu’il est maintenant, et indique « Le fichier a changé. Veuillez réessayer. » Rien n’est perdu d’un côté comme de l’autre : ajoutez de nouveau votre note, et elle ira dans la version actuelle du fichier.

Les fichiers qui ne sont pas en UTF-8

Presque tous les fichiers Markdown sont aujourd’hui en UTF-8. Les fichiers plus anciens, notamment dans des langues telles que le russe ou l’hébreu, sont parfois enregistrés dans un ancien encodage Windows à la place. PlanCake les ouvre et les affiche correctement, mais par défaut il n’y écrit pas : le fichier s’ouvre en lecture seule, et PlanCake vous le signale, en nommant l’encodage, par exemple « Ce fichier n’est pas en UTF-8, il a donc été ouvert en lecture seule en tant que Windows-1251. Impossible d’y ajouter des notes. Pour le convertir en UTF-8, activez la conversion des fichiers qui ne sont pas en UTF-8 dans les paramètres. »

Pour ajouter des notes à de tels fichiers, activez Convertir en UTF-8 à l’ouverture dans les paramètres avancés. PlanCake convertit alors chaque fichier de ce type en UTF-8 dès que vous l’ouvrez et vous le signale, par exemple « Le fichier a été converti de Windows-1251 en UTF-8. » Seul l’encodage change ; le texte et les fins de ligne restent les mêmes.

Parfois, PlanCake ne peut pas déterminer avec certitude quel encodage un fichier utilise. Un tel fichier reste toujours en lecture seule, quel que soit le paramètre : « L’encodage de ce fichier n’a pas pu être reconnu, il a donc été ouvert en lecture seule et ne sera jamais modifié. Impossible d’y ajouter des notes. » C’est une règle stricte. Écrire dans un fichier qui n’a pas été lu correctement détruirait les caractères que PlanCake n’a pas pu déchiffrer, et PlanCake ne fait jamais cela.

Le paramètre Langue du document est l’un des indices que PlanCake utilise pour reconnaître un ancien encodage ; le régler sur la langue dans laquelle vos anciens fichiers sont écrits est donc utile.

Paramètres

Appuyez sur Ctrl+Virgule, ou choisissez Paramètres dans le menu Fichier. Les paramètres se répartissent sur trois onglets, Général, Notes et Avancé ; cliquez sur un onglet, ou passez de l’un à l’autre avec Ctrl+Tab et Ctrl+Maj+Tab. Cliquez sur OK pour appliquer vos changements — ils prennent effet immédiatement, sans redémarrer PlanCake — ou sur Annuler (Échap) pour les abandonner.

Général

Langue de l’interface

La langue des menus, des boîtes de dialogue et des messages : anglais, Русский (russe), Українська (ukrainien), français, עברית (hébreu) ou Deutsch (allemand). Langue du système, la valeur par défaut, suit la langue de Windows, et utilise l’anglais si Windows est dans une langue que PlanCake ne possède pas. En hébreu, toute la fenêtre est disposée de droite à gauche. Vous pouvez aussi la changer depuis Langue de l’interface dans le menu Affichage. Ce paramètre ne change pas la langue du document.

Langue du document

La langue dans laquelle PlanCake suppose qu’un document nouvellement ouvert est rédigé. Par défaut : anglais. Elle ne suit jamais la langue de l’interface ni celle de Windows. Voir La langue du document.

Quand le fichier change sur le disque

Le recharger (par défaut) recharge le fichier dès qu’autre chose le modifie. Demander avant de le recharger vous le demande d’abord. Voir Quand le fichier change en dehors de PlanCake.

Demander avant de supprimer une note

Activé par défaut. Désactivez-le pour supprimer des notes individuelles sans question. Supprimer toutes les notes demande toujours confirmation.

Demander avant de cocher ou de décocher une tâche

Activé par défaut. Désactivez-le pour cocher les tâches d’un simple clic ou d’une simple pression de touche.

Afficher la liste des notes

Activé par défaut. Désactivez-le pour masquer la liste des notes dans cette fenêtre comme dans toutes les autres. C’est le même réglage que Liste des notes dans le menu Affichage : modifier l’un modifie l’autre.

Rechercher les mises à jour au démarrage

Activé par défaut. PlanCake vérifie une fois à son démarrage et reste silencieux à moins qu’une nouvelle version existe.

Rechercher les mises à jour en arrière-plan

La fréquence à laquelle PlanCake vérifie de nouveau pendant qu’il continue de s’exécuter : Une fois par jour, Tous les 3 jours, Une fois par semaine (par défaut), Une fois par mois ou Jamais. Jamais ne désactive que ces vérifications répétées, pas celle du démarrage.

Notes

Marqueur d’ouverture

Le texte par lequel une note commence dans le fichier. Par défaut : [usernote]. Il ne peut être vide, ne peut ni commencer ni se terminer par une espace ou un guillemet double, et ne peut contenir de saut de ligne.

Marqueur de fermeture (laisser vide pour un marqueur unique qui s’étend jusqu’à la fin de la ligne)

Le texte par lequel une note se termine. Par défaut : [/usernote]. Il suit les mêmes règles et doit être différent du marqueur d’ouverture. Si vous le laissez vide, une note s’étend du marqueur d’ouverture jusqu’à la fin de sa ligne ; les notes ne font alors toujours qu’une seule ligne, et tout saut de ligne que vous tapez dans une note devient une espace. Si les marqueurs enfreignent l’une de ces règles, la ligne en dessous en donne la raison, précédée de « Erreur : », et un lecteur d’écran la lit dès que vous faites une pause dans la saisie.

Entrée ou clic sur un bloc

Ajoute une note (par défaut) ouvre la boîte de dialogue Ajouter une note. Ouvre le menu contextuel affiche à la place le menu du bloc, où vous choisissez Ajouter une note ou Copier le texte du bloc ; choisissez cette option si vous vous surprenez à ajouter des notes par accident. Un clic ou Entrée sur une note existante l’ouvre toujours pour la modifier, et un clic droit, la touche Applications et Maj+F10 ouvrent toujours le menu.

Entrée dans la boîte de dialogue de note (Ctrl+Entrée fait l’inverse)

Enregistre la note est le réglage par défaut. Commence une nouvelle ligne convient aux notes longues à plusieurs paragraphes. Quel que soit votre choix, Ctrl+Entrée fait l’autre action.

Avancé

Convertir en UTF-8 à l’ouverture

Désactivé par défaut, de sorte que les fichiers dans d’anciens encodages s’ouvrent en lecture seule et ne sont jamais modifiés. Activez-le pour que PlanCake convertisse à son ouverture un fichier qui n’est pas en UTF-8 en UTF-8 sans marque d’ordre des octets (BOM), afin que vous puissiez y ajouter des notes. La conversion réécrit le fichier sur le disque. Un fichier dont PlanCake ne peut pas reconnaître l’encodage n’est jamais converti. Voir Les fichiers qui ne sont pas en UTF-8.

Travailler depuis la ligne de commande

PlanCake peut aussi fonctionner sans fenêtre. Quatre commandes permettent de lire les notes d’un fichier, de vérifier s’il en reste, de toutes les supprimer, ou d’exporter le fichier en HTML. Elles sont conçues pour les scripts et pour les assistants IA : Claude les utilise pour lire vos notes sur un plan et confirmer qu’elles ont toutes été traitées.

Chaque commande suit le même modèle :

plancake <command> <file> [options]

Tapez plancake --help pour la liste des commandes, ou plancake list --help pour les options d’une commande. La sortie est en UTF-8 sans marque d’ordre des octets. Les erreurs vont vers la sortie d’erreur, avec le code de sortie 1. Une commande mal tapée, comme plancake chek, est aussi une erreur (« Commande non reconnue : chek. Vouliez-vous dire check ? ») : aucune fenêtre ne s’ouvre alors sur un fichier qui n’existe pas.

Les commandes list, check et export ne modifient jamais votre fichier Markdown. Seule clear le fait.

Lister les notes

plancake list plan.md

Cela affiche une ligne par note : les lignes de la note, les lignes du bloc qu’elle suit, le début de ce bloc, et la note elle-même. Les lignes sont numérotées à partir de 1, comme dans un éditeur de texte. Les sauts de ligne à l’intérieur d’une note sont représentés par une barre oblique.

43-43 after 41-42 "Back up the database before you run the migration.": Also back up the uploads folder.

Une note placée avant le premier bloc du fichier ne suit aucun bloc, et sa ligne l’indique :

1-1 at the start: Read the whole plan before you start.

Ce format est destiné aux scripts, ses mots fixes et sa ponctuation — « after », « at the start », le tiret, les guillemets — restent donc en anglais quelle que soit votre langue d’interface.

Ajoutez --json pour du JSON : une liste d’objets avec les champs noteStartLine, noteEndLine, blockStartLine, blockEndLine, blockKind, blockExcerpt et text. Les lignes sont numérotées à partir de 1. Le champ blockKind vaut paragraph, heading, listItem, code, tableRow, ou start pour une note placée avant le premier bloc, dont blockStartLine et blockEndLine valent null et dont blockExcerpt est vide. Ajoutez -o (ou --output) suivi d’un nom de fichier pour écrire le résultat dans un fichier plutôt qu’à l’écran :

plancake list plan.md --json -o notes.json

Exporter les notes dans le menu Fichier enregistre le même JSON depuis la fenêtre.

Vérifier s’il reste des notes

plancake check plan.md

Cela affiche le nombre de notes, tel que 2 notes, et se termine avec le code de sortie 0 s’il n’y en a aucune, 3 s’il y en a, et 1 si le fichier n’a pas pu être lu. Un script peut ainsi distinguer les trois cas : terminé, notes encore ouvertes, quelque chose s’est mal passé.

Supprimer toutes les notes

plancake clear plan.md

Cela supprime toutes les notes du fichier et affiche combien il en a supprimé, par exemple 2 notes supprimées. Pour un fichier dans un ancien encodage, clear suit le paramètre de conversion : quand la conversion est désactivée, ou que l’encodage ne peut pas être reconnu, il refuse de modifier un fichier qui contient des notes et explique pourquoi. Ajoutez --convert pour convertir un tel fichier en UTF-8 pour cette exécution, quel que soit le paramètre ; un fichier dont l’encodage ne peut pas être reconnu n’est toujours jamais modifié.

plancake clear old-plan.md --convert

Exporter en HTML

plancake export plan.md -o plan.html

Cela écrit une page web autonome du document avec ses notes clairement signalées, à partager avec quelqu’un qui n’utilise pas PlanCake. La page intègre ses styles et ne contient aucun script. L’option -o est obligatoire. La langue de la page est la Langue du document définie dans les paramètres ; pour en utiliser une autre, ajoutez --lang suivi d’un code de langue, tel que --lang fr. Le titre de la page est le premier titre du document, ou le nom du fichier s’il n’en a aucun. Les images qui sont des fichiers de votre ordinateur, comme ![Schéma](diagram.png) à côté du plan, sont intégrées à la page, qui les affiche donc où qu’on l’ouvre ; une image de plus de 10 Mo, ou sur le partage réseau d’un autre ordinateur, ne l’est pas. Les images venant du web restent des liens vers le web.

Utiliser d’autres marqueurs pour une seule exécution

Par défaut, les commandes utilisent les marqueurs des paramètres. Pour en utiliser d’autres pour une seule exécution, ajoutez :

--open-marker <text>

Le marqueur par lequel une note commence.

--close-marker <text>

Le marqueur par lequel une note se termine.

--single-token

Les notes n’ont pas de marqueur de fermeture et se terminent avec leur ligne. Cela ne peut pas être combiné avec --close-marker.

plancake check plan.md --open-marker "!NOTE!" --single-token

PowerShell et l’invite de commandes n’attendent pas

PlanCake est un programme Windows avec une fenêtre, et un PowerShell ou une invite de commandes interactifs n’attendent pas la fin de tels programmes. Quand vous tapez une commande à l’invite, celle-ci peut réapparaître avant que la sortie ne s’affiche ; la sortie apparaît alors en dessous. Elle est complète — simplement en retard.

La sortie redirigée par un tube ou capturée est toujours complète, car le shell l’attend. C’est le cas dans bash, quand vous la redirigez vers une autre commande, et dans les propres appels d’outils de Claude.

Dans les scripts PowerShell, il y a un piège : affecter la sortie à une variable n’est pas la rediriger par un tube. $notes = plancake list plan.md n’attend pas, et laisse $LASTEXITCODE vide. Redirigez plutôt la commande par un tube, ou exécutez-la via cmd :

$notes = plancake list plan.md | Out-String
plancake check plan.md | Out-Host
$LASTEXITCODE

cmd /c "plancake check plan.md"

Relire un plan avec Claude

Voici comment les éléments s’articulent quand Claude rédige un plan et vous demande de le relire. Vous ouvrez le plan avec pk plan.md, vous le lisez, et vous laissez des notes partout où vous n’êtes pas d’accord ou souhaitez des changements. Quand vous dites à Claude que vous avez terminé, il exécute plancake list plan.md --json pour lire vos notes avec les blocs exacts auxquels elles se rapportent, retravaille le plan, et supprime les notes qu’il a traitées. plancake check plan.md confirme qu’il n’en reste aucune.

Si vous utilisez les plugins Debussy pour Claude Code, leur étape de relecture manuelle lit les notes marquées avec les marqueurs du paramètre noteMarkers de Debussy, où une paire de marqueurs s’écrit open...close. Les marqueurs par défaut de PlanCake, [usernote] et [/usernote], correspondent déjà à cette convention. Voir la documentation de Debussy pour savoir comment la configurer ; son code source est sur GitHub.

Référence clavier et souris

Ces raccourcis sont fixes ; ils ne peuvent pas être modifiés. Vous pouvez aussi tous les consulter dans PlanCake lui-même : choisissez Raccourcis clavier dans le menu Aide.

N’importe où dans la fenêtre

Dans le document

Dans la liste des notes

Dans la boîte de dialogue de note

Si vous réglez Entrée dans la boîte de dialogue de note sur Commence une nouvelle ligne, Entrée et Ctrl+Entrée échangent leurs rôles.

Référence des menus

Cliquez sur un nom de menu, appuyez sur Alt ou F10 pour atteindre la barre de menus, ou ouvrez un menu directement : Alt+F pour Fichier, Alt+D pour Édition, Alt+A pour Affichage, Alt+N pour Notes, Alt+E pour Aide. Les commandes qui ne s’appliquent pas pour le moment — Annuler sans rien à annuler, Note suivante dans un fichier sans notes — sont indisponibles.

Fichier

Édition

Affichage

Notes

Aide

Menus contextuels

Ouvrez un menu contextuel par un clic droit, ou avec la touche Applications ou Maj+F10.

Garder PlanCake à jour

PlanCake recherche de nouvelles versions à son démarrage puis une fois par semaine, et reste discret sauf s’il en trouve une. Quand une nouvelle version existe, une fenêtre la décrit et propose de l’installer ; vous pouvez aussi ignorer cette version ou être rappelé plus tard. Vous pouvez changer la fréquence des vérifications de PlanCake, ou les désactiver, dans les paramètres généraux.

Si vous avez plusieurs plans ouverts, une seule fenêtre effectue ces vérifications automatiques, afin que la même mise à jour ne vous soit pas proposée plusieurs fois.

Pour vérifier immédiatement, choisissez Vérifier les mises à jour dans le menu Aide. PlanCake vous indique le résultat, par exemple « PlanCake est à jour. »

Vos données et votre confidentialité

Vos notes sont dans vos fichiers

PlanCake n’a ni base de données ni fichiers cachés pour vos notes : chaque note est du texte brut à l’intérieur du fichier Markdown auquel elle appartient. Tout ce qui sauvegarde vos fichiers — contrôle de version, synchronisation dans le cloud, copie sur une clé USB — sauvegarde vos notes avec eux. Pour donner vos notes à quelqu’un, donnez-lui le fichier.

Paramètres et journaux

Vos paramètres se trouvent dans un seul fichier texte, PlanCake.cfg :

• Avec le programme d’installation : %APPDATA%\Oire\PlanCake\PlanCake.cfg
• Portable : userdata\PlanCake.cfg, à côté de plancake.exe

Pour emporter vos paramètres sur un autre ordinateur, copiez ce fichier au même endroit là-bas. Ce même dossier contient un dossier logs, qui enregistre ce qu’a fait PlanCake et aide quand vous signalez un problème. Les fichiers de travail de l’affichage du document sont conservés dans %LOCALAPPDATA%\Oire\PlanCake avec l’installateur, et dans ce même dossier userdata dans la version portable. Supprimer ces dossiers réinitialise PlanCake à ses valeurs par défaut et ne touche jamais à vos fichiers Markdown ni aux notes qu’ils contiennent.

Ce qui transite sur le réseau

PlanCake ne se connecte à internet que pour deux choses : télécharger un fichier quand vous en ouvrez un depuis un lien, et vérifier les mises à jour. Il n’envoie aucune donnée d’utilisation où que ce soit.

Dépannage