abbr-design-pattern-fr: Difference between revisions
(abbr-design-pattern : translation to be reviewed) |
m (error fixed : 10h00 vs 22:00 (to be reviewed)) |
||
Line 2: | Line 2: | ||
== Objectif == | == Objectif == | ||
* Utiliser le [[abbr-design-pattern-fr|abbr-design-pattern]] pour | * Utiliser le [[abbr-design-pattern-fr|abbr-design-pattern]] pour faire que le texte qui soit lisible par un humain soit aussi lisible formellement par une machine | ||
* Eviter d'utiliser [[abbr-design-pattern-fr|abbr-design-pattern]] pour réencoder le texte humain ou pour cacher les données | * Eviter d'utiliser [[abbr-design-pattern-fr|abbr-design-pattern]] pour réencoder le texte humain ou pour cacher les données | ||
== Comment l'utiliser ? == | == Comment l'utiliser ? == | ||
* | * enclore le texte convivial-pour-les-humains que vous voulez pour faire qu'il soit lisible par les machines avec <code><abbr></code> | ||
* comme pour le [[class-design-pattern-fr|class-design-pattern]], ajoutez l'attribut approprié <code>class</code> à l'élément <code>abbr</code> | * comme pour le [[class-design-pattern-fr|class-design-pattern]], ajoutez l'attribut approprié <code>class</code> à l'élément <code>abbr</code> | ||
* ajoutez un attribut <code>title</code> à l'élément <code>abbr</code> avec les données lisibles par les machines comme la valeur. | * ajoutez un attribut <code>title</code> à l'élément <code>abbr</code> avec les données lisibles par les machines comme la valeur. | ||
== Exemple == | == Exemple == | ||
Le [[datetime-design-pattern-fr|datetime-design-pattern]] encode formellement les datetimes (bien connus pour être non parsables) à l'intérieur d'un élément <code>abbr</code>. | Le [[datetime-design-pattern-fr|datetime-design-pattern]] encode formellement les 'datetimes' (bien connus pour être non parsables) à l'intérieur d'un élément <code>abbr</code>. | ||
avant : | avant : | ||
<pre> | <pre> | ||
La | La fête aura lieu le 10 à 10 heures. | ||
</pre> | </pre> | ||
Line 22: | Line 22: | ||
<pre> | <pre> | ||
La | La fête aura lieu le | ||
<abbr class="dtstart" title="20051010T10:10:10-0100">10 à | <abbr class="dtstart" title="20051010T10:10:10-0100">10 à 10 heures</abbr>. | ||
</pre> | </pre> | ||
Line 34: | Line 34: | ||
<pre> | <pre> | ||
<abbr class="dtstart" title="20051010T10:10:10-0100">le 10 à | <abbr class="dtstart" title="20051010T10:10:10-0100">le 10 à 10 heures</abbr> | ||
</pre> | </pre> | ||
</li> | </li> | ||
Line 46: | Line 46: | ||
</ol> | </ol> | ||
L'utilisation #1 est encouragée s'il y a un véritable besoin pour cela. L'utilisation de #2 n'est pas recommandée sous le [http://c2.com/cgi-bin/wiki?DontRepeatYourself principe Don't Repeat Yourself], parce que : "#2 est un cas de *plus* d'information étant invisiblement présente, nommément, le nom de famille dans ce cas. Si quelqu'un ne veut pas rendre quelque information | L'utilisation #1 est encouragée s'il y a un véritable besoin pour cela. L'utilisation de #2 n'est pas recommandée sous le [http://c2.com/cgi-bin/wiki?DontRepeatYourself principe Don't Repeat Yourself], parce que : "#2 est un cas de *plus* d'information étant invisiblement présente, nommément, le nom de famille dans ce cas. Si quelqu'un ne veut pas rendre quelque information visible, alors nous ne devrions pas l'encourager à stocker cette information de façon invisible, pour toutes les mêmes raisons que les méta-données invisibles sont en premier lieu mauvaises/futiles". | ||
''J'aimerais effacer ça en-dessous, car les points sont couverts au-dessus'' | ''J'aimerais effacer ça en-dessous, car les points sont couverts au-dessus'' |
Revision as of 05:42, 21 February 2007
Abbr design pattern
Objectif
- Utiliser le abbr-design-pattern pour faire que le texte qui soit lisible par un humain soit aussi lisible formellement par une machine
- Eviter d'utiliser abbr-design-pattern pour réencoder le texte humain ou pour cacher les données
Comment l'utiliser ?
- enclore le texte convivial-pour-les-humains que vous voulez pour faire qu'il soit lisible par les machines avec
<abbr>
- comme pour le class-design-pattern, ajoutez l'attribut approprié
class
à l'élémentabbr
- ajoutez un attribut
title
à l'élémentabbr
avec les données lisibles par les machines comme la valeur.
Exemple
Le datetime-design-pattern encode formellement les 'datetimes' (bien connus pour être non parsables) à l'intérieur d'un élément abbr
.
avant :
La fête aura lieu le 10 à 10 heures.
After:
La fête aura lieu le <abbr class="dtstart" title="20051010T10:10:10-0100">10 à 10 heures</abbr>.
Discussion
Cette discussion est rejetée d'ici. Imaginez deux usages possibles pour le abbr-design-pattern :
-
utiliser ABBR pour encoder les données lisibles par les machines autour de données lisibles par des humains
<abbr class="dtstart" title="20051010T10:10:10-0100">le 10 à 10 heures</abbr>
-
Utiliser ABBR pour encoder des données humaines plus formelles autour de quelque chose de moins formel
<abbr class="author" title="Danny Ayers">Danny</abbr>
L'utilisation #1 est encouragée s'il y a un véritable besoin pour cela. L'utilisation de #2 n'est pas recommandée sous le principe Don't Repeat Yourself, parce que : "#2 est un cas de *plus* d'information étant invisiblement présente, nommément, le nom de famille dans ce cas. Si quelqu'un ne veut pas rendre quelque information visible, alors nous ne devrions pas l'encourager à stocker cette information de façon invisible, pour toutes les mêmes raisons que les méta-données invisibles sont en premier lieu mauvaises/futiles".
J'aimerais effacer ça en-dessous, car les points sont couverts au-dessus
- Théoriquement, ceci pourrait être produit avec presque n'importe quel élément HTML. Mais est-ce une bonne idée ? Si ce n'en est pas une, est-ce que abbr est la seule ? DavidJanes
- abbr-design-pattern devrait être évité si possible. RobertBachmann
- pourquoi, ou sous quelles circonstances ? Par exemple, il est tout à fait utile avec les datetimes. Devrait-il y avoir là d'autres situations potenitellement analogues ? DavidJanes