Deutsch
Über dieses Handbuch

Dieses Handbuch gehört zum Quartz-Plugin quartz-multilanguage. Und es ist mit ihm gebaut: Der Umschalter oben rechts kommt von dort.

Auch diese Box steht zweimal in der Konfiguration — einmal je Sprache.

7.1 – Die zwei Hinweise

options:
  missingTranslationNotice: true
  availableTranslationNotice: true
OptionWann der Satz erscheintWas er sagt
missingTranslationNoticeDer Besucher spricht eine Sprache, in der es diese Seite nicht gibt„Diese Seite ist nur auf Englisch verfügbar.“
availableTranslationNoticeEs gibt sie auch in seiner Sprache„Diese Seite gibt es auch auf Deutsch.“ — mit Link

Der zweite ist der wichtigere: Er fängt den Besucher ab, der über eine Suchmaschine auf der falschen Sprache gelandet ist. Diese Website hat ihn eingeschaltet; auf einer englischen Seite mit deutschem Browser steht er über dem Text.

Warum das erst im Browser entschieden wird

Welche Sprache jemand bevorzugt, weiß nur sein Browser. Beim Bauen ist das nicht bekannt, und eine Seite kann nicht in zwei Fassungen zugleich ausgeliefert werden.

Das Plugin setzt deshalb oben auf jeder Seite ein leeres, verstecktes Callout ein. Das Skript vergleicht die Sprache der Seite mit der bevorzugten Sprache des Besuchers — gemerkte Wahl, sonst Browsersprache — und füllt den passenden Text ein. Passt nichts, bleibt der Kasten leer und unsichtbar.

Der Text steht in der Sprache des Besuchers

Wer Deutsch spricht und auf einer englischen Seite landet, liest „Diese Seite gibt es auch auf Deutsch“ — auf Deutsch. Das ist der Sinn: Der Satz richtet sich an jemanden, der die Sprache der Seite womöglich nicht liest.

Die Texte bringt das Plugin für en-US, de-DE, fr-FR und es-ES mit; andere Sprachen fallen auf Englisch zurück.

Warum sie nicht im Suchindex landen

Weil der Kasten beim Bauen leer ist. Der Text entsteht erst im Browser und gelangt deshalb weder in die Seitenbeschreibung noch in den Suchindex. Beide blieben sonst mit einem Satz verschmutzt, der gar nicht zum Inhalt gehört.

Aussehen

Der Kasten trägt die Klasse callout und übernimmt damit das Aussehen der Obsidian-Callouts, wenn das entsprechende Plugin aktiv ist. Ohne es ist er ein schlichter Kasten, den man über .multilanguage-notice gestalten kann.