Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- de:shibidp:config-i18n [2024/07/23 13:48] – [Installation der deutschsprachigen System-Meldungen] Doreen Liebenau
+++ de:shibidp:config-i18n [2026/08/04 11:15] (aktuell) – Aktualisierung Internationalisierung, defaults Doreen Liebenau
@@ Zeile 6: / Zeile 6: @@
 </callout>
-===== Installation der deutschsprachigen System-Meldungen =====
+In früheren IdP-Versionen waren alle Texte in den ''./messages/messages.properties''-Dateien im ''conf/''-Verzeichnis zu finden. Bei einer aktuellen IdP-Neuinstallation werden Sie im ''./messages''- Verzeichnis lediglich eine leere ''messages.properties''- Datei vorfinden.
+===== Das Override-Prinzip =====
-Laden Sie aus dem [[https://wiki.shibboleth.net/confluence/display/IDP4/MessagesTranslation|Shibboleth-Wiki]] die zur jeweiligen IdP-Version passende Datei für die deutsche Übersetzung der IdP-Seiten herunter. Legen Sie sie nach ''./messages/messages_de.properties'':
+Die [[https://codeberg.org/Shibboleth/java-identity-provider/src/branch/main/idp-conf-impl/src/main/resources/net/shibboleth/idp/messages|Defaults]] sind auf den ersten Blick im [[https://shibboleth.atlassian.net/wiki/spaces/IDP5/pages/3199501666/Configuration#Installation-Layout|Datei-Baum]] nicht sichtbar. Alle Standardtexte (Englisch, sowie vorhandene Übersetzungen) sind fest in den Programmbibliotheken des IdP einkompiliert.
+Die Dateien im ''conf''-Verzeichnis sind für Overrides vorgesehen. Die Datei ''messages.properties'' (Standard/Englisch) enthält initial keine Einträge. Sie dient als Überschreibungs-Datei. Erweiterungen für weitere Sprachen müssen bei Bedarf angelegt werden (z.B. ''messages_de.properties'').
-<code bash>
+Für Textanpassungen genügt also ein Eintrag in der Datei ''messages.properties'', bzw. ''messages_de.properties''. Ggf. muss die Datei messages_de.properties erstmalig angelegt werden.
-root@idp:~# curl -o /opt/shibboleth-idp/messages/messages_de.properties 'https://git.shibboleth.net/view/?p=java-idp-translations.git;a=blob_plain;f=java-identity-provider/5/messages/messages_de.properties;hb=HEAD'
-</code>
+===== Wie wird die Sprachauswahl getroffen? =====
-Ab jetzt sollten die IdP-Seiten auch auf Deutsch angezeigt werden.
+Die Sprachauswahl passiert dynamisch bei jedem einzelnen Login-Vorgang und wird vom Webrowser der Nutzenden gesteuert.
+Über den „Accept-Language“-Header des Browsers kann eine sprachspezifische Message-Datei bevorzugt werden, die anstelle der Standarddatei verwendet wird. Beispielsweise würde für die deutsche Sprachumgebung eine Datei namens ''messages_de.properties'' verwendet werden. Soweit bekannt ist, beschränkt Spring dies auf eine einzige Sprachumgebung, die entweder eine Übereinstimmung aufweist oder auf die Standardeinstellung zurückgreift, was keine präferenzbasierte Auswahl zulässt.
-===== System-Meldungen anpassen =====
-Die einzelnen Meldungen auf den Seiten sollten jetzt noch in Englisch und Deutsch angepasst werden.
+{{tag>idp5 tutorial i18n internationalisierung not-included-in-ansible}}
-==== Englisch ====
-Laden Sie unsere {{:de:messages.properties|englische Beispiel-Datei}} herunter und legen Sie diese nach ''/opt/shibboleth-idp/messages/messages.properties''. Hier werden lediglich einige der systeminternen Standardstrings für Ihre Hochschule gesetzt. Öffnen Sie die Datei in einem Editor und
-  * ersetzen Sie die Platzhalter "University XY" und "20XY" durch die korrekten Werte.
-  * passen Sie die Nutzungsbedingungen in Absprache mit Ihrer Rechtsabteilung und/oder Datenschützer*innen an.
-Hinweis: wundern Sie sich nicht, dass der deutsche Beispieltext für die Nutzungsbedingungen in der englischen Datei auftauchen. Wir haben im Moment keine englische Version und durch das Platzieren des deutschen Textes in diese Datei wird der deutsche Text jedem Webbrowser angezeigt, egal welche Sprache dieser haben möchte. Sofern Sie eine englische Version der Bedingungen haben, ersetzen Sie den deutschen Text einfach!
-=== Deutsch ===
-Passen Sie einige Felder in der ''/opt/shibboleth-idp/messages/messages_de.properties'' für Ihre Einrichtung an, z.B.:<code properties>
-root.title		= Login Dienst für Mitglieder der Hochschule XY
-idp.title		= Login Dienst für Mitglieder der Hochschule XY
-idp.logo		= /images/logo.png
-idp.logo.alt-text	= Logo der Hochschule XY
-idp.logo.target.url	= https://www.hochschule-XY.de/
-idp.url.password.reset	= https://www.hochschule-XY.de/passwortwiederherstellung/
-idp.url.helpdesk	= https://www.hochschule-XY.de/de/hilfe/
-idp.url.imprint		= https://www.hochschule-XY.de/de/impressum/
-idp.url.copyyear	= 20XY
-root.footer		= <strong>&copy; Hochschule XY 20XY \| <a style="color: #ffffff" title="Imprint" href="https://www.hochschule-XY.de/impressum/" target="_blank">Impressum</a> \| <a style="color: #ffffff" title="Nutzungsbedingungen" href="/idp/tou.jsp" target="_blank">Nutzungsbedingungen</a></strong> \| <a style="color: #ffffff" title="Datenschutzerklärung" href="https://www.hochschule-XY.de/dse/" target="_blank">Datenschutzerklärung</a></strong>
-idp.footer		= <strong>&copy; Hochschule XY 20XY \| <a style="color: #ffffff" title="Imprint" href="https://www.hochschule-XY.de/impressum/" target="_blank">Impressum</a> \| <a style="color: #ffffff" title="Nutzungsbedingungen" href="/idp/tou.jsp" target="_blank">Nutzungsbedingungen</a></strong> \| <a style="color: #ffffff" title="Datenschutzerklärung" href="https://www.hochschule-XY.de/dse/" target="_blank">Datenschutzerklärung</a></strong>
-my-terms		= my-tou
-my-tou.title		= Nutzungsbedingungen
-</code>
-Hinweis: wundern Sie sich nicht dass hier keine Nutzungsbedingungen enthalten sind. Sollten Sie in der englischen Datei eigene Nutzungsbedingungen auf englisch eingetragen haben, müssen Sie jetzt noch Ihre Bedingungen auf Deutsch hier eintragen.
-Testen Sie nochmal einen Login mithilfe der DFN-Test-SP(s) und überzeugen Sie sich dass die Layout-Anpassungen wirksam geworden sind.
-{{tag>idp4 tutorial i18n internationalisierung not-included-in-ansible}}

idp5 tutorial i18n internationalisierung not-included-in-ansible