From 73d9be8f9c1ff3622f37fffa117d0f435f7ad4a0 Mon Sep 17 00:00:00 2001 From: tristantheb Date: Sun, 11 Apr 2021 16:41:56 +0200 Subject: L10N: Update content of the HTML section - Part 1 (#299) * UPDATE: Update content of the HTML page with en-US * FIX: Removing KS or the translation * UPDATE: Update content of the Applying_color page * UPDATE: Update content of the Block-level_elements page * UPDATE: Update content of the CORS_enabled_image page * UPDATE: Update content of the Date_and_time_formats page * FIX: Fixing html position * Minor fix on html * UPDATE: Update content of the Inline_elements page * UPDATE: Update content of the Link_types page * UPDATE: Update content of the Microdata page * UPDATE: Update content of the Microformats page * UPDATE: Update content of the Preloading_content page * UPDATE: Updating the q_mode_&_s_mode page + removing old invalid link * UPDATE: Removing xref KS and update links * UPDATE: Update content layout and remove old link on Using_the_application_cache page * L10N: Translation of the Viewport_meta_tag page * Review - HTML Applying colors - minor typos and a missing paragraph * Review - HTML Block Elements - minor typos / lint * Review - HTML CORS Images - minor rewording / link fix * Review - HTML date time formats - linting typography, minor changes * Review - HTML Landing page - minor rewording, typos * Review - HTML Inline elements - minor linting / example translation * Review - HTML link types - lint HTML / rm brs * Review - HTML microdata - minor linting * Review - HTML microformat - minor typofixes * Review - HTML preloading - minor changes * Review - HTML quirks - minor changes / rm deadlinked section * Review - HTML element references - minor change * Review - HTML Meta Viewport - minor changes Co-authored-by: julieng --- files/fr/web/html/microformats/index.html | 256 +++++++++++++++--------------- 1 file changed, 131 insertions(+), 125 deletions(-) (limited to 'files/fr/web/html/microformats') diff --git a/files/fr/web/html/microformats/index.html b/files/fr/web/html/microformats/index.html index 9144f6683b..dee6a2c39f 100644 --- a/files/fr/web/html/microformats/index.html +++ b/files/fr/web/html/microformats/index.html @@ -1,33 +1,43 @@ --- -title: microformats +title: Microformats slug: Web/HTML/microformats tags: + - Composing - HTML - - Microformat - - µFormat + - Microformats + - NeedsContent + - NeedsMarkupWork + - Reference + - SEO + - Search translation_of: Web/HTML/microformats --- -
{{HTMLSidebar}}
+

Les microformats (parfois abrégés μF) sont des normes utilisées pour intégrer la sémantique et les données structurées dans le HTML, et fournir une API à utiliser par les moteurs de recherche, les agrégateurs et autres outils. Ces modèles minimaux de HTML sont utilisés pour marquer des entités allant d'informations fondamentales à des informations spécifiques à un domaine, telles que des personnes, des organisations, des événements et des lieux. Les microformats utilisent des vocabulaires de soutien pour décrire les objets et des paires nom-valeur pour attribuer des valeurs à leurs propriétés. Les propriétés sont transportées dans des attributs de classe qui peuvent être ajoutés à tout élément HTML, tandis que les valeurs des données réutilisent le contenu des éléments HTML et les attributs sémantiques. Microformats2 est une mise à jour de microformats qui offre un moyen plus simple d'annoter la syntaxe structurée et les vocabulaires HTML que les approches précédentes utilisant RDFa et microdata qui nécessitent l'apprentissage de nouveaux attributs.

-

Les microformats (parfois abrégés μF) sont un ensemble de conventions pour intégrer une sémantique en HTML et fournir une API utilisable par les moteurs de recherche, les agrégateurs et d'autres outils. Ces constructions HTML permettent de marquer des entités pouvant être génériques (personnes, organisations, évènements, etc.) ou spécifiques à un domaine.

+

Les microformats sont pris en charge par tous les principaux moteurs de recherche. Les moteurs de recherche bénéficient grandement d'un accès direct à ces données structurées, car elles leur permettent de comprendre les informations contenues dans les pages Web et de fournir des résultats plus pertinents aux utilisateurs. En plus d'être lisible par les machines, leur format est conçu pour être facilement lu par les humains.

-

Les microformats sont utilisés par l'ensemble des principaux moteurs de recherche. Les données associées sont fournies via l'attribut {{HTMLAttrXRef("class")}} et peuvent donc être ajoutées à n'importe quel élément HTML.

+
    +
  • Pour créer un objet microformats, les noms de classe h-* sont utilisés dans l'attribut class.
    • +
  • Pour ajouter une propriété à un objet, les noms de classe p-*, u-*, dt-*, e-* sont utilisés sur un des descendants de l'objet.
    • +
-

Les valeurs fournies sont censées être interprétables par des machines et lisibles par les humains.

Il existe différentes bibliothèques d'analyse pour la plupart des langages de programmation qui permettent d'analyser les données microformats2.

-

Le fonctionnement des microformat

+

Comment fonctionnent les microformats

Un auteur d'une page web peut ajouter des microformats via le contenu HTML. Ainsi, si un auteur veut s'identifier via un élément, il peut utiliser une classe h-card :

-
-
<a class="h-card" href="http://example.com">Joe Bloggs</a>
+

Exemple HTML

+ +
<a class="h-card" href="http://alice.example.com">Alice Blogger</a>
+ +

Lorsqu'un parseur de microformat détectera cette donnée, il saura que cette page contient une « carte » qui décrit une personne ou une organisation nommée Alice Blogger et dont l'URL est http://alice.example.com/. Le parseur rend ensuite cette donnée accessible via des API qui pourront être utilisées par des applications.

-

Lorsqu'un parseur de microformat détectera cette donnée, il saura que cette page contient une « carte » qui décrit une personne ou une organisation nommée Joe Blogger et donc l'URL est http://example.com/. Le parseur rend ensuite cette donnée accessible via des API qui pourront être utilisées par des applications.

+

Comme dans cet exemple, certains modèles de balisage ne nécessitent qu'un seul nom de classe racine de microformat, que les analyseurs syntaxiques utilisent pour trouver quelques propriétés génériques telles que name, url et photo.

-

Préfixes et microformats

+

Préfixes et microformats

Tous les microformats se composent d'une racine et d'un ensemble de propriétés. Les propriétés sont optionnelles et peuvent avoir plusieurs valeurs (si une application a besoin d'une seule valeur, elle pourra utiliser la première valeur d'une propriété). Les données hiérarchisées sont représentées avec des microformats imbriqués.

@@ -45,23 +55,23 @@ translation_of: Web/HTML/microformats
  • "p-*" pour les propriétés textuelles (ex. "p-name", "p-summary")
      -
    • Un contenu texte. Pour certains éléments HTML, certains attributs spécifiques seront utilisés (ex. {{HTMLAttrxref("alt","img")}} pour {{HTMLElement("img")}},  {{HTMLAttrxref("title","abbr")}} pour {{HTMLElement("abbr")}}).
      • +
    • Un contenu texte. Pour certains éléments HTML, certains attributs spécifiques seront utilisés (ex. alt pour <img>, title pour <abbr>).
  • "u-*" pour les propriétés qui sont des URL (ex. "u-url", "u-photo", "u-logo")
      -
    • Une analyse spécifique est nécessaire et ce sont les attributs plutôt que le contenu de l'élément qui seront utilisés (ex. {{HTMLAttrxref("src","img")}} pour {{HTMLElement("img")}}, {{HTMLAttrxref("href","a")}} pour {{HTMLElement("a")}}, {{HTMLAttrxref("object","data")}} pour {{HTMLElement("data")}}, etc.).
      • +
    • Analyse spéciale : attributs d'éléments <a>/href, <img>/src, <object>/data etc. attributs sur le contenu des éléments.
  • "dt-*" pour les propriétés temporelles (date/heure) (ex. "dt-start", "dt-end", "dt-bday")
      -
    • Une analyse spécifique est nécessaire.
      • +
    • Analyse syntaxique spéciale : attribut datetime de l'élément <time>, value-class-pattern et analyse séparée de la valeur date-heure pour plus de lisibilité.
  • "e-*" pour les arborescences où l'intégralité de la hiérarchie de l'élément est la valeur à récupérer (ex. "e-content"). Le préfixe "e-" peut être retenu en anglais comme "element tree", "embedded markup" ou "encapsulated markup".
    • -

    Exemples de microformats

    +

    Exemples de microformats

    h-card

    @@ -69,6 +79,8 @@ translation_of: Web/HTML/microformats

    La valeur de chaque propriété est définie en HTML via l'attribut class.

    +

    Exemple de h-card

    + 
    <p class="h-card">
   <img class="u-photo" src="http://example.org/photo.png" alt="" />
@@ -81,49 +93,48 @@ translation_of: Web/HTML/microformats
    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    PropriétéDescription
    p-nameLe nom complet et formaté de la personne ou de l'organisation.
    u-emailL'adresse électronique.
    u-photoUne photo pour la personne ou l'organisation.
    u-urlLa page d'accueil ou une URL représentant la personne ou l'organisation.
    u-uidUn identifiant universel unique (de préférence une URL canonique).
    p-street-addressL'adresse composée du numéro et du nom de la rue.
    p-localityLa ville ou le village de résidence.
    p-country-nameLe nom du pays de résidence.
    PropriétéDescription
    p-nameLe nom complet et formaté de la personne ou de l'organisation.
    u-emailL'adresse électronique.
    u-photoUne photo pour la personne ou l'organisation.
    u-urlLa page d'accueil ou une URL représentant la personne ou l'organisation.
    u-uidUn identifiant universel unique (de préférence une URL canonique).
    p-street-addressL'adresse composée du numéro et du nom de la rue.
    p-localityLa ville ou le village de résidence.
    p-country-nameLe nom du pays de résidence.
    -

    Exemple imbriqué

    +

    Exemple de h-card imbriqué

    -
    <div class="h-card">
   <a class="p-name u-url"
    href="http://blog.lizardwrangler.com/"
@@ -132,11 +143,9 @@ translation_of: Web/HTML/microformats
     href="http://mozilla.org/"
    >Mozilla Foundation</a>)
 </div>
    -

    Cela fournira le JSON suivant :

    -
    {
   "items": [{
   "type": ["h-card"],
@@ -154,17 +163,15 @@ translation_of: Web/HTML/microformats
   }
   }]
 }
    -
    -
    -

    Note : Le h-card imbriqué récupère des valeurs implicites pour name et url.

    +
    +

    Note : Le h-card imbriqué récupère des valeurs implicites pour name et url.

    h-entry

    Le microformat h-entry représente un contenu épisodique ou daté présent sur le Web. Il est généralement utilisé pour du contenu qui est présenté dans un flux (ex. les billets de blog).

    -
    <article class="h-entry">
   <h1 class="p-name">Microformats are amazing</h1>
   <p>Published by <a class="p-author h-card" href="http://example.com">W. Developer</a>
@@ -177,41 +184,40 @@ translation_of: Web/HTML/microformats
   </div>
 </article>
    -

    Propriétés

    -
    +

    Propriétés

    - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + +
    PropriétéDescription
    p-nameNom ou titre pour l'entrée.
    p-authorL'auteur de l'entrée (éventuellement imbriquée avec une h-card).
    dt-publishedLa date de publication de l'entrée.
    p-summaryUn résumé de l'entrée.
    e-contentLe contenu complet de l'entrée.
    PropriétéDescription
    p-nameNom ou titre pour l'entrée.
    p-authorL'auteur de l'entrée (éventuellement imbriquée avec une h-card).
    dt-publishedLa date de publication de l'entrée.
    p-summaryUn résumé de l'entrée.
    e-contentLe contenu complet de l'entrée.
    -

    Exemple de microformat h-entry analysé

    +

    Exemple de microformat h-entry analysé

    -
    <div class="h-entry">
+
    <div class="h-entry">
   <p><span class="p-author h-card">
     <a href="https://quickthoughts.jgregorymcverry.com/profile/jgmac1106" ><img class="u-photo" src="https://quickthoughts.jgregorymcverry.com/file/2d6c9cfed7ac8e849f492b5bc7e6a630/thumb.jpg"/></a>
     <a class="p-name u-url" href="https://quickthoughts.jgregorymcverry.com/profile/jgmac1106">Greg McVerry</a></span>
@@ -224,7 +230,6 @@ translation_of: Web/HTML/microformats
    datetime="2019-05-31T14:19:09+0000">31 May 2019</time></a></p>
 </div>
    
 
-
    
 
    {
   "items": [
     {
@@ -255,8 +260,9 @@ translation_of: Web/HTML/microformats
         ]
       },
       "lang": "en"
-    }
    
-
    
+    }
+  ]
+}

    h-feed

    @@ -278,26 +284,26 @@ translation_of: Web/HTML/microformats </div>
    -

    Propriétés

    +

    Propriétés

    - - - - - - - - - - - - - - + + + + + + + + + + + + + +
    PropriétéDescription
    p-nameNom du flux.
    p-authorAuteur du flux, éventuellement intégré via une h-card.
    PropriétéDescription
    p-nameNom du flux.
    p-authorAuteur du flux, éventuellement intégré via une h-card.
    -

    Éléments fils

    +

    Enfants

    @@ -325,7 +331,7 @@ translation_of: Web/HTML/microformats </div> -

    Propriétés

    +

    Propriétés

    @@ -356,9 +362,8 @@ translation_of: Web/HTML/microformats
    -

    Exemple d'analyse

    +

    Exemple d'analyse

    -
    <div class="h-event">
   <h2 class="p-name">IndieWeb Summit</h2>
   <time class="dt-start" datetime="2019-06-29T09:00:00-07:00">June 29, 2019 at 9:00am  (-0700)</time><br>through <time class="dt-end" datetime="2019-06-30T18:00:00-07:00">June 30, 2019 at 6:00pm (-0700)</time><br>
@@ -382,9 +387,6 @@ translation_of: Web/HTML/microformats
     </div>
 </div>
    - - -
    {
   "items": [
     {
@@ -432,15 +434,19 @@ translation_of: Web/HTML/microformats
       },
       "lang": "en"
     }
-  ],
    -
    -
    + ] +} + +

    Compatibilité des navigateurs

    + +

    Pris en charge dans tous les navigateurs prenant en charge l'attribut class et son API DOM.

    -

    Voir aussi

    +

    Voir aussi

    -- cgit v1.2.3-54-g00ecf