GENEFIS MEDIA's NOEMA

Документация

Краткое руководство по разделам Noema. Выберите тему — ниже откроется описание.

Введение

Noema хранит лор вокруг мира. После входа вы попадаете в список миров, создаёте новый или открываете существующий дашборд. Все модули — таймлайн, карточки, биографии и остальные — работают внутри выбранного мира.

Интерфейс модулей построен единообразно: сверху заголовок и действия, ниже — рабочая область. Ссылка «Логи» внизу страницы открывает журнал изменений текущего раздела. Оперативные заметки мира доступны с дашборда и через панель справа на страницах мира.

Ниже — описание каждого модуля. Если вы только начинаете, достаточно создать мир, задать точку отсчёта времени и открыть таймлайн: базовая линия истории мира появится автоматически.

Для мобильных клиентов и скриптов есть World API v1 — JSON-доступ к данным мира по bearer-токену из настроек.

Миры

Мир — корневая сущность Noema. У него есть название, описание (синопсис), изображение-обложка, точка отсчёта (подпись нуля на шкале времени) и сеттинг для карт (фэнтези, современность или научная фантастика).

На странице «Мои миры» можно упорядочить карточки и войти в дашборд. В настройках мира меняются основные поля; удаление мира требует явного подтверждения. С дашборда открываются все модули выбранного мира.

Таймлайн

Таймлайн — визуальная хронология: линии (отрезки времени) и события на них. При создании мира появляется главная линия «История мира» и событие в год 0 с текстом точки отсчёта.

Создавайте линии и события через кнопки шапки или контекстное меню (правый клик по холсту). У события можно указать год и, при необходимости, границы периода. Флаг «конец линии» обрывает второстепенную линию на этом годе (на главной линии мира не применяется).

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

Карточки

Модуль карточек — это истории, разбитые на нумерованные карточки. Метод близок к сценарной работе «от общего к частному»: одна мысль — одна карточка, порядок можно менять, важные места подсвечивать.

Истории объединяются в циклы, поддерживают синопсис и режимы открытия карточек. Текст оформляется разметкой Noema (см. раздел «Разметка текста»). Доступны массовое создание карточек, декомпозиция абзацев и экспорт в PDF.

Биографии

Биографии — карточки персонажей: портрет, краткие сведения, родственные и социальные связи, привязка к фракциям, список событий жизни на шкале мира.

Даты рождения и смерти, как и годы событий, задаются числами шкалы мира (включая условные месяц и день 1…100), а не календарём устройства. Из биографии можно создать линию на таймлайне и вынести на неё факты — или отправить одно событие на уже существующую линию.

Фракции

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

Как и у персонажей, события фракции можно вынести на отдельную линию таймлайна. Персонажи могут ссылаться на фракцию как на расу, народ, страну или членство — удаление фракции очищает такие ссылки.

Бестиарий

Бестиарий — справочник существ мира: вид, описание, галерея, связи с другими существами. Список поддерживает алфавитный указатель и поиск; доступен экспорт в PDF.

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

Карты

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

Удаление объектов, подписей и самой карты подтверждается в диалоге интерфейса. Размеры холста задаются в настройках карты.

Связи

Доски связей помогают визуализировать отношения: генеалогию, круги знакомств, политические узлы, нити расследования. На доску выносятся блоки (узлы), связанные с сущностями мира, и соединяются нитями.

Создайте несколько досок под разные задачи — например, отдельно «двор короля» и «загадка первой главы». Удаление доски снимает все блоки и связи на ней.

Заметки

Заметки — быстрый слой для идей и задач по миру. У каждой заметки есть статус: Актуально, Важно или Выполнено.

Важные заметки поднимаются вверх списка и выделяются красной рамкой. Выполненные по умолчанию скрыты на странице заметок и в выезжающей панели; на странице модуля есть фильтр по статусу. Форма создания на странице свёрнута в раскрывашку «Новая заметка».

Разметка текста

В карточках, биографиях и других текстовых полях используется разметка Noema: оформление абзацев и ссылки на сущности мира (персонажи, существа, объекты карты и т.д.). Редактор подсказывает доступные сущности и проверяет ссылки при сохранении.

Ссылки на объекты карты учитывают только объекты с осмысленным названием — пустые служебные подписи в выборе не участвуют. Подробные примеры тегов будут расширяться вместе с редактором; ориентируйтесь на подсказки в интерфейсе поля.

Журнал

Журнал активности фиксирует создание, изменение и удаление сущностей. Ссылка «Логи» ведёт в журнал текущего контекста: модуля, конкретной истории, карты, заметки и т.д. — а не всегда в общий лог мира.

На странице журнала можно очистить именно тот набор записей, который сейчас показан. Это удобно для тестовых черновиков, но действие необратимо.

World API

World API v1 даёт программный доступ к содержимому мира: таймлайн, карточки, биографии, фракции, бестиарий, карты, связи, заметки и разметка. Контекст мира задаётся заголовком Authorization: Bearer …, а не id в URL.

Токен создаётся вместе с миром или перегенерируется на дашборде мира (шестерёнка → API-токен). Старый токен после перегенерации перестаёт работать. Скрытый мир по API недоступен.

Справочник маршрутов на сайте

Живая JSON-справка с полями запросов и правилами PUT: GET /api/v1/docs с тем же bearer-токеном. Подробности также в README.md репозитория.

Аккаунт

В профиле задаются отображаемое имя, краткая биография и аватар. В настройках аккаунта — параметры интерфейса, в том числе порядок карточек на странице «Мои миры» и значения по умолчанию для новых карт.

Раздел «Команда» готовится к совместной работе над мирами; часть сценариев ещё в разработке — смотрите дорожную карту.