Hcard – Уики за микроформати

Щракнали сте върху връзка към статия, която все още не е преведена. Вижтеоригиналната статия

Можете да помогнете да го преведете до края, като спазвате стила и общите правила за превод.

Напомняме ви, че вашият превод може да бъде променян от други членове на общността, така че се опитайте да превеждате статиите по-точно и по-четливо.

hCard е прост, отворен микроформат за описание на хора, компании, организации и места, използвайки силата на vCard (RFC 2426). Имената на класовете hCard напълно преобразуват съответните имена на полета на vCard към семантичен (X)HTML. hCard е един от отворените микроформати, които могат да бъдат вградени в HTML, XHTML, ATOM, RSS и XML.

Искате ли да маркирате своя собствена hCard? Опитайте да започнете с генератор на hCard или създайте сами това маркиране на микроформат, като следвате подканите за вграждане в съществуващи страници.

Авторство и правни проблеми

Тази спецификация е предмет на патентна политика. Виж детайлите:

Стандартът vCard (RFC 2426) е широко разпространен, за да позволи оперативна съвместимост между различни приложения (например приложението "Address Book" на Apple, вградено в Mac OS X). Освен това много блогъри се идентифицират по име и обсъждат своите приятели и семейство на страниците на блога. С малко структуриране блогърите могат да обсъждат (описват) хора в своите блогове по такъв начин, че роботите за търсене и други роботи да могат да поискат тази информация, автоматично да я конвертират във vCard и да я използват по-късно във всяка услуга или приложение, което работи с vCard.

Тази спецификация въвежда форматаhCard, който проектира гореспоменатия стандарт vCard в семантичен HTML. Блогърите могат да вграждат hCard директно в уеб документи иСтилизирайте ги с CSS, за да им придадете вида, който искате. hCard също позволява на приложенията да търсят информация директно от уеб документи, без достъп до отделни файлове.

Особености

Основният стандарт за hCard е vCard.

hCard използва vCard имена на обекти/свойства, преобразувани в малки букви за използване като имена на класове и за създаване на йерархия на HTML елементи.

Корен клас

Основният клас за hCard е "vcard". Елементът с име на клас "vcard" се наричаhCard.

Свойствата на hCard са елементите в рамките на hCard. Елементите с имена на класове на посочените свойства са стойностите на тези свойства. Някои свойства може да имат по-сложна вложена структура от други свойства, но като цяло тяхната структура е идентична.

Списък на имотите

  • fn
  • n1 (фамилия, лично име, допълнително име, почетен префикс, почетен суфикс)

  • псевдоним, сортиране на низ
  • url, имейл (тип, стойност), тел 2 (тип, стойност)
  • adr (пощенска кутия, разширен адрес, уличен адрес, населено място, регион, пощенски код, име на държава, тип, стойност), етикет
  • geo (широчина, дължина), tz
  • снимка, лого, звук, рожден ден
  • заглавие, роля, организация (име на организация, организационна единица)
  • категория, бел
  • > Допълнителни инструкции

Единични и множество имоти

Списък със свойства, които трябва да се използват уникално във формата (само веднъж):

За такива свойства само първият дъщерен елемент с този клас трябва да има стойност, останалите трябва да се игнорират.

Всички други свойства могат да се появят многократно. Всеки нов подобен клас създаванов параметър със стойността на това свойство.

Четивност за човек и машина

Всичко, което е съдържанието на елементите, е достъпно за човек (това всъщност е съдържанието на определено свойство на микроформат), с някои нюанси:

  • Ако елементabbrсе използва за описване на свойство, тогава атрибутътtitle(ако има такъв) на този елемент е стойността на това свойство, вместо съдържанието на този елемент, което в този случай предоставя повече четима от човека информация.
  • Ако елементaсе използва за едно или повече свойства, той трябва да се интерпретира, както следва:
  • За свойствотоphotoи всяко друго свойство, което се състои от URI, стойността е стойността на атрибутаhref.
  • За всички други свойства стойността е съдържанието на елемента.
  • Ако img елемент се използва за едно или повече свойства, той трябва да се интерпретира, както следва:
  • За свойствотоphotoи всяко друго свойство, което приема URI като своя стойност, стойността е стойността на атрибутаsrc.
  • За други свойства атрибутътaltсъдържа тяхната стойност.
  • Ако елементobjectсе използва за указване на едно или повече свойства, той трябва да бъде разпознат, както следва:
  • За свойствотоphotoи свойства, подобни на свойство, атрибутътdataе стойността на тези свойства.
  • За други свойства съдържанието на елемента е тяхната стойност.

    • Частични стойности

    Понякога само част от елемент се използва като стойност на определено свойство. Това често се случва, когато свойството има подтип(напримертел). В този случай специалното име на класvalueсе използва за подчертаване на частта от елемента, която ще бъде стойността на свойството.

    Този фрагмент от hCard ще се покаже, както следва:

    Изключения за собственост

    Стандартът vCard има няколко свойства, които не играят специална роля или тяхната роля се поема от други елементи на уеб страницата. Този раздел описва какво да правите с тях.

      СвойстваNAME,PROFILE,SOURCE,PROD > Информация за организацията

    Препоръки за оптимизиране наn

    1. Съдържанието наFNе разделено на две думи, разделени с интервал.
    2. Първатадума в свойствоFNепосочено имеза свойствоN.
    3. Втората (последна)дума в това свойство се интерпретира катофамилияза свойствоN.
    4. Изключение: Ако първата дума завършва със запетая ","иливтората дума се състои само от един знак (може да бъде последвана от точка "."), тогава първата дума (с изключение на запетаята) се тълкува катофамилия, а втората дума катоиме.

    Ето примери за типични ситуации:

    • име (интервал) фамилно име
    • фамилия (запетая) собствено име
    • фамилия (запетая) име-първо-инициал
    • фамилно-име (интервал) дадено-име-първо-инициал (по избор точка)

    Препоръки за оптимизиране напсевдоним

    По аналогия с оптимизацията наn, ако свойстватаFNиORGне съвпадат и стойността на свойствотоFNе точно една дума, докато отделно свойствоNне е посочено, тогава:

    1. Съдържанието наFNтрябва да се счита за стойностсвойствапсевдоним.
    2. Обработчиците (парсерите) трябва да попълнят липсващото свойствоNс празни стойности.

    Авторите на hCard трябва директно да посочат свойствотоnickname, например:

    hCard може да има отделен елемент с класnickname, чиято стойност ще бъде стойността на свойство със същото име.

    име на организацияоптимизации

    Двойки стойностиТип(тип)иСтойност(стойност)

    Подсвойствотоtypeможе да приема различни стойности в зависимост от това към кое свойство принадлежи. Стойностите за това подсвойство са нечувствителни към главни и малки букви (което означава, че „работа“ е същото като „работа“). Пример:

    Ще се покаже, както следва:

    Дом (предпочитан): +1.415.555.1212

    типбез указанастойност

    Когато е посочено свойствотипи не е посочено свойствостойност, всичко, което не етипсе счита застойностна свойството, например:

    Следователноtypeе "home" и стойността е "+1.415.555.1212"

    Възможни стойностиtypeза adr, tel и email

    Вижте също раздели 3.2.1 ADR, 3.3.1 TEL и 3.3.2 EMAIL в RFC 2426 за нормативна информация. Стойността по подразбиране (дори ако е няколко стойности) е първата стойност в този списък.

    • adr: INTL, POSTAL, PARCEL, WORK, dom, home, pref
    • тел: ГЛАС, дом, съобщ., работа, преф., факс, клетка, v > XMDP профил

    Вижте XMDP профила на hCard, който съдържа всички горни свойства.

    Обработка на информация

    Този раздел е информативен

    пример за vcard

    Това е примерна vCard:

    и еквивалент на горната vCard в hCard маркиране:

    ТоваhCard ще се покаже така:

    Забележка: информация за версията не се изисква в маркирането на hCard, тъй като тази информация ще бъде включена в профила на hCard, който ще се използва чрез премахване на атрибутаprofileв HTML елементаhead.

    Информация за контакт за Commercenet. Този микроформат вече може да бъде идентифициран на тази страница с помощта на различни помощни програми.

    По-долу е маркирането с някои семантични подобрения:

    • abbr се използва за съкращения
    • Името на организацията е представено като връзка

    Допълнителни примери

    Повече примери можете да намерите на страницата с примери на hCard. Има и примери за преобразувани от vCard hCard.

    Можете да използвате следните бутони на вашата страница заедно с микроформата hCard:

      Примери онлайн

    Този раздел е информативен. Броят на примерите в мрежата е много голям, така че беше решено те да бъдат преместени на отделна страница

    Реализации

    Този раздел е информативен.

    Регулаторен

    Информативен

    Спецификации, свързани с hCard

    Подобни работи

    Благодаря на моя добър приятел Вадим, който ме запозна с vCardмногогодини. Ако бях по-внимателен, на много хора нямаше да им се налага да си губят времето да преоткриват колелото.

    Създавайте формати на базата на hCard

    Този раздел е информативен.

    ">