Флог (от «файловый лог»)

Персональный блог, который живёт в одном HTML-файле

Флог выглядит как сайт и работает в браузере, но лежит не в интернете, а у вас на компьютере или флешке. Сервер, база данных и аккаунт не нужны: браузер с разрешения пользователя записывает заметки прямо в файл.

Внутри одного index.html находятся интерфейс, настройки, тексты и изображения. Файл можно перенести на другой компьютер и продолжить писать.

Возможности

• визуальный редактор с заголовками, списками, цитатами, ссылками, кодом, изображениями и подписями;
• автоматическое сохранение черновиков;
• поиск, теги, цвета заметок и статистика текста;
• пять скинов: «Нормкор», «Сердечки», «Манга», «Строгий» и «Консоль»;
• цветные фоны, светлая и тёмная темы;
• шифрование заметок, черновиков и изображений паролем;
• обновление внутренней программы перетаскиванием нового файла;
• обязательная проверенная резервная копия перед обновлением.

Как начать

1. Скачайте index.html.
2. Откройте его в браузере как обычный файл.
3. Нажмите + и создайте первую заметку.
4. При первой записи выберите этот же index.html в системном окне.

Прямая запись в файл работает в настольных Chrome, Edge и других Chromium-браузерах с поддержкой File System Access API. В остальных браузерах Флог предложит скачать обновлённую копию.

Шифрование

Флог использует браузерный Web Crypto API: содержимое шифруется алгоритмом AES-GCM-256, а ключ выводится из пароля через PBKDF2-HMAC-SHA-256. Пароль нигде не сохраняется и не отправляется в сеть.

Если забыть пароль, восстановить заметки невозможно. Перед включением шифрования стоит убедиться, что пароль сохранён в надёжном месте.

Обновление

Обычная замена файла здесь не подходит: файл Флога одновременно является и программой, и вашим дневником.

Чтобы обновиться:

1. скачайте новый index.html из этого репозитория;
2. откройте свой текущий Флог;
3. перетащите новый файл в окно браузера;
4. подтвердите обновление.

Флог сначала предложит сохранить резервную копию через системное окно и проверит записанный файл. Только после этого отдельным нажатием можно установить обновление. Заметки, изображения, черновики и настройки будут перенесены в новую версию. Используйте для обновления только файл, которому доверяете.

Разработка

Читаемые исходники и инструменты сборки находятся в скрытой папке .src. Готовое приложение собирается в корневой index.html.

npm --prefix .src install
npm --prefix .src run check
npm --prefix .src run build

Чистый файл для публикации, без пользовательских данных:

npm --prefix .src run build:release

Он появится в .src/release/glog-<версия>.html.

Корневой index.html при обычной сборке сохраняет текущий блок blog-data. Если вы ведёте в нём личные записи, не добавляйте этот файл в публичный коммит: для публикации всегда используйте build:release и проверьте чистый артефакт.

Лицензия

MIT © 2026 Evgeny Stepanischev