BesluitBron 1.4.4-23 État Se connecter

Documentation

Dernière modification le .

La documentation telle qu'elle apparaît actuellement, avec une table des matières à gauche, les chapitres de la page à droite et un champ de recherche qui affiche des suggestions au fur et à mesure de la saisie. Sous le titre figure la date de la dernière modification du texte, dans la langue de la page : « Last changed on 17 August 2026 » sur une page en anglais, par exemple. Cette date provient de l'historique des versions de la documentation. La même date figure dans sitemap.xml, afin qu'un moteur de recherche sache quelle page est récente. À partir de la version 1.3.21 ; la langue de la ligne de date est définie à partir de la version 1.3.69.

L'adresse reflète la langue. La documentation est disponible sur /nl/documentatie, /de/dokumentation, /en/documentation et /fr/documentation, et le champ de recherche dispose d’une adresse distincte pour chacun de ces sites : zoeken, suche, search et recherche. Jusqu’à la version 1.3.50 incluse, la documentation était accessible via une seule adresse sans indication de langue, /documentatie. Cette adresse reste fonctionnelle et redirige vers la version néerlandaise ; un ancien lien ou signet fonctionnera donc toujours.

Cette redirection s'effectue toujours vers le néerlandais et non vers la langue du visiteur. Cela diffère du reste du site, où une adresse sans indication de langue sélectionne bel et bien la langue du visiteur. La raison en est que chaque page de la documentation est disponible dans chaque langue à l'adresse sitemap.xml ; ainsi, un visiteur accède directement à la page dans sa propre langue à partir d'un résultat de recherche et ne rencontre l'ancienne adresse qu'en suivant un ancien lien.

Le texte a été traduit en anglais, en allemand et en français. Lorsque l'on accède à /de/dokumentation, le texte s'affiche en allemand. À partir de la version 1.3.51. Jusqu'à la version 1.3.50 incluse, le texte était en néerlandais dans toutes les langues, et l'adresse ne comportait que le code de langue.

La traduction a été effectuée par un logiciel et n'a pas été relue par un humain. Cette mention figure en haut de chaque page traduite, dans la langue de la page elle-même, accompagnée d'une note indiquant que la version néerlandaise fait foi. En cas de doute sur l'exactitude d'une phrase traduite, il suffit de consulter la page néerlandaise qui se trouve à côté.

Ces deux mentions n'apparaissent que lorsque la page est entièrement traduite. Une page en néerlandais ne les comporte pas, car il s'agit du texte original. Une page dont la traduction n'est pas encore terminée ne les comporte pas non plus : sinon, cela reviendrait à affirmer que tout est traduit alors qu'elle contient encore des passages en néerlandais.

La traduction ne s'effectue pas pendant que l'utilisateur attend. Peu après le démarrage du service, chaque page est traduite et enregistrée. Le lecteur reçoit ensuite la traduction enregistrée, ou le texte en néerlandais s'il n'existe pas encore de traduction pour ce passage. Le service de traduction n'est donc jamais sollicité lors de l'ouverture d'une page.

Une nouvelle installation ne part pas de zéro. Elle contient une traduction réalisée précédemment à partir du texte de l'époque et la charge dès que le modèle de données est prêt, même sans clé DeepL propre. Ainsi, une telle installation affiche déjà des pages partiellement traduites, pour la partie du texte qui n’a pas été modifiée depuis lors. Une partie du texte qui a été modifiée par la suite reste en néerlandais jusqu’à ce qu’une clé DeepL personnelle la remplace. À partir de la version 1.3.69.

Les libellés des diagrammes sont également traduits. La forme du diagramme reste inchangée : les flèches, les blocs et les noms d'éléments tels que « McpConnectorSurface » ou d'outils tels que « search_documents » ne changent pas, car ce sont des éléments que le lecteur peut retaper lui-même. Seuls les mots qu'ils contiennent sont traduits. À partir de la version 1.3.51.

À partir de la version 1.3.69, les titres figurant dans le fil d'Ariane en haut de la page et dans la table des matières à gauche reprennent la même traduction que le texte : un titre dont la réconciliation a déjà été effectuée s'affiche dans la langue correspondante, tandis qu'un titre pour lequel cela n'a pas encore été fait reste en néerlandais jusqu'au prochain démarrage qui effectuera la mise à jour. Jusqu'à la version 1.3.68 incluse, les deux s'affichaient toujours en néerlandais, même sur une page traduite.

Ce qui reste toujours en néerlandais, quelle que soit cette traduction : les titres « Aperçu » et « Table des matières » au-dessus de la table des matières elle-même, le champ de recherche, le pied de page en bas, le texte visible derrière un lien wiki nu dans le corps du texte et les mots contenus dans l'adresse elle-même. Le pied de page renvoie également à la déclaration de confidentialité néerlandaise, même sur une page rédigée dans une autre langue.

Les captures d'écran sont spécifiques à chaque langue et affichent l'écran dans cette langue. Elles ont été réalisées sur une installation où la traduction est activée ; la page de documentation visible sur l'image est donc également traduite. Jusqu'à la version 1.3.72 incluse, elles affichaient un écran en néerlandais dans toutes les langues. À partir de la version 1.3.73.

Lorsqu'on change de langue, le lecteur reste sur la même page, y compris sur la page de recherche. Jusqu'à la version 1.3.50, lorsqu'un utilisateur changeait de langue au sein de la documentation, il était redirigé vers la page d'accueil du site et perdait ainsi la page qu'il était en train de consulter.

La barre de menu en haut de la page s'adapte à la langue de la page. Les liens qu'elle contient renvoient vers cette même langue, et le menu de sélection de la langue indique la langue dans laquelle la page est rédigée. Jusqu'à la version 1.3.53 incluse, elle contenait des liens en néerlandais, même sur une page en allemand, et le menu de sélection de la langue y indiquait le néerlandais comme langue sélectionnée. Les mots figurant dans la barre étaient toutefois déjà traduits à l'époque. À partir de la version 1.3.54.

Sur un écran de moins de 900 pixels, ces éléments s'affichent les uns sous les autres dans un ordre différent : d'abord le champ de recherche, puis le texte lui-même, et enfin la table des matières tout en bas. Le texte commence ainsi en haut de l'écran. Jusqu’à la version 1.3.34, la table des matières figurait encore au-dessus et occupait tout le premier écran d’un téléphone. Un tableau trop large pour l’écran se déplace latéralement à l’intérieur de ses propres limites ; le texte qui l’entoure reste à sa place. À partir de la version 1.3.35.