hcard-examples-fr: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
m (hcard-examples translation / to be reviewed)
Line 231: Line 231:
Administration Chantier, Assistant
Administration Chantier, Assistant


=== 3.1.1 FN Définition Type ===
=== 3.1.1 Définition Type FN  ===


<pre><nowiki>
<pre><nowiki>
Line 247: Line 247:
M. Jean Q. Public, Dr.
M. Jean Q. Public, Dr.


=== 3.1.2 N Type Definition ===
=== 3.1.2 Définition Type N ===


==== Exemple 1 ====
==== Exemple 1 ====
Line 296: Line 296:
Dr. John Philip Paul Stevenson, Jr., M.D., A.C.P.
Dr. John Philip Paul Stevenson, Jr., M.D., A.C.P.


=== 3.1.3 PSEUDO Type Definition ===
=== 3.1.3 Définition Type NICKNAME (pseudo) ===


==== Exemple 1 ====
==== Exemple 1 ====
Line 331: Line 331:
Jim, Jimmie
Jim, Jimmie


=== 3.1.4 PHOTO Type Definition ===
=== 3.1.4 Définition Type PHOTO ===


==== Exemple 1 ====
==== Exemple 1 ====
Line 361: Line 361:
</nowiki></pre>
</nowiki></pre>


=== 3.1.5 BDAY Type Definition ===
=== 3.1.5 Définition Type BDAY ===


==== Exemple 1 ====
==== Exemple 1 ====
Line 411: Line 411:
<abbr class="bday" title="1987-09-27T08:30:00-06:00">9 septembre 1987</abbr>
<abbr class="bday" title="1987-09-27T08:30:00-06:00">9 septembre 1987</abbr>


=== 3.2.1 ADR Type Definition ===
=== 3.2.1 Définition Type ADR ===


<pre><nowiki>
<pre><nowiki>
Line 443: Line 443:
</div>
</div>


=== 3.2.2 LABEL Type Definition ===
=== 3.2.2 Définition Type LABEL ===


<pre><nowiki>
<pre><nowiki>
Line 487: Line 487:
</pre>
</pre>


=== 3.3.1 TEL Type Definition ===
=== 3.3.1 Définition Type TEL ===


<pre><nowiki>
<pre><nowiki>
Line 509: Line 509:
mon téléphone professionnel avec messagerie vocale : +1-213-555-1234
mon téléphone professionnel avec messagerie vocale : +1-213-555-1234


=== 3.3.2 EMAIL Type Definition ===
=== 3.3.2 Définition Type EMAIL ===


==== Exemple 1 ====
==== Exemple 1 ====
Line 517: Line 517:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment:
ce fragment vCard comme un fragment hCard :  


<pre><nowiki>
<pre><nowiki>
Line 523: Line 523:
</nowiki></pre>
</nowiki></pre>


this hCard fragment could be displayed as:
ce fragment hCard pourrait s'afficher ainsi


[mailto:jqpublic@xyz.dom1.com email jqpublic]
[mailto:jqpublic@xyz.dom1.com email jqpublic]
Line 533: Line 533:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment:
ce fragment vCard comme un fragment hCard :  


<pre><nowiki>
<pre><nowiki>
Line 539: Line 539:
</nowiki></pre>
</nowiki></pre>


this hCard fragment could be displayed as:
ce fragment hCard pourrait s'afficher ainsi


[mailto:jdoe@isp.net email jdoe]
[mailto:jdoe@isp.net email jdoe]
Line 546: Line 546:


<pre><nowiki>
<pre><nowiki>
EMAIL;TYPE=internet,pref:jane_doe@abc.com
EMAIL;TYPE=internet,pref:jeanne_doe@abc.com
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment:
ce fragment vCard comme un fragment hCard :  


<pre><nowiki>
<pre><nowiki>
<a class="email" href="mailto:jane_doe@abc.com">
<a class="email" href="mailto:jeanne_doe@abc.com">
  <abbr class="type" title="pref">preferred</abbr>  
  <abbr class="type" title="pref">preferred</abbr>  
  email for jane_doe
  email préféré pour jeanne_doe
</a>
</a>
</nowiki></pre>
</nowiki></pre>


this hCard fragment could be displayed as:
ce fragment hCard pourrait s'afficher ainsi


[mailto:jane_doe@abc.com preferred email for jane_doe]
[mailto:jeanne_doe@abc.com email préféré pour jeanne_doe]


=== 3.3.3 MAILER Type Definition ===
=== 3.3.3 Définition Type MAILER ===


<pre><nowiki>
<pre><nowiki>
Line 568: Line 568:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment:
ce fragment vCard comme un fragment hCard :  


<pre><nowiki>
<pre><nowiki>
Jane Doe uses <span class="mailer">PigeonMail 2.1</span> for email.
Jeanne Doe utilise <span class="mailer">PigeonMail 2.1</span> pour l'email.
</nowiki></pre>
</nowiki></pre>


this hCard fragment could be displayed as:
ce fragment hCard pourrait s'afficher ainsi


Jane Doe uses <span class="mailer">PigeonMail 2.1</span> for email.
Jane Doe utilise <span class="mailer">PigeonMail 2.1</span> pour l'email.


=== 3.4.1 TZ Type Definition ===
=== 3.4.1 Définition Type TZ ===


==== Exemple 1 ====
==== Exemple 1 ====
Line 586: Line 586:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment:
ce fragment vCard comme un fragment hCard :  


<pre><nowiki>
<pre><nowiki>
Line 592: Line 592:
</nowiki></pre>
</nowiki></pre>


this hCard fragment could be displayed as:
ce fragment hCard pourrait s'afficher ainsi


-05:00
-05:00
Line 602: Line 602:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment:
ce fragment vCard comme un fragment hCard :  


<pre><nowiki>
<pre><nowiki>
Line 611: Line 611:
</nowiki></pre>
</nowiki></pre>


this hCard fragment could be displayed as:
ce fragment hCard pourrait s'afficher ainsi


<abbr class="tz" title="-05:00; EST; Raleigh/North America;This example has a single value, not a structure text value.">EST</abbr>
<abbr class="tz" title="-05:00; EST; Raleigh/North America;This example has a single value, not a structure text value.">EST</abbr>


=== 3.4.2 GEO Type Definition ===
=== 3.4.2 Définition Type GEO ===


<pre><nowiki>
<pre><nowiki>
Line 621: Line 621:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment:
ce fragment vCard comme un fragment hCard :  


<pre><nowiki>
<pre><nowiki>
Line 630: Line 630:
</nowiki></pre>
</nowiki></pre>


this hCard fragment could be displayed as:
ce fragment hCard pourrait s'afficher ainsi


37.386013, -122.082932
37.386013, -122.082932


=== 3.5.1 TITLE Type Definition ===
=== 3.5.1 Définition Type TITLE ===


<pre><nowiki>
<pre><nowiki>
TITLE:Director\, Research and Development
TITLE:Directeur\, Recherche et Développement
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment:
ce fragment vCard comme un fragment hCard :  


<pre><nowiki>
<pre><nowiki>
<span class="title">Director, Research and Development</span>
<span class="title">Directeur, Recherche et Développement</span>
</nowiki></pre>
</nowiki></pre>


this hCard fragment could be displayed as:
ce fragment hCard pourrait s'afficher ainsi


Director, Research and Development
Directeur, Recherche et Développement


=== 3.5.2 ROLE Type Definition ===
=== 3.5.2 Définition Type ROLE ===


<pre><nowiki>
<pre><nowiki>
ROLE:Programmer
ROLE:Programmeur
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment:
ce fragment vCard comme un fragment hCard :  


<pre><nowiki>
<pre><nowiki>
<span class="role">Programmer</span>
<span class="role">Programmeur</span>
</nowiki></pre>
</nowiki></pre>


this hCard fragment could be displayed as:  
ce fragment hCard pourrait s'afficher ainsi :


Programmer
Programmeur


=== 3.5.3 LOGO Type Definition ===
=== 3.5.3 Définition Type LOGO ===


==== Exemple 1 ====
==== Exemple 1 ====
Line 674: Line 674:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment
ce fragment vCard comme un fragment hCard :


<pre><nowiki>
<pre><nowiki>
Line 680: Line 680:
</nowiki></pre>
</nowiki></pre>


this hCard fragment could be displayed as (note: I used a real URL for the image):  
ce fragment hCard pourrait s'afficher ainsi : (note : j'ai utilisé un URL véritable pour l'image) :  


http://microformats.org/img/mf-lg-ora.gif
http://microformats.org/img/mf-lg-ora.gif
Line 694: Line 694:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment
ce fragment vCard comme un fragment hCard :


<pre><nowiki>
<pre><nowiki>
Line 703: Line 703:
</nowiki></pre>
</nowiki></pre>


no display equivalent given, since data: URL from original example is incomplete.
aucun affichage équivalent donné, parce que ce sont des données : URL tiré de l'exemple original incomplet.


=== 3.5.4 AGENT Type Definition ===
=== 3.5.4 Définition Type AGENT ===


==== Exemple 1 ====
==== Exemple 1 ====
Line 714: Line 714:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment
ce fragment vCard comme un fragment hCard :


<pre><nowiki>
<pre><nowiki>
Line 720: Line 720:
</nowiki></pre>
</nowiki></pre>


this hCard fragment could be displayed as:
ce fragment hCard pourrait s'afficher comme :  


JQPUBLIC
JQPUBLIC
Line 731: Line 731:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment
ce fragment vCard comme un fragment hCard :


<pre><nowiki>
<pre><nowiki>
Line 740: Line 740:
</nowiki></pre>
</nowiki></pre>


this hCard fragment could be displayed as:  
ce fragment hCard pourrait s'afficher comme :  


[mailto:sthomas@host.com Susan Thomas], +1-919-555-1234
[mailto:sthomas@host.com Susan Thomas], +1-919-555-1234


Note: the vCard in the AGENT property vCard fragment is actually invalid since it lacks an "N" property.  However, the hCard version *is* valid, since I added the "n" class name to the example.
Note : la vCard dans la propriété AGENT du fragment vCard est en fait invalide parce qu'il lui manque la propriété "N".  Néanmoins, la version hCard *est* valide, parce que j'ai ajouté le nom de classe "n" à l'exemple.


=== 3.5.5 ORG Type Definition ===
=== 3.5.5 Définition Type ORG ===


<pre><nowiki>
<pre><nowiki>
Line 752: Line 752:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment:
ce fragment vCard comme un fragment hCard :  


<pre><nowiki>
<pre><nowiki>
Line 762: Line 762:
</nowiki></pre>
</nowiki></pre>


this hCard fragment could be displayed as:
ce fragment hCard pourrait s'afficher comme :  


ABC, Inc., North American Division, Marketing
ABC, Inc., North American Division, Marketing


=== 3.6.1 CATEGORIES Type Definition ===
=== 3.6.1 Définition Type CATEGORIES ===


==== Exemple 1 ====
==== Exemple 1 ====
Line 774: Line 774:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment:
ce fragment vCard comme un fragment hCard :  


<pre><nowiki>
<pre><nowiki>
Line 780: Line 780:
</nowiki></pre>
</nowiki></pre>


this hCard fragment could be displayed as:
ce fragment hCard pourrait s'afficher comme :  


TRAVEL AGENT
TRAVEL AGENT
Line 791: Line 791:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment:
ce fragment vCard comme un fragment hCard :  


<pre><nowiki>
<pre><nowiki>
Line 800: Line 800:
</nowiki></pre>
</nowiki></pre>


this hCard fragment would be displayed as:
ce fragment hCard pourrait s'afficher comme :  


INTERNET, IETF, INDUSTRY, INFORMATION TECHNOLOGY
INTERNET, IETF, INDUSTRY, INFORMATION TECHNOLOGY
Line 811: Line 811:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment:
ce fragment vCard comme un fragment hCard :  


<pre><nowiki>
<pre><nowiki>
Line 817: Line 817:
</nowiki></pre>
</nowiki></pre>


this hCard fragment could be displayed as:
ce fragment hCard pourrait s'afficher comme :  


This fax number is operational 0800 to 1715 EST, Mon-Fri.
This fax number is operational 0800 to 1715 EST, Mon-Fri.
Line 827: Line 827:
</nowiki></pre>
</nowiki></pre>


Note, this vCard property actually doesn't make sense as a  hCard property, since it really should be filled in by whatever code transforms the hCard into a vCard, e.g. Brian Suda's X2V.
Note, cette propriété vCard ne fait véritablement pas de sens comme propriété hCard, parce qu'elle devrait être vraiment remplie par tout ce que peut transformer le code hCard en vCard, par ex. Brian Suda's X2V.


=== 3.6.4 REV Type Definition ===
=== 3.6.4 Définition Type REV ===


==== Exemple 1 ====
==== Exemple 1 ====
Line 837: Line 837:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment:
ce fragment vCard comme un fragment hCard :  


<pre><nowiki>
<pre><nowiki>
Line 843: Line 843:
</nowiki></pre>
</nowiki></pre>


this hCard fragment could be displayed as:
ce fragment hCard pourrait s'afficher comme :  


<abbr class="rev" title="1995-10-31T22:27:10Z">Updated: 10/31 10:27p</abbr>
<abbr class="rev" title="1995-10-31T22:27:10Z">Updated: 10/31 10:27p</abbr>
Line 853: Line 853:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment:
ce fragment vCard comme un fragment hCard :  


<pre><nowiki>
<pre><nowiki>
Line 859: Line 859:
</nowiki></pre>
</nowiki></pre>


this hCard fragment could be displayed as:
ce fragment hCard pourrait s'afficher comme :  


<abbr class="rev" title="1997-11-15">Updated: November 15</abbr>
<abbr class="rev" title="1997-11-15">Updated: November 15</abbr>


=== 3.6.5 SORT-STRING Type Definition ===
=== 3.6.5 Définition Type SORT-STRING ===


==== Exemple 1 ====
==== Exemple 1 ====
Line 873: Line 873:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment:
ce fragment vCard comme un fragment hCard :  


<pre><nowiki>
<pre><nowiki>
Line 889: Line 889:
</nowiki></pre>
</nowiki></pre>


Note: The string "Harten" was NOT repeated in the hCard, even though it WAS repeated in the vCard (3 times! In N, FN, and SORT-STRING).  The "SORT-STRING" property provides another good demonstration of how hCard enables better adherence to the [http://microformats.org/wiki/hcard-example1-steps#hCard_example_iteration_1:_DRY DRY principle] than vCard.
Note : La chaîne "Harten" n'a PAS été répétée dans le hCard, même s'il ETAIT répété dans la vCard (3 fois ! dans N, FN, et SORT-STRING).  La propriété "SORT-STRING" fournit une autre bonne démonstration sur la façon dont hCard permet une meilleure adhérence au  [http://microformats.org/wiki/hcard-example1-steps-fr#exemple_hCard_it.C3.A9ration_1_:_DRY principe DRY] que la vCard.


this hCard fragment could be displayed as:
ce fragment hCard pourrait s'afficher comme :  


Sir Rene van der Harten (J.), R.D.O.N.
Sir Rene van der Harten (J.), R.D.O.N.
Line 903: Line 903:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment:
ce fragment vCard fragment comme un fragment hCard :  


<pre><nowiki>
<pre><nowiki>
Line 913: Line 913:
</nowiki></pre>
</nowiki></pre>


Note: Not only was the string "Pau" was NOT repeated in the hCard (better [http://microformats.org/wiki/hcard-example1-steps#hCard_example_iteration_1:_DRY DRY principle] adherence again), even though it WAS repeated in the vCard, but in this case since the "family-name" and "sort-string" are the same, we were able to use [http://microformats.org/wiki/hcard-example1-steps#hCard_example_iteration_2:_element_conservation element conservation] and use only one element for both properties.
Note : Non seulement la chaîne "Pau" n'était PAS répétée dans le hCard (meilleure adhérence à nouveau au better [http://microformats.org/wiki/hcard-example1-steps-fr#exemple_hCard_it.C3.A9ration_1_:_DRY principe DRY]), même s'il elle ETAIT répétée dans la vCard, mais dans ce cas du fait que "family-name" et "sort-string" sont les même, nous avons pu utiliser la [http://microformats.org/wiki/hcard-example1-steps-fr#Exemple_hCard_it.C3.A9ration_2_:_conservation_.C3.A9l.C3.A9ment conservation élément] et n'utiliser qu'un élément pour les deux propriétés.


this hCard fragment could be displayed as:
ce fragment hCard pourrait être affiché ainsi :


Robert Pau Shou Chang
Robert Pau Shou Chang
Line 927: Line 927:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment:
ce fragment vCard fragment comme un fragment hCard :  


<pre><nowiki>
<pre><nowiki>
Line 935: Line 935:
</nowiki></pre>
</nowiki></pre>


Note: This example, in addition to illustrating better support for the [http://microformats.org/wiki/hcard-example1-steps#hCard_example_iteration_1:_DRY DRY principle], also makes use of the [http://microformats.org/wiki/hcard#Implied_.22N.22_Optimization Implied "N" Optimization].
Note : Cet exemple, en plus de mieux illustrer le meilleur support du [http://microformats.org/wiki/hcard-example1-steps-fr#exemple_hCard_it.C3.A9ration_1_:_DRY principe DRY], fait aussi usage de l'[http://microformats.org/wiki/hcard-fr#Optimisation_implicite_.22n.22 optimisation implicite "N"].


this hCard fragment could be displayed as:
ce fragment hCard pourrait être affiché ainsi :


Osamu Koura
Osamu Koura
Line 949: Line 949:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment:
ce fragment vCard fragment comme un fragment hCard :  


<pre><nowiki>
<pre><nowiki>
Line 963: Line 963:
</nowiki></pre>
</nowiki></pre>


Note: This example unfortunately could not completely adhere to the DRY principle due to the "FN" using a *substring* of the family-name, and in addition thus had to hide the extra "family-name" string value using CSS display:none, which in general should be avoided.  Suggestion welcome for improvements on this hCard fragement.
Note : Malheureusement cet exemple pourrait ne pas complètement adhérer au principe DRY du fait du "FN" utilisant une *substring* du family-name, et en plus a dû par conséquent cacher la chaîne de valeur supplémentaire "family-name" en utilisant CSS display:none, ce qui en devrait être évité en général.  Suggestion bienvenue pour améliorations de ce fragment hCard.


this hCard fragment could be displayed as:
ce fragment hCard pourrait s'afficher comme :  


Oscar del Pozo
Oscar del Pozo
Line 977: Line 977:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment:
ce fragment vCard comme un fragment hCard :  


<pre><nowiki>
<pre><nowiki>
Line 985: Line 985:
</nowiki></pre>
</nowiki></pre>


Note: This example re-demonstrates the same hCard advantages/efficiencies demonstrated in [http://microformats.org/wiki/hcard-examples#Example_3_3 example 3] above.
Note : Cet exemple redémontre les avantages/l'efficacité démontrés dans l'[http://microformats.org/wiki/hcard-examples-fr#Exemple_3_3 exemple 3] au-dessus.


this hCard fragment could be displayed as:
ce fragment hCard pourrait s'afficher comme :


Christine d'Aboville
Christine d'Aboville


=== 3.6.6 SOUND Type Definition ===
=== 3.6.6 Définition Type SOUND ===


==== Exemple 1 ====
==== Exemple 1 ====
Line 1,000: Line 1,000:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment
ce fragment vCard comme un fragment hCard :


<pre><nowiki>
<pre><nowiki>
Line 1,009: Line 1,009:
</nowiki></pre>
</nowiki></pre>


this hCard fragment would probably be displayed as
ce fragment hCard pourrait s'afficher comme :


pronounciation of "JOHN Q PUBLIC"
prononciation de "JOHN Q PUBLIC"


unless your browser supports the MIME type "audio/basic" (defined in [http://www.rfc-editor.org/rfc/rfc2046.txt RFC2046 section 4.3]) and has some way of retrieving "CID:" urls.
à la condition que votre navigateur supporte le type MIME "audio/basic" (défini dans la [http://www.rfc-editor.org/rfc/rfc2046.txt RFC2046 section 4.3]) et ait quelque moyen de retrouver les urls "CID:".


==== Exemple 2 ====
==== Exemple 2 ====
Line 1,023: Line 1,023:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment
ce fragment vCard comme un fragment hCard :


<pre><nowiki>
<pre><nowiki>
Line 1,035: Line 1,035:
</nowiki></pre>
</nowiki></pre>


no display equivalent given, since data: URL from original example is incomplete.
pas d'affichage équivalent donné, parce que des données : l'URL de l'exemple original est incomplète.


=== 3.6.7 UID Type Definition ===
=== 3.6.7 Définition Type UID ===


<pre><nowiki>
<pre><nowiki>
Line 1,043: Line 1,043:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment
ce fragment vCard comme un fragment hCard :


<pre><nowiki>
<pre><nowiki>
Line 1,050: Line 1,050:
</nowiki></pre>
</nowiki></pre>


this hCard fragment could be displayed as
ce fragment hCard pourrait s'afficher comme :


Unique id:19950401-080045-40000F192713-0052
Unique id:19950401-080045-40000F192713-0052


Note: in practice I don't think I've seen globally unique IDs for "contact info" records published on the web, but perhaps I am not considering enough examples.
Note : en pratique, je ne pense pas que j'ai vu globalement des IDs uniques pour des enregistrements de "contact info" publiés sur le web, mais peut-être que je ne considère pas assez d'exemples.




=== 3.6.8 URL Type Definition ===
=== 3.6.8 Définition Type URL ===


<pre><nowiki>
<pre><nowiki>
Line 1,063: Line 1,063:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment
ce fragment vCard comme un fragment hCard :


<pre><nowiki>
<pre><nowiki>
Line 1,069: Line 1,069:
</nowiki></pre>
</nowiki></pre>


this hCard fragment could be displayed as
ce fragment hCard pourrait s'afficher comme :


[http://www.swbyps.restaurant.french/~chezchic.html Chez Chic]
[http://www.swbyps.restaurant.french/~chezchic.html Chez Chic]




=== 3.7.1 CLASS Type Definition ===
=== 3.7.1 Définition Type CLASS ===


==== Exemple 1 ====
==== Exemple 1 ====
Line 1,082: Line 1,082:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment
ce fragment vCard comme un fragment hCard :


<pre><nowiki>
<pre><nowiki>
Line 1,088: Line 1,088:
</nowiki></pre>
</nowiki></pre>


this hCard fragment could be displayed as
ce fragment hCard pourrait s'afficher comme :


PUBLIC
PUBLIC
Line 1,098: Line 1,098:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment
ce fragment vCard comme un fragment hCard :


<pre><nowiki>
<pre><nowiki>
Line 1,104: Line 1,104:
</nowiki></pre>
</nowiki></pre>


this hCard fragment could be displayed as
ce fragment hCard pourrait s'afficher comme :


PRIVATE
PRIVATE
Line 1,114: Line 1,114:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment
ce fragment vCard comme un fragment hCard :


<pre><nowiki>
<pre><nowiki>
Line 1,120: Line 1,120:
</nowiki></pre>
</nowiki></pre>


this hCard fragment could be displayed as
ce fragment hCard pourrait s'afficher comme :


CONFIDENTIAL
CONFIDENTIAL


=== 3.7.2 KEY Type Definition ===
=== 3.7.2 Définition Type KEY ===


<pre><nowiki>
<pre><nowiki>
Line 1,144: Line 1,144:
</nowiki></pre>
</nowiki></pre>


this vCard fragment as an hCard fragment
ce fragment vCard comme un fragment hCard :


<pre><nowiki>
<pre><nowiki>
Line 1,168: Line 1,168:
</nowiki></pre>
</nowiki></pre>


this hCard fragment could be displayed as
ce fragment hCard pourrait s'afficher comme :


Key
Key


Note: Because of the lack of a TYPE value in the RFC2426 example, I substituted application/octet-stream.  Clearly for it to be of some use, the type specified must be some sort of key or certificate mime type.
Note : Du fait du manque d'une valeur TYPE dans l'exemple RFC2426, j'ai substitué  application/octet-stream.  Clairement pour que ce soit de quelque utilité, le type spécifié doit être de quelque sorte de clé ou de "certificate mime type".


=== 7.  Adresses des Auteurs ===
=== 7.  Adresses des Auteurs ===
Line 1,203: Line 1,203:
</nowiki></pre>
</nowiki></pre>


Note that both of these vCards are invalid since they lack the REQUIRED "N" property which is quite ironic, since these are the vCards of the authors themselves.
Notez que ces deux vCards sont invalides parce qu'il manque la propriété REQUISE "N" qui est tout à fait ironique, parce que ce sont les vCards des auteurs eux-mêmes.


Nonetheless, these vCards can be represented by the following hCards:
Néanmoins, ces vCards peuvent être représentées par les hCards suivantes :  


<pre><nowiki>
<pre><nowiki>
Line 1,260: Line 1,260:
</nowiki></pre>
</nowiki></pre>


this hCards could be displayed as
ces hCards pourraient s'afficher comme :


<div class="vcard">
<div class="vcard">
Line 1,312: Line 1,312:
== Test de Casses ==
== Test de Casses ==


These are [[hcard|hCard]] examples which have been found to be particularly useful in finding bugs in hCard parsers (e.g. X2V).
Ce sont des exemples [[hcard-fr|hCard]] qui ont été trouvés particulièrement utiles pour trouver des bugs dans les parseurs hCard (par ex. X2V).


=== Problème avec Information BDAY ===
=== Problème avec Information BDAY ===


this example:
cet exemple :  


<pre>
<pre>
Line 1,328: Line 1,328:
</pre>
</pre>


ought to produce "BDAY:1985-10-27T00:00:00Z" but it produces "BDAY:Birthday October 27\, 1985". interesting is that the apple addressbook is still willing to accept it in this way.
devrait produire "BDAY:1985-10-27T00:00:00Z" mais il produit "BDAY:Birthday October 27\, 1985". Le fait intéressant est que le carnet d'adresses apple est encore en train de vouloir l'accpeter de cette façon.


=== case-INSENSITIVITY of type values ===
=== INSENSIBILITE à la casse des valeurs type ===


* "home" vs. "Home"
* "home" vs. "Home"


this example works with X2V:
cet exemple fonctionne avec X2V :


<pre>
<pre>
Line 1,343: Line 1,343:
</pre>
</pre>


this does not, but should. but instead it becomes just TEL without a type in the vcard
ceci non, mais le devrait. Mais au lieu de ça il devient simplement TEL sans un type dans la vcard


<pre>
<pre>
Line 1,353: Line 1,353:


=== GEO parsing ===
=== GEO parsing ===
The following hCard:
la hCard suivante :  


<pre><nowiki>
<pre><nowiki>
Line 1,386: Line 1,386:
</pre>
</pre>


Should be translated into the following vCard:
devrait être traduite dans la vCard suivante :


<pre><nowiki>
<pre><nowiki>
Line 1,401: Line 1,401:
</nowiki></pre>
</nowiki></pre>


X2V currently (2005-12-18) fails to parse/export the GEO property at all.
X2V (2005-12-18) échoue à cette heure pour parser/exporter la propriété GEO.


== Autre ==
== Autre ==


* Voir [[hcard-brainstorming]] pour plus d'exemples (qui peuvent éventuellement être migrés ici) et une analyse.
* Voir [[hcard-brainstorming]] pour plus d'exemples (qui peuvent éventuellement être migrés ici) et une analyse.

Revision as of 05:03, 26 June 2006

Exemples hCard

Exemples de hCards.

Auteurs

Exemples Instructifs

Auteurs de Pages et de Posts

Selon la spécification HTML4.01, "les auteurs peuvent employer l'élément <address> pour fournir les informations de contact du document ou d'une partie essentielle de celui-ci" c'est à dire 

<address>
 <a href="http://tantek.com/">Tantek Çelik</a>
</address>

En ajoutant hCard à un tel XHTML sémantique, vous pouvez indiquer explicitement le nom de la personne, son URL, etc. : 

<address class="vcard">
 <a class="fn url" href="http://tantek.com/">Tantek Çelik</a>
</address>

Ceci pourrait être affiché comme : 

Tantek Çelik

Ceci fonctionne non seulement pour l'ensemble de pages, mais aussi pour les "parties essentielles" des pages, par exemple les billets de blog.

Voir le blog microformats.org (visualisez la source) pour un exemple vivant. L'auteur de chaque billet de blog sur le blog microformats.org est balisé comme un élément <address class="vcard"> comme l'exemple montré ci-dessus.

Références aux Personnes et aux Organisations

Un modèle commun dans les posts de blog est de lier les citations des noms de personnes vers leurs blogs, et/ou les organisations vers leurs pages d'accueil. Par ex : 

<cite><a href="http://meyerweb.com/">Eric Meyer</a></cite> a écrit un billet 
(<cite><a href="http://meyerweb.com/eric/thoughts/2005/12/16/tax-relief/">Tax Relief</a></cite>) 
à propos d'une lettre involontairement humoristique qu'il a reçue du 
<a href="http://irs.gov/">Internal Revenue Service</a>.

En ajoutant hCard à un tel balisage, vous pouvez explicitement indiquer à la fois la personne et l'organisation par le nom et l'URL : 

<cite class="vcard"><a class="fn url" href="http://meyerweb.com/">Eric Meyer</a></cite> a écrit un billet (<cite><a href="http://meyerweb.com/eric/thoughts/2005/12/16/tax-relief/">Tax Relief</a></cite>) à propos d'une lettre involontairement humoristique qu'il a reçue du 
<span class="vcard"><a class="fn org url" href="http://irs.gov/">Internal Revenue Service</a>.

Remarquez les noms de classe "fn org url" sur l'hyperlien entourant IRS. Utiliser la même valeur (ou élément pour ce qui compte) pour "fn" et "org" indique que le hCard décrit une organisation plutôt qu'une personne.

Ceci pourrait être affiché comme : 

Eric Meyer a écrit un billet (Tax Relief) à propos d'une lettre involontairement humoristique qu'il a reçue du Internal Revenue Service.

hCard et XFN

Références vers des Personnes dans les Billets de Blog

Dans l'exemple au-dessus, une personne (le blogueur) fait référence à une autre personne (Eric Meyer). En plus d'utiliser hCard pour baliser explicitement la référence comme une personne, le blogueur peut utiliser XFN (Le XHTML Friends Network) pour indiquer sa relation avec Eric Meyer, par ex. : 

<cite class="vcard"><a class="fn url" rel="friend colleague met" href="http://meyerweb.com/">Eric Meyer</a></cite> a écrit un billet 
(<cite><a href="http://meyerweb.com/eric/thoughts/2005/12/16/tax-relief/">Tax Relief</a></cite>) 
à propos d'une lettre involontairement humoristique qu'il a reçue du 
<span class="vcard"><a class="fn org url" href="http://irs.gov/">Internal Revenue Service</a></span>.

Cela s'afficherait de la même façon que dans l'exemple précédent.

Références aux Personnes dans les Blogrolls

Beaucoup de blogueurs utilisent XFN (en utilisant souvent une interface utilisateur facile qui est construite dans WordPress) pour indiquer explicitement leurs relations avec les personnes dans leurs blogrolls : 

<ul>
 <li><a href="http://meyerweb.com" rel="friend colleague met">Eric Meyer</a></li>
 <li><a href="http://photomatt.net" rel="friend colleague met">Matt Mullenweg</a></li>
</ul>

En ajoutant le balisage hCard à une blogroll d'amis XFN, vous pouvez indiquer explicitement le nom et l'URL de la personne en plus de sa relation : 

<ul>
 <li class="vcard"><a class="fn url" href="http://meyerweb.com" rel="friend colleague met">Eric Meyer</a></li>
 <li class="vcard"><a class="fn url" href="http://photomatt.net" rel="friend colleague met">Matt Mullenweg</a></li>
</ul>

Ceci pourrait s'afficher comme :

Pour plus d'information sur XFN, voir la page d'accueil XFN, rejoindre XFN, et données de base sur XFN.

Nouveaux Types d'Information de Contact

Depuis que vCard a été conçu, il y a eu plusieurs autres services qui fournissent des individus avec des adresses ou d'autres moyens de contact, par ex. la messagerie instantanée, la voip, etc.

Est-ce que cela veut dire que vCard (et par conséquent hCard) doit être étendu pour les représenter ?

Grâce à la flexibilité de la propriété URL, la réponse est non, aucune extension n'est nécessaire. Au lieu de cela, nous utilisons l'URL appropriée pour le service qui identifie le service (protocole, machine et/ou chemin), et plaçon l'adresse de l'individu à l'intérieur de cela.

AOL Instant Messenger (AIM)

Les ids AOL Instant Messenger (AIM) peuvent être représentées en utilisant le protocole aim:. Beaucoup de personnes qui publient leurs ids AIM le font ainsi avec des URLs cliquables par ex : 

<a href="aim:goim?screenname=ShoppingBuddy">IM avec l'AIM ShoppingBuddy</a>

Par conséquent pour hCard, nous adopterons ce comportement existant d'éditeur, et le saisirons simplement comme un autre URL pour le hCard : 

<a class="url" href="aim:goim?screenname=ShoppingBuddy">IM avec l'AIM ShoppingBuddy</a>

Yahoo Messenger

De la même manière, les ids de Yahoo Instant Messenger (YIM) peuvent être représentées en utilisant le protocole ymsgr:. Et de la même manière, beaucoup publient leurs ids YIM comme des URLs cliquables par ex : 

<a href="ymsgr:sendIM?QuelqueAmiYahoo">IM avec QuelqueAmiYahoo</a>

A nouveau, pour hCard, nous adopterons ce comportement de pubication de contenu existant, et le saisirons simplement comme un autre URL pour le hCard : 

<a class="url" href="ymsgr:sendIM?QuelqueAmiYahoo">IM avec QuelqueAmiYahoo</a>

MSN Messenger

Malheureusement, AFAIK, il n'y a pas de protocole bricolé de facto pour ouvrir une session de messagerie instantanée MSN avec un identifiant utilisateur MSN (qui lui-même n'est qu'une adresse email). Par conséquent, nous devons simplement avoir recours à les baliser comme des adresses email, et s'attendre à ce que les consommateurs puisses utiliser quelque heuristique, telle que "les adresses email hotmail.com sont aussi des identifiants de MI MSN". -Tantek

Les ids de MSN Messenger (MSNIM) peuvent être représentées en utilisant le protocole msnim:. Et de la même façon, beaucoup publient leurs ids MSNIM comme des URLs cliquables par ex : 

<a href="msnim:chat?contact=jeandupont@hotmail.com">IM avec jeandupont@hotmail.com</a>

Pour hCard, nous adopterons ce comportement de publication existant et le saisirons simplement comme une autre URL pour le microformat hCard : 

<a class="url" href="msnim:chat?contact=jeandupont@hotmail.com">IM avec jeandupont@hotmail.com</a>

Mis à jour le 14 mai 2006 - Ruben

Ruben, j'ai essayé ça, et "msnim:" est un protocole non reconnu sur MacOSX.4 (ceci avec le dernier MSN Messenger pour Mac installé, et en état de marché et connecté). Pourriez-vous fournir des liens vers la documentation à propos de "msnim:" et des liens vers de vrais pages qui publient leurs ids MSNIM de cette manière ? Je n'en connais pas - Tantek

Profils de Sites

Les bloggers indiquent souvent leur identité sur les services d'hébergement de contenu en utilisant l'URL de leur page d'accueil, fil ou profil sur ces services. En les étiquetant comme des propriétés d'URL, ces facettes supplémentaires d'identité peuvent être aussi bien publiées dans hCard.

Organisations et Départements

Les départements sont balisés en utilisant le nom de classe "organization-unit" à l'intérieur de l'élément "org", avec le nom de l'organisation "organization-name" spécifiquement balisé pur le distinguer du département : 

<div class="vcard">
 <div class="org fn">
  <div class="organization-name">Pages Jaunes France</div> 
  <div class="organization-unit">Apprentissage et Plomberie : Design Microformats</div>
 </div>
</div>

Le département peut aussi faire partie de l'adresse, cas dans lequel vous pourrez vouloir le baliser explicitement comme "extended-address" (adresse étendue) en plus de "organization-unit". 

<div class="vcard">
 <div class="adr">
  <div class="org fn">
   <div class="organization-name">Pages Jaunes France</div>
   <div class="organization-unit extended-address">Apprentissage et Plomberie : Design Microformats</div>
  </div>
  <div class="street-address">7 avenue de la Cristallerie</div>
  <span class="locality">Sèvres</span>, 
  <abbr title="Ile de France" class="region">Ile de France</abbr>
  <span class="postal-code">92310</span>
 </div>
</div>

Noter qu'en imbriquant le org dans l'adresse, nous avons évité de dupliquer le nom du département.

Exemples RFC 2426 dans le hCard

Ce sont des exemples 1:1 de hCard pour chaque exemple dans la RFC 2426.

Mark Pilgrim a produit ces exemples de hCard disponibles sous des fichiers séparés :

2.4.2 VCARD

AGENT:BEGIN:VCARD\nFN:Jean Vendredi\nTEL:+1-919-555-7878\n
TITLE:Administration Chantier\, Assistant\n EMAIL\;TYPE=INTERNET:\n
jvendredi@host.com\nEND:VCARD\n

Ce fragment de vCard a une propriété dont la valeur est une autre vCard, et pourrait être représentée comme un fragment de hCard avec un Chard embarqué, littéralement (avec la valeur par défaut non nécessaire type=internet omise, et l'optimisation implicite n) : 

<div class="agent vcard">
 <a class="email fn" href="mailto:jvendredi@host.com">Jean Vendredi</a>
 <div class="tel">+1-919-555-7878</div>
 <div class="title">Administration Chantier, Assistant</div>
</div>

Ce hCard pourrait être affiché comme :

Jean Vendredi
+1-919-555-7878
Administration Chantier, Assistant

3.1.1 Définition Type FN

FN:M. Jean Q. Public\, Dr.

ce fragment vCard comme un fragment hCard : 

<span class="fn">M. Jean Q. Public, Dr.</span>

Ce fragment hCard pourrait être affiché comme :

M. Jean Q. Public, Dr.

3.1.2 Définition Type N

Exemple 1

N:Public;Jean;Quinlan;M.;Esq.

ce fragment vCard fragment comme un fragment hCard : 

<span class="n">
 <span class="honorific-prefix">M.</span>
 <span class="given-name">Jean</span>
 <span class="additional-name">Quinlan</span>
 <span class="family-name">Public</span>, 
 <span class="honorific-suffix">Dr.</span>
</span>

ce fragment hCard pourrait être affiché comme :

M. Jean Quinlan Public, Dr.

Exemple 2

N:Stevenson;Jean;Philippe,Paul;Dr.;Jr.,M.D.,A.C.P.

Ce fragment vCard sous un fragment hCard : 

<span class="n">
 <span class="honorific-prefix">Dr.</span>
 <span class="given-name">Jean</span>
 <span class="additional-name">Philippe</span>
 <span class="additional-name">Paul</span>
 <span class="family-name">Stevenson</span>,
 <span class="honorific-suffix">Jr.</span>,
 <span class="honorific-suffix">M.D.</span>,
 <span class="honorific-suffix">A.C.P.</span>
</span>

ce fragment hCard serait affiché comme :

Dr. John Philip Paul Stevenson, Jr., M.D., A.C.P.

3.1.3 Définition Type NICKNAME (pseudo)

Exemple 1

NICKNAME:Robbie

Ce fragment vCard sous un fragment hCard : 

<span class="nickname">Robbie</span>

ce fragment hCard serait affiché comme :

Robbie

Exemple 2

NICKNAME:Jim,Jimmie

Ce fragment vCard sous un fragment hCard : 

<span class="nickname">Jim</span>, 
<span class="nickname">Jimmie</span>

ce fragment hCard serait affiché comme :

Jim, Jimmie

3.1.4 Définition Type PHOTO

Exemple 1

PHOTO;VALUE=uri:http://www.abc.com/pub/photos/jqpublic.gif

Ce fragment vCard sous un fragment hCard : 

<img class="photo" src="http://www.abc.com/pub/photos/jqpublic.gif" alt="" />

Exemple 2

PHOTO;ENCODING=b;TYPE=JPEG:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcN
 AQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bm
 ljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0
 <...remainder of "B" encoded binary data...>

Ce fragment vCard sous un fragment hCard : (sauts de ligne insérés dans la valeur src pour lisibilité) : 

<img class="photo" src="data:image/jpeg;base64,MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcN
AQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bm
ljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0
...remainder of B encoded binary data..." alt="" />

3.1.5 Définition Type BDAY

Exemple 1

BDAY:1996-04-15

Ce fragment vCard sous un fragment hCard : 

<abbr class="bday" title="1996-04-15">15 avril 1996</abbr>

ce fragment hCard pourrait s'afficher comme :

15 avril 1996

Exemple 2

BDAY:1953-10-15T23:10:00Z

Ce fragment vCard sous un fragment hCard : 

<abbr class="bday" title="1953-10-15T23:10:00Z">15 octobre 1953</abbr>

ce fragment hCard pourrait s'afficher comme :

15 octobre 1953

Exemple 3

BDAY:1987-09-27T08:30:00-06:00

Ce fragment vCard sous un fragment hCard : 

<abbr class="bday" title="1987-09-27T08:30:00-06:00">9 septembre 1987</abbr>

ce fragment hCard pourrait s'afficher comme :

9 septembre 1987

3.2.1 Définition Type ADR

ADR;TYPE=dom,home,postal,parcel:;;123 Rue Principale;UNE VILLE;IDF;92310

Ce fragment vCard sous un fragment hCard : 

<div class="adr">
 Adresse du <span class="type">domicile</span> en  
 <abbr class="type" title="dom">France</abbr> pour le 
 <abbr class="type" title="postal">courrier</abbr> et les 
 <abbr class="type" title="parcel">colis</abbr> :
 <div class="street-address">123 Rue Principale</div>
 <span class="locality">UNE VILLE</span>, <span class="region">IDF</span>, 
 <span class="postal-code">92310</span>
</div>

ce fragment hCard pourrait s'afficher comme :

Adresse du domicile en France pour le courrier et les colis :

123, Rue Principale

UNE VILLE, IDF, 92310

3.2.2 Définition Type LABEL

LABEL;TYPE=dom,home,postal,parcel:Mr.John Q. Public\, Esq.\n
 Mail Drop: TNE QB\n123 Main Street\nAny Town\, CA  91921-1234
 \nU.S.A.

Ce fragment vCard sous un fragment hCard : 

<nowiki>
Merci d'utiliser l'étiquette adresse suivante pour la 
 <div class="label">
 <abbr class="type" title="dom">distribution locale</abbr>
 <abbr class="type" title="home">à mon domicile</abbr>
 <abbr class="type" title="postal">du courrier</abbr>
 <abbr class="type" title="parcel">et de colis :</abbr>
<pre>
Mr.John Q. Public, Esq.
Mail Drop: TNE QB
123 Main Street
Any Town, CA  91921-1234
U.S.A.

</nowiki>

Note : le fragment hCard au-dessus utilise un tag <pre> à l'intérieur d'une valeur de propriété pour capturer/représenter des retours explicites de transport (caractères "\n") extrait du fragment vCard.

ce fragment hCard pourrait s'afficher comme suit :

Merci d'utiliser l'étiquette adresse suivante pour la distribution locale à mon domicile de courrier et de colis : 

Mr.John Q. Public, Esq.
Mail Drop: TNE QB
123 Main Street
Any Town, CA  91921-1234
U.S.A.

3.3.1 Définition Type TEL

TEL;TYPE=work,voice,pref,msg:+1-213-555-1234

ce fragment vCard sous un fragment hCard : 

<span class="tel">
 <abbr class="type" title="pref">mon</abbr> 
 <abbr class="type" title="voice">téléphone</abbr>
 <span class="type">professionnel</span> avec 
  <abbr class="type" title="msg">messagerie vocale</abbr> :
 <span class="value">+1-213-555-1234</span>
</span>

ce fragment hCard pourrait s'afficher comme :

mon téléphone professionnel avec messagerie vocale : +1-213-555-1234

3.3.2 Définition Type EMAIL

Exemple 1

EMAIL;TYPE=internet:jqpublic@xyz.dom1.com

ce fragment vCard comme un fragment hCard : 

<a class="email" href="mailto:jqpublic@xyz.dom1.com">email jqpublic</a>

ce fragment hCard pourrait s'afficher ainsi

email jqpublic

Exemple 2

EMAIL;TYPE=internet:jdoe@isp.net

ce fragment vCard comme un fragment hCard : 

<a class="email" href="mailto:jdoe@isp.net">email jdoe</a>

ce fragment hCard pourrait s'afficher ainsi

email jdoe

Exemple 3

EMAIL;TYPE=internet,pref:jeanne_doe@abc.com

ce fragment vCard comme un fragment hCard : 

<a class="email" href="mailto:jeanne_doe@abc.com">
 <abbr class="type" title="pref">preferred</abbr> 
 email préféré pour jeanne_doe
</a>

ce fragment hCard pourrait s'afficher ainsi

email préféré pour jeanne_doe

3.3.3 Définition Type MAILER

MAILER:PigeonMail 2.1

ce fragment vCard comme un fragment hCard : 

Jeanne Doe utilise <span class="mailer">PigeonMail 2.1</span> pour l'email.

ce fragment hCard pourrait s'afficher ainsi

Jane Doe utilise PigeonMail 2.1 pour l'email.

3.4.1 Définition Type TZ

Exemple 1

TZ:-05:00

ce fragment vCard comme un fragment hCard : 

<span class="tz">-05:00</span>

ce fragment hCard pourrait s'afficher ainsi

-05:00

Exemple 2

TZ;VALUE=text:-05:00; EST; Raleigh/North America
;This example has a single value, not a structure text value.

ce fragment vCard comme un fragment hCard : 

<abbr class="tz"
 title="-05:00; EST; Raleigh/North America;This example has a single value, not a structure text value.">
 EST
</abbr>

ce fragment hCard pourrait s'afficher ainsi

EST

3.4.2 Définition Type GEO

GEO:37.386013;-122.082932

ce fragment vCard comme un fragment hCard : 

<span class="geo">
 <span class="latitude">37.386013</span>, 
 <span class="longitude">-122.082932</span>
</span>

ce fragment hCard pourrait s'afficher ainsi

37.386013, -122.082932

3.5.1 Définition Type TITLE

TITLE:Directeur\, Recherche et Développement

ce fragment vCard comme un fragment hCard : 

<span class="title">Directeur, Recherche et Développement</span>

ce fragment hCard pourrait s'afficher ainsi

Directeur, Recherche et Développement

3.5.2 Définition Type ROLE

ROLE:Programmeur

ce fragment vCard comme un fragment hCard : 

<span class="role">Programmeur</span>

ce fragment hCard pourrait s'afficher ainsi :

Programmeur

Exemple 1

LOGO;VALUE=uri:http://www.abc.com/pub/logos/abccorp.jpg

ce fragment vCard comme un fragment hCard : 

<img class="logo" src="http://www.abc.com/pub/logos/abccorp.jpg" alt="my logo" />

ce fragment hCard pourrait s'afficher ainsi : (note : j'ai utilisé un URL véritable pour l'image) :

mf-lg-ora.gif


Exemple 2

LOGO;ENCODING=b;TYPE=JPEG:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcN
AQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bm
ljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0
<...the remainder of "B" encoded binary data...>

ce fragment vCard comme un fragment hCard : 

<img class="logo" src="data:image/jpeg;base64,MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcN
AQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bm
ljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0
...remainder of B encoded binary data..." alt="" />

aucun affichage équivalent donné, parce que ce sont des données : URL tiré de l'exemple original incomplet.

3.5.4 Définition Type AGENT

Exemple 1

AGENT;VALUE=uri:
 CID:JQPUBLIC.part3.960129T083020.xyzMail@host3.com

ce fragment vCard comme un fragment hCard : 

<a class="agent" href="CID:JQPUBLIC.part3.960129T083020.xyzMail@host3.com">JQPUBLIC</a>

ce fragment hCard pourrait s'afficher comme :

JQPUBLIC

Exemple 2

AGENT:BEGIN:VCARD\nFN:Susan Thomas\nTEL:+1-919-555-
 1234\nEMAIL\;INTERNET:sthomas@host.com\nEND:VCARD\n

ce fragment vCard comme un fragment hCard : 

<span class="agent vcard">
 <a class="email fn n" href="mailto:sthomas@host.com">Susan Thomas</a>,
 <span class="tel">+1-919-555-1234</span>
</span>

ce fragment hCard pourrait s'afficher comme :

Susan Thomas, +1-919-555-1234

Note : la vCard dans la propriété AGENT du fragment vCard est en fait invalide parce qu'il lui manque la propriété "N". Néanmoins, la version hCard *est* valide, parce que j'ai ajouté le nom de classe "n" à l'exemple.

3.5.5 Définition Type ORG

ORG:ABC\, Inc.;North American Division;Marketing

ce fragment vCard comme un fragment hCard : 

<span class="org">
 <span class="organization-name">ABC, Inc.</span>, 
 <span class="organization-unit">North American Division</span>,
 <span class="organization-unit">Marketing</span>,
</span>

ce fragment hCard pourrait s'afficher comme :

ABC, Inc., North American Division, Marketing

3.6.1 Définition Type CATEGORIES

Exemple 1

CATEGORIES:TRAVEL AGENT

ce fragment vCard comme un fragment hCard : 

<span class="category">TRAVEL AGENT</span>

ce fragment hCard pourrait s'afficher comme :

TRAVEL AGENT


Exemple 2

CATEGORIES:INTERNET,IETF,INDUSTRY,INFORMATION TECHNOLOGY

ce fragment vCard comme un fragment hCard : 

<span class="category">INTERNET</span>, 
<span class="category">IETF</span>, 
<span class="category">INDUSTRY</span>, 
<span class="category">INFORMATION TECHNOLOGY</span>

ce fragment hCard pourrait s'afficher comme :

INTERNET, IETF, INDUSTRY, INFORMATION TECHNOLOGY

3.6.2 NOTE Type Definition

NOTE:This fax number is operational 0800 to 1715
 EST\, Mon-Fri.

ce fragment vCard comme un fragment hCard : 

<p class="note">This fax number is operational 0800 to 1715 EST, Mon-Fri.</p>

ce fragment hCard pourrait s'afficher comme :

This fax number is operational 0800 to 1715 EST, Mon-Fri.

3.6.3 PRODID Type Definition

PRODID:-//ONLINE DIRECTORY//NONSGML Version 1//EN

Note, cette propriété vCard ne fait véritablement pas de sens comme propriété hCard, parce qu'elle devrait être vraiment remplie par tout ce que peut transformer le code hCard en vCard, par ex. Brian Suda's X2V.

3.6.4 Définition Type REV

Exemple 1

REV:1995-10-31T22:27:10Z

ce fragment vCard comme un fragment hCard : 

<abbr class="rev" title="1995-10-31T22:27:10Z">Updated: 10/31 10:27p</abbr>

ce fragment hCard pourrait s'afficher comme :

Updated: 10/31 10:27p

Exemple 2

REV:1997-11-15

ce fragment vCard comme un fragment hCard : 

<abbr class="rev" title="1997-11-15">Updated: November 15</abbr>

ce fragment hCard pourrait s'afficher comme :

Updated: November 15

3.6.5 Définition Type SORT-STRING

Exemple 1

FN:Rene van der Harten
N:van der Harten;Rene;J.;Sir;R.D.O.N.
SORT-STRING:Harten

ce fragment vCard comme un fragment hCard : 

<span class="n"
 <span class="honorific-prefix">Sir</span>
 <span class="fn">
  <span class="given-name">Rene</span>
  <span class="family-name">
   van der <span class="sort-string">Harten</span>
  </span>
 </span>
 (<span class="additional-name">J.</span>),
 <span class="honorific-suffix">R.D.O.N.</span>
</span>

Note : La chaîne "Harten" n'a PAS été répétée dans le hCard, même s'il ETAIT répété dans la vCard (3 fois ! dans N, FN, et SORT-STRING). La propriété "SORT-STRING" fournit une autre bonne démonstration sur la façon dont hCard permet une meilleure adhérence au principe DRY que la vCard.

ce fragment hCard pourrait s'afficher comme :

Sir Rene van der Harten (J.), R.D.O.N.

Exemple 2

FN:Robert Pau Shou Chang
N:Pau;Shou Chang;Robert
SORT-STRING:Pau

ce fragment vCard fragment comme un fragment hCard : 

<span class="fn n">
 <span class="additional-name">Robert</span>
 <span class="family-name sort-string">Pau</span>
 <span class="given-name">Shou Chang</span>
</span>

Note : Non seulement la chaîne "Pau" n'était PAS répétée dans le hCard (meilleure adhérence à nouveau au better principe DRY), même s'il elle ETAIT répétée dans la vCard, mais dans ce cas du fait que "family-name" et "sort-string" sont les même, nous avons pu utiliser la conservation élément et n'utiliser qu'un élément pour les deux propriétés.

ce fragment hCard pourrait être affiché ainsi :

Robert Pau Shou Chang

Exemple 3

FN:Osamu Koura
N:Koura;Osamu
SORT-STRING:Koura

ce fragment vCard fragment comme un fragment hCard : 

<span class="fn">
 Osamu <span class="sort-string">Koura</span>
</span>

Note : Cet exemple, en plus de mieux illustrer le meilleur support du principe DRY, fait aussi usage de l'optimisation implicite "N".

ce fragment hCard pourrait être affiché ainsi :

Osamu Koura

Exemple 4

FN:Oscar del Pozo
N:del Pozo Triscon;Oscar
SORT-STRING:Pozo

ce fragment vCard fragment comme un fragment hCard : 

<span class="n">
 <span class="fn">
  <span class="given-name">Oscar</span>
  del <span class="sort-string">Pozo</span>
 </span>
 <span class="family-name" style="display:none">
  del Pozo Triscon
 </span>
</span>

Note : Malheureusement cet exemple pourrait ne pas complètement adhérer au principe DRY du fait du "FN" utilisant une *substring* du family-name, et en plus a dû par conséquent cacher la chaîne de valeur supplémentaire "family-name" en utilisant CSS display:none, ce qui en devrait être évité en général. Suggestion bienvenue pour améliorations de ce fragment hCard.

ce fragment hCard pourrait s'afficher comme :

Oscar del Pozo

Exemple 5

FN:Christine d'Aboville
N:d'Aboville;Christine
SORT-STRING:Aboville

ce fragment vCard comme un fragment hCard : 

<span class="fn">
 Christine d'<span class="sort-string">Aboville</span>
</span>

Note : Cet exemple redémontre les avantages/l'efficacité démontrés dans l'exemple 3 au-dessus.

ce fragment hCard pourrait s'afficher comme :

Christine d'Aboville

3.6.6 Définition Type SOUND

Exemple 1

SOUND;TYPE=BASIC;VALUE=uri:CID:JOHNQPUBLIC.part8.
 19960229T080000.xyzMail@host1.com

ce fragment vCard comme un fragment hCard : 

<object class="sound" type="audio/basic"
 data="CID:JOHNQPUBLIC.part8.19960229T080000.xyzMail@host1.com">
pronounciation of "JOHN Q PUBLIC"
</object>

ce fragment hCard pourrait s'afficher comme :

prononciation de "JOHN Q PUBLIC"

à la condition que votre navigateur supporte le type MIME "audio/basic" (défini dans la RFC2046 section 4.3) et ait quelque moyen de retrouver les urls "CID:".

Exemple 2

SOUND;TYPE=BASIC;ENCODING=b:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcN
 AQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bm
 ljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0
 <...the remainder of "B" encoded binary data...>

ce fragment vCard comme un fragment hCard : 

<object class="sound" 
data="data:audio/basic;base64,MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcN
 AQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bm
 ljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0
 ...the remainder of "B" encoded binary data...">
pronounciation
</object>

pas d'affichage équivalent donné, parce que des données : l'URL de l'exemple original est incomplète.

3.6.7 Définition Type UID

UID:19950401-080045-40000F192713-0052

ce fragment vCard comme un fragment hCard : 

Unique id: 
 <span class="uid">19950401-080045-40000F192713-0052</span>

ce fragment hCard pourrait s'afficher comme :

Unique id:19950401-080045-40000F192713-0052

Note : en pratique, je ne pense pas que j'ai vu globalement des IDs uniques pour des enregistrements de "contact info" publiés sur le web, mais peut-être que je ne considère pas assez d'exemples.


3.6.8 Définition Type URL

URL:http://www.swbyps.restaurant.french/~chezchic.html

ce fragment vCard comme un fragment hCard : 

<a class="url" href="http://www.swbyps.restaurant.french/~chezchic.html">Chez Chic</a>

ce fragment hCard pourrait s'afficher comme :

Chez Chic


3.7.1 Définition Type CLASS

Exemple 1

CLASS:PUBLIC

ce fragment vCard comme un fragment hCard : 

<span class="class">PUBLIC</span>

ce fragment hCard pourrait s'afficher comme :

PUBLIC

Exemple 2

CLASS:PRIVATE

ce fragment vCard comme un fragment hCard : 

<span class="class">PRIVATE</span>

ce fragment hCard pourrait s'afficher comme :

PRIVATE

Exemple 3

CLASS:CONFIDENTIAL

ce fragment vCard comme un fragment hCard : 

<span class="class">CONFIDENTIAL</span>

ce fragment hCard pourrait s'afficher comme :

CONFIDENTIAL

3.7.2 Définition Type KEY

KEY;ENCODING=b:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcNAQEEBQA
 wdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENbW11bmljYX
 Rpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0
 ZW1zMRwwGgYDVQQDExNyb290Y2EubmV0c2NhcGUuY29tMB4XDTk3MDYwNj
 E5NDc1OVoXDTk3MTIwMzE5NDc1OVowgYkxCzAJBgNVBAYTAlVTMSYwJAYD
 VQQKEx1OZXRzY2FwZSBDb21tdW5pY2F0aW9ucyBDb3JwLjEYMBYGA1UEAx
 MPVGltb3RoeSBBIEhvd2VzMSEwHwYJKoZIhvcNAQkBFhJob3dlc0BuZXRz
 Y2FwZS5jb20xFTATBgoJkiaJk/IsZAEBEwVob3dlczBcMA0GCSqGSIb3DQ
 EBAQUAA0sAMEgCQQC0JZf6wkg8pLMXHHCUvMfL5H6zjSk4vTTXZpYyrdN2
 dXcoX49LKiOmgeJSzoiFKHtLOIboyludF90CgqcxtwKnAgMBAAGjNjA0MB
 EGCWCGSAGG+EIBAQQEAwIAoDAfBgNVHSMEGDAWgBT84FToB/GV3jr3mcau
 +hUMbsQukjANBgkqhkiG9w0BAQQFAAOBgQBexv7o7mi3PLXadkmNP9LcIP
 mx93HGp0Kgyx1jIVMyNgsemeAwBM+MSlhMfcpbTrONwNjZYW8vJDSoi//y
 rZlVt9bJbs7MNYZVsyF1unsqaln4/vy6Uawfg8VUMk1U7jt8LYpo4YULU7
 UZHPYVUaSgVttImOHZIKi4hlPXBOhcUQ==

ce fragment vCard comme un fragment hCard : 

<object class="key" type="application/octet-stream"
 data="data:application/octet-stream;base64,MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcNAQEEBQA
 wdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENbW11bmljYX
 Rpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0
 ZW1zMRwwGgYDVQQDExNyb290Y2EubmV0c2NhcGUuY29tMB4XDTk3MDYwNj
 E5NDc1OVoXDTk3MTIwMzE5NDc1OVowgYkxCzAJBgNVBAYTAlVTMSYwJAYD
 VQQKEx1OZXRzY2FwZSBDb21tdW5pY2F0aW9ucyBDb3JwLjEYMBYGA1UEAx
 MPVGltb3RoeSBBIEhvd2VzMSEwHwYJKoZIhvcNAQkBFhJob3dlc0BuZXRz
 Y2FwZS5jb20xFTATBgoJkiaJk/IsZAEBEwVob3dlczBcMA0GCSqGSIb3DQ
 EBAQUAA0sAMEgCQQC0JZf6wkg8pLMXHHCUvMfL5H6zjSk4vTTXZpYyrdN2
 dXcoX49LKiOmgeJSzoiFKHtLOIboyludF90CgqcxtwKnAgMBAAGjNjA0MB
 EGCWCGSAGG+EIBAQQEAwIAoDAfBgNVHSMEGDAWgBT84FToB/GV3jr3mcau
 +hUMbsQukjANBgkqhkiG9w0BAQQFAAOBgQBexv7o7mi3PLXadkmNP9LcIP
 mx93HGp0Kgyx1jIVMyNgsemeAwBM+MSlhMfcpbTrONwNjZYW8vJDSoi//y
 rZlVt9bJbs7MNYZVsyF1unsqaln4/vy6Uawfg8VUMk1U7jt8LYpo4YULU7
 UZHPYVUaSgVttImOHZIKi4hlPXBOhcUQ==">
Key
</object>

ce fragment hCard pourrait s'afficher comme :

Key

Note : Du fait du manque d'une valeur TYPE dans l'exemple RFC2426, j'ai substitué application/octet-stream. Clairement pour que ce soit de quelque utilité, le type spécifié doit être de quelque sorte de clé ou de "certificate mime type".

7. Adresses des Auteurs

BEGIN:vCard
VERSION:3.0
FN:Frank Dawson
ORG:Lotus Development Corporation
ADR;TYPE=WORK,POSTAL,PARCEL:;;6544 Battleford Drive
;Raleigh;NC;27613-3502;U.S.A.
TEL;TYPE=VOICE,MSG,WORK:+1-919-676-9515
TEL;TYPE=FAX,WORK:+1-919-676-9564
EMAIL;TYPE=INTERNET,PREF:Frank_Dawson@Lotus.com
EMAIL;TYPE=INTERNET:fdawson@earthlink.net
URL:http://home.earthlink.net/~fdawson
END:vCard


BEGIN:vCard
VERSION:3.0
FN:Tim Howes
ORG:Netscape Communications Corp.
ADR;TYPE=WORK:;;501 E. Middlefield Rd.;Mountain View;
CA; 94043;U.S.A.
TEL;TYPE=VOICE,MSG,WORK:+1-415-937-3419
TEL;TYPE=FAX,WORK:+1-415-528-4164
EMAIL;TYPE=INTERNET:howes@netscape.com
END:vCard

Notez que ces deux vCards sont invalides parce qu'il manque la propriété REQUISE "N" qui est tout à fait ironique, parce que ce sont les vCards des auteurs eux-mêmes.

Néanmoins, ces vCards peuvent être représentées par les hCards suivantes : 

<div class="vcard">
<a class="url fn" href="http://home.earthlink.net/~fdawson">Frank Dawson</a>
<div class="org">Lotus Development Corporation</div>
<div class="adr">
 <span class="type">work</span> address 
(<abbr class="type" title="postal">mail</abbr> and
 <abbr class="type" title="parcel">packages</abbr>):
 <div class="street-address">6544 Battleford Drive</div>
 <span class="locality">Raleigh</span>
 <span class="region">NC</span>
 <span class="postal-code">27613-3502</span>
 <div class="country-name">U.S.A.</div>
</div>
<div class="tel">
 <span class="value">+1-919-676-9515</span> 
(<abbr class="type" title="WORK">w</abbr>,
 <abbr class="type" title="VOICE">v</abbr><abbr class="type" title="MSG">m</abbr>)
</div>
<div class="tel">
 <span class="value">+1-919-676-9564</span>
(<abbr class="type" title="WORK">w</abbr><abbr class="type" title="FAX">f</abbr>)
</div>
<a class="email" href="mailto:Frank_Dawson@Lotus.com">
 <span class="type">pref<span>erred</span> email</span>
</a>,
<a class="email" href="mailto:fdawson@earthlink.net">
 alternate email
</a>
</div>
<div class="vcard">
<a class="email fn" href="mailto:howes@netscape.com">Tim Howes</a>
<div class="org">Netscape Communications Corp.</div>
<div class="adr">
 <span class="type">work</span> address:
 <div class="street-address">501 E. Middlefield Rd.</div>
 <span class="locality">Mountain View</span>, 
 <span class="region">CA</span>
 <span class="postal-code">94043</span>
 <div class="country-name">U.S.A.</div>
</div>
<div class="tel">
 <span class="value">+1-415-937-3419</span> 
(<abbr class="type" title="WORK">w</abbr>,
 <abbr class="type" title="VOICE">v</abbr><abbr class="type" title="MSG">m</abbr>)
</div>
<div class="tel">
 <span class="value">+1-415-528-4164</span>
(<abbr class="type" title="WORK">w</abbr><abbr class="type" title="FAX">f</abbr>)
</div>
</div>

ces hCards pourraient s'afficher comme :

Frank Dawson

Lotus Development Corporation

work address (mail and packages):

6544 Battleford Drive

Raleigh NC 27613-3502

U.S.A.

+1-919-676-9515 (w, vm)

+1-919-676-9564 (wf)

preferred email, alternate email

Tim Howes

Netscape Communications Corp.

work address:

501 E. Middlefield Rd.

Mountain View, CA 94043

U.S.A.

+1-415-937-3419 (w, vm)

+1-415-528-4164 (wf)

Test de Casses

Ce sont des exemples hCard qui ont été trouvés particulièrement utiles pour trouver des bugs dans les parseurs hCard (par ex. X2V).

Problème avec Information BDAY

cet exemple : 

    <!-- birthday -->
    <div class="bday">
    <dt>Birthday</dt>
    <dd>
        <abbr class="value" title="1985-10-27T00:00:00Z">October 27, 1985</abbr>
    </dd>
    </div>

devrait produire "BDAY:1985-10-27T00:00:00Z" mais il produit "BDAY:Birthday October 27\, 1985". Le fait intéressant est que le carnet d'adresses apple est encore en train de vouloir l'accpeter de cette façon.

INSENSIBILITE à la casse des valeurs type

  • "home" vs. "Home"

cet exemple fonctionne avec X2V : 

    <div class="tel">
    <dt>Phone (<span class="type">home</span>)</dt>
    <dd><span class="value">+438123418</span></dd>
    </div>

ceci non, mais le devrait. Mais au lieu de ça il devient simplement TEL sans un type dans la vcard 

    <div class="tel">
    <dt>Phone (<span class="type">Home</span>)</dt>
    <dd><span class="value">+438123418</span></dd>
    </div>

GEO parsing

la hCard suivante : 

<div class="vcard">
  <span class="n">
     <a class="url" href="http://t37.net">
       <span class="given-name">Fréderic</span> 
       <span class="family-name">de Villamil</span> 
     </a>
  </span>
  <span class="nickname">neuro</span>
  <a class="email" href="mailto:neuroNOSPAM@t37.net">
     <span class="type">pref<span>erred</span> email</span>
  </a>
  <span class="org">Omatis</span>
  <span class="adr">
     <abbr class="type" title="dom">France</abbr>
     <span class="type">home</span> address
     <abbr class="type" title="postal">mail</abbr> and
     <abbr class="type" title="parcel">shipments</abbr>:
     <span class="street-address">12 rue Danton</span>
     <span class="locality">Le Kremlin-Bicetre</span>
     <span class="postal-code">94270</span>
     <span class="country-name">France</span>
  </span>
  <span class="geo">
     <abbr class="latitude" title="48.816667">N 48° 81.6667</abbr>
     <abbr class="longitude" title="2.366667">E 2° 36.6667</abbr>
  </span>
</div>

devrait être traduite dans la vCard suivante : 

BEGIN:VCARD
VERSION:3.0
URL:http://t37.net
ORG:Omatis;;
NICKNAME:neuro
N:de Villamil;Frederic;;Mr.;
EMAIL;TYPE=INTERNET,PREF:neuroNOSPAM@t37.net
ADR;TYPE=HOME:;;12 rue danton;le Kremlin-Bicetre;;94270;France
GEO:48.816667;2.366667
END:VCARD

X2V (2005-12-18) échoue à cette heure pour parser/exporter la propriété GEO.

Autre

  • Voir hcard-brainstorming pour plus d'exemples (qui peuvent éventuellement être migrés ici) et une analyse.
Retrieved from "http://microformats.org/wiki/index.php?title=hcard-examples-fr&oldid=7090"