hcard-faq-fr

From Microformats Wiki
Revision as of 23:04, 2 September 2007 by ChristopheDucamp (talk | contribs)
Jump to navigation Jump to search

FAQ hCard

Cette page est pour documenter les Q&R à propos de hCard. Si vous avez une nouvelle question à poser, considérez svp tout d'abord de poser votre question 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

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échrgement 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 le fil de service Technorati Contacts dans un hyperlien c'est à dire :
<a href="http://feeds.technorati.com/contacts/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 Technorati Contacts Feed 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.

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.


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

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.

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 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 une construction qui est un polygône, tandis qu'un GEO ne représente qu'un point unique

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>
 &lt;<a class="email" href="mailto:Email@exemple.com">Email@exemple.com</a>&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>

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

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>

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>

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.

Retrieved from "http://microformats.org/wiki/index.php?title=hcard-faq-fr&oldid=20984"