PlanCake

Ласкаво просимо до PlanCake

PlanCake дає змогу зручно читати файли Markdown і залишати нотатки саме там, де їм і місце. Він показує файл так, як його й задумано читати: зі справжніми заголовками, списками, таблицями та блоками коду замість решіток і зірочок. Його створено для довгих планів реалізації, які пишуть ШІ-асистенти для програмування, — часто по 800 рядків і більше, — але він працює з будь-яким файлом Markdown.

Читання — це половина рецензування. Друга половина — сказати, що ви думаєте: «цей крок неправильний», «зробіть спершу оце». У PlanCake ви клацаєте абзац, елемент списку, заголовок, рядок таблиці чи блок коду, який хочете прокоментувати, або натискаєте на ньому Enter, і вводите свою нотатку. PlanCake одразу записує її просто у файл Markdown, одразу після цього блоку, між парою маркерів. Вам ніколи не доведеться рахувати рядки чи визначати, куди має піти нотатка, — PlanCake знає, з яких рядків файлу походить кожен блок. Той, хто відкриє файл після вас, — колега чи ШІ-асистент на кшталт Claude, — знайде ваші нотатки точно там, де їм і місце.

Кілька речей варто знати заздалегідь. PlanCake — не текстовий редактор: окрім ваших нотаток і позначок пунктів завдань, він ніколи не змінює текст документа. Тут немає нічого зберігати — кожна нотатка потрапляє у файл одразу, щойно ви її підтвердите. PlanCake працює на Windows 10 і 11 (64-розрядних), і все в ньому однаково добре працює мишею, лише з клавіатури та з програмою читання з екрана.

Швидкий старт

1. Відкрийте план: запустіть PlanCake з меню «Пуск» і перетягніть файл Markdown на його вікно, або натисніть Ctrl+O і виберіть файл. З командного рядка те саме робить команда plancake plan.md.
2. Прочитайте його. Заголовки, списки, таблиці й код показуються відформатованими; прокручуйте колесом миші або клавішами зі стрілками та перемикання сторінок.
3. Коли дійдете до чогось, що хочете прокоментувати, клацніть це. З клавіатури натискайте Alt+Shift+Стрілка вниз або Alt+Shift+Стрілка вгору, щоб переходити від блоку до блоку, доки потрібний не буде обведено рамкою, а тоді натисніть Enter. Відкриється діалог «Додати нотатку» з курсором у полі нотатки.
4. Введіть свою нотатку й натисніть Enter, або клацніть ОК. Нотатка з’явиться одразу після блоку, а рядок стану повідомить «Нотатку додано». Вона вже у файлі.
5. Продовжуйте читати й додавати нотатки. Коли закінчите, закрийте вікно — зберігати нічого не потрібно.

Встановлення PlanCake

PlanCake постачається у двох формах: інсталятор, який усе налаштовує за вас, і портативна версія, яка запускається з будь-якої папки, зокрема з USB-накопичувача. Обидві працюють однаково після запуску; різниця лише в тому, де PlanCake зберігає свої налаштування. Завантажте будь-яку з них із сайту PlanCake.

За допомогою інсталятора

Запустіть інсталятор і виконайте його кроки. Окрім самого PlanCake, він подбає про те, що потрібно PlanCake для роботи: встановить середовище виконання .NET 10 Desktop Runtime та середовище виконання Microsoft Edge WebView2 Runtime, якщо їх ще немає на вашому комп’ютері. Він також додає PlanCake до PATH, тому команда plancake працює в будь-якому новому вікні PowerShell чи командного рядка.

Ваші налаштування зберігаються в %APPDATA%\Oire\PlanCake.

Інсталятор додає PlanCake до меню «Пуск» разом з ярликом цього посібника мовою, яку ви вибрали для інсталятора.

PlanCake не підписано сертифікатом підпису коду. Тому під час першого запуску інсталятора або файлу plancake.exe з портативного zip-архіву фільтр Windows SmartScreen може показати повідомлення «Windows захистила ваш комп’ютер» і невідомого видавця. Щоб продовжити, виберіть Докладніше, а потім Усе одно запустити.

Портативна версія

Розпакуйте zip-файл у будь-яку папку та запустіть звідти plancake.exe. Zip-файл містить порожню папку userdata поруч із plancake.exe; доки ця папка існує, PlanCake зберігає свої налаштування в ній і нічого не записує до вашого профілю користувача. Видаліть або перейменуйте папку userdata, і PlanCake повернеться до використання %APPDATA%\Oire\PlanCake.

Портативна версія нічого не встановлює, тому на вашому комп’ютері вже мають бути .NET 10 Desktop Runtime і Microsoft Edge WebView2 Runtime. У Windows 11 WebView2 вже є; якщо його немає, PlanCake повідомить про це під час запуску та запропонує відкрити сторінку завантаження.

Щоб використовувати команду plancake із портативною версією, вкажіть повний шлях до неї або самостійно додайте її папку до PATH.

Видалення PlanCake

Видаліть PlanCake у розділі «Програми» параметрів Windows або командою «Видалити PlanCake» в меню «Пуск». Програма видалення прибирає PlanCake з PATH і запитує, чи видалити також ваші налаштування та журнали; ваших файлів Markdown і нотаток у них вона ніколи не торкається. Портативна версія нічого не встановлює: щоб її видалити, видаліть її папку.

Якщо ви працюєте у звичайному обліковому записі Windows, а видалення дозволяє адміністратор, вводячи свій пароль, програма видалення працює від імені цього адміністратора й шукає його налаштування, а не ваші, тому про них не запитує. Тоді ваші налаштування та журнали залишаються в %APPDATA%\Oire\PlanCake і %LOCALAPPDATA%\Oire\PlanCake; якщо вони вам більше не потрібні, видаліть ці папки самі.

Коротша команда: pk

Якщо ви відкриваєте плани з командного рядка щодня, можете дати PlanCake двобуквену назву. PlanCake не налаштовує це за вас — це один рядок у вашому власному профілі оболонки.

• У PowerShell додайте цей рядок до свого профілю (файл, шлях до якого зберігає $PROFILE):

  Set-Alias pk plancake

• У bash додайте цей рядок до свого .bashrc:

  alias pk=plancake

Після цього pk plan.md відкриває план, і кожна команда з розділу Робота з командного рядка працює з pk замість plancake.

Головне вікно

У вікні є рядок меню вгорі, документ ліворуч, список нотаток праворуч і рядок стану в самому низу. Рядок заголовка показує ім’я відкритого файлу, наприклад plan.md - PlanCake.

Щоб дати документу чи списку нотаток більше місця, перетягніть межу між ними. З клавіатури виберіть Розширити список нотаток або Звузити список нотаток у меню «Вигляд»: кожна команда зсуває межу на десяту частину спільної ширини, до круглого числа — наприклад, з 32 відсотків список стає завширшки 40 відсотків або 30. Рядок стану повідомляє нову частку, наприклад «Список нотаток 40%». Жодна зі сторін не може зменшитися надто сильно: список залишається завширшки принаймні близько 150 пікселів, а документ — близько 200. На цій межі кордон зупиняється, і рядок стану повторює поточну частку. Обидві команди недоступні, доки список нотаток прихований.

PlanCake запам’ятовує розмір і розташування вікна, чи було воно розгорнуте, ширину списку нотаток і масштаб: наступне вікно відкривається так само, на екрані, який досі під’єднано. Найперше вікно підлаштовується під екран, на якому відкривається.

Документ

Це ваш файл Markdown, відформатований для читання. Коли PlanCake відкриває файл, він починає з початку. Ваші нотатки теж з’являються в документі, кожна одразу після блоку, до якого вона належить, і виділена серед тексту плану, тому ви одразу бачите, що належить вам.

Список нотаток

Список нотаток збирає всі нотатки файлу в одному місці, у порядку їхньої появи. У ньому три стовпці:

Нотатка

Перше речення нотатки в одному рядку, без пунктуації Markdown. Стовпець займає всю ширину, яку залишають два інші. Наведіть указівник миші на рядок, щоб побачити нотатку повністю.

Рядки

Де нотатка розташована у файлі: 12 для однорядкової нотатки, 12-14 для довшої.

Блок

Перше речення блоку, за яким іде нотатка, тому ви розумієте, про що вона, не переходячи до неї. В обох стовпцях дуже довге речення за можливості скорочується на комі, двокрапці чи тире.

Щоб перейти до нотатки в документі, натисніть Enter на її рядку або двічі клацніть по ньому; фокус переміститься до нотатки. Щоб видалити нотатку, виберіть її та натисніть Delete; після цього виділення переміститься до найближчої нотатки, що залишилася, тож ви ніколи не втратите своє місце в списку. Клацніть правою кнопкою по рядку або натисніть Клавіша програм чи Shift+F10, щоб відкрити меню з пунктами «Редагувати нотатку» та «Видалити нотатку».

Якщо ви хочете віддати весь простір вікна документу, виберіть Список нотаток у меню «Вигляд». Це приховує список, а повторний вибір знову показує його; рядок стану повідомляє «Список нотаток приховано» або «Список нотаток показано». PlanCake запам’ятовує вибір: це той самий перемикач, що й Показувати список нотаток у Налаштуваннях, тож нові вікна відкриваються так само, а інші відкриті вікна слідують йому, щойно ви до них перейдете.

Переміщення між документом і списком

Клацніть там, де хочете працювати, або натисніть F6, щоб перемкнутися між документом і списком нотаток. Якщо в списку немає нотаток, рядок стану повідомляє «Нотаток немає».

Tab теж працює: натискання Tab після останнього посилання чи прапорця в документі переносить вас до списку нотаток, і Shift+Tab з першого елемента робить те саме. Зі списку Tab і Shift+Tab повертають вас до документа.

Коли список нотаток прихований, і F6, і Tab залишають вас у документі. F6 переміщує фокус; він не повертає прихований список. Для цього скористайтеся Вигляд, Список нотаток.

Повідомлення в рядку стану

Жодна дія PlanCake не відбувається мовчки. Кожну зміну — додану нотатку, позначене завдання, перезавантажений файл, завершене завантаження — підтверджує коротке повідомлення в рядку стану внизу вікна, наприклад «Нотатку додано» або «Файл перезавантажено». Повідомлення залишається там, доки наступне не замінить його.

Питання, які ставить PlanCake

Коли PlanCake ставить вам питання «так чи ні» — видалити цю нотатку? позначити це завдання? перезавантажити цей файл? — натискання Escape відповідає Ні, так само як і закриття питання кнопкою закриття. Ви завжди можете відмовитися від дії, нічого не вибираючи.

В інших діалогах — Додати нотатку, Налаштування, Відкрити за посиланням — Escape є кнопкою «Скасувати»: вона закриває діалог і відкидає те, що ви ввели. У діалогах «Комбінації клавіш» і «Про PlanCake» Escape просто закриває їх.

Використання програми читання з екрана

PlanCake створено з думкою про програми читання з екрана, і кілька деталей варто знати, якщо ви нею користуєтеся:

• Документ — це вебсторінка, тому ви читаєте її звичними навігаційними клавішами вашої програми читання з екрана — за заголовками, списками, таблицями тощо. Щоб прокоментувати блок, перейдіть до нього й натисніть Enter; ви залишаєтеся в своєму режимі читання, на тому самому місці. Після збереження ви опиняєтеся на новій нотатці.
• Кожне повідомлення в рядку стану озвучується незалежно від того, де перебуває фокус, тому ви чуєте «Нотатку додано», «Більше нотаток немає» чи «Файл перезавантажено», не шукаючи рядок стану. Якщо ви пропустили повідомлення, команда вашої програми читання з екрана для читання рядка стану або повторення останнього повідомлення прочитає його знову.
• Кожна нотатка в документі — це область із назвою «Нотатка користувача», тож ви можете відрізнити її від власного тексту плану.
• Налаштування «Мова документа» повідомляє вашій програмі читання з екрана, яким голосом читати план, незалежно від мови інтерфейсу: англійський план читається англійським голосом, навіть якщо Windows і PlanCake — українською.
• Коли файл перезавантажується після зовнішньої зміни, сторінка оновлюється на місці, тож ваша позиція читання залишається там, де була.
• Ctrl+A не виділяє весь документ — навмисно: виділення тексту залишено власним командам вашої програми читання з екрана.

Відкриття файлу

Плани надходять до вас багатьма шляхами: файл на диску, шлях, вставлений кимось у чат, посилання на GitHub. PlanCake може відкрити їх усі напряму, без попереднього збереження. Яким би способом ви не скористалися, щойно відкритий файл завжди починається з початку.

Коли жоден файл не відкрито, вікно перелічує способи відкрити файл та їхні клавіші. Великий файл може відкриватися не одразу: якщо це триває понад пів секунди або файл більший за 1 МБ, PlanCake показує діалог «Відкриття файлу» з індикатором виконання. Натисніть Escape або кнопку Скасувати, щоб перервати відкриття; файл, відкритий до цього, залишиться як був.

З командного рядка

Введіть plancake, а після нього файл:

plancake docs\plans\001-plan.md

Відкриється вікно з цим файлом. Введіть просто plancake для порожнього вікна. Ви також можете перетягнути файл Markdown на plancake.exe або на ярлик до нього.

Через діалог «Відкрити» або перетягуванням

Перетягніть файл Markdown з Провідника файлів і скиньте його на вікно PlanCake. Або натисніть Ctrl+O, або виберіть Відкрити в меню «Файл»: стандартний діалог відкриття Windows показує файли Markdown (.md і .markdown); перемкніть тип файлу на Усі файли, щоб побачити все.

З буфера обміну

Натисніть Ctrl+V у вікні PlanCake, або виберіть Відкрити з буфера обміну в меню «Файл». PlanCake дивиться, що ви скопіювали:

• Файл, скопійований у Провіднику файлів: PlanCake відкриває його. Якщо ви скопіювали кілька, він відкриває перший файл Markdown серед них.
• Шлях, скопійований як текст, із лапками або без них (команда Провідника файлів Копіювати як шлях додає їх): PlanCake відкриває цей файл.
• Вебпосилання, що починається з http:// або https://: PlanCake завантажує файл і відкриває його, як описано в наступному розділі.

Якщо в буфері обміну щось інше, рядок стану повідомляє «У буфері обміну немає файлу Markdown чи посилання.»

За посиланням в інтернеті

Скажімо, колега надсилає вам посилання на план на GitHub. Натисніть Ctrl+L, або виберіть Відкрити за посиланням у меню «Файл». Поле «Посилання» вже заповнене, якщо в буфері обміну є посилання; інакше вставте або введіть його. Натисніть Enter або клацніть ОК, щоб завантажити; натисніть Escape або клацніть Скасувати, щоб відмовитися.

Рядок стану показує «Завантаження з github.com...», а коли завантаження завершено — куди збережено файл; потім план відкривається. Завантаження потрапляють до вашої папки «Завантаження» під власним ім’ям файлу й завжди як файл Markdown: до посилання на файл іншого типу додається .md, тож tool.bat зберігається як tool.bat.md і ніколи не запуститься. Як і браузер, PlanCake позначає файл як завантажений з інтернету; якщо файл із такою назвою вже є, PlanCake додає номер, наприклад plan (2).md, як це робить браузер. Оскільки завантажений файл — це звичайний файл на вашому диску, ваші нотатки зберігаються в ньому, як і в будь-якому іншому.

Кілька речей варто знати про посилання:

• Ви можете вставити звичайне посилання на сторінку файлу на GitHub; PlanCake отримує «сирий» Markdown, що стоїть за нею.
• Посилання на звичайну вебсторінку, а не на файл Markdown, відхиляється: «Це посилання веде на вебсторінку, а не на файл Markdown.»
• Завантаження зупиняється через 30 секунд, а файли, більші за 10 МБ, не завантажуються.

Одне вікно на файл

Кожен файл отримує власне вікно, і файл ніколи не відкритий у двох вікнах одночасно. Якщо ви відкриваєте файл, який уже відкрито в іншому вікні PlanCake — з командного рядка, з буфера обміну, звідки завгодно, — PlanCake виводить те вікно на передній план замість того, щоб відкривати друге. Так два вікна ніколи не зможуть записати суперечливі нотатки в той самий файл.

Читання документа

Переміщення документом

Прокручуйте колесом миші чи смугою прокручування, або користуйтеся клавішами зі стрілками, Page Up, Page Down, Home і End. Tab переміщує від посилання до посилання і від прапорця до прапорця. Виділяйте текст мишею та копіюйте його клавішами Ctrl+C, як у будь-якій іншій програмі; завершення виділення ніколи не відкриває діалог нотатки.

Щоб працювати з певним блоком із клавіатури — абзацом, заголовком, елементом списку, рядком таблиці, блоком коду чи нотаткою — натисніть Alt+Shift+Стрілка вниз для наступного блоку та Alt+Shift+Стрілка вгору для попереднього, або виберіть Наступний блок і Попередній блок у меню «Нотатки». Блок отримує рамку та прокручується у видиму область. Натисніть Enter, щоб додати до нього нотатку (або редагувати її, якщо це вже нотатка), або Клавіша програм для його меню. На початку чи в кінці документа рядок стану повідомляє «Більше блоків немає».

Переміщення починається від блоку чи нотатки, з якими ви працювали чи до яких переходили востаннє. Якщо такого ще немає, Alt+Shift+Стрілка вниз переходить до першого видимого блоку, а Alt+Shift+Стрілка вгору — до останнього. У списку нотаток ці клавіші переміщують до блоку в документі й розташовують вас там.

Перехід за посиланнями, повернення назад

Клацніть посилання або натисніть на ньому Enter, і PlanCake робить те, що має сенс для того, куди воно веде:

• Вебпосилання відкривається у вашому браузері за замовчуванням.
• Посилання на інший файл Markdown поруч із цим відкриває той файл у PlanCake, у тому самому вікні.
• Посилання на папку відкриває її у Провіднику файлів, а посилання на текстовий файл, PDF чи зображення відкриває його програмою, яку Windows використовує для нього. Будь-який інший файл (програма, сценарій, наприклад .bat, .js чи .py, або файл будь-якого іншого типу, відкриття якого може щось запустити) за посиланням ніколи не відкривається, хоч би що казав його текст: натомість PlanCake питає, чи показати файл у Провіднику файлів. За посиланням на файл у мережевій теці іншого комп’ютера PlanCake не переходить.
• Посилання на заголовок у тому самому документі переносить вас до цього заголовка.
• Якщо посилання веде на файл, якого не існує, рядок стану повідомляє про це та показує шлях.

PlanCake запам’ятовує файли, які ви відкривали у вікні, і де ви були в кожному з них, — подібно до історії браузера. Натисніть Alt+Стрілка вліво або Backspace, або виберіть Назад у меню «Вигляд», щоб повернутися до попереднього файлу точно в тому місці, де ви його залишили. Alt+Стрілка вправо або Уперед веде далі вперед. На кінцях історії рядок стану повідомляє «Попереднього файлу немає» або «Наступного файлу немає». Якщо файл з історії відтоді видалено, PlanCake повідомляє про це й пропускає його.

Відкриття файлу будь-яким іншим способом — через Ctrl+O, перетягуванням, з буфера обміну, за посиланням — теж додає його до історії, тож Назад завжди повертає вас до того, що ви читали раніше.

Масштабування

Щоб зробити текст більшим, натисніть Ctrl+Плюс; щоб зробити його меншим, натисніть Ctrl+Мінус. Клавіші на цифровій клавіатурі теж працюють, як і Збільшити масштаб і Зменшити масштаб у меню «Вигляд». Кожен крок змінює розмір на 10 відсотків, у межах від 50 до 300 відсотків, і рядок стану показує новий розмір, наприклад «Масштаб 120%». Натисніть Ctrl+0, щоб повернутися до 100 відсотків. Наступне відкрите вікно почне з того самого масштабу.

Мова документа

PlanCake розрізняє дві мови: мову своїх меню й вікон та мову, якою написано документ. Перемикання інтерфейсу на французьку не робить англійський план французьким. Мова документа має значення, коли план читається вголос (див. Використання програми читання з екрана), і допомагає PlanCake розпізнавати старі кодування файлів (див. Файли не в UTF-8).

Нові документи використовують налаштування «Мова документа» з Налаштувань — англійську, доки ви її не зміните. Щоб встановити іншу мову для одного конкретного файлу, виберіть Мова документа в меню «Вигляд» і виберіть її. Це стосується лише відкритого файлу; наступний відкритий файл знову використовує мову з Налаштувань.

Залишення нотаток

Додавання нотатки

1. Клацніть абзац, заголовок, елемент списку, рядок таблиці чи блок коду, який хочете прокоментувати. Блок під указівником миші підсвічується, тож видно, до якого блоку клацання додасть нотатку. З клавіатури перейдіть до нього клавішами Alt+Shift+Стрілка вниз або Alt+Shift+Стрілка вгору (див. Переміщення документом) і натисніть Enter. Відкриється діалог «Додати нотатку». Він показує початок блоку під написом Нотатка до, щоб ви могли перевірити, чи правильний блок обрали, і розміщує курсор у полі Нотатка.
2. Введіть свою нотатку. Щоб почати в ній новий рядок, натисніть Ctrl+Enter.
3. Натисніть Enter або клацніть ОК, щоб зберегти; натисніть Escape або клацніть Скасувати, щоб відмовитися. ОК залишається недоступною, доки поле порожнє, і натискання Enter тоді лише повідомляє «Спершу введіть нотатку.»

PlanCake одразу записує нотатку у файл, одразу після блоку. Документ оновлюється, рядок стану повідомляє «Нотатку додано», і нова нотатка — там, де ви зараз перебуваєте. Вона також з’являється в списку нотаток.

Досить одного клацання; подвійне клацання не робить нічого більшого за одинарне. Виділення тексту мишею не відкриває діалог, тож ви й далі можете виділяти й копіювати текст як завжди.

Якщо ви хочете, щоб Enter починав новий рядок, а Ctrl+Enter зберігав, змініть Enter у діалозі нотатки в Налаштуваннях. Якщо ви хочете, щоб клацання чи Enter на блоці відкривали меню, а не діалог, — наприклад, тому що ви часто клацаєте, щоб просто розташуватися, і випадково додаєте нотатки, — змініть Enter або клацання на блоці. Обидва описано в Налаштуваннях нотаток.

Ви також можете додати нотатку через контекстне меню: клацніть правою кнопкою по блоку, або натисніть на ньому Клавіша програм чи Shift+F10, і виберіть Додати нотатку.

Редагування нотатки

Клацніть нотатку в документі, або перейдіть до неї клавішами F9 чи Alt+Shift+Стрілка вниз і натисніть Enter. Відкриється той самий діалог із заголовком «Редагувати нотатку», заповнений текстом нотатки. Змініть його та збережіть; рядок стану повідомляє «Нотатку змінено».

Ви також можете відкрити нотатку для редагування зі списку нотаток, через контекстне меню або командою «Редагувати нотатку» в меню «Нотатки».

Видалення нотаток

Щоб видалити одну нотатку, виберіть її в списку нотаток і натисніть Delete. Або клацніть правою кнопкою по нотатці, в документі чи в списку, або натисніть на ній Клавіша програм чи Shift+F10, і виберіть Видалити нотатку. PlanCake запитає «Видалити цю нотатку?» і покаже її текст; клацніть Так або натисніть Enter. Рядок стану повідомляє «Нотатку видалено». Якщо ви не хочете, щоб вас запитували щоразу, вимкніть Запитувати перед видаленням нотатки в Налаштуваннях.

Щоб прибрати всі нотатки з файлу одразу — скажімо, після того, як автор плану опрацював їх усі, — виберіть Видалити всі нотатки в меню «Редагування». PlanCake завжди спершу запитує, повідомляючи кількість нотаток, хоч би що казало налаштування.

Переміщення від нотатки до нотатки

Натисніть F9 для наступної нотатки та Shift+F9 для попередньої, або скористайтеся командами «Наступна нотатка» і «Попередня нотатка» в меню «Нотатки». У документі це переносить вас до нотатки; у списку нотаток — переміщує виділення. Після останньої нотатки чи перед першою рядок стану повідомляє «Більше нотаток немає».

Скасування зміни

Натисніть Ctrl+Z, щоб скасувати, і Ctrl+Y, щоб повторити, або скористайтеся командами «Скасувати» та «Повторити» в меню «Редагування». Це охоплює все, що записує PlanCake: додавання, редагування й видалення нотаток, видалення всіх нотаток, а також позначення завдань виконаними чи невиконаними. Рядок стану повідомляє, що саме скасовано чи повторено, наприклад «Додавання нотатки скасовано» або «Позначення завдання повторено», і «Нічого скасовувати», коли скасовувати вже нічого.

Скасування працює, лише доки файл все ще містить те, що PlanCake записав востаннє. Якщо відтоді файл змінило щось інше, PlanCake не скасовує цю зміну; він повідомляє «Файл змінився, тому більше нічого скасовувати чи повторювати.»

Форматування в нотатці

У нотатці можна використовувати Markdown: виділення, вбудований код, посилання, списки і навіть блок коду. У документі нотатка показується відформатованою, тоді як файл зберігає точно те, що ви ввели.

Два винятки зберігають структуру плану незмінною. Заголовок, який ви вводите в нотатці, показується як жирний текст, а не як справжній заголовок, тож ваші нотатки ніколи не змішуються з власними заголовками плану. А теги HTML, які ви вводите, показуються як звичайний текст.

Нотатка не може містити власний закривальний маркер, за замовчуванням [/usernote], бо це завершило б її передчасно. Якщо ви використовуєте один маркер без закривального (див. Налаштування нотаток), нотатка не може містити цей маркер, бо це почало б другу нотатку. Якщо ви введете будь-який із них, PlanCake залишить діалог відкритим і пояснить чому.

Як нотатка виглядає у файлі

Нотатки — це звичайний текст у вашому файлі Markdown, огорнутий двома маркерами. Нотатка на абзаці виглядає так:

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

Кожен, хто відкриє файл у текстовому редакторі, і будь-який інструмент, що його читає, побачить ваші нотатки. Ви навіть можете писати нотатки вручну в такому самому вигляді, і PlanCake показуватиме їх так само, як власні. Щоб використовувати інші маркери, див. Налаштування нотаток.

Маркери всередині коду не вважаються нотатками: між зворотними апострофами, як у `[usernote]`, або в блоці коду. Не вважаються нотатками й маркери в HTML: всередині HTML-коментаря, <!-- … -->, або в блоці <pre>, <script>, <style> чи <textarea>, від відкривального тегу до закривального. Якщо Відкривальний маркер сам починається з <!--, маркери всередині коментарів і далі вважаються нотатками. План чи посібник, де маркери показано як приклад, зберігає їх як є, і ні вікно, ні команди їх не чіпають. Сам PlanCake ніколи не пише нотатку всередині коду: нотатка до блоку коду записується в рядок після нього.

Копіювання тексту блоку

Щоб скопіювати абзац, елемент списку чи інший блок без пунктуації Markdown, клацніть по ньому правою кнопкою, або натисніть на ньому Клавіша програм чи Shift+F10, і виберіть Копіювати текст блоку. Рядок стану повідомляє «Текст блоку скопійовано».

Позначення завдань виконаними

Багато планів містять контрольні списки — рядки на кшталт - [ ] Write the tests у файлі. PlanCake показує їх як справжні прапорці, тож ви можете позначати кроки в міру просування, не відкриваючи редактор.

1. Клацніть прапорець, або натисніть на ньому Пробіл чи Enter.
2. PlanCake запитає «Позначити це завдання як виконане? Файл на диску буде змінено.» (або «Позначити це завдання як невиконане? Файл на диску буде змінено.» для вже позначеного завдання) і покаже завдання. Клацніть Так або натисніть Enter. Якщо ви відповісте «Ні», прапорець залишиться точно таким, яким був.
3. PlanCake записує [x] або [ ] у тому одному рядку файлу. Ви залишаєтеся на прапорці, і рядок стану повідомляє «Завдання позначено» або «Позначку із завдання знято».

Якщо ви позначаєте завдання часто й не потребуєте питання, вимкніть Запитувати, перш ніж позначити завдання або зняти з нього позначку в Налаштуваннях. Ctrl+Z скасовує позначення, як і будь-яку іншу зміну.

Завдання з підзавданнями, частина з яких виконана, а частина ні, показується частково позначеним. Це лише відображення: у Markdown немає третього стану, тож для цього нічого не записується. Позначення такого завдання позначає виконаним лише саме це завдання — рядки його підзавдань ніколи не змінюються.

Коли файл змінюється поза PlanCake

План на рецензуванні рідко стоїть на місці: ШІ-асистент оновлює його, колега редагує, система керування версіями приносить нову ревізію. PlanCake помічає, коли відкритий файл змінюється на диску, і одразу перезавантажує його. Рядок стану повідомляє «Файл перезавантажено», і ви залишаєтеся там, де читали, — сторінка оновлюється на місці, а не повертається на початок.

Якщо ви хочете вирішувати самі, встановіть для Коли файл змінюється на диску значення Запитувати, чи перезавантажити його в Налаштуваннях. Тоді PlanCake запитує, чи перезавантажувати. Якщо ви відповісте «Ні», він повідомить, що F5 перезавантажує файл, коли ви будете готові.

Якщо файл видалено, перейменовано чи переміщено, PlanCake повідомляє про це, і команди для нотаток недоступні, доки файл не повернеться. Коли він знову з’являється на тому самому місці, PlanCake повідомляє, що він повернувся, і перезавантажує його.

PlanCake ніколи не перезаписує зміну, якої не бачив. Припустімо, файл змінюється, поки ви вводите нотатку. Коли ви зберігаєте, PlanCake відмовляється записувати, показує файл таким, яким він є зараз, і повідомляє «Файл змінився. Спробуйте ще раз.» Нічого не втрачається з жодного боку: додайте свою нотатку ще раз, і вона потрапить до поточної версії файлу.

Файли не в UTF-8

Майже кожен файл Markdown сьогодні — в UTF-8. Старіші файли, особливо мовами на кшталт російської чи іврита, іноді збережені в застарілому кодуванні Windows. PlanCake відкриває й показує їх правильно, але за замовчуванням не записує в них: файл відкривається лише для читання, і PlanCake повідомляє про це, називаючи кодування, наприклад «Цей файл не в UTF-8, тому його відкрито лише для читання в кодуванні Windows-1251. Додавати до нього нотатки не можна. Щоб перетворити його на UTF-8, увімкніть у налаштуваннях перетворення файлів, записаних не в UTF-8.»

Щоб додавати нотатки до таких файлів, увімкніть Перетворювати на UTF-8 під час відкриття у Додаткових налаштуваннях. Тоді PlanCake перетворює кожен такий файл на UTF-8 у момент відкриття та повідомляє про це, наприклад «Файл перетворено з Windows-1251 на UTF-8.» Змінюється лише кодування; текст і символи кінця рядка залишаються тими самими.

Іноді PlanCake не може напевно визначити, яке кодування використовує файл. Такий файл завжди залишається лише для читання, хоч би що казало налаштування: «Не вдалося розпізнати кодування цього файлу, тому його відкрито лише для читання, і він ніколи не змінюється. Додавати до нього нотатки не можна.» Це тверде правило. Запис файлу, який не вдалося прочитати правильно, знищив би символи, які PlanCake не зміг розпізнати, а PlanCake ніколи цього не робить.

Налаштування «Мова документа» — одна з підказок, які PlanCake використовує для розпізнавання застарілого кодування, тож встановлення її на мову, якою написані ваші старі файли, допомагає.

Налаштування

Натисніть Ctrl+Кома, або виберіть Налаштування в меню «Файл». Налаштування розташовані на трьох вкладках: Загальні, Нотатки і Додатково; клацніть вкладку або переходьте між ними клавішами Ctrl+Tab і Ctrl+Shift+Tab. Клацніть ОК, щоб застосувати зміни, — вони набувають чинності одразу, без перезапуску PlanCake, — або Скасувати (Escape), щоб відкинути їх.

Загальні

Мова інтерфейсу

Мова меню, вікон і повідомлень: English (англійська), Русский (російська), Українська, Français (французька), עברית (іврит) або Deutsch (німецька). Мова системи, значення за замовчуванням, слідує за мовою вашої Windows і використовує англійську, якщо Windows працює мовою, якої PlanCake не має. Для іврита все вікно розташовується справа наліво. Ви також можете перемкнути її в пункті «Мова інтерфейсу» меню «Вигляд». Це налаштування не змінює мову документа.

Мова документа

Мова, якою PlanCake вважає написаним щойно відкритий документ. За замовчуванням: англійська. Вона ніколи не слідує за мовою інтерфейсу чи Windows. Див. Мова документа.

Коли файл змінюється на диску

Перезавантажувати його (за замовчуванням) перезавантажує файл, щойно щось інше його змінить. Запитувати, чи перезавантажити його запитує вас спочатку. Див. Коли файл змінюється поза PlanCake.

Запитувати перед видаленням нотатки

Увімкнено за замовчуванням. Вимкніть, щоб видаляти окремі нотатки без питання. Видалити всі нотатки завжди запитує.

Запитувати, перш ніж позначити завдання або зняти з нього позначку

Увімкнено за замовчуванням. Вимкніть, щоб позначати завдання одним клацанням чи натисканням клавіші.

Показувати список нотаток

Увімкнено за замовчуванням. Вимкніть, щоб приховати список нотаток у цьому вікні та в усіх інших. Це той самий перемикач, що й Список нотаток у меню «Вигляд»: змінивши один, ви змінюєте й інший.

Перевіряти оновлення під час запуску

Увімкнено за замовчуванням. PlanCake перевіряє один раз під час запуску й мовчить, якщо немає нової версії.

Перевіряти оновлення у фоні

Як часто PlanCake перевіряє знову, поки продовжує працювати: Раз на день, Раз на 3 дні, Раз на тиждень (за замовчуванням), Раз на місяць або Ніколи. Ніколи вимикає лише ці повторні перевірки, а не перевірку під час запуску.

Нотатки

Відкривальний маркер

Текст, з якого починається нотатка у файлі. За замовчуванням: [usernote]. Він не може бути порожнім, не може починатися чи закінчуватися пробілом або подвійними лапками, і не може містити розрив рядка.

Закривальний маркер (залиште порожнім, щоб використовувати один маркер, який діє до кінця рядка)

Текст, яким закінчується нотатка. За замовчуванням: [/usernote]. Він підпорядковується тим самим правилам і має відрізнятися від відкривального маркера. Якщо ви залишите його порожнім, нотатка триває від відкривального маркера до кінця свого рядка; нотатки тоді завжди мають один рядок завдовжки, а будь-які розриви рядків, які ви вводите в нотатці, стають пробілами. Якщо маркери порушують одне з цих правил, рядок під ними пояснює чому, починаючи зі слова «Помилка:», а програма читання з екрана зачитує його, щойно ви зробите паузу в наборі.

Enter або клацання на блоці

Додає нотатку (за замовчуванням) відкриває діалог «Додати нотатку». Відкриває контекстне меню натомість показує меню блоку, де ви обираєте Додати нотатку чи Копіювати текст блоку; оберіть це, якщо помічаєте, що додаєте нотатки випадково. Клацання чи Enter на наявній нотатці завжди відкриває її для редагування, а клацання правою кнопкою, Клавіша програм і Shift+F10 завжди відкривають меню.

Enter у діалозі нотатки (Ctrl+Enter — навпаки)

Зберігає нотатку — значення за замовчуванням. Починає новий рядок підходить для довгих нотаток із кількома абзацами. Що б ви не обрали, Ctrl+Enter робить протилежне.

Додатково

Перетворювати на UTF-8 під час відкриття

Вимкнено за замовчуванням, тож файли в застарілих кодуваннях відкриваються лише для читання й ніколи не змінюються. Увімкніть, щоб PlanCake під час відкриття перетворював файл не в UTF-8 на UTF-8 без позначки порядку байтів (BOM), тож ви зможете додавати нотатки. Під час перетворення файл на диску перезаписується. Файл, кодування якого PlanCake не може розпізнати, ніколи не перетворюється. Див. Файли не в UTF-8.

Робота з командного рядка

PlanCake також може працювати без вікна. Чотири команди читають нотатки у файлі, перевіряють, чи залишилися якісь, видаляють їх усі або експортують файл у HTML. Вони створені для скриптів і для ШІ-асистентів: Claude використовує їх, щоб прочитати ваші нотатки на плані та підтвердити, що з кожною з них розібралися.

Кожна команда виглядає однаково:

plancake <command> <file> [options]

Введіть plancake --help для списку команд, або plancake list --help для параметрів однієї команди. Виведення — в UTF-8 без позначки порядку байтів. Помилки йдуть у потік помилок, із кодом виходу 1. Помилкою вважається й одруківка в назві команди, наприклад plancake chek («Невідома команда: chek. Можливо, ви мали на увазі check?»): вікно з неіснуючим файлом у такому разі не відкривається.

Команди list, check і export ніколи не змінюють ваш файл Markdown. Лише clear змінює.

Виведення списку нотаток

plancake list plan.md

Це виводить по одному рядку на кожну нотатку: рядки нотатки, рядки блоку, за яким вона йде, початок цього блоку та саму нотатку. Рядки нумеруються з 1, як у текстовому редакторі. Розриви рядків усередині нотатки показуються як коса риска.

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

Нотатка перед першим блоком файлу не йде за жодним блоком, і її рядок про це каже:

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

Цей формат призначено для скриптів, тому його незмінні слова та пунктуація — «after», «at the start», тире, лапки — завжди залишаються англійською, хоч би якою мовою був ваш інтерфейс.

Додайте --json для JSON: список об’єктів із полями noteStartLine, noteEndLine, blockStartLine, blockEndLine, blockKind, blockExcerpt і text. Рядки нумеруються з 1. Поле blockKind має одне зі значень paragraph, heading, listItem, code, tableRow або start — для нотатки перед першим блоком; у такої нотатки blockStartLine і blockEndLine дорівнюють null, а blockExcerpt порожній. Додайте -o (або --output) та ім’я файлу, щоб записати результат у файл замість екрана:

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

Експортувати нотатки в меню «Файл» зберігає такий самий JSON із вікна.

Перевірка, чи залишилися нотатки

plancake check plan.md

Це виводить кількість нотаток, наприклад 2 нотатки, і завершується з кодом виходу 0, якщо їх немає, 3, якщо є, і 1, якщо файл не вдалося прочитати. Скрипт може розрізнити три випадки: готово, нотатки ще залишилися, щось зламалося.

Видалення всіх нотаток

plancake clear plan.md

Це видаляє з файлу всі нотатки та виводить, скільки їх видалено, наприклад Видалено 2 нотатки. Для файлу в застарілому кодуванні clear дотримується налаштування перетворення: коли перетворення вимкнено або кодування не вдається розпізнати, вона відмовляється змінювати файл, у якому є нотатки, і пояснює чому. Додайте --convert, щоб цього разу перетворити такий файл на UTF-8 незалежно від налаштування; файл, кодування якого не вдається розпізнати, як і раніше ніколи не змінюється.

plancake clear old-plan.md --convert

Експорт у HTML

plancake export plan.md -o plan.html

Це записує окрему вебсторінку документа з чітко позначеними нотатками, щоб поділитися нею з тим, хто не користується PlanCake. Сторінка має вбудовані стилі й не містить скриптів. Параметр -o є обов’язковим. Мова сторінки — це Мова документа з Налаштувань; щоб використати іншу, додайте --lang і код мови, наприклад --lang fr. Заголовок сторінки — це перший заголовок документа, або ім’я файлу, якщо заголовків немає. Зображення, що є файлами на вашому комп’ютері, наприклад ![Схема](diagram.png) поруч із планом, вбудовуються в сторінку, тож вона показує їх, де б її не відкрили; зображення, більше за 10 МБ або в мережевій папці іншого комп’ютера, не вбудовується. Зображення з інтернету залишаються посиланнями.

Використання інших маркерів для одного запуску

За замовчуванням команди використовують маркери з Налаштувань. Щоб використати інші для одного запуску, додайте:

--open-marker <text>

Маркер, з якого починається нотатка.

--close-marker <text>

Маркер, яким закінчується нотатка.

--single-token

Нотатки не мають закривального маркера й закінчуються разом зі своїм рядком. Це не можна поєднувати з --close-marker.

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

PowerShell і cmd не чекають

PlanCake — програма Windows із вікном, а інтерактивний PowerShell чи командний рядок не чекають завершення таких програм. Коли ви вводите команду в підказці, підказка може повернутися раніше, ніж з’явиться вивід; тоді вивід з’являється нижче неї. Він повний — просто запізнілий.

Вивід, який передається каналом чи перехоплюється, завжди повний, бо оболонка чекає на нього. Так відбувається в bash, коли ви передаєте канал в іншу команду, і у власних викликах інструментів Claude.

У скриптах PowerShell є одна пастка: присвоєння виводу змінній — це не передавання каналом. $notes = plancake list plan.md не чекає завершення й залишає $LASTEXITCODE порожнім. Передавайте команду каналом натомість, або запустіть її через cmd:

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

cmd /c "plancake check plan.md"

Перевірка плану за допомогою Claude

Ось як складаються частини, коли Claude пише план і просить вас його перевірити. Ви відкриваєте план командою pk plan.md, читаєте його й залишаєте нотатки, де не погоджуєтеся чи хочете змін. Коли ви кажете Claude, що закінчили, він запускає plancake list plan.md --json, щоб прочитати ваші нотатки разом із точними блоками, до яких вони належать, доопрацьовує план і видаляє нотатки, з якими розібрався. plancake check plan.md підтверджує, що нічого не залишилося.

Якщо ви користуєтеся плагінами Debussy для Claude Code, їхній етап перевірки плану вручну читає нотатки, позначені маркерами з налаштування noteMarkers у Debussy, де пара маркерів записується як open...close. Маркери PlanCake за замовчуванням, [usernote] і [/usernote], вписуються в цю угоду такими, якими є. Див. документацію Debussy про те, як це налаштувати; її вихідний код — на GitHub.

Довідка з клавіш і миші

Ці комбінації фіксовані; їх не можна змінити. Ви також можете побачити їх усі в самому PlanCake: виберіть Комбінації клавіш у меню «Довідка».

Будь-де у вікні

У документі

У списку нотаток

У діалозі нотатки

Якщо ви встановите для Enter у діалозі нотатки значення Починає новий рядок, Enter і Ctrl+Enter міняються місцями.

Довідка з меню

Клацніть назву меню, натисніть Alt або F10, щоб перейти до рядка меню, або відкрийте потрібне меню одразу: Alt+Ф — Файл, Alt+Р — Редагування, Alt+В — Вигляд, Alt+Н — Нотатки, Alt+Д — Довідка. Команди, що наразі не застосовуються, — Скасувати, коли нічого скасовувати, Наступна нотатка у файлі без нотаток, — недоступні.

Файл

Редагування

Вигляд

Нотатки

Довідка

Контекстні меню

Відкрийте контекстне меню клацанням правою кнопкою, або Клавіша програм чи Shift+F10.

Оновлення PlanCake

PlanCake перевіряє наявність нових версій під час запуску, а потім раз на тиждень, і мовчить, доки не знайде нову. Коли з’являється нова версія, вікно описує її та пропонує встановити; ви також можете пропустити цю версію або отримати нагадування пізніше. Ви можете змінити, як часто PlanCake перевіряє, або вимкнути перевірки, у Загальних налаштуваннях.

Якщо у вас відкрито кілька планів, лише одне вікно виконує ці автоматичні перевірки, тож вам не пропонують те саме оновлення кілька разів.

Щоб перевірити негайно, виберіть Перевірити оновлення в меню «Довідка». PlanCake повідомляє результат, наприклад «У вас остання версія PlanCake.»

Ваші дані та конфіденційність

Ваші нотатки — у ваших файлах

У PlanCake немає бази даних і прихованих файлів для ваших нотаток: кожна нотатка — це звичайний текст усередині файлу Markdown, якому вона належить. Що б не резервувало копії ваших файлів — система керування версіями, синхронізація в хмарі, копія на USB-накопичувачі — воно резервує копії ваших нотаток разом із ними. Щоб віддати комусь свої нотатки, віддайте файл.

Налаштування та журнали

Ваші налаштування — в одному текстовому файлі, PlanCake.cfg:

• З інсталятором: %APPDATA%\Oire\PlanCake\PlanCake.cfg
• Портативно: userdata\PlanCake.cfg, поруч із plancake.exe

Щоб перенести свої налаштування на інший комп’ютер, скопіюйте цей файл у те саме місце там. Та сама папка містить папку logs, яка записує, що робив PlanCake, і допомагає, коли ви повідомляєте про проблему. Робочі файли перегляду документа зберігаються в %LOCALAPPDATA%\Oire\PlanCake, якщо PlanCake встановлено, і в тій самій папці userdata у портативній версії. Видалення цих папок скидає PlanCake до значень за замовчуванням і ніколи не торкається ваших файлів Markdown чи нотаток у них.

Що передається через мережу

PlanCake з’єднується з інтернетом лише для двох речей: завантаження файлу, коли ви відкриваєте його за посиланням, і перевірки оновлень. Він не надсилає нікуди жодних даних про використання.

Усунення несправностей