View Single Post
Old 02-25-2024, 05:54 PM   #1
seeder
Enthusiast
seeder has a complete set of Star Wars action figures.seeder has a complete set of Star Wars action figures.seeder has a complete set of Star Wars action figures.
 
Posts: 49
Karma: 274
Join Date: Aug 2020
Device: none
[Metadata Source Plugin] xTrance.info [CZ/SK]

xTrance - Version 2.0.7 (2024/06/15)

Description:
xTrance is a library containing information about authors, books, and e-books. It includes a database of books primarily published in the Czech Republic or Slovakia.

This module uses website xtrance.info as the metadata source.
Spoiler:

Main features:
  • Basics
    It can retrieve and save all basic data about a book into the Calibre library: title, authors, rating (*), series (with index), tags (genre), publisher, publication date, languages, comments (book description), and cover.
  • Identifiers
    It can save xtrance and isbn identifiers.
  • Identifiers in Title
    You can add identifiers to the Title field before searching in the format 'identifier:123', which will be used for more precise book issue retrieval.
    You can specify the publication year of the book in the Title field using 'pubdate:2023' or 'pubyear:2023'. Then, the closest book issue to the specified year will be retrieved.
    You can specify the publisher of the book issue being searched for using 'publisher:Publisher_Name'.
    You can specify the language of the book issue being searched for using 'lang:cs' or 'language:cs'.
    pubdate, lang, and publisher identifiers can be combined.
  • Search Priority
    You can enable/disable search options (search for books by matching titles from the beginning > by matching anywhere in the title).
  • Book issue
    You can choose which book issue of the book you prefer (Czech or Slovak and newest or oldest).
  • Additional metadata
    The module can download additional metadata from the website into the basic fields in Calibre:
    • translator and illustrator names into the Authors field
    • original publication year into the Published field
    • original language into the Languages field
    • genre, number of pages, issue specification, book cover type, book edition, dimensions of the book, number of images in book, original language of publication, language of publication, original publisher, publisher, year of first publication, year of publication, original title, title, subtitle, names of authors, translators, and illustrators, series (with order), book edition (with order), rating (%), rating (0-5), rating (0-10), ISBN, xtrance ID, search order into the Title Publisher, Series, Comments, Tags, and special Identifiers with the prefix 'xtr_'
  • Comments, Publisher, Title, and Series Fields Builder
    You can sort information in the Comments, Publisher, Title, and Series fields as needed.
    You can have any other numerical value written in the 'Series index' field.
  • Remapping Downloaded Data
    The module can remap downloaded data before saving (genre/tags, series/editions, and publisher).
    You can enable a filter to save only those items that are contained in the mapping table (other information will not be saved).
  • Other Options
    • Maximum number of displayed results
    • Switching the Name Surname to Surname Name (similar to the built-in 'LN, FN' function with comma) in the Authors field
    • Saving the role (Translator, Illustrator) of the author stored in the 'Authors' field
    • Saving only the first found name into the Authors field
    • Module configuration translated into: English, Czech

Installation:
  1. Download the attached zip file and install it in the usual way (open Calibre > Preferences > Advanced tab > Plugins > Load plugin from file and select the downloaded zip file)
  2. The module can also be installed directly in Calibre (Preferences > Advanced tab > Plugins > Get new plugins > search for xTrance and choose Install)

Notes:
  • Requires Calibre 0.8 or later
  • Set up the module before using it
  • The module supports automatic update checking when Calibre is launched and will offer to download updates

---------------------------------------------------------------------------------------

Popis:
xTrance je knihovna s informacemi o autorech, knihách a eboocích. Obsahuje databázi knih vydávaných převážně v Česku nebo na Slovensku.

Tento modul využívá web xtrance.info jako zdroj informací.

Hlavní funkce:
  • Základy
    Umí získat a uložit do knihovny Calibre všechny základní data o knize: název, autoři, hodnocení (*), série (s pořadím), štítky (žánr), vydavatel, datum vydání, jazyky, komentáře (popis knihy) a obálku.
  • Identifikátory
    Umí uložit xtrance a isbn identifikátory.
  • Identifikátory v názvu
    Slouží k upřesnění vyhledávaného vydání knihy (upřednostní vydání nejpodobnější specifikaci pomocí těchto identifikátorů) a k seřazení výsledků hledání.
    Do pole Název před vyhledáváním můžete přidat identifikátory ve formátu 'identifikátor:123' ke zpřesnění volby vydání knihy.
    Pomocí 'pubdate:2023' nebo 'pubyear:2023' můžete specifikovat rok vydání knihy. Poté bude vyhledáno nejbližší vydání ke specifikovanému roku.
    Pomocí 'publisher:Název_vydavatelství' můžete specifikovat vydavatele hledaného vydání knihy.
    Pomocí 'lang:cs' nebo 'language:cs' můžete specifikovat jazyk hledaného vydání knihy.
    pubdate, lang a publisher identifikátory lze kombinovat
  • Vydání knihy
    Můžete si vybrat, které vydání knihy preferujete (české nebo slovenské a nejnovější nebo nejstarší) pokaždé bez zapisování Identifikátorů do Názvu.
  • Priorita vyhledávání
    Můžete si zapnout/vypnout možnosti vyhledání knihy (vyhledání knihy podle shody názvu od začátku > podle shody kdekoliv v názvu).
  • Dodatečná data
    Modul umí stahovat dodatečná data z webu do základních polí v Calibre:
    • jména překladatelů a ilustrátorů do pole Autoři
    • rok originálního vydání do pole Vydáno
    • jazyk originálního vydání do pole Jazyky
    • žánr, počet stran, náklad, vazba knihy, vydání knihy, rozměry knihy, počet obrázků, originální jazyk vydání, jazyk vydání, originální vydavatel, vydavatel, rok prvního vydání, rok vydání, původní název, název, podtitul, jména autorů, překladatelů a ilustrátorů, série (s pořadím), knižní edice (s pořadím), hodnocení (%), hodnocení (0-5), hodnocení (0-10), ISBN, xtrance ID, pořadí ve vyhledávání do pole Komentáře, Štítky a speciálních Identifikátorů s prefixem 'xtr_'
  • Seskládání pole Komentáře, Vydavatel, Název a Série
    Informace v polích Komentáře, Vydavatel, Název a Série můžete seskládat podle potřeby.
    Do pole 'Pořadí v sérii' si můžete nechat zapisovat jakoukoliv jinou číselnou hodnotu.
  • Přemapování stažených dat
    Modul umí před uložením přemapovat stažená data (žánr/štítky, série/edice a vydavatel).
    Lze zapnout filtr pro uložení pouze těch položek, které jsou obsaženy v mapovací tabulce. (jiné informace nebudou uloženy)
  • Jiné možnosti
    • Maximální počet zobrazovaných výsledků
    • Přehození Jméno Příjmení na Příjmení Jméno (podobné vestavěné funkci 'LN, FN' s čárkou) v poli Autoři
    • Ukládání role autora ukládáného do pole 'Autoři'
    • Ukládání pouze prvního nalezeného jména do pole Autoři
    • Konfigurace modulu přeložena do: angličtina, čeština

Instalace:
  1. Stáhněte přiložený zip soubor a instalujte běžným způsobem (otevřete Calibre > Předvolby > záložka Rozšířené > Moduly > Načíst modul ze souboru a vyberte stažený zip soubor)
  2. Modul lze také nainstalovat přímo v Calibre (Předvolby > záložka Rozšířené > Moduly > Získat nové moduly > vyhledáte xTrance a zvolíte Instalovat)

Poznámky:
  • Požaduje Calibre 0.8 nebo novější
  • Před použitím si modul nastavte
  • Modul podporuje automatické vyhledání aktualizace při spuštění Calibre a nabídne její stažení

Seznam změn:
Spoiler:

Version 2.0.7 - 15.6. 2024 (seeder)
- všechny výsledky hledání seřadí podle Identifikátorů v názvu, anebo podle nastavení 'Vyberte preferované vydání knihy'
-> př. pokud k Názvu knihy před vyhledáváním napíšete identifikátory "lang:cs pubdate:2000" modul seřadí nalezené výsledky:
nejprve upřednostňuje knihy se shodou autorů, poté shodu názvu a poté řadí výsledky právě dle jazyka (v tomto případě upřednostní české knihy)
následně upřednostňuje v pořadí výsledků knihy nejblíže roku vydání 2000
-> pokud máte v modulu nastavenou volbu 'Vyberte preferované vydání knihy' na jinou než Výchozí řadí modul výsledky podle dané volby obdobně jako s identifikátory
-> při seřazování upřednostňuje hodnotu identifikátoru před volbou v nastavení
- opravy popisků (odkazy na EBF, MR)
Version 2.0.6 - 29.2. 2024 (seeder)
- modul umí stahovat vícero obálek, pokud dochází ke sloučení vydání (nabídne obálky všech sloučených vydání)
- stahuje počet obrázků
Version 2.0.5 - 25.2. 2024 (seeder)
- přidáno stahování pořadí v edici (ukládá první nalezenou edici)
-> pořadí v edici ukládá pouze jako číselnou hodnotu (existují i edice s písmeny)
- zápis role autora kompatibilní s:
-> ostatními možnostmi pluginu: přehození jména a příjmení (bez čárky), stažení pouze prvního autora
-> globální možností přehození (platí pro všechny pluginy): Jméno Příjmení (Role) > Příjmení, Jméno (Role)
- přehození jména bez čárky (plugin only) a s čárkou (global) nyní funguje správně i když jsou zapnuté obě možnosti (preferuje možnost s čárkou)
- role jiné než 'Autor' zapisuje vždy (i pokud je např překladatel jediným autorem v poli)
- přidáno záložní vyhledávání pokud podle názvu od počátku/celého názvu nenalezne shodu:
-> vyzkouší vyhledávat knihy pouze pomocí jednoho slova z názvu (od nejdelších)
-> vyzkouší před vyhledáváním přehodit hodnoty zadané v poli název a autoři
Version 2.0.4 - 17.2. 2024 (seeder)
- přidána možnost zápisu role autora (překlad, ilustrace) v poli Autoři (pokud se má do pole zapsat více než jedna skupina rolí)
- přidána možnost úpravy pole Série a pořadí v sérii
- přidán výpis všech štítků z xTrance k přemapování (při přechodu z předchozí verze stačí resetovat mapování do původních hodnot)
- identifikátor V Názvu 'publisher' nyní porovnává i s přemapovanými hodnotami
- prohledávání kdekoliv v názvu v základu vypnuto (lze zapnout v nastavení)
- do komentářů zapisuje prefix kurzívou
- úprava logování
Version 2.0.3 - 16.2. 2024 (seeder)
- nyní vyhledává i výsledky obsahující hledaný text uprostřed názvu
- přidána konfigurace modulu (jako modul databazeknih.cz) (max. počet výsledků, přemapování Štítků/vydavatelů, seskládání Komentářů/Názvu, přidání dodatečných identifikátorů atd.)
- možnost výběru preferovaného vydání (české/slovenské a nejnovější/nejstarší)
- identifikátory v Názvu (pubdate/pubyear, publisher, language/lang) pro specifikaci přesného vydání (když má záznam shodný Název i autory)
- možnost přidání pořadového čísla k vyhledání všech vydání stejného názvu a autora (v záložce Název přidáte k názvu např. pořadí ve vyhledávání - jde o to že kniha nesmí mít shodné pole 'Název' a 'Autoři')
Version 2.0.2 - 15.2. 2024 (seeder)
- !! nově ukládá identifikátor 'xtrance' namísto 'xtrance_id' (zachován proklik na web z detailu knihy i přes původní 'xtrance_id')
- opravy importu urllib (nyní funkční i s calibre v4)
- opravy formátování BBkódu [url] v popisu knihy
- stahuje pouze prvního vydavatele a ISBN
- kontroluje shodu autora knihy s autorem ve vyhledávání (upřednostní knihy se shodou)
- odebírá z Názvu před vyhledáváním speciální znaky
Version 2.0.1 - 13.2. 2024 (seeder)
- oprava kódování (calibre 7.5)
- stahuje pouze první sérii a index v pořadí
- převádí formátování popisu knihy do HTML (kurzíva, tučně, url odkaz...)
- oprava parsování pub_date (v některých případech je v xml ve špatném formátu např. YYYY-MM-DD-01-01)
- možnost vypnutí stahování jazyka
Version 2.0.0 - 20.4. 2021 (Sosie)
- vyhladavanie nazvu knihy a autora je bez ohladu na male a velke pismena
- Hodnotenie (Rating) parsovalo ako text a potom porovnavalo ako cislo, pretypovane na cislo
- masivny refaktoring
Version 1.0.0 - 25.3. 2015 (wrzx)
- initial version
Attached Files
File Type: zip xTrance_2_0_7.zip (46.1 KB, 20572 views)

Last edited by seeder; 06-15-2024 at 01:34 PM. Reason: bump to version 2.0.7
seeder is offline   Reply With Quote