Какие файлы создает Kirbon
Страницы, вложения и необязательный файл .pages — и все, что Kirbon хранит на вашем Mac, а не в папке.
В вашей папке
Kirbon пишет только то, что ожидаешь увидеть в папке с документацией:
| Что | Где | Когда |
|---|---|---|
| Страницы | .md-файлы с именами по названиям | Когда вы создаете страницу (имя дается один раз — когда у нее впервые появляется название) |
| Разделы | Папки с README.md | Новый раздел… или первая дочерняя страница у страницы |
| Изображения и файлы | assets/<страница>/ в корне папки | Когда вы добавляете их на страницу |
| Порядок страниц | Файл .pages в этой папке | Только когда вы сами меняете порядок |
Это все. Kirbon никогда не пишет метаданные в страницы, не переименовывает файл из-за правки заголовка и не удаляет вложения, когда вы убираете их со страницы.
Файл .pages
Обычный текстовый файл, по одному имени в строке — файлу или папке в той же папке. Не перечисленные имена идут после перечисленных по алфавиту; строки, начинающиеся с #, пропускаются. Удалите файл — и порядок в папке снова станет алфавитным.
план-запуска-orbit-3-0.md
дорожная-карта-2027.md
тарифы.md
интервью-с-клиентами.md
На вашем Mac
Все, что касается того, как вы смотрите на документацию, остается на вашем Mac, вне папки, — и поэтому никогда не попадает в Git:
- открытые окна и вкладки, их страницы, режимы и прокрутка;
- избранное;
- ширина широких таблиц, свернутые ветки структуры, номера строк кода;
- настройки «Файлы и вложения» для каждой папки с документацией;
- список недавних папок и разрешение Kirbon их открывать.
В Корзине
Kirbon не удаляет, а перемещает в системную Корзину: страницы, которые вы туда отправили, и копию файла перед его заменой (например, при Заменить версию на диске моей…). Их можно вернуть из Корзины.