PlanCake

Willkommen bei PlanCake

Mit PlanCake können Sie Markdown-Dateien bequem lesen und Notizen genau dort hinterlassen, wo sie hingehören. PlanCake zeigt eine Datei so an, wie sie gelesen werden soll: echte Überschriften, Listen, Tabellen und Codeblöcke statt Rautezeichen und Sternchen. Es wurde für die langen Implementierungspläne entwickelt, die KI-Programmierassistenten schreiben – oft 800 Zeilen und mehr –, funktioniert aber mit jeder Markdown-Datei.

Lesen ist die eine Hälfte des Überprüfens. Die andere Hälfte ist zu sagen, was Sie denken: „Dieser Schritt ist falsch“, „Das hier zuerst machen“. In PlanCake klicken Sie den Absatz, das Listenelement, die Überschrift, die Tabellenzeile oder den Codeblock an, den Sie kommentieren möchten, oder drücken Eingabe darauf, und tippen Ihre Notiz. PlanCake schreibt sie direkt in die Markdown-Datei, gleich nach diesem Block, zwischen ein Markierungspaar. Sie müssen nie Zeilen zählen oder herausfinden, wohin die Notiz gehört – PlanCake weiß, aus welchen Zeilen der Datei jeder Block stammt. Wer die Datei als Nächstes liest, ob Kollege oder KI-Assistent wie Claude, findet Ihre Notizen genau dort, wo sie hingehören.

Ein paar Dinge vorab: PlanCake ist kein Texteditor: Abgesehen von Ihren Notizen und den Kontrollkästchen von Aufgabenlisten ändert es niemals den Text eines Dokuments. Es gibt nichts zu speichern – jede Notiz steht in der Datei, sobald Sie sie bestätigen. PlanCake läuft unter Windows 10 und 11 (64-Bit), und alles darin funktioniert gleich gut mit der Maus, allein über die Tastatur und mit einem Screenreader.

Schnellstart

1. Öffnen Sie einen Plan: Starten Sie PlanCake über das Startmenü und ziehen Sie eine Markdown-Datei auf sein Fenster, oder drücken Sie Strg+O und wählen Sie die Datei aus. In einer Eingabeaufforderung erreicht plancake plan.md dasselbe.
2. Lesen Sie es. Überschriften, Listen, Tabellen und Code werden formatiert angezeigt; scrollen Sie mit dem Mausrad oder den Pfeil- und Bildlauftasten.
3. Wenn Sie etwas erreichen, das Sie kommentieren möchten, klicken Sie es an. Von der Tastatur aus drücken Sie Alt+Umschalt+Nach-unten oder Alt+Umschalt+Nach-oben, um sich von Block zu Block zu bewegen, bis er umrandet ist, und drücken dann Eingabe. Der Dialog Notiz hinzufügen öffnet sich mit dem Cursor im Notizfeld.
4. Tippen Sie Ihre Notiz und drücken Sie Eingabe, oder klicken Sie auf OK. Die Notiz erscheint direkt nach dem Block, und die Statusleiste zeigt „Notiz hinzugefügt“. Sie steht bereits in der Datei.
5. Lesen und notieren Sie weiter. Wenn Sie fertig sind, schließen Sie das Fenster – es gibt nichts zu speichern.

PlanCake installieren

PlanCake gibt es in zwei Formen: als Installationsprogramm, das alles für Sie einrichtet, und als portable Version, die aus jedem Ordner läuft, auch von einem USB-Stick. Beide funktionieren im laufenden Betrieb gleich; sie unterscheiden sich nur darin, wo PlanCake seine Einstellungen ablegt. Laden Sie eine der beiden Versionen von der PlanCake-Website herunter.

Mit dem Installationsprogramm

Führen Sie das Installationsprogramm aus und folgen Sie den Schritten. Neben PlanCake selbst kümmert es sich auch darum, was PlanCake zum Laufen braucht: Es installiert die .NET 10 Desktop Runtime und die Microsoft Edge WebView2 Runtime, falls Ihr Computer sie noch nicht hat. Außerdem fügt es PlanCake zu Ihrem PATH hinzu, sodass der Befehl plancake in jedem neuen PowerShell- oder Eingabeaufforderungsfenster funktioniert.

Ihre Einstellungen werden unter %APPDATA%\Oire\PlanCake gespeichert.

Das Installationsprogramm fügt PlanCake dem Startmenü hinzu, zusammen mit einer Verknüpfung zu diesem Handbuch in der Sprache, die Sie für die Installation gewählt haben.

PlanCake ist nicht mit einem Codesignaturzertifikat signiert. Wenn Sie das Installationsprogramm oder plancake.exe aus dem portablen ZIP-Archiv zum ersten Mal ausführen, kann Windows SmartScreen „Der Computer wurde durch Windows geschützt“ und einen unbekannten Herausgeber anzeigen. Um fortzufahren, wählen Sie Weitere Informationen und dann Trotzdem ausführen.

Die portable Version

Entpacken Sie die ZIP-Datei in einen beliebigen Ordner und führen Sie plancake.exe von dort aus. Die ZIP-Datei enthält einen leeren Ordner namens userdata neben plancake.exe; solange dieser Ordner vorhanden ist, bewahrt PlanCake seine Einstellungen darin auf und schreibt nichts in Ihr Benutzerprofil. Löschen oder benennen Sie den Ordner userdata um, verwendet PlanCake wieder %APPDATA%\Oire\PlanCake.

Die portable Version installiert nichts, daher benötigt Ihr Computer bereits die .NET 10 Desktop Runtime und die Microsoft Edge WebView2 Runtime. Windows 11 bringt WebView2 bereits mit; fehlt es, sagt PlanCake Ihnen das beim Start und bietet an, die Download-Seite zu öffnen.

Um den Befehl plancake mit der portablen Version zu verwenden, geben Sie entweder seinen vollständigen Pfad ein oder fügen Sie seinen Ordner selbst zu Ihrem PATH hinzu.

PlanCake deinstallieren

Deinstallieren Sie PlanCake unter Apps in den Windows-Einstellungen oder mit PlanCake entfernen im Startmenü. Das Deinstallationsprogramm nimmt PlanCake aus Ihrem PATH und fragt, ob auch Ihre Einstellungen und Protokolle entfernt werden sollen; Ihre Markdown-Dateien und die Notizen darin bleiben immer unberührt. Die portable Version installiert nichts: Um sie zu entfernen, löschen Sie ihren Ordner.

Wenn Sie mit einem Standardkonto von Windows arbeiten und ein Administrator sein Kennwort eingibt, um die Deinstallation zu erlauben, läuft das Deinstallationsprogramm als dieser Administrator und sucht dessen Einstellungen, nicht Ihre, und fragt deshalb nicht danach. Ihre Einstellungen und Protokolle bleiben dann in %APPDATA%\Oire\PlanCake und %LOCALAPPDATA%\Oire\PlanCake; löschen Sie diese Ordner selbst, wenn Sie sie nicht mehr brauchen.

Ein kürzerer Befehl: pk

Wenn Sie den ganzen Tag Pläne über die Befehlszeile öffnen, können Sie PlanCake einen zweibuchstabigen Namen geben. PlanCake richtet das nicht für Sie ein; es ist eine einzige Zeile in Ihrem eigenen Shell-Profil.

• Fügen Sie in PowerShell diese Zeile zu Ihrem Profil hinzu (die Datei, deren Pfad $PROFILE enthält):

  Set-Alias pk plancake

• Fügen Sie in bash diese Zeile zu Ihrer .bashrc hinzu:

  alias pk=plancake

Danach öffnet pk plan.md einen Plan, und jeder Befehl unter Über die Befehlszeile arbeiten funktioniert mit pk anstelle von plancake.

Das Hauptfenster

Das Fenster hat oben eine Menüleiste, links das Dokument, rechts die Notizliste und ganz unten eine Statusleiste. Die Titelleiste zeigt den Namen der geöffneten Datei, zum Beispiel plan.md - PlanCake.

Um dem Dokument oder der Notizliste mehr Platz zu geben, ziehen Sie die Trennlinie zwischen ihnen. Über die Tastatur wählen Sie Notizliste verbreitern oder Notizliste verschmälern im Menü Ansicht: Jeder Befehl verschiebt die Trennlinie um ein Zehntel der Breite, die sich beide teilen, auf eine runde Zahl – aus 32 Prozent wird die Liste zum Beispiel 40 Prozent breit, oder 30 Prozent. Die Statusleiste nennt den neuen Anteil, etwa „Notizliste 40 %“. Keine Seite kann wegschrumpfen: Die Liste bleibt mindestens etwa 150 Pixel breit und das Dokument etwa 200. An dieser Grenze bleibt die Trennlinie stehen, und die Statusleiste wiederholt den aktuellen Anteil. Beide Befehle sind nicht verfügbar, während die Notizliste ausgeblendet ist.

PlanCake merkt sich Größe und Position des Fensters, ob es maximiert war, die Breite der Notizliste und den Zoom: Das nächste Fenster öffnet sich genauso, auf einem Bildschirm, der noch angeschlossen ist. Das allererste Fenster passt sich an den Bildschirm an, auf dem es sich öffnet.

Das Dokument

Das ist Ihre Markdown-Datei, formatiert. Wenn PlanCake eine Datei öffnet, beginnt es ganz oben. Auch Ihre Notizen erscheinen im Dokument, jeweils direkt nach dem Block, zu dem sie gehören, und optisch vom Text des Plans abgesetzt, damit Sie auf einen Blick sehen, was von Ihnen stammt.

Die Notizliste

Die Notizliste versammelt jede Notiz der Datei an einem Ort, in der Reihenfolge, in der sie vorkommen. Sie hat drei Spalten:

Notiz

Der erste Satz der Notiz in einer Zeile, ohne Markdown-Zeichensetzung. Die Spalte nimmt die ganze Breite ein, die die beiden anderen lassen. Lassen Sie den Mauszeiger auf einer Zeile ruhen, um die ganze Notiz zu sehen.

Zeilen

Wo die Notiz in der Datei steht: 12 für eine einzeilige Notiz, 12-14 für eine längere.

Block

Der erste Satz des Blocks, auf den die Notiz folgt, damit Sie wissen, worum es geht, ohne dorthin zu gehen. In beiden Spalten wird ein sehr langer Satz nach Möglichkeit an einem Komma, Doppelpunkt oder Gedankenstrich gekürzt.

Um im Dokument zu einer Notiz zu springen, drücken Sie Eingabe auf ihrer Zeile oder doppelklicken Sie sie; der Fokus springt zur Notiz. Um eine Notiz zu löschen, wählen Sie sie aus und drücken Entf; die Auswahl springt dann zur nächstgelegenen verbleibenden Notiz, sodass Sie Ihre Stelle in der Liste nie verlieren. Klicken Sie eine Zeile mit der rechten Maustaste an, oder drücken Sie die Anwendungstaste oder Umschalt+F10, für ein Menü mit Notiz bearbeiten und Notiz löschen.

Wenn Sie lieber das ganze Fenster für das Dokument hätten, wählen Sie Notizliste im Menü Ansicht. Das blendet die Liste aus, und erneutes Wählen zeigt sie wieder; die Statusleiste zeigt „Notizliste ausgeblendet“ oder „Notizliste eingeblendet“. PlanCake merkt sich die Wahl: Es ist dieselbe Einstellung wie Notizliste anzeigen in den Einstellungen, sodass neue Fenster genauso öffnen und andere offene Fenster folgen, sobald Sie zu ihnen wechseln.

Zwischen Dokument und Notizliste wechseln

Klicken Sie, wo Sie arbeiten möchten, oder drücken Sie F6, um zwischen Dokument und Notizliste zu wechseln. Wenn die Liste keine Notizen enthält, zeigt die Statusleiste „Keine Notizen“.

Tab funktioniert ebenfalls: Drücken Sie Tab über den letzten Link oder das letzte Kontrollkästchen im Dokument hinaus, gelangen Sie in die Notizliste, und Umschalt+Tab vom ersten aus tut dasselbe. Von der Liste aus bringen Sie Tab und Umschalt+Tab zurück zum Dokument.

Wenn die Notizliste ausgeblendet ist, halten Sie sowohl F6 als auch Tab im Dokument. F6 bewegt den Fokus; es blendet eine ausgeblendete Liste nicht wieder ein. Verwenden Sie dafür Ansicht, Notizliste.

Statusmeldungen

Nichts, was PlanCake tut, geschieht stillschweigend. Jede Änderung – eine hinzugefügte Notiz, eine abgehakte Aufgabe, eine neu geladene Datei, ein abgeschlossener Download – wird durch eine kurze Meldung in der Statusleiste am unteren Rand des Fensters bestätigt, etwa „Notiz hinzugefügt“ oder „Datei neu geladen“. Die Meldung bleibt stehen, bis die nächste sie ersetzt.

Fragen, die PlanCake stellt

Wenn PlanCake Ihnen eine Ja-oder-Nein-Frage stellt – diese Notiz löschen? diese Aufgabe abhaken? diese Datei neu laden? –, beantwortet das Drücken von Esc sie mit Nein, ebenso wie das Schließen der Frage über deren Schließen-Schaltfläche. Sie können sich jederzeit zurückziehen, ohne etwas auszuwählen.

In den anderen Dialogen – Notiz hinzufügen, Einstellungen, Über Link öffnen – ist Esc die Schaltfläche Abbrechen: Sie schließt den Dialog und verwirft, was Sie eingegeben haben. Bei Tastenkombinationen und Über PlanCake schließt Esc sie einfach.

Einen Screenreader verwenden

PlanCake wurde mit Screenreadern im Blick entwickelt, und ein paar Details sind wissenswert, wenn Sie einen verwenden:

• Das Dokument ist eine Webseite, daher lesen Sie es mit den üblichen Web-Navigationstasten Ihres Screenreaders – nach Überschrift, Liste, Tabelle und so weiter. Um einen Block zu kommentieren, gehen Sie zu ihm und drücken Eingabe; Sie bleiben in Ihrem Lesemodus, an derselben Stelle. Nach dem Speichern landen Sie auf der neuen Notiz.
• Jede Statusmeldung wird gesprochen, wo immer sich Ihr Fokus befindet, sodass Sie „Notiz hinzugefügt“, „Keine weiteren Notizen“ oder „Datei neu geladen“ hören, ohne nach der Statusleiste zu suchen. Wenn Sie eine verpassen, liest der Befehl Ihres Screenreaders zum Lesen der Statusleiste oder zum Wiederholen der letzten Meldung sie erneut vor.
• Jede Notiz im Dokument ist eine Region mit dem Namen „Benutzernotiz“, damit Sie sie vom eigentlichen Text des Plans unterscheiden können.
• Die Einstellung Dokumentsprache teilt Ihrem Screenreader mit, mit welcher Stimme er den Plan lesen soll, unabhängig von der Oberflächensprache: Ein englischer Plan wird mit einer englischen Stimme gelesen, selbst wenn Windows und PlanCake auf Deutsch eingestellt sind.
• Wenn die Datei nach einer Änderung von außen neu geladen wird, wird die Seite an Ort und Stelle aktualisiert, sodass Ihre Leseposition erhalten bleibt.
• Strg+A markiert absichtlich nicht das gesamte Dokument: Das Markieren von Text bleibt den eigenen Befehlen Ihres Screenreaders überlassen.

Eine Datei öffnen

Pläne erreichen Sie auf viele Arten: eine Datei auf der Festplatte, ein Pfad, den jemand in einen Chat eingefügt hat, ein Link zu GitHub. PlanCake kann alle davon direkt öffnen, ohne dass Sie zuvor etwas speichern müssen. Auf welche Weise auch immer Sie vorgehen, eine neu geöffnete Datei beginnt immer ganz oben.

Wenn keine Datei geöffnet ist, zählt das Fenster die Wege auf, eine zu öffnen, mit ihren Tasten. Eine große Datei kann einen Moment zum Öffnen brauchen: Dauert es länger als eine halbe Sekunde oder ist die Datei größer als 1 MB, zeigt PlanCake den Dialog Datei wird geöffnet mit einer Fortschrittsanzeige. Drücken Sie Esc oder klicken Sie auf Abbrechen, um das Öffnen abzubrechen; die zuvor geöffnete Datei bleibt, wie sie war.

Über die Befehlszeile

Geben Sie plancake gefolgt von der Datei ein:

plancake docs\plans\001-plan.md

Ein Fenster öffnet sich mit dieser Datei. Geben Sie nur plancake ein für ein leeres Fenster. Sie können auch eine Markdown-Datei auf plancake.exe oder eine Verknüpfung dazu ziehen.

Über den Öffnen-Dialog oder per Ziehen

Ziehen Sie eine Markdown-Datei aus dem Datei-Explorer und legen Sie sie auf dem PlanCake-Fenster ab. Oder drücken Sie Strg+O, oder wählen Sie Öffnen im Menü Datei: Der standardmäßige Windows-Öffnen-Dialog zeigt Markdown-Dateien (.md und .markdown); wechseln Sie den Dateityp zu Alle Dateien, um alles zu sehen.

Aus der Zwischenablage

Drücken Sie Strg+V im PlanCake-Fenster, oder wählen Sie Aus der Zwischenablage öffnen im Menü Datei. PlanCake sieht sich an, was Sie kopiert haben:

• Eine im Datei-Explorer kopierte Datei: PlanCake öffnet sie. Haben Sie mehrere kopiert, öffnet es die erste Markdown-Datei darunter.
• Ein als Text kopierter Pfad, mit oder ohne Anführungszeichen (die Funktion Als Pfad kopieren des Datei-Explorers fügt sie hinzu): PlanCake öffnet diese Datei.
• Ein Weblink, der mit http:// oder https:// beginnt: PlanCake lädt die Datei herunter und öffnet sie, wie im nächsten Abschnitt beschrieben.

Enthält die Zwischenablage etwas anderes, zeigt die Statusleiste „Die Zwischenablage enthält weder eine Markdown-Datei noch einen Link.“

Über einen Link im Web

Angenommen, ein Kollege schickt Ihnen einen Link zu einem Plan auf GitHub. Drücken Sie Strg+L, oder wählen Sie Über Link öffnen im Menü Datei. Das Feld Link ist bereits ausgefüllt, wenn die Zwischenablage einen Link enthält; andernfalls fügen Sie ihn ein oder tippen ihn. Drücken Sie Eingabe oder klicken Sie auf OK, um herunterzuladen; drücken Sie Esc oder klicken Sie auf Abbrechen, um abzubrechen.

Die Statusleiste zeigt „Download von github.com...“ und, wenn der Download abgeschlossen ist, wo die Datei gespeichert wurde; dann öffnet sich der Plan. Downloads landen in Ihrem Ordner Downloads unter dem eigenen Namen der Datei, immer als Markdown-Datei: Ein Link zu einer Datei anderen Typs bekommt .md angehängt, sodass tool.bat als tool.bat.md gespeichert wird und nie ausgeführt werden kann. Wie ein Browser kennzeichnet PlanCake die Datei als aus dem Internet heruntergeladen; existiert dort bereits eine Datei mit diesem Namen, fügt PlanCake eine Zahl hinzu, etwa plan (2).md, so wie es ein Browser tut. Da die heruntergeladene Datei eine gewöhnliche Datei auf Ihrer Festplatte ist, werden Ihre Notizen darin gespeichert wie in jeder anderen.

Ein paar Dinge zu Links:

• Sie können einen normalen GitHub-Seitenlink zu einer Datei einfügen; PlanCake ruft das rohe Markdown dahinter ab.
• Ein Link zu einer gewöhnlichen Webseite statt zu einer Markdown-Datei wird abgelehnt: „Dieser Link führt zu einer Webseite, nicht zu einer Markdown-Datei.“
• Ein Download bricht nach 30 Sekunden ab, und Dateien, die größer als 10 MB sind, werden nicht heruntergeladen.

Ein Fenster pro Datei

Jede Datei bekommt ihr eigenes Fenster, und eine Datei ist nie in zwei Fenstern gleichzeitig geöffnet. Öffnen Sie eine Datei, die bereits in einem anderen PlanCake-Fenster geöffnet ist – über die Befehlszeile, die Zwischenablage, egal wo –, holt PlanCake dieses Fenster in den Vordergrund, statt ein zweites zu öffnen. So können zwei Fenster nie widersprüchliche Notizen in dieselbe Datei schreiben.

Ein Dokument lesen

Sich im Dokument bewegen

Scrollen Sie mit dem Mausrad oder der Bildlaufleiste, oder verwenden Sie die Pfeiltasten, Bild-auf, Bild-ab, Pos1 und Ende. Tab bewegt sich von Link zu Link und von Kontrollkästchen zu Kontrollkästchen. Markieren Sie Text mit der Maus und kopieren Sie ihn mit Strg+C wie in jedem anderen Programm; wenn Sie das Markieren beenden, öffnet sich nie der Notizdialog.

Um von der Tastatur aus an einem bestimmten Block zu arbeiten – einem Absatz, einer Überschrift, einem Listenelement, einer Tabellenzeile, einem Codeblock oder einer Notiz –, drücken Sie Alt+Umschalt+Nach-unten für den nächsten Block und Alt+Umschalt+Nach-oben für den vorherigen, oder wählen Sie Nächster Block und Vorheriger Block im Menü Notizen. Der Block erhält einen Rahmen und wird in den sichtbaren Bereich gescrollt. Drücken Sie Eingabe, um ihm eine Notiz hinzuzufügen (oder sie zu bearbeiten, falls es eine Notiz ist), oder die Anwendungstaste für sein Menü. Am Anfang oder Ende des Dokuments zeigt die Statusleiste „Keine weiteren Blöcke“.

Die Bewegung beginnt beim Block oder der Notiz, mit der Sie zuletzt gearbeitet oder zu der Sie zuletzt gewechselt haben. Gibt es noch keine, geht Alt+Umschalt+Nach-unten zum ersten sichtbaren Block und Alt+Umschalt+Nach-oben zum letzten. In der Notizliste bewegen diese Tasten zu einem Block im Dokument und setzen Sie dort ab.

Links folgen, zurückgehen

Klicken Sie einen Link an, oder drücken Sie Eingabe darauf, und PlanCake tut, was für sein Ziel sinnvoll ist:

• Ein Weblink öffnet sich in Ihrem Standardbrowser.
• Ein Link zu einer anderen Markdown-Datei neben dieser öffnet diese Datei in PlanCake, im selben Fenster.
• Ein Link zu einem Ordner öffnet ihn im Datei-Explorer, und ein Link zu einer Textdatei, einer PDF-Datei oder einem Bild öffnet sie mit dem Programm, das Windows dafür verwendet. Jede andere Datei (ein Programm, ein Skript wie .bat, .js oder .py oder jeder andere Typ, dessen Öffnen etwas ausführen könnte) wird nie über einen Link geöffnet, was auch immer sein Text sagt: PlanCake fragt stattdessen, ob die Datei im Datei-Explorer angezeigt werden soll. Einem Link zu einer Datei auf der Netzwerkfreigabe eines anderen Computers folgt PlanCake nicht.
• Ein Link zu einer Überschrift im selben Dokument bringt Sie zu dieser Überschrift.
• Zeigt ein Link auf eine Datei, die nicht existiert, sagt die Statusleiste das und zeigt den Pfad.

PlanCake merkt sich die Dateien, die Sie in einem Fenster geöffnet haben, und wo Sie in jeder davon waren, wie den Verlauf eines Browsers. Drücken Sie Alt+Nach-links oder Rücktaste, oder wählen Sie Zurück im Menü Ansicht, um zur vorherigen Datei zurückzugehen, genau an der Stelle, an der Sie sie verlassen haben. Alt+Nach-rechts oder Vorwärts geht wieder vorwärts. An den Enden des Verlaufs zeigt die Statusleiste „Keine vorherige Datei“ oder „Keine nächste Datei“. Wurde eine Datei im Verlauf inzwischen gelöscht, sagt PlanCake das und überspringt sie.

Eine Datei auf jede andere Weise zu öffnen – mit Strg+O, per Ziehen, aus der Zwischenablage, über einen Link – fügt sie ebenfalls zum Verlauf hinzu, sodass Zurück Sie immer zu dem zurückbringt, was Sie zuvor gelesen haben.

Zoomen

Um den Text größer zu machen, drücken Sie Strg+Plus; um ihn kleiner zu machen, drücken Sie Strg+Minus. Die Tasten auf dem Ziffernblock funktionieren ebenfalls, ebenso wie Vergrößern und Verkleinern im Menü Ansicht. Jeder Schritt ändert die Größe um 10 Prozent, zwischen 50 und 300 Prozent, und die Statusleiste zeigt die neue Größe, zum Beispiel „Zoom 120 %“. Drücken Sie Strg+0, um zu 100 Prozent zurückzukehren. Das nächste Fenster, das Sie öffnen, beginnt mit demselben Zoom.

Die Sprache des Dokuments

PlanCake hält zwei Sprachen auseinander: die Sprache seiner Menüs und Dialoge, und die Sprache, in der das Dokument geschrieben ist. Die Oberfläche auf Französisch umzustellen macht einen englischen Plan nicht französisch. Die Dokumentsprache ist wichtig, wenn der Plan vorgelesen wird (siehe Einen Screenreader verwenden) und hilft PlanCake, alte Dateicodierungen zu erkennen (siehe Dateien, die nicht in UTF-8 vorliegen).

Neue Dokumente verwenden die Dokumentsprache aus den Einstellungen, standardmäßig Englisch, sofern Sie sie nicht ändern. Um für eine bestimmte Datei eine andere Sprache festzulegen, wählen Sie Dokumentsprache im Menü Ansicht und wählen Sie sie aus. Das gilt nur für die geöffnete Datei; die nächste Datei, die Sie öffnen, verwendet wieder die Sprache aus den Einstellungen.

Notizen hinterlassen

Eine Notiz hinzufügen

1. Klicken Sie den Absatz, die Überschrift, das Listenelement, die Tabellenzeile oder den Codeblock an, den Sie kommentieren möchten. Der Block unter dem Mauszeiger wird hervorgehoben, sodass Sie sehen, welchem Block ein Klick eine Notiz hinzufügt. Von der Tastatur aus bewegen Sie sich mit Alt+Umschalt+Nach-unten oder Alt+Umschalt+Nach-oben dorthin (siehe Sich im Dokument bewegen) und drücken Eingabe. Der Dialog Notiz hinzufügen öffnet sich. Er zeigt den Anfang des Blocks unter Notiz zu, damit Sie prüfen können, ob Sie den richtigen ausgewählt haben, und setzt den Cursor in das Feld Notiz.
2. Tippen Sie Ihre Notiz. Um darin eine neue Zeile zu beginnen, drücken Sie Strg+Eingabe.
3. Drücken Sie Eingabe oder klicken Sie auf OK, um zu speichern; drücken Sie Esc oder klicken Sie auf Abbrechen, um abzubrechen. OK bleibt nicht verfügbar, solange das Feld leer ist, und Eingabe sagt dann nur „Geben Sie zuerst eine Notiz ein.“

PlanCake schreibt die Notiz sofort in die Datei, direkt nach dem Block. Das Dokument aktualisiert sich, die Statusleiste zeigt „Notiz hinzugefügt“, und die neue Notiz steht dort, wo Sie sich gerade befinden. Sie erscheint auch in der Notizliste.

Ein einzelner Klick genügt; ein Doppelklick bewirkt nicht mehr als ein einzelner Klick. Das Markieren von Text mit der Maus öffnet den Dialog nicht, sodass Sie weiterhin wie gewohnt Text markieren und kopieren können.

Wenn Sie es bevorzugen, dass Eingabe eine neue Zeile beginnt und Strg+Eingabe speichert, ändern Sie Eingabetaste im Notizdialog in den Einstellungen. Möchten Sie, dass ein Klick oder Eingabe auf einen Block ein Menü öffnet statt des Dialogs – zum Beispiel, weil Sie oft klicken, um sich zu positionieren, und dabei aus Versehen Notizen hinzufügen –, ändern Sie Eingabetaste oder Mausklick auf einen Block. Beides ist unter Notizen-Einstellungen beschrieben.

Sie können eine Notiz auch über das Kontextmenü hinzufügen: Klicken Sie einen Block mit der rechten Maustaste an, oder drücken Sie die Anwendungstaste oder Umschalt+F10 darauf, und wählen Sie Notiz hinzufügen.

Eine Notiz bearbeiten

Klicken Sie die Notiz im Dokument an, oder bewegen Sie sich mit F9 oder Alt+Umschalt+Nach-unten dorthin und drücken Eingabe. Derselbe Dialog öffnet sich, betitelt Notiz bearbeiten und mit dem Text der Notiz gefüllt. Ändern Sie ihn und speichern Sie; die Statusleiste zeigt „Notiz bearbeitet“.

Sie können eine Notiz auch aus der Notizliste, über das Kontextmenü oder mit Notiz bearbeiten im Menü Notizen zur Bearbeitung öffnen.

Notizen löschen

Um eine einzelne Notiz zu löschen, wählen Sie sie in der Notizliste aus und drücken Entf. Oder klicken Sie die Notiz, im Dokument oder in der Liste, mit der rechten Maustaste an, oder drücken Sie die Anwendungstaste oder Umschalt+F10 darauf, und wählen Sie Notiz löschen. PlanCake fragt „Diese Notiz löschen?“ und zeigt ihren Text; klicken Sie auf Ja oder drücken Sie Eingabe. Die Statusleiste zeigt „Notiz gelöscht“. Möchten Sie lieber nicht jedes Mal gefragt werden, schalten Sie Vor dem Löschen einer Notiz fragen in den Einstellungen aus.

Um alle Notizen auf einmal aus der Datei zu entfernen – etwa, nachdem der Autor des Plans sich durch alle durchgearbeitet hat –, wählen Sie Alle Notizen löschen im Menü Bearbeiten. PlanCake fragt dabei immer zuerst, mit der Anzahl der Notizen, egal was die Einstellung sagt.

Von Notiz zu Notiz springen

Drücken Sie F9 für die nächste Notiz und Umschalt+F9 für die vorherige, oder verwenden Sie Nächste Notiz und Vorherige Notiz im Menü Notizen. Im Dokument bringt Sie das zur Notiz; in der Notizliste bewegt es die Auswahl. Nach der letzten Notiz oder vor der ersten zeigt die Statusleiste „Keine weiteren Notizen“.

Eine Änderung rückgängig machen

Drücken Sie Strg+Z zum Rückgängigmachen und Strg+Y zum Wiederholen, oder verwenden Sie Rückgängig und Wiederholen im Menü Bearbeiten. Das gilt für alles, was PlanCake schreibt: Notizen hinzufügen, bearbeiten und löschen, alle Notizen löschen sowie Aufgaben abhaken oder das Häkchen entfernen. Die Statusleiste sagt Ihnen, was rückgängig gemacht oder wiederholt wurde, zum Beispiel „Hinzufügen der Notiz rückgängig gemacht“ oder „Abhaken der Aufgabe wiederholt“, und „Nichts zum Rückgängigmachen“, wenn nichts mehr übrig ist.

Rückgängigmachen funktioniert nur, solange die Datei noch das enthält, was PlanCake zuletzt geschrieben hat. Hat sich die Datei seitdem anderweitig geändert, macht PlanCake das nicht über diese Änderung hinweg rückgängig; es meldet: „Die Datei hat sich geändert, daher gibt es nichts mehr rückgängig zu machen oder zu wiederholen.“

Formatierung innerhalb einer Notiz

Sie können in einer Notiz Markdown verwenden: Hervorhebungen, Inline-Code, Links, Listen, sogar einen Codeblock. Im Dokument wird die Notiz formatiert angezeigt, während die Datei genau das behält, was Sie eingegeben haben.

Zwei Ausnahmen halten die Struktur des Plans intakt. Eine Überschrift, die Sie in eine Notiz eintippen, wird als fetter Text angezeigt, nicht als echte Überschrift, damit sich Ihre Notizen nie mit den eigenen Überschriften des Plans vermischen. Und HTML-Tags, die Sie eintippen, werden als reiner Text angezeigt.

Eine Notiz darf ihre eigene Endmarkierung nicht enthalten, standardmäßig [/usernote], weil diese die Notiz vorzeitig beenden würde. Verwenden Sie eine einzelne Markierung ohne Endmarkierung (siehe Notizen-Einstellungen), darf eine Notiz diese Markierung nicht enthalten, weil sie eine zweite Notiz beginnen würde. Tippen Sie eine davon ein, hält PlanCake den Dialog offen und sagt Ihnen, warum.

Wie eine Notiz in der Datei aussieht

Notizen sind reiner Text in Ihrer Markdown-Datei, eingefasst von zwei Markierungen. Eine Notiz zu einem Absatz sieht so aus:

Back up the database before you run the migration.
[usernote]Also back up the uploads folder.[/usernote]

Wer die Datei in einem Texteditor öffnet, und jedes Tool, das sie liest, sieht Ihre Notizen. Sie können Notizen sogar von Hand in derselben Form schreiben, und PlanCake zeigt sie wie seine eigenen an. Um andere Markierungen zu verwenden, siehe Notizen-Einstellungen.

Markierungen in Code sind keine Notizen: zwischen Backticks, wie in `[usernote]`, oder in einem Codeblock. Auch Markierungen in rohem HTML sind keine Notizen: in einem HTML-Kommentar, <!-- … -->, oder in einem <pre>-, <script>-, <style>- oder <textarea>-Block, vom öffnenden bis zum schließenden Tag. Beginnt die Anfangsmarkierung selbst mit <!--, bleiben Markierungen in Kommentaren Notizen. Ein Plan oder Handbuch, das die Markierungen als Beispiel zeigt, behält sie unverändert, und weder das Fenster noch die Befehle rühren sie an. PlanCake selbst schreibt nie eine Notiz in Code: Eine Notiz zu einem Codeblock kommt in die Zeile danach.

Den Text eines Blocks kopieren

Um einen Absatz, ein Listenelement oder einen anderen Block ohne seine Markdown-Zeichensetzung zu kopieren, klicken Sie ihn mit der rechten Maustaste an, oder drücken Sie die Anwendungstaste oder Umschalt+F10 darauf, und wählen Sie Blocktext kopieren. Die Statusleiste zeigt „Blocktext kopiert“.

Aufgaben abhaken

Viele Pläne enthalten Checklisten – Zeilen wie - [ ] Write the tests in der Datei. PlanCake zeigt sie als echte Kontrollkästchen an, sodass Sie Schritte im Vorbeigehen abhaken können, ohne einen Editor zu öffnen.

1. Klicken Sie das Kontrollkästchen an, oder drücken Sie Leertaste oder Eingabe darauf.
2. PlanCake fragt „Diese Aufgabe als erledigt markieren? Die Datei auf dem Datenträger wird geändert.“ (oder „Diese Aufgabe als nicht erledigt markieren? Die Datei auf dem Datenträger wird geändert.“ für eine bereits abgehakte Aufgabe) und zeigt die Aufgabe. Klicken Sie auf Ja oder drücken Sie Eingabe. Antworten Sie mit Nein, bleibt das Kontrollkästchen genau, wie es war.
3. PlanCake schreibt [x] oder [ ] in diese eine Zeile der Datei. Sie bleiben auf dem Kontrollkästchen, und die Statusleiste zeigt „Aufgabe abgehakt“ oder „Häkchen der Aufgabe entfernt“.

Haken Sie Aufgaben oft ab und brauchen die Frage nicht, schalten Sie Vor dem Abhaken einer Aufgabe oder dem Entfernen des Häkchens fragen in den Einstellungen aus. Strg+Z macht ein Abhaken wie jede andere Änderung rückgängig.

Eine Aufgabe mit Unteraufgaben, von denen manche erledigt sind und manche nicht, wird als teilweise abgehakt angezeigt. Das ist nur eine Anzeige: Markdown kennt keinen dritten Zustand, daher wird dafür nichts geschrieben. Das Abhaken einer solchen Aufgabe markiert nur diese Aufgabe selbst als erledigt – die Zeilen ihrer Unteraufgaben werden nie angerührt.

Wenn sich die Datei außerhalb von PlanCake ändert

Ein Plan in Überprüfung steht selten still: Ein KI-Assistent aktualisiert ihn, ein Kollege bearbeitet ihn, die Versionsverwaltung bringt eine neue Revision. PlanCake bemerkt, wenn sich die geöffnete Datei auf der Festplatte ändert, und lädt sie sofort neu. Die Statusleiste zeigt „Datei neu geladen“, und Sie bleiben dort, wo Sie gelesen haben – die Seite wird an Ort und Stelle aktualisiert, statt zurück an den Anfang zu springen.

Möchten Sie lieber selbst entscheiden, stellen Sie Wenn sich die Datei auf dem Datenträger ändert in den Einstellungen auf Vor dem Neuladen fragen. PlanCake fragt dann, ob neu geladen werden soll. Sagen Sie Nein, teilt es Ihnen mit, dass F5 die Datei neu lädt, sobald Sie bereit sind.

Wird die Datei gelöscht, umbenannt oder verschoben, sagt PlanCake Ihnen das, und Notizbefehle sind nicht verfügbar, bis die Datei zurück ist. Erscheint sie wieder am selben Ort, sagt PlanCake, dass sie zurück ist, und lädt sie neu.

PlanCake überschreibt nie eine Änderung, die es nicht gesehen hat. Angenommen, die Datei ändert sich, während Sie eine Notiz eintippen. Wenn Sie speichern, weigert sich PlanCake zu schreiben, zeigt die Datei so, wie sie jetzt ist, und meldet: „Die Datei hat sich geändert. Bitte versuchen Sie es erneut.“ Auf keiner Seite geht etwas verloren: Fügen Sie Ihre Notiz erneut hinzu, und sie geht in die aktuelle Version der Datei ein.

Dateien, die nicht in UTF-8 vorliegen

Fast jede Markdown-Datei liegt heute in UTF-8 vor. Ältere Dateien, besonders in Sprachen wie Russisch oder Hebräisch, sind manchmal stattdessen in einer veralteten Windows-Codierung gespeichert. PlanCake öffnet und zeigt sie korrekt an, schreibt aber standardmäßig nicht in sie: Die Datei öffnet sich schreibgeschützt, und PlanCake sagt Ihnen das und nennt die Codierung, zum Beispiel „Diese Datei ist nicht in UTF-8 und wurde daher schreibgeschützt als Windows-1251 geöffnet. Notizen können nicht hinzugefügt werden. Um sie in UTF-8 zu konvertieren, aktivieren Sie in den Einstellungen das Konvertieren von Dateien, die nicht in UTF-8 vorliegen.“

Um solchen Dateien Notizen hinzuzufügen, schalten Sie Beim Öffnen in UTF-8 konvertieren in den erweiterten Einstellungen ein. PlanCake konvertiert dann jede solche Datei in dem Moment, in dem Sie sie öffnen, nach UTF-8 und sagt Ihnen zum Beispiel „Die Datei wurde von Windows-1251 in UTF-8 konvertiert.“ Nur die Codierung ändert sich; der Text und die Zeilenenden bleiben gleich.

Manchmal kann PlanCake nicht sicher sagen, welche Codierung eine Datei verwendet. Eine solche Datei bleibt immer schreibgeschützt, egal was die Einstellung sagt: „Die Codierung dieser Datei konnte nicht erkannt werden, daher wurde sie schreibgeschützt geöffnet und wird nie geändert. Notizen können nicht hinzugefügt werden.“ Das ist eine feste Regel. Eine Datei zu schreiben, die nicht korrekt gelesen wurde, würde die Zeichen zerstören, die PlanCake nicht entziffern konnte, und das tut PlanCake nie.

Die Einstellung Dokumentsprache ist einer der Hinweise, die PlanCake zur Erkennung einer veralteten Codierung nutzt; sie auf die Sprache Ihrer alten Dateien einzustellen, hilft also.

Einstellungen

Drücken Sie Strg+Komma, oder wählen Sie Einstellungen im Menü Datei. Die Einstellungen verteilen sich auf drei Registerkarten, Allgemein, Notizen und Erweitert; klicken Sie eine Registerkarte an, oder wechseln Sie mit Strg+Tab und Strg+Umschalt+Tab zwischen ihnen. Klicken Sie auf OK, um Ihre Änderungen zu übernehmen – sie wirken sofort, ohne PlanCake neu zu starten –, oder auf Abbrechen (Esc), um sie zu verwerfen.

Allgemein

Oberflächensprache

Die Sprache der Menüs, Dialoge und Meldungen: English (Englisch), Русский (Russisch), Українська (Ukrainisch), Français (Französisch), עברית (Hebräisch) oder Deutsch. Systemsprache, die Voreinstellung, folgt Ihrer Windows-Sprache und verwendet Englisch, wenn Windows in einer Sprache läuft, die PlanCake nicht hat. Auf Hebräisch wird das gesamte Fenster von rechts nach links angeordnet. Sie können sie auch über Oberflächensprache im Menü Ansicht wechseln. Diese Einstellung ändert nicht die Dokumentsprache.

Dokumentsprache

Die Sprache, in der PlanCake ein neu geöffnetes Dokument vermutet. Standard: Englisch. Sie folgt nie der Oberflächensprache oder Windows. Siehe Die Sprache des Dokuments.

Wenn sich die Datei auf dem Datenträger ändert

Neu laden (die Voreinstellung) lädt die Datei neu, sobald etwas anderes sie ändert. Vor dem Neuladen fragen fragt Sie zuerst. Siehe Wenn sich die Datei außerhalb von PlanCake ändert.

Vor dem Löschen einer Notiz fragen

Standardmäßig eingeschaltet. Schalten Sie sie aus, um einzelne Notizen ohne Rückfrage zu löschen. Alle Notizen löschen fragt immer.

Vor dem Abhaken einer Aufgabe oder dem Entfernen des Häkchens fragen

Standardmäßig eingeschaltet. Schalten Sie sie aus, um Aufgaben mit einem einzigen Klick oder Tastendruck abzuhaken.

Notizliste anzeigen

Standardmäßig eingeschaltet. Schalten Sie sie aus, um die Notizliste in diesem und in allen anderen Fenstern auszublenden. Es ist dieselbe Einstellung wie Notizliste im Menü Ansicht: Wenn Sie das eine ändern, ändert sich auch das andere.

Beim Start nach Updates suchen

Standardmäßig eingeschaltet. PlanCake prüft einmal beim Start und bleibt still, sofern es keine neue Version gibt.

Im Hintergrund nach Updates suchen

Wie oft PlanCake erneut prüft, während es weiterläuft: Einmal täglich, Alle 3 Tage, Einmal wöchentlich (die Voreinstellung), Einmal monatlich oder Nie. Nie schaltet nur diese wiederholten Prüfungen aus, nicht die Prüfung beim Start.

Notizen

Anfangsmarkierung

Der Text, mit dem eine Notiz in der Datei beginnt. Standard: [usernote]. Sie darf nicht leer sein, nicht mit einem Leerzeichen oder einem doppelten Anführungszeichen beginnen oder enden, und keinen Zeilenumbruch enthalten.

Endmarkierung (leer lassen für eine einzelne Markierung, die bis zum Zeilenende reicht)

Der Text, mit dem eine Notiz endet. Standard: [/usernote]. Sie folgt denselben Regeln und muss sich von der Anfangsmarkierung unterscheiden. Lassen Sie sie leer, läuft eine Notiz von der Anfangsmarkierung bis zum Ende ihrer Zeile; Notizen sind dann immer eine Zeile lang, und Zeilenumbrüche, die Sie in eine Notiz eintippen, werden zu Leerzeichen. Verstoßen die Markierungen gegen eine dieser Regeln, nennt die Zeile darunter den Grund, beginnend mit „Fehler:“, und ein Screenreader liest ihn vor, sobald Sie beim Tippen innehalten.

Eingabetaste oder Mausklick auf einen Block

Fügt eine Notiz hinzu (die Voreinstellung) öffnet den Dialog Notiz hinzufügen. Öffnet das Kontextmenü zeigt stattdessen das Menü des Blocks, in dem Sie Notiz hinzufügen oder Blocktext kopieren wählen; wählen Sie das, wenn Sie sich dabei ertappen, aus Versehen Notizen hinzuzufügen. Ein Klick oder Eingabe auf eine bestehende Notiz öffnet sie immer zur Bearbeitung, und ein Rechtsklick, die Anwendungstaste und Umschalt+F10 öffnen immer das Menü.

Eingabetaste im Notizdialog (Strg+Eingabe bewirkt das Gegenteil)

Speichert die Notiz ist die Voreinstellung. Beginnt eine neue Zeile eignet sich für lange Notizen mit mehreren Absätzen. Was auch immer Sie wählen, Strg+Eingabe tut das jeweils andere.

Erweitert

Beim Öffnen in UTF-8 konvertieren

Standardmäßig ausgeschaltet, sodass Dateien in veralteten Codierungen schreibgeschützt geöffnet und nie geändert werden. Schalten Sie sie ein, damit PlanCake eine Datei, die nicht in UTF-8 vorliegt, beim Öffnen in UTF-8 ohne Byte Order Mark (BOM) konvertiert, sodass Sie Notizen hinzufügen können. Die Konvertierung überschreibt die Datei auf dem Datenträger. Eine Datei, deren Codierung PlanCake nicht erkennen kann, wird nie konvertiert. Siehe Dateien, die nicht in UTF-8 vorliegen.

Über die Befehlszeile arbeiten

PlanCake kann auch ohne Fenster arbeiten. Vier Befehle lesen die Notizen einer Datei, prüfen, ob noch welche übrig sind, entfernen sie alle oder exportieren die Datei nach HTML. Sie sind für Skripte und für KI-Assistenten gemacht: Claude verwendet sie, um Ihre Notizen zu einem Plan zu lesen und zu bestätigen, dass jede davon bearbeitet wurde.

Jeder Befehl folgt demselben Muster:

plancake <command> <file> [options]

Geben Sie plancake --help ein für die Liste der Befehle, oder plancake list --help für die Optionen eines einzelnen Befehls. Die Ausgabe ist UTF-8 ohne Byte Order Mark. Fehler gehen an die Fehlerausgabe, mit Exitcode 1. Auch ein falsch geschriebener Befehl wie plancake chek ist ein solcher Fehler („Unbekannter Befehl: chek. Meinten Sie check?“), statt dass sich ein Fenster mit einer Datei öffnet, die es nicht gibt.

Die Befehle list, check und export ändern nie Ihre Markdown-Datei. Nur clear tut das.

Die Notizen auflisten

plancake list plan.md

Das gibt eine Zeile pro Notiz aus: die Zeilen der Notiz, die Zeilen des Blocks, auf den sie folgt, den Anfang dieses Blocks und die Notiz selbst. Die Zeilen werden ab 1 gezählt, wie in einem Texteditor. Zeilenumbrüche innerhalb einer Notiz werden als Schrägstrich dargestellt.

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

Eine Notiz vor dem ersten Block der Datei folgt auf keinen Block, und ihre Zeile sagt das:

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

Dieses Format ist für Skripte gedacht, daher bleiben seine festen Wörter und Zeichensetzung — „after“, „at the start“, der Bindestrich, die Anführungszeichen — auf Englisch, unabhängig von Ihrer Oberflächensprache.

Fügen Sie --json hinzu für JSON: eine Liste von Objekten mit den Feldern noteStartLine, noteEndLine, blockStartLine, blockEndLine, blockKind, blockExcerpt und text. Die Zeilen werden ab 1 gezählt. blockKind ist paragraph, heading, listItem, code, tableRow oder start für eine Notiz vor dem ersten Block; bei ihr sind blockStartLine und blockEndLine null, und blockExcerpt ist leer. Fügen Sie -o (oder --output) und einen Dateinamen hinzu, um das Ergebnis in eine Datei statt auf den Bildschirm zu schreiben:

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

Notizen exportieren im Menü Datei speichert dasselbe JSON aus dem Fenster.

Prüfen, ob noch Notizen vorhanden sind

plancake check plan.md

Das gibt die Anzahl der Notizen aus, etwa 2 Notizen, und endet mit Exitcode 0, wenn es keine gibt, 3, wenn es welche gibt, und 1, wenn die Datei nicht gelesen werden konnte. Ein Skript kann die drei Fälle unterscheiden: fertig, noch offene Notizen, etwas ist kaputt.

Alle Notizen entfernen

plancake clear plan.md

Das entfernt jede Notiz aus der Datei und gibt aus, wie viele entfernt wurden, zum Beispiel 2 Notizen entfernt. Bei einer Datei in einer veralteten Codierung folgt clear der Konvertierungseinstellung: Ist die Konvertierung ausgeschaltet, oder kann die Codierung nicht erkannt werden, weigert es sich, eine Datei zu ändern, die Notizen enthält, und erklärt, warum. Fügen Sie --convert hinzu, um eine solche Datei für diesen Aufruf unabhängig von der Einstellung in UTF-8 zu konvertieren; eine Datei, deren Codierung nicht erkannt werden kann, wird weiterhin nie geändert.

plancake clear old-plan.md --convert

Nach HTML exportieren

plancake export plan.md -o plan.html

Das schreibt eine eigenständige Webseite des Dokuments mit seinen deutlich markierten Notizen, um sie mit jemandem zu teilen, der PlanCake nicht verwendet. Die Seite hat ihre Stile eingebaut und enthält keine Skripte. Die Option -o ist erforderlich. Die Sprache der Seite ist die Dokumentsprache aus den Einstellungen; um eine andere zu verwenden, fügen Sie --lang und einen Sprachcode hinzu, etwa --lang fr. Der Seitentitel ist die erste Überschrift des Dokuments, oder der Dateiname, wenn es keine hat. Bilder, die Dateien auf Ihrem Computer sind, etwa ![Diagramm](diagram.png) neben dem Plan, werden in die Seite eingebettet, sodass sie sie überall zeigt, wo sie geöffnet wird; ein Bild über 10 MB oder auf der Netzwerkfreigabe eines anderen Computers wird nicht eingebettet. Bilder aus dem Web bleiben Links ins Web.

Andere Markierungen für einen einzelnen Durchlauf verwenden

Standardmäßig verwenden die Befehle die Markierungen aus den Einstellungen. Um für einen einzelnen Durchlauf andere zu verwenden, fügen Sie hinzu:

--open-marker <text>

Die Markierung, mit der eine Notiz beginnt.

--close-marker <text>

Die Markierung, mit der eine Notiz endet.

--single-token

Notizen haben keine Endmarkierung und enden mit ihrer Zeile. Das kann nicht mit --close-marker kombiniert werden.

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

PowerShell und cmd warten nicht

PlanCake ist ein Windows-Programm mit einem Fenster, und eine interaktive PowerShell oder Eingabeaufforderung wartet nicht, bis solche Anwendungen fertig sind. Wenn Sie einen Befehl an der Eingabeaufforderung eintippen, kann die Eingabeaufforderung zurückkommen, bevor die Ausgabe erscheint; die Ausgabe zeigt sich dann darunter. Sie ist vollständig – nur spät.

Eine Ausgabe, die weitergeleitet oder erfasst wird, ist immer vollständig, weil die Shell darauf wartet. Das gilt in bash, wenn Sie sie an einen anderen Befehl weiterleiten, und in Claudes eigenen Werkzeugaufrufen.

In PowerShell-Skripten gibt es eine Falle: Die Ausgabe einer Variablen zuzuweisen ist kein Weiterleiten. $notes = plancake list plan.md wartet nicht und lässt $LASTEXITCODE leer. Leiten Sie den Befehl stattdessen weiter, oder führen Sie ihn über cmd aus:

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

cmd /c "plancake check plan.md"

Einen Plan mit Claude überprüfen

So greifen die Teile ineinander, wenn Claude einen Plan schreibt und Sie bittet, ihn zu überprüfen. Sie öffnen den Plan mit pk plan.md, lesen ihn und hinterlassen Notizen, wo immer Sie anderer Meinung sind oder Änderungen wünschen. Wenn Sie Claude sagen, dass Sie fertig sind, führt es plancake list plan.md --json aus, um Ihre Notizen mit den genauen Blöcken zu lesen, auf die sie sich beziehen, überarbeitet den Plan und entfernt die Notizen, die es bearbeitet hat. plancake check plan.md bestätigt, dass nichts übrig ist.

Wenn Sie die Debussy-Plugins für Claude Code verwenden, liest deren Schritt zur manuellen Überprüfung Notizen, die mit den Markierungen in Debussys Einstellung noteMarkers markiert sind, wobei ein Markierungspaar als open...close geschrieben wird. Die Standardmarkierungen von PlanCake, [usernote] und [/usernote], passen so, wie sie sind, zu dieser Konvention. Siehe Debussys Dokumentation, um das einzurichten; ihr Quellcode ist auf GitHub.

Tastatur- und Mausreferenz

Diese Tastenkombinationen sind fest vorgegeben; sie können nicht geändert werden. Sie können sie auch alle in PlanCake selbst einsehen: Wählen Sie Tastenkombinationen im Menü Hilfe.

Überall im Fenster

Im Dokument

In der Notizliste

Im Notizdialog

Stellen Sie Eingabetaste im Notizdialog auf Beginnt eine neue Zeile, tauschen Eingabe und Strg+Eingabe die Rollen.

Menüreferenz

Klicken Sie einen Menünamen an, drücken Sie Alt oder F10, um die Menüleiste zu erreichen, oder öffnen Sie ein Menü direkt: Alt+D für Datei, Alt+B für Bearbeiten, Alt+A für Ansicht, Alt+N für Notizen, Alt+H für Hilfe. Befehle, die gerade nicht zutreffen — Rückgängig, wenn es nichts rückgängig zu machen gibt, Nächste Notiz in einer Datei ohne Notizen —, sind nicht verfügbar.

Datei

Bearbeiten

Ansicht

Notizen

Hilfe

Kontextmenüs

Öffnen Sie ein Kontextmenü mit der rechten Maustaste, oder mit der Anwendungstaste oder Umschalt+F10.

PlanCake auf dem neuesten Stand halten

PlanCake prüft beim Start und dann einmal wöchentlich auf neue Versionen und bleibt still, sofern es keine findet. Gibt es eine neue Version, beschreibt sie ein Fenster und bietet an, sie zu installieren; Sie können diese Version auch überspringen oder sich später daran erinnern lassen. Sie können ändern, wie oft PlanCake prüft, oder die Prüfungen ausschalten, in den allgemeinen Einstellungen.

Haben Sie mehrere Pläne geöffnet, führt nur ein Fenster diese automatischen Prüfungen durch, sodass Ihnen dasselbe Update nicht mehrfach angeboten wird.

Um sofort zu prüfen, wählen Sie Nach Updates suchen im Menü Hilfe. PlanCake teilt Ihnen das Ergebnis mit, zum Beispiel „PlanCake ist auf dem neuesten Stand.“

Ihre Daten und Ihre Privatsphäre

Ihre Notizen sind in Ihren Dateien

PlanCake hat keine Datenbank und keine versteckten Dateien für Ihre Notizen: Jede Notiz ist reiner Text innerhalb der Markdown-Datei, zu der sie gehört. Was auch immer Ihre Dateien sichert – Versionsverwaltung, Cloud-Synchronisierung, eine Kopie auf einem USB-Stick –, sichert Ihre Notizen mit ihnen. Um jemandem Ihre Notizen zu geben, geben Sie ihm die Datei.

Einstellungen und Protokolle

Ihre Einstellungen stehen in einer einzigen Textdatei, PlanCake.cfg:

• Mit dem Installationsprogramm: %APPDATA%\Oire\PlanCake\PlanCake.cfg
• Portabel: userdata\PlanCake.cfg, neben plancake.exe

Um Ihre Einstellungen auf einen anderen Computer mitzunehmen, kopieren Sie diese Datei dort an denselben Ort. Derselbe Ordner enthält einen Ordner logs, der aufzeichnet, was PlanCake getan hat, und beim Melden eines Problems hilft. Die Arbeitsdateien der Dokumentansicht liegen mit dem Installationsprogramm in %LOCALAPPDATA%\Oire\PlanCake und in der portablen Version im selben Ordner userdata. Das Löschen dieser Ordner setzt PlanCake auf seine Standardwerte zurück und rührt nie Ihre Markdown-Dateien oder die Notizen darin an.

Was über das Netzwerk übertragen wird

PlanCake verbindet sich nur für zwei Dinge mit dem Internet: um eine Datei herunterzuladen, wenn Sie eine über einen Link öffnen, und um nach Updates zu suchen. Es sendet keine Nutzungsdaten irgendwohin.

Fehlerbehebung