From d8bfb0b907439be72e23a591318b482ac52513aa Mon Sep 17 00:00:00 2001 From: Joseph Milazzo Date: Sat, 9 Mar 2024 09:44:21 -0600 Subject: [PATCH] Updated conversion tables --- pages/guides/metadata/comics.mdx | 5 +-- pages/guides/metadata/epubs.mdx | 64 +++++++++++++++++++++++++++++++ pages/guides/metadata/general.mdx | 4 +- 3 files changed, 68 insertions(+), 5 deletions(-) diff --git a/pages/guides/metadata/comics.mdx b/pages/guides/metadata/comics.mdx index e95c20b..cb2ede1 100644 --- a/pages/guides/metadata/comics.mdx +++ b/pages/guides/metadata/comics.mdx @@ -17,11 +17,10 @@ The XML schema of this file can be found in the [Anansi Project webpage](https:/ | [`LocalizedSeries`](/guides/metadata/comics#non-standard-tags) | → | Localized Name | | `Series` or [`SeriesSort`](/guides/metadata/comics#non-standard-tags) | → | Name | | `Number` | → | Issue/Chapter number | -| [`Count`](/guides/metadata/comics#count) | → | Publication Status | +| [`Count`](/guides/metadata/comics#count) | → | Publication Status | | `Volume` | → | Volume | | `Summary` | → | Summary | -| `Writer` | → | Writers | -| `Publisher` | → | Publisher | +| `Publisher`, `Imprint` | → | Publisher, Imprint | | `Year`, `Month`, `Day` | → | Release Date ([Release Year](/guides/metadata/comics#release-year) for series) | | `Summary` | → | Series Summary from first issue/chapter Issue/Chapter Summary | | `Writer`, `Penciller`, `Inker`, `Colorist`, `Letterer`, `Cover Artist`, `Editor`, `Translator` | → | Writer, Penciller, Inker, Colorist, Letterer, Cover Artist, Editor, Translator | diff --git a/pages/guides/metadata/epubs.mdx b/pages/guides/metadata/epubs.mdx index c86d27a..313e595 100644 --- a/pages/guides/metadata/epubs.mdx +++ b/pages/guides/metadata/epubs.mdx @@ -2,3 +2,67 @@ EPUB files do not have a ComicInfo.xml, but they do have some limited metadata i See the table above to know what tags do kavita read from the OPF file ! **Note:** OPF metadata files must be **inside** the `.epub` file, or it won't be read. + + +## OPF + +### Conversion table + +| In OPF | Is | Equivalent In Kavita | +|------------------------------------------------------------------------------------------------|----|--------------------------------------------------------------------------------| +| `dc:title` (this can be overridden by `calibre:series` or `belongs-to-collection` meta) | → | Chapter Title | +| `calibre:series` | → | Name | +| `calibre:series_index` | → | Volume | +| `dc:description` | → | Summary | +| `dc:publisher` | → | Publisher | +| `Year`, `Month`, `Day` | → | Release Date ([Release Year](/guides/metadata/comics#release-year) for series) | +| `Summary` | → | Series Summary from first issue/chapter Issue/Chapter Summary | +| `dc:creator`, | → | Writer | +| `dc:subject` | → | Genres | +| `dc:language` | → | Language (Kavita will only take the first) | +| `dc:identifier opf:scheme="isbn` | → | ISBN | + + +### Expanding People Metadata +In an epub (Kavita v0.7.3+), you can expand on people with not just author and publisher mappings, but can support the following: +* art/artist +* aut/author +* pbl/publisher +* trl/translator +* edt/editor +* ill/illustrator +* clr/colorist + +In order to achieve this, you must refine the existing `dc:creator` tag with a `meta` tag. Both must exist otherwise the creator will be treated just as an author. See below, we are going to define that there is an editor: +``` +Miya Kazuki +editor +``` +### Reading Lists and Collections +For libraries that are allowed to manage collections and reading lists (and Kavita v0.7.3+), Kavita can utilize epub metadata fields for this. + +In the following example, we have just a single title here and the meta tag to refine this title and indicate that it is used for a collection. With just this, Kavita will generate a `Collection` tag. +``` +A Dictionary of Modern English Usage +collection +``` + +If you add an additional tag of `display-seq` then Kavita will treat the collection as a reading list and generate the reading list with the following order. Note that if you have conflicts, Kavita will automatically reorder, so order may be skewed. +``` +1 +``` + +### Grouping Series +Some books belong together, like in the example, Harry Potter. Sure, we can have each book as it's own series, but sometimes it's better to group them under one series. The ideal way to perform this grouping is by using `calibre:series` and `calibre:series_index` or `belongs-to-collection` and `group-position` for Epub 3.2 files. In the following, we can have our 2 harry potter books grouped together as one single Harry Potter Series (I am using Epub 2 for the first and Epub 3+ for the second): + +``` +Harry Potter and the Philosopher's Stone +Harry Potter +1 +``` + +``` +Harry Potter and the Chamber of Secrets +Harry Potter +2 +``` \ No newline at end of file diff --git a/pages/guides/metadata/general.mdx b/pages/guides/metadata/general.mdx index a0e7f5d..b73f9f5 100644 --- a/pages/guides/metadata/general.mdx +++ b/pages/guides/metadata/general.mdx @@ -1,9 +1,9 @@ # General Metadata Information Kavita uses metadata to parse Series Name, Volumes, Chapters, Special Status, etc... -Kavita reads metadata from within your .cb* archives (cbz, cbr, cb7, cbt) and epubs. If your archives contain a comicinfo.xml at the root, or if your epub contains an embedded .opf file, it will override any parsed information from the filename +Kavita reads metadata from within your .cb* archives (cbz, cbr, cb7, cbt) and epubs. If your archives contain a comicinfo.xml at the root, or if your epub contains an embedded .opf file, it will override any parsed information from the filename. -You can find multiple tools to add metadata under [External Tools](/guides/external-tools/mangamanager) +You can find multiple tools to add metadata under [External Tools](/guides/external-tools/mangamanager). ### Metadata Tag Conversion Below is an example showing how common tags are used in Kavita. More complete documentation can be found in their respective pages.