Webtrees Handbuch/Entwicklungsumgebung - Versionsgeschichte

Hartenthaler: /* Struktur auf GitHub */

2025-08-03T23:00:46Z

Struktur auf GitHub

← Nächstältere Version		Version vom 4. August 2025, 01:00 Uhr
Zeile 491:		Zeile 491:

	=== Struktur auf GitHub ===		=== Struktur auf GitHub ===
	Der Quell-Code von {{WT-Name}} liegt auf einer [https://github.com/fisharebest/webtrees Github-Site]. Dieses Repository enthält mehrere Zweige ("branches"); etwa für die jeweils letzten Stände der Versionszweige 1.4, 1.7 und 2.0. Die jeweils aktuelle Entwicklungsversion liegt im Zweig "main".		Der Quell-Code von {{WT-Name}} liegt auf einer [https://github.com/fisharebest/webtrees Github-Site]. Dieses Repository enthält mehrere Zweige ("branches"); etwa für die jeweils letzten Stände der Versionszweige 1.4, 1.7, 2.0 und 2.1. Die jeweils aktuelle Entwicklungsversion liegt im Zweig "main".

	=== Entwicklungsumgebung und -werkzeuge ===		=== Entwicklungsumgebung und -werkzeuge ===

Hartenthaler: /* webtrees-Forum */ Link korrigiert

2025-08-03T22:58:05Z

webtrees-Forum: Link korrigiert

← Nächstältere Version		Version vom 4. August 2025, 00:58 Uhr
Zeile 20:		Zeile 20:
	=== webtrees-Forum ===		=== webtrees-Forum ===
	<div style="float:right;">[[datei:WT_webtrees-Forum.png\|thumb\|350px\|webtrees Forum]]</div>		<div style="float:right;">[[datei:WT_webtrees-Forum.png\|thumb\|350px\|webtrees Forum]]</div>
	Das englischsprachige [https://www.webtrees.net/index.php/en/forum webtrees-Forum] dient dem Austausch mit anderen {{WT-Name}}-Nutzern und den Entwicklern. Dort können Sie alle Fragen stellen. Sie sollten sich also unbedingt im Forum als Nutzer anmelden. Dort werden auch aktuelle Informationen verteilt, etwa wenn neue Versionen von {{WT-Name}} erscheinen.		Das englischsprachige [https://www.webtrees.net/index.php/en/forum webtrees-Forum] dient dem Austausch mit anderen {{WT-Name}}-Nutzern und den Entwicklern. Dort können Sie alle Fragen stellen. Sie sollten sich also unbedingt im Forum als Nutzer anmelden. Dort werden auch aktuelle Informationen verteilt, etwa wenn neue Versionen von {{WT-Name}} erscheinen. Im Forum sind über 1.700 Nutzer registriert.<ref>abgerufen am 4.8.2025 auf https://www.webtrees.net/index.php/forum/index</ref>

	Das Forum ist in verschiedene Themenstränge gegliedert		Das Forum ist in verschiedene Themenstränge gegliedert
Zeile 43:		Zeile 43:
	* Verwenden Sie Forenbeiträge, Signaturen oder Avatar-Links '''nicht''' für Werbung oder für Aufforderungen zu Handlungen.		* Verwenden Sie Forenbeiträge, Signaturen oder Avatar-Links '''nicht''' für Werbung oder für Aufforderungen zu Handlungen.
	* Posten Sie nicht zu viel und fügen Sie keine überflüssigen Kommentare hinzu, die den anderen Nutzern im Forum keinen Mehrwert bringen.		* Posten Sie nicht zu viel und fügen Sie keine überflüssigen Kommentare hinzu, die den anderen Nutzern im Forum keinen Mehrwert bringen.
	* Lesen Sie bitte auch die Hilfeseite zum Forum "[https://www.webtrees.net/index.php/en/forum/help Forum Help]". Diese enthält weitere Tipps zur Verwendung des Forums und einige wichtige Informationen zum Hochladen von Dateien und Bildern als Anhänge.		* Lesen Sie bitte auch die Hilfeseite zum Forum "[https://www.webtrees.net/index.php/forum/forum-help Forum Help]". Diese enthält weitere Tipps zur Verwendung des Forums und einige wichtige Informationen zum Hochladen von Dateien und Bildern als Anhänge.

	=== Discourse ===		=== Discourse ===

Hartenthaler: /* webtrees-Forum */ Anpassung an aktuelle Gliederung des Forums

2025-08-03T22:44:02Z

webtrees-Forum: Anpassung an aktuelle Gliederung des Forums

← Nächstältere Version		Version vom 4. August 2025, 00:44 Uhr
Zeile 24:		Zeile 24:
	Das Forum ist in verschiedene Themenstränge gegliedert		Das Forum ist in verschiedene Themenstränge gegliedert
	* Help for version 2.2 - hier geht es um alle Fragen zur aktuellen Version von {{WT-Name}}		* Help for version 2.2 - hier geht es um alle Fragen zur aktuellen Version von {{WT-Name}}
	* Help for ~~version 2.1 - alle Fragen zur Vorgängerversion 2.1~~		* Help for older versions, PGV, and migration - in Unterkategorien geht es um alle Fragen zu früheren Versionen von {{WT-Name}}, zu PhpGedView (PGV) und der Migration von einer Version auf eine andere
	* Help for 2.1 migration - ~~hier wird der Umstieg von 2.0 auf 2.1 thematisiert~~		* General discussion about webtrees or genealogy - Fragen mit übergeordnetem Charakter (Strategie, Genealogie allgemein)
	* Help for version 2.0 - alle Fragen ~~zur Vorgängerversion 2.0~~		* Customising webtrees - Fragen rings um die Erweiterungsmodule
	* Beta release GitHub "Main branch" - hier werden Fragen zur nächsten Version von {{WT-Name}} ~~diskutiert~~		* Request for New Feature - Wünsche betreffend neuer Funktionen für {{WT-Name}}
	* Help for Version 1.7 - alle Fragen zur eingefrorenen Version 1.7 (und ~~frühere)~~		* Translation - Themen, die die Übersetzung in verschiedene Sprachen betreffen
	* ~~Open~~ discussion - Fragen mit übergeordnetem Charakter (Strategie, Genealogie allgemein)
	* webtrees forum questions - alle Fragen, die das Forum selbst betreffen		* webtrees forum questions - alle Fragen, die das Forum selbst betreffen
	* Customising - Fragen rings um die Erweiterungsmodule
	* Translation - Themen, die die Übersetzung in verschiedene Sprachen betreffen
	* Request for New Feature - Wünsche betreffend neuer Funktionen für {{WT-Name}}
	* Converting from PhpGedView (PGV) - Umstieg vom Vorgängerprogramm PhpGedView auf {{WT-Name}}

	Sie sollten sich also als erstes überlegen zu welchem Themenstrang ihre Frage am besten passt. Und dann ihre Frage dort platzieren.		Sie sollten sich also als erstes überlegen zu welchem Themenstrang ihre Frage am besten passt. Und dann ihre Frage dort platzieren.

	Hilfreich wäre, wenn Sie dabei folgende Punkte in Betracht ziehen		Hilfreich wäre, wenn Sie dabei folgende Punkte in Betracht ziehen
	* {{WT-Name}} wird von vielen Freiwilligen unterstützt, die für dieses Programm programmieren und im Forum bei der Lösung von Problemen helfen. Bitte denken Sie dran, dass Sie keinen Anspruch darauf haben, dass ein Problem für Sie gelöst wird oder dass eine neue Funktion nach ihren ~~Wünsche~~ realisiert wird. Wenn Sie etwas ändern wollen, dann können Sie danach fragen, aber ggf. müssen Sie es selber verbessern.		* {{WT-Name}} wird von vielen Freiwilligen unterstützt, die für dieses Programm programmieren und im Forum bei der Lösung von Problemen helfen. Bitte denken Sie dran, dass Sie keinen Anspruch darauf haben, dass ein Problem für Sie gelöst wird oder dass eine neue Funktion nach ihren Wünschen realisiert wird. Wenn Sie etwas ändern wollen, dann können Sie danach fragen, aber ggf. müssen Sie es selber verbessern.
	* Es ist einfacher, Ihnen zu helfen, wenn Sie die Adresse ihrer Website mitteilen. Sie können den Link zu ihrer Website am besten direkt in ihre Forensignatur integrieren.		* Es ist einfacher, Ihnen zu helfen, wenn Sie die Adresse ihrer Website mitteilen. Sie können den Link zu ihrer Website am besten direkt in ihre Forensignatur integrieren.
	* Bei Serverproblemen hilft es, wenn Sie mitteilen, welche Softwareversionen in Ihrer Umgebung installiert sind. Sie können diese Informationen auch in ihre Forensignatur einbauen.		* Bei Serverproblemen hilft es, wenn Sie mitteilen, welche Softwareversionen in Ihrer Umgebung installiert sind. Sie können diese Informationen auch in ihre Forensignatur einbauen.
	* Prüfen Sie vorher, ob ihre Frage im Forum bereits beantwortet wurde. Sie können die Forenseiten über die Registerkarte "[https://www.webtrees.net/index.php/en/forum/search Search]" durchsuchen.		* Prüfen Sie vorher, ob ihre Frage im Forum bereits beantwortet wurde. Sie können die Forenseiten über die Registerkarte "[https://www.webtrees.net/index.php/en/forum/search Search]" durchsuchen.
	* Wenn Sie ein Problem im Zusammenhang mit der Migration von [[Webtrees_Handbuch/Anleitung_für_Webmaster/Anleitung_Upgrade_20\|1.7 auf 2.0]] ~~oder von~~ [[Webtrees_Handbuch/Anleitung_für_Webmaster/Anleitung_Upgrade_21\|2.0 auf 2.1]] haben, lesen Sie bitte zuerst die entsprechenden Abschnitte in diesem Handbuch.		* Wenn Sie ein Problem im Zusammenhang mit der Migration von [[Webtrees_Handbuch/Anleitung_für_Webmaster/Anleitung_Upgrade_20\|1.7 auf 2.0]], [[Webtrees_Handbuch/Anleitung_für_Webmaster/Anleitung_Upgrade_21\|2.0 auf 2.1]] oder von [[Webtrees Handbuch/Anleitung für Webmaster/Anleitung Upgrade 22\|2.1 auf 2.2]] haben, lesen Sie bitte zuerst die entsprechenden Abschnitte in diesem Handbuch.
	* Wenn Sie „denken“, dass Sie einen Fehler gefunden haben, deaktivieren Sie bitte zuerst alle [https://wiki-de.genealogy.net/Webtrees_Handbuch/Anleitung_f%C3%BCr_Webmaster/Erweiterungsmodule Erweiterungsmodule], falls Sie welche verwenden. Wenn das Problem dadurch verschwindet, melden Sie den Fehler auf der GitHub-Seite des Erweiterungsmoduls oder geben Sie zumindest das ~~benutzerdefinierte Modul~~ als wahrscheinliche Ursache des Problems an, wenn Sie das Problem im Forum melden möchten. Wenn das Problem ohne Bezug zu einem Erweiterungsmodul ist, durchsuchen sie die Liste der bekannten [https://github.com/fisharebest/webtrees/issues webtrees-Fehler]. Gehen Sie dann zum Forum zurück und fragen Sie nach, bevor Sie den Fehler auf GitHub melden. Vielleicht ist es ja auch etwas, das Sie nicht vollständig verstehen, und überhaupt kein Fehler.		* Wenn Sie „denken“, dass Sie einen Fehler gefunden haben, deaktivieren Sie bitte zuerst alle [https://wiki-de.genealogy.net/Webtrees_Handbuch/Anleitung_f%C3%BCr_Webmaster/Erweiterungsmodule Erweiterungsmodule], falls Sie welche verwenden. Wenn das Problem dadurch verschwindet, melden Sie den Fehler auf der GitHub-Seite des Erweiterungsmoduls oder geben Sie zumindest das Erweiterungsmodul als wahrscheinliche Ursache des Problems an, wenn Sie das Problem im Forum melden möchten. Wenn das Problem ohne Bezug zu einem Erweiterungsmodul ist, durchsuchen sie die Liste der bekannten [https://github.com/fisharebest/webtrees/issues webtrees-Fehler]. Gehen Sie dann zum Forum zurück und fragen Sie nach, bevor Sie den Fehler auf GitHub melden. Vielleicht ist es ja auch etwas, das Sie nicht vollständig verstehen, und überhaupt kein Fehler.
	* Die Standardsprache im Forum ist Englisch. Wenn Sie es bevorzugen Ihre Frage in deutscher Sprache zu stellen, sollten Sie zusätzlich eine Übersetzung ins Englische hinzuzufügen (verwenden Sie dafür vielleicht [https://translate.google.de/ Google Translate] oder [https://www.deepl.com/translator DeepL]). Wenn möglich, wird man Ihnen in Deutsch antworten, oder Sie verwenden ein Tool zur Rückübersetzung.		* Die Standardsprache im Forum ist Englisch. Wenn Sie es bevorzugen Ihre Frage in deutscher Sprache zu stellen, sollten Sie zusätzlich eine Übersetzung ins Englische hinzuzufügen (verwenden Sie dafür vielleicht [https://translate.google.de/ Google Translate] oder [https://www.deepl.com/translator DeepL]). Wenn möglich, wird man Ihnen in Deutsch antworten, oder Sie verwenden ein Tool zur Rückübersetzung.
	* Verwenden Sie Forenbeiträge, Signaturen oder Avatar-Links '''nicht''' für Werbung oder für Aufforderungen zu Handlungen.		* Verwenden Sie Forenbeiträge, Signaturen oder Avatar-Links '''nicht''' für Werbung oder für Aufforderungen zu Handlungen.

Hartenthaler: /* Softwarearchitektur und modularer Aufbau von webtrees */ typo

2025-07-30T23:04:48Z

Softwarearchitektur und modularer Aufbau von webtrees: typo

← Nächstältere Version		Version vom 31. Juli 2025, 01:04 Uhr
Zeile 218:		Zeile 218:
	=== Softwarearchitektur und modularer Aufbau von webtrees ===		=== Softwarearchitektur und modularer Aufbau von webtrees ===
	[[Datei:WT 2.1 ModelViewControllerDiagram.png\|mini\|Ein Model-View-Controller-Konzept. Eine durchgezogene Linie symbolisiert hier eine direkte Assoziation, eine gestrichelte eine indirekte Assoziation (zum Beispiel über einen Beobachter).\|verweis=Special:FilePath/WT_2.1_ModelViewControllerDiagram.svg]]		[[Datei:WT 2.1 ModelViewControllerDiagram.png\|mini\|Ein Model-View-Controller-Konzept. Eine durchgezogene Linie symbolisiert hier eine direkte Assoziation, eine gestrichelte eine indirekte Assoziation (zum Beispiel über einen Beobachter).\|verweis=Special:FilePath/WT_2.1_ModelViewControllerDiagram.svg]]
	{{WT-Name}} verwendet das Laravel-Framework<ref>{{wikipedia-Link\|Laravel}}</ref> in der Version 18. Laravel ist ein freies PHP-Webframework, das dem MVC-Muster folgt. Der Architekturansatz "[https://de.wikipedia.org/wiki/Model_View_Controller Model View Controller]" (MVC, englisch für Modell-Präsentation-Steuerung) sieht eine Softwarearchitektur mit drei Komponenten vor		{{WT-Name}} verwendet das Laravel-Framework<ref>{{wikipedia-Link\|Laravel}}</ref> in der Version 11. Laravel ist ein freies PHP-Webframework, das dem MVC-Muster folgt. Der Architekturansatz "[https://de.wikipedia.org/wiki/Model_View_Controller Model View Controller]" (MVC, englisch für Modell-Präsentation-Steuerung) sieht eine Softwarearchitektur mit drei Komponenten vor
	* Datenmodell (englisch model)		* Datenmodell (englisch model)
	* Präsentation (englisch view) und		* Präsentation (englisch view) und

Hartenthaler: /* Softwarearchitektur und modularer Aufbau von webtrees */ Laravel V18

2025-07-30T22:57:19Z

Softwarearchitektur und modularer Aufbau von webtrees: Laravel V18

← Nächstältere Version		Version vom 31. Juli 2025, 00:57 Uhr
Zeile 218:		Zeile 218:
	=== Softwarearchitektur und modularer Aufbau von webtrees ===		=== Softwarearchitektur und modularer Aufbau von webtrees ===
	[[Datei:WT 2.1 ModelViewControllerDiagram.png\|mini\|Ein Model-View-Controller-Konzept. Eine durchgezogene Linie symbolisiert hier eine direkte Assoziation, eine gestrichelte eine indirekte Assoziation (zum Beispiel über einen Beobachter).\|verweis=Special:FilePath/WT_2.1_ModelViewControllerDiagram.svg]]		[[Datei:WT 2.1 ModelViewControllerDiagram.png\|mini\|Ein Model-View-Controller-Konzept. Eine durchgezogene Linie symbolisiert hier eine direkte Assoziation, eine gestrichelte eine indirekte Assoziation (zum Beispiel über einen Beobachter).\|verweis=Special:FilePath/WT_2.1_ModelViewControllerDiagram.svg]]
	{{WT-Name}} verwendet das Laravel-Framework<ref>{{wikipedia-Link\|Laravel}}</ref> in der Version 10. Laravel ist ein freies PHP-Webframework, das dem MVC-Muster folgt. Der Architekturansatz "[https://de.wikipedia.org/wiki/Model_View_Controller Model View Controller]" (MVC, englisch für Modell-Präsentation-Steuerung) sieht eine Softwarearchitektur mit drei Komponenten vor		{{WT-Name}} verwendet das Laravel-Framework<ref>{{wikipedia-Link\|Laravel}}</ref> in der Version 18. Laravel ist ein freies PHP-Webframework, das dem MVC-Muster folgt. Der Architekturansatz "[https://de.wikipedia.org/wiki/Model_View_Controller Model View Controller]" (MVC, englisch für Modell-Präsentation-Steuerung) sieht eine Softwarearchitektur mit drei Komponenten vor
	* Datenmodell (englisch model)		* Datenmodell (englisch model)
	* Präsentation (englisch view) und		* Präsentation (englisch view) und

Hartenthaler: /* webtrees-Forum */ Aktualisierung auf 2.2

2025-04-03T15:38:12Z

webtrees-Forum: Aktualisierung auf 2.2

← Nächstältere Version		Version vom 3. April 2025, 17:38 Uhr
Zeile 23:		Zeile 23:

	Das Forum ist in verschiedene Themenstränge gegliedert		Das Forum ist in verschiedene Themenstränge gegliedert
	* ~~Beta release~~ - hier ~~werden~~ Fragen zur ~~nächsten~~ Version von {{WT-Name}} ~~diskutiert~~		* Help for version 2.2 - hier geht es um alle Fragen zur aktuellen Version von {{WT-Name}}
	* Help for version 2.1 - ~~hier geht es um~~ alle Fragen zur ~~aktuellen Version~~		* Help for version 2.1 - alle Fragen zur Vorgängerversion 2.1
	* Help for 2.1 migration - hier wird der Umstieg von 2.0 auf 2.1 thematisiert		* Help for 2.1 migration - hier wird der Umstieg von 2.0 auf 2.1 thematisiert
	* Help for version 2.0 - alle Fragen zur Vorgängerversion 2.0		* Help for version 2.0 - alle Fragen zur Vorgängerversion 2.0
			* Beta release GitHub "Main branch" - hier werden Fragen zur nächsten Version von {{WT-Name}} diskutiert
	* Help for Version 1.7 - alle Fragen zur eingefrorenen Version 1.7 (und frühere)		* Help for Version 1.7 - alle Fragen zur eingefrorenen Version 1.7 (und frühere)
	* Open discussion - Fragen mit übergeordnetem Charakter (Strategie, Genealogie allgemein)		* Open discussion - Fragen mit übergeordnetem Charakter (Strategie, Genealogie allgemein)

Hartenthaler: /* Testen von selbst erstellten Übersetzungen */

2025-02-14T22:47:34Z

Testen von selbst erstellten Übersetzungen

← Nächstältere Version		Version vom 15. Februar 2025, 00:47 Uhr
Zeile 1.159:		Zeile 1.159:
	== Erweiterung der Übersetzungen ==		== Erweiterung der Übersetzungen ==
	[[Datei:WT_2.0_webtrees-weblate.png\|thumb\|250px\|{{WT-Name}} Weblate-Instanz ]]Die in {{WT-Name}} verwendeten Begriffe und Textbausteine werden in viele verschiedene Sprachen übersetzt und es kommen immer noch neue Sprachen hinzu. Durch den {{WT-Name}}-Hauptentwickler wird eine eigene [https://en.wikipedia.org/wiki/Weblate Weblate]-Instanz betrieben, um die Übersetzungen über alle Sprachen hinweg zu pflegen: [https://translate.webtrees.net/projects/webtrees/webtrees-22/ translate.webtrees.net/projects/webtrees/webtrees-22/]. Dieses [https://weblate.org/ Weblate]-Übersetzungssystem erfordert eine Registrierung als Nutzer.		[[Datei:WT_2.0_webtrees-weblate.png\|thumb\|250px\|{{WT-Name}} Weblate-Instanz ]]Die in {{WT-Name}} verwendeten Begriffe und Textbausteine werden in viele verschiedene Sprachen übersetzt und es kommen immer noch neue Sprachen hinzu. Durch den {{WT-Name}}-Hauptentwickler wird eine eigene [https://en.wikipedia.org/wiki/Weblate Weblate]-Instanz betrieben, um die Übersetzungen über alle Sprachen hinweg zu pflegen: [https://translate.webtrees.net/projects/webtrees/webtrees-22/ translate.webtrees.net/projects/webtrees/webtrees-22/]. Dieses [https://weblate.org/ Weblate]-Übersetzungssystem erfordert eine Registrierung als Nutzer.

	Wenn man eine neue Sprache einbringen möchte, müssen einige Spracheigenschaften, wie etwa die Pluralregeln der Sprache oder die Schreibrichtung, zentral hinterlegt werden. Das Anlegen erfolgt einmalig im {{WT-Name}}-Kern durch den Hauptentwickler. Die grundsätzlichen Spracheigenschaften sind im Verzeichnis <code>/vendor/fisharebest/localization/src</code> hinterlegt; dort findet man etwa die im Schweizer Hochdeutsch spezielle Festlegung zur Darstellung von Zahlen. Anpassungen der sprachspezifischen Sortierung von Wörtern oder Datumsangaben werden in einer Datei in <code>/app/Module/Language<Sprache>.php</code> festgelegt (für Deutsch also in <code>/app/Module/LanguageGerman.php</code>).

	=== I18N-Übersetzungssystem ===		=== I18N-Übersetzungssystem ===
Zeile 1.204:		Zeile 1.202:
	Nach Ergänzungen oder Korrekturen von Übersetzungen muss man auf die nächste Version von {{WT-Name}} warten, die dann alle Änderungen enthält. Geänderte Übersetzungen sind also auf dem eigenen Server jeweils mit dem nächsten Upgrade von {{WT-Name}} verfügbar. Wenn man die Übersetzungen bereits zuvor testen oder nutzen möchte, empfiehlt sich das folgende Vorgehen		Nach Ergänzungen oder Korrekturen von Übersetzungen muss man auf die nächste Version von {{WT-Name}} warten, die dann alle Änderungen enthält. Geänderte Übersetzungen sind also auf dem eigenen Server jeweils mit dem nächsten Upgrade von {{WT-Name}} verfügbar. Wenn man die Übersetzungen bereits zuvor testen oder nutzen möchte, empfiehlt sich das folgende Vorgehen

	# Wenn man eine neue Sprache erstmalig aktivieren will, muss man einige durch den {{WT-Name}}-Hauptentwickler aktualisierte Verzeichnisse bzw. Dateien vom {{WT-Name}}-GitHub-Server auf den eigenen Server kopieren		# Einige Tage nach der Änderung einer Übersetzung findet man die neueste PO-Datei (<code>messages.po</code>) im Sprachunterverzeichnis für die entsprechende Sprache auf dem GitHub-{{WT-Name}}-Server, also etwa für die deutsche Sprache unter [https://github.com/fisharebest/webtrees/blob/main/resources/lang/de/messages.po github.com/fisharebest/webtrees/blob/main/resources/lang/de/messages.po]. Man kann diese PO-Datei auch aus der Weblate-Site [https://translate.webtrees.net/projects/webtrees/webtrees-22/ translate.webtrees.net/projects/webtrees/webtrees-22/] erstellen und von dort herunterladen. Zur manuellen Aktivierung legt man diese Datei <code>messages.po</code> im entsprechenden Sprach-Verzeichnis auf dem eigenen Server ab, etwa im Verzeichnis <code>/resources/lang/de/</code> .
	~~##<code>/vendor/fisharebest/localization/src/</code>~~
	~~##<code>/app/Module/Language<Sprache>.php</code>~~
	~~##<code>/app/Services/ModuleService.php</code>~~
	# Einige Tage nach der Änderung einer Übersetzung findet man die neueste PO-Datei (<code>messages.po</code>) im Sprachunterverzeichnis für die entsprechende Sprache auf dem GitHub-{{WT-Name}}-Server, also etwa für die deutsche Sprache unter [https://github.com/fisharebest/webtrees/blob/main/resources/lang/de/messages.po github.com/fisharebest/webtrees/blob/main/resources/lang/de/messages.po]. Man kann diese PO-Datei auch aus der Weblate-Site [https://translate.webtrees.net/projects/webtrees/webtrees-22/ translate.webtrees.net/projects/webtrees/webtrees-22/] erstellen und von dort herunterladen. Zur manuellen Aktivierung legt man diese Datei <code>messages.po</code> im entsprechenden ~~Unterverzeichnis <code>/resources/lang/<2 Zeichen Sprachkennung>/</code>~~ auf dem eigenen Server ab, ~~wobei man dieses Verzeichnis neu erstellen muss, falls es noch nicht existieren sollte (wobei "<code><2 Zeichen Sprachkennung></code>"~~ etwa ~~für Deutsch "de" ist). Das~~ Verzeichnis <code>/resources/lang/de/</code> ~~wird aber schon existieren~~.
	# Dann löscht man die vorhandene Datei <code>messages.php</code> in diesem Verzeichnis; diese Datei wird dann automatisch von {{WT-Name}} beim nächsten Aufruf aus der aktualisierten Datei <code>messages.po</code> neu erzeugt.		# Dann löscht man die vorhandene Datei <code>messages.php</code> in diesem Verzeichnis; diese Datei wird dann automatisch von {{WT-Name}} beim nächsten Aufruf aus der aktualisierten Datei <code>messages.po</code> neu erzeugt.
	~~# Die gewünschte Sprache muss im Verwaltungsmenü von {{WT-Name}} unter <code>Module / Webseite / Sprachen</code> aktiviert werden, falls sie es noch nicht ist.~~
	# Die geänderten Übersetzungen sollten gründlich getestet werden.		# Die geänderten Übersetzungen sollten gründlich getestet werden.

	{{WT-ToDo\|Verweis auf die Sprachenliste hier im Handbuch; Verweis zur Liste/Standard der Sprachcodes.}}		=== Erstmaliges Anlegen einer neuen Sprache ===
			Wenn man eine neue Sprache für {{WT-Name}} einbringen möchte, müssen einige Spracheigenschaften, wie etwa die Pluralregeln der Sprache oder die Schreibrichtung, zentral hinterlegt werden. Das Anlegen erfolgt einmalig im {{WT-Name}}-Kern durch den Hauptentwickler. Die grundsätzlichen Spracheigenschaften sind im Verzeichnis <code>/vendor/fisharebest/localization/src</code> hinterlegt; dort findet man etwa die im Schweizer Hochdeutsch spezielle Festlegung zur Darstellung von Zahlen. Anpassungen der sprachspezifischen Sortierung von Wörtern oder Datumsangaben werden in einer Datei in <code>/app/Module/Language<Sprache>.php</code> festgelegt (für Deutsch also in <code>/app/Module/LanguageGerman.php</code>).

			Wenn man eine neue Sprache für Tests vor dem Erscheinen eines {{WT-Name}}-Upgrades erstmalig aktivieren will, muss man einige durch den {{WT-Name}}-Hauptentwickler aktualisierte Verzeichnisse bzw. Dateien vom {{WT-Name}}-GitHub-Server auf den eigenen Server kopieren
			*<code>/vendor/fisharebest/localization/src/</code>
			*<code>/app/Module/Language<Sprache>.php</code>
			*<code>/app/Services/ModuleService.php</code>
			Zusätzlich muss man auf dem eigenen Server das Unterverzeichnis <code>/resources/lang/<2 Zeichen Sprachkennung>/</code> neu erstellen (wobei <code><2 Zeichen Sprachkennung></code> etwa für Deutsch "de" ist). Danach kann man wie im obigen Abschnitt "[[Webtrees Handbuch/Entwicklungsumgebung#Testen von selbst erstellten Übersetzungen\|Testen von selbst erstellten Übersetzungen]]" vorgehen. Die gewünschte Sprache muss dann im Verwaltungsmenü von {{WT-Name}} unter <code>Module / Webseite / Sprachen</code> aktiviert werden und der Test kann beginnen.{{WT-ToDo\|Verweis auf die Sprachenliste hier im Handbuch; Verweis zur Liste/Standard der Sprachcodes.}}

	== Einzelnachweise ==		== Einzelnachweise ==

Hartenthaler: /* Testen von selbst erstellten Übersetzungen */

2025-02-14T16:20:28Z

Testen von selbst erstellten Übersetzungen

← Nächstältere Version		Version vom 14. Februar 2025, 18:20 Uhr
Zeile 1.204:		Zeile 1.204:
	Nach Ergänzungen oder Korrekturen von Übersetzungen muss man auf die nächste Version von {{WT-Name}} warten, die dann alle Änderungen enthält. Geänderte Übersetzungen sind also auf dem eigenen Server jeweils mit dem nächsten Upgrade von {{WT-Name}} verfügbar. Wenn man die Übersetzungen bereits zuvor testen oder nutzen möchte, empfiehlt sich das folgende Vorgehen		Nach Ergänzungen oder Korrekturen von Übersetzungen muss man auf die nächste Version von {{WT-Name}} warten, die dann alle Änderungen enthält. Geänderte Übersetzungen sind also auf dem eigenen Server jeweils mit dem nächsten Upgrade von {{WT-Name}} verfügbar. Wenn man die Übersetzungen bereits zuvor testen oder nutzen möchte, empfiehlt sich das folgende Vorgehen

	# Wenn man eine neue Sprache erstmalig aktivieren will, muss man einige durch den {{WT-Name}}-Hauptentwickler aktualisierte Dateien vom {{WT-Name}}-GitHub-Server auf den eigenen Server kopieren		# Wenn man eine neue Sprache erstmalig aktivieren will, muss man einige durch den {{WT-Name}}-Hauptentwickler aktualisierte Verzeichnisse bzw. Dateien vom {{WT-Name}}-GitHub-Server auf den eigenen Server kopieren
	##<code>/vendor/fisharebest/localization/src</code>		##<code>/vendor/fisharebest/localization/src/</code>
	##<code>/app/Module/Language<Sprache>.php</code>		##<code>/app/Module/Language<Sprache>.php</code>
	##<code>/app/Services/ModuleService.php</code>		##<code>/app/Services/ModuleService.php</code>

Hartenthaler: /* Testen von selbst erstellten Übersetzungen */

2025-02-14T16:15:23Z

Testen von selbst erstellten Übersetzungen

← Nächstältere Version		Version vom 14. Februar 2025, 18:15 Uhr
Zeile 1.158:		Zeile 1.158:

	== Erweiterung der Übersetzungen ==		== Erweiterung der Übersetzungen ==
	Die in {{WT-Name}} verwendeten Begriffe und Textbausteine werden in viele verschiedene Sprachen übersetzt und es kommen immer noch neue Sprachen hinzu. Durch den {{WT-Name}}-Hauptentwickler wird eine eigene [https://en.wikipedia.org/wiki/Weblate Weblate]-Instanz betrieben, um die Übersetzungen über alle Sprachen hinweg zu pflegen: [https://translate.webtrees.net/projects/webtrees/webtrees-22/ translate.webtrees.net/projects/webtrees/webtrees-22/]. Dieses [https://weblate.org/ Weblate]-Übersetzungssystem erfordert eine Registrierung als Nutzer.		[[Datei:WT_2.0_webtrees-weblate.png\|thumb\|250px\|{{WT-Name}} Weblate-Instanz ]]Die in {{WT-Name}} verwendeten Begriffe und Textbausteine werden in viele verschiedene Sprachen übersetzt und es kommen immer noch neue Sprachen hinzu. Durch den {{WT-Name}}-Hauptentwickler wird eine eigene [https://en.wikipedia.org/wiki/Weblate Weblate]-Instanz betrieben, um die Übersetzungen über alle Sprachen hinweg zu pflegen: [https://translate.webtrees.net/projects/webtrees/webtrees-22/ translate.webtrees.net/projects/webtrees/webtrees-22/]. Dieses [https://weblate.org/ Weblate]-Übersetzungssystem erfordert eine Registrierung als Nutzer.

	Wenn man eine neue Sprache einbringen möchte, müssen einige Spracheigenschaften, wie etwa die Pluralregeln der Sprache oder die Schreibrichtung, zentral hinterlegt werden. Das Anlegen erfolgt einmalig im {{WT-Name}}-Kern durch den Hauptentwickler. Die grundsätzlichen Spracheigenschaften sind im Verzeichnis <code>/vendor/fisharebest/localization/src</code> hinterlegt; dort findet man etwa die im Schweizer Hochdeutsch spezielle Festlegung zur Darstellung von Zahlen. Anpassungen der sprachspezifischen Sortierung von Wörtern oder Datumsangaben werden in einer Datei in <code>/app/Module/Language<Sprache>.php</code> festgelegt (für Deutsch also in <code>/app/Module/LanguageGerman.php</code>).		Wenn man eine neue Sprache einbringen möchte, müssen einige Spracheigenschaften, wie etwa die Pluralregeln der Sprache oder die Schreibrichtung, zentral hinterlegt werden. Das Anlegen erfolgt einmalig im {{WT-Name}}-Kern durch den Hauptentwickler. Die grundsätzlichen Spracheigenschaften sind im Verzeichnis <code>/vendor/fisharebest/localization/src</code> hinterlegt; dort findet man etwa die im Schweizer Hochdeutsch spezielle Festlegung zur Darstellung von Zahlen. Anpassungen der sprachspezifischen Sortierung von Wörtern oder Datumsangaben werden in einer Datei in <code>/app/Module/Language<Sprache>.php</code> festgelegt (für Deutsch also in <code>/app/Module/LanguageGerman.php</code>).
Zeile 1.202:		Zeile 1.202:

	=== Testen von selbst erstellten Übersetzungen ===		=== Testen von selbst erstellten Übersetzungen ===
	Nach Ergänzungen oder Korrekturen von Übersetzungen muss man auf die nächste Version von {{WT-Name}} warten, die dann alle Änderungen enthält. ~~Neue oder geänderte~~ Übersetzungen sind also jeweils mit dem nächsten Upgrade von {{WT-Name}} verfügbar. Wenn man die Übersetzungen bereits zuvor testen oder nutzen möchte, empfiehlt sich das folgende Vorgehen		Nach Ergänzungen oder Korrekturen von Übersetzungen muss man auf die nächste Version von {{WT-Name}} warten, die dann alle Änderungen enthält. Geänderte Übersetzungen sind also auf dem eigenen Server jeweils mit dem nächsten Upgrade von {{WT-Name}} verfügbar. Wenn man die Übersetzungen bereits zuvor testen oder nutzen möchte, empfiehlt sich das folgende Vorgehen

			# Wenn man eine neue Sprache erstmalig aktivieren will, muss man einige durch den {{WT-Name}}-Hauptentwickler aktualisierte Dateien vom {{WT-Name}}-GitHub-Server auf den eigenen Server kopieren
			##<code>/vendor/fisharebest/localization/src</code>
			##<code>/app/Module/Language<Sprache>.php</code>
			##<code>/app/Services/ModuleService.php</code>
	# Einige Tage nach der Änderung einer Übersetzung findet man die neueste PO-Datei (<code>messages.po</code>) im Sprachunterverzeichnis für die entsprechende Sprache auf dem GitHub-{{WT-Name}}-Server, also etwa für die deutsche Sprache unter [https://github.com/fisharebest/webtrees/blob/main/resources/lang/de/messages.po github.com/fisharebest/webtrees/blob/main/resources/lang/de/messages.po]. Man kann diese PO-Datei auch aus der Weblate-Site [https://translate.webtrees.net/projects/webtrees/webtrees-22/ translate.webtrees.net/projects/webtrees/webtrees-22/] erstellen und von dort herunterladen. Zur manuellen Aktivierung legt man diese Datei <code>messages.po</code> im entsprechenden Unterverzeichnis <code>/resources/lang/<2 Zeichen Sprachkennung>/</code> auf dem eigenen Server ab, wobei man dieses Verzeichnis neu erstellen muss, falls es noch nicht existieren sollte (wobei "<code><2 Zeichen Sprachkennung></code>" etwa für Deutsch "de" ist). Das Verzeichnis <code>/resources/lang/de/</code> wird aber schon existieren.		# Einige Tage nach der Änderung einer Übersetzung findet man die neueste PO-Datei (<code>messages.po</code>) im Sprachunterverzeichnis für die entsprechende Sprache auf dem GitHub-{{WT-Name}}-Server, also etwa für die deutsche Sprache unter [https://github.com/fisharebest/webtrees/blob/main/resources/lang/de/messages.po github.com/fisharebest/webtrees/blob/main/resources/lang/de/messages.po]. Man kann diese PO-Datei auch aus der Weblate-Site [https://translate.webtrees.net/projects/webtrees/webtrees-22/ translate.webtrees.net/projects/webtrees/webtrees-22/] erstellen und von dort herunterladen. Zur manuellen Aktivierung legt man diese Datei <code>messages.po</code> im entsprechenden Unterverzeichnis <code>/resources/lang/<2 Zeichen Sprachkennung>/</code> auf dem eigenen Server ab, wobei man dieses Verzeichnis neu erstellen muss, falls es noch nicht existieren sollte (wobei "<code><2 Zeichen Sprachkennung></code>" etwa für Deutsch "de" ist). Das Verzeichnis <code>/resources/lang/de/</code> wird aber schon existieren.
	# Dann löscht man die vorhandene Datei <code>messages.php</code> in diesem Verzeichnis; diese Datei wird dann automatisch von {{WT-Name}} beim nächsten Aufruf aus der aktualisierten Datei <code>messages.po</code> neu erzeugt.		# Dann löscht man die vorhandene Datei <code>messages.php</code> in diesem Verzeichnis; diese Datei wird dann automatisch von {{WT-Name}} beim nächsten Aufruf aus der aktualisierten Datei <code>messages.po</code> neu erzeugt.
	# ~~Wenn man eine neue~~ Sprache ~~erstmalig aktivieren will,~~ muss ~~man einige aktualisierte Dateien vom~~ {{WT-Name}}~~-GitHub-Server auf den eigenen Server kopieren~~		# Die gewünschte Sprache muss im Verwaltungsmenü von {{WT-Name}} unter <code>Module / Webseite / Sprachen</code> aktiviert werden, falls sie es noch nicht ist.
	~~## <code>/vendor/fisharebest/localization/src</code>~~		# Die geänderten Übersetzungen sollten gründlich getestet werden.
	## <code>~~/app/~~Module/~~Language<Sprache>.php<~~/~~code>~~
	~~## <code>/app/Services/ModuleService.php~~</code>
	~~# Aktivierung der gewünschten Sprache im Verwaltungsmenü von {{WT-Name}} unter Module / Webseite / Sprachen~~, falls sie es noch nicht ist.
	# ~~Testen der~~ geänderten Übersetzungen.

	{{WT-ToDo\|Verweis auf die Sprachenliste hier im Handbuch; Verweis zur Liste/Standard der Sprachcodes.}}		{{WT-ToDo\|Verweis auf die Sprachenliste hier im Handbuch; Verweis zur Liste/Standard der Sprachcodes.}}

Hartenthaler: /* Verbesserungsvorschläge für die deutsche Übersetzung */

2025-02-14T16:04:53Z

Verbesserungsvorschläge für die deutsche Übersetzung

← Nächstältere Version		Version vom 14. Februar 2025, 18:04 Uhr
Zeile 194:		Zeile 194:
	Wenn der erste Grund zutrifft, sollten Sie ein Erweiterungsmodul mit ihren persönlichen Übersetzungen erstellen (siehe Abschnitt "[[Webtrees Handbuch/Entwicklungsumgebung#Modul zur individuellen Anpassung von Übersetzungen\|Modul zur individuellen Anpassung von Übersetzungen]]").		Wenn der erste Grund zutrifft, sollten Sie ein Erweiterungsmodul mit ihren persönlichen Übersetzungen erstellen (siehe Abschnitt "[[Webtrees Handbuch/Entwicklungsumgebung#Modul zur individuellen Anpassung von Übersetzungen\|Modul zur individuellen Anpassung von Übersetzungen]]").

	Wenn der zweite Grund zutrifft, sollten sie diese Übersetzungsänderung im {{WT-Name}}-Forum in der Kategorie "[https://www.webtrees.net/index.php/forum/8-translation Translation]" besprechen. Wenn es zu einem Konsens kommt, können Sie mit dem Weblate-Übersetzungstool die Änderung durchführen.		Wenn der zweite Grund zutrifft, sollten sie diese Übersetzungsänderung im {{WT-Name}}-Forum in der Kategorie "[https://www.webtrees.net/index.php/forum/8-translation Translation]" besprechen. Wenn es zu einem Konsens kommt, können Sie mit dem Weblate-Übersetzungstool die Änderung durchführen (siehe Kapitel "[[Webtrees Handbuch/Entwicklungsumgebung#Erweiterung_der_.C3.9Cbersetzungen\|Erweiterung der Übersetzungen]]").

	Übersetzungen von [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule\|Erweiterungsmodulen]] erfolgen ~~an anderer Stelle,~~ direkt im GitHub-Verzeichnis des Moduls. Dazu bietet in der Regel die <code>README.md</code>-Seite des jeweiligen Moduls weitergehende Hinweise (siehe Abschnitt "[[Webtrees Handbuch/Entwicklungsumgebung#.C3.9Cbersetzung der Modultexte in andere Sprachen\|Übersetzung der Modultexte in andere Sprachen]]").		Übersetzungen von [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule\|Erweiterungsmodulen]] erfolgen direkt im GitHub-Verzeichnis des jeweiligen Moduls. Dazu bietet in der Regel die <code>README.md</code>-Seite des jeweiligen Moduls weitergehende Hinweise (siehe Abschnitt "[[Webtrees Handbuch/Entwicklungsumgebung#.C3.9Cbersetzung der Modultexte in andere Sprachen\|Übersetzung der Modultexte in andere Sprachen]]").

	{{-}}		{{-}}