adr-fr: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
(→‎Format: translation to be reviewed)
mNo edit summary
Line 28: Line 28:
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.
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 Designe XHTML Sémantique ==
== Principes de Design XHTML Sémantique ==
{{semantic-xhtml-design-principles-fr}}
{{semantic-xhtml-design-principles-fr}}


Line 69: Line 69:
=== Profil XMDP ===
=== Profil XMDP ===


Voir [[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éfinition RFC 2426.
Voir [[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 ===
===  Détails Parsage ===
Line 75: Line 75:


== Exemples ==
== Exemples ==
This section is informative.
Cette section est informative.


=== Echantillon adr ===
=== Echantillon adr ===


Here is a sample adr:
Voilà un échantillon adr :  


<pre><nowiki>
<pre><nowiki>
Line 92: Line 92:
</nowiki></pre>
</nowiki></pre>


This adr might be displayed as:
Cette adr pourrait être affiché comme :


<pre>665 3rd St.
<pre>665 3rd St.
Line 101: Line 101:
=== Plus d'exemples ===
=== Plus d'exemples ===


See [http://microformats.org/wiki/hcard-examples#3.2.1_ADR_Type_Definition hCard example ADR] for more examples.
Voir [[hcard-examples-fr#3.2.1_D.C3.A9finition_Type_ADR|exemples ADR hCard] pour plus d'exemple.


See [http://microformats.org/wiki/adr-examples adr examples] for additional uses of ADR.
Voir [http://microformats.org/wiki/adr-examples-fr exemples adr] pour des usages additionnels de ADR.


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


The following sites have published adrs, outside their normal context of hCards, and thus are a great place to start for anyone looking for examples "in the wild" to try parsing, indexing, organizing etc., in addition to [[hcard|hCard]] examples in the wild. If you find adrs outside of hCards anywhere else, feel free to add them to the top of this list. Once the list grows too big, we'll make a separate wiki page.
Les sites suivants ont publié des adr en dehors du contexte normal des hCards, et sont par conséquent un endroit génial pour commencer à regarder des exemples "dans la jungle" afin d'essayer de parser, indexer, organiser, etc., en plus des exemples [[hcard-fr|hCard]] dans la jungle. Si vous trouvez des adrs en dehors des hCards n'importe où ailleurs, sentez-vous à l'aise pour les ajouter en haut de cette liste. Une fois que la liste sera devenue trop grosse, nous ferons une page wiki séparée.


* ...
* ...
Line 114: Line 114:


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


The following implementations have been developed which either generate or parse adrs outside the context of hCards. If you have an adr implementation, feel free to add it to the top of this list. Once the list grows too big, we'll make a separate wiki page.
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://code.highearthorbit.com/greaseroute/index.php GreaseRoute] is a GreaseMonkey user script (also available as a simple Firefox Extension) which will add icons for displaying the location, or route to, an [[adr]] using a MapQuest map. The route is displayed from the starting location based on the viewer's IP-Address as determined by the [http://hostip.info HostIP] geolocation service.


* [http://code.highearthorbit.com/greaseroute/index.php GreaseRouteEmbed] is another GreaseMonkey user script that will actually embed a route image in the webpage when the user clicks the "route" link.  
* [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] is a plugin for [http://textpattern.com/ Textpattern] that supports embedding adrs and other microformats in templates and blog posts. Written by [http://placenamehere.com/ Chris Casciano].
* [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].


* The [http://tantek.com/microformats/hcard-creator.html hCard creator], though it creates complete hCards, can also be used simply to create adrs by filling out the address portion and simply copy and pasting the &lt;div class="adr"&gt; element and its contents.
* 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; element and its contents.


== Références ==
== Références ==
Line 140: Line 141:


== Chantier en cours ==
== Chantier en cours ==
This specification is a work in progress. As additional aspects are discussed, understood, and written, they will be added.
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 ==
== Discussions ==
Line 147: Line 148:


=== Q&R ===
=== Q&R ===
* If you have any questions about hCard, check the [[hcard-faq|hCard FAQ]] first, and if you don't find answers, add your questions! (Odds are that any '''adr''' question will apply to [[hCard]] as well).
* 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]]).
* See also [http://microformats.org/discuss/ for other methods of feedback].
* Voir aussi [http://microformats.org/discuss/ pour d'autres méthodes de feedback].


=== Problématiques ===
=== Problématiques ===
* Please add any issues with the specification to the separate [[hcard-issues-fr|hCard issues]] document.  Ditto.
* SVP, ajoutez toutes les problématiques avec la spécification sur le documen séparé [[hcard-issues-fr|problématiques hCard]].  Ditto.


== Voir aussi ==
== Voir aussi ==
* [[adr-examples-fr|exemples adr]]
* [[adr-examples-fr|exemples adr]]

Revision as of 04:55, 2 July 2006

adr

adr (nom de code pour travailler, prononcez "adeure") est un format simple pour baliser l'information adresse, approprié pour l'embarquement dans (X)HTML, Atom, RSS et le XML arbitraire. adr est une représentation 1:1 de la propriété adr dans le standard vCard (RFC2426) en XHTML, l'un des nombreux standards ouverts microformats.

Spécification Brouillon

Editeur/Auteur

Tantek Çelik, Technorati, Inc.

Copyright

Cette spécification est (C) 2005-2024 par les auteurs. Néanmoins, les auteurs ont pour but de soumettre cette spécification à un corps de standards avec une politique libérale de copyright/licence telle que GMPG, IETF, et/ou W3C. Quiconque souhaite contribuer devrait lire avant de contribuer leurs principes de copyright, politiques et licences (par ex. les Principes GMPG) et être d'accord avec eux, y compris le fait de licencier toutes les contributions sous les licences nécessaires (par ex. CC-by 1.0 et suivantes).

Brevets

Cette spécification est sujette à une politique de brevets libres de droits, par ex. pour la Politique de Brevet du W3C, IETF RFC3667 et RFC3668.

Inspiration et Remerciements

Merci à tous ceux qui ont participé dans le Geo Microformat BOF at O'Reilly's Where 2.0 conference, et tout particulièrement Nat Torkington et Vee McMillen de O'Reilly pour organiser et héberger le BOF.

Introduction et Historique

Le standard vCard (RFC2426), a été largement implémenté de façon interopérable (par ex. l'application carnet d'adresses d'Apple). Le microformat 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 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 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.

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 au lieu de simplement adr pour publier le nom et l'adresse du lieu.

Principes de Design XHTML Sémantique

Note : les Principes de Design XHTML Sémantique ont été écrits initialement dans le contexte de développement de hCard et hCalendar, par conséquent il peut être plus facile de comprendre ces principes dans le contexte de la méthodologie de design hCard (ce qui veut dire, lisez ça d'abord). Tantek

XHTML est construit sur du XML, et par conséquent les formats fondés sur XHTML peuvent être utilisés non seulement pour une présentation d'affichage pratique, mais aussi à des fins d'échanges de données. A bien des façons, les formats fondés sur XHTML illustrent le meilleur des mondes tant du HTML que du XML. Néanmoins au moment de construire des formats basés sur XHTML, cela aide d'avoir un ensemble de principes directeurs.

  1. Réutilisez autant que possible le schéma (noms, objets, propriétés, valeurs, types, hiérarchies, contraintes) à partir des standards de référence établis et bien supportés. Evitez de redéclarer les contraintes exprimées dans le standard source. Des mentions à titre d'information peuvent passer.
    1. Pour les types avec plusieurs composants, utilisez des éléments imbriqués avec des noms de classe équivalents aux noms des composants.
    2. Les composants pluriels sont produits au singulier, et par conséquent plusieurs éléments imbriqués sont utilisés pour représenter plusieurs valeurs de texte qui sont délimitées par des virgules.
  2. Utilisez la sémantique XHTML la plus précise pour construire des blocs pour chaque objet, etc.
  3. Autrement utilisez un élément générique structurel (par ex. <span> ou <div>), ou l'élément contextuel approprié (par ex. un <li> dans un <ul> ou <ol>).
  4. Utilisez des noms de classes basés sur des noms extraits du schéma original, à moins que le XHTML sémantique de construction de bloc ne représente précisément cette partie du schéma original. Si les noms dans le schéma original ne sont pas sensibles la casse, alors mettez tout dans un équivalent en bas de casse. Les noms de composants implicites en prose (plutôt qu'explicites dans le schéma défini) devraient aussi utiliser les équivalents bas de casse pour une facilité d'utilisation. Les espaces dans les noms des composants deviennent des caractères tiret '-'.
  5. Pour finir, si le format de la donnée selon le schéma original est trop long et/ou non amical sur le plan humain, utilisez <abbr> au lieu d'un élément générique structurel, et placez les données littérales dans l'attribut 'title' (là où vont les expansions abbr), et l'équivalent le plus bref et le plus lisible humainement dans l'élément lui-même. De plus amples explications de cet usage de <abbr> : Human vs. ISO8601 dates problem solved

Format

Propriétés Singulières

Remarquez que toutes les propriétés dans adr sont des propriétés singulières et par conséquent le premier élément descendant avec cette classe devrait prendre effet, tous les autres étant ignorés.

Lisible Humain vs Machine

Si un élément <abbr> est utilisé pour une propriété, alors l'attribut title de l'élément <abbr> est la valeur de la propriété, au lieu des contenus de l'élément, qui fournissent à la place une version présentable humainement de la valeur.

De la même façon, si un élément <img> est utilisé pour une ou plusieurs propriétés, il doit être traité comme suit :

  1. Pour la propriété PHOTO et toute autre propriété qui prend un URL comme sa valeur, l'attribut src fournit la valeur de la propriété.
  2. Pour d'autres propriétés, l'attribut alt de <img> est la valeur de la propriété.


Extraction 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 le nom de classe value est utilisé pour extraire la partie de l'élément qui est la valeur de la propriété. Voir hCard pour les détails à ce sujet.

Nom Classe Racine

Le nom de classe racine pou une adresse adr est adr.

Liste Propriétés

Ceci est la liste des propriétés dans adr, extraite de hCard:

  • post-office-box
  • extended-address
  • street-address
  • locality
  • region
  • postal-code
  • country-name

La sous-propriété type 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 profil hCard pour le profil 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 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 adr :

<div class="adr">
 <div class="street-address">665 3rd St.</div>
 <div class="extended-address">Suite 207</div>
 <span class="locality">San Francisco</span>,
 <span class="region">CA</span>
 <span class="postal-code">94107</span>
 <div class="country-name">U.S.A.</div>
</div>

Cette adr pourrait être affiché comme :

665 3rd St.
Suite 207
San Francisco, CA 94107
U.S.A.

Plus d'exemples

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

Voir exemples adr pour des usages additionnels de ADR.

Exemples dans la jungle

Cette section est informative.

Les sites suivants ont publié des adr en dehors du contexte normal des hCards, et sont par conséquent un endroit génial pour commencer à regarder des exemples "dans la jungle" afin d'essayer de parser, indexer, organiser, etc., en plus des exemples hCard dans la jungle. Si vous trouvez des adrs en dehors des hCards n'importe où ailleurs, sentez-vous à l'aise pour les ajouter en haut de cette liste. Une fois que la liste sera devenue trop grosse, nous ferons une page wiki séparée.

  • ...
  • ...

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.


  • 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 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 HostIP.
  • 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".
  • pnh_mf est un plugin pour Textpattern qui supporte l'embarquement des adrs et d'autres microformats dans les gabarits et billets de blog. Ecrit par Chris Casciano.
  • Le 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 <div class="adr"> element and its contents.

Références

Références Normatives

Références Informatives

Travaux Similaires

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

Q&R

  • Si vous avez quelque question à propos de hCard, regardez d'abord les 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).
  • Voir aussi pour d'autres méthodes de feedback.

Problématiques

  • SVP, ajoutez toutes les problématiques avec la spécification sur le documen séparé problématiques hCard. Ditto.

Voir aussi