machine-data-fr - Revision history

AmeerDawood: /* Problèmes Potentiels */

2008-11-17T23:48:09Z

Problèmes Potentiels

← Older revision		Revision as of 23:48, 17 November 2008
Line 126:		Line 126:

	* Some parsers (particularly those that run incoming HTML through [http://tidy.sf.net Tidy] to convert it into well-formed XML) may strip empty inline elements. A workaround may be to allow (or even require) hard white space (i.e. <code>&nbsp;</code>) within the element with class='value".		* Some parsers (particularly those that run incoming HTML through [http://tidy.sf.net Tidy] to convert it into well-formed XML) may strip empty inline elements. A workaround may be to allow (or even require) hard white space (i.e. <code>&nbsp;</code>) within the element with class='value".
	**It is, however, trivial to patch and build Tidy not to do this (keeping empty elements where that element also has a class attribute). Parser writers need to feed back on whether using a custom build is impossible to their solution, but since Tidy can be made to work, the problem can likely be alleviated. Ben Ward has put up an experimental build of Tidy with patched element-dropping ~~behaviour~~ here: [http://ben-ward.co.uk/files/tidy-microformats.zip tidy-microformats.zip]		**It is, however, trivial to patch and build Tidy not to do this (keeping empty elements where that element also has a class attribute). Parser writers need to feed back on whether using a custom build is impossible to their solution, but since Tidy can be made to work, the problem can likely be alleviated. Ben Ward has put up an experimental build of Tidy with patched element-dropping behavior here: [http://ben-ward.co.uk/files/tidy-microformats.zip tidy-microformats.zip]

	=== Autres Propositions ===		=== Autres Propositions ===

AmeerDawood: /* Donnée Supplémentaire */

2008-11-17T23:47:24Z

Donnée Supplémentaire

← Older revision		Revision as of 23:47, 17 November 2008
Line 81:		Line 81:
	===Donnée Supplémentaire===		===Donnée Supplémentaire===

	The machine data form can be included alongside any human legible text, and hidden using another layer of the browser stack (namely, CSS). This ~~behaviour~~ is derived from the [[hcard#Value_excerpting\|value excerpting]] ~~behaviour~~ in hCard.		The machine data form can be included alongside any human legible text, and hidden using another layer of the browser stack (namely, CSS). This behavior is derived from the [[hcard#Value_excerpting\|value excerpting]] behavior in hCard.

	So, for example, when describing a location by name, but still wanting to include [[geo]] for the machine-readable location:		So, for example, when describing a location by name, but still wanting to include [[geo]] for the machine-readable location:

ChristopheDucamp: typo

2008-05-28T05:05:00Z

typo

← Older revision		Revision as of 05:05, 28 May 2008
Line 3:		Line 3:
	{{TOC-right}}		{{TOC-right}}

	Les microformats sont conçus pour marquer une information consommable par l'~~homme~~, comme cela ~~est~~ généralement vu dans la jungle. Mais dans un certain nombre de cas exceptionnels, il a été nécessaire de spécifier des formats précis de données pour des propriétés spécifiques. Les formats pour les dates, horaires, et lieux sont standardisés d'une manière qui ne correspond pas toujours à la manière dont l'information est publiée visiblement. Ceci est nécessaire pour ~~rendre~~ la donnée compréhensible par les parseurs. De la même manière, il y a des mots-clés dans la hCard qui doivent être ~~écrit~~ en anglais ('type' telephone dans la hCard par exemple).		Les microformats sont conçus pour marquer une information consommable par l'humain, comme cela se rencontre généralement dans la jungle. Mais dans un certain nombre de cas exceptionnels, il a été nécessaire de spécifier des formats précis de données pour des propriétés spécifiques. Les formats pour les dates, horaires, et lieux sont standardisés d'une manière qui ne correspond pas toujours à la manière dont l'information est publiée visiblement. Ceci est nécessaire pour faire que la donnée soit compréhensible par les parseurs. De la même manière, il y a des mots-clés dans la hCard qui doivent être écrits en anglais ('type' telephone dans la hCard par exemple).

	Il est nécessaire pour ces formats de données d'être fixés pour rendre la donnée parsable par les machines ; le coût pour un parseur de supporter chaque format publié de date-time dans le monde (ce qui inclut des approximations comme 'il y a cinq minutes') est trop élevé, comme l'est la gestion de traduction internationale (telle que les téléphones mobiles ; <abbr title="United States">US</abbr>-English ‘cell’ publié comme un 'mobile' British English).		Il est nécessaire pour ces formats de données d'être fixés pour rendre la donnée parsable par les machines ; le coût pour un parseur de supporter chaque format publié de date-time dans le monde (ce qui inclut des approximations comme 'il y a cinq minutes') est trop élevé, comme l'est la gestion de traduction internationale (telle que les téléphones mobiles ; <abbr title="United States">US</abbr>-English ‘cell’ publié comme un 'mobile' British English).

ChristopheDucamp at 05:02, 28 May 2008

2008-05-28T05:02:55Z

← Older revision		Revision as of 05:02, 28 May 2008
Line 7:		Line 7:
	Il est nécessaire pour ces formats de données d'être fixés pour rendre la donnée parsable par les machines ; le coût pour un parseur de supporter chaque format publié de date-time dans le monde (ce qui inclut des approximations comme 'il y a cinq minutes') est trop élevé, comme l'est la gestion de traduction internationale (telle que les téléphones mobiles ; <abbr title="United States">US</abbr>-English ‘cell’ publié comme un 'mobile' British English).		Il est nécessaire pour ces formats de données d'être fixés pour rendre la donnée parsable par les machines ; le coût pour un parseur de supporter chaque format publié de date-time dans le monde (ce qui inclut des approximations comme 'il y a cinq minutes') est trop élevé, comme l'est la gestion de traduction internationale (telle que les téléphones mobiles ; <abbr title="United States">US</abbr>-English ‘cell’ publié comme un 'mobile' British English).

	Dans certains cas, la version humaine de la donnée peut être sémantiquement décrite sous une forme abrégée de la donnée machine, et la donnée machine peut être aussi consommable par l'homme. Par exemple le [[date-design-pattern~~-fr~~\|date-design-pattern~~-fr~~]] utilise l'élément <code>abbr</code> du HTML pour étendre une représentation de date humaine en une date au format ISO 8601 : ‘January 1st’ est une forme abrégée ‘2008-01-01’. La dernière est aussi déchiffrable pour les humains (et peut leur être exposée à travers des infobulles et des screen-readers).		Dans certains cas, la version humaine de la donnée peut être sémantiquement décrite sous une forme abrégée de la donnée machine, et la donnée machine peut être aussi consommable par l'homme. Par exemple le [[date-design-pattern\|date-design-pattern]] utilise l'élément <code>abbr</code> du HTML pour étendre une représentation de date humaine en une date au format ISO 8601 : ‘January 1st’ est une forme abrégée ‘2008-01-01’. La dernière est aussi déchiffrable pour les humains (et peut leur être exposée à travers des infobulles et des screen-readers).

	Dans d'autres cas, cette donnée machine n'est '''pas''' déchiffrable par les humains. Dans le [[haudio-fr\|hAudio]], la propriété [[haudio-fr#Duration\|duration]] utilise ISO 8601, ce qui aboutit en une donnée machine de <code>PT3M23S</code> ; non compréhensible pour les humains, et par conséquent pas une expansion valide de ‘trois minutes et ving-trois secondes’.		Dans d'autres cas, cette donnée machine n'est '''pas''' déchiffrable par les humains. Dans le [[haudio-fr\|hAudio]], la propriété [[haudio-fr#Duration\|duration]] utilise ISO 8601, ce qui aboutit en une donnée machine de <code>PT3M23S</code> ; non compréhensible pour les humains, et par conséquent pas une expansion valide de ‘trois minutes et ving-trois secondes’.

ChristopheDucamp: [fr: translation in progress - to be cont'd]

2008-05-28T05:02:00Z

[fr: translation in progress - to be cont'd]

New page

<h1>Données Machine dans les Microformats</h1>

{{TOC-right}}

Les microformats sont conçus pour marquer une information consommable par l'homme, comme cela est généralement vu dans la jungle. Mais dans un certain nombre de cas exceptionnels, il a été nécessaire de spécifier des formats précis de données pour des propriétés spécifiques. Les formats pour les dates, horaires, et lieux sont standardisés d'une manière qui ne correspond pas toujours à la manière dont l'information est publiée visiblement. Ceci est nécessaire pour rendre la donnée compréhensible par les parseurs. De la même manière, il y a des mots-clés dans la hCard qui doivent être écrit en anglais ('type' telephone dans la hCard par exemple).

Il est nécessaire pour ces formats de données d'être fixés pour rendre la donnée parsable par les machines ; le coût pour un parseur de supporter chaque format publié de date-time dans le monde (ce qui inclut des approximations comme 'il y a cinq minutes') est trop élevé, comme l'est la gestion de traduction internationale (telle que les téléphones mobiles ; <abbr title="United States">US</abbr>-English ‘cell’ publié comme un 'mobile' British English).

Dans certains cas, la version humaine de la donnée peut être sémantiquement décrite sous une forme abrégée de la donnée machine, et la donnée machine peut être aussi consommable par l'homme. Par exemple le [[date-design-pattern-fr|date-design-pattern-fr]] utilise l'élément <code>abbr</code> du HTML pour étendre une représentation de date humaine en une date au format ISO 8601 : ‘January 1st’ est une forme abrégée ‘2008-01-01’. La dernière est aussi déchiffrable pour les humains (et peut leur être exposée à travers des infobulles et des screen-readers).

Dans d'autres cas, cette donnée machine n'est '''pas''' déchiffrable par les humains. Dans le [[haudio-fr|hAudio]], la propriété [[haudio-fr#Duration|duration]] utilise ISO 8601, ce qui aboutit en une donnée machine de <code>PT3M23S</code> ; non compréhensible pour les humains, et par conséquent pas une expansion valide de ‘trois minutes et ving-trois secondes’.

==Cas de Formats de Données Fixés dans les Microformats==

Ce qui suit sont tous les usages actuels des formats de données machine fixés requis par les différents microformats.

===hCalendar===

* Usages de ISO 8601 pour <code>dtstart</code>, <code>dtend</code>, <code>duration</code> et <code>rdate</code>

===hCard===

* Telephone [[hcard-fr#adr_tel_email_types|mots-clés <code>type</code>]] : <code>voice</code>, <code>home</code>, <code>msg</code>, <code>work</code>, <code>pref</code>, <code>fax</code>, <code>cell</code>, <code>video</code>, <code>pager</code>, <code>bbs</code>, <code>modem</code>, <code>car</code>, <code>isdn</code>, <code>pcs</code>.
* Address mots-clés type : <code>INTL</code>, <code>POSTAL</code>, <code>PARCEL</code>, <code>WORK</code>, <code>dom</code>, <code>home</code>, <code>pref</code>.
* Email mots-clés type : <code>INTERNET</code>, <code>x400</code>, <code>pref</code>.
* Usages de date ISO 8601 pour <code>bday</code>
* ISO 8601 time zone pour <code>tz</code>
* Les numéros de téléphone requièrent une forme numérique, bien que les numéros de téléphone puissent être présentés sous forme alpha-numérique : par ex +1-555-FORMATS

===hReview===

* Usages d'un date-time ISO 8601 pour <code>dtreviewed</code>
* Usages de valeurs entières de <var>0</var>-<var>5</var> pour <code>rating</code> (les éditeurs peuvent par exemple, afficher une évaluation en pourcentage)

===hAtom===

* Usages d'un date-time ISO 8601 pour <code>updated</code>
* Usages d'un date-time ISO 8601 pour <code>published</code>

===hResume===

* Uses ISO 8601 date for individual <code>experience</code> items.
* Uses ISO 8601 date for individual <code>education</code> items.

===Geo===

* requiert <code>latitude</code> et <code>longitude</code> en format décimal (<code>1.23232;-2.343535</code>), mais peut être publié en degrés : <code>N 37° 24.491</code>, <code>W 122° 08.313</code>
* Les lieux sont le plus souvent publiés tout simplement comme des noms d'endroits (pas des coordonnées abrégées)

===hAudio===

* Utilise ISO 8601 pour la <code>duration</code> de la plage, par ex. <code>PT3M23S</code>

==Embarquement de Formats de Données Fixés dans les Microformats==

Il existe actuellement trois méthodes supportées pour inclure ces formats de données fixés dans un document microformaté.

===Contenu de Page Visible===

Vous pouvez utiliser le [[class-design-pattern-fr|class-design-pattern]] pour marquer la donnée visiblement dans la page.

<code>Ben est né le ''1984-02-09''.</code>

<code>Nous nous rencontrons sur le Toit de la Grande Arche (48.892381, 2.236274).</code>

===Abréviation===

Dans quelques cas, les formats de données spécifiés produisent des expansions valides de formes communes pour les humains, tels que les dates dans un champ birthday de hCard :

<code>Ben est né le <abbr class="bday" title="1984-02-09">9 février</abbr></code>

Remarquez néanmoins que tous les formats de données ne sont pas des expansions valides. En HTML, l'élément <code>abbr</code> fonctionne sémantiquement à un niveau texte, pas à un niveau donnée. Tant la forme abrégé (le texte à l'intérieur) que la forme étendue (le title) ont besoin d'être consommables par les humains.

Ce qui veut dire dans hAudio, que l'utilisation d'une abréviation pour <code>duration</code> est incorrect :

<code><abbr class="duration" title="PT3M23S">3 minutes, 23 secondes</abbr></code>

Whilst the ''data'' ‘PT3M23S’ is an expanded form of ‘3 minutes, 23 seconds’, the text is not; ‘PT3M23S’ is nonsense to most human beings. <code>abbr</code> is an element that describes the ''text'', not the data. HTML4 has no way to mark up arbitrary data.

===Donnée Supplémentaire===

The machine data form can be included alongside any human legible text, and hidden using another layer of the browser stack (namely, CSS). This behaviour is derived from the [[hcard#Value_excerpting|value excerpting]] behaviour in hCard.

So, for example, when describing a location by name, but still wanting to include [[geo]] for the machine-readable location:

<code>Northumberland Avenue, London 51.507033,-0.126343</code>

Then, optionally use CSS to hide the data you don't want displayed:

<code>.geo > .value { display: none; }</code>

The same pattern works for the [[hAudio]] <code>duration</code> example given above:

<code>3 minutes and 23 seconds PT3M23S</code>

And again, the optional CSS:

<code>.haudio .duration > .value { display: none; }</code>

Of course, this does result in a dependency on CSS to make the data invisible to users, and will result in the machine data being displayed alongside the human form in any user agent without CSS support. That's a compromise that has to be resolved based on the requirements of individual sites.

== Méthodes Proposées ==

===Donnée Supplémentaire Invisible===

''This section is a proposed extension to value-excerpting, is currently open to active discussion and is not currently supported in parsers. You '''must not''' implement this in pages at this time.''

Value excerpting is already implemented as a means of extracting data from within a microformat property. Where the element (''any'' element) with <code>class="value"</code> is also empty (containing no inner-text), parsers should instead read the value of the <code>title</code> attribute of that element.

So, the following code will read the inner-text of the element, as per current implementations:

<code>Tomorrow lunchtime 2008-05-17T12:00:00+0100</code>

The data format, poorly legible to most humans remains visible in the page. To make the machine data invisible at an HTML level, the following can also be parsed:

<code>Tomorrow lunchtime </code>

The <code>span</code> with <code>class="value"</code> is empty, therefore the parser must read the value of the <code>title</code> attribute instead. Where the element is ''not empty'', the <code>title</code> attribute is ignored.

Empty elements are invisible within the page, and take up no physical space, so the <code>title</code> is not exposed as a tool-tip. Also, the entire element is ignored by assistive technology such as screen readers, therefore the data is not exposed to any user. ''This assistive technology claim is based on informed, expert advice, but is awaiting confirmation through testing. That testing is forthcoming''.

HTML has no pure way of including machine data inline. The use of value excerpting, which can be applied to any HTML element, is the least obtrusive way to embed data into HTML, without overloading existing element semantics and without browser compatibility issues.

==== Problèmes Potentiels ====

* Some parsers (particularly those that run incoming HTML through [http://tidy.sf.net Tidy] to convert it into well-formed XML) may strip empty inline elements. A workaround may be to allow (or even require) hard white space (i.e. <code>&nbsp;</code>) within the element with class='value".
**It is, however, trivial to patch and build Tidy not to do this (keeping empty elements where that element also has a class attribute). Parser writers need to feed back on whether using a custom build is impossible to their solution, but since Tidy can be made to work, the problem can likely be alleviated. Ben Ward has put up an experimental build of Tidy with patched element-dropping behaviour here: [http://ben-ward.co.uk/files/tidy-microformats.zip tidy-microformats.zip]

=== Autres Propositions ===

Cette section doit être étendue.

* ufusetitle class
* adopter l'attribut RDFa "content"
* "data:" prefix

==Remerciements==

* [http://isolani.co.uk Mike Davies] pour sa suggestion d'utiliser un <code>span</code> vide comme moyen d'embarquer de la donnée sans qu'elle ne soit exposée dans les technologies assistives.
* [http://adactio.com Jeremy Keith] pour l'assistance au raffinement l'extension de donnée invisible pour l'extraction-valeur

==Pages en Rapport==

* [[class-design-pattern-fr]]
* [[abbr-design-pattern-fr]]
* [[date-design-pattern-fr]]
* [[datetime-design-pattern-fr]]
* HTML 4.01 définition de l'élément <code>[http://www.w3.org/TR/REC-html40/struct/text.html#edef-ABBR <abbr]></code>