Utilisation de l'en-tête pour le web sémantique et les extraits enrichis#

Lors de la rédaction d'un contenu sur Geotribu, que ce soit une revue de presse, un article, un guide de contribution ou autre, on insiste beaucoup sur l'en-tête du fichier, comme l'illustre ce guide.

Pourquoi ? car c'est ainsi que le site génère des données structurées standardisées qui sont notamment utilisées pour les extraits enrichis des moteurs de recherche.

Web sémantique et données structurées#

La structuration des données géographiques, ça vous semble important ? Eh bien, c'est la même chose quand il s'agit des pages webs. C'est d'ailleurs le principe fondateur de ce qu'on appelle plus communément le web sémantique : intégrer des données structurées dans le contenu des pages de façon à faciliter le travail d'indexation et de mise en relation des contenus.
Evidemment les structures répondent à des standards dont l'élaboration est liée aux acteurs de l'industrie mais aussi aux initiatives communautaires. Les schémas de données, qui gèrent le relationnel, sont documentés et regoups sur le site : schema.org. C'est ce site et cette dynamique qui ont inspiré schema.data.gouv.fr.

Ces données sont également utilisées par les moteurs de recherche et favorisent le référencement ou plutôt permettent un affichage enrichi dans les pages de résultats, d'où le nom donné par Google : extrait enrichi (rich snippet en anglais).

Il existe de nombreux schémas décrivant différents types d'objets : Article, WebSite, Author, Organization, etc. Les personnes qui travaillent sur les portails de données ouvertes connaissent bien le sujet puisqu'il existe un schéma standardisé pour les jeux de données qui permet notamment de faire indexer ses données dans le moteur dédié de Google : Dataset Search.

Processus#

Au moment de la transformation des fichiers markdown en fichiers HTML, le site génère un objet au format JSON-LD (JSON Linked Data), intégré à la page HTML, à partir de plusieurs éléments :

l'en-tête fournit l'essentiel des informations : date, auteur(s), mots-clés, description, image, etc.
l'URL : permet d'affiner le type de contenu, notamment pour distinguer un article d'une revue de presse.
le fichier de l'auteur s'il respecte le nommage team/{pnnn}.md

Les informations sont manipulées avec la syntaxe Jinja, utilisée par Mkdocs, dans le template main.html.

Exemple du bloc permettant de gérer les contenus avec plusieurs auteurs :

[...]
{% elif author is iterable and (author is not string and author is not mapping) %}
  {% if author | length > 1 %}
    {# plusieurs auteurs #}
    "author": [
    {% for a in author %}
        {% if a != config.site_author %}
          {% set author_split = a.split(' ', 1) %}
          {
          "@type": "Person",
          "name": "{{ a }}",
          "url": "{{ config.extra.geotribu_main_site }}team/{{ author_split[0][:1] | lower }}{{ author_split[1][:3] | lower }}"
          {% if a != author|last %}
          {# Si l'auteur n'est pas le dernier de la liste, on ajoute une virgule #}
            },
          {% else %}
          {# Si c'est le dernier, pas de virgule #}
            }
          {% endif %}
        {% endif %}
    {% endfor %}
    ],
[...]

Exemples de données structurées générées sur Geotribu#

Les données structurées sont stockées en JSON-LD (JSON Linked Data) sous forme de script intégré dans l'en-tête du fichier HTML (balise head). Pour y accéder, il suffit d'ouvrir le fichier source (Ctrl+U sur le navigateur) ou d'utiliser un validateur ou visualiseur dédié (il y en a plein sur le net).

Page d'accueil#

On y intègre les métadonnées principales du site, ainsi que des informations fonctionnelles, notamment le moteur de recherche, conformément au schéma Sitelink :

{
  "@context": "http://www.schema.org",
  "@type": "WebSite",
  "name": "Geotribu",
  "alternateName": "Géotribu",
  "url": "https://geotribu.fr/",
  "sameAs": [
    "http://geotribu.fr",
    "http://geotribu.net",
    "https://github.com/geotribu/",
    "https://facebook.com/geotribu",
    "https://twitter.com/geotribu"
  ],
  "potentialAction": {
    "@type": "SearchAction",
    "target": "https://geotribu.fr/?q={search_term}",
    "query-input": "required name=search_term"
  }
}

Article#

Exemple pour cet article :

{
  "@context": "https://schema.org",
  "@type": "Article",
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://contribuer.geotribu.fr/articles/2021/2021-02-15_ignfr2map_carte_liens_IGN_open-data_7_etapes/"
  },
  "headline": "Geotribu - ign2map : Du site à la carte en 7 étapes",
  "abstract": "ign2map : le petit projet de Geotribu pour rendre l’expérience de téléchargement des données ouvertes de l'IGN plus interactive.",
  "datePublished": "2021-02-15 11:11",
  "image": "https://cdn.geotribu.fr/img/articles-blog-rdp/articles/ign_opendata_map/ign_opendata_map_html_rendu.png","author": [
    {
      "@type": "Person",
      "name": "Florian Boret",
      "url": "https://contribuer.geotribu.fr/team/fbor"
    },
    {
      "@type": "Person",
      "name": "Julien Moura",
      "url": "https://contribuer.geotribu.fr/team/jmou"
    }
  ],
  "publisher": {
    "@type": "Organization",
    "name": "Geotribu",
    "logo": {
      "@type": "ImageObject",
      "url": "https://cdn.geotribu.fr/img/internal/charte/geotribu_logo_64x64.png"
    }
  }
}

Revue de presse#

Exemple pour cette GeoRDP :

{
  "@context": "https://schema.org",
  "@type": "Article",
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://geotribu.fr/rdp/2022/rdp_2022-06-03/"
  },
  "headline": "Contribuer à Geotribu - Revue de presse du 3 juin 2022",
  "abstract": "Cette semaine on vous propose une déambulation autour de divers sujets : traduction de logiciels libres, une carte de bruit, le programme Lidar HD, la donnée OSO, la détection de bâtiments et les logiciels libres en thèse",
  "datePublished": "2022-06-03",
  "image": "https://cdn.geotribu.fr/img/articles-blog-rdp/capture-ecran/carte_bruit_Paris.jpg",
  "author": {
    "@type": "Organization",
    "name": "Geotribu",
    "url": "https://geotribu.fr/"
    },
  "publisher": {
    "@type": "Organization",
    "name": "Geotribu",
    "logo": {
      "@type": "ImageObject",
      "url": "https://cdn.geotribu.fr/img/internal/charte/geotribu_logo_64x64.png"
    }
  }
}

Ressources#

le schéma d'un article sur schema.org
le validateur de schéma
description de l'extrait enrichi de type Article dans la documentation de Google
Google propose un site pour tester les extraits enrichis.

étape où un contributeur propose d'intégrer ses modifications dans le socle principal du projet. Voir la documentation de GitHub. ↩