# Метадані

В 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) також підтримує функціонал парсингу метаданих із підтримуваних каталогів. Парсери доступні для встановлення в Репозиторії, який можна відкрити натиснувши на верхній панелі додатку

Щоб отримати метадані необхідно в редакторі натиснути на Отримати метадані, вставити в поле підтримуване посилання на контент і натиснути

download

Інтерфейс вікна отримання метаданих

Якщо отримати метадані за посиланням не вийшло, можна вставити в поле нижче HTML-код сторінки контенту і повторити спробу

# Збереження

Змінивши метадані, їх потрібно зберегти. Існує чотири режими запису під час редагування метаданих на сервері:

  • у пов'язані Архіви (метадані записуються в усі Архіви Серії)
  • у зовнішні файли метаданих (у такому разі збереження відбувається в зовнішній файл book_info.json, який зберігається за шляхом <поточна директорія>/.atsumeru/<назва архіва>/book_info.json)
  • тільки в базу даних (запис відбувається тільки в базу даних, не змінюючи оригінальні файли і не створюючи окремі файли book_info.json)
  • тільки Серію (змінюється тільки Серія і тільки в базі даних. Корисно, коли необхідно змінити тільки Серію не змінюючи Архіви)

Будь-який метод запису метаданих (окрім запису тільки Серії) автоматично визначає і записує номери томів Архівів

Редагування локальних Архівів (файлів) і book_info.json завжди зберігає зміни у файлі