abbr-design-pattern-fr: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
(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 rendre le texte qui est lisible par un humain aussi lisble formellement par une machine
* 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 ? ==
* entourer le texte convivial-pour-les-humains que vous voulez pour le rendre lisible par les machines avec <code>&lt;abbr></code>  
* enclore le texte convivial-pour-les-humains que vous voulez pour faire qu'il soit lisible par les machines avec <code>&lt;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 soirée aura lieu le 10 à 22 heures.
La fête aura lieu le 10 à 10 heures.
</pre>
</pre>


Line 22: Line 22:


<pre>
<pre>
La soirée aura lieu le  
La fête aura lieu le  
<abbr class="dtstart" title="20051010T10:10:10-0100">10 à 22 heures</abbr>.
<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 à 22 heures</abbr>
<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 visibile, alors nous ne devrions par 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".
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ément abbr
  • ajoutez un attribut title à l'élément abbr 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 :

  1. 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>
    
  2. 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

Voir aussi