Mikroformát hCard
Mikroformát hCard je jednoduchý, otevřený distribuovaný formát reprezentující lidi, firmy, organizace a místa, a to za použití vCard (RFC2426) vlastností a hodnot v sémantickém HTML a XHTML. hCard je jedním z několika mikroformátů - otevřených standardů vhodných pro zabudování do HTML, XHTML, Atom, RSS, XML a jiných značkovacích jazyků.
Chcete-li začít s kódováním mikroformátů hCard, použijte hCard creator k napsání některých kontaktních údajů a jejich zveřejnění. Nebo postupujte podle hCard doporučených tipů pro přidání hCard do vaší aktuální kontaktní stránky.
Úvod
Standard vCard (RFC2426), byl víceméně implementován například v Apple "Address Book" aplikaci postavené na MacOSX.
Tato specifikace zavádí hCard mikroformát, který využívá vlastností a hodnot z výše uvedených vCard v sémantických HTML. Kodéři mohou zakotvit hCard přímo do jejich webových stránek a stylovat jej pomocí CSS. Kromě toho, mikroformát hCard umožňuje aplikacím jednoduše získat informace přímo z webových stránek.
Použijte hCard creator a zkopírujte vygenerovaný HTML kód do svého blogu nebo webové stránky, kde chcete publikovat své kontaktní údaje.
Standard vCard (RFC2426) tvoří základ hCard.
K čemu vlastně hCard slouží? Mikroformát hCard je určen k vložení kontaktních dat do kódu vašich webových stránek či aplikací.
hCard se zapisuje pomocí jmen ve třídách, tedy názvů tříd a jejich vlastnostmi.
Požadavky - specifikace:
povinné:
- Fn
- n (příjmení, křestní jméno, titul před jménem, titul za jménem)
volitelné
- Přezdívka, sort-string
- Url, e-mail, tel
- Adr (P.O.BOX, adresa, e-adresa, ulice, město, region, poštovní směrovací číslo, země - stát, popisek
- Geo (zeměpisná šířka, délka),TZ
- Foto, loga, zvuky, bday - narozeniny
- org (jméno, poslání)
- Kategorie, poznámka
- Třída, klíč, obálky, uid, rev
Poznámky:
Jedinečnost vlastností fn, n, bday, TZ, geo, sort-string, uid, třída u vlastností, které jsou prvním potomkem prvku s třídou, která by měla nabýt účinku, všechny ostatní budou ignorovány.
Všechny ostatní vlastnosti mohou být kombinovány. Každá třída instance takové vlastnosti, vytváří novou instanci této vlastnosti.
Lidským okem viditelný text obsahuje prvek, jež představuje hodnotu tohoto prvku, s několika málo výjimkami:
Je-li prvek <abbr> použit v hodnotě, pak atribut nadpis (je-li přítomen) v <abbr>je hodnotou.
Je-li prvek hCard použit pro jednu nebo více vlastností, musí být nakládáno takto:
1. Pro vlastnost foto a veškeré ostatní vlastnosti, které májí v sobě URL , např. href ="..." atribut obsahuje hodnotu.
2. U ostatních vlastností a prvků je jejich obsah hodnotou.
Je-li <img> prvek použit pro jednu nebo více vlastností, musí být nakládáno takto:
1. Pro vlastnost foto a veškeré ostatní vlastnosti, které májí v sobě URL , např. src ="..." atribut obsahuje hodnotu.
2. Pro ostatní vlastnosti s prvkem <img> atribut Alt je hodnota.
Je-li použit prvek <objekt> pro jednu nebo více vlastností, musí být nakládáno takto:
1. Pro vlastnost foto a veškeré ostatní, jež mají URL v sobě, např. href ="..." atribut obsahuje hodnotu vlastnosti.
2. Z dalších vlastností a prvků je jejich obsah hodnotou vlastnosti.
Někdy se část prvku stejná pro vlastnost používá i pro hodnoty vlastností daného prvku. To se obvykle stává v případech, kdy vlastnost obsahuje podtyp, jako je například tel. Pro tento účel se používá speciální třídy s názvem hodnoty pro výpis z podmnožiny prvku, kterou je hodnota vlastnosti prvku.
Například takto se značí hCard pro domácí telefonní číslo:
Vizitka:
TEL; type = domů: 354444444
hCard
<div class="vcard"> <span class="fn tel"> <span class="type"> domů </ span>: <span class="value"> 354444444</ span> </ span> </ div>
Tento hCard bude zobrazen takto:
Organizace - kontaktní informace
Pokud mají vlastnosti fn a org stejnou hodnotu, typicky proto, že jsou nastaveny na stejný prvek, například:
<span class="fn org">
Pak hCard představuje kontaktní údaje o společnosti, organizaci či místě. V tomto případě se vlastnost n nesmí nastavit na výslovně prázdný řetězec.
Vlastnosti n
Přestože vCard vyžaduje, aby vlastnost n byla přítomna, autoři specifikace vCard (RFC2426) sami o sobě vlastnost n do vCard nezahrnují. Tento zdánlivý rozpor lze vyřešit jednoduše. Aby se vlastnost fn, která má značit vlastnost n v typických případech stanovených specifikací vCard (RFC2426), používáme to výslovně v hCard.
Nejsou-li vlastnosti fn a org stejné a hodnota vlastnosti fn je rovna přesně dvěma slovům oddělených mezerou a neexistuje žádná explicitní vlastnost n, pak vlastnost n je odvozena od vlastnosti fn.
Pokud je pro vlastnost fn použito, buď jedno slovo, nebo má tři a více potomků, musí autor použít vlastnosti n, s výjímkou u kontaktních informací organizací.
- obsah vlastnosti fn je rozdělen na dvě slova mezerou
- první slovo vlastnosti fn je interpretováno jako křestní jméno ve vlastnosti n
- druhé či poslední slovo ve vlastnosti fn je interpretováno jako příjmení ve vlastnosti n
Výjímka:
Pokud první slovo končí čárkou, nebo v případě, že druhé slovo je jedinný znak, pak první slovo (bez čárky na konci, pokud existuje) je interpretováno jako příjmení a druhé slovo jako křestní jméno.
Vlastnost nickname - přezdívka
Podobně jako u vlastnosti n, není-li vlastnost fn a org stejná a hodnota vlastnosti fn je právě jedno slovo a neexistuje žádná explicitní vlastnost n, pak platí toto:
- obsah vlastnosti fn musí být považován za hodnotu vlastnosti nickname - přezdívku
- chybějící vlastnost n naznačuje prázdné hodnoty pro všechny podvlastnosti n
Vydavatelé a autoři by se měli uvádět výslovně přezdívkou.
<span class="vcard"> <span class="fn nickname"> ysiary </ span> </ span>
hCard může obsahovat další hodnoty vlastnosti nickname - přezdívky.
Kategorie
Kategorie mohou být v hCard zastoupeny štítky s třídou rel-tag. Pokud je pro kategorii použita vlastnost třídy rel-tag, pak se pro tuto kategorii používá právě tento štítek.
Mnoho dalších informací o specifikaci mikroformátu hCard naleznete na microformats.org.
Pro nejsnažší pochopení této specifikace hCard bude nejlepší, když uvedu alespoň jeden příklad hCard pro kontaktní údaje firmy či organizace. V tomto případě smyšlených ukázkových kontaktních informací tohoto webu.
<div class="vcard"> <a class="fn org url" href="http://ysiary.name"> ysiary.name - mikroformáty </ a> <div class="adr"> <span class="type"> pref </ span>erovaná adresa: <span class="street-address"> Bezejmenná 1245/54 </ span> <span class="locality"> Boubín I. </ span> <span class="postal-code"> 47805 <abbr class="region" title="Boubín"> Boubín </ abbr></ span> <span class="country-name"> Česká Republika </ span> </ div> <div class="tel"> <span class="type"> home </ span>: 354444444 </ div> <div class="tel"> <span class="type"> fax </ span>: 354444445 </ div> <div> Email: <span class="email"> ysiary@gmail.com </ span> </ div> </ div>
Tento hCard se v prohlížeči zobrazí takto:
Všimněte si řádku preferovaná adresa.
<span class="type"> pref </ span>erovaná adresa:
Pro podtypy v této třídě jsou předepsané hodnoty home, work, pref, fax, cell, voice, video, pager, car, msg, modem, bbs, isdn, pcs podle specifikace RFC2119. Proto jsem slovo preferovaná rozdělil na dvě části. Není to úplně krásný zápis, ale specifikaci to splňuje. Samozřejmě se to dá vyřešit i jinak, například pomocí kaskád. To samé platí i pro podtypy u telefonu či faxu.
<div class="tel"> <span class="type"> home </ span>: 354444444 </ div>
Zdrojem informací je microformats.org.
