# Метаданные
В Atsumeru
основной упор делается в наполнение вашего контента метаданными. Максимально, насколько это возможно. Это упрощает поиск контента, позволяет более быстро и легко изучить описание/жанры/теги/и тд и улучшает внешний вид библиотеки
# Поддерживаемые форматы метаданных
# ComicInfo.xml
Формат метаданных придуманный для приложения ComicRack
, который больше не разрабатывается. Формат сильно устарел и очень ограничен в оригинальном исполнении, но все еще используется некоторыми приложениями из-за отсутствия альтернативы
Atsumeru
во время импорта извлекает ComicInfo.xml
из архивов и читает следующие поля:
Title
Circles
Summary
Volume
Year
Month
Writer
Publisher
Genre
Characters
PageCount
Ввиду того, что формат сильно устарел и расширять его практически бессмысленно, был разработан альтернативный формат метаданных book_info.json на который опираются Atsumeru
и Atsumeru Manager (opens new window)
# book_info.json
Специально разработанный формат метаданных для всей экосистемы Atsumeru
. Формат поддерживает большое количество полей метаданных на любой вкус и позволяет наполнять метаданными не только комиксы (ComicInfo.xml был разработан для комиксов), но и Мангу
, Хентай
и Ранобэ
Atsumeru Manager (opens new window) содержит редактор метаданных, который работает именно с этим форматом метаданных
Atsumeru
также может хранить и извлекать статичные уникальные хеши Архива
и Серии
внутри объекта atsumeru
в метаданных, которые позволяют переимпортировать Архивы
и Серии
без привязки к пути файла и без потери истории чтения
# chapter_info.json
Вспомогательный формат метаданных для глав в архивах (одна директория - одна глава). Поддерживает почти аналогичный набор полей метаданных и позволяет организовать в архивах сложную систему из глав у каждой из которых будут свои уникальные метаданные (актуально, например, для журналов Манги
или Хентая
, в которых часто собраны главы разных произведений)
# Редактор метаданных
Atsumeru Manager (opens new window) содержит мощный редактор метаданных в book_info.json формате
Поддерживается несколько удобных и прозрачных режимов редактирования:
- редактирование импортированных
Серий
иАрхивов
на сервере - редактирование локальных
Архивов
(файлов) - непосредственное редактирование файла book_info.json
# Открытие редактора
Открыть редактор можно несколькими путями:
- из контекстного меню
Серии
- из контекстного меню
Архива
внутриСерии
- нажав editна верхней панели приложения:
- нажав на выбор файла
- перетащив файл в окно
Интерфейс редактора метаданных
# Редактирование
Редактор интуитивно понятен и предоставляет доступ ко всем возможным полям метаданных формата book_info.json, но необходимы небольшие уточнения:
- поле
Альтернативное название
предполагает запись туда названия на вашем языке - поле
Рейтинг
стоит заполнять, если вы привязываете ваш контент ко внешним сервисам-базам данных по типу Shikimori (opens new window), MyAnimeList (opens new window), ComicVine (opens new window) и других. Данное поле означает позицию контента в рейтинге таких сервисов - поле
Оценка
подразумевает среднестатистическую оценку контента по десятибальной шкале с плавающей точкой - поле
Том
недоступно во время редактированияСерии
.Atsumeru
использует данное значение из метаданныхАрхива
или попытается самостоятельно его определить из названия файла
У всех полей доступно расширенное контекстное меню с дополнительными функциями:
Расширенное контекстное меню
# Связанные сервисы
В нижней части окна есть раздел Связанные сервисы
, где отображается список полей поддерживаемых Atsumeru
внешних сервисов, которые можно привязать к контенту. Может быть полезным для быстрой привязки контента со стороны клиента к сервисам трекинга по типу Shikimori (opens new window), MyAnimeList (opens new window) и другим
Каждое поле обладает функциями автодополнения. Достаточно вставить в соответствующее поле ссылку/идентификатор контента и второе поле будет заполнено автоматически
Файл метаданных book_info.json поддерживает указание любых Связанных сервисов
. Конкретный список сервисов для Atsumeru
был отобран по усмотрению разработчика
# Получение метаданных с внешних источников
Atsumeru Manager (opens new window) также поддерживает функционал парсинга метаданных с поддерживаемых каталогов. Парсеры доступны для установки в Репозитории, который можно открыть нажав на верхней панели приложения
Чтобы получить метаданные необходимо в редакторе нажать на Получить метаданные
, вставить в поле поддерживаемую ссылку на контент и нажать
Интерфейс окна получения метаданных
Если получить метаданные по ссылке не получилось, можно вставить в поле ниже HTML-код страницы контента и повторить попытку
# Сохранение
Изменив метаданных их нужно сохранить. Существует четыре режима записи при редактировании метаданных на сервере:
- в связанные
Архивы
(метаданные записываются во всеАрхивы
Серии
) - во внешние файлы метаданных (в таком случае сохранение происходит во внешний файл book_info.json, который сохраняется по пути
<текущая директория>/.atsumeru/<название архива>/book_info.json
) - только в базу данных (запись происходит только в базу данных не изменяя оригинальные файлы и не создавая отдельные файлы book_info.json)
- только
Серию
(изменяется толькоСерия
и только в базе данных. Полезно, когда необходимо изменить толькоСерию
не изменяяАрхивы
)
Любой метод записи метаданных (кроме записи только Серии
) автоматически определяет и записывает номера томов Архивов
Редактирование локальных Архивов
(файлов) и book_info.json всегда сохраняет изменения в файл