BookMap

BookMap je textový soubor se seznamem údajů o knihách, na které má KnihoLink odkazovat. Je to obdoba souboru SiteMap pro vyhledávače, nebo XML souborů se seznamem zboží pro agregátory zboží z e-shopů.

Tyto XML soubory obsahují také informace o knihách, soubor BookMap je však jednodušší a obsahuje méně údajů. Je možné ho vygenerovat jednoduše.

Pokud chcete KnihoLinku usnadnit indexaci vašich stránek o knihách, vytvořte na nějakém URL soubor BookMap a zašlete URL administrátorovi.

Struktura souboru

Jde o prostý textový soubor v kódování UTF-8 (měl by mít HTTP hlavičku "Content-Type: text/plain; charset=utf-8"). Na každém řádku jsou informace o jednom vydání knihy. Jednotlivé údaje jsou oddělené mezerami, obecně whitespacem. Na pořadí údajů nezáleží.

Údaj (kromě URL) se skládá z názvu, dvojtečky a hodnoty. Když je hodnota víceslovný řetězec, je nutné ho dát do uvozovek. Případné uvozovky uvnitř řetězce je nutné zdvojit.

Příklad jednoho řádku: STAMP:"2009-10-16" http://knihovna.phil.muni.cz/dl/oldbooks/kronyka-ceska-hajek-z-libocan-1819 BETH:16644 MUNI:54233 AU:"Hájek z Libočan, Václav, 1499-1553." TITLE:"Kronyka česká" DATE:1819

• Hlavním a povinným údajem je URL stránky o knize.
• STAMP je datum poslední změny stránky. Když bude uvedeno, urychlí se zpracování souboru.
• Dále je dobré uvést co nejvíce jednoznačných identifikátorů, jako ISBN nebo systémová čísla v různých systémech. Např. ISBN:80-7254-584-1 nebo i ISBN:8072545841, ABA001:001574381 (systémové číslo v katalogu Národní knihovny, ABA001 je tzv. sigla knihovny), CTLNO:(OCoLC)85157581 (kontrolní číslo v katalogu WorldCat)
• Pokud máte svoje sytémové číslo, uveďte je ve tvaru [ID cíle]:[vaše systémové číslo], kde [ID cíle] je max. 6 místné označení vaší služby v KnihoLinku, které přiděluje administrátor, např. BETH:16644
• Pokud nejsou k dispozici globálně známé identifikátory, ale i pro jistotu a upřesnění, je dobré uvést základní identifikační údaje vydání knihy: TITLE - název, AU - autora (ve tvaru buď "jméno - mezera - příjmení" nebo v knihovnickém "příjmení - čárka - mezera - jméno", při víc autorech zopakujte pole AU nebo uveďte prvního), DATE - rok vydání

Podle těchto údajů se KnihoLink pokusí přiřadit vaši stránku k ostatním stránkám o stejné knize v jiných systémech.

Obsah souboru

Soubor by měl ze začátku obsahovat údaje o všech knihách z vašeho systému. Jakmile se soubor zaindexuje, bude stačit generovat jen údaje, které se změnily během posledních několika dní. Soubor BookMap by se měl stahovat každý den v noci. Kvůli rezervě bych generoval seznam za posledních 7 dní.