FAQ hCard

Jump to: navigation, 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.

Contents

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 ?

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 ?

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.

<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.

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.

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 ?

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 ?

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 ?

Ancienne réponse :

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 ?

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

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 ?

Comment marquez-vous les suffixes

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

<abbr class="honorific-suffix" title="Junior">Jr.</abbr>


Comment le genre est représenté

Comment représentez-vous le sexe dans hCard ?

<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 ?

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 ?

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>"

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 ?

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 ?

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 ?

<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 ?

<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 ?

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 ?

<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" ?


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 ?

<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"?

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 ?

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 ?

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 ?

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 ?

Comment GEO fonctionne avec ABBR

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

<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 ?

Un plan pour les xparams

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

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

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

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."

<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). </ol>

Comment ajoutez-vous des catégories à une hCard

Comment ajoutez-vous des catégories à une 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 ?

<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>

Comment baliser plusieurs adresses

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

<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 ?

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.

<span class="label adr">San Francisco, CA</span>

Dates Partielles ou Un Gentleman Ne Demande Jamais

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 :

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) :

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 :

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.

FAQ hCard was last modified: Wednesday, November 11th, 2009

Views