View source for adr-fr

<entry-title> adr </entry-title>
{{DraftSpecification-fr}}

'''adr''' (nom de code pour travailler, prononcez "adeure" ; FAQ : [[hcard-faq-fr#Devrais-je_utiliser_ADDRESS_pour_les_hCards|pourquoi "adr"]] ?) est un format simple pour baliser l'information adresse, approprié pour l'embarquement dans le HTML, XHTML, Atom, RSS et le XML arbitraire. '''adr''' est une représentation 1:1 de la propriété ''adr'' dans le standard vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) en HTML, l'un des nombreux standards ouverts [[microformats-fr|microformats]]. C'est aussi une propriété de [[hcard-fr|hCard]].

== Spécification Brouillon ==
<div class="vcard">
; <span class="role">Editeur</span>/<span class="role">Auteur</span> 
: <span class="fn">[[User:Tantek|Tantek Çelik]]</span> (<span class="url">http://tantek.com/</span>, et précédemment chez [http://technorati.com Technorati, Inc.])


;<span class="role">Traduction</span>
: <span class="fn">[[User:ChristopheDucamp|Christophe Ducamp]]</span> 

</div>

=== Copyright ===
Selon la sortie dans le domaine public sur [[User:Tantek|ma page utilisateur]], cette spécification est publiée dans le domaine public.

{{MicroFormatPublicDomainContributionStatement-fr}}

=== Brevets ===
{{MicroFormatPatentStatement-fr}}

=== Inspiration et Remerciements  ===
Merci à tous ceux qui ont participé dans le [[geo-bof-2005-06-30|Geo Microformat BOF at O'Reilly's Where 2.0 conference]], et tout particulièrement [http://radar.oreilly.com/nat/ Nat Torkington] et Vee McMillen de [http://oreilly.com O'Reilly] pour [http://conferences.oreillynet.com/cs/where2005/view/e_sess/7476 organiser et héberger le BOF].

== Introduction et Historique ==
Le standard vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]), a été largement implémenté de façon interopérable (par ex. l'application carnet d'adresses d'Apple). Le microformat [[hcard-fr|hCard]] a de manière similaire reçu une adoption significative de la part de nombreux sites publiant le format des proxies hCards aux vCards, jusqu'aux parseurs javascript côté client.

A la [http://conferences.oreillynet.com/where/ conférence Where 2.0] en juin 2005, il y a eu une reconnaissance largement acceptée que la communauté avait besoin d'un moyen pour publier simplement et facilement sur le web une information d'adresse qui soit visible, extractible, compte tenu du fait que souvent les blogueurs et les nombreux autres sites publient des informations d'adresses. Le [[geo-bof-2005-06-30|geo microformat BOF]] a discuté tout particulièrement de ce sujet et conclu avec une décision consensuelle de simplement essayer d'utiliser ''adr'' venant de vCard/hCard.

Cette spécification présente le microformat '''adr''', qui est une représentation 1:1 de la propriété mentionnée ci-dessus ''adr'' extraite du standard vCard en réutilisant simplement la propriété ''adr'' et les sous-propriétés telles quelles extraites du microfomat [[hcard-fr|hCard]].

Les auteurs peuvent à la fois embarquer directement des adresses '''adr''' dans leurs pages web et fils, tout comme baliser des adresses existantes dans le contexte du reste de l'information dans leurs pages web et fils.

Si l'auteur connaît et publie le '''name''' de l'endroit en plus de son adresse, alors l'auteur DOIT utiliser [[hcard-fr|hCard]] au lieu de simplement '''adr''' pour publier le nom et l'adresse du lieu.

== Principes de Design XHTML Sémantique ==
{{semantic-xhtml-design-principles-fr}}

== Format ==
=== Propriétés Singulières ===
Voir [[hcard-fr#Propri.C3.A9t.C3.A9s_Singuli.C3.A8res_vs._Plurielles|hCard : Propriétés Singulières vs Plurielles]] pour la liste des propriétés "adr" (sous-propriétés dans la hCard) qui sont au singulier.  Prenez note de l'analyse en cours : [[adr-singular-properties-fr]].

=== Lisible Humain vs Machine ===

Si un élément <code>&lt;abbr&gt;</code> est utilisé pour une propriété, alors l'attribut <code>title</code> de l'élément <code>&lt;abbr&gt;</code> est la valeur de la propriété, au lieu des contenus de l'élément, ce qui fournit à la place une version humainement présentable de la valeur.

De la même façon, si un élément <code>&lt;img&gt;</code> est utilisé pour une ou plusieurs propriétés, il doit être traité comme suit : 
# Pour la propriété <code>PHOTO</code> et toute autre propriété qui prend un <abbr title="Uniform Resource Locator">URL</abbr> comme sa valeur, l'attribut <code>src</code> fournit la valeur de la propriété.
# Pour d'autres propriétés, l'attribut <code>alt</code> de <code>&lt;img&gt;</code> est la valeur de la propriété.

=== Extraction de Valeur ===
Parfois, seule la part d'un élément qui est l'équivalent pour une propriété devrait être utilisée pour la valeur de la propriété. A cette intention, le nom de classe <code>value</code> est utilisé pour extraire la partie de l'élément qui est la valeur de la propriété. Voir [[hcard-fr|hCard]] pour les détails à ce sujet.

=== Nom Classe Racine ===
Le nom de classe racine pour une adresse '''adr''' est <code>adr</code>.

=== Liste Propriétés ===
Ceci est la liste des propriétés dans '''adr''', extraite de [[hcard-fr|hCard]] :

* <code>post-office-box</code> (boîte postale)
* <code>extended-address</code>  (suite adresse)
* <code>street-address</code>  (adresse-rue)
* <code>locality</code> (localité)
* <code>region</code> (région)
* <code>postal-code</code> (code postal)
* <code>country-name</code> (nom du pays)

La sous-propriété <code>type</code> est omise parce que sans le contexte d'un type d'adresse pour ''whom'', cela ne fait pas beaucoup plus de sens.

=== Profil XMDP ===
Voir le [[hcard-profile-fr|profil hCard]] pour le profil [http://gmpg.org/xmdp XMDP] de hCard qui contient la liste complète au-dessus des propriétés, avec des références vers leurs définitions RFC 2426.

===  Détails Parsage ===
Voir le [[hcard-parsing-fr|parsage hCard]], avec la seule différence étant que "adr" est le nom de classe racine, plutôt que "vcard".

== Exemples ==
Cette section est informative.

=== Echantillon adr ===

Voilà un échantillon <code>adr</code> : 

<source lang=html4strict>
<div class="adr">
 <div class="street-address">50 rue Saint Denis</div>
 <div class="extended-address">Suite 207</div>
 <span class="postal-code">75001</span> <span class="locality">Paris</span>
 <div class="region">Ile de France</div>
 <div class="country-name">France</div>
</div>
</source>

qui pourrait être affichée comme :

<div class="adr"><div class="street-address">50 rue Saint Denis</div><div class="extended-address">Suite 207</div><span class="postal-code">75001</span> <span class="locality">Paris</span><div class="region">Ile de France</div><div class="country-name">France</div></div>

Remarquez que c'est un microformat <code>adr</code> vivant, qui sera trouvé sur cette page par les parseurs.

=== Plus d'exemples ===
Voir [[hcard-examples-fr#3.2.1_D.C3.A9finition_Type_ADR|exemples ADR hCard]] pour plus d'exemples.

Voir [http://microformats.org/wiki/adr-examples-fr exemples adr] pour des usages supplémentaires de ADR.

== Exemples dans la jungle ==
Cette section est '''informative'''.

Les sites suivants ont publié des adrs, en dehors de leur contexte normal pour les hCards, et sont de ce fait un endroit génial pour commencer à regarder des exemples "dans la jungle" afin d'essayer de parser, indexer, organiser, etc, en plus des exemples de  [[hcard-fr|hCard]] dans la jungle. Si vous trouvez des adrs en dehors de hCards n'importe où, sentez-vous libre de les ajouter en haut de cette liste. Une fois que la liste aura trop grossi, nous produirons une page wiki séparée.
* [http://iprefer.com/ I Prefer Guest Benefit Program] utilise adr sur les pages de résultats de recherche pour l'information city/state/country information, exemple : [http://iprefer.com/luxury-hotel/Bangalore/ Search page for Bangalore]
* [http://preferredhotels.com/ Preferred Hotels and Resorts] utilise adr sur les pages de résultats de recherche pour l'information city/state/country information, exemple :  [http://preferredhotels.com/luxury-hotel/London/ Search page for London]
* [http://sterlinghotels.com Sterling Hotels] utilise adr sur les pages de résultats de recherche pour l'information city/state/country information, exemple : [http://sterlinghotels.com/smart-hotel/Barcelona/ Search page for Barcelona]
* [http://www.growsonyou.com/visit Grows on You] uses the microformat to mark up the addresses of open gardens.
* [http://www.stems-florist.co.uk/ Stems Florist] uses the microformat on the front page to markup up the two store addresses
* [http://themechanism.com/locations/ theMechanism] uses the adr microformat to mark up the locations of 
their offices.
* [http://www.mister-map.com/ Mister-Map.com] uses the adr microformat to mark up the streets, zip-codes, regions and country names.

(Voir aussi [[hcard-examples-in-wild-fr|hcard-exemples-dans-la-jungle]])

== Implémentations ==
Cette section est '''informative'''.

Les implémentations suivantes ont été développées et soit génèrent ou parsent des adrs en dehors du contexte des hCards. Si vous avez une implémentation adr, sentez-vous libre de l'ajouter en haut de la liste. Une fois que la liste sera devenue trop grosse, nous ferons une page wiki séparée.

* [http://georss.org/geopress GeoPress] est un plugin [http://wordpress.org WordPress] qui supporte l'embarquement des adrs, geo, maps (commutable dynamiquement entre le Cartes Google-Yahoo-Microsoft Maps), et les fils [http://georss.org GeoRSS].

* [http://code.highearthorbit.com/greaseroute/index.php GreaseRoute] est un script utilisateur  GreaseMonkey (aussi disponibles comme une simple extension Firefox) qui ajoutera des icônes pour afficher l'endroit, ou la route vers une [[adr-fr|adr]] en utilisant une carte MapQuest. La route est affichée à partir du lieu de départ fondé sur l'Adresse-IP du spectateur déterminée par le service de géolocalisation [http://hostip.info HostIP].

* [http://code.highearthorbit.com/greaseroute/index.php GreaseRouteEmbed] est un autre script utilisateur  GreaseMonkey qui embarquera une image de la route dans la page web quand l'utilisateur cliquera sur le lien "route".
 
* [http://placenamehere.com/TXP/pnh_mf/ pnh_mf] est un plugin pour [http://textpattern.com/ Textpattern] qui supporte l'embarquement des adrs et d'autres microformats dans les gabarits et billets de blog. Ecrit par [http://placenamehere.com/ Chris Casciano].

* Le [http://tantek.com/microformats/hcard-creator.html hCard creator], même s'il crée des hCards complètes, peut aussi être utilisé simplement pour créer des adrs en ne remplissant que la portion d'adresse et en copiant et collant simplement l'élément &lt;div class="adr"&gt; et ses contenus.

== Références ==
=== Références Normatives ===
* [[hcard-fr|hCard]]

=== Références Informatives ===
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426] ([http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426])
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]

=== Travaux Similaires ===
* [[geo-fr|geo]]
* [[hcalendar-fr|hCalendar]]
* [[XOXO-fr|XOXO]]

== Chantier en cours ==
Cette spécification est un travail en cours. Au fur et à mesure que des aspects additionnels seront discutés, compris et écrits, ils seront ajoutés.

== Discussions ==

* Voir [http://www.technorati.com/cosmos/referer.html les blogs qui discutent de cette page].

=== Q&R ===
* Si vous avez quelque question à propos de hCard, regardez d'abord les [[hcard-faq-fr|FAQ hCard]] et si vous ne trouvez pas de réponses, ajoutez vos questions ! (Les chances sont celles que toute question '''adr''' s'appliquera tout aussi bien à  [[hcard-fr|hCard]]).
* Voir aussi [http://microformats.org/discuss/ pour d'autres méthodes de feedback].

=== Problématiques ===
* SVP, ajoutez toutes les problématiques avec la spécification sur le document séparé [[hcard-issues-fr|problématiques hCard]]. Ditto.

== Pages en rapport ==
* {{adr-fr}}

[[Category:Draft_Specifications]]
[[Category:hCard]]
[[Category:adr]]


{{langcat|fr}}