# Метадані
В 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 завжди зберігає зміни у файлі