FAQ hCard

From Microformats Wiki
Revision as of 16:26, 18 July 2020 by Aaronpk (talk | contribs) (Replace <entry-title> with {{DISPLAYTITLE:}})
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search


Ceci documente les question fréquemment posées et les réponses (FAQs) à propos de hCard. Pour les FAQs concernant les microformats en général ou sur d'autres microformats, regardez les FAQ microformats.


Si vous avez une nouvelle question à poser, considérez SVP tout d'abord de poser votre question sur le canal irc microformats (de préférence) ou sur la liste de discussion microformats. Les nouvelles questions et réponses devraient être ajoutées à la fin de la liste. Si vous avez une nouvelle question mais pas de réponse, ajoutez-là svp aux problématiques hCard.

Editer cette page

SVP, n'utilisez pas le "?" ou d'autres ponctuations dans les titres - cela aide à maintenir les URLs vers leurs identifiants fragements plus courts et plus faciles à lire, copier/coller, etc. Voir comment jouer pour en savoir plus sur les règles de conduite d'édition sur le wiki.

Q&R

Quel est l'objet de hCard

Quel est l'objet de hCard pour les personnes, les entreprises, etc. ?

Comment hCard se différencie de simples liens

Comment hCard est différent de simples liens ?

  • hCard peut être utilisée pour exprimer qu'un nom et un lien (et potentiellement de l'information supplémentaire) sont sémantiquement connectés et font référence à une personne spécifique, un endroit ou une organisation.

Comment hCard aide les utilisateurs

Comment hCard aide les utilisateurs, par ex. comment améliore-t'elle l'expérience utilisateur dans les navigateurs plus qu'en fournissant un nom et un email sous forme de texte ?

  • Dans la plupart des navigateurs, (par ex. Flock, Firefox, Internet Explorer, Safari avec différentes extensions), les utilisateurs peuvent détecter quand il y a des hCards, et peuvent télécharger facilement cette information de contact hCard dans son intégrité, plutôt que d'avoir à copier/coller manuellement chaque nom, adresse email, lien, etc.
  • Voir aussi : Intégration Navigateur

Comment puis-je styliser les hCards avec CSS

Comment puis-je styliser les hCards avec CSS ?

Comment puis-je convertir des hCards en vCards pour le téléchargement sur un site

Y'a-t-il quelque moyen en live de convertir des hCards en vCards pour téléchargement sur un site ? En d'autres mots, j'ai ajouté une hCard sur ma page, mais j'aimerais que mes utilisateurs disposent d'un bouton télécharger vCard.

  • Pour une réponse rapide, utilisez service X2V dans un hyperlien c'est à dire :
<a href="http://h2vx.com/vcf/VOTREURLICI">télécharger la vCard</a>

Envisagez d'utiliser un texte plus amical, comme Ajouter au Carnet d'Adresses. Il y a beaucoup d'exemples de cela dans la page des exemples hCard. Remarquez que le service h2vx est basé sur le "X2V" open source XSLT produit par Brian Suda et d'autres. Si vous voulez, vous pouvez installer vous-même X2V et faire fonctionner votre propre convertisseur local.

Devrais-je utiliser ADDRESS pour les hCards

Devrais-je utiliser l'élément plus sémantique <address> pour mes hCards

Oui l'élément <address> est plus sémantique, mais il est trop spécifiquement sémantique pour la plupart des usages hCard. L'élément pauvrement nommé <address> veut véritablement signifier <info-contact-pour-cette-page-web>. La définition HTML4 de l'élément ADDRESS dit qu'il est utilisé pour "pour fournir les informations de contact du document ou d'une partie essentielle de celui-ci, comme un formulaire." Par conséquent <address> ne devrait être utilisé pour hCard SEULEMENT SI cette hCard représente l'information de contact pour la page ou une partie essentielle de celle-ci. Un exemple d'un tel usage est sur le blog de Tantek. Un autre moyen de dire ceci sont les deux déclarations suivantes : Chaque <address> sur une page DEVRAIT être une hCard. Mais toute hCard ne devrait pas être une <address>.
En résumé, N'utilisez PAS <address> pour baliser les adressses en général. Ne l'utilisez que pour baliser l'information de contact pour la page (ou la partie essentielle de celle-ci), et si vous faites ainsi, utilisez-le pour baliser l'information de contact "entière" (via <address class="vcard">), pas simplement l'adresse du contact.

  • L'élément <address> est plus sémantique, mais il est trop spécifiquement sémantique pour la plupart des usages hCard. L'élément pauvrement nommé <address> signifie vraiment <info-contact-pour-cette-page-web>. La définition HTML4 de l'élément ADDRESS dit qu'il est utilisé pour "pour fournir les informations de contact du document ou d'une partie essentielle de celui-ci, comme un formulaire." Par conséquent <address> ne devrait être utilisé pour hCard SEULEMENT SI cette hCard représente l'information de contact pour la page ou une partie essentielle de celle-ci. Un exemple d'un tel usage est sur le blog de Tantek. Un autre moyen de dire ceci est la double déclaration : Chaque <address> sur une page DEVRAIT être une hCard. Mais toute hCard ne devrait pas être une <address>.
    Pour faire court, N'UTILISEZ PAS <address> pour marquer les adresses physiques/rues/mailing en général. Ne l'utilisez uniquement que pour marquer l'information de contact pour la page (ou une partie majeure de celle-ci), et au moment de faire ainsi, utilisez la pour marquer l'information de contact complète (via <address class="vcard">), pas juste une adresse physique/rue/mailing pour le contact.

Pour en savoir plus sur les différents types de hCards significatives pour les pages, et les distinctions sémantiques parmi elles, voir hCards-et-pages.

Pourquoi la propriété adr est-elle nécessaire

Quel est la raison d'avoir class="adr" quand nous avons l'élément <address> ?- 2006-12-04 posée par Joshie Surber.

  • Tout d'abord, <address> NE VEUT PAS DIRE "address", lisez svp en priorité et précisément la réponse à la FAQ précédente. Deuxièmement, "adr" parle d'adresses physiques, alors que <address> est conçu spécifiquement pour l'information de contact pour la page ou une majeure partie de celle-ci. Elles sont complètement différentes.

Pourquoi la propriété url est-elle nécessaire

Pourquoi est-ce nécessaire de mettre le nom de classe "url" sur les éléments URL dans la hCard quand ces hyperliens commencent déjà par "http://", et que c'est assez pour les distinguer des liens email ?

  • Le nom de classe "url" est nécessaire pour distinguer explicitement les hyperliens qui sont des éléments URL pour la hCard, des autres hyperliens qui peuvent être apparentés à l'item ou autrement dans le même élément conteneur mais qui ne devraient pas être inclus dans la hCard. Les liens communs qui peuvent apparaître dans le document mais ne pas être l'information de contact sont des liens apparentées avec l'action (données de téléchargement, ajout à liste d'amis, etc.) des hyperliens de contact (email, messagerie interne de site, autocomposeurs), tout comme les hyperliens vers les photos ou tous les autres hyperliens au hasard qui surviennent à être à l'intérieur de la hCard.

une hCard peut-elle avoir plusieurs URLs

une hCard peut-elle avoir plusieurs URLs ?

j'ai un problème à servir un fichier vcf vCard

J'ai un problème à servir un fichier .vcf de vCard qui a l'information de ma page /contact/ provenant de mon site web. Par exemple les navigateurs ne font qu'afficher le texte du fichier vcf de la vCard au lieu de la télécharger.

Le chose la plus facile à faire et pour le support (tout spécialement avec de plus en plus de consommateurs de vcar ici sur leurs propres territoires) est de faire ainsi : :

  1. Ajouter du marquage hCard à votre page de /contact/ là où vous avez déjà votre informatin de contact visible dans le contenu. Voir aussi hCard creator un outil qui est utile pour aprendre comment fonctionne le marquage hCard.
  2. Changez le lien vers votre fichier vCard .vdf pour : http://feeds.technorati.com/contacts/http://votresiteweb .exemple.com/contact/

De cette façon vous n'aurez pas à vous soucier des duplicatas de données provenant d'ailleurs. - mettes simplement à jour le contenu de votre page de contact balisée avec hCard et tous ceux qui recevront votre vCard recevront automatiquement l'information de contact mise à jour sans que vous n'ayez à vous soucier de mettre à jour un fil séparé.

Comment supporter une URL vCard existante

J'ai déjà une vCard que je maintiens à jour. Je ne veux pas changer quelque référence vers elle, car cela pourrait casser quelque chose d'autre, que puis-je faire ?

  • Vous pouvez utiliser .HTACCESS pour récrire les liens vers votre vCArd vers un service web qui convertit une page dynamiquement vers la vCard, pour faire ça vous avez besoin d'ajouter quelque chose de similaire à votre fichier .htaccess
RewriteRule ^path/to/old.vcf http://suda.co.uk/projects/X2V/get-vcard.php\?uri=http://example.com/hCard_encoded.htm&filename=old.vcf

Maintenant vous ne devriez pas à avoir à faire quoi que ce soit d'autre, tous les liens vers le "vieux.vcf" sont redirigés vers le webservice et renverront une nouvelle vCard qui sera générée dynamiquement à partir de votre page.

Je pense qu'utiliser 'Redirect' est mieux qu'utiliser mod_rewrite (ce n'est pas autorisé sur quelques hébergeurs) --Robert Bachmann

Redirect /path/to/old.vcf http://suda.co.uk/projects/X2V/get-vcard.php?uri=http://exemple.com/hCard_encoded.htm&nomfichier=old.vcf

Pourquoi hCard utilise vcard comme le nom de classe racine

hCard cartographie les propriétés et valeurs du standard vCard (RFC2426), d'où l'utilisation du nom de classe vcard dans le marquage HTML. Plus de contexte sur les raisons derrière cette décision ici : hCard Parsing: Root Class Name.

Quelles sont les propriétés plurielles hCard

Y'a t-il une liste de toutes les propriétés hCard qui peuvent être plurielles ?
Y'a t-il une liste de toutes les propriétés qui peuvent avoir plusieurs instances ?

  • Il existe la listes des propriétés de hCard, et la liste des propriétés singulières hCard. Tout ce qui n'est pas singulier est pluriel. Cette liste a été présentée explicitement (après beaucoup d'analyse de la RFC2426) parce que c'était trop difficile de lire la RFC2426 et de capter avec conficance quelles propriétés étaient singulières vs plurielles.

Ancienne réponse :

  • Nous avons évité de *dupliquer* (ou de fournir un raccourci) de "est-ce que cette propriété peut apparaître plusieurs fois ou non" délibérément afin d'éviter de devoir répéter une contrainte provenant de la RFC 2426 vCard, et par conséquent faire que ce soit potentiellement faux. Voilà le moyen de déterminer si une propriété particulière peut arriver plusieurs fois (est une propriété plurielle / peut avoir plusieurs instances ou valeurs).
  • Regardez le profil hCard XMDP pour la définition de propriété.
  • Si la définition de propriété fait référence à une forme plurielle dans RFC 2426 (par ex. 'honorific-suffix' fait référence à des suffixes honorifiques), alors la propriété est une propriété plurielle.
  • Ailleurs allez vérifier la section référencée dans la RFC 2426 qui devrait déclarer explicitement si la propriété est plurielle ou singulière.
  • Sinon (si la RFC 2426 n'est *pas* explicite) alors la propriété est plurielle.

Comment marquez-vous une organisation

comment puis-je créer une hCard pour une organisation ou une société ?

Marquez des hCards pour des organisations ou des sociétés en utilisant à la fois les propriétés "fn" et "org" pour le nom de l'organisation/société. par ex.

<p class="vcard">Vous pouvez aider à supporter
 <span class="fn org">microformats.org</span>
 en publiant des microformats sur vos pages web, 
 en ajoutant le support des microformats à vos outils, 
 en donnant un feedback constructif sur le wiki, 
 et en participant aux discussions sur le canal IRC
</p>

Voir aussi : publication hCard :hCards Organisations.

Que veut dire FN

Que veut dire FN ?

  • FN veut dire "Formatted Name." Extrait de la Section 3.1.1 de la RFC :

proposition Type : Pour spécifier le texte mis en forme correspondant au nom de l'object que la vCard représente.

  • Le raisonnement derrière ça semble être que, alors que N nous donne un nom structuré, FN nous donne le nom formaté, lisible par un humain, qui est assemblé à partir de ses parties structurées d'une manière culturellement dépendante.

Comment marquez-vous un nom de milieu ou une initiale

Comment gère-t'on des noms du milieu ou des initiales dans la hCard ?

  • Utilisez la sous-propriété "additional-name" pour marquer un nom du milieu. Pour les initiales du milieu, utilisez l'élément abbr pour indiquer que l'initiale du milieu est une abréviation, et utilisez son attribut title pour le nom en entier si vous l'avez. Voir hCard publication : nom du milieu pour des exemples.

Comment marquez-vous les suffixes

Comment gère-t-on les suffixes, tant ceux en rapport avec la famille que ceux honorifiques ?

  • Utiliser la sous-propriété "honorific-suffix" pour marquer à la fois les suffixes familiaux (par ex. Jr., Sr., II, III, etc.) et les suffixes honorifiques (par ex. Ph.D., Esq., M.D., etc.).
  • par ex.
<abbr class="honorific-suffix" title="Junior">Jr.</abbr>


Comment le genre est représenté

Comment représentez-vous le sexe dans hCard ?

  • Il n'y a pas de propriété GENDER (NDT : sexe) dans vCard RFC2426. hCard suit le schéma à partir de vCard pour des raisons d'inter-opérabilité. Si vous voulez, il est possible de représenter implicitement le sexe dans le champ "honorific-prefix" honorifique, par ex. Monsieur pour masculin et Madame/Mademoiselle pour le féminin :
<span class="honorific-prefix">Monsieur</span>

ou

<span class="honorific-prefix">Madame</span>

Remarquez qu'il y a aussi une page sur MSDN qui mentionne vCard et "gender". Pas certain de savoir quoi faire de cela.

Est-ce que hCard peut contenir des éléments supplémentaires

Est-ce OK pour un noeud hCard de contenir des éléments supplémentaires ?

  • Oui les parseurs ingoreront tout ce qu'ils ne comprennent pas.

Est-ce que GEO peut être inféré à partir d'un ADR dans une hCard

Puis-je automatiquement ajouter GEO à partir d'une adresse au moment de transformer une hCard en vCard s'il n'est pas présent ?

  • Non, une adresse représente un domaine de terre qui est un polygône (ou peut-être un espace dans une construction qui est un polyèdre), alors qu'un GEO ne représente qu'un point unique. Ils ne sont pas équivalents.

X2V ne convertit pas l'email avec un nom en texte clair

X2V ne convertit pas correctement mon adresse email, il est sous la forme href="Prénom Nom <Email@exemple.com>"

  • Alors que ce format d'adresse email fonctionne pour quelques programmes comme outlook, ce n'est pas une valeur mailto: valide (voir RFC2368) le Prénom et Nom devraient être omis.

Un balisage hcard valide possible pourrait être :

<span class="vcard">
  <span class="fn">Prénom Nom</span>
 &amp;lt;<a class="email" href="mailto:Email@exemple.com">Email@exemple.com</a>&amp;gt;
</span>


Ceci pourrait être affiché comme :

Prénom Nom <email@exemple.com>

Quelles sont les propriétés requises dans une hCard

Quelles sont les propriétés requises dans une hCard ?

  • Les seules propriétés requises sont 'fn' (le "formatted name" nom formaté) et 'n' (le nom structuré), mais 'n' peut sous certaines circonstances peut être inféré à partir de la propriété fn. Voir Optimisation Implicite N pour les détails.

Est-ce que la propriété N requiert toutes les sous-propriétés

Si j'utilise la propriété 'n', dois-je utiliser TOUTES les sous-propriétés ?

  • Non, vous pouvez en utiliser autant ou aussi peu que vous en avez besoin pour baliser le nom, mais au minimum vous devriez au moins utiliser les sous-propriétés 'given-name' et 'family-name' si c'est possible. Si tout ce que vous avez est un nickname/handle/userid, alors considérez simplement de baliser ça comme une propriété 'fn' et de tirer partie de l'Optimisation implicite du "nickname".

Est-ce que FN et N doivent être sur le même élément

Est-ce que les propriétés 'fn' et 'n' doivent être sur le même élément ?

  • Non, vous pouvez avoir deux éléments séparés, par exemple :
<p class="vcard">Mon nom est
<span class="n">
<span class="honorific-prefix">Monsieur</span>
<span class="given-name">Jean</span>
<span class="additional-name">Q</span>
<span class="family-name">Public</span>
</span>
mais vous pouvez m'appeler simplement 
<span class="fn">Jeannot</span>
</p>

Est-que FN peut être dans un ordre inversé et N encore extraire correctement l'information

Est-que FN peut être dans un ordre inversé et N encore extraire correctement l'information ?

  • Oui, la valeur FN prendra la chaîne de texte comme telle, mais N regardera ves les sous-propriétés et re-triera ensuite au moment de la conversion en vCard.
<span class="fn n"><span class="family-name">Smith</span>,  <span
class="given-name">John</span></span>

La valeur FN devrait être "Smith, John", mais la valeur N extrairait correctement "John" comme le prénom, et "Smith" comme le nom de famille. Ceci est utile pour quelques cultures qui inverse l'ordre des noms.

La même chose s'applique aux sous-propriétés des adresses. Vous pouvez trier et placer le code-postal avant la localité, ou vice versa selon les normes culturelles.

Comment convertissez-vous une vCard vers une hCard

Y'a t-il un moyen de convertir une vCard vers une hCard ?

  • Il n'existe pas de conversion canonique d'une vCard vers hCard parce que vous pouvez construire une hCard de tellement de manières différentes tout en exprimant la même sémantique. Si vous aimeriez recommander un gabarit suggéré de hCard à utiliser au moment d'afficher des vCards dans un navigateur, proposez-le svp sur la liste de discussion.

Est-ce que les éléments descendants sont reconnus dans une propriété microformat

Est-ce que les descendants sont reconnus dans une propriété microformat ?

  • Oui, par exemple :
<span class="country-name">Etats-Unis <small>d'</small>Amérique</span>

La sortie devrait être "Etats-Unis d'Amérique".

Est-ce que les propriétés comme TEL utilisent tous les descendants

Est-ce que les propriétés comme TEL utilisent tous les descendants ? par ex.

<span class="tel">
 <span class="type">Home</span>:<span class="value">+1.234.567.8900</span>
</span>

Cela ne devrait t-il pas produire "TEL:Home: +1.234.567.8900" ?

  • Non. class="value" est utilisé pour indiquer un sous-élément qui est utilisé pour la valeur de la propriété. Voir Extraction de valeur pour plus de détails.


Pouvez vous avoir plusieurs éléments 'value'

Pouvez-vous avoir plusieurs éléments class="value" à l'intérieur d'une propriété et que leur arrive t'ils ?

  • Bien sûr par exemple
<span class="tel"><span class="type">Home</span> :<span class="value">+1</span>.<span class="value">234</span>.<span class="value">567</span>.<span class="value">8900</span></span>

produirait : "+12345678900".

Pouvez-vous mélanger les propriétés et le nom de classe racine

Pouvez-vous mettre des propriétés sur le même élément que la classe racine pour un microformat ? par ex. class="vcard fn"?

  • Non, pour plusieurs raisons :
    • Cela brise la règle simple du sélecteur contextuel CSS pour trouver et styler les valeurs de propriétés : .rootname .propertyname qui rendront plus difficile l'écriture d'une CSS étendue pour les propriétés. Pour en savoir plus pourquoi c'est important voir les microformats FAQ concernant les interactions de classe.
    • Cela résultera en plus de confusion pour les parseurs qui peuvent être en train de parser des microformats imbriqués.

Pouvez vous mélanger une propriété est ses sous-propriétés

Est-ce que les sous-propriétés singulières peuvent être mixées avec des parents ?

  • Non, toutes les sous-propriétés DOIVENT être sur des éléments dans leurs parents.

Pouvez-vous utiliser des chaînes de requête sur l'email

Que s'est t'il passé à la "Query String" sur mon adresse email ?

  • Les "Query strings" sont ôtées des adresses email parce qu'elles ne sont pas valides pour l'importation vers des vCards.

Quels types d'email pouvez-vous spécifier

Quels types d'email pouvez-vous spécifier ? La section RFC2426 3.3.2 dit "A non-standard value can also be specified." Est-ce que cela fait référence à une valeur d'adresse e-mail non-standard ou à une valeur type ?

  • Vous ne pouvez uniquement spécifier que l'ensemble fixé des valeurs "type" documentées par hCard: adr tel email types, dans ce cas, pour la propriété email (non-sensible à la casse)
    • INTERNET
    • x400
    • pref

Est-ce que ADR et TEL sont sensibles à la casse

Est-ce que la liste des types possibles pour ADR et TEL sont sensibles à la casse ?

  • Non, les valeurs énumérées ne sont PAS sensibles à la casse, par conséquent, Home, home, HOME, etc sont toutes équivalentes.

Comment GEO fonctionne avec ABBR

Qu'arrive t'il aux sous-propriétés GEO quand GEO est utilisé avec ABBR ?

  • La propriété GEO peut être représentée de deux manières différentes :
<span class="geo">
<span class="latitude">123.45</span>
<span class="longitude">67.89</span>
</span>

<abbr class="geo" title="123.45;67.89">Ma Maison</abbr>

Quand utilisée avec un élément <abbr> la latitude et la longitude sont séparées par un point-virgule.

Pourquoi hCard utilise vcard comme nom de classe racine

hCard correspond aux propriétés et valeurs du standard vCard (RFC2426), de ce fait il utilise le nom de classe vcard dans la syntaxe HTML. Plus d'historique sur les raisons derrière cette décision ici : hCard Parsing : Nom de Classe Racine.

Comment balisez-vous une extension 'téléphone'

Comment je balise une extension téléphone dans hCard ? Il ne semble pas y avoir de manière de déclarer une extension téléphone dans la spéc. vCard RFC2426, le moyen actuel suggéré est en ce moment :

<span class="tel">
    <span class="type">cell</span>: <span class="value">800 555-1212 x 1234</span>
</span>

Comment encodez-vous les comptes de Messagerie Instantanée

Comment j'encode mon compte de messagerie instantanée dans hCard ?

Pouvez-vous hCard'er' les morts

Comment produisez-vous une hCard pour les décédés ?

  • Les vCards n'ont jamais été conçues pour gérer les dates de décès, référez-vous svp au microformat biographique ou genealogy-formats

Un plan pour les xparams

Y'a t'il des plans pour inclure les x-parameters dans les futures versions de hCard ?

  • Non. Le problème est que chacun de ces x-parameters sont spécifiques aux vendeurs et ne font pas partie de la RFC. Deuxièmement, il n'y pas de de moyen d'être sûr à 100% que 'x-foobar' n'est pas simplement un nom de classe de contenu spécifique HTML que l'éditeur est en train d'utiliser pour la mise en style CSS.

Qu'est-ce qu'un mot dans les optimisations implicites

Que représente un "mot" pour l'objectif de 'implied-n optimization'?

  • "N" peut être sous-entendu à partir de "FN" quand le contenu de "FN" est coupé en deux "mots" séparés par un espace blanc. Pour cet objectif, un "mot" est n'importe quelle séquence de caractères sans espace blanc inclus mais non limité à quelque gamme alphanumérique basse et haute et à quelque ponctuation. Un "mot" peut être caractérisé par l'expression régulière suivante :
    /\S+/
    

Comment créez-vous des attributs de titres qui ne soient pas en anglais

"Mon site web n'est pas en anglais et je veux que les attributs de titres (qualifiés de bulles d'affichage par certains navigateurs) soient dans ma langue natale."

  • Les propriétés telles que class="type" exigent une liste énumérée de mots anglais. Il est possible d'utiliser votre langue natale pour le titre affiché, mais elle utilise encore les mots anglais 'work' 'home' pour class="type" sans qu'il ne s'affiche.
<abbr class="type" title="home">
 <span title="[le mot de votre langue natale pour domicile ici]">
  à mon domicile</span>
</abbr>

Avoir un span avec un attribut title dans l'élément abbr n'affichera seulement que le 'title' sur le span, où vous avez le texte (votre mot en langue natale pour domicile ici).

Comment ajoutez-vous des catégories à une hCard

Comment ajoutez-vous des catégories à une hCard ?

  • La réponse courte est, utilisez class="category" et rel="tag", par ex. si vous voulez taguez quelqu'un avec la catégorie "microformats", vous mettriez ça dans sa hCard :
<a class="category" rel="tag" 
   href="http://fr.wikipedia.org/wiki/microformats">microformats</a>

Quel est le rapport entre category et rel-tag

Quelle est la relation entre la propriété CATEGORY et rel-tag ?

  • Les catégories peuvent optionnellement être représentées comme des tags. Le nom de classe 'category' DOIT toujours être utilisé, mais rel="tag" peut être utilisé optionnellement (en plus). Dans le cas où rel-tag est utilisé, le tag (tel que défini par rel-tag) est utilisé pour la catégorie : Exemples :
<span class="category">food</span>
<a class="category" rel="tag" href="http://example.com/food">Food</a>

Pourquoi ne pas placer le type pour tel ou adr à l'intérieur de class

Pourquoi ne pas placer la valeur 'type' pour les propriétés 'tel' ou 'adr' à l'intérieur du nom de classe ? Par ex.

<span class="fax">(415) 555-1212</span>

  • Cela fût véritablement essayé et rejeté parce que cela constituait un anti-design-pattern. Le "type" dans ce cas est en fait un "tag" sur le numéro de téléphone, qui est du contenu lisible par un humain, et de ce fait devrait être visible, plutôt que caché dans un attribut de classe invisible. En outre, polluer l'attribut class avec du contenu texte le rend significativement plus dur à utiliser pour l'usage voulu, qui est d'ajouter/de raffiner la sémantique de noms d'éléments existants.

Comment baliser plusieurs adresses

Comment puis-je baliser des adresses distinctes, comme pour domicile et travail ?

  • Vous avez besoin de deux éléments avec les noms de classes "adr" et les sous-propriétés appropriées. Par ex. dérivé à partir des exemples de hCard :
<div class="adr">
 <span class="type">home</span> address:
 <div class="street-address">123 Main Street</div>
 <span class="locality">Any Town</span>, <span class="region">CA</span>, 
 <span class="postal-code">91921-1234</span>
</div>
<div class="adr">
 <span class="type">work</span> address:
 <div class="street-address">789 Main Street</div>
 <span class="locality">Any Town</span>, <span class="region">CA</span>, 
 <span class="postal-code">91921-1234</span>
</div>

En tant que résultat, remarquez que chaque élément avec un nom de classe "adr" est traité comme une adresse séparée avec ses propres sous-propriétés et valeurs.

Et si vous avez une hCard en France, on peut localiser les attributs de titres :

<div id="hcard" class="vcard">
  <span class="fn n">
  <span class="given-name">Prénom</span>
  <span class="additional-name">Nom1</span>
  <span class="family-name">VraiNom</span>
  </span>
  <div class="org">Picoformats Ltd</div>
  <div class="adr">
  <abbr class="type" title="home">
  <span title="infobulle pour adresse domicile">adresse domicile :</span>
  <div class="street-address">1 rue des Poissonniers</div>
  <span class="postal-code">75001</span> <span class="locality">Paris</span> 
  <span class="country-name">France</span></abbr>
  </div>

  <div class="adr">
  <abbr class="type" title="work">
  <span title="adresse coworking cantinecamp">adresse coworking :</span>
  <div class="street-address">123 rue Paul Klee</div>
  <span class="postal-code">75013</span> <span class="locality">Paris</span> 
  <span class="country-name">France</span></abbr>
  </div>
</div>


Pourquoi le alt IMG n'a pas été choisi

J'ai mon nom dans un attribut alt d'<img> et il n'est pas sélectionné par les outils de hCard. Pourquoi pas ?

Vous pouvez utiliser la valeur alt de <img> afin de spécifier n'importe quelle valeur de propriété texte (à savoir pas une URL) en plaçant le nom de classe directement sur l'élément <img> lui-même. D'autres alterantives d'éléments sont documentées dans hCard : Lisible par les Humains vs lisible par les machines.

Voici un exemple de le produire FAUX et la façon correcte d'y aller. L'espace blanc a été ajouté pour la lisibilité :

FAUX

<span class="vcard">
 <a class="url fn photo" href="http://tantek.com">
  <img src="http://tantek.com/icon80.jpg" alt="Tantek Çelik" />
 </a>
</span>

BON

Remarquez la migration des noms de classes "fn" et "photo" à partir du <a> vers l'<img>

<span class="vcard">
 <a class="url" href="http://tantek.com">
  <img class="fn photo" src="http://tantek.com/icon80.jpg" alt="Tantek Çelik" />
 </a>
</span>

Certains ont suggéré de faire que le alt IMG (et d'autres alternatives textuelles équivalentes) fasse toujours partie des valeurs de propriété environnantes, et que même si ce peut initialement sembler séduisant, ceci fût délibérément rejeté lors de la création de hCard pour donner plus de contrôle aux éditeurs.

En outre il y a aussi bien trop souvent du "détritus" (ou simplement du texte non voulu) dans les attributs alt pour une quantité de raisons dépendant des auteurs, et ce texte étranger polluerait autrement les valeurs de propriétés propres dans de nombreux sites existantes.

De ce fait, seulement si l'auteur veut le texte extrait de l'attribut, il ajoutera la valeur de classe respective pour l'obtenir.

Pour finir, il est plus simple et plus prévisible pour les auteurs, s'il savent que pour les images et autres éléments URLs en rapport (a, objet, etc) que s'ils spécifient une propriété URL (comme "email", "photo", "url", etc.) ou une propriété texte (comme "fn", "nickname", etc.) dans tous les cas directement, spécifier la propriété sur l'élément est la façon de faire ça.

Comment marquer chaque ADR avec un GEO

J'ai une hCard avec plusieurs adresses. Comment marquer chaque ADR avec un GEO ?

  • Réponse rapide : ne le faite pas. Voir aussi Est-ce qu'un GEO peut être inféré à partir d'une ADR dans une hCard.
  • Plus long : il y a deux raisons pour ne pas marquer une ADR avec un GEO :
    • Tout d'abord et le plus important, ADR et GEO ne veulent pas dire la même chose, par conséquent vous NE DEVEZ PAS simplement marquer une ADR avec un GEO.
    • Deuxièmement, si vous les considériez vraiment comme étant la même information, vous ne devriez pas faire ainsi pour des raisons de DRY (Don't Repeat Yourself). La duplication d'information accroît la probabilité d'information incohérente du fait d'une copie étant mise à jour sans que l'autre ne soit mise à jour.
  • Détails : ADR et GEO représentent différentes sémantiques, une ADR représentant une adresse de l'object hCard (de ce fait les hCards peuvent avoir plusieurs ADRs), tandis qu'un GEO s'il est présent représente le lieu physique de l'objet hCard (de ce fait une hCard peut avoir au plus un unique GEO). En outre, ils représentent des types de données différentes, à savoir une ADR représente un domaine de terrain qui est un polygone (ou peut-être un espace dans un building qui est un polyedre), tandis qu'un GEO ne représente uniquement qu'un point unique.

    Essayer de dupliquer une ADR avec une propriété GEO avec des coordonnées avoisinantes/représentatives (par ex que vous pourriez dériver en utilisant un service en ligne de cartographie) est aussi non désirable du fait de la perspective DRY pour tous les doublons habituels obtenus lors des problèmes de non synchronisation.

Comment je marque un lieu non structuré

Si j'ai un champ de lieu qui n'est pas structuré, comme je le marque ? Je pourrais avoir un utilisateur qui saisit "San Francisco" ou "San Francisco, CA" ou "USA", etc.

  • Réponse rapide : utiliser la propriété "label" et aussi la propriété "adr" sans les sous-propriétés (à cette heure). Par ex.
<span class="label adr">San Francisco, CA</span>
  • Plus long :
    1. La propriété "label" fonctionne bien pour marquer un lieu non structuré, mais gardez à l'esprit que seule une peut être fournie (en pratique, nous devons encore trouver un service qui publie *plusieurs* adresses non structurées pour une personne ou organisation - s'ils vont avoir le problème de publier plusieurs adresses, il font aussi généralement le travail minimal de les structurer).
    2. Utiliser la propriété "adr" (sans ses sous-propriétés) indiques au moins la sémantique qu'il *y avoir* des composants d'adresses dans la donnée, et indiquer même que la sémantique est meilleure que d'indiquer pas de sémantique. Bien que les parseurs actuels de hCards n'extrairont probablement pas quelque information adr d'un tel marquage (même s'ils vons dans le "label" non structuré, ce qui est mieux que rien), il y a quelque brainstorming en cours sur la façon d'essayer d'extraire de la structure d'une "adr" non structurée, et de ce fait les parseurs futurs pourraient faire plus d'usage d'un tel marquage.

Dates Partielles ou Un Gentleman Ne Demande Jamais

  • Je veux marquer la date de naissance de quelqu'un, mais ne sait pas en quelle année elle est née.
  • Je veux marquer la date de naissance de quelqu'un, mais ne connaît que l'année à laquelle elle est née.

Le modèle-de-design-de-date recommande d'utiliser les dates ISO 8601, compatible avec W3CDTF ou RFC 3339 (qui sont tous deux des sous-ensembles de ISO 8601). Heureusement W3CDTF autorise les dates partielles. Par exemple :

  • <abbr class="bday" title="2008-09">Sept 2008</abbr>
  • <abbr class="bday" title="2008">2008</abbr>

De telles dates sont supportées par la plupart des parseurs de microformats. ISO 8601 autorise aussi à ce que les dates soient fournies sans l'année (et même sans le mois) :

  • <abbr class="bday" title="--09-01">1 Sept</abbr>
  • <abbr class="bday" title="---01">le premier du mois</abbr>

Ces dates ne sont pas compatibles avec W3CDTF ou RFC 3339, et on un support moins large dans les parseurs de microformats. Il devrait être aussi noté que la spécification vCard requiert que les dates incluent les années, aussi même si votre parseur microformat supporte l'un de ces formats, il devrait probablement remplir une date stupide au moment de produire une sortie vCard.

Qu'est-ce que AGENT

Qu'est-ce que la propriété "agent" dans la hCard ?

De Ben Ward sur IRC

En contexte d'affaires, la vcard principale serait par exemple ‘Dana B. Lawyer’, et sa vcard contient un AGENT pour ‘Joe Secretary’. C'est quelqu'un qui agit en tant que 'agent' de la personne principale.

Les hCards peuvent-elles utiliser des variantes de propriétés comme Given-Name ou country

Les hCards peuvent-elles utiliser des variantes de propriétés comme "Given-Name" ou "country"?

Non. Seuls les noms de propriétés précis en bas de casse dans la spec hCard sont valides. (voir en rapport sensibles à la casse).

Les variations suivantes que les personnes ont demandées sont toutes invalides et DOIVENT être ignorées dans les hCards :

  • Given-Name - les propriétés microformats sont toutes en bas de casse, utilisez given-name
  • Family-Name - ""
  • Street-Address - ""
  • country - utilisez country-name

Chacune d'entre elles pourraient peut-être former la base d'un simple test d'erreur de parsage de hCard. Voir aussi :


Pages Apparentées

La spécification hCard est un chantier en cours. Au fur et à mesure que des aspects supplémentaires sont discutés, compris et écrits, ils seront rajoutés. Ces idées, problématiques et questions sont maintenues sur des pages distinctes.