BesluitBron 1.4.4-23 Status Anmelden

Dokumentation

Zuletzt geändert am .

Die aktuelle Dokumentation mit einem Inhaltsverzeichnis auf der linken Seite, den Kapiteln der Seite auf der rechten Seite und einem Suchfeld, das bereits während der Eingabe Vorschläge anzeigt. Unter dem Titel steht, wann der Text zuletzt geändert wurde, in der Sprache der Seite: „Last changed on 17 August 2026“ auf einer englischen Seite zum Beispiel. Dieses Datum stammt aus dem Versionsverlauf der Dokumentation. Das gleiche Datum steht in sitemap.xml, damit eine Suchmaschine erkennt, welche Seite neu ist. Ab Version 1.3.21, die Sprache der Datumszeile ab 1.3.69.

Die Adresse spiegelt die Sprache wider. Die Dokumentation ist unter /nl/documentatie, /de/dokumentation, /en/documentation und /fr/documentation zu finden, und das Suchfeld hat unter jeder dieser Adressen eine eigene Adresse: zoeken, suche, search und recherche. Bis einschließlich Version 1.3.50 war die Dokumentation unter einer einzigen Adresse ohne Sprachangabe zu finden: /documentatie. Diese Adresse funktioniert weiterhin und leitet zur niederländischen Version weiter, sodass auch ein alter Link oder Lesezeichen noch funktioniert.

Die Weiterleitung erfolgt immer auf Niederländisch und nicht in die Sprache des Besuchers. Dies weicht vom Rest der Website ab, wo eine Adresse ohne Sprachangabe sehr wohl die Sprache des Besuchers auswählt. Der Grund dafür ist, dass jede Seite der Dokumentation pro Sprache unter sitemap.xml zu finden ist. Ein Besucher gelangt also über ein Suchergebnis direkt in seine eigene Sprache und stößt nur dann auf die alte Adresse, wenn er einem alten Link folgt.

Der Text wurde ins Englische, Deutsche und Französische übersetzt. Wer /de/dokumentation aufruft, sieht den Text auf Deutsch. Dies gilt ab Version 1.3.51. Bis einschließlich Version 1.3.50 war der Text in jeder Sprache auf Niederländisch, und die Adresse enthielt lediglich den Sprachcode.

Die Übersetzung wurde maschinell erstellt und nicht von einem Menschen überprüft. Dies wird oben auf jeder übersetzten Seite in der Sprache der Seite selbst angegeben, zusammen mit dem Hinweis, dass die niederländische Version als maßgebend gilt. Wer Zweifel an der Richtigkeit eines übersetzten Satzes hat, sollte die niederländische Seite daneben lesen.

Die beiden Hinweise erscheinen nur, wenn die Seite wirklich vollständig übersetzt ist. Eine niederländische Seite enthält sie nicht, da es sich dabei um den Originaltext handelt. Eine Seite, deren Übersetzung noch nicht vollständig ist, enthält sie ebenfalls nicht: Andernfalls würde dort behauptet werden, dass alles übersetzt sei, obwohl sie noch niederländische Passagen enthält.

Die Übersetzung erfolgt nicht, während jemand wartet. Kurz nach dem Start des Dienstes wird jede Seite übersetzt und gespeichert. Ein Leser erhält anschließend die gespeicherte Übersetzung oder den niederländischen Text, falls für diesen Abschnitt noch keine Übersetzung vorliegt. Es wird also beim Öffnen einer Seite niemals ein Übersetzungsdienst aufgerufen.

Eine neue Installation beginnt nicht bei Null. Sie enthält eine zuvor erstellte Übersetzung des damaligen Textes und lädt diese, sobald das Datenmodell bereitsteht, auch ohne eigenen DeepL-Schlüssel. So zeigt auch eine solche Installation bereits teilweise übersetzte Seiten an, und zwar für den Teil des Textes, der seitdem nicht geändert wurde. Ein Textabschnitt, der danach angepasst wurde, bleibt auf Niederländisch, bis ein eigener DeepL-Schlüssel ihn übernimmt. Ab Version 1.3.69.

Die Beschriftungen in den Diagrammen werden ebenfalls übersetzt. Die Form eines Diagramms bleibt unverändert: Die Pfeile, die Blöcke und die Bezeichnungen von Komponenten wie „McpConnectorSurface“ oder eines Werkzeugs wie „search_documents“ ändern sich nicht, da der Leser diese Begriffe selbst eingeben kann. Nur die darin enthaltenen Wörter werden übersetzt. Ab Version 1.3.51.

Die Titel im Breadcrumb-Pfad oben und im Inhaltsverzeichnis links folgen ab Version 1.3.69 derselben Übersetzung wie der Text: Ein Titel, der bereits durch die Abgleichfunktion übersetzt wurde, erscheint in der jeweiligen Sprache; ein Titel, bei dem dies noch nicht geschehen ist, bleibt bis zum nächsten Start, bei dem der Abgleich durchgeführt wird, auf Niederländisch. Bis einschließlich Version 1.3.68 waren beide immer auf Niederländisch, auch auf einer übersetzten Seite.

Was unabhängig von dieser Übersetzung weiterhin auf Niederländisch bleibt: die Überschriften „Übersicht“ und „Inhaltsverzeichnis“ über dem Inhaltsverzeichnis selbst, das Suchfeld, die Fußzeile ganz unten, der sichtbare Text hinter einem einfachen Wiki-Link im Fließtext und die Wörter in der Adresse selbst. Die Fußzeile verweist ebenfalls auf die niederländische Datenschutzerklärung, auch auf einer Seite in einer anderen Sprache.

Die Screenshots sind nach Sprachen sortiert und zeigen den Bildschirm in der jeweiligen Sprache. Sie wurden auf einer Installation aufgenommen, auf der die Übersetzungsfunktion aktiviert ist, sodass auch die Dokumentationsseite auf dem Screenshot übersetzt ist. Bis einschließlich Version 1.3.72 wurde in jeder Sprache ein niederländischer Bildschirm angezeigt. Ab Version 1.3.73.

Beim Wechseln der Sprache bleibt der Leser auf derselben Seite, auch auf der Suchseite. Bis einschließlich Version 1.3.50 gelangte jeder, der innerhalb der Dokumentation die Sprache wechselte, auf die Startseite der Website und verlor somit die Seite, die er gerade gelesen hatte.

Die Menüleiste oben richtet sich nach der Sprache der Seite. Die darin enthaltenen Links führen zu derselben Sprache, und die Sprachauswahl zeigt die Sprache an, in der die Seite vorliegt. Bis einschließlich Version 1.3.53 enthielt sie niederländische Links, auch auf einer deutschen Seite, und die Sprachauswahl gab dort Niederländisch als ausgewählte Sprache an. Die Begriffe in der Leiste waren damals jedoch bereits übersetzt. Ab Version 1.3.54.

Auf einem Bildschirm, der schmaler als 900 Pixel ist, werden diese Abschnitte untereinander in einer anderen Reihenfolge angezeigt: zuerst das Suchfeld, dann der Text selbst und erst ganz unten das Inhaltsverzeichnis. So beginnt der Text oben auf dem Bildschirm. Bis zur Version 1.3.34 befand sich das Inhaltsverzeichnis noch darüber und füllte den ersten Bildschirm eines Smartphones aus. Eine Tabelle, die zu breit für den Bildschirm ist, wird innerhalb ihres eigenen Rahmens seitlich verschoben; der umgebende Text bleibt an seiner Stelle stehen. Ab Version 1.3.35.