Русская локализация StoryLine для Obsidian

Локальный русский перевод интерфейса плагина StoryLine для Obsidian. Дополнение переводит доску, сюжетную сетку, хронологию, сюжетные линии, рукопись, мир книги, статистику, экспорт, формы персонажей и основные сообщения.

Оригинальные файлы StoryLine не изменяются. Поэтому StoryLine можно обновлять независимо от локализации.

English README

Возможности

• Перевод основных экранов StoryLine и динамически открываемых окон.
• Русские подписи, кнопки, подсказки, пустые состояния и уведомления.
• Перевод счётчиков слов и сцен.
• Русские обозначения переключателей: ДА / НЕТ.
• Автоматический перевод новых элементов интерфейса после их появления на экране.
• Защита текста рукописи: редактор Markdown, предпросмотр заметок и дерево файлов исключены из обработки.
• Работа полностью локально, без сетевых запросов, телеметрии и доступа к API.

Требования

• Obsidian 1.12.7 или новее.
• Установленный и включённый плагин StoryLine.
• Проверено со StoryLine 1.10.62 и Obsidian 1.13.7.

Установка

Через BRAT

1. Установите плагин BRAT из каталога сторонних плагинов Obsidian.

2. Откройте настройки BRAT и выберите Add beta plugin.

3. Введите репозиторий:

   XaarBot/storyline-russian-localization
   

4. Включите StoryLine Russian Localization в разделе сторонних плагинов.

Вручную

1. Скачайте ZIP из раздела Releases.

2. Распакуйте папку storyline-russian-localization в:

   <ваше хранилище>/.obsidian/plugins/
   

3. Убедитесь, что в папке находятся main.js, manifest.json и styles.css.

4. Перезапустите Obsidian или перезагрузите сторонние плагины.

5. Включите StoryLine Russian Localization.

Использование

Перевод применяется автоматически. Для принудительного обновления откройте палитру команд (Ctrl+P) и выполните:

Обновить русский перевод StoryLine

Чтобы вернуть английский интерфейс, отключите дополнение:

Настройки → Сторонние плагины → StoryLine Russian Localization

Как это работает

Дополнение хранит словарь точных пользовательских строк и отслеживает появление новых элементов интерфейса через MutationObserver. Перевод применяется только к отображаемым надписям и атрибутам интерфейса. Файлы StoryLine, свойства проекта и текст рукописи не переписываются.

Ограничения

• Это независимое дополнение, не связанное с авторами StoryLine или Obsidian.
• После крупных обновлений StoryLine могут появляться новые английские подписи. Для них потребуется дополнить словарь.
• Названия папок и файлов на диске намеренно не переводятся.
• Пользовательский текст и введённые автором значения никогда не переводятся автоматически.

Конфиденциальность

Плагин не выполняет сетевых запросов, не собирает телеметрию и не отправляет содержимое хранилища. Весь код работает внутри локального окна Obsidian.

Разработка

Проверка синтаксиса:

npm test

При добавлении перевода используйте точную английскую строку из интерфейса StoryLine как ключ в объекте TRANSLATIONS внутри main.js.

Предложения и исправления принимаются через Issues и pull request.

Лицензия

MIT. StoryLine и Obsidian являются отдельными продуктами и распространяются на собственных условиях.