GenWiki - Benutzerbeiträge [de]

Webtrees Handbuch

2023-03-16T07:05:00Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

__NOTOC__

[[Datei:Webtrees_icon.png|left|125px|link=]]

<div id="toc" class="toc" role="navigation" aria-labelledby="mw-toc-heading" style="float:right; border-radius: 1em 1em 1em 1em;">
<div class="toctitle" dir="ltr" lang="de" style="background-color:#FFFFCC; border-radius: 1em 1em 1em 1em;"><h2 id="mw-toc-heading">Handbuch Kapitelübersicht</h2></div>
<ul>
<li class="toclevel-1 tocsection-1">[[Webtrees_Handbuch/Allgemeine Erläuterung des Programms|Kapitel 1 - Allgemeine Erläuterung des Programms]]</li>
<li class="toclevel-1 tocsection-2">[[Webtrees_Handbuch/Anleitung_für_Besucher|Kapitel 2 - Anleitung für Besucher]]</li>
<li class="toclevel-1 tocsection-3">[[Webtrees_Handbuch/Anleitung_für_Mitglieder|Kapitel 3 - Anleitung für Mitglieder ]]</li>
<li class="toclevel-1 tocsection-4">[[Webtrees_Handbuch/Anleitung_für_Bearbeiter|Kapitel 4 - Anleitung für Bearbeiter]]</li>
<li class="toclevel-1 tocsection-5">[[Webtrees_Handbuch/Anleitung_für_Moderatoren|Kapitel 5 - Anleitung für Moderatoren]]</li>
<li class="toclevel-1 tocsection-6">[[Webtrees_Handbuch/Anleitung_für_Verwalter|Kapitel 6 - Anleitung für Verwalter]]</li>
<li class="toclevel-1 tocsection-7">[[Webtrees_Handbuch/Anleitung_für_Administratoren|Kapitel 7 - Anleitung für Administratoren]]</li>
<li class="toclevel-1 tocsection-8">[[Webtrees_Handbuch/Anleitung_für_Webmaster|Kapitel 8 - Anleitung für Webmaster]]</li>
<li class="toclevel-1 tocsection-9">[[Webtrees_Handbuch/Entwicklungsumgebung|Kapitel 9 - Entwicklungsumgebung]]</li>
<li class="toclevel-1 tocsection-10">[[Webtrees_Handbuch/Nutzungserfahrungen|Kapitel 10 - Nutzungserfahrungen]]</li>
<li class="toclevel-1 tocsection-11">[[Webtrees_Handbuch/Genealogischer Prozess|Kapitel 11 - Genealogischer Prozess]]</li>
<li class="toclevel-1 tocsection-12">[[Webtrees_Handbuch/Sonstige_Dokumentation_zu_webtrees|Anhang - Sonstige Dokumentation zu webtrees]]</li>
</ul>
</div>

<div style="margin-top: 1.8em; margin-bottom: 1em; margin-left: 10em; margin-right: 23em;">
Dieses Handbuch ist ein vollständiger Benutzer- und Administrationsleitfaden für das webbasierte Genealogieprogramm '''[https://webtrees.net webtrees]'''.

Es gibt mehrere Gründe, warum viele Ahnen- und Familienforscher webtrees so großartig finden. Es ist kostenlos, gut gestaltet, frei konfigurierbar und einfach zu bedienen. Allerdings verläuft die Erstinstallation auf einem [https://de.wikipedia.org/wiki/Webserver Webserver] nicht immer reibungslos und stellt Anforderungen, die viele Nutzer herausfordernd finden. Darüber hinaus sind alle Dokumente zu webtrees in englischer Sprache verfasst. Da neben den englischsprachigen Nutzern die deutschsprachigen Nutzer die größte Gruppe darstellen, ist nun hier ein umfassendes und aktuelles Handbuch in deutscher Sprache verfasst worden.

Bei der Arbeit mit webtrees lassen sich die Tätigkeiten verschiedenen [[Webtrees_Handbuch/Anleitung_für_Administratoren/Benutzer#Rollen|Rollen]] zuordnen. Die Kapitel 2 bis 7 in diesem Handbuch folgen genau dieser hierarchischen Rollenstruktur.
</div>
{{-}}


<center>
{|width="95%" border="0" cellpadding="3"
|-
| style="text-align: center; padding:2em; background-color:#EEEEEE; border-radius: 1em 1em 1em 1em;"| <big>'''Überblick über die Kapitel im Handbuch'''</big>
|-
|
{|{{Tabellenrahmen}}
| width="33%" {{Tabellenkopf2}} |
<big>Kapitel 1 - '''[[Webtrees_Handbuch/Allgemeine Erläuterung des Programms|Allgemeine Erläuterung des Programms]]'''</big>
| width="34%" {{Tabellenkopf2}} |
<big>Kapitel 2 - '''[[Webtrees_Handbuch/Anleitung für Besucher|Anleitung für Besucher]]'''</big>
| width="33%" {{Tabellenkopf2}} |
<big>Kapitel 3 - '''[[Webtrees_Handbuch/Anleitung für Mitglieder|Anleitung für Mitglieder]]'''</big>
|- valign="top"
| style="padding:1.3em; "|[[Datei:Icon portal digital library.svg|links|rahmenlos|40x40px|link= ]]Das erste Kapitel gibt eine allgemeine Einführung in die Besonderheiten von webtrees.
| style="padding:1.3em; "|[[Datei:Icon portal digital library.svg|links|rahmenlos|40x40px|link= ]]Website-Besucher, die als unangemeldete Gäste zumindest Teile der Website ggf. mit Einschränkungen betrachten können, finden in diesem Kapitel entsprechende Hinweise.
| style="padding:1.3em; "|[[Datei:Icon portal digital library.svg|links|rahmenlos|40x40px|link= ]]Für berechtigte Mitglieder des Stammbaums, die auch auf geschützte Daten lesend zugreifen können, ist dieses Kapitel vorgesehen.
|-
| {{Tabellenkopf2}} |
<big>Kapitel 4 - '''[[Webtrees_Handbuch/Anleitung_für_Bearbeiter|Anleitung für Bearbeiter]]'''</big>
| {{Tabellenkopf2}} |
<big>Kapitel 5 - '''[[Webtrees_Handbuch/Anleitung_für_Moderatoren|Anleitung für Moderatoren]]'''</big>
| {{Tabellenkopf2}} |
<big>Kapitel 6 - '''[[Webtrees_Handbuch/Anleitung_für_Verwalter|Anleitung für Verwalter]]'''</big>
|- valign="top"
| style="padding:1.3em; "|[[Datei:Icon portal digital library.svg|links|rahmenlos|40x40px|link= ]]Für Mitglieder, die in einem Stammbaum Daten ändern und hinzufügen können, dienen die Hinweise in diesem Kapitel.
| style="padding:1.3em; "|[[Datei:Icon portal digital library.svg|links|rahmenlos|40x40px|link= ]]Moderatoren genehmigen die von Bearbeitern vorgenommenen Änderungen.
| style="padding:1.3em; "|[[Datei:Icon portal digital library.svg|links|rahmenlos|40x40px|link= ]]Verwalter können für einen Stammbaum etliche Konfigurationsoptionen einstellen. Sie finden in diesem Kapitel eine Beschreibung aller ihnen zur Verfügung stehenden Möglichkeiten.
|-
| width="33%" {{Tabellenkopf2}} |
<big>Kapitel 7 - '''[[Webtrees_Handbuch/Anleitung_für_Administratoren|Anleitung für Administratoren]]'''</big>
| width="34%" {{Tabellenkopf2}} |
<big>Kapitel 8 - '''[[Webtrees_Handbuch/Anleitung für Webmaster|Anleitung für Webmaster]]'''</big>
| width="33%" {{Tabellenkopf2}} |
<big>Kapitel 9 - '''[[Webtrees_Handbuch/Entwicklungsumgebung|Entwicklungsumgebung]]'''</big>
|- valign="top"
| style="padding:1.3em; "|[[Datei:Icon portal digital library.svg|links|rahmenlos|40x40px|link= ]]In diesem Kapitel werden alle weiteren in webtrees verfügbaren Konfigurationsoptionen und Pflegetätigkeiten behandelt.
| style="padding:1.3em; "|[[Datei:Icon portal digital library.svg|links|rahmenlos|40x40px|link= ]]Die anfängliche Installation, die Konfiguration und die Wartung der Website werden in diesem Kapitel ausführlich behandelt. Hier werden auch einige Erweiterungsmodule beschrieben, deren Nutzung - je nach Einstellung - für Nutzer in allen Rollen möglich sein kann.
| style="padding:1.3em; "|[[Datei:Icon portal digital library.svg|links|rahmenlos|40x40px|link= ]]Dieses Kapitel beschreibt das Ökosystem rings um webtrees, mit dem Forum und der Entwicklungsumgebung.
|-
| {{Tabellenkopf2}} |
<big>Kapitel 10 - '''[[Webtrees_Handbuch/Nutzungserfahrungen|Nutzungserfahrungen]]'''</big>
| {{Tabellenkopf2}} |
<big>Kapitel 11 - '''[[Webtrees_Handbuch/Genealogischer Prozess|Genealogischer Prozess]]'''</big>
| {{Tabellenkopf2}} |
<big>Anhang - '''[[Webtrees_Handbuch/Sonstige_Dokumentation_zu_webtrees|Sonstige Dokumentation zu webtrees]]'''</big>

|- valign="top"
| style="padding:1.3em; "|[[Datei:Icon portal digital library.svg|links|rahmenlos|40x40px|link= ]]Besonderheiten bei der Zusammenarbeit mit anderen Genealogieprogrammen werden in diesem Kapitel näher beschrieben.
| style="padding:1.3em; "|[[Datei:Icon portal digital library.svg|links|rahmenlos|40x40px|link= ]]Im letzten Kapitel wird eher grundsätzlich auf das Vorgehen bei der Ahnenforschung unter Nutzung von webtrees eingegangen. Es dient somit noch nicht so erfahrenen Nutzern als Leitfaden zur Entwicklung eigener Strategien und als Kompendium genealogischen Grundwissens.
| style="padding:1.3em; "|[[Datei:Icon portal digital library.svg|links|rahmenlos|40x40px|link= ]]Neben diesem Handbuch gibt es im Internet noch weitere Dokumentationen zu webtrees, auf die hier verwiesen wird.
|-
|}
|}
</center>




{{Infobox|<big>'''Navigation im Handbuch'''</big> 
Jede Handbuchseite hier im GenWiki hat den selben Aufbau. Ganz oben steht der Titel der Seite. Darunter befindet sich die Brotkrumen-Navigationsleiste, die es bei verschachtelten Wiki-Seiten erlaubt, schrittweise zurück zu gehen. 
Rechts oben auf jeder Seite befindet sich das Inhaltsverzeichnis zum entsprechenden Kapitel oder Abschnitt, wobei die Nummerierung jeweils intern für das Kapitel oder den Abschnitt erfolgt. Im Kopf des Inhaltsverzeichnisses steht der Name und die Nummer des Kapitels oder des Abschnitts. Darunter gibt es einen Link "Zur Kapitelübersicht", der auf diese Startseite des Handbuchs verweist, und teilweise einen Link auf das übergeordnete Kapitel. 
Wenn es verschachtelte Wiki-Seiten gibt, etwa, wenn ein Kapitel ansonsten zu lang geworden wäre, dann wird auf die tieferen Wiki-Seiten im Text mit einem Link verwiesen und es gibt unter dem Inhaltsverzeichnis einen Informationskasten "Unterseiten" mit den Links auf diese Seiten. 
Ansonsten verweisen an vielen Stellen im Text hinterlegte Links auf andere Stellen des Handbuchs oder auf Informationen außerhalb des Handbuchs.}}

{{Infobox|<big>'''German is not your language?'''</big> 
The official webtrees documentation in the English language can be found at [https://webtrees.net/ webtrees.net] (see menu "Docs"). 
There are additional manuals for webtrees available
* a manual in [https://richard-underwood.com/product/webtrees-manual/ English] language (eBook or pdf)
* a fork of this manual in [https://manu.jprodina.cz/ Czech] language
}}

{{Infobox|
;Handbuch im Aufbau ... 
Bitte haben Sie noch ein wenig Geduld, das Handbuch wird noch bearbeitet.
Alle Stellen im Handbuch, die noch nicht fertig beschrieben sind, enthalten eine Infobox mit einem entsprechenden Hinweis.
Wenn Ihnen beim Lesen etwas auffallen sollte oder wenn Sie etwas suchen und keinen passenden Hinweis auf eine noch zu erfolgende Ergänzung vorfinden, fügen Sie bitte dort eine ToDo-Box ein mit dem Hinweis darauf, was noch fehlt.

Wenn Sie mitmachen wollen, können Sie einfach hier im GenWiki etwas ändern oder Sie melden Sie sich in unserem [https://team.genealogy.net/project/deutschsprachiges-handbuch-fuer-das-open/ Team-Raum].
}}

[[Kategorie:Webtrees]]

Wiki:Bot-OFB ohne Infobox

2023-03-15T13:13:24Z

Bot1: automatisch erzeugt von BotOfbOhneInfobox

{{ErzeugtdurchBot}}

Folgende Seiten enthalten keine Infobox OFB:

* [[Criewen 1975, OFB]]
* [[Eller, OFB]]
* [[Groß-St. Peter, OFB]]
* [[Hirschfeld, OFB]]
* [[Illingen (Saar), OFB]]
* [[Jarnoltów, OFB]]
* [[Kinzig, OFB]]
* [[Mülheim-Kärlich (2), OFB]]
* [[Radevormwald, OFB]]
* [[Remlingrade, OFB]]
* [[Rödersheim-Gronau, OFB]]
* [[Uelsen, OFB]]
* [[Varjas, OFB]]
* [[Vasbeck 1662 - 1938, OFB]]
* [[Veldhausen, OFB]]
* [[Versend, OFB]]
* [[White Creek, OFB]]
* [[Wiesdorf, OFB]]
* [[Wiesenfeld (Burgwald), OFB]]
* [[Wilhelmsbruch, OFB]]
* [[Windhagen, OFB]]
* [[Winnweiler, OFB]]
* [[Winzeln, OFB]]
* [[Wolfenweiler, OFB]]
* [[Wupperfeld, OFB]]
* [[Wuppertal, OFB]]

Webtrees Handbuch/Sonstige Dokumentation zu webtrees

2023-03-14T20:42:32Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Anhang|info=1}}{{WT-Inhaltsverzeichnis|Anhang|A}}

Neben diesem deutschsprachigen Handbuch gibt es noch andere Dokumentationen zu webtrees. Darunter sind sowohl offizielle Dokumente, als auch Handbücher, Präsentationen oder Video-Tutorials in verschiedenen Sprachen, die von Nutzern von webtrees erstellt worden sind.

== Offizielle Dokumentation zu webtrees ==
Die offizielle Dokumentation zu webtrees in englischer Sprache liegt bei [https://webtrees.net webtrees.net] (siehe das Menü "Docs").

== Handbücher für webtrees in anderen Sprachen ==
Folgende Handbücher sind bisher erschienen
* Handbuch in englischer Sprache (als [https://richard-underwood.com/product/webtrees-manual/ eBook oder pdf])
* davon abgeleitetes Handbuch in tschechischer Sprache (als [https://manu.jprodina.cz/ Web-Site])

== Was es sonst noch gibt ==
Am 8. Dezember 2022 hat das Team, das dieses Handbuch in weiten Teilen erstellt hat, das Programm webtrees in einer der regelmäßigen CompGen-Zoom-Veranstaltungen vorgestellt. Näheres zum Video und den Folien findet sich im zugehörigen [https://www.compgen.de/2022/12/praesentation-des-genealogieprogramms-webtrees/ Blog-Beitrag].

Viele weitere Autoren haben Präsentationen und Tutorials zu webtrees erstellt, die in der folgenden Liste aufgeführt sind und die mehr oder weniger aktuell sind.

{|class="wikitable sortable"
|+ Dokumente zum Thema webtrees
|-
! Dokument || Autor || berücksichtigte Version || Sprache || Installation || Konfiguration || Benutzung || class="unsortable" | Besonderheiten
|-
|[https://www.compgen.de/2022/12/praesentation-des-genealogieprogramms-webtrees/ Programmvorstellung mit Beispielen in einer Videoaufzeichnung]
|Peter Schulz, Hermann Hartenthaler, Burkhard Spiegel, Bernd Schwendinger
|2.1.15
|de
|(x)
|
|x
|Video mit Beispielen zur Nutzung
|-
|[https://z-m-a.de/webtrees_Anleitungen/webtrees-Bedienungsanleitung_knokeibutver.pdf Knoblauch Keibel Buttmann Verhuven und mehr - Bedienungsanleitung]
|?
|1.7
|de
|
|
|x
|37 reich bebilderte Seiten (nicht mehr auf der Originalseite verfügbar)
|-
|[https://z-m-a.de/webtrees_Anleitungen/webtrees-Benutzeranleitung_knokeibutver.pdf Knoblauch Keibel Buttmann Verhuven und mehr - Nutzung mit einem persönlichen Benutzerkonto]
|?
|1.7
|de
|
|
|x
|22 reich bebilderte Seiten (nicht mehr auf der Originalseite verfügbar)
|-
|[https://anverwandte.info/hilfe/webtrees-anleitungen-dokumentation/ Stammbaum "Anverwandte" - Anleitungen und Dokumentation]
|Klemens Miehe
|?
|de / en
|
|
|x
|sehr gute Online-Dokumentation in drei Kapiteln: Personen, Felder, IT
|-
|[https://stammbaum.anverwandte.info/anlagen/anleitung_v1_d.pdf Stammbaum Anverwandte Anleitung]|| Klemens Miehe || 1.3 || de || || || x || 51 reich bebilderte Seiten, gut strukturiert
|-
|[https://alexander-schnapper.de/wp-content/uploads/2020/10/webtrees_manual-de_v1_0_6.pdf Benutzerhandbuch webtrees-Anwendung des Familienstammbaum Schnapper online]
|Alexander Schnapper
|1.7.17
|de
|
|
|x
|21 reich bebilderte Seiten
|-
| [https://hilfe.udmedia.de/installation/wie-installiere-ich-webtrees/ Wie installiere ich webtrees] || UD Media || || de || x || x || || sehr knappe Anleitung für den Hoster UD Media
|-
| [https://web.archive.org/web/20190918220607/https://wiki.webtrees.net/de/Hauptseite webtrees-Wiki] || verschiedene || 1.7 || de || x || x || x || Archiv-Version, sehr umfangreich
|-
| [https://gustine.eu/mode_emploi/ französische Kurzanleitung ]|| gustine || 2.1 || fr || || || x || kurze Anleitung inkl. der auf [https://webtrees.gustine.eu/ webtrees.gustine.eu] verwendeten Erweiterungsmodule
|-
|[https://wiki.huhwt.de/doku.php?id=webtrees HuHwt webtrees wiki]
|Heinrich, Hermann Hartenthaler
|2.0
|de
|x
|x
|
|Wiki vor allem mit Bericht über Installation
|-
|[http://familie-horster.com/ Videotutorials Familie Horster] (siehe Videos/Links)
|Thomas Horster-Möller
|1.7
|de / en
|
|
|x
|5 professionell gemachte Videotutorials
|}

[[Kategorie:Webtrees]]

Webtrees Handbuch/Nutzungserfahrungen

2023-03-14T20:42:22Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Kapitel 10|info=1}}{{WT-Inhaltsverzeichnis|Kapitel 10|A}}

In diesem Kapitel werden Erfahrungen aus der Praxis weitergegeben.

Zum einen wird darauf eingegangen, wie man die Zusammenarbeit mit mehreren Ahnenforschern an einem gemeinsamen Baum am besten organisiert,
und zum anderen wird beschrieben, wie man bei Bedarf im Zusammenspiel mit webtrees auch noch weitere Genealogieprogramme effizient nutzen kann. Und es wird im letzten Abschnitt gezeigt, wie man in webtrees direkt auf der Ebene der GEDCOM-Datensätze Änderungen vornehmen kann, also an der Bedienoberfläche vorbei.

== Zusammenarbeit mehrerer Ahnenforscher ==
Die Unterstützung der Zusammenarbeit mehrerer Forscher ist das hervorstechendste Kennzeichen von webtrees. Während bei anderen Genealogieprogrammen, die auf einem lokalen PC installiert sind, meist nur ein Bearbeiter die Daten erfasst, pflegt und auswertet, können sich bei webtrees mehrere Nutzer, entsprechend der ihnen zugewiesenen Rollen, diese Arbeit teilen und gemeinsam an einem Stammbaum arbeiten. Doppelte Arbeit entfällt und die Qualität kann gesteigert werden, indem mehrere Personen mit ihrem Blick auf die Daten eventuelle Ungereimtheiten entdecken oder fehlende Informationen ergänzen.

Es gibt unterschiedliche Modelle wie eine kollaborative Ahnen- und Familienforschung mit webtrees betrieben werden kann.

=== Modell "Familienforschung" ===
Es gibt viele webtrees Server bei denen es nur einen aktiven Nutzer gibt, der die Daten bearbeitet. Weitere Familienmitglieder können als Nutzer registriert sein, die aber im Wesentlichen die Daten nur betrachten und nicht verändern, da sie sich mit der Thematik "Ahnen- und Familienforschung" nicht so tief beschäftigen wollen.

Familienmitglieder, die auch selber Daten erfassen wollen, sollten in der Rolle "Bearbeiter" angelegt werden; alle übrigen in der Rolle "Mitglied". webtrees sollte so konfiguriert werden, dass Änderungen durch die Bearbeiter nicht sofort wirksam werden, sondern zuvor durch einen "Moderator" freigegeben werden müssen. Also muss mindestens eine erfahrene Person die Rolle "Moderator" oder "Administrator" übernehmen. Die Bearbeitung direkt auf der GEDCOM-Ebene sollte für die Bearbeiter gesperrt werden.

Für die Bearbeiter sollte man in einem FAQ-Beitrag oder in einem anderen Dokument Richtlinien und Hinweise festhalten, die beschreiben wie man verschiedene Dinge handhaben möchte. Etwa

* wie werden Fotos angelegt und benannt
* wie werden Quellen und Archive angelegt
* wo gibt es weiterführende Informationen
* wer kann bei Fragen weiterhelfen.

Man sollte für die Familienmitglieder regelmäßig Neuigkeiten auf der Startseite des Stammbaums verfassen, damit es für sie interessant wird öfters einmal vorbeizuschauen.

=== Modell "Einzelkämpfer" ===
Man kann aber webtrees auch ganz alleine nutzen und das Programm dazu auf einem Server installieren, der nicht mit dem Internet verbunden sein muss. Hier macht das Rollenkonzept von webtrees nicht viel Sinn. Der einzige Bearbeiter ist in der Rolle "Administrator" tätig. Allerdings kann man eventuell auch hier die Funktion "Freigabe von Änderungen durch einen Moderator" aktivieren, wenn man selbst noch nicht so erfahren ist. Wenn man dann Änderungen vornimmt, werden diese nicht mehr gleich wirksam und man hat eine zweite Chance diese Änderungen zu akzeptieren oder zu verwerfen.

Man sollte die Funktion der Forschungsaufgaben nutzen und diese auf der persönlichen Seite einblenden.

=== Modell "Ortsfamilienbuch" ===
Eine weitere Form der Nutzung besteht darin, mit anderen zusammen alle Kirchenbücher eines Ortes gemeinsam zu indizieren und dann in webtrees in einem gemeinsamen Stammbaum zu erfassen.

=== Modell "Verein" ===
Ein anderer Ansatz ist es, für die Mitglieder in einem Verein einen gemeinsam benutzten webtrees-Server bereit zu stellen. Dann kann jedes Vereinsmitglied dort an seinem Stammbaum arbeiten, muss sich aber nicht um die technische Organisation von webtrees kümmern. Die Vereinsmitglieder können sich aber auch zusammentun und gemeinsame Bäume erstellen, wenn sich ihre Interessensgebiete überdecken. Hier bietet es sich an, von vorneherein alle Vereinsmitglieder als webtrees-Administratoren für ihren jeweils eigenen Stammbaum anzulegen.

== Datenaustausch mit anderen Genealogieprogrammen ==
webtrees stellt sehr viele Funktionen bereit, es gibt jedoch auch Merkmale, die in anderen Genealogieprogrammen eventuell besser gelöst sein können. Daher kann es nötig werden, Daten aus webtrees zu exportieren und in einem anderen Programm zu importieren. Auch der umgekehrte Weg kommt vor, wenn Daten in einem PC-Programm gepflegt und zur Präsentation in webtrees transferiert werden. Mit weiteren Programmen lassen sich Daten aus Genealogiediensten, wie Ancestry, MyHeritage oder FamilySearch-FamilyTree extrahieren und in webtrees verwenden. Nach dem Import in einen Stammbaum lassen sich diese Daten mit Daten in bereits vorhandenen Stammbäumen verschmelzen.

{{WT-ToDo|Noch beschreiben: round tripping}}
{{WT-ToDo|Noch beschrieben: Nutzung eines externen Programms für Plausibilitätsprüfungen}}
{{WT-ToDo|Noch beschrieben: Verschmelzen von importierten Daten und Kennzeichnen der neuen Daten mit einer gemeinsamen Quelle}}
{{WT-ToDo|Noch beschrieben: Erstübernahme von Daten aus einem anderen Programm, Nutzung des GEDCOM-Dialekts in webtrees, Überführung der Daten nach GEDCOM- Standard, etwa mit Datafix-Funktionen oder Suchen/Ersetzen, Verwendung der “Fehlersuche“}}

=== Wechsel von TNG zu webtrees ===
* [[Webtrees/TNG_zu_Webtrees|Wechsel]] von [[TNG|'''TNG''']] zu webtrees (bzw. Datenübertrag)
{{WT-ToDo|Dieser veraltete Tipp zum Wechsel von TNG sollte aktualisiert oder gelöscht werden.}}

== Arbeiten auf der GEDCOM-Ebene ==
Im Normalfall sollten alle Daten in einem Stammbaum unter Nutzung der von webtrees bereit gestellten Bedienoberfläche eingegeben und bearbeitet werden. Aber es gibt auch Situationen in denen ein mit GEDCOM vertrauter Nutzer die Daten direkt auf der GEDCOM-Ebene sehen und bearbeiten möchte. webtrees stellt diese Funktion sowohl auf der Ebene der Datensätze (INDI, FAM, OBJE, …) als auch auf der Ebene von Ereignissen oder Fakten (BIRT, DEAT, MARR, …) zur Verfügung.

{{Warnung|Sie sollten diese erweiterte Bearbeitungsoption nicht verwenden, wenn Sie das GEDCOM-Format nicht vollständig verstanden haben. Hier eingegebene Fehler können nur schwer identifiziert und behoben werden.}}[[Datei:WT_2.1_GEDCOM_Rohdaten_bearbeiten.png|thumb|right|400px|Menüpunkt "GEDCOM Rohdaten bearbeiten"]]

Im Menü "Bearbeiten" gibt es bei vielen Datensatztypen die Option "GEDCOM Rohdaten bearbeiten". Teilweise muss man aber auch erst "Bearbeiten" auswählen und dann ganz am Ende des Formulars in einem kleinen Menüblock die Option "GEDCOM Rohdaten bearbeiten" auswählen. Wenn man diese Option wählt, werden bereits gemachte Änderungen im Änderungsformular verworfen und es öffnet sich ein neues Fenster in dem die Elemente des Datensatzes in GEDCOM-Syntax angezeigt werden. Dort können dann alle Werte direkt überschrieben werden (die Identifikation des Elements an sich (z.B. "0 @X162@ _LOC") kann aber nicht geändert werden).
{{-}}
[[Datei:WT_2.1_GEDCOM_Rohdaten.png|thumb|right|400px|Bearbeiten eines Datensatzes auf Basis von GEDCOM]]
Im Kopf der sich öffnenden Seite erfolgt noch ein Warnhinweis und es gibt einen Link zum [https://webtrees.net/downloads/gedcom-5-5-1.pdf GEDCOM-Standard 5.5.1], damit man im Zweifel nachsehen kann, was laut Standard zulässig ist und was nicht. Beim Speichern der Änderungen erfolgt eine einfache Prüfung und falls Fehler vorliegen, wird die entsprechende Sektion mit dem Fehler rot eingefärbt und die Speicherung verweigert.

Die angezeigten Elemente haben links oben einen "Anfasser" mit dem man die Blöcke verschieben kann. So kann man die Reihenfolge der Elemente verändern, etwa um den wichtigsten von mehreren Namen an die erste Stelle zu schieben. Eines der angezeigten Elemente ist komplett leer, so dass man damit auch neue Elemente hinzufügen kann.

{{-}}Wenn man mehrere Änderungen auf GEDCOM-Ebene vorgenommen hat, sollte man als Verwalter oder Administrator den Stammbaum im Verwaltungsmenü auswählen und dort die Funktion "[[Webtrees Handbuch/Anleitung für Verwalter#Fehlersuche|Fehlersuche]]" nutzen.{{WT-ToDo|Noch hinzufügen: zwei Beispiele}}

[[Kategorie:Webtrees]]

Webtrees Handbuch/Genealogischer Prozess

2023-03-14T20:42:12Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Kapitel 11|info=1}}{{WT-Inhaltsverzeichnis|Kapitel 11|A}}

== Ahnen- und Familienforschung ==

[[bild:WT-2_0-de-Ahnenforschung_Prozess_persönlich.png|thumb|left|600px|Individueller Ahnenforschungsprozess]] 
[[bild:WT-2_0-de-Ahnenforschung_Prozess_allgemein.png|thumb|left|600px|Allgemeiner Ahnenforschungsprozess]] 

=== Individuelle Ahnen- und Familienforschung ===
Das Ziel der individuellen Ahnen- und Familienforschung besteht, wie in der ersten Abbildung gezeigt, darin, dass Informationen aus unterschiedlichsten Quellen herausgesucht, gesammelt und ausgewertet werden, um diese dann zu filtern und mit bereits Bekanntem zu verknüpfen und so den Zusammenhang der Verwandtschaft des Ahnenforschers oder etwa auch der ehemaligen Bewohner eines Ortes zu präsentieren. Wenn viele Ahnenforscher dasselbe tun, entstehen viele solcher persönlichen Stammbäume, die sich in einem fortgeschrittenen Grad der Forschung mit den Stammbäumen anderer Forscher überdecken können.

=== Kooperative Ahnen- und Familienforschung ===
Daher liegt es nahe sich mit anderen Forschern auszutauschen oder sogar von vorneherein kooperativ zu arbeiten. Der Ansatz von webtrees liegt darin, genau das zu unterstützen. Mehrere Ahnenforscher können gemeinsam an einem Stammbaum arbeiten. Doppelte Arbeit entfällt und die Qualität kann gesteigert werden, indem mehrere Personen mit ihrem Blick auf die Daten eventuelle Ungereimtheiten entdecken oder fehlende Informationen ergänzen.

Die Zusammenarbeit kann man, wie in der zweiten Abbildung oben gezeigt wird, natürlich noch in einem stärkeren Ausmaß kooperativ betreiben. Zum einen kann eine sehr große Forschergemeinschaft die Quellen viel effizienter erschließen. Anstatt dass jeder einzelne Forscher aus einem alten Kirchenbuch nur diejenigen Einträge heraussucht, die ihn gerade interessieren, ist es auf Dauer sinnvoller, dass etwa ein Kirchenbuch von einer Gruppe von Forschern in einem Zug komplett erfasst und dann allen anderen Forschern zur Verfügung gestellt wird. Solche Crowd-Sourcing-Aktionen laufen seit einigen Jahren sehr erfolgreich, da inzwischen die Zusammenarbeit zwischen engagierten Forschern dank des Internets und der Vielzahl an dort bereit gestellten Anwendungen sehr viel einfacher organisiert werden kann. Es laufen Projekte zur Erfassung der Daten auf allen Grabsteinen weltweit, Kirchenbücher verschiedener Orte werden in Ortsfamilienbüchern erfasst, die deutschen Verlustlisten aus dem Ersten Weltkrieg mit etwa 8,5 Millionen Einträgen wurden von zuletzt etwa 800 Freiwilligen abgeschrieben und so für die Suche durch alle anderen Forscher zugänglich gemacht. Dies sind nur einige wenige Beispiele, so dass man irgendwann in nicht allzu ferner Zukunft erwarten kann, dass ein großer Teil der heute noch erhaltenen Quellen mit Bezug zur Genealogie tatsächlich digital erfasst und dann auch einfach durchsuchbar sein werden.

=== Welt-Familienbäume ===
Zum anderen gibt es derzeit vier größere Aktionen mit dem Ziel, die Ergebnisse der Forschungsarbeit nicht in isolierten Stammbäumen zu präsentieren, sondern an einer zusammengeführten Darstellung zu arbeiten, einem ''"Welt-Familienbaum"''. In den Projekten [https://geni.com Geni], [https://www.familysearch.org/ FamilySearch FamilyTree], [https://www.wikitree.com/ WikiTree] und [https://www.werelate.org/ WeRelate] arbeiten viele tausende Forscher daran, ihre Stammbäume miteinander zu verschmelzen und gemeinsam für eine gute Qualität zu sorgen; ein kooperativer Prozess ähnlich dem, der bei [https://www.wikipedia.de wikipedia] verwendet wird.

Allerdings gibt man bei den Welt-Familienbäumen die eigenen erforschten Daten preis und ist bei der Qualität darauf angewiesen, dass alle anderen Mitwirkenden einen vergleichbaren Standard anstreben.

Daher hat der Ansatz von webtrees einen großen Charme. Zum einen wird die Kooperation mehrerer Ahnen- und Familienforscher unterstützt und zum anderen behält man die volle Hoheit über die Daten. Und man kann im Gegensatz zu den öffentlichen Welt-Familienbäumen auch noch lebende Familienmitglieder erfassen und deren Daten besonders schützen.

=== Detailprozessschritte ===
Der genealogische Prozess hat das Ziel Fragestellungen zu den Ahnen- und Familienmitgliedern aufzustellen und diese dann in einzelnen Behauptungen zu verifizieren oder zu falsifizieren. Dies geschieht auf Basis der vorhandenen Quellen, die gesucht und gesammelt werden müssen. Die Informationen aus den Quellen werden den bereits vorhandenen Informationen zugeordnet und führen dann zu Übereinstimmungen oder Widersprüchen, die bewertet werden müssen, und die so die Behauptungen unterstützen oder sie widerlegen. Die einzelnen Schritte und die Ergebnisse im genealogischen Prozess müssen in einer solchen Form dokumentiert werden, dass sie präsentiert, weiter ausgewertet und archiviert werden können.

webtrees ist ein Genealogieprogramm, das den Genealogen in seinem Arbeitsprozess dabei unterstützt, die Ergebnisse zu dokumentieren und zu archivieren. Die einzelnen Schritte, wie die Erkenntnisse gewonnen worden sind, oder welche Behauptungen bei der Arbeit falsifiziert worden sind, können nur rudimentär, etwa in Notizen, dokumentiert werden. Es gibt einige wenige Genealogieprogramme, die einen anderen Ansatz verfolgen, und die eine "Evidenzbasierte Ahnenforschung" unterstützen<ref>siehe dazu [https://www.compgen.de/2020/11/evidenz-basierte-ahnenforschung-die-aufzeichnung-steht-jetzt-online/ Evidenz-basierte Ahnenforschung]</ref>. Diese Programme unterstützen vor allem die ersten der im Folgenden näher beschriebenen einzelnen Schritte des genealogischen Prozesses, während webtrees als ergebnisorientiertes Genealogieprogramm seinen Schwerpunkt in den beiden letzten Prozessschritten hat.

{{WT-ToDo|Detailprozessschritte beschreiben}}

==== Suchen und Sammeln ====
Ziel ist eine einigermaßen erschöpfende Recherche in allen noch vorhandenen Quellen

==== Zuordnen ====

==== Behaupten und Bewerten ====

==== Präsentieren und Auswerten ====

==== Archivieren ====

== Genealogische Datenstrukturen ==
webtrees ist ein genealogisches Programm, das im Wesentlichen die beiden letzten oben vorgestellten Detailprozesse der genealogischen Arbeit unterstützt

* Präsentieren und Auswerten
* Archivieren.

Erkenntnisse können mit webtrees dokumentiert werden. Das Programm unterstützt die Analyse der erfassten Daten und hilft bei einer konsistenten und vollständigen Erfassung der Informationen und Schlussfolgerungen aus den Quellen. Die Ergebnisse können im Internet für Besucher und Familienmitglieder rollenbasiert und sicher präsentiert werden. Die Daten in webtrees können als GEDCOM-Datei exportiert und so zukunftssicher archiviert werden.

Im Folgenden werden die gängigen Datenstrukturen vorgestellt, die bei der Ahnenforschung von Bedeutung sind. Es wird jeweils gezeigt, wie diese Strukturen mit webtrees erfasst und dargestellt werden können. In diesem Kapitel des webtrees-Handbuchs geht es vor allem darum eine Empfehlung zur Erfassung und Speicherung von genealogischen Daten zu geben. webtrees ist ein sehr tolerantes und flexibles Programm, das auch vom Standard abweichende Umsetzungen unterstützt. Je enger man sich aber an den GEDCOM-Standard 5.5.1 hält, desto einfacher wird der Umstieg nach GEDCOM 7.0 werden und desto leichter kann man Daten mit anderen Forschern austauschen oder verschiedene Genealogieprogramme im Wechsel nutzen. Besonders wenn man die erfassten Daten archivieren und für die Zukunft sicher bewahren möchte ist es sehr sinnvoll sich möglichst eng an den GEDCOM-Standard zu halten. Daher ist in den folgenden Abschnitten ein enger Bezug zu GEDCOM nötig.

=== Personen, Familien und ihre Beziehungen ===
Ein wesentliches Element der Genealogie ist die Beschreibung der Beziehungen zwischen Personen, etwa in Familien.

==== Personen und Familien ====
Personen sind Objekte mit Eigenschaften und zugeordneten Ereignissen (siehe nachfolgende Abschnitte "Fakten" und "Ereignisse"). Familien sind Gruppierungen von solchen Objekten, etwa Partner und ihre gemeinsamen Kinder. Im Normalfall werden die Personen bereits verstorbene oder noch lebende Menschen sein, aber es gibt auch Genealogien zu den griechischen Göttern oder zu den Phantasiefiguren aus Romanen, etwa den Gestalten aus Mittelerde oder aus Harry Potter. webtrees ist auch schon verwendet worden, um Hunde- oder Pferdestammbäume zu dokumentieren.

==== Verwandtschaftsverhältnisse ====
Kern aller Verwandtschaftsverhältnisse<ref>Vgl. {{wikipedia-Link|Verwandtschaftsbeziehung}}</ref> ist die Beziehung zwischen Eltern und ihren Kindern. Dabei unterscheidet man
* Biologische oder genetische Beziehung (leibliche Eltern, sowie Sonderformen wie Spender von Eizellen oder Spermien, Leihmutterschaft)
* Rechtliche oder soziale Beziehung (Adoptiv- oder Pflegekinder, Amme im Islam)

Die zweite elementare Beziehung ist diejenige zwischen zwei Partnern, die innerhalb einer Familie besteht. Auch wenn ein Mann und eine Frau ein gemeinsames Kind haben, ist es sinnvoll diese Beziehung zu erfassen, selbst wenn die beiden Eltern nie zusammengelebt haben. Üblicherweise erfasst man in der Genealogie keine temporären Beziehungen zwischen Menschen, die weder verheiratet waren, noch zu gemeinsamen Kindern geführt haben.

===== Anlegen einer Familie (Eltern, Partner, Kinder) =====
Die Erfassung dieser Beziehungen ist auch in webtrees ein Kernelement und erfolgt im Rahmen der vom GEDCOM-Standard vorgegebenen Möglichkeiten. Ausgehend von einer Person (Proband) kann man auf dem [[Webtrees_Handbuch/Anleitung_für_Besucher#Familien|Reiter „Familien“]] zu dieser Person einen Vater und eine Mutter hinzufügen. Dabei legt webtrees ggf. direkt eine Familie der Eltern mit dem Probanden als Kind an. Wenn man diesen Schritt dann für den Vater und die Mutter wiederholt, baut man Generation um Generation den Stammbaum des Probanden auf.

{{WT-ToDo|kurze Darstellung ergänzen: wie ist ein INDI und ein FAM-Datensatz in GEDCOM aufgebaut}}{{WT-ToDo|beschreiben wie man in webtrees einen Probanden als erste Person eines Stammbaums anlegen kann}}

Wenn man die Geschwister eines Probanden kennt, aber nicht die gemeinsamen Eltern, kann man zum Probanden ein Elternteil (ohne Namen) hinzufügen. Zu der dadurch erstellten Elternfamilie kann man dann die Geschwister hinzufügen. Je nach Wunsch kann man danach auch das hinzugefügte Elternteil auch wieder löschen.

Ebenfalls auf dem Reiter „Familie“ hat man die Möglichkeit zum Probanden einen Partner hinzuzufügen. Dadurch wird in webtrees automatisch eine „Familie“ mit den beiden Partnern angelegt, die – je nach Konfiguration – in der rechten Seitenleiste im [[Webtrees_Handbuch/Anleitung_für_Besucher#Familienlotse|Familienlotsen]] angezeigt wird. Auf Grund der Beschränkungen des GEDCOM-Standards haben Familien immer zwei Partner (oder bei unbekanntem zweitem Partner auch nur ein Elternteil); Dreierbeziehungen etwa lassen sich also nicht modellieren, wohl aber gleichgeschlechtliche Paarbeziehungen. Wenn die beiden Partner verheiratet sind, fügt man der Familie ein Heiratsereignis hinzu. Der Standard bei webtrees ab Version 2.0 ist die Annahme, dass die Partner in einer Familie unverheiratet sind. Daher muss ein entsprechendes Ereignis für jegliche Form von Verpartnerung immer hinzugefügt werden, falls vorhanden.

Wenn man Kinder zu einer Familie ergänzen möchte, ist der einfachste Weg in webtrees, auf der Seite unterhalb des [[Webtrees_Handbuch/Anleitung_für_Bearbeiter#Familien-Datens.C3.A4tze|Reiters „Familie“]] auf die Überschriftenzeile der Familie zu klicken; dann öffnet sich die korrespondierende Familienseite mit einem Sanduhrdiagramm, das Optionen zur Ergänzung von Kindern zu dieser Familie anbietet. Wenn man die Schritte „Partner hinzufügen“ und „Kinder hinzufügen“ wiederholt, baut sich Generation um Generation die Nachkommenschaft des Probanden auf. Wenn man auch zu den Vorfahren des Probanden deren Nachkommen im Stammbaum ergänzt, bauen sich die Seitenlinien auf.

===== Blutsverwandtschaft und Verschwägerungsbeziehungen =====
Bei der Blutsverwandtschaft<ref>Vgl. {{wikipedia-Link|Blutsverwandtschaft}}</ref> unterscheidet man die direkten Linien und die Seitenlinien. Für den Probanden gehören zur direkten Linie (lineare Verwandtschaft) Nachkommen (Kinder, Enkelkinder, ...) und Vorfahren (Eltern, Großeltern, ...). Zu den Seitenlinien (kollaterale Verwandtschaft) gehören die Geschwister der direkten Vorfahren sowie deren Nachkommen.

Hat man alle direkten Linien und Seitenlinien weitgehend erforscht, wird man kaum noch weiterkommen, weil keine Aufzeichnungen und Dokumente mehr gefunden werden ([[Toter_Punkt|tote Punkte]] in der Ahnenforschung). Spätestens dann setzt man seine Arbeit bei angeheirateten Familienangehörigen fort und dokumentiert so auch Verschwägerungsbeziehungen<ref>Vgl. {{wikipedia-Link|Schwägerschaft}}</ref>.

Die biologische Vaterschaft konnte vor allem in der Vergangenheit nicht sicher überprüft werden. Daher kam es durchaus auch zu sogenannten „Kuckuckskindern“<ref>{{wikipedia-Link|Kuckuckskind}}</ref>. Am besten hält man sich an die Beziehungen von Eltern zu ihren Kindern, wie sie in Quellen dokumentiert sind. Sofern Zweifel bestehen, können in den Notizen Hinweise darauf ergänzt werden.

==== Verwandtschaftssysteme ====
Verwandtschaftssysteme<ref>Vgl. {{wikipedia-Link|Verwandtschaftssystem}}</ref>, die auf der Abstammung, der Deszendenz, beruhen, sind für viele Gesellschaften die wichtigste soziale Zugehörigkeitsgruppe. Es werden zwei grundlegende Formen unterschieden, die in unterschiedlichen Kulturen vorkommen: unilineare und bilineare Abstammungsformen.
===== Unilineare Verwandtschaftssysteme =====
Bei unilinearen Verwandtschaftssystemen wird die Zugehörigkeit zu einer Abstammungsgruppe (Clan, Sippe) entweder nur durch die Mutter (weibliche Linie, matrilinear<ref>Vgl. {{wikipedia-Link|Matrilinearität}}</ref>) oder nur durch den Vater (männliche Linie, patrilinear<ref>Vgl. {{wikipedia-Link|Patrilinearität}}</ref>) bestimmt.

===== Bilineare Verwandtschaftssysteme =====
In bilinearen Abstammungsformen wird die Zugehörigkeit zu einer bestimmten Verwandtschaftsgruppe nach beiden Abstammungslinien gerechnet. Hier wird unterschieden zwischen ambilinearen und kognatischen Abstammungsformen.
* Bei ambilinearen Verwandtschaftssystemen wird das Kind je nach sozialem Kontext der Linie des Vaters oder der Linie der Mutter zugerechnet. Zum Beispiel wird in großen Teilen des europäischen Judentums die Zugehörigkeit zu diesem über die Mutterlinie vermittelt, die Zugehörigkeit zur Einzelfamilie aber über die Vaterlinie.
* Kognatische Verwandtschaftssysteme hingegen rechnen die Kinder gleichzeitig zur Abstammungslinie der Mutter und des Vaters. Bilineare, kognatische Verwandtschaftssysteme tauchen in Kulturen auf, deren sozialer Zusammenhalt nicht primär auf einem Verwandtschaftsnetz oder permanenten Verwandtschaftsgruppen basiert. So beispielsweise in den postindustriellen Gesellschaften, in denen die kindzentrierte Kernfamilie die kleinste soziale Einheit darstellt.

===== Bezeichnung des Verwandtschaftsverhältnisses =====
Die Art der Bezeichnung des Verwandtschaftsverhältnisses zwischen zwei Personen ist kulturell sehr unterschiedlich. Es gibt dafür (nach George P. Murdock<ref>{{Wikipedia-Link|Verwandtschaftssystem#Sechs_Verwandtschaftssysteme_nach_Murdock}}</ref>) weltweit sechs verschiedene größere Bezeichnungssysteme: Eskimosystem, Hawaiisches System, Irokesensystem, Crowsystem, Omahasystem und Sudanesisches System. Inzwischen wurde ein weiteres, siebtes, System identifiziert.

Da webtrees (dem GEDCOM-Standard folgend) nur das bilineare, kognatische Eskimosystem unterstützt, wird im folgenden Abschnitt nur auf dieses eingegangen.

====== Eskimosystem ======
In Europa und Nordamerika wird üblicherweise das Eskimosystem verwendet. Als bilineares, kognatisches Verwandtschaftssystem unterscheidet es nicht zwischen mütterlicher und väterlicher Linie; eine Tante etwa kann die Schwester der Mutter oder die Schwester des Vaters sein, weswegen bei der Notwendigkeit einer genaueren Beschreibung zu Hilfskonstruktionen wie „Großvater mütterlicherseits“ zurückgegriffen werden muss.

Das Eskimosystem betont die Kernfamilie, indem es die Eltern und Geschwister sehr genau unterscheidet (es gibt nur eine Mutter und nur einen Vater), aber bei entfernteren Verwandten sehr ungenau wird. Diese Ungenauigkeit geht sogar so weit, dass in einigen Sprachen, in denen das System verwendet wird, nicht einmal zwischen dem Geschlecht der Kinder der Geschwister der Eltern unterschieden wird. So gibt es im Englischen nur ein Wort für Cousine und Cousin bzw. Vetter und Base (alternative deutsche Worte), nämlich „Cousin“. Der Satz "My Cousin lives in London." sagt also weder aus, ob die bezeichnete Person männlich oder weiblich ist, noch ob sie das Kind eines Bruders oder einer Schwester eines Elternteils ist, noch aus welcher Elternlinie die Person abstammt.

Die Verwandtschaftsbezeichnung wird beim Eskimosystem durch die Entfernung (erster, zweiter, dritter Grad, etc.) und den Generationenunterschied bestimmt. Die Entfernung wird durch die Anzahl der vorhergehenden Generationen bis zum ersten gemeinsamen Vorfahren bestimmt. Wenn etwa zwei Personen derselben Generation gemeinsame Urgroßeltern (drei Generationen zurück) haben, heißt ihr Verwandtschaftsverhältnis "Cousin zweiten Grades". Der Generationenunterschied ist die Anzahl der Generationen, die zwei Personen trennt. Zur Kennzeichnung des Unterschieds werden die Standardvorsilben "Groß-" für eine Distanz von zwei Generationen und "Urgroß-" für drei Generationen verwendet. Wenn die andere Person, deren Verwandtschaftsverhältnis beschrieben werden soll, zu einer vorhergehenden Generation gehört, wird das Verwandtschaftsverhältnis als Onkel bzw. Tante bezeichnet. Wenn diese Person aus einer nachfolgenden Generation stammt, dann wird dies als Neffe bzw. Nichte bezeichnet. Für Neffe und Nichte wird die Entfernung um einen Grad erhöht. Zum Beispiel ist der Vater eines "Cousin zweiten Grades", der "Onkel zweiten Grades" einer betrachteten Person. Der Urenkel eines "Cousin zweiten Grades", ist der "Urgroßneffe dritten Grades" des Probanden.

In webtrees gibt es ein [[Webtrees Handbuch/Anleitung für Besucher/Diagramme Vergleichstabelle|Diagramm]] „Beziehungen“ mit dem sich die Verwandtschaftsverhältnisse zwischen zwei Personen grafisch darstellen lassen. Dort wird auch eine textuelle Bezeichnung des Verwandtschaftsverhältnisses angezeigt, das der oben beschriebenen Systematik folgt.

{{WT-ToDo|Beispielgrafik mit einer Beziehung zu einem Großneffen oder ähnlichem einfügen}}

==== Nicht-genetische Beziehungen in Familien ====
Neben den Familienmitgliedern auf Grund einer biologischen oder genetischen Beziehung gibt es auch Familienmitglieder aus sozialen oder auf Grund von rechtlichen Beziehungen, so etwa Pflege- oder Adoptivkinder.
{{WT-ToDo|Anlegen von nicht-genetischen Beziehungen (etwa Adoptiv- oder Pflegekinder) genauer beschreiben}}

==== Nicht-familiäre Beziehungen zwischen Personen ====
Neben den familiären Beziehungen zwischen Beziehungen gibt es auch noch weitere Beziehungen, die dargestellt werden können. Bei Ereignisse wie Taufen oder bei einer Heirat sind etwa Taufzeugen oder Trauzeugen mit anwesend und auch in Quellen verzeichnet. Die Beziehungen zu diesen Personen können Hinweise auf entfernte Verwandte geben oder auch auf Nachbarn in einem Dorf. Wenn solche Zeugen eindeutig identifiziert werden können, lassen sich auch weitere Rückschlüsse ziehen, etwa wer zum Zeitpunkt eines Ereignisses gelebt hat. Neben Zeugen können auch Beziehungen zu Freunden, Nachbarn, Vermieter/Mieter, Arbeitgeber/Mitarbeiter, Verkäufer/Käufer und vieles mehr dokumentiert werden.

{{WT-ToDo|Beschreiben wie das in webtrees aussieht; Hinweis auf ASSO und _ASSO.}}

{{Wichtig|Vorschläge zur optimalen Datenerfassung von Personen und ihren Beziehungen mit dem Ziel, eine qualitative und standard-gerechte Erfassung zu erreichen 
- tbd}}

=== Namen ===
Namen sind ein wichtiges Element in der Genealogie, um Personen zu identifizieren. Sie sind aber nicht eindeutig.

* Es gibt unterschiedliche Personen, die denselben Namen tragen und zur selben Zeit in der gleichen Gegend lebten.

* Es gibt identische Personen, welche mit unterschiedlichen Namen oder Namensschreibweisen in verschiedenen Quellen verzeichnet sind.

webtrees unterstützt die Vergabe von mehreren Namen für eine Person, wobei der erste Name unter sonst gleichrangigen Namen der bevorzugte Name ist, wenn es darum geht für die Darstellung in einer Liste oder in einer Grafik genau einen Namen auszuwählen. Die Reihenfolge der Namen kann in webtrees über eine Bearbeitungsfunktion geändert werden.

In GEDCOM werden Namen von Personen mit dem Kennzeichen [[GEDCOM/NAME-Tag|NAME]] gekennzeichnet. Ein einfaches Beispiel: „Maria Julia Meier“ wird in dieser Form in ihrem Taufbucheintrag bezeichnet. Sie heiratet einen „Georg Schulze“ und heißt von da an „Maria Schulze“. In der Genealogie ist es üblich, nur den Geburtsnamen als Namen zu erfassen. In den Angaben zu dieser Person wird in der GEDCOM-Datei dann stehen:

<code>1 NAME Maria Julia /Meier/</code>

<code>2 GIVN Maria Julia</code>

<code>2 SURN Meier</code>

In webtrees wird man die Vornamen<ref>{{wikipedia-Link|Vorname}}</ref> und den Nachnamen<ref>{{wikipedia-Link|Nachname}}</ref> in den dafür vorgesehenen, getrennten Eingabefeldern erfassen. Dabei sollte die Groß-/Kleinschreibung so erfolgen, wie sie in offiziellen Quellen erfolgt (etwa „O'Hartigan“ oder „MacNamara“). Eine generelle Großschreibung der Nachnamen sollte unterbleiben. Die zugehörige mehrzeilige NAME-Struktur wird dann von webtrees automatisch erstellt und gespeichert. Wenn man in webtrees nach dem Ehenamen sucht, also nach „Maria Schulze“, wird auch dieser Eintrag gefunden, da es eine implizite Regel gibt, dass Frauen bei der Suche auch unter dem Namen ihres Partners gefunden werden.

==== Namen im Laufe eines Lebens ====
Der Name einer Person kann sich, wie oben erwähnt, im Laufe des Lebens ändern, etwa verknüpft mit Ereignissen wie Eheschließung, Adoption oder Umzug in einen anderen Sprachraum. GEDCOM kennt aber keine Datumsangaben oder Ereignisse, die einem Namen zugeordnet werden, sondern nur Typen von Namen. Wenn man keinen Namenstyp angibt, ist das immer der Geburtsname, also der Name der in einem engen zeitlichen Zusammenhang mit der Geburt vergeben worden ist. Alle im Laufe eines Lebens erhaltenen Namen sind grundsätzlich gleichwertig. Wenn beispielsweise „Maria Julia Meier“, verheiratete „Schulze“, geschieden wurde und dann „Gustav Schindler“ geheiratet hat, kann das so aussehen:

<code>1 NAME Maria Julia /Meier/</code>

<code>2 TYPE BIRTH</code>

<code>1 NAME Maria /Schulze/</code>

<code>2 TYPE MARRIED</code>

<code>1 NAME Maria /Schindler/</code>

<code>2 TYPE MARRIED</code>

Wie bereits oben erwähnt, ist die Erfassung der Namen durch Eheschließung nicht zwingend notwendig, wenn eine Frau den Namen des Ehemanns angenommen hat. Falls "Frau Meier" bei der Heirat einen Doppelnamen etwa „Meier-Schulze“ gewählt hat, sollte man diese Besonderheit in einem zweiten Namenseintrag mit dem Typ "Ehename" erfassen. Das kann dann so aussehen:

<code>1 NAME Maria Julia /Meier/</code>

<code>2 GIVN Maria Julia</code>

<code>2 SURN Meier</code>

<code>1 NAME Maria Julia /Meier-Schulze/</code>

<code>2 TYPE MARRIED</code>

<code>2 GIVN Maria Julia</code>

<code>2 SURN Meier-Schulze</code>

Wenn „Maria“ in der Zeit zwischen der Scheidung und der Wiederheirat ihren Mädchennamen getragen haben sollte, kann man das mit dem [[GEDCOM/NAME-Tag|NAME]]-Kennzeichen nicht darstellen. Hier bietet es sich an, beim Scheidungsereignis eine Notiz anzulegen in der beschrieben wird, welchen Namen „Maria“ nach der Scheidung getragen hat. Ergänzend oder alternativ kann man aber auch zu jeder Namensänderung eine nutzerdefinierte Tatsache zur Beschreibung wählen und dazu ein FACT-Kennzeichen für die Person anlegen..

<code>1 FACT</code>

<code>2 TYPE NAME CHANGE</code>

<code>2 DATE FROM 1 JAN 2000 TO 1 FEB 2020</code>

<code>2 NOTE Nach der Scheidung von Schulze trug Julia bis zur Heirat mit Schindler ihren Geburtsnamen "Meier"</code>

Offizielle Namensänderungen, etwa nach einer Geschlechtsumwandlung, müssen auf jeden Fall durch eine solche Beschreibung formuliert und entsprechend kommentiert werden.

Wenn Sie GEDCOM-Daten aus anderen Programmen in webtrees importieren, kann es vorkommen, dass dort die Namen nach einer Heirat unter dem benutzerspezifischen Kennzeichen _MARNM stehen:

<code>1 NAME Maria Julia /Meier/</code>

<code>2 _MARNM Maria Julia /Schulze/</code>

Solche Konstruktionen sollten Sie in standardkonformes GEDCOM konvertieren ohne die Verwendung des Kennzeichens _MARNM, indem Sie als Verwalter die entsprechende Datenkorrekturfunktion "[[Webtrees_Handbuch/Anleitung_für_Verwalter#Datenkorrekturen|INDI:NAME:_XXX-Kennzeichen in GEDCOM 5.5.1 konvertieren]]" ausführen. Danach wird der Eintrag so aussehen:

<code>1 NAME Maria Julia /Meier/</code>

<code>1 NAME Maria Julia /Schulze/</code>

<code>2 TYPE MARRIED</code>

{{Infobox|Während wir etwa im deutschen Namensrecht<ref>{{wikipedia-Link|Namensrecht}}</ref> auch so etwas wie einen Ehenamen kennen, gibt es etwas Entsprechendes in GEDCOM und damit auch in webtrees nicht. Bei der Heirat etwa kann festgelegt werden, welche Nachnamen die Ehepartner in der Ehe führen (z.B. unter Nutzung von Doppelnamen) und welchen Nachnamen eventuelle Kinder erhalten werden, das ist der Ehenamen. Eine solche Vereinbarung kann in webtrees nur in einer Notiz zum Heiratsereignis festgehalten werden.}}

==== Konzepte zur Namensgebung ====
Die Konzepte zur Namensgebung sind stark abhängig von der Zeit und der Kultur, in der sie verwendet werden. Im deutschen Sprachraum hat sich seit dem 12. Jahrhundert ein zweigliedriges Namensystem mit einem Individualnamen (Vorname, Rufname) und einem Familiennamen (Beiname, Nachname, Zuname) entwickelt. In anderen Ländern gibt es auch andere Namensysteme. In Russland zum Beispiel verwendet man ein dreigliedriges Namensystem mit einem Patronym zwischen Vorname und Familienname, d.h. ein Hinweis auf den Vornamen des Vaters. So ist etwa bei „Alexander Sergejewitsch Puschkin“ der Namensbestandteil „Sergejewitsch“ das Patronym, d.h. er ist ein Sohn des „Sergej“. In Island verwendet man nur in Ausnahmefällen Familiennamen, hier sind Patronyme bis heute offizieller Nachname. Die Bildung erfolgt dabei durch die Endung „-son“ bzw. weiblich durch „–dóttir“.

Im europäischen Kulturraum ist die Reihenfolge „Vornamen Nachname“ vorherrschend, in China und einigen weiteren Ländern im asiatischen Raum ist die Reihenfolge aber umgekehrt. webtrees unterstützt etliche solcher Namensysteme; das wirkt sich dann aus, wenn man zu einem Ehepaar neue Kinder anlegt: Entsprechend der vom Verwalter für einen Baum als bevorzugt ausgewählte Nachnamens-Tradition (siehe [[Webtrees_Handbuch/Anleitung_für_Verwalter#Einstellungen|Stammbaum-Einstellungen]]) sind dann die entsprechenden Felder in der Maske zur Erfassung des Namens passend vorbelegt. Und der zusammengesetzte Name im Kennzeichen [[GEDCOM/NAME-Tag|NAME]] wird passend gebildet; etwa wird der Eintrag für Mao Zedong so aussehen (in latinisierter Form):

<code>1 NAME /Mao/ Zedong</code>

<code>2 GIVN Zedong</code>

<code>2 SURN Mao</code>

Wenn ein Name vom ausgewählten Standardkonzept abweicht, müssen die vorbelegten Namensfelder in der Eingabemaske von webtrees manuell entsprechend abgeändert werden.

==== Alternative Schreibweisen des Namens einer Person ====
Die Schreibweise von Namen variiert im Laufe der Zeit; oft wurden Namen etwa von einem Pfarrer in einem Kirchenbucheintrag so geschrieben, wie er den Namen akustisch verstanden hat; der Bezeichnete war oftmals des Lesens nicht mächtig und konnte so nicht korrigierend eingreifen. Oder latinisierende Formen wie „Carolus“ stehen zwar im Kirchenbuch, wurden aber im Alltag zu „Karl“. In solchen Fällen empfiehlt es sich, einer Person mehrere Namen zuzuordnen und die bevorzugte Version als erste aufzuführen. Bei der Eingabe der alternativen Namen sind jeweils alle Namensbestandteile erneut aufzuführen. Das kann dann so aussehen:

<code>1 NAME Karl /Mayer/</code>

<code>1 NAME Carolus /Maier/</code>

Ein anderer Grund alternative Schreibweisen eines Namens zu erfassen, kann darin liegen, dass Namen in einigen Sprachen grammatikalisch gebeugt werden. In der tschechischen Sprache etwa wird die Mutter des (unehelich geborenen) Michal Kolovratník einen gebeugten Namen tragen: Helena Kolovratníková. Auch in Österreich und Teilen von Süddeutschland war es bis in die Neuzeit üblich an den Nachnamen einer Frau ein „in“ anzuhängen, d.h. „Maria Hartenthaler“ kann in Quellen auch „Maria Hartenthalerin“ genannt werden.

webtrees sortiert in einigen Listen Personen nach ihren Nachnamen; damit nun beide Personen, Sohn und Mutter, zusammen sortiert werden, sollte man den Inhalt des zum Sortieren verwendeten GEDCOM-Kennzeichens SURN vereinheitlichen. Das könnte dann so aussehen:

<code>0 INDI @X1@</code>

<code>1 NAME Michal /Kolovratník/</code>

<code>2 GIVN Michal</code>

<code>2 SURN Kolovratník</code>

<code>0 INDI @X2@</code>

<code>1 NAME Helena /Kolovratníková/</code>

<code>2 GIVN Helena</code>

<code>2 SURN Kolovratníková, Kolovratník</code>

Hinter dem Kennzeichen [[GEDCOM/NAME-Tag|SURN]] kann man also auch eine Liste von Nachnamen angeben. In solchen Fällen muss man aber als Bearbeiter selbst darauf achten, dass das Kennzeichen [[GEDCOM/NAME-Tag|NAME]] richtig befüllt wird, da der ansonsten aktive Automatismus von webtrees zur Synchronisation des NAME-Kennzeichens und der Unterkennzeichen in diesem Sonderfall deaktiviert wird.

Die im Kennzeichen [[GEDCOM/NAME-Tag|NAME]] gewählte Form des Namens wird immer zur Anzeige verwendet; die Angaben in [[GEDCOM/NAME-Tag|GIVN]] und [[GEDCOM/NAME-Tag|SURN]] dienen nur internen Sortier- oder Selektionszwecken.

==== Vornamen ====
Der Vorname einer Person ist der Teil des Namens, der nicht die Zugehörigkeit zu einer Familie ausdrückt, sondern diese Person individuell identifiziert. Häufig bekommt eine Person auch mehrere Vornamen. Dies kann dazu führen, dass die Darstellung des Namens in Tabellen und Grafiken sehr lang wird; es bietet sich in solchen Fälle an, zwei Geburtsnamen anzulegen: einen vollständigen und einen nur mit dem oder den gebräuchlichen Vornamen.

===== Mittelnamen =====
Im anglo-amerikanischen Sprachraum sind Zwischennamen gebräuchlich, die auch Mittelnamen<ref>{{wikipedia-Link|Mittelname}}</ref> (middle names) genannt und meistens mit dem Anfangsbuchstaben abgekürzt werden (middle initials). Ein Beispiel ist hier „John F. Kennedy“ oder auch „John Fitzgerald Kennedy“; wobei Fitzgerald der Nachname seiner Mutter ist. Auch im Ostfriesischen gibt es Zwischennamen. Solche Mittelnamen werden wie weitere Vornamen erfasst.

===== Rufnamen =====
Nicht immer wird der erste Vorname auch im Alltag verwendet, auch einer der anderen Vornamen kann der gebräuchliche sein. In Deutschland bezeichnet man als Rufnamen<ref>{{wikipedia-Link|Rufname_(Deutschland)}}</ref> den- oder diejenigen Vornamen, unter denen eine Person tatsächlich angesprochen wird. Etwa bei der Heirat kann der Rufname durchaus als einziger Vorname im Kirchenbuch auftauchen, was häufig eine eindeutige Identifikation der Person erschwert. In manchen Standesamtdokumenten ist der Rufname dadurch gekennzeichnet, dass einer der Vornamen unterstrichen wurde.

Häufig wurden Mädchen mit dem ersten Vornamen „Maria“ getauft, zur Verwendung als Rufname kam dann aber der zweite Vorname, da Maria ein sehr häufiger und daher kaum zur Unterscheidung dienender Vorname war.

Eine andere Tradition war, dass männliche Nachkommen einer Familie immer wieder denselben ersten Vornamen bekamen, dieser also nicht zur Unterscheidung der Söhne dienen konnte, so dass einer der weiteren Vornamen als Rufname verwendet wurde.

Zur Auszeichnung von Rufnamen, die nicht mit dem ersten Vornamen identisch sind, kann man in webtrees zwei Methoden verwenden

* An den Rufnamen wird ein Stern-Zeichen angehängt, damit der Name unterstrichen dargestellt wird.
* Das nutzerspezifische GEDCOM-Kennzeichen [[GEDCOM/NAME-Tag|_RUFNAME]] wird verwendet.

Das kann dann folgendermaßen aussehen:

<code>1 NAME Johann Gustav* /Maier/</code>

<code>2 GIVN Johann Gustav</code>

<code>2 SURN Maier</code>

<code>2 _RUFNAME Gustav</code>

In webtrees ist es auch möglich, einen Stern an mehrere Namensbestandteile anzuhängen, die dadurch alle unterstrichen dargestellt werden.

<code>1 NAME Albert Hans* Jürgen* /Rheinfeld genannt Schaffgotsch*/</code>

===== Spitznamen und Koseformen =====
Manchmal hat sich für eine Person auch ein Spitzname<ref>{{wikipedia-Link|Spitzname}}</ref> herausgeprägt unter dem die Person allgemein bekannt ist. Ein solcher Spitzname ist ein Ersatzname für den realen Namen der Person und wird deshalb in der Genealogie häufig miterfasst. webtrees erlaubt das und verwendet das dafür vorgesehene GEDCOM-Kennzeichen NICK. Der Spitzname kann bei webtrees hinter den Vornamen im Namen dargestellt werden und wird durch Anführungszeichen gekennzeichnet. Ein Beispiel ist der „Bergsepp“ genannte Josef Baumgärtner (auf dem Berg lebende Sepp):

<code>1 NAME Josef /Baumgärtner/</code>

<code>2 GIVN Josef</code>

<code>2 NICK Bergsepp</code>

<code>2 SURN Baumgärtner</code>

Die Darstellung durch webtrees in Tabellen und Grafiken wird dann, abhängig von der Konfiguration, so lauten: ''Josef „Bergsepp“ Baumgärtner''.

Meistens werden Spitznamen nicht bereits ab der Geburt einer Person verwendet, so dass diese eigentlich nicht in den Datensatz mit dem Geburtsnamen gehören, sondern in einen eigenen zusätzlichen Namensdatensatz.

Da es Genealogieprogramme gibt, die die Namensteile wie NICK nicht auswerten, kann man Spitznamen auch direkt im NAME-Kennzeichen unterbringen, etwa:

<code>1 NAME Josef "Bergsepp" /Baumgärtner/</code>

Gebräuchliche Vornamen werden aus verschiedenen Gründen manchmal zu Koseformen<ref>{{wikipedia-Link|Diminutiv}}</ref> abgekürzt oder verfremdet, etwa um eine besondere Nähe zu dieser Person auszudrücken. Koseformen und Spitznamen sind sich naturgemäß nahe und daher oft kaum zu unterscheiden. Daher empfiehlt es sich Koseformen im Feld für Spitznamen zu erfassen.

==== Familiennamen ====
Ein Familienname<ref>{{wikipedia-Link|Familienname}}</ref> dient als Ergänzung zum Vornamen der besseren Unterscheidbarkeit von Personen. Die Kombination aus Vornamen und Nachnamen macht einen Namen in seiner Gesamtheit individueller und einzigartiger. Soziologisch-historisch wird mit dem Familiennamen die Zugehörigkeit einer Person zu einer familiären Gemeinschaft ausgedrückt. Der Geburtsname drückt die Zugehörigkeit zur Elternfamilie aus.

Während der deutsche Adel seit der Erblichkeit der Lehen im Jahr 1037 (''Constitutio de feudis''<ref>{{wikipedia-Link|Constitutio_de_feudis}}</ref>) feste Familiennamen trug, um seine Erbansprüche geltend machen zu können, folgten erst später die Patrizier und Stadtbürger. Der Familienname hatte bis ins 18. Jahrhundert hinein zumeist nur untergeordnete Bedeutung, während der Rufname der eigentliche Name blieb. In bäuerlichen Gegenden kam man bis zum 17. oder 18. Jahrhundert meist ohne einen festen Familiennamen aus, in Friesland wurde er beispielsweise erst im 19. Jahrhundert gesetzlich eingeführt.

Es gibt auch heute noch Personen, die keinen Nachnamen tragen, so etwa "König Charles III.". In diesem Fall entfällt der Nachnamenteil in der GEDCOM-Notation komplett. Das Erfassungsergebnis könnte dann in etwa so aussehen:

<code>1 NAME Charles III</code>

<code>2 GIVN Charles Philip Arthur George</code>

===== Hausnamen =====
Hausnamen entstanden insbesondere im ländlichen und dörflichen Raum. Sie waren vor Einführung der Hausnummern die einzige eindeutige Kennzeichnung eines Anwesens. In Deutschland und Österreich sind in nahezu allen ländlichen Regionen die traditionellen Hausnamen noch in Gebrauch, besonders in den älteren Ortsteilen. Die Bewohner eines Anwesens werden dort umgangssprachlich teilweise nicht mit ihrem Familiennamen bezeichnet sondern mit ihrem Hausnamen, der dem Vornamen jeweils vorangestellt wird. Wohnt beispielsweise „Maria Baur“ auf dem Anwesen oder Hof mit dem Namen „Gallauer“, wird sie „Gallauer Maria“ genannt.

Ein Hausname ist in Kirchenbüchern oder anderen Dokumenten zu erkennen an Zusätzen wie: „vulgo“, „modo“, „vel“, „alias“ oder „genannt“ und ähnlichen, regional unterschiedlichen Formulierungen. In manchen Regionen war die Bindung des Namens an den Hof so stark, dass der wirkliche Name eines Bauern völlig dahinter zurücktrat und verlorenging, ohne dass dies in Kirchenbüchern oder anderen Dokumenten mit einem der Zusätze dokumentiert ist. Im Rheinland endete diese Sitte 1798 mit Einführung der Personenstandsregister durch die französische Verwaltung. Hier durfte nur noch der Name geführt werden, der bei der Geburt ins Kirchenbuch eingetragen worden war. In Preußen galt dies ab 1816.

Hausnamen sollten, wenn sie erkennbar sind, in einem zusätzlichen Namen mit dem Typ „AKA“ („auch bekannt als“) erfasst und ggf. mit einer Notiz erläutert werden.

===== Titel, Adelsnamen, Übernahmen und weitere Namensbestandteile =====
Ein Namenszusatz kann ein im Laufe des Lebens erworbener akademischer Grad wie „Dr.“ oder ein verliehener Titel wie „Kammersänger“ sein, der dem Namen voran- oder nachgestellt wird. Akademische Grade und verliehene Titel sind nach aktuellem Recht in Deutschland und Österreich keine Bestandteile des Familiennamens. Es gibt (mindestens) drei Arten von Titeln:

* akademische Titel wie "Dr.", oder "PhD", oder "Bachelor", oder "Master", oder "Dr. Dr. (hc)", ...
* Berufs- oder Ordenstitel wie "General", "Reverend", "Bruder" oder "Kammersänger" (von solchen offiziellen Titeln gibt es noch einige in Deutschland und viele in Österreich)
* Kaiserliche, königliche und adelige Standestitel wie "König von ...", "Prinz", "Freiherr", ...

Im Personalausweis und im Pass kann ein Doktorgrad im Feld Familienname eingetragen werden, dennoch ist "Dr." ein Titel und kein Teil des Namens. webtrees unterstützt die Erfassung von akademischen Graden und anderen Formen von Titeln im GEDCOM-Kennzeichen [[GEDCOM/TITL-Tag|TITL]], etwa in der Form:

<code>1 NAME Hans /Six/</code>

<code>2 GIVN Hans</code>

<code>2 SURN Six</code>

<code>1 TITL Dr.</code>

Berufsbezeichnungen wie etwa „Filialdirektor“ gehören nicht in die Namensfelder oder das Titelfeld, sie müssen im GEDCOM-Kennzeichen [[GEDCOM/OCCU-Tag|OCCU]] abgelegt werden. Bei „Prof.“ kann es sich um einen verliehenen Titel oder eine temporäre Amtsbezeichnung handeln, dies muss also entweder im Kennzeichen [[GEDCOM/TITL-Tag|TITL]] oder im Kennzeichen [[GEDCOM/OCCU-Tag|OCCU]] gespeichert werden.

Adelstitel, wie etwa „König von …“ werden nicht als Namensbestandteil betrachtet. Für solche Titel wird ebenfalls das GEDCOM-Kennzeichen [[GEDCOM/TITL-Tag|TITL]] verwendet. Solche Adelstitel können auch mit einem Zeitraum als Attribut versehen werden, denn die Adelstitel wurden zu einem definierten Zeitpunkt verliehen, wurden ggf. vererbt, und konnten auch wieder entzogen werden. Die Sprache in der ein Titel erfasst wird, sollte sich nach der Sprache richten, die der Träger vor allem verwendet hat, also zum Beispiel „König von Bayern“ und „King of Scotland“. Man kann aber natürlich auch mehrere Titel-Einträge hinterlegen.

Von den akademischen Graden und den Titeln werden Adelsnamen und Zusätze wie etwa das Adelsprädikat „von“ unterschieden. In Artikel 109 WRV (Weimarer Reichsverfassung vom 11. August 1919<ref>{{Wikipedia-Link|Weimarer_Verfassung}}</ref>) wird bestimmt, dass die Vorrechte oder Nachteile der Geburt oder des Standes aufzuheben sind. Adelsbezeichnungen gelten ab diesem Zeitpunkt nicht mehr als zusätzliche Teile des Namens und dürfen auch nicht mehr verliehen werden. Personen, die 1918 in Deutschland einen Adelstitel trugen, änderten ihren Namen und der Adelstitel war fortan ein Teil ihres Namens; wenn also eine fiktive Person 2022 mit dem Namen „Otto Freiherr von Münchhausen“ geboren wäre, dann wäre „Otto“ der Vorname und "Freiherr von Münchhausen" der Nachname.<ref>siehe Artikel "[https://www.protokoll-inland.de/Webs/PI/DE/anschriften-anreden/familiennamen-mit-adelsbezeichnungen/familiennamen-ehemalige-adelsbezeichnungen-node.html Familiennamen mit ehemaligen Adelsbezeichnungen]" (abgerufen am 9.10.2022)</ref>

Dies würde man so speichern:

<code>1 NAME Otto /Freiherr von Münchhausen/</code>

<code>2 GIVN Otto</code>

<code>2 SURN Freiherr von Münchhausen</code>

Die Erfassung eines historischen Adelsnamens kann in webtrees im Feld für den Nachnamen erfolgen, wobei für das Adelsprädikat „von“ das GEDCOM-Kennzeichen [[GEDCOM/NAME-Tag|SPFX]] vorgesehen ist. Die historische Person „Hieronymus Carl Friedrich Freiherr von Münchhausen“ (geboren 1720) könnte man folgendermaßen speichern:

<code>1 TITL Freiherr von Münchhausen</code>

<code>1 NAME Hieronymus Carl Friedrich /von Münchhausen/</code>

<code>2 GIVN Hieronymus Carl Friedrich</code>

<code>2 SPFX von</code>

<code>2 SURN Münchhausen</code>

<code>2 NICK Lügenbaron</code>

In Österreich wurden die Adelstitel und die Adelsvorsilbe „von“ vollständig abgeschafft. So wurde etwa aus „Erzherzog Otto von Habsburg-Lothringen“ ein „Otto Habsburg-Lothringen“. Entsprechende Regelungen sind in anderen Ländern in unterschiedlicher Art getroffen worden.

Insbesondere bei Adeligen aus dem Mittelalter gibt es häufig zusätzliche Kennzeichnungen oder Übernamen, die eine Person näher und eindeutig kennzeichnen, so etwa „Heinrich IV. der Blinde von Luxemburg“ oder „Albrecht VI. der Freigebige von Habsburg“. Manchmal wurden diese Bezeichnungen schon zu Lebzeiten der Person geprägt und verwendet, meist jedoch erst später in der Rückschau. Eine Erfassung kann im Feld für Spitznamen und im GEDCOM-Kennzeichen für das Namens-Suffix [[GEDCOM/NAME-Tag|NSFX]] erfolgen, also etwa:

<code>1 NAME Albrecht /von Habsburg/ VI</code>

<code>2 TYPE AKA</code>

<code>2 GIVN Albrecht</code>

<code>2 SPFX von</code>

<code>2 SURN Habsburg</code>

<code>2 NSFX VI</code>

<code>2 NICK der Freigebige</code>

Die Darstellung kann dann, abhängig von der Konfiguration in webtrees, so aussehen: Albrecht "der Freigebige" von Habsburg VI.

Wenn ein Sohn denselben Namen trägt wie der Vater, kommt es häufig vor, dass man die Beiden durch ein angehängtes „jr.“ und „sr.“ unterscheidet. Bei allgemein bekannten namensgleichen Personen gibt es manchmal die Zusatzbezeichnung „der Ältere“ und „der Jüngere“, selbst wenn diese Personen nicht miteinander verwandt sind. Manchmal wird diese Bezeichnung aber auch für Vater und Sohn verwendet, so etwa bei ''Daniel Lüncker der Ältere'' und seinem Sohn ''Daniel Lüncker der Jüngere''. In allen diesen Fällen sollte die Erfassung im Namens-Suffix erfolgen. Korrekterweise sind solche erst später verwendeten Namensbestandteile nicht Teil des Geburtsnamens und sollten daher in einem zusätzlichen Namenseintrag angegeben werden.

==== Namen in verschiedenen Alphabeten ====
Namen gibt es in allen menschlichen Sprachen, sie können viele verschiedene Arten von Zeichen enthalten, wie etwa Leerzeichen, Punkte, Umlaute, diakritische Zeichen, chinesische Schriftzeichen, und viele andere.<ref>siehe den vielzitierten Artikel "[https://www.kalzumeus.com/2010/06/17/falsehoods-programmers-believe-about-names/ Falsehoods programmers believe about names]"</ref> Sie dürfen jedoch keine Kommas und keine Schrägstriche enthalten. Die Zeichen * und " haben eine besondere Bedeutung (für die Hervorhebung und für Spitznamen) und sollten nicht Teil eines Namens selbst sein.

Namen können auch in anderen als dem lateinischen Alphabet vorkommen, wie etwa Arabisch, Kyrillisch oder Hebräisch. Als ein Beispiel sei hier Maria Callas angeführt:

<code>1 NAME Μαρία Άννα Σοφία Καικιλία /Καλογεροπούλου/</code>

<code>2 TYPE BIRTH</code>

<code>2 GIVN Μαρία Άννα Σοφία Καικιλία</code>

<code>2 SURN Καλογεροπούλου</code>

<code>1 NAME Maria Anna Sofia Cecilia /Kalogeropoulos/</code>

<code>2 TYPE BIRTH</code>

<code>2 GIVN Maria Anna Sofia Cecilia</code>

<code>2 SURN Kalogeropoulos</code>

<code>1 NAME Maria /Callas/</code>

<code>2 TYPE AKA</code>

<code>2 GIVN Maria</code>

<code>2 SURN Callas</code>

<code>2 NICK La Callas</code>

Hier wurden drei Namen angelegt. Wenn der Nutzer von webtrees in seinem Browser als bevorzugte Sprache „Griechisch“ angegeben hat, wird er bevorzugt die Namensvariante im griechischen Alphabet angezeigt bekommen, während ein Nutzer etwa mit der Vorzugssprache „Deutsch“ bevorzugt die Namensschreibweise im lateinischen Alphabet angezeigt bekommen wird.

{{WT-ToDo|Erklärung zu Transliteration und Transskribierung; siehe ROMN}}

==== Namen in verschiedenen Sprachen ====
Insbesondere im europäischen Adel kommt es häufiger vor, dass Personen in verschiedenen Ländern unter verschiedenen Namen bekannt sind, etwa ''Francesco I delle Due Sicilie'', der auch als ''Franz I. von Sizilien'' oder als ''Francesco I di Borbone'' bekannt ist. Insbesondere wenn sich der Name auf Landesteile bezieht, die in verschiedenen Sprachen unterschiedlich heißen, wird die Person in verschiedenen Sprachen ebenfalls unterschiedlich genannt, so etwa bei ''Philippa von Hennegau'', die im englischen ''Philippa of Hainault'' genannt wird. In diesen Fällen bietet es sich an, mehrere Namen für die Person zu erfassen und in einer zugehörigen Notiz zu vermerken in welcher Sprache welche Bezeichnung gilt.

==== Unbekannte Namensbestandteile ====
Wenn Namensbestandteile unbekannt sind, entfallen die entsprechenden Teile. Das kann dann so aussehen:

<code>1 NAME Anna Maria</code>

oder

<code>1 NAME Anna Maria //</code>

Die erste Variante ist konform mit dem GEDCOM-Standard, erlaubt es aber nicht zu unterscheiden, ob der Nachname unbekannt ist oder ob die Person keinen Nachnamen trägt. Die zweite Variante wird von webtrees unterstützt und zeigt an, dass der Nachname existiert, aber nicht bekannt ist.

Bei unbekanntem Vornamen (das kann zum Beispiel bei Totgeburten ohne Taufe vorkommen), kann die Erfassung folgendermaßen aussehen:

<code>1 NAME /Maier/</code>

Wenn es zwar klar ist, dass eine Person existiert, aber kein Name bekannt ist, muss das GEDCOM-Kennzeichen [[GEDCOM/NAME-Tag|NAME]] ganz entfallen. webtrees erzeugte bislang in solchen Fällen im Widerspruch zum GEDCOM-Standard einen leeren Namen:

<code>1 NAME //</code>

Bei der Darstellung von Diagrammen und Listen wird bei einem leeren oder nicht vorhandenen Namenseintrag bei webtrees "… …" angezeigt, so dass man erkennt, dass hier eine Person ohne Namen vorliegt.

Für unleserliche Namensteile aus einer Quelle, schreibt der GEDCOM-Standard 5.5.1 das Einsetzen eines [https://de.wikipedia.org/wiki/Auslassungszeichen Auslassungszeichens] vor. Verwendet werden soll ein Zeichen mit drei Punkten: '…'.<ref>Der Code des Auslassungszeichens (drei Punkte als ein Zeichen, auch „Dreipunkt“ oder „Ellipse“ genannt) ist '''U+2026'''.</ref> Wenn also in einem Kirchenbucheintrag Teile des Nachnamens nicht erkannt werden können, sollte man erkannte Teile erfassen und die Lücken kennzeichnen:

<code>1 NAME Johannes /Bal…grien/</code>

{{Wichtig|Vorschläge zur optimalen Datenerfassung von Namen mit dem Ziel, eine qualitative und standard-gerechte Erfassung zu erreichen 
- Namen so erfassen wie sie in den Quellen geschrieben werden 
- Erfassung aller bekannter Namensvarianten zu einer Person in separaten NAME-Einträgen mit jeweiligen Quellenangaben 
- Nutzung von SURN zu Sortier- und Selektionszwecken 
- Rufnamen mit Sternchen und _RUFNAME erfassen 
- Titel, akademische Grade und Berufsbezeichnungen getrennt vom Namen erfassen 
- Namen von Personen aus einem Sprachraum, der ein anderes als das lateinische Alphabet verwendet: eventuell im lateinischen und im fremden Alphabet erfassen
}}

=== Orte ===
{{WT-ToDo|Handbuch Im Aufbau...}}
==== Orte und ihre Hierarchie ====

==== Gemeinsame Orte ====

==== Adressen ====

{{Wichtig|Vorschläge zur optimalen Datenerfassung von Orten mit dem Ziel, eine qualitative und standard-gerechte Erfassung zu erreichen 
- tbd
}}

=== Zeitpunkte und -spannen ===
Bei vielen Ereignissen ist es wichtig den Zeitpunkt des Ereignisses zu beschreiben. So etwa bei einer Geburt oder bei der Erfassung des Todeszeitpunktes oder der Bestattung. Wie man Zeitangaben in webtrees eingibt, ist im Abschnitt "[[Webtrees Handbuch/Anleitung für Bearbeiter#Datumsangaben|Datumsangaben]]" im Kapitel "[[Webtrees Handbuch/Anleitung für Bearbeiter|Anleitung für Bearbeiter]]" beschrieben. Dort ist auch beschrieben wie ungenaue oder geschätzte Zeitangaben einzugeben sind. Neben Zeitpunkten gibt es auch Zeitspannen; wenn man etwa beschreiben möchte von wann bis wann eine Person an einem Ort wohnte, wird man dieses "Ereignis" mit einer Zeitspanne kennzeichnen. Wenn zur Kennzeichnung des Datums eines Ereignisses in einer Quelle eine Phrase verwendet wird, wie etwa "getauft am Pfingstmontag des Jahres 1702", dann sollte diese Angabe in ein Kalenderdatum umgerechnet werden; zusätzlich ist dann aber die Phrase aus der Quelle mit zu erfassen.

Die Datumsangaben in einer Quelle verwenden bei Ereignissen im Normalfall immer das am entsprechenden Ort zu diesem Zeitpunkt gültige Kalendersystem. Für alle Datumsangaben nach dem 15. Oktober 1582 wird das häufig der gregorianische Kalender sein. Davor gilt immer der julianische Kalender. Allerdings erfolgte die Umstellung auf den gregorianischen Kalender in evangelischen Regionen Deutschlands, etwa in Preußen, oder in anderen Ländern zu unterschiedlichen Zeitpunkten etwa im Jahr 1700, teilweise aber auch erst erheblich später, so dass einige in Quellen vorgefundene Datumsangaben entsprechend unklar sind. Wenn man weiß, welches Kalendersystem bei einem Ereignis an einem Ort galt, sollte man dieses Kalendersystem bei der Erfassung des Datums spezifizieren; ansonsten erfasst man das Datum ohne die Angabe eines Kalendersystems.

Der Jahresanfang im gregorianischen Kalender war nicht immer am 1. Januar, sondern - regional verschieden - später, etwa zum Osterfest, so dass etwa Datumsangaben in einem Kirchenbuch im Januar oder Februar noch das alte Jahr verwendet haben. Wenn bekannt ist zu welchem Kalenderjahr nach heutiger Zuordnung ein Ereignis gehörte, dann sollte die Jahresangabe aus der Quelle ggf. korrigiert erfasst werden, so dass davon ausgegangen werden kann, dass ein Kalenderjahr immer am 1. Januar beginnt.

{{WT-ToDo|noch beschreiben: Doppeljahre siehe https://gedcom.io/specifications/FamilySearchGEDCOMv7.pdf S. 107}}

Wenn zu einem Ereignis eine Uhrzeit angegeben ist, dann bezieht sich diese Angabe im Normalfall immer auf die am jeweiligen Ort geltende Zeitzone und die gerade dort geltende Sommer- oder Winterzeit. Die Erfassung der Uhrzeit sollte immer so erfolgen, wie sie in der Quelle angegeben ist; eine Angabe wie "um 8 Uhr abends" sollte aber immer in "20:00" übersetzt werden.

Wann ein neuer Tag beginnt, wird auch heute noch in verschiedenen Teilen der Welt unterschiedlich gehandhabt. In großen Teilen der Welt ist es heute üblich, dass ein neuer Tag um Mitternacht beginnt, also um 0:00 Uhr. Es kann aber auch sein, dass der neue Tag erst mit der Morgendämmerung beginnt, so dass bis zu diesem Zeitpunkt noch das Datum des Vortages gilt. Eine Datenerfassung sollte das nicht korrigieren, sondern Datum und Uhrzeit so erfassen wie es in der Quelle angegeben ist; ggf. mit einem Hinweis darauf in einer Notiz.

{{Wichtig|Vorschläge zur optimalen Datenerfassung von Zeitpunkten und -spannen mit dem Ziel, eine qualitative und standard-gerechte Erfassung zu erreichen 
- tbd
}}

=== Ereignisse ===
{{WT-ToDo|Typen von Ereignissen beschreiben; Abgrenzung zu Fakten vornehmen; GEDCOM-Strukturen beschreiben;}}

Manchmal ist in einem Kirchenbuch nicht klar ersichtlich, ob es sich bei einem Datum, das in einem Eintrag genannt wird, um das Geburtsdatum oder das Taufdatum handelt; ähnliches gilt für das Todes- oder das Bestattungsdatum. Dann sollte man sowohl das Geburts- als auch das Taufdatum mit dem selben Datum erfassen und in einem Kommentar darauf hinweisen. Gleiches gilt für das Todesdatum und das Bestattungsdatum. Da in solchen Fällen der Ort der kirchlichen Zeremonie im Normalfall klar definiert ist, sollte man den Ereignisort bei der Taufe und der Bestattung eingeben, aber den Ort bei Geburt und Tod nicht angeben.

{{Wichtig|Vorschläge zur optimalen Datenerfassung von Ereignissen mit dem Ziel, eine qualitative und standard-gerechte Erfassung zu erreichen 
- tbd
}}

=== Fakten ===
{{WT-ToDo|Handbuch Im Aufbau...}}

{{Wichtig|Vorschläge zur optimalen Datenerfassung von Fakten mit dem Ziel, eine qualitative und standard-gerechte Erfassung zu erreichen 
- tbd
}}

=== Quellen und Archive ===
Nach einer Einführung in das Thema "Quellen und Archive", werden in den danach folgenden Abschnitten die Details zur Angabe von
* Quellenzitaten
* Quellen
* Archiven
in webtrees beschrieben. Dies erfolgt in enger Anlehnung an die Festlegungen im GEDCOM-Standard. Danach werden noch Beispiele für verschiedene Arten von Quellen gegeben und jeweils passende Vorlagen beschrieben, die Sie bei der Dokumentation unterstützen sollen.

==== Einführung ====
Als '''Quellen'''<ref>siehe auch: {{Wikipedia-Link|Quelle (Geschichtswissenschaft)}}</ref> bezeichnet man in der Geschichtswissenschaft – nach der vielzitierten Definition Paul Kirns – „alle Texte, Gegenstände oder Tatsachen, aus denen Kenntnis der Vergangenheit gewonnen werden kann“.<ref>Paul Kirn: ''Einführung in die Geschichtswissenschaft.'' fortgeführt von Joachim Leuschner. 5. Auflage. De Gruyter, Berlin 1968, S. 29.</ref> Eine Quelle kann also sehr vieles sein. Ob für den Genealogen etwas zur Quelle wird, hängt von der Fragestellung ab, davon, ob ein Text, ein Foto, ein Gegenstand oder eine DNA-Analyse Antworten auf eine bestimmte Frage geben kann, d.h. das konkrete Forschungsinteresse des jeweiligen Genealogen ist entscheidend.<ref>Zur wissenschaftlichen Arbeit mit Quellen gibt es ein knappes Tutorial "[http://www.historicum-estudies.net/etutorials/tutorium-quellenarbeit/ Arbeiten mit Quellen]".</ref>

Quellenangaben sind daher für die Ahnen- und Familienforschung von einer elementaren Bedeutung. In der Quellenangabe wird festgehalten, woher die dokumentierten Angaben zu einer Person oder einer Familie stammen. Als Quellen kommen Standesurkunden, Kirchenbücher, Familienstammbücher, Grundbücher, Gerichtsurteile, Volkszählungslisten, Grabsteine, handschriftliche Aufzeichnungen, Fotos, Interviews, Webseiten und noch vieles andere in Frage. Wenn sich andere Personen mit den von Ihnen aufgezeichneten Personendaten beschäftigen möchten, sind sie auf die Nachvollziehbarkeit ihrer Angaben angewiesen. Falls zu einem späteren Zeitpunkt widersprüchliche Informationen erkannt werden sollten, ist eine gute Quellenangabe zur Klärung des Widerspruchs unerlässlich. In webtrees können zu jeder behaupteten Angabe in einem Ereignis oder in den behaupteten Fakten beliebig viele Quellenzitate notiert werden.

Quellen sind Teil einer Hierarchie von Referenzen mit '''Zitaten''' und '''Archiven''', die etwa folgende Struktur aufweist

* '''Archive''' sind die "Herkunftsorte", aus denen eine oder mehrere Quellen stammen, wie z.B. Stadtarchive, Kirchenarchive, Büchereien, Friedhöfe, private Dokumentensammlungen, aber auch Webseiten wie Ancestry, Archion, FamilySearch, FindAGrave, MyHeritage, Wikipedia, etc. Archive sind also entweder physisch existente Orte oder virtuelle Orte im Internet.
* '''Quellen''' sind Bestandteile der Archive und beinhalten die Informationen zur Beschreibung der Personen und Familien, wie z.B. eine Standesurkunde, ein Kirchenbuch, ein Familienstammbuch, ein Grabstein, ein Wikipedia-Artikel, ein Zeitungsartikel, eine niedergeschriebene Geschichte von Tante Elsbeth, die sie gerne beim Sonntagsessen erzählt hat, etc. Im Prinzip können Quellen selbst noch einmal hierarchisch organisiert sein; etwa alle Kirchenbücher eines Ortes, ein spezieller Kirchenbuchband, eine Seite aus einem Kirchenbuchband.
* '''Zitate''' führen zum eigentlichen Inhalt der Quellen, wie z.B. ein abgeschriebener Text aus einem Kirchenbuch, oder der Inhalt einer Heiratsurkunde, oder die Daten von einem Grabstein mit dem zugehörigen Foto des Grabsteins, etc.
Man unterscheidet in der Genealogie etwa folgende Kategorien von Quellen

* '''Primärquelle''': Dies ist die ursprüngliche Form einer Aufzeichnung, die in einem engen zeitlichen Zusammenhang mit einem Ereignisses zum Zweck der späteren Rekonstruktion eines Sachverhalts von einer kompetenten Person erstellt wurde. Ein Beispiel ist ein Kirchenbuch in dem die Taufe eines Kindes vom Pfarrer am Tag der Taufe aufgezeichnet worden ist.
* '''Sekundärquelle''': Dies kann eine später kopierte, aggregierte oder abgeleitete Version der Originalaufzeichnungen sein. Solche abgeleiteten Quellen werden normalerweise lange nach dem eigentlichen Ereignis erstellt. Zum Beispiel kann dies ein Kirchenbuchindex mit den Lebensdaten der Bewohner eines Ortes sein. Meist werden die dort erfassten Daten stimmen, aber manchmal haben sich auch Kopierfehler eingeschlichen.
* '''Traditionsquelle''': Darunter versteht man beispielsweise die Aufzeichnung eines Interviews mit Familienangehörigen, ein Tagebuch, Memoiren oder eine aufgeschriebene Familiengeschichte, die über Vergangenes berichtet. Zu den Traditionsquellen zählt man auch ein Fotoalbum oder das Gemälde, das einen Vorfahren darstellt, oder auch ein Kriegerdenkmal mit einer Inschrift. Zu dieser Kategorie zählen kann man auch einen Grabstein oder eine Todesanzeige in einer Tageszeitung.
* '''Überreste''': Unter Überresten versteht man Zeugnisse der Vergangenheit, die ohne eine gezielte Überlieferungsabsicht angelegt worden sind. Dazu zählen etwa Akten mit Geschäfts- und Verwaltungsschriftgut, so etwa Kaufverträge oder Gerichtsurteile, privates Schriftgut wie Briefe oder Zeitungsartikel, in denen Vorfahren erwähnt werden.

*'''Literatur''': Darunter kann man die veröffentlichte Forschung subsummieren, die bereits über Personen und Familien durchgeführt wurde. Dazu gehört auch alles, was sich in irgendeiner Form interpretatorisch mit einer oder mehreren Quellen auseinandersetzt. Das können gedruckte Genealogien sein, aber auch Stammbäume im Internet oder handschriftliche Zusammenstellungen zu einer Familie. Ein Ortsfamilienbuch gehört ebenfalls in diese Kategorie; da es sich aber sehr eng an die Informationen hält, die aus den Primärquellen bezogen wurden, kann man ein solches auch als Sekundärquelle einordnen.

Wenn man möchte, kann man in webtrees die Quellen-Datensätze entsprechend mit diesen Kategorien kennzeichnen, indem man eine gemeinsame Notiz zu jeder Quelle hinzufügt. Das kann dann folgendermaßen aussehen:

0 @S1@ SOUR
1 TITL Kirchenbuch - Köndringen
1 NOTE @N1@
0 @N1@ NOTE #### Quellenkategorie: Primärquelle

Die Quelle "Kirchenbuch - Köndringen" enthält dann einen Verweis auf die Notiz "Quellenkategorie: Primärquelle", wobei man die "####" weglassen sollte, wenn man kein Markdown verwendet. Wenn man sich in webtrees die Liste der gemeinsamen Notizen ansieht und dort die Notiz "Quellenkategorie: Primärquelle" auswählt, bekommt man im Reiter "Quellen" eine Auflistung aller im Stammbaum verwendeten Primärquellen.

Die Einschätzung der Qualität einer Quelle ist wichtig, wenn es darum geht ihre Verlässlichkeit bezügliche der vorgefundenen Informationen zu bewerten. Dabei geht es zum einen um die Echtheit der Quelle und zum anderen um ihre Aussagekraft, d.h. wie wahrscheinlich ist es, dass die in der Quelle dokumentierten Informationen mit der historischen Realität übereinstimmen. Wenn etwa widersprüchliche Daten zu einem Ereignis vorliegen, kann die Einschätzung der Qualität einer Quelle helfen, Angaben für weitere Schlussfolgerungen zu bevorzugen. Generell ist es das Ziel, alle noch vorhandenen Quellen zu einer Fragestellung möglichst vollständig zu erfassen und bei Sekundärquellen oder aufgefundenen Quellen in der Kategorie "Literatur" zu den Primärquellen vorzustoßen. Die Einordnung einer Quelle in eine der oben aufgeführten Kategorien kann ein Indikator für die Qualität einer Quelle sein; es gilt aber, dass alle Quellen gleichermaßen kritisch geprüft werden müssen, um sie beurteilen zu können. Dies muss unbeeinflusst von einer a priori-Kategorisierung erfolgen.

Um die Richtigkeit der Angaben zu historischen Ereignissen oder Fakten einzuschätzen, sind schriftliche Quellen eine wichtige, aber nicht die einzige Möglichkeit. Wenn es etwa darum geht, die männlichen Vorfahren einer Person zu ermitteln, muss man immer damit rechnen, dass die Quellenlage in Kirchenbüchern oder staatlichen Urkunden nicht mit der Realität übereinstimmt, da etwa bei einem Kuckuckskind, die Angaben im Kirchenbuch oder einer Urkunde nicht den biologischen Vater bezeichnen, sondern denjenigen Vater, dem das Kind untergeschoben worden ist. Hier kann eine DNA-Analyse eine Quelle für eine objektivere Verifizierung oder Falsifizierung einer behaupteten Abstammungsvermutung darstellen, und dies auch noch einige Generationen später.

Ein '''Archiv''' ist eine Institution oder Organisationseinheit, in der Archivgut zeitlich unbegrenzt im Rahmen der Zuständigkeit des Archivs oder des jeweiligen Sammlungsschwerpunktes aufbewahrt, benutzbar gemacht und erhalten wird (Archivierung). Archivgut muss jede der folgenden drei Bedingungen erfüllen

# Ist im Geschäftsgang einer juristischen oder natürlichen Person entstanden;
# wird zur Erledigung der laufenden Geschäfte nicht mehr benötigt;
# hat einen bleibenden Wert.

Das Archivgut kann physisch existent oder virtuell sein; entsprechend können Archive physisch existente oder auch virtuelle Orte sein.

Unter "Archiv" kann man auch einen Oberbegriff für Informations- und Wissensspeicher ganz allgemein verstehen. Das Archiv ist dann nicht nur ein Ort des Bewahrens, sondern nach Michel Foucault „das allgemeine System der Formation und der Transformation von Aussagen“<ref>Zitiert nach Michel Foucault, ''Archäologie des Wissens'', 1969, S. 188.</ref>. Ganz im Sinne des hier beschriebenen genealogischen Prozesses dient ein Archiv also dazu, formulierte Forschungsfragen in Aussagen und in der Folge in Wissen zu transformieren.

Im Internet gibt es zahlreiche Archivportale. Sie bieten gebündelte Information über Archive und bieten teilweise die Möglichkeit, in den Beständen mehrerer Archive gleichzeitig zu recherchieren. Die Digitalisierung von analogem Archivgut wird weltweit vorangetrieben; dabei entstehende Digitalisate werden dann zur Nutzung im Internet bereitgestellt. Dadurch bieten einige der Archivportale nicht nur eine Möglichkeit Quellen zu finden, sondern erlauben zunehmend auch den direkten Zugriff auf diese.

Zu Zitaten, Quellen und Archiven werden in der Regel eine ganze Reihe von Angaben erfasst, wie etwa ein Quellendatum, Seitenzahlen, Registernummern, Datenqualität, Verweise auf Webseiten, Adressen etc. Wie man diese Informationen mit webtrees dokumentiert, wird in den folgenden Abschnitten noch näher beschrieben.

Die gute Dokumentation von Quellen hat unter anderem folgende Vorteile
* Vorhandene Quellenangaben machen die Angaben im Stammbaum jederzeit nachvollziehbar und überprüfbar.
* Die Quellensammlung erleichtert den Überblick über bereits belegte Informationen und hilft damit, die weitere Forschung auf noch fehlende Quellenangaben zu beschränken.
* Die Zuverlässigkeit von Angaben lässt sich besser überprüfen und bewerten. Eine Originalurkunde, die in Zusammenhang mit einem Ereignis erstellt wurde, ist vermutlich zuverlässiger als eine erst später verfasste Abschrift.
* Die Dokumentation der Quellen hilft dabei, unstimmige Angaben zu bewerten. Wenn Sie auf widersprüchliche Angaben stoßen, wie zwei unterschiedliche Geburtsdaten für eine Person, können Sie anhand der Quellenangaben die relevanten Quellen erneut einsehen und so möglicherweise diejenige Quelle identifizieren, welche die korrekten Angaben enthält.
* Forschungsarbeit, die bereits geleistet wurde, geht nicht verloren und kann als gute Grundlage für den weiteren Ausbau Ihres Stammbaums dienen.
webtrees unterstützt die Erfassung von Informationen zu Zitaten, Quellen und Archiven gemäß dem GEDCOM-Standard. Wenn hierarchische Quellen und Archivstrukturen oder auch ein externes Archiv- und Quellenmanagementsystem, wie etwa [https://www.accesstomemory.org/ AtoM], zum Einsatz kommen sollen, gibt es dafür das [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodul]] "RepositoryHierarchy" (siehe Liste im Abschnitt "[[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule#.C3.9Cbersicht%20.C3.BCber%20bekannte%20Erweiterungsmodule|Übersicht über bekannte Erweiterungsmodule]]").

In jedem Bearbeitungsfenster von webtrees für "Tatsachen und Ereignisse" lassen sich neue oder bereits vorhandene Quellenzitate hinzufügen. Alle zitierten Quellenangaben müssen zu genau einer Quelle gehören. Gibt es für ein Ereignis mehr als eine Quelle, werden mehrere Quellenzitate erstellt. Eine bereits erfasste Quelle kann für weitere Ereignisse mehrfach verwendet werden. Zum Beispiel können aus einer Heiratsurkunde nicht nur das Heiratsdatum und der Ort sowie die Namen der Brautleute stammen, häufig sind viele weitere Informationen enthalten, wie z.B. Beruf oder Stand der Brautleute, der Wohnort der Brautleute, die Namen und Wohnorte der Eltern, die Namen, das Alter und die Wohnorte der Trauzeugen, die Urkundennummer, das Standesamt, etc.

==== Quellenzitat ====
{{WT-ToDo|noch beschreiben: wie und wo erfasst man ein Quellenzitat in webtrees; wie fügt man Fotos bei; wie sieht die zugehörige GEDCOM-Struktur aus?}}

===== Quelle =====
{{WT-ToDo|Link zu einer vorhandenen Quellenbeschreibung}}

===== Details zur Zitierung =====
(Wo innerhalb der Quelle) Spezifische Fundstelle innerhalb der referenzierten Information. Für ein veröffentlichtes Werk, könnte dies die Bandnummer eines mehrbändigen Werkes und die Seitennummer beinhalten. Für ein Periodikum könnte es Jahrgang, Ausgabe und Seitennummer beinhalten. Für eine Zeitung könnte es die Seiten und Spaltennummer beinhalten. Für eine unveröffentlichte Quelle oder mikroverfilmte Werke könnte dies eine Filmnummer oder Blattnummer, Seitennummer, Bildnummer etc. sein. Ein Eintrag einer Volkszählung könnte eine Distriktnummer, Seitennummer, Zeilennummer, Wohnungsnummer und Familiennummer beinhalten. Die Daten in diesem Feld sollten die Form von Bezeichnung und Wertpaaren haben, wie beispielsweise: Bezeichung1: Wert, Beizeichnung2: Wert, wobei die Paare durch Kommata getrennt sind. Beispiel: Film: 1234567, Bild: 344, Zeile: 38.

===== Ereignis =====
(Art des zitierten Ereignisses) Ein Code, der die Art des Ereignisses kennzeichnet, welches Ursache für die Aufzeichnung in der Quelle war. Wurde der Eintrag beispielsweise erstellt, um die Geburt eines Kindes aufzuzeichnen, so würde „Geburt“ angegeben, unabhängig davon, welche Informationen aus dem Eintrag abgeleitet wurden, wie das Geburtsdatum oder Name der Mutter. Dies erlaubt es, eine priorisierte Auswahl anzubieten, sowie die Bestimmung der Glaubwürdigkeit die der Quelle des zitierten Ereignisses zukommt.

===== Rolle =====
(Rolle im Ereignis) Zeigt an, welche Rolle diese Person in dem zitierten Ereignis einnahm. Wenn beispielsweise der Geburtseintrag eines Kindes als Quelle des Namens der Mutter dient, ist der Wert für dieses Feld “MOTH”. Wenn der Bräutigam einer Hochzeit beschrieben wird, ist die Rolle „HUSB“.

===== Datum des Eintrages in der ursprünglichen Quelle =====
(Datum der Aufzeichnung des Eintrags) Das Datum, zu dem dieses Ereignis in der Originalquelle aufgezeichnet wurde.

===== Text =====
(Text aus der Quelle) Eine wortgetreue Kopie (Transkription) des Textes in der Quelle. Eine [[Transkription]] ist die unverfälschteste Wiedergabe eines Quellentextes. Sie ist bemüht, den Inhalt 1:1 in heutiger Schrift (nicht Sprache!) wiederzugeben. Jede Übersetzung eines transkribierten Textes wäre zwangsläufig immer auch schon ein Stück Interpretation. Das Feld enthält den Text und die Notizen, die tatsächlich in der Quelle enthalten sind. Im Sinne einer Beweisführung sollte dies „was der ursprünglich Aufzeichnende schrieb“ sein, nicht etwas wie der Forscher es interpretiert hat.

===== Medienobjekt =====
Multimedia-Datei zum Zitat, etwa eine Abbildung zum Quelleintrag.

===== Notiz =====
(Verfasser, Text) Kommentare oder Meinungen des Verfassers zum Zitat.

===== Datenqualität =====
Eine Quelle ist nicht die Wahrheit - es ist nur ein Beweisstück zur Stützung von Schlussfolgerungen, zum Beispiel, dass jemand am 19. Dezember 1769 geboren wurde.

Mit einem Kennzeichen für die Datenqualität einer Quelle kann der Verfasser seine Einschätzung über die Vertrauenswürdigkeit einer Information ausdrücken, basierend auf den vorhandenen Beweisstücken. Die Eingabe erfolgt in webtrees über eine Auswahlliste mit folgenden Werten
*'''(3) sicher, Primärquelle''' = Direkte und primäre Beweise; unwiderlegbare Beweislage (z.B. Standesurkunden, Kirchenbucheinträge, etc.)
*'''(2) abgeleitet, Sekundärquelle''' = Sekundäre und abgeleitete Beweise; Daten, die irgendwann nach dem Ereignis offiziell aufgezeichnet wurden (Wikipedia, andere Stammbäume, etc.)
*'''(1) fragwürdig, fraglich''' = fragwürdige Glaubwürdigkeit der Quelle; (z.B. Interviews, Volkszählungen, mündliche Familienüberlieferung, potenziell einseitige Darstellung z.B. Autobiografie, etc.)
*'''(0) angenommen, geschätzt''' = unsichere Beweise und geschätzte Daten

==== Quellenbeschreibung ====

===== Titel =====
Der Titel des Werkes, Aufzeichnung oder Objektes, sowie, wenn passend, der Titel des größeren Werkes oder Serie, dessen Teil diese Quelle ist.
Für veröffentlichte Werke, z. B. ein Buch, könnte ein Titel angegeben werden, und zusätzlich der Titel einer Serie von Büchern, zu der dieses Buch gehört. Ein Artikel in einem Magazin würde einen Titel haben, sowie den Titel des Magazins, in welchem der Artikel veröffentlicht wurde.
Für unveröffentlichte Werke, Beispiele:
• Ein Brief könnte das Datum, den Absender und den Empfänger beinhalten
• Eine Transaktion zwischen Käufer und Verkäufer könnte deren Namen und das Transaktionsdatum beinhalten.
• Ein Familienstammbuch, das genealogische Informationen enthält, könnte vergangene und derzeitige Eigentümer und eine physische Beschreibung des Buches enthalten
• Ein persönliches Interview würde den Befragten und den Fragenden benennen

===== Abkürzung =====
(Quelle abgelegt unter Eintrag) Dieser Eintrag wird für einen Kurztitel benutzt, der zur Sortierung, Ablage und Abruf dient.

===== Daten =====

====== Daten-Ereignisse ======
(Aufgezeichnete Ereignisse) Eine Auflistung von verschiedenen Ereignistypen, die in einer bestimmten Quelle aufgezeichnet wurden. Jeder Wert wird durch ein Komma getrennt. So würde ein Register, welches Geburten, Sterbedaten und Hochzeiten enthält als BIRT, DEAT, MARR angegeben.

====== Daten-Datumsbereich ======
(Aufgezeichnete Datumsbereich ) Datum der Aufzeichnung

====== Daten-Ort ======
(Quelle, Gerichtsbezirk, Ort) Der Name des kleinsten Gerichtsbezirks, der alle Orte umfasst, die in der Quelle genannt sind. Beispielsweise würde „Oneida, Idaho“ als Gerichtsbezirk für eine Quelle genutzt werden, die Ereignisse für verschiedene Orte innerhalb von Oneida County beschreibt. Hingegen würde „Idaho“ genutzt werden, wenn die in der Quelle genannten Ereignisse auch in anderen Gemeinden außer Oneida County stattfanden.

====== Daten-Institution ======
(zuständiges Amt oder Institution) Die Organisation, Institution, Firma, Person oder andere Einheit, die in diesem Zusammenhang verantwortlich ist. Beispielsweise der Arbeitgeber einer Person zu einem Beruf, oder eine Kirche, die die Riten oder Ereignisse verwaltet, oder eine Organisation, die für die Durchführung von Ereignissen oder deren Aufzeichnung verantwortlich ist.

====== Daten-Notiz ======
Notiz zu den Aufzeichnungen

===== Verfasser =====
(Quelle, Urheber) Die Person, Organisation oder juristische Person, die das Werk erschaffen hat. Für ein veröffentlichtes Werk, könnte dies der Autor, Zusammensteller, Transkriptor, Zusammenfassende oder Editor sein. Für ein unveröffentlichtes Werk kann dies eine Person, eine Behörde, eine Kirchen- oder private Organisation etc. sein.

===== Veröffentlichung =====
(Quelle, Veröffentlichungsdaten) Wann und wo die Aufzeichnung erstellt wurde. Für veröffentlichte Werke, beinhaltet dies Informationen wie den Ort der Veröffentlichung, Name des Verlages und Jahr der Veröffentlichung. Für ein unveröffentlichtes Werk beinhaltet dies Datum und Ort an dem die Aufzeichnung erstellt wurde - beispielsweise die Gemeinde und den Bundesstaat in der eine Person wohnhaft war, als sie einen Rentenantrag stellte, oder den Wohnort und Staat eines Briefeschreibers.

===== Text =====
(Text aus der Quelle) Eine wortgetreue Kopie einer beliebigen Beschreibung aus der Quelle. Dies beschreibt Notizen oder Text der tatsächlich in der Quelle enthalten ist, nicht die Meinung des Einreichers über diese Quelle. Im Sinne einer Beweisführung sollte dies „was der ursprünglich Aufzeichnende schrieb“ sein, nicht etwas wie der Forscher es interpretiert hat. Das Wort „Text“, in diesem Falle, meint in der Quelle enthaltener Text, inklusive Beschriftungen

===== Notiz =====
(Verfasser, Text) Kommentare oder Meinungen des Verfassers zur Quelle.

===== Multimedia =====
Multimedia-Datei zur Quelle

===== Archiv =====
Das Archiv ist ein Datensatz zur Lokalisierung. Das kann ein realer Ort mit Besucheradresse oder auch ein virtueller Raum im Internet sein. Zur Beschreibung des Archivs gehören

* Name oder Bezeichnung
* ggf. Adresse, Telefon, E-Mail-Adresse, Internetadresse (URL)
* ggf. Datensatz-ID, Eindeutige Kennung, Referenznummer
* ggf. Notiz, Einschränkung
{{WT-ToDo|noch beschreiben: wie sieht ein REPO-Datensatz aus?}}

'''Archiv-Signatur'''
Die '''Signatur''' ist der Code bzw. die Referenz, mit dem eine Quelle im Archiv identifiziert wird und damit jederzeit auffindbar ist.

====== Archiv-Medientyp ======
(Quelle, Medientyp) Eine der Medienklassifikationen, die angibt auf welcher Art von Material die Quelle abgelegt ist.

====== Archiv-Notiz ======
(Verfasser, Text) Kommentare oder Meinungen des Verfassers zum Quell-Archiv-Zitat.

==== Archivbeschreibung ====
{{WT-ToDo|Handbuch Im Aufbau...}}

===== Bezeichnung =====
(Name des Quellarchivs) Der offizielle Name des Archivs, in welchem die benannten Quellen gelagert sind.

===== Adresse =====
Die Adress-Struktur sollte so geformt werden, wie sie auf einem Adressaufkleber erscheinen würde.

===== E-Mail =====
(Adresse, E-Mail) Eine Adresse für elektronische Post, die zur Kontaktaufnahme genutzt werden kann, wie beispielsweise eine E-Mail Adresse.

===== Telefon =====
Eine Telefonnummer.

===== Fax =====
(Adresse, Fax) Eine Telefax-Telefonnummer, an die ein Faximile gesendet werden kann.

===== Internet-Adresse (URL) =====
(Adresse, Web Seite) Die Adresse der WWW-Seite.

==== Beispiele für Quellen ====
Um zu verstehen, wie man Quellen angibt und wie man auf sie verweist, sieht man sich am besten das eine oder andere Beispiel an. Die folgenden Abschnitte führen Beispiele auf, in welchem Format eine genealogische Quelle vorliegen kann. Es wird jeweils gezeigt, welche Angaben man wie in der Quellenverwaltung in webtrees eingeben sollte. Eine Übersicht über die verschiedenen Arten von Quellen findet man im GenWiki in der [[:Kategorie:Quellengattung|Kategorie:Quellengattung]] gesammelt.

{{Wichtig|Tragen Sie ausreichende Angaben ein, so dass Sie oder jemand anders die Quelle wiederfinden und die Genauigkeit der Angaben beurteilen kann. Vermeiden Sie Abkürzungen!}}

===== Mikroverfilmtes Schriftstück (z.B. Kirchenbücher) =====
Im Folgenden finden Sie wesentliche Felder, die Sie bei einer mikroverfilmten Urkunde ausfüllen sollten.

====== Quellenzitat ======
'''Quelle''' - Link zur Quellenbeschreibung

'''Details zur Zitierung''' - Seite 19, Nr. 103

'''Ereignis''' - Heirat

'''Rolle''' -

'''Datum des Eintrages in der ursprünglichen Quelle''' -

'''Text''' -

'''Medienobjekt''' - Link zu einer digitalen Kopie

'''Notiz''' -

'''Datenqualität''' - sicher, Primärquelle

====== Quellenbeschreibung ======
'''Titel''' - Kirchenbuch St. Lorenz, Nürnberg, Trauungen 1874-1884

'''Abkürzung''' -

'''Daten-Ereignisse''' - Heirat

'''Daten-Datumsbereich''' - 1874-1884

'''Daten-Ort''' - St. Lorenz, Nürnberg

'''Daten-Institution''' -

'''Daten-Notiz''' -

'''Verfasser''' -

'''Veröffentlichung''' -

'''Text''' -

'''Notiz''' -

'''Multimedia''' -

'''Archiv''' - Link zum Archiv

'''Archiv-Signatur''' -

'''Archiv-Medientyp''' - Mikrofilm

'''Archiv-Notiz''' -

====== Archivbeschreibung ======
'''Bezeichnung''' - Landeskirchliche Archiv der Evangelisch-Lutherischen Kirche in Bayern

'''Adresse''' - Evang.-Luth. Dekanat Nürnberg, Burgstr. 1-3, 90403 Nürnberg

'''E-Mail''' - dekanat.nuernberg@elkb.de

'''Telefon''' - 0911- 214 1111

'''Fax''' -

'''Internet-Adresse (URL)''' - www.nuernberg-evangelisch.de

===== Dokumente in Online-Archiven (z.B. Kirchenbücher) =====
Im Folgenden finden Sie wesentliche Felder, die Sie bei einer Quelle aus einem Online-Archiv ausfüllen sollten.

====== Quellenzitat ======
'''Quelle''' - Link zur Quellenbeschreibung

'''Details zur Zitierung''' - Seite 19, Nr. 103

'''Ereignis''' - Heirat

'''Rolle''' -

'''Datum des Eintrages in der ursprünglichen Quelle''' -

'''Text''' -

'''Medienobjekt''' - Link zu einem Screenshot

'''Notiz''' -

'''Datenqualität''' - sicher, Primärquelle

====== Quellenbeschreibung ======
'''Titel''' - Kirchenbuch St. Lorenz, Nürnberg, Trauungen 1874-1884

'''Abkürzung''' -

'''Daten-Ereignisse''' - Heirat

'''Daten-Datumsbereich''' - 1874-1884

'''Daten-Ort''' - St. Lorenz, Nürnberg

'''Daten-Institution''' -

'''Daten-Notiz''' -

'''Verfasser''' -

'''Veröffentlichung''' -

'''Text''' -

'''Notiz''' -

'''Multimedia''' -

'''Archiv''' - Link zum Archiv

'''Archiv-Signatur''' - http://archion.de/p/c1f7501b97/

'''Archiv-Medientyp''' - Mikrofilm

'''Archiv-Notiz''' - Original: Landeskirchliche Archiv der Evangelisch-Lutherischen Kirche in Bayern

====== Archivbeschreibung ======
'''Bezeichnung''' - Archion

'''Adresse''' - Kirchenbuchportal GmbH, Balinger Str. 33/1, 70567 Stuttgart

'''E-Mail''' - info@archion.de

'''Telefon''' - 0711 - 78237880

'''Fax''' -

'''Internet-Adresse (URL)''' - www.archion.de

===== Geburtsurkunden und ähnliche Dokumente =====
Im Folgenden finden Sie wesentliche Felder, die Sie bei einer Geburtsurkunde oder einem sonstigen Dokument ausfüllen sollten. 

{{Wichtig|Wenn Sie eine Abschrift, einen Index oder eine Zusammenfassung verwendet haben, geben Sie dies als Quelle an und nicht das dort referenzierte Dokument.}}

====== Quellenzitat ======
'''Quelle''' -

'''Details zur Zitierung''' -

'''Ereignis''' -

'''Rolle''' -

'''Datum des Eintrages in der ursprünglichen Quelle''' -

'''Text''' -

'''Medienobjekt''' -

'''Notiz''' -

'''Datenqualität''' -

====== Quellenbeschreibung ======
'''Titel''' -

'''Abkürzung''' -

'''Daten-Ereignisse''' -

'''Daten-Datumsbereich''' -

'''Daten-Ort''' -

'''Daten-Institution''' -

'''Daten-Notiz''' -

'''Verfasser''' -

'''Veröffentlichung''' -

'''Text''' -

'''Notiz''' -

'''Multimedia''' -

'''Archiv''' -

'''Archiv-Signatur''' -

'''Archiv-Medientyp''' -

'''Archiv-Notiz''' -

====== Archivbeschreibung ======
'''Bezeichnung''' -

'''Adresse''' -

'''E-Mail''' -

'''Telefon''' -

'''Fax''' -

'''Internet-Adresse (URL)''' -

===== Gespräch und mündlich überlieferte Geschichte =====

===== Personenstandsregister =====

===== Quellen im Internet =====
 

===== Quellen aus der Familie =====
 

===== Aufzeichnung und Stammbaum der Familie =====
 

===== Veröffentlichtes Buch =====
 

===== Mehrbändiges Buch =====
 

===== Im Eigenverlag herausgegebenes Buch =====
 

===== Zeitschriften- oder Zeitungsartikel =====
 

===== Schriftverkehr (z.B. Briefe, E-Mail) =====
 

===== Persönliches Tagebuch =====
 

===== Physische Datenträger =====
... CD, Festplatte, USB-Stick, ...
 

===== Eigenes Wissen =====
 

===== Objekt mit Beschriftung =====

{{Wichtig|Vorschläge zur optimalen Datenerfassung von Quellen und Archiven mit dem Ziel, eine qualitative und standard-gerechte Erfassung zu erreichen 
- Tragen Sie ausreichende Angaben ein, so dass Sie oder jemand anders die Quelle wiederfinden kann. 
- Geben Sie einen Hinweis auf die Genauigkeit oder Zuverlässigkeit der Quellenanagaben. 
- Wenn Sie eine Abschrift, einen Index oder eine Zusammenfassung verwendet haben, geben Sie dies als Quelle an und nicht das dort referenzierte Dokument. 
- tbd
}}

== Einzelnachweise ==
<references />

[[Kategorie:Webtrees]]
[[Kategorie:Genealogisches Basiswissen]]

Webtrees Handbuch/Entwicklungsumgebung

2023-03-14T20:42:02Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Kapitel 9|info=1|sticktable=1}}{{WT-Inhaltsverzeichnis|Kapitel 9|A}}

Selbst wenn Sie selbst keine Module für webtrees entwickeln wollen, werden Sie dennoch mit der Entwicklungsumgebung in Kontakt kommen. Etwa wenn Sie bei der Nutzung von webtrees auf einen Fehler stoßen oder wenn Ihnen eine Funktion nicht ausreicht. Es kann auch sein, dass Sie etwas an der deutschen Übersetzung stört. Oder sie stoßen auf Fragen, die Sie auch nach der Lektüre dieses Handbuchs nicht geklärt bekommen.

In diesem Kapitel des Handbuchs erfahren Sie, wie Sie in diesen Fällen weiterkommen und wie Sie sich selbst in die webtrees-Gemeinschaft einbringen können. Vielleicht wollen Sie auch ein Modul von webtrees an ihren Bedarf anpassen oder sogar ein neues Modul entwickeln. Das kann leichter sein, als Sie vielleicht denken. Dazu im [[Webtrees_Handbuch/Entwicklungsumgebung#Anpassung_und_Entwicklung_eigener_Module|vorletzten Abschnitt]] dieses Kapitels mehr. Es kann aber auch sein, dass Sie nur eine Darstellung in der Bedienoberfläche anpassen möchten, das kann mit Hilfe des Moduls "[[Webtrees Handbuch/Entwicklungsumgebung#Anpassungen mit dem Modul "CSS und JS"|CSS und JS]]" eventuell ganz einfach sein. Einige Beispiele dazu finden Sie im [[Webtrees Handbuch/Entwicklungsumgebung#Anpassungen mit dem Modul "CSS und JS"|letzten Abschnitt]] dieses Kapitels.

Es gibt also viele Möglichkeiten, wie Sie einen Beitrag zu webtrees leisten können. Zum Beispiel indem Sie

* [[Webtrees Handbuch/Entwicklungsumgebung#Klärung von Fragen|Fragen von anderen Nutzern beantworten]]
* [[Webtrees Handbuch/Entwicklungsumgebung#Analyse und Meldung von Programmfehlern|Probleme melden, wenn Sie Fehler finden]]
* [[Webtrees Handbuch/Entwicklungsumgebung#Verbesserungsvorschläge für webtrees|neue Funktionen oder Verbesserungen vorschlagen]]
* [[Webtrees Handbuch/Entwicklungsumgebung#Verbesserungsvorschläge für die deutsche Übersetzung|Texte übersetzen]]
* [[Webtrees Handbuch/Entwicklungsumgebung#Verbesserungsvorschläge für dieses Handbuch|Dokumentation verbessern]]
* [[Webtrees Handbuch/Entwicklungsumgebung#Anpassung und Entwicklung eigener Module|Programm-Code verbessern oder ganz neue Module programmieren]]
* [[Webtrees Handbuch/Entwicklungsumgebung#Testen|Funktionen testen.]]

== Klärung von Fragen ==
Ein unschätzbarer Vorteil bei der Nutzung von webtrees ist die viel gelobte Gemeinschaft der Anwender dieses Programms. Zu jeder Frage, zu jedem Problem gibt es kurzfristige und kompetente Hilfe durch die Entwickler und andere Nutzer von webtrees.

=== webtrees-Forum ===
<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 webtrees-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 webtrees erscheinen.

Das Forum ist in verschiedene Themenstränge gegliedert
* Help for version 2.1 - hier geht es um alle Fragen zur aktuellen Version
* 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 1.7 - alle Fragen zur eingefrorenen Version 1.7 (und frühere)
* Open discussion - Fragen mit übergeordnetem Charakter (Strategie, Genealogie allgemein)
* 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 webtrees
* Converting from PhpGedView (PGV) - Umstieg vom Vorgängerprogramm PhpGedView auf webtrees

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
* webtrees 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 das, ggf. müssen Sie es aber selber tun.
* 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.
* 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 „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.
* 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.
* 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.

=== Discourse ===
Im System "[https://discourse.genealogy.net Discourse]" von [https://www.compgen.de CompGen] gibt es einen eher wenig genutzten [http://list.genealogy.net/mm/listinfo/php-gedview-l Themenstrang] zu webtrees. Dort erfolgt die Diskussion immer in deutscher Sprache.

{{-}}

== Analyse und Meldung von Programmfehlern ==
Bei einem so umfangreichen Programm wie webtrees ist es unvermeidlich, dass es Fehler im Programm gibt. Mit jedem neuen Release werden Fehler behoben, aber es kommen auch neue dazu. Es gibt aber auch Fehlerquellen, die außerhalb von webtrees liegen, etwa wenn Sie als Webmaster eine neue Version von PHP aktivieren oder wenn ihr Webhoster Änderungen in der Systemumgebung vornimmt. Auch die von webtrees mitgelieferten Bibliotheken von anderen Entwicklern kommen immer wieder als Quelle für Fehler in Frage.

Manche Fehler sind so gravierend, dass Sie keinen Zugang mehr zu ihrer Website haben, andere führen zu einer Fehlermeldung und wieder andere führen dazu, dass sich webtrees nicht so verhält, wie Sie es erwarten. Mit diesen Arten von Fehlern beschäftigen sich die folgenden Abschnitte. Nicht hierher gehören Fehler in den genealogischen Daten selbst, also fehlerhafte GEDCOM-Strukturen (siehe Abschnitt [[Webtrees Handbuch/Anleitung für Administratoren/Stammbäume|Fehlersuche]]) sowie unplausible oder falsche genealogische Daten.

=== Fehler mit einer Fehlermeldung ===
[[datei:WT_2.1_Fehlermeldung-Stacktrace.png|thumb|right|350px|Fehlermeldung mit Stacktrace<ref>{{wikipedia-Link|Stacktrace}}</ref>]]
Es kann passieren, dass Sie bei der Nutzung des Programms einen Fehler angezeigt bekommen. Das kann in etwa so aussehen, wie im Screenshot auf der rechten Seite.

Die oberste Zeile weist auf die Stelle hin, bei der der Fehler aufgetreten ist. Das muss nicht unbedingt die Stelle sein, die den Fehler verursacht. Deshalb enthält die Fehlermeldung noch weitere Zeilen, die zeigen welche Programmfunktionen zuvor aufgerufen worden sind.

Wenn die Stelle, an der der Fehler aufgetreten ist, zu einem [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule|Erweiterungsmodul]] gehört, dann sollten Sie als erstes dieses [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule|Erweiterungsmodul]] deaktivieren und testen, ob damit auch der Fehler verschwindet. Wenn Sie dann das betreffende [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule|Erweiterungsmodul]] wieder aktivieren und der Fehler wieder auftritt, dann haben Sie den Fehler ziemlich sicher lokalisiert und können diesen auf der GitHub-Seite des Erweiterungsmoduls als "issue" melden. Zuvor sollten Sie aber in der Liste der offenen "issues" nachsehen, ob dieser Fehler bereits gemeldet worden ist. Es kann aber auch sein, dass die Aktion, bei der es zur Fehlermeldung kam, ganz klar zur Funktion des [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule|Erweiterungsmoduls]] gehört, die in der Fehlermeldung angezeigt worden ist. Dann ist die Zuordnung recht klar und Sie können sich das Deaktivieren des Erweiterungsmoduls eventuell sparen, wenn Sie und die übrigen Nutzer bis zur Fehlerbehebung mit dem Fehlverhalten leben können.

Wenn die Fehlerstelle in einer Funktion des webtrees-Kerns liegt, dann melden sie diesen Fehler auf der GitHub-Seite von webtrees. Wenn der Fehler sehr gravierend ist und sie nicht bis zur Fehlerbehebung warten können, dann bleibt eventuell nur das Einspielen einer früheren Version von webtrees aus einer Datensicherung. Dies sollten Sie aber ggf. zuvor im webtrees-Forum abklären.

{{WT-ToDo|Noch beschreiben: wie legt man einen issue in GitHub an (für Core und für Erweiterungsmodul) und was sollte man melden (Was habe ich getan, was habe ich erwartet, wie sehen die obersten Zeilen der Fehlermeldung aus (etwa 10 Zeilen kopieren)}}

=== Sicherheitsrelevante Fehler ===
Fehler, die zu Problemen mit der Datensicherheit oder mit dem Datenschutz führen, treten nur sehr selten auf. Wenn Sie auf einen solchen Fehler in webtrees stoßen sollten, dann melden Sie diesen bitte umgehend. Allerdings auf keinen Fall unter Verwendung des Forums oder von GitHub, sondern in einer direkten E-Mail an [mailto:greg@subaqua.co.uk Greg Roach].

Für die Behebung von Sicherheitsproblemen ihres Webservers, oder anderen Dingen, die nichts mit webtrees zu tun haben, sind Sie als Webmaster oder der Betreiber ihrer Website zuständig. Sicherheitsprobleme können auch in PHP stecken. Die Entwickler von PHP pflegen nur noch die Versionen ab 7.4.

==== Gepflegte Versionen ====
Sicherheitsrelevante Fehler können eventuell schon seit längerer Zeit unerkannt im Code von webtrees stecken. Allerdings werden nur die webtrees-Versionen ab 2.0 noch gepflegt. Betreiber von älteren und damit nicht mehr unterstützten Versionen müssen sich selbst um die Behebung von neu entdeckten Sicherheitslücken kümmern.

==== Reaktionszeiten ====
Sie können innerhalb von 24 Stunden nach Meldung des Problems per E-Mail mit einer Bestätigung rechnen.

Denken Sie daran, dass nicht alle E-Mails zugestellt werden und dass einige Teile der Welt keinen Internetzugang haben. Wenn Sie keine Antwort erhalten, senden Sie bitte eine Folge-E-Mail. Wenn Sie immer noch keine Antwort erhalten, versuchen Sie bitte über das Projektforum unter [https://webtrees.net webtrees.net] Kontakt aufzunehmen.

Abhängig von der Komplexität und Schwere des Problems wird versucht werden, innerhalb von zwei bis sieben Tagen eine Lösung zu veröffentlichen.

==== Offenlegung und Zuschreibung ====
Bitte warten Sie bis eine neue Version von webtrees verfügbar ist, die das gemeldete Sicherheitsproblem behebt, bevor Sie Details zu dem Problem veröffentlichen. Wenn Sie wünschen, dass Ihnen ihre Entdeckung zugeschrieben werden soll, sagen Sie bitte Bescheid.

=== Unerwartetes Verhalten des Programms ===
Es kann vorkommen, dass sich webtrees für Sie unerwartet verhält. Eine Funktion reagiert anders als erwartet oder eine Darstellung auf dem Bildschirm sieht nicht so aus, wie Sie es erwarten. Dies kann, muss aber nicht, eine Fehlfunktion von webtrees sein, denn vielleicht haben Sie auch eine andere Erwartung. Demnach ist es also in so einem Fall erst einmal sinnvoll, sich die entsprechende Stelle noch einmal genau anzusehen. Hierbei sollte auch dieses Handbuch helfen.

Und Sie sollten versuchen, die möglichen Fehlerursachen etwas einzugrenzen. Wenn Sie Erweiterungsmodule nutzen, sollten Sie diese erst einmal deaktivieren. Wenn das unerwartete Verhalten dann immer noch auftritt, können Sie davon ausgehen sein, dass das Problem bei webtrees selbst liegt. Andernfalls aktivieren Sie nacheinander die Erweiterungsmodule wieder und finden so das Modul, das für das Fehl- oder unerwartete Verhalten verantwortlich ist.

Wenn Sie sich auch danach noch nicht sicher sind, ob es sich um einen Fehler handelt, sollten Sie das Problem im webtrees-Forum zur Klärung bringen.

Bitte beschreiben Sie dazu
* was Sie erreichen wollten
* was Sie konkret zuletzt getan haben, bevor der Fehler oder das unerwartete Verhalten auftrat
* was passiert ist (am besten mit einem Screenshot dokumentiert)
* was Sie erwartet haben, aber nicht passiert ist

=== Bildschirm ist leer ===
Eine leere Seite bedeutet, dass zwei Dinge passiert sind<ref>Übersetzung der Seite https://webtrees.net/faq/500/.</ref>

* Beim Erstellen der Webseite ist ein schwerwiegender Fehler aufgetreten.
* Ihr Webserver (z. B. Apache, Nginx, IIS) ist so konfiguriert, dass er schwerwiegende Fehler nicht auf dem Bildschirm anzeigt.

Typische Ursachen für fatale Fehler sind

*'''Inkompatible Software''': Zum Beispiel die Verwendung von PHP 7.3 mit einer Software, die für PHP 7.4 entwickelt wurde.
* '''Dateiberechtigungen''': webtrees benötigt auf alle Dateien und Unterordner im Ordner "/data" Schreibzugriff.
* Der '''Speicherplatz''' ist erschöpft: Sie können prüfen, ob dies ein Problem ist, indem Sie eine große Datei per FTP auf den Server hochladen (und dann löschen).
* Die '''CPU-Zeitbegrenzung''' wurde erreicht: Sie können dies daran erkennen, dass der Fehler erst erscheint, wenn einige Zeit ohne Reaktion vergangen ist.
* Kein '''Arbeitsspeicher''' mehr vorhanden: Dies kann durch Programmfehler oder durch die Verarbeitung zu vieler Daten auf einmal, verursacht werden. Zum Beispiel, wenn Sie versuchen, mehrere tausend Personen gleichzeitig aufzulisten.
* '''Blockierte PHP-Funktion''': Durch den Server wurden Funktionen blockiert. Zum Beispiel kann die Funktion, die zum Versenden von E-Mails benötigt wird, blockiert sein.

Wenn ein schwerwiegender Fehler auftritt, schreibt der Webserver in der Regel eine detaillierte Fehlermeldung in eine Protokolldatei. Sie müssen dieses Fehlerprotokoll finden (siehe nachfolgender Abschnitt "[[Webtrees Handbuch/Entwicklungsumgebung#Weitere Methoden zur Fehleranalyse|Weitere Methoden zur Fehleranalyse]]"). Ohne diese Datei wird es sehr schwierig sein das Problem zu beheben.

Wenn Ihr Server [[Webtrees_Handbuch/Anleitung_für_Webmaster#.htaccess|.htaccess]]-Dateien unterstützt, können Sie versuchen, dort die folgenden Zeilen einzufügen (nicht alle Server unterstützen diese Funktion)

<syntaxhighlight lang="ApacheConf">
php_flag display_errors on
php_flag display_startup_errors on
php_value error_reporting -1
</syntaxhighlight>

=== Weitere Methoden zur Fehleranalyse ===
{{WT-ToDo|Analyse der diversen Log-Files beschreiben}}
Beachten Sie, dass Ihr Webserver zwei [[Webtrees Handbuch/Anleitung für Webmaster#Logfile-Überwachung|Protokolldateien]] erstellt. Eine ist das Zugriffsprotokoll und die andere ist das Fehlerprotokoll. Sie benötigen für die Fehlersuche das Fehlerprotokoll. Das Zugriffsprotokoll kann Hinweise geben, falls verstärkte Angriffsversuche aus dem Internet auf ihren Server stattfinden.

Wenn Sie das Fehlerprotokoll nicht finden können, sollten Sie Ihren Hosting-Anbieter um Hilfe bitten.

{{WT-ToDo|Nutzung von Browser-Entwickler-Funktionen zur Fehleranalyse beschreiben}}

{{-}}

== Verbesserungspotentiale ==
Im Laufe der Jahre ist webtrees regelmäßig mit vielen kleinen Änderungen verbessert worden. Immer wieder gab es aber auch große Schritte in Richtung zu einer modernen Software-Architektur und zu einem modularen Konzept. Es gibt aber noch immer Punkte, die in webtrees unbefriedigend gelöst sind. Und es gibt eine Reihe von Erweiterungswünschen. Auf Beides wird im folgenden näher eingegangen. Eine Liste von gewünschten neuen Funktionen ist auch im [https://www.webtrees.net/index.php/en/forum/9-request-for-new-feature webtrees-Forum] zu finden.

=== Berichte lassen sich nicht pflegen und weiter entwickeln ===
Die interne Struktur zur Erzeugung der Berichte unter Nutzung von XML ist veraltet. Das hat zur Folge, dass diese nicht mehr gewartet oder gar erweitert werden können. Das wäre jedoch nötig, da das Layout, die Auswahl der Inhalte und die Anpassungsmöglichkeiten unbefriedigend sind. Die Berichte müssten von Grund auf neu entwickelt werden. Das wird auch im Forum immer wieder moniert und erklärt, hat aber leider eine niedrige Priorität.

Darüber hinaus greift das Berichtssystem direkt auf die GEDCOM-Daten zu und verwendet nicht wie alle anderen Module von webtrees interne, gekapselte Datenstrukturen. Damit gibt es auch keine Möglichkeit an der Art der Speicherung der GEDCOM-Daten etwas zu verändern.

=== Authentifizierung von Nutzern ===
Die Authentifizierung der Nutzer von webtrees nur per Nutzerkennung und Passwort ist nicht mehr zeitgemäß. Es fehlt an der Möglichkeit

* mehrere E-Mail-Adressen mit einem Nutzerkonto zu verknüpfen
* externe Identitätsanbieter anzubinden
* eine API für externe Anwendungen anzubieten (und die Zugriffe darüber per Token zu gestatten).

=== Fehlende Plausibilitätsprüfungen ===
Derzeit wird in webtrees zwar die Einhaltung der GEDCOM-Grammatik geprüft, die Daten selbst werden aber so gut wie nicht analysiert. Um die Plausibilität der genealogischen Daten zu überprüfen, existieren nur sehr wenige Funktionen, es besteht aber der Bedarf für mehr Überprüfungen. Personen, die mehr als zweihundert Jahre alt wurden, die im Alter von 10 Jahren geheiratet haben oder noch nach ihrem Tod Eltern wurden, lassen darauf schließen, dass da etwas nicht korrekt abgebildet ist. Für Ereignisse vor der Geburt oder nach dem Tod einer Person gibt es in der Bedienoberfläche kleine Hinweise. Hilfreich wären Berichte, in denen solche Fehler aufgelistet werden oder Prüfungen, die schon bei der Dateneingabe explizite Hinweise geben.

=== Unzureichende grafische Diagramme ===
Zur Darstellung von Personen und Familien in einem Stammbaum gibt es unterschiedliche Diagramme, aber derzeit gibt es keinerlei Schmuckdiagramme, also künstlerische Darstellungen, etwa mit einem gezeichneten Baum im Hintergrund.

=== Unterstützung lang dauernder Verarbeitungsschritte ===
Es gibt Verarbeitungsschritte, die bei großen Datenmengen oder bei hoher Komplexität sehr lange dauern. So etwa der Import von sehr großen Stammbäumen, das Suchen und Ersetzen bei großen Datenmengen oder die Suche von Fehlern in umfangreichen genealogischen Daten. Da webtrees eine Webanwendung ist, dürfen solche Operationen nicht beliebig lange dauern, da ein Browser nach einer bestimmten Zeit eine Antwort des webtrees-Servers erwartet; wenn diese nicht eintrifft, bricht der Browser ggf. die Verbindung ab und der Nutzer erhält eine Fehlermeldung oder einen leeren Bildschirm. Bei diversen Operationen, die länger dauern könnten, enthält webtrees bereits interne Lösungen, die solche Aufgaben in kürzere Teilaufgaben zerlegt. Dieses Verfahren müsste aber generalisiert werden und dann an noch mehr Stellen zum Einsatz kommen.

=== Unterstützung von GEDCOM 7.0 ===
Bislang unterstützt webtrees den GEDCOM-Standard 5.5.1 und diverse GEDCOM-Dialekte. Beim Import ist webtrees sehr tolerant gegenüber den zu importierenden Strukturen. Sehr vieles wird erkannt und bleibt intern erhalten, selbst wenn es sich um Erweiterungen oder Abweichungen zum Standard handelt. Beim Export von Stammbäumen wird implizit der Standard 5.5.1 unterstützt. Es gibt noch kein Konzept wie der aktuelle GEDCOM-Standard 7.0 neben dem weit verbreiteten Standard 5.5.1 parallel unterstützt werden kann. Damit ist auch noch nicht klar, wann webtrees einen Export gemäß GEDCOM 7.0 anbieten wird.

=== Schwierigkeiten bei der Anpassung der Bedienoberfläche ===
webtrees eröffnet Möglichkeiten, Teile von Standardmodulen zu überschreiben und so Ansichten oder Funktionen zu ändern, ohne in dem Erweiterungsmodul alle Funktionen erneut implementieren zu müssen, nur um Kleinigkeiten in der Darstellung zu ändern. Die Vorgehensweise im webtrees-System ist jedoch nicht perfekt, da möglicherweise verschiedene Erweiterungsmodule dieselbe Ansicht überschreiben. Es gibt keinen Erkennungsmechanismus für mögliche Konflikte (das zuletzt registrierte Modul gewinnt), sodass das Verhalten von webtrees in so einem Fall nicht stabil vorhersagbar ist.

Und das Überschreiben von Funktionen ist nicht immer das Ziel, manchmal soll ein Erweiterungsmodul nur einen bestimmten Teil der Bedienoberfläche erweitern, also etwa ein Objekt vor der Anzeige manipulieren oder unterdrücken. Weitere Beispiele sind etwa das Hinzufügen von Icons zu Elementen in der Bedienoberfläche oder das Ergänzen eines Punktes in einem Akkordeon-Konstrukt. Oder auch kleinere Ergänzungen in der Darstellung einer Tabelle, etwa die Ergänzung um eine weitere Spalte.

==== Planungssicherheit ====
Es gibt keine detaillierte Release-Planung für webtrees. Für die nächste größere Version 2.2 von webtrees sind die folgenden Themen vorgesehen<ref>siehe [https://github.com/fisharebest/webtrees/projects/1 Projektreiter bei GitHub]</ref>

* [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodule]] sollen besser verwaltet werden können: Installation, Upgrade und Entfernung der Module soll durch den Administrator erfolgen können.
* PHP 8.2 soll unterstützt werden (und die Unterstützung von PHP 7.4 soll beendet werden).
* Diverse Dritt-Pakete sollen in einer aktuelleren Version zum Einsatz kommen.

Die Entwicklung des webtrees-Kerns erfolgt ohne Abstimmung mit den Autoren von Erweiterungsmodulen. Manchmal werden Funktionen aus Erweiterungsmodulen in den Kern übernommen, aber das ist eher selten der Fall. Zuletzt wurden etliche Funktionen rings um Ortsdatensätze (_LOC) in den Kern aufgenommen, die zuvor nur über die Vesta-Erweiterungsmodule zur Verfügung standen. Die mangelhafte Kommunikation kann dazu führen, dass Entwicklungen doppelt gemacht werden, oder Schnittstellen in Erweiterungsmodulen bei jedem neuen Release von webtrees angepasst werden müssen. Bis diese Anpassungen jeweils erfolgt sind, können davon betroffene Erweiterungsmodule für einige Zeit nicht mehr genutzt werden.

==== Abhängigkeit von Schnittstellen ====
Beim Erstellen komplexer Module können zusätzliche Herstellerbibliotheken erforderlich werden, die grundlegende Funktionen mit sich bringen. Das Hinzufügen von Bibliotheken zu den Standardbibliotheken kann sich als schwierig erweisen, da es Konflikte mit den vorhandenen Bibliotheken im Basispaket oder mit Bibliotheken bei anderen Erweiterungsmodulen geben kann. webtrees bietet keine Unterstützung bei der Verwaltung von Abhängigkeiten zwischen verschiedenen Modulen.

==== Keine automatische Aktualisierung von Erweiterungsmodulen ====
webtrees kennt neben dem manuellen Upgrade auch das sehr komfortable automatische Upgrade, bei dem nach einem Anstoß durch einen Administrator automatisch auf eine aktuelle Version von webtrees umgestellt wird. Dieser Mechanismus steht aber leider nicht für Erweiterungsmodule zur Verfügung. Mit der Version 2.2 von webtrees sollen erste Schritte in diese Richtung umgesetzt werden.

{{-}}

== Verbesserungsvorschläge ==
Sicherlich fallen Ihnen bei der Nutzung von webtrees im Laufe der Zeit Dinge auf, die man noch besser gestalten oder lösen könnte. Es gibt verschiedene Wege, die Sie dann einschlagen können, um Ihre Ideen kund zu tun. Näheres dazu wird in diesem Abschnitt beschrieben. Sie sollten aber bedenken, dass webtrees von Freiwilligen gepflegt und entwickelt wird, die ohne Bezahlung und in ihrer Freizeit aktiv sind. Es gibt also keinen Anspruch darauf, dass Fehler kurzfristig behoben werden oder dass Verbesserungsvorschläge irgendwann umgesetzt werden. Wenn Sie etwas stört, sollten Sie also zuerst darüber nachdenken, was Sie selbst aktiv beitragen können.

=== Verbesserungsvorschläge für webtrees ===
{{WT-ToDo|Beschreiben: im Forum in der Kategorie "Request for New Feature"}}
{{WT-ToDo|Beschreiben: über github (issue oder pull request)}}

=== Verbesserungsvorschläge für die deutsche Übersetzung ===
[[Datei:WT_2.0_webtrees-weblate.png|thumb|250px|webtrees Weblate-Instanz https://translate.webtrees.net/projects/webtrees/webtrees-20/]]

Die führende Sprache in webtrees ist Englisch. Sollten Ihnen fälschlich oder nicht übersetzte Wörter in einer anderen verwendeten Sprache auffallen, ist es möglich hier selber einen Beitrag zu leisten. Durch den webtrees-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-20/

Für die Bearbeitung ist ein Benutzerkonto erforderlich. Die Registrierung funktioniert leider nicht, statt dessen richten Sie einfach eine Anfrage per E-Mail an Greg Roach<ref>greg@subaqua.co.uk</ref>.

Übersetzungen von [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule|Erweiterungsmodulen]] erfolgen an anderer Stelle. Dazu bieten die entsprechenden Webseiten der jeweiligen Entwickler in der Regel weitergehende Hinweise.

{{-}}

=== Verbesserungsvorschläge für dieses Handbuch ===
Wenn Sie Fehler in diesem Handbuch finden oder entdecken, dass etwas fehlt oder ausführlicher beschrieben werden sollte, dann greifen Sie bitte in die Tasten, melden sich hier im GenWiki als Nutzer an und ändern oder ergänzen Sie bitte falsche oder fehlende Teile selbst. Wenn Sie sich nicht sicher sind, dann können Sie auf der parallelen Seite "Diskussion" eine Anmerkung hinterlassen.

{{-}}

== Anpassung und Entwicklung eigener Module ==
Als Entwicklungsplattform für webtrees wird GitHub<ref>siehe https://github.com/</ref> präferiert. Die Programmierung erfolgt mit der objektorientierten Variante von PHP<ref>{{Wikipedia-Link|PHP}}</ref> und einzelne Funktionen in der Bedienoberfläche werden in JavaScript<ref>{{Wikipedia-Link|JavaScript}}</ref> ausgeführt.

Wenn Sie eigene Module entwickeln möchten, sollten Sie sich mit den folgenden Themen vertraut machen
* Objektorientierte Programmierung mit PHP
* Programmierung mit JavaScript
* Web-Technologie (HTML, CSS, ...)
* Nutzung von GitHub.
Bitte beachten Sie, dass webtrees entsprechend der Lizenz GPL 3<ref>{{wikipedia-Link|GNU General Public License}}</ref> veröffentlicht wird und alle ihre Beiträge dazu unter derselben Lizenz stehen müssen. Bitte stellen Sie sicher, dass Sie die Rechte an allen ihren Zuarbeiten besitzen.

=== 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]]
webtrees 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
* Datenmodell (englisch model)
* Präsentation (englisch view) und
* Programmsteuerung (englisch controller).
Das Ziel ist ein flexibler Programmentwurf, der eine spätere Änderung oder Erweiterung erleichtert und eine Wiederverwendbarkeit der einzelnen Softwarekomponenten ermöglicht.

Das Datenmodell von webtrees folgt weitgehend den im GEDCOM-Standard definierten Strukturen. Das Datenmodell wird unter anderem in den Tabellen in der Datenbank abgebildet. Direkte Zugriffe auf die Datenbank, etwa aus webtrees-Funktionen in Erweiterungsmodulen heraus, sollten, dem Architekturansatz folgend, nicht stattfinden.

Die Präsentation in der Bedienoberfläche ist bei webtrees weitgehend entkoppelt von den Funktionen, die die Inhalte bereitstellen, die präsentiert werden sollen. Eine bei Nutzung von PHP im Prinzip mögliche Durchmischung von komplexen Funktionen in PHP-Code und html-Code zur Präsentation wird weitgehend vermieden. JavaScript wird nur für Funktionen in der Bedienoberfläche genutzt, nicht aber für komplexe Funktionen. Eine Ausnahme sind spezielle Erweiterungsmodule, wie etwa das [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/TAM und Lineage|TAM-Modul]] zur Anzeige eines topografischen Knoten-Kanten-Diagramms.

Bei der Gestaltung der Bedienoberfläche wird in webtrees Bootstrap in der Version 5.2 eingesetzt. Bootstrap ist ein freies Frontend-CSS-Framework. Es enthält auf HTML und CSS basierende Gestaltungsvorlagen für Typografie, Formulare, Buttons, Tabellen, Grid-Systeme, Navigations- und andere Oberflächengestaltungselemente sowie zusätzliche, optionale JavaScript-Erweiterungen.

Die meisten Funktionen in webtrees werden in Modulen realisiert, die PHP-Klassen definieren und implementieren. Dadurch lassen sich diese Funktionen sehr leicht durch Erweiterungsmodule ergänzen oder ersetzen. Einzelne, als "public" gekennzeichnete, Funktionen in einer PHP-Klasse lassen sich in einem Erweiterungsmodul überschreiben und führen so zu einer modifizierten Funktionalität.

Anstatt eine Klasse durch eine eigene Klasse in einem Erweiterungsmodul zu überschreiben, könnte man natürlich auch direkt die Funktion im webtrees-Kern ändern indem man die entsprechende Datei durch eine modifizierte Datei ersetzt. Allerdings wird eine solche Änderung beim nächsten Upgrade von webtrees wieder überschrieben und kann damit verloren gehen, wenn man nicht genau aufpasst und solche Änderungen direkt im Kern penibel dokumentiert und nach jedem Upgrade wieder rekonstruiert. Daher sind solche Änderungen nicht sinnvoll. Wenn man ein erfahrener Softwareentwickler ist, kann man aber Vorschläge zur Änderung des webtrees-Kerns über "pull requests" in GitHub einbringen.

=== Entwicklungsumgebung und -werkzeuge ===
Die bevorzugte Entwicklungsumgebung für webtrees sollte GitHub unterstützen. Dort liegen die Archive (Repositories) für die Anwendung selbst und fast alle Erweiterungsmodule. Sie sollten sich also unbedingt mit den Funktionen von GitHub vertraut machen. Sie können Archive von anderen Nutzern klonen und getrennt oder gemeinsam weiter entwickeln. Es gibt von GitHub Anwendungen, die auf ihrem lokalen Entwicklungsrechner installiert werden, und die die lokalen Dateien mit den Dateien auf dem GitHub-Server synchron halten.

Als Entwicklungswerkzeug kann etwa PhpStorm zum Einsatz kommen. Für dieses mächtige Werkezeug können Sie auf Antrag eine kostenkose Lizenz vom Hersteller bekommen, wenn Sie angeben, dass Sie für das OpenSource-Programm webtrees entwickeln werden.

{{WT-ToDo|Wichtigste Funktionen von GitHub und von PhpStorm beschreiben, Links und Logo hinterlegen.}}

=== Struktur der webtrees-Ordner ===
Die Anwendung webtrees wird auf dem Server in einem Verzeichnis installiert, das für den Web-Server zugänglich ist.

Es sind sechs Unterordner vorhanden, die in der folgenden Tabelle beschrieben werden.
{| class="wikitable"
|+
!Verzeichnis
!Inhalt
|-
|<code>/</code>
|Im Wurzelverzeichnis von webtrees liegen Verwaltungsdateien (etwa für Composer), Favicon, Dokumentation (Readme, Lizenz), eventuell [[Webtrees_Handbuch/Anleitung_für_Webmaster#.htaccess|.htaccess]].
|-
|<code>/app</code>
|Hier liegen alle Dateien, die den Kern von webtrees ausmachen, etwa alle [[Webtrees_Handbuch/Anleitung_f%C3%BCr_Administratoren/Module|Module]].
|-
|<code>/data</code>
|Dieses [[Webtrees_Handbuch/Anleitung_f%C3%BCr_Administratoren/Webseite#Datenverzeichnis|Datenverzeichnis]] kann als einziges von der webtrees-Anwendung beschrieben werden; hier liegen alle Mediendateien, temporäre Dateien, Cache-Verzeichnisse, exportierte [[GEDCOM]]-Dateien und die Konfigurationsdatei [[Webtrees_Handbuch/Anleitung_f%C3%BCr_Webmaster#config.ini.php|config.ini.php]].
|-
|<code>/modules_v4</code>
|Hier liegen alle [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule|Erweiterungsmodule]].
|-
|<code>/public</code>
|Hier befinden sich der intern verwendete Editor, CSS-Dateien, Icons und zentrale JavaScript-Dateien.
|-
|<code>/ressources</code>
|Hier liegen unterstützende Elemente der Anwendung, wie Zeichensätze, Sprachdateien, Grafiken, Elemente der Bedienoberfläche und Berichtsvorlagen (XML).
|-
|<code>/vendor</code>
|Alle verwendeten Bibliotheken der genutzten Drittmodule sind in diesem Ordner versammelt.
|}

=== Codierungsstile und -standards ===
webtrees folgt einigen der "[https://de.wikipedia.org/wiki/PHP_Standard_Recommendation PHP Standard Recommendations (PSR)]". Eine PSR ist eine als Empfehlung verfasste Spezifikation, welche durch die "PHP Framework Interoperability Group (''PHP FIG'')" veröffentlicht wird. Eine PSR empfiehlt ausschließlich die Form der Programmierung ''mit'' PHP, nicht jedoch neue Features ''in'' PHP. Ziel der PSRs ist es, die Interoperabilität von Komponenten zu ermöglichen, Quellcode universell lesbar und verständlich zu machen und bewährte Konzepte in der Programmierung zu standardisieren.

<div class="stickytablewrapperh">
{| class="wikitable" style="max-width:95%"
!Nummer
!Name
!Beschreibung
!Status bzgl. webtrees
|-
|PSR-0
|Autoloading Standard
|Benennung von Komponenten in Bezug auf Hersteller, Namespace und Klasse sowie zugehörigen Verzeichnisnamen, so dass Komponenten bei Verwendung im PHP-Code bei Bedarf einheitlich automatisch nachgeladen werden können.
|veraltet; abgelöst durch PSR-4
|-
|PSR-1
|Basis Coding Standard
|Allgemeiner Programmierstil, der z. B. die Tags am Anfang eines PHP-Codes, den verwendeten Zeichensatz (UTF-8) sowie die Benennung von Klassen/Methoden regelt; erfordert die Umsetzung von PSR-0.
|ja
|-
|PSR-2
|Coding Style Guide
|Legt fest an welchen Stellen im Code Zeilenumbrüche bei Klammerausdrücken zu verwenden sind, Einrückungen und Leerzeichen oder die Sichtbarkeit von Eigenschaften und Methoden; erfordert die Umsetzung von PSR-1.
|ja
|-
|PSR-3
|Logger Interface
|Einheitliches Interface für Logmeldungen, zu verwendende Loglevel, Exceptions, das Format von Logmeldungen und zu verwendende Hilfsklassen in diesem Umfeld
|nicht verwendet, aber geplant
|-
|PSR-4
|Improved Autoloading
|Erweiterung der Autoloading-Spezifikation aus PSR-0
|ja
|-
|PSR-5
|PHPDoc
|Eine vollständige und formale Definition der PHPDoc-Syntax
|nicht relevant
|-
|PSR-6
|Caching Interface
|Interfaces für das Konzept des Caching
|ja
|-
|PSR-7
|HTTP Message Interfaces
|Einheitliches Interface für HTTP-Nachrichten und Umgang mit URIs
|ja
|-
|PSR-8
|Huggable Interface
|Aprilscherz
|nicht relevant
|-
|PSR-9
|Security Disclosure
|Vereinheitlichung von sicherheitsrelevanten Meldungen innerhalb von Projekten (inaktive PSR)
|?
|-
|PSR-10
|Security Advisories
|Vereinheitlichung der Kommunikation sicherheitsrelevanter Meldungen mit der Öffentlichkeit (inaktive PSR)
|?
|-
|PSR-11
|Container Interface
|Interface für Dependency Injection Containers
|ja
|-
|PSR-12
|Extended Coding Style Guide
|Erweitert PSR-1 und PSR-2 um weitere Regeln zum Programmierstil
|ja
|-
|PSR-13
|Hypermedia Links
|Spezifikation bzgl. einheitlicher Darstellung von hypermedialen Links.
|?
|-
|PSR-14
|Event Manager
|Einheitliche Schnittstellen für die Implementierung von Events.
|?
|-
|PSR-15
|HTTP Handlers
|Gemeinsame Schnittstellen für HTTP-Server-Request-Handler und HTTP-Server-Middleware-Komponenten, die HTTP-Nachrichten verwenden
|ja
|-
|PSR-16
|Simple Cache
|Vereinfachte Schnittstelle für Caching-Bibliotheken
|?
|-
|PSR-17
|HTTP Factories
|Standard für Fabrikmethoden zur Erstellung von PSR-7-kompatiblen Objekten
|ja
|-
|PSR-18
|HTTP Client
|Standard zum Senden und Empfangen von HTTP-Anfragen
|?
|-
|PSR-19
|PHPDoc tags
|Katalog von PHPDoc-Tags
|nicht relevant
|-
|PSR-20
|Clock
|Standardmethode für den Zugriff auf die Uhrzeit; ermöglicht die Interoperabilität während des Testens, wenn ein Verhalten getestet wird, das zeitbasierte Nebenwirkungen hat.
|?
|}
</div>
JavaScript wird in webtrees entsprechend dem "Semi-Standard" programmiert.

=== Beispiele für Erweiterungsmodule ===
Um den Einstieg in die Programmierung von [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule|Erweiterungsmodulen]] einfacher zu machen, gibt es einige Beispielmodule, die als Vorlage für eigene Module genutzt werden können.
{| class="wikitable"
|+
!Modul
!Download
!Beschreibung
|-
|example-module
|[https://github.com/webtrees/example-module GitHub]
|Nutzung eines einfachen Basis-Moduls etwa um nutzerspezifische Übersetzungen vorzunehmen
|-
|example-module-custom-tags
|[https://github.com/webtrees/example-module-custom-tags GitHub]
|Definition von benutzerspezifischen GEDCOM Tags
|-
|example-module-theme
|[https://github.com/webtrees/example-module-theme GitHub]
|Erweiterung eines Themen-Moduls
|-
|example-module-middleware
|[https://github.com/webtrees/example-module-middleware GitHub]
|Erstellung eines "Middleware" Moduls, das vor und nach jeder Web-Anfrage ausgeführt wird, etwa um Anfragen von bestimmten IP-Adressen zu blockieren oder um einen benutzerdefinierten HTTP-Header hinzuzufügen.
|-
|example-module-footer
|[https://github.com/webtrees/example-module-footer GitHub]
|Erweiterung der Fußzeilen auf der Webseite
|-
|example-module-server-config
|[https://github.com/webtrees/example-module-server-config GitHub]
|Änderungen an den Einstellungen von PHP oder der Datenbank
|}

Neben den Beispielmodulen ist aber auch das Studium anderer Erweiterungsmodule bei der Einarbeitung in die Programmierung für webtrees sehr hilf- und lehrreich. Bei spezifischen Fragen zu einzelnen Funktionen kann auch das Forum genutzt werden.

=== Grundsätzlicher Aufbau eines Erweiterungsmoduls ===
Im folgenden werden die zu einem Erweiterungsmodul gehörenden Komponenten und wichtige grundsätzliche Funktionsprinzipien beschrieben.

Die Beschreibung erfolgt an Hand des in der obigen Tabelle verlinkten Beispielmoduls <code>example-module-footer</code>. Um das Beispiel nachzuvollziehen, bietet es sich an, sich bei GitHub anzumelden und dort ein Repository anzulegen. In dieses Verzeichnis kopiert man dann die Beispieldateien.

==== module.php ====
Zu jedem Erweiterungsmodul gehört ein Startmodul <code>module.php</code>, das automatisch gefunden und gestartet wird. Dieses Modul kann in etwa folgendermaßen aussehen
<syntaxhighlight lang="php">
<?php

/**
* Example footer with a link to a page of information.
*/

declare(strict_types=1);

namespace ExampleNamespace;

require __DIR__ . '/ExampleModuleFooter.php';

return new ExampleModuleFooter();
</syntaxhighlight>

Das Modul enthält PHP-Code, wie auch an der Dateiendung zu erkennen ist. Es wird hier optional festgelegt, dass die Typen von Variablen und Funktionen strikt beachtet werden sollen. Diese Festlegung muss in jeder einzelnen Datei wiederholt werden. Danach wird ein spezifischer Namensraum für das Modul definiert; der Namensraum kann frei gewählt werden; der gewählte Namensraum muss dann in allen PHP-Dateien des Moduls in gleicher Form wieder auftauchen. Danach wird angezeigt, dass zur weiteren Ausführung eine Datei benötigt wird; hier ist es diejenige Datei, die das eigentliche Erweiterungsmodul mit der dort definierten Klasse enthält. Hier ist es die Datei <code>ExampleModuleFooter.php</code> im Stammverzeichnis des Erweiterungsmoduls. In der letzten Zeile wird dann die Klasse <code>ExampleModuleFooter()</code> in einer neuen Instanz übergeben. Diese Klasse wird in der Datei <code>ExampleModuleFooter.php</code> definiert und wird nun als nächstes beschrieben.

==== Klasse mit dem Erweiterungsmodul ====
{{WT-ToDo|Weitere wesentliche Aufbauelemente eines Erweiterungsmoduls exemplarisch beschreiben}}

==== Versionsverwaltung ====
webtrees kann überprüfen, ob die installierte Version eines Erweiterungsmoduls noch aktuell ist. Gegebenenfalls wird dem Administrator im Verwaltungsmenü ein Hinweis angezeigt, sobald eine neuere Version verfügbar ist, so dass der Webmaster dann diese neue Version installieren kann.

Dazu muss im Stammverzeichnis des Erweiterungsmoduls eine Textdatei mit dem Namen <code>latest-version.txt</code> hinzugefügt werden, die immer die aktuell veröffentlichte Versionsnummer des Erweiterungsmoduls enthält, etwa die Zeichenkette "2.1.15.0".

In der Klassendefinition des Erweiterungsmoduls, also im Beispiel in der Datei <code>ExampleModuleFooter.php</code> werden zwei Funktionen und einige Zeichenketten als Konstanten eingefügt. Die beiden Funktionen können unverändert dem unten stehenden Code entnommen werden. Die Konstanten müssen natürlich entsprechend angepasst werden; sie enthalten den Modulnamen, die aktuelle Versionsnummer des Moduls und einen Verweis auf die Datei im GitHub-Verzeichnis mit der aktuellen Release-Nummer.
<syntaxhighlight lang="php">
public const CUSTOM_TITLE = 'Modulname in Englischer Sprache';
public const CUSTOM_MODULE = 'Ordnername des Moduls';
public const CUSTOM_AUTHOR = 'Name des Autors';
public const CUSTOM_GITHUB_USER = 'Nutzername des Autors bei GitHub';
public const CUSTOM_WEBSITE = 'https://github.com/' . self::CUSTOM_GITHUB_USER . '/' . self::CUSTOM_MODULE . '/';
public const CUSTOM_VERSION = '2.1.15.0';
public const CUSTOM_LAST = 'https://raw.githubusercontent.com/' . self::CUSTOM_GITHUB_USER . '/' .
self::CUSTOM_MODULE . '/main/latest-version.txt';

/**
* Die Version dieses Moduls.
*
* @return string
*/
public function customModuleVersion(): string
{
return self::CUSTOM_VERSION;
}

/**
* Eine URL, hinter der die aktuelle Release-Nummer dieses Moduls gefunden werden kann.
*
* @return string
*/
public function customModuleLatestVersionUrl(): string
{
return self::CUSTOM_LAST;
}
</syntaxhighlight>

==== Unterordner /resources ====
Im Unterordner<code>/ressources</code>eines Erweiterungsmoduls liegen alle Dateien, die keine PHP-Dateien sind, aber zur Ausführung des Moduls notwendig sind. Dieser Ordner ist üblicherweise in Unterordner gegliedert, die jeweils Dateien mit ähnlichem Inhalt enthalten.

* <code>/ressources/css</code>: modulspezifische Gestaltung der Seiten (mit CSS)
* <code>/ressources/docs</code>: Abbildungen und Dokumente zur Dokumentation
* <code>/ressources/js</code>: JavaScript-Funktionen
* <code>/ressources/lang</code>: Übersetzungsdateien für die Texte im Erweiterungsmodul zur Unterstützung weiterer Sprachen
* <code>/ressources/views</code>: Anzeigeseiten für die Bedienoberfläche (im wesentlichen in HTML, mit etwas PHP und ggf. etwas JavaScript)

Die folgende Funktion kann dem Erweiterungsmodul hinzugefügt werden, um eine Funktion bereit zu stellen, die einen Verweis auf den Unterordner <code>/ressources</code> zurück gibt.
<syntaxhighlight lang="php">
/**
* Where does this module store its resources?
*
* @return string
*/

public function resourcesFolder(): string
{
return __DIR__ . DIRECTORY_SEPARATOR . 'resources' . DIRECTORY_SEPARATOR;
}
</syntaxhighlight>

==== README.md ====
Zu jedem Erweiterungsmodul gehört eine kurze Beschreibung der angebotenen Funktionen in englischer Sprache. Diese Beschreibung ist Bestandteil der Datei <code>README.md</code>. Zur Formatierung wird ein einfacher Markdown-Code verwendet. Am besten kopiert man eine halbwegs passende Beschreibung aus einem anderen Erweiterungsmodul und passt diese dann entsprechend an.

==== Übersetzung der Modultexte in andere Sprachen ====
Die Textbausteine, die in einem Erweiterungsmodul verwendet werden, werden in der US-Englischen Sprache verfasst. Zur Übersetzung werden Funktionen des I18N-Systems verwendet. Die zu übersetzenden Textbausteine werden etwa im po/mo-System mt dem Programm [https://de.wikipedia.org/wiki/Poedit Poedit] bearbeitet.

Die folgende Funktion kann dem Erweiterungsmodul hinzugefügt werden, um Übersetzungen bereit zu stellen.
<syntaxhighlight lang="php">
/**
* Additional/updated translations.
*
* @param string $language
*
* @return string[] // array<string,string>
*/
public function customTranslations(string $language): array
{
$languageDirectory = $this->resourcesFolder() . 'lang/';
$file = $languageDirectory . $language . '.mo';
if (file_exists($file)) {
return (new Translation($file))->asArray();
} else {
return [];
}
}
</syntaxhighlight>
Diese Funktion wird vom webtrees-Kern mit einem Sprachcode als Parameter <code>$language</code> aufgerufen, etwa <code>de</code> für die deutsche Sprache. Die Funktion gibt eine Tabelle zurück, die die Übersetzungen von der internen US-englischen Sprache in die angeforderte Zielsprache enthält; beispielsweise Zeilen in der Art

<code>"This is an example footer module." => "Dies ist ein Beispiel für ein Fußzeilen-Modul."</code>

In der Variablen <code>$languageDirectory</code> wird festgelegt in welchem Unterverzeichnis des Erweiterungsmoduls die Sprachdateien liegen. Wenn in diesem Verzeichnis die Sprachdatei für die angeforderte Sprache existiert, etwa <code>de.mo</code>, wird der Inhalt dieser .mo-Datei in die interne Tabellenform transformiert und als Ergebnis abgeliefert; andernfalls wird eine leere Tabelle als Rückgabewert verwendet.
{{WT-ToDo|Noch beschreiben: Doku zu I18N; I18N-Pluralformen inkl. Link zum entsprechenden webtrees File; I18N-Kontext; Ausgabe von Zahlen in sprachtypischer Form; Verweis auf die Sprachenliste hier im Handbuch; Hinweis auf Dienst poedit.com; Verweis auf php-Form statt mo/po; Verweis zur Liste/Standard der Sprachcodes.}}

==== Festlegungen des Aussehens von Seitenelementen per CSS ====
Alle Seitenelemente einer webtrees-Seite sind per CSS beeinflussbar. Die neuen Elemente, die von einem Erweiterungsmodul erzeugt werden, sollten sich in dieses Schema einfügen. Zum einen gibt es Elemente aus dem von webtrees verwendeten [https://getbootstrap.com/docs/5.2/getting-started/introduction/ bootstrap-System]. Und zum anderen die von webtrees selbst definierten CSS-Klassen, die alle eine Bezeichnung haben, die mit "wt-" beginnt. Diese Klassen werden unter anderem in der Datei [https://github.com/fisharebest/webtrees/blob/684a6f87b3ab6b4cc21e962b050c95eb9c0cea91/resources/css/webtrees.css#L55-L82 webtrees.css] definiert. Die neuen Klassen eines Erweiterungsmoduls sollten mit einer modulspezifischen Kennung beginnen, etwa "fm-" für CSS-Klassen des Footer-Moduls.

{{WT-ToDo|Beispiele für CSS-Klassendefinitionen und ihre Verwendung darstellen.}}

=== Testen ===
{{WT-ToDo|Das Vorgehen beim Testen von neuem Code für webtrees beschreiben.}}
Wenn Sie daran interessiert sind, Pull-Requests für ein webtrees-Modul vor der Veröffentlichung zu testen oder in solchen Fällen Regressionstests durchzuführen, wird sich der entsprechende Modulentwickler sehr freuen. Melden Sie sich bei ihm! Denn generell ist es besser, wenn derjenige, der entwickelt, nicht auch noch testet. Ein Tester geht nicht mit der Brille des Entwicklers an die Arbeit und ist somit unvoreingenommener. Wenn sie sogar in der Lage sind, automatisierte Tests zu erstellen, wird jeder Entwickler begeistert sein.

== Anpassungen mit dem Modul "CSS und JS" ==
Wenn es darum geht, kleinere Änderungen am Aussehen von Elementen in der Bedienoberfläche vorzunehmen oder das Verhalten von solchen Elementen zu ändern, muss nicht immer gleich ein Erweiterungsmodul erstellt werden. Je nach Bedarf kann das mit geeigneten JavaScript<ref>{{wikipedia-Link|JavaScript}}</ref>-Funktionen oder CSS<ref>{{wikipedia-Link|Cascading Style Sheets}}</ref>-Direktiven im Modul "[[Webtrees_Handbuch/Anleitung_für_Administratoren/Module#CSS_und_JS|CSS und JS]]" erledigt werden.

Das Modul hat zwei Eingabebereiche. Der erste Bereich ist für CSS bestimmt und wird im head-Teil der Webseite eingebaut und der zweite Bereich ist für JavaScript vorgesehen, er wird im body-Teil der Webseite integriert. Der CSS-Code wird durch genau ein Paar mit den Anweisungen "<style>" und "</style>" umgeben, der JavaScript-Code wird durch genau ein Paar mit den Anweisungen "<script>" und "</script>" umgeben.

=== Beispiel - Bildschirmfläche besser ausnutzen ===
Mit '''CSS''' kann man die Breite der Bildschirmspalten auf einen maximalen Wert setzen.
<syntaxhighlight lang="css">
<style>
.container { max-width: 100% }
.container-lg { max-width: 99% }
</style>
</syntaxhighlight>

=== Beispiel - Farben bei Historischen Fakten anpassen ===
Mit '''CSS''' kann man die Hintergrundfarben bei der Anzeige von "Historischen Fakten" modifizieren.
<syntaxhighlight lang="css">
<style>
[dir] .wt-historic-fact > :first-child {background-color: #bfac99;}
[dir] .wt-historic-fact > :last-child {background-color: #d9c3ad;}
</style>
</syntaxhighlight>

=== Beispiel - Farben bei Ereignissen naher Verwandter anpassen ===
[[Datei:WT_2.1_Modul-CSS-und-JS-Beispiel-Farbe-Verwandtenereignis.png|thumb|right|250px|Farbanpassung Ereignisse naher Verwandter (links: Anpassung / rechts: Standard)]]
Mit '''CSS''' kann man die Hintergrundfarben bei der Anzeige von "Ereignissen naher Verwandter" modifizieren.
<syntaxhighlight lang="css">
<style>
[dir] .wt-relation-fact > :first-child {background-color: #b398b2;}
[dir] .wt-relation-fact > :last-child {background-color: #ccadcb;}
</style>
</syntaxhighlight>

=== Beispiel - Anpassung der Namensboxen an die Inhalte ===
Mit '''CSS''' kann man die Größe der Namensboxen optimieren, um längere Inhalte vollständig wiederzugeben.<ref>Vgl. Forumsbeitrag "Request for New Feature > Geometry of person's summary box": https://www.webtrees.net/index.php/en/forum/9-request-for-new-feature/36000-geometry-of-person-s-summary-box</ref>

<syntaxhighlight lang="css">
<style>
.wt-block .wt-chart-box {height: auto;}
.wt-chart-ancestors .wt-chart-box {margin: 2px; height: auto; min-height: 4.5rem;}
.wt-chart-descendants .wt-chart-box {margin: 2px; height: auto; min-height: 4.5rem;}
.wt-chart-family-book .wt-chart-box {margin: 2px; height: auto; min-height: 4rem;}
.wt-chart-hourglass .wt-chart-box {margin: 2px; height: auto; min-height: 4.5rem;}
.wt-chart-pedigree-left .wt-chart-box {margin: 2px; height: auto; min-height: 4.5rem;}
.wt-chart-pedigree-right .wt-chart-box {margin: 2px; height: auto; min-height: 4.5rem;}
.wt-chart-pedigree-up .wt-chart-box {margin: 2px; height: auto; min-height: 4.5rem; min-width: 18rem;}
.wt-chart-pedigree-down .wt-chart-box {margin: 2px; height: auto; min-height: 4.5rem; min-width: 18rem;}
.wt-chart-relationships .wt-chart-box {margin: 2px; height: auto; min-height: 4.5rem;}
.wt-family-members .wt-chart-box {margin: 2px; height: auto; min-height: 4.5rem;}
</style>
</syntaxhighlight>

=== Beispiel - Nachnamen hervorheben ===
Mit '''CSS''' kann man die Nachnamen auf der [[Webtrees_Handbuch/Anleitung_für_Besucher#Personenseite_mit_Reitern_und_Navigationsleiste|Personenseite]] etwa durch GROSSSCHREIBUNG und '''Fettdruck''' hervorheben:<ref>Vgl. Forumsbeitrag "Request for New Feature > Surnames full capitalization": https://www.webtrees.net/index.php/en/forum/9-request-for-new-feature/36468-surnames-full-capitalization</ref>
<syntaxhighlight lang="css">
<style>
.SURN { text-transform: uppercase; font-weight: bold; }
</style>
</syntaxhighlight>

=== Beispiel - Ersten Namen aufklappen ===
[[Datei:WT_2.1_Modul-CSS-und-JS-Beispiel-Name.png|thumb|right|250px|Personenseite mit aufgeklappten ersten Namen]]
Mit '''JavaScript''' kann man dafür sorgen, dass der erste Name einer Person beim Öffnen der Personenseite immer gleich aufgeklappt wird.

<syntaxhighlight lang="html">
<script>
$('[id^="name-content-"]').first().addClass('show');
</script>
</syntaxhighlight>

{{-}}

=== Beispiel - Externe Links in neuem Fenster/Reiter öffnen ===
{{Halt|Bitte verwenden Sie dieses Beispiel nicht!}}
Dieses Beispiel führt aus mehreren Gründen zu einer schlechten Benutzungserfahrung
* Es unterbricht den Fluss der Navigation. In einer neuen Registerkarte bzw. einem neuen Fenster gibt es keine Schaltfläche "Zurück", um zur vorherigen Seite zurückzukehren.
* Dem Benutzer wird die Kontrolle entzogen. Die Nutzer können jederzeit mit der STRG-Taste, der rechten Maustaste oder durch langes Berühren einen Link in einer neuen Registerkarte bzw. in einem neuen Fenster öffnen. Es gibt aber keine Möglichkeit, einen Link im selben Fenster zu öffnen.
* Das Surfen im Internet findet vorwiegend auf Handys und Tablets statt, deren Browser teilweise keine Registerkarten oder Fenster verwenden. Die Verwaltung von "Fenstern" auf diesen Geräten ist normalerweise umständlich.

Aber wenn Sie wirklich müssen, dann fügen Sie das Folgende in den <body>-Abschnitt ein<ref>Übersetzung der Seite https://webtrees.net/faq/target/.</ref>

<syntaxhighlight lang="html">
<script>
document.addEventListener('click', function(event) {
if (event.target.tagName === 'A' && !event.target.href.includes('//' + location.hostname)) {
event.target.target="_blank";
event.target.rel="noopener";
}
});
</script>
</syntaxhighlight>

=== Beispiel - Querverweise zu Datensätzen ===
[[Datei:WT_2.1_Modul-CSS-und-JS-Beispiel-Querverweis.png|thumb|right|350px|Beispiel für Querverweis auf der Startseite]]
Zwar ersetzt webtrees in Notizen [[GEDCOM/XREF_ID|XREFs]] wie etwa @I2@ durch den passenden Anzeigenamen mit einem Querverweis, dies ist aber nicht so flexibel und funktioniert leider nicht im [[Webtrees_Handbuch/Anleitung_für_Administratoren/Stammbäume#html-block|HTML-Block]] auf der Startseite, wenn man dort im Fließtext auf einen Datensatz verweisen möchte, ohne absolute Verweise einzufügen
(solche absoluten Verweise könnte man im Quellcode des HTML-Blocks etwa folgendermaßen eingeben: <code><nowiki><a href="https://mustermann.genonline.de/tree/Mustermann/individual/I1/Max-Manfred-Mustermann">Max M. Mustermann</a></nowiki></code>).

Das nachfolgend beschriebene Skript funktioniert im [[Webtrees_Handbuch/Anleitung_für_Verwalter#Markdown|Markdown]] von Notizen und dem HTML-Block. Es werden <a>-Tags gesucht, deren href-Attributwerte mit #@ beginnen, gefolgt von einem Buchstaben ('i': 'individual', 'f':'family' , 's':'source', 'r':'repository', 'n':'note', 'l':'sharedPlace') und =@XREF@. Es ist auch möglich einen Querverweis zu einem anderen Stammbaum anzufügen. Bei Personendatensätzen kann ein angehängtes '+dia' für die zusätzliche Anzeige eines Icons sorgen, das zum "[[Webtrees_Handbuch/Anleitung_für_Besucher#Interaktives_Sanduhrdiagramm|Interaktiven Sanduhrdiagramm]]" der Person führt. Unterstützt werden beide URL-Varianten (Standard und [[Webtrees_Handbuch/Anleitung_für_Webmaster#Pretty-URLs|Pretty URLs]]) und auch unterschiedliche Sprachen.

Anwendungsbeispiele
* Markdown (etwa in Notizen)
** Querverweis zu einem Quellen-Datensatz: <code>[Quelle 1](#@s=@S1@)</code>
** Querverweis zur Personenseite und zusätzlicher Link zum interaktiven Sanduhrdiagramm: <code>[Max M. Mustermann](#@i=@I1@+dia)</code>
* HTML-Block
** Querverweis in einen anderen Stammbaum: <code><a href="#@i=@I1@tree2+dia">Lt. Cmndr. Joseph Allen jr.</a></code>
** Zur Eingabe kann man
*** im Bearbeitungsmodus <code>Lt. Cmndr. Joseph Allen jr.</code> in das Textfeld eingeben, diesen Text markieren, auf das Symbol "Link einfügen" klicken und dann <code>#@i=@I1@tree2+dia</code> in das Feld URL schreiben oder alternativ
*** über einen Klick auf die Schaltfläche "Quellcode" in den Quellcode-Modus wechseln und dann dort <code><a href="#@i=@I1@tree2+dia">Lt. Cmndr. Joseph Allen jr.</a></code> eingeben.

{{Halt|XREF sind eigentlich rein interne Identifikatoren. Sie könnten beim Importieren oder Exportieren eines Stammbaums verändert werden. Allerdings ändert webtrees die XREF bei diesen Vorgängen nicht. Wenn aber Stammbäume verschmolzen werden, kann es zwangsläufig passieren, dass sich die XREF ändert, etwa wenn eine XREF in beiden zu verschmelzenden Stammbäumen vorkommt. Dadurch werden dann die Verweise nicht mehr stimmen, wenn sie so wie hier beschrieben verwendet werden.}}

Das nachfolgende Skript muss dazu im <body>-Abschnitt eingetragen werden.
<syntaxhighlight lang="html">
<script>
function convertCrossReferenceLinks() {
let rectype = { 'i': 'individual', 'f':'family', 's':'source', 'r':'repository', 'n':'note', 'l':'sharedPlace' };
let separator = { 'default': {'path':'%2F', 'option':'&'}, 'pretty': {'path':'/', 'option':'?'} };
let baseurl = document.location.href.match(/^.+?\/index\.php\?route=%2Ftree%2F([^%\/#?]+)/i) || document.location.href.match(/^.+?\/tree\/([^\/#?]+)/i);
if (!baseurl) { return }
let tree = baseurl[1];
baseurl = baseurl[0];
let urlmode = ( baseurl.indexOf('index.php') > -1 ? 'default' : 'pretty' );
let diatitle = $("a.dropdown-item.menu-chart-tree[role=menuitem]").text().trim() || 'Interaktives Sanduhrdiagramm';

$('a[href^="#@"]').each(function( index, element ){
let link = $(this).attr('href');
let m = link.match(/^#@([ifsrnl])=@([^@]+)@(.*)/i);
if ( m ) {
let type = m[1].toLowerCase();
let xref = m[2];
let param = m[3];
let dia = false;
if ( param.match(/\+dia/i) ) {
dia = true;
param = param.replace(/\+dia/i, '')
}
let newtree = param;
let url = ( newtree ? baseurl.replace(`/tree/${tree}`.replaceAll('/', separator[urlmode].path), `/tree/${newtree}`.replaceAll('/', separator[urlmode].path)) : baseurl );
$(this).attr('href', url + separator[urlmode].path + rectype[type] + separator[urlmode].path + xref ).attr('target', '_blank');
if (type == 'i' && dia) {
let diaurl = url.replace("/tree/".replaceAll('/', separator[urlmode].path), "/module/tree/Chart/".replaceAll('/', separator[urlmode].path)) + separator[urlmode].option + "xref=" + xref;
$(this).after($(' <a/>', { href: diaurl, class: 'menu-chart-tree', target: '_blank', title: `${diatitle} - ${xref}` + ( $(this).text() ? ' / ' + $(this).text() : ''), html: ' '}));
}
}
});
}

$( document ).ready(function() {
convertCrossReferenceLinks();
});
</script>
</syntaxhighlight>

=== Beispiel - Stammbaum-Titel wird zum Link auf die Startseite ===
Um schnell zur [[Webtrees_Handbuch/Anleitung_f%C3%BCr_Verwalter#Startseite|Startseite]] des aktuellen Stammbaums zu wechseln, wird durch dieses Skript der Stammbaum-Titel in einen Link gewandelt. Solange das Stammbäume-Menü sichtbar ist, sollte dies dem Skript auch gelingen.

Das nachfolgende Skript muss dazu im <body>-Abschnitt eingetragen werden.
<syntaxhighlight lang="html">
<script>
function setHomeLink(useMyPage) {
let treename = $(".wt-site-title").text().trim();
let treelink = '';
$("li.nav-item.menu-tree a.dropdown-item").each(function(index, elem){
if (elem.text.trim() == treename) {
treelink = elem.href + (useMyPage && $("li.nav-item.menu-logout").length > 0 ? '/my-page' : '');
}
});
if (treelink) {
$(".wt-site-title").wrapInner(`<a href="${treelink}"></a>`);
}
}

$( document ).ready(function() {
setHomeLink();
});
</script>
</syntaxhighlight>

Möchte man in Abhängigkeit vom Anmeldestatus alternativ auf die eigene [[Webtrees_Handbuch/Anleitung_f%C3%BCr_Mitglieder#Meine_Seiten|Startseite]] verweisen, muss der Funktionsaufruf <code>setHomeLink(1)</code> mit gesetztem Parameter erfolgen.

=== Beispiel - Erweiterung des Kopfmenüs ===
[[Datei:WT_2.1_Modul-CSS-und-JS-Beispiel-Kopfmenue-Erweiterung.png|thumb|right|250px|Erweiterung des Kopfmenüs um einen Eintrag]]
Mit JavaScript kann das [[Webtrees_Handbuch/Anleitung_für_Besucher#Kopfmen.C3.BC|Kopfmenü]] um einfache Einträge erweitert werden, ohne dafür ein [[Webtrees_Handbuch/Entwicklungsumgebung#Anpassung_und_Entwicklung_eigener_Module|eigenes Modul]] entwicklen zu müssen.<ref>Vgl. Forumsbeitrag "Help for version 2.0
> Howto add a item to the secundary menu?": https://www.webtrees.net/index.php/en/forum/help-for-2-0/34337-howto-add-a-item-to-the-secundary-menu#96110</ref>

Das nachfolgende Skript muss dazu im <body>-Abschnitt eingetragen werden.
<syntaxhighlight lang="html">
<script>
jQuery('.wt-user-menu').prepend('<li class="nav-item menu-wthb"><a class="nav-link" href="https://wiki.genealogy.net/Webtrees_Handbuch">Webtrees-Handbuch</a></li>');
</script>
</syntaxhighlight>

== Einzelnachweise ==
<references />

[[Kategorie:Webtrees]]

Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/TAM und Lineage/TAM

2023-03-14T20:41:52Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Abschnitt 8.10.1.1|info=1}}{{WT-Inhaltsverzeichnis|Kapitel 8|G|Abschnitt 8.10|Abschnitt 8.10.1|Abschnitt 8.10.1.1}}

Das [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodul]] '''TAM''' ist ein Visualisierungsmodul, das ein Knoten-Kanten-Diagramm<ref>{{wikipedia-Link|Graphentheorie}}</ref> verwendet, um genealogische Beziehungen darzustellen. Dieses Diagramm kann mit einem temporalen Feld hinterlegt werden (Topographic Attribute Map), so dass zeitliche Zusammenhänge in den Beziehungen besser sichtbar werden.

Dieses Modul hat viele Ähnlichkeiten mit dem Erweiterungsmodul [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule/TAM_und_Lineage/Lineage|Lineage]], so dass gemeinsame Funktionen und Eigenschaften auf der übergeordneten Seite "[[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule/TAM_und_Lineage|TAM und Lineage]]" beschrieben sind.

Das Modul TAM geht auf Arbeiten von R. Preiner und seinem Team an der Universität Graz zurück<ref>[https://diglib.eg.org/handle/10.1111/cgf13987 Augmenting Node-Link Diagrams with Topographic Attribute Maps]</ref>, die eine Version von TAM auf [https://github.com/rpreiner/tam GitHub] veröffentlicht haben.

== Beschreibung ==
TAM stellt die Verbindungen von Familien und Personen dar. Die Personen werden als Knoten visualisiert, Familien als Kreise. Die Nachkommen einer Familie sind im Kreis lokalisiert, haben sie selbst Familien bzw. Beziehungen gegründet, werden sie mit Linien mit diesen verbunden. Eine Person kann also durchaus mit mehreren Familien verbunden sein.

Die primäre Darstellung ist die Kreis-Knoten-Ansicht mit den verknüpften Personen. Durch einen ''Doppel-Klick'' auf einen Personen-Knoten wird in einem weiteren Browser-Fenster eine '''H-Tree'''-Ansicht geöffnet, in der die Vorfahren dieser Person in einer schematisierten Übersicht dargestellt sind (siehe nachfolgender Abschnitt "Alternative Darstellungen").

Die Personen-Knoten werden in ihrer Darstellung nach Geschlecht differenziert - Männer werden als Quadrate, Frauen und Personen mit unbekanntem Geschlecht werden als Kreise präsentiert.

Die Eigenschaften der Familien-Kreise werden durch die darin lokalisierten Nachkommen bestimmt. Der Durchmesser wird nicht über die Anzahl der umfassten Personen ermittelt, sondern über die Zeitspanne der Geburtsdaten - je weiter diese auseinanderliegen, desto größer der Durchmesser. Insofern kann die TAM-Visualisierung auch als Werkzeug zur Plausibilisierung und Konsistenzprüfung der Datenqualität im Stammbaum gesehen werden - Zahlendreher bei Geburtsjahren führen zu Auffälligkeiten in der Darstellung.

: Unter Umständen hatte man die verdeckten Inkonsistenzen bis zur Aufbereitung in TAM noch gar nicht registriert, denn webtrees ist sehr viel flexibler in der Interpretation der Datumsangaben im unterliegenden GEDCOM. Ein Datum kann in der webtrees-Oberfläche vollkommen plausibel erscheinen, weil die Aufbereitung diverse Verschiebungen und Verfälschungen abfängt. Die GEDCOM-Aufbereitung in TAM setzt demgegenüber eine weitestgehend der Spezifikation entsprechend strukturierte Datumsangabe voraus und kann nur wenige Sonderfälle interpretieren.

Geburtsdaten sind also für die TAM-Aufbereitung ein primäres Kriterium - es gibt aber im Stammbaum durchaus die Situation, dass ein solches Datum nicht gefunden werden konnte. In einem solchen Fall wird versucht, dass Datum über die mit der Person verbundenen Vorfahren und/oder Nachkommen abzuleiten. Werden bei den Eltern Geburtsdaten gefunden, wird das Datum auf das "jüngere" Datum + 20 Jahre gesetzt. War bei den Eltern kein Geburtsdatum hinterlegt, werden die Nachkommen geprüft und als Datum das Geburtsdatum des ältesten Kindes - 20 Jahre gesetzt. Die erfolgten Substitutionen werden in der Browser-Konsole dokumentiert, ebenso wird dort abschließend protokolliert, für welche Personen überhaupt kein Geburtsdatum gefunden bzw. gesetzt werden konnte.

[[Datei:huhwt-wttam Viewport.png|right|mini|720x720px|Viewport gesamt - ein Familien-Kreis ist fixiert; Information zur Familie im Tooltip]]
=== Farbschema ===
Familienkreise sind in einem Lila-Ton eingefärbt, Personenknoten in einer Farbe aus einem grün-grauen Farbraum, wobei der Farbton umso dunkler ist, je früher das Geburtsdatum der Person liegt. Bei Personen, für die kein Geburtsdatum gefunden werden konnte, sind die Kreise rot. Diese Art der Darstellung kann analog der Größe der Familienkreise ebenfalls als Prüfkriterium für die Plausibilität der Daten dienen.

[[Datei:huhwt-wttam Viewport-with-Map.png|right|mini|720x720px|Gleiche Situation - mit hinterlegter ''Temporal Attribute Map'']]

=== Information in der Darstellung ===
Familienkreise sind die übergeordneten Elemente im Diagramm, Personenknoten sind diesen in mancher Beziehung untergeordnet. Das zeigt sich auch in der Art und Weise, wie die Informationen zu den Knoten dargestellt werden.

Den Familienkreisen sind die Familiennamen beigeordnet. Zu den Personenknoten werden nur die Vornamen direkt angezeigt. Weitere Informationen erscheinen aber, wenn man mit der Maus einen Kreis bzw. Knoten überfährt (''Hovern''), was einen Informationsblock (''Tooltip'') erscheinen lässt

* Familienkreis - der Tooltip zeigt den Familiennamen (+ID) als Kopfzeile und listet die beteiligten Partner, das Hochzeitsdatum, die Anzahl der Kinder insgesamt und das Geburtsjahr des ersten Kindes auf.
* Personenknoten - der Tooltip zeigt den vollen Namen (+ID) als Kopfzeile und listet Geburts- und Sterbedatum, das Alter zum Zeitpunkt des Todes und jeweils den vollen Namen der Mutter und des Vaters auf.

Sind die jeweiligen Informationen nicht hinterlegt, steht jeweils <tt>-unbekannt-</tt> an Stelle eines Wertes.

=== Zeit-Dimension ===
Das Akronym '''TAM''' steht ja für '''''T'''''-'''emporal''' '''''A'''''-'''ttribute''' '''''M'''''-'''ap'''. Zeit-Aspekte werden schon über das Farbschema visualisiert, besonders augenfällig werden sie, wenn man die '''Map'''-Ansicht aktiviert.

Über einen Schalter in der Bedienoberfläche wird die Knoten-Kanten-Darstellung mit einer topografischen Kartendarstellung unterlegt. Die Höhenlinien entsprechen dabei den Jahren. Auf den "Gipfeln" befinden sind die Personen der jüngsten Geburtsjahrgänge, in den Tälern entsprechen die früheren Altersgruppen. Außer den Höhenlinien werden die Jahresbereiche auch durch gleiche Einfärbung gegeneinander abgegrenzt, insgesamt ergibt sich ein recht plastisch strukturiertes Profil.

Die Eigenschaften der Kartendarstellung können, wie im nachfolgenden Abschnitt beschrieben, durch diverse Optionen beeinflusst werden. 

== Bedienoberfläche ==
Der Benutzer kann mit den Elementen im Diagramm interagieren und er kann im Steuerungsmenü Einstellungen zur Visualisierung vornehmen.

In den nachfolgenden Abbildungen sind aktive Elemente grün eingefärbt, sie reagieren in dieser Weise, wenn man auf dem Bildschirm solche Schaltflächen mit der Maus überstreicht. Andere Elemente sind An-/Aus-Schalter oder Spinner, mit denen man die Steuerwerte hoch- oder runtersetzen kann. Bei den Spinnern sind programmseitig Minimal- und Maximal-Werte gesetzt, sie werden also bei fortwährender Änderung in eine Richtung irgendwann nicht mehr reagieren, weil definierte Grenzwerte erreicht wurden.

=== Manipulation der Knoten ===
Familien- und Personen-Knoten können mit der Maus "angefasst" und verschoben werden (Drag-n-Drop). Familien-Knoten werden dabei durch Intensivierung der Farbe hervorgehoben, Personen-Knoten durch einen lila gefärbten Rand. Familien-Knoten werden am Endpunkt der Verschiebung in der Folge fixiert, ihre Position verändert sich also nicht mehr durch die Auswirkungen des Simulations-Verfahrens, welches die Darstellung erzeugt. Für Personen-Knoten funktioniert die Fixierung nur eingeschränkt, denn deren Position ist nicht primär durch die Simulation sondern vor wesentlich von der des übergeordneten Familien-Kreises bestimmt - solange dieser sich frei bewegt, wird auch der Personen-Knoten weiterhin "wandern".

Durch einen ''Klick'' auf einen fixierten Kreis bzw. Knoten wird die Fixierung wieder aufgehoben und die Positionierung folgt wieder dem Simulations-Verfahren.

Wie erwähnt, öffnet ein ''Doppel-Klick'' auf einen Personen-Knoten eine zusätzliche Darstellung. Zusätzlich wird dabei der Ziel-Knoten in der aktuellen wie auch der zusätzlichen Ansicht durch Vergrößerung und Einfärbung in Orange besonders hervorgehoben, er muss in der Folge durch einfaches Anklicken wieder entsperrt werden.

''Doppel-Klick'' auf einen Familien-Kreis hat demgegenüber nur die Auswirkung, dass der Kreis wie beim Verschieben an der aktuellen Position fixiert und farblich hervorgehoben wird, auch hier entsperrt ein nachfolgendes Anklicken wieder.

Die Fixierung von Familien-Kreisen und Personen-Knoten kann hilfreich sein, um die Darstellung im Zuge einer näheren Analyse vorübergehend ruhig(er) zu stellen.

=== Steuerungsmenü ===
Am linken Bildschirmrand ist das Steuerungsmenü lokalisiert. Im Ausgangszustand sind alle Funktionsbereiche eingeklappt, ein ''Klick'' auf den jeweiligen Bereichstitel öffnet dann einen zusätzlich eingeschobenen Bereich, welcher über Schaltflächen und Steuerelemente diverse Aktionen und Optionen zugänglich macht. Ein erneuter ''Klick'' auf den Titel klappt den Bereich dann wieder ein.

[[Datei:huhwt-wttam Screen-Aktionen.png|right|mini|325x470px|TAM-Steuerungsmenü - Funktionsbereiche]]
Die Bereiche behandeln Aspekte wie

* '''''Öffnen / Speichern''''' - Datenmanagement

* '''''Darstellung''''' - beeinflusst wesentliche Eigenschaften des Erscheinungsbildes der Darstellung insgesamt

* '''''Force Layout''''' - eher esoterische Aspekte der unterliegenden Force-Simulation, welche im Regelfall für den Benutzer weniger wichtig sind
:'' Diese Optionen waren so in der ursprünglichen Programm-Version definiert; sie wurden beibehalten, weil Änderungen hier fallweise bei komplexen und für das Simulations-Verfahren spürbar "mühsamen" Datenkonstellationen helfen können, dass die Darstellung stabiler wird. Im Allgemeinen sollten die vorbelegten Werte nicht verändert werden.''

* '''''Graph Darstellung''''' - beeinflusst das Erscheinungsbild der Darstellung in sekundären Belangen

* '''''Karte Darstellung''''' - kommt erst zum Tragen, wenn die '''Map''' aktiviert ist und kann das Erscheinungsbild stark beeinflussen

* '''''Sprache''''' - (immer aufgeklappt) hier kann man die Anzeigesprache ändern.

 
==== Öffnen / Speichern ====
[[Datei:huhwt-wttam Screen-Aktionen-ÖS.png|right|mini|420x290px|'''Öffnen / Speichern''' - Aktions-Schaltflächen]]
Dieser Aktionsbereich aktiviert Folgeaktionen zum Daten-Laden und -Wegschreiben. wtTAM wird beim Aufruf aus dem huhwt-cce-Erweiterungsmodul im Hintergrund mit seinen Daten versorgt, ohne dass es einer expliziten Benutzer-Intervention bedarf. Bei der Analyse ist es aber auch hilfreich, wenn man verschiedene Ansichten und Datenteilmengen nochmals aufrufen kann, ohne dass man erneut alle vorherigen Aktionen im Sammelbehälter ausführen muss. Man kann also den aktuellen Zustand - Knoten und Links mit ihren aktuellen Positionen - für spätere Verwendung sichern oder einen früher gesicherten Zustand einlesen. Beim Einlesen wird der aktuelle Zustand komplett überschrieben.

'''''von Datei''''' / '''''in Datei''''' verwenden die üblichen und bekannten Datei-Öffnungsdialoge, beim Wegschreiben wird je nach individueller Browser-Konfiguration u.U. die Zieldatei auch in das übliche Download-Verzeichnis geschrieben. Auch wenn die Datei über einen Dateidialog weggeschrieben wird, aus Sicht des Browsers ist es in jedem Fall ein Download und taucht somit auch in der Download-Übersicht des Browsers auf.

'''''aus IDB''''' / '''''in IDB''''' liest und schreibt die Daten demgegenüber in IndexedDB. Die primäre Datenversorgung aus webtrees-cce heraus läuft auch über IDB, transparent und ohne Benutzer-Interaktion, man kann aber auch gezielt Daten dort ablegen und auslesen.

Beim Wegschreiben müssen die Daten einen Namen bzw. Key zugeordnet bekommen. Dieser ergibt sich entweder aus dem entsprechenden Namen, wenn man vorher einen früheren Datenstand geladen hatte, oder er muss beim ersten Wegschreiben den zu sichernden Daten mitgegeben werden. Dies erfolgt, indem man im mittleren Textfeld einen einschlägigen Namen/Key einträgt, steht dort schon ein Eintrag, kann dieser nach Belieben und Bedarf verändert werden. Eine explizite ''Speichern unter ...''-Option gibt es nicht, man verändert halt den vorhandenen Text. Eine ''Überschreiben''-Warnung gibt nur im Dateidialog, IDB-Schreiboperationen erfolgen direkt.

Ist man mehr am graphischen Inhalt der Darstellung interessiert, weil man etwas illustrieren möchte, kann man natürlich zum Einen einen Screenshot anfertigen, dabei wird dann eine Bitmap-Grafik, meistens im PNG-Format, erzeugt. Diese hat aber den inhärenten Nachteil, dass die Ansicht beim fallweisen Vergrößern pixelig wird. Je nach Aufnahme-Modus sind zum Anderen auch noch alle sonstigen Elemente des Browser-Fensters darin enthalten und müssen in einem Bildbearbeitungsprogramm entfernt werden.

wtTAM bietet deshalb auch die Option, den aktuellen Zustand der Darstellung als SVG-Grafik abzulegen. Diese kann dann später mit einem aktuellen Browser aufgerufen werden und man kann dann eine solche Vektor-Grafik beliebig hochskalieren, ohne dass die Klarheit der Darstellung leidet.
 

==== Darstellung ====
Dieser Aktionsbereich fasst Schalter zusammen, mit denen die wesentlichen Eigenschaften der Darstellung wechsel- und stufenweise zu- und abgeschaltet werden können. Die kennzeichnenden Texte enthalten jeweils einen hervorgehobenen Buchstaben als Shortcut, man kann damit die Aktion auch per Tastatur auslösen. Die Buchstaben in den Texten sind in Großbuchstaben, geht aber auch einfach mit dem Kleinbuchstaben.

* ''einFrieren -> '''''F''''' - hiermit wird die namenstiftende '''''Temporal Attribute Map''''' an- und abgeschaltet.
: Die Bezeichnung ''einfrieren'' wurde seinerzeit gewählt und auch beibehalten, weil die unterliegende Force-Simulation, welche ja einen gewissen Energielevel verkörpert, gestoppt und die Bewegung der Knoten damit quasi wirklich eingefroren ist. Anhand der Zeitinformationen bei den Knoten wird nun in einem mehrstufigen recht komplexen Verfahren die temporale Verteilung ermittelt und zeitgleiche Bereiche mit entsprechenden Markierungen abgegrenzt, die einen Effekt ähnlich den Höhenlinien auf Landkarten ergeben. Diese Bereiche werden zudem analog eingefärbt und man hat schlußendlich eine Art ''Vorfahren-Landkarte'' erzeugt.

* ''Hervorheben Konturen'' -> '''''H''''' - wenn aktiviert, wird beim Überfahren mit der Maus jeweils der darunterliegende Bereich deutlich hervorgehoben, und nicht nur dieser, sondern alle anderen Bereiche auf der Karte des gleichen Zeitraums. Die können auch durchaus in ganz anderen "Gegenden" liegen, denn das wesentliche Strukturmerkmal ist ja die Abfolge der Generationen und Personen. Man erkennt also, welche Personen im gleichen Zeitraum gelebt haben (bzw. geboren sind, der Leitwert ist das Geburtsdatum).

* ''Jahr zu Kontur zeigen'' -> '''''J''''' - wenn aktiviert, wird beim Überfahren einer Bereichs als Tooltip der entsprechende Jahrwert angezeigt.
: Aus technischen Gründen können die H- und die J-Aktion nur eingeschränkt gleichzeitig aktiv sein, bzw. es kommt auf die Reihenfolge der gleichzeitigen Aktivierung an. Erst H und dann J funktioniert so, dass die beim Aktivieren der Jahresanzeige die hervorgehobene Kontur gehalten wird, man kann nun über die Karte wandern und bekommt die wechselnden Jahre gezeigt, man kann auch die Jahresanzeige wieder abschalten, damit die Konturanzeige wieder reagiert, muss diese aber erst abgeschaltet und dann wieder aktiviert werden. Erst J und dann H funktioniert durchaus, sowohl Kontur- als auch Jahresanzeige verändern sich beim Wandern. Schaltet man H ab, bleibt die letzte Hervorhebung unverändert, J funktioniert weiterhin, schaltet man H wieder zu, verändern sich auch wieder die Kontur-Hervorhebungen. Schaltet man J zuerst ab, funktioniert H weiter.

* ''Node Info zeigen'' -> '''''I''''' - diese Funktion steuert das Erscheinen der Tooltips mit den Informationen zu Personen und Familien. Wenn abgeschaltet, werden keine Tooltips mehr gezeigt. Deshalb wird diese Aktion auch im Standard von vornherein aktiviert.

* ''TickCounter Information'' -> '''''C''''' - diese Funktion blendet gewisse Kennwerte bezüglich des Programmzustands ein, es ist eine Entwickler-Funktion und wird wohl später nicht mehr gezeigt werden.

==== Force Layout ====

==== Graph Darstellung ====

==== Karte Darstellung ====

==== Sprache ====
''Mit einem Klick'' auf eines der Sprach-Auswahlfelder werden die Texte der Bedienoberfläche sofort auf die gewählte Zielsprache umgestellt. Neben Deutsch und Englisch ist auch Niederländisch verfügbar.

== Beispiele für Visualisierungen ==

=== Ahnenkreise in einem Stammbaum ===
<gallery perrow="2" widths="500" heights="500">
Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Ahnenkreise_ohne_Hintergrund.png|Ahnenkreise (ohne Hintergrund)
Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Ahnenkreise_mit_Hintergrund.png|Ahnenkreise (mit einem temporalen Feld als Hintergrund)
</gallery>

=== Partnerketten ===
<gallery perrow="2" widths="500" heights="500">
Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Partnerketten_ohne_Hintergrund.png|Partnerketten (ohne Hintergrund)
Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Partnerketten_mit_Hintergrund.png|Partnerketten (mit einem temporalen Feld als Hintergrund)
</gallery>

=== Kompaktes H-Diagramm ===
[[Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_H-Diagramm.png|mini|600x600px|H-Diagramm|links|verweis=Special:FilePath/WT_2.1_Erweiterungsmodul_Sammelbehälter_H-Diagramm.png]]

Ein kompaktes H-Diagramm gibt es bereits in webtrees. Wenn man ...

== Einzelnachweise ==
<references />

[[Kategorie:Webtrees]]

Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/TAM und Lineage/Lineage/Nachnamenfilter

2023-03-14T20:41:42Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Abschnitt 8.10.1.2.1|info=1}}{{WT-Inhaltsverzeichnis|Kapitel 8|G|Abschnitt 8.10|Abschnitt 8.10.1|Abschnitt 8.10.1.2|Abschnitt 8.10.1.2.1}}

== Nachnamenfilter ==

Aufgeklappt zeigt dieser Bereich zusätzliche Schaltflächen, mit denen man die Indexierung für das Farbschema der Personen-Knoten verändern kann.
[[Datei:huhwt-wtlin Viewport-NF.png|left|mini|480x320px|Aktive Elemente Nachnamenfilter]]
 
Ein ''Klick'' auf die obere Schaltfläche, welche das aktuell aktive Schema angibt, klappt die 3 mittleren Schaltflächen wieder ein.

Ein ''Klick'' auf eine der 3 mittleren Schaltflächen ändert das aktive Schema und klappt die Auswahl ebenfalls wieder ein.

Ein ''Klick'' auf die unterste Schaltfläche <tt>Filter bearbeiten</tt> öffnet ein zusätzliches Fenster - die '''Übersicht Namen im Bestand'''.

=== Übersicht Namen im Bestand ===

[[Datei:huhwt-wtlin Viewport-NF Start.png|right|mini|640x520px|Unterfenster: Übersicht Namen im Bestand]]

Oben sind neben der Überschrift 2 Symbole - links ein Haken, ''Klick'' darauf speichert den Filterzustand zurück - rechts ein Kreuz, ''Klick'' darauf bricht die Bearbeitung ab.

{|
|-
| [[File:huhwt-wtlin Viewport-NF Buttons-SC.png|left|frameless|300x90px|Schaltflächen Speichern / Schließen]]
|
* Der Haken färbt sich beim Darüberfahren mit der Maus grün, das Kreuz färbt sich rot.
* Beim Speichern wird der neue Filterzustand ausgewertet, die Darstellung ändert sich entsprechend.
* Bei Abbruch bleibt die Darstellung unverändert.
|}

Unter der Überschrift wird der aktuelle Filterinhalt angezeigt - '''Ausgewählte Namen'''. Das Textfeld kann bei Bedarf, wenn also sehr viele Namen ausgewählt wurden und die Anzeigefläche nicht mehr reicht, weiter aufgezogen werden.

Unter dem Textfeld kann die Namensliste nach Anfangsbuchstaben eingeschränkt werden - '''Alle''' setzt zurück auf die Gesamtansicht, ''Klick'' auf einen Buchstaben zeigt nur noch die Nachnamen an, die mit diesem Buchstaben beginnen. Die Buchstabenauswahl deckt den Bereich 'A' bis 'Z' ab, Nachnamen, welche mit Sonderzeichen beginnen wie z.B. <nowiki>@N.N.</nowiki> werden nur in der Gesamtansicht gezeigt. Die Schaltflächen für Anfangsbuchstaben, zu welchen es keinen Namen im Bestand gibt, sind deaktiviert.

Die angezeigte Namensliste - ungeachtet ob Gesamtliste oder Teilmenge - kann zusätzlich sortiert werden:

* '''checked:''' - Ausgewählte Namen werden oben angezeigt, der Rest dann nach dem letzten anderen vorher gewählten Sortierkriterium.
* '''Namen:''' - Alphabetische Sortierung
* '''Anzahl:''' - aus webtrees wird die Information mitgenommen, wie oft der Namen im Bestand auftritt und dient hier als Kriterium.

Ein Name wird über die voranstehende Checkbox aus- bzw. abgewählt. Bei Auswahl wird der Namen in das Textfeld darüber übernommen, bei Abwahl wieder aus dem Textfeld entfernt. Die Reihenfolge im Textfeld ergibt sich aus der Reihenfolge, in der die Namen angeklickt worden sind - für die später wirkende Filteraktion ist die Reihenfolge nicht relevant.
 
==== Aktionen im Unterformular ====

Eine Übersicht der möglichen Aktionen ...

<gallery widths=480px heights=420px>
File:huhwt-wtlin Viewport-NF Aktion-lM.png|Anfangsbuchstaben 'M' gewählt - Sortierung nach Anzahl
File:huhwt-wtlin Viewport-NF Aktion-lM-sN.png|Anfangsbuchstaben 'M' - Sortierung nach Namen
File:huhwt-wtlin Viewport-NF Aktion-lM-sC.png|Anfangsbuchstaben 'M' - Sortierung nach checked
</gallery>

Bei der <tt> Sortierung nach '''checked''' </tt> sind die Namen als 2. Reihenfolge nach der jeweils vorher aktiven sortiert.
 

{{Infobox|
Diese wie auch die folgenden Ansichten wurden mit Zoomstufe 150% im Browser erzeugt. Zusätzlich wurde auch in die Darstellung hineingezoomt.
}}

=== Ansicht '''mit Partnern''' ===

<gallery widths=770px heights=440px>
File:huhwt-wtlin Viewport-NF 1N.png|1 Name gewählt - Nur Personen dieses Namens
File:huhwt-wtlin Viewport-NF 1NpP.png|1 Name  <tt>''' mit Partnern '''</tt> - zusätzlich weitere Personen (kleinere Knoten)
</gallery>

=== Filter nachbearbeiten ===

Gegebene Ausgangssituation: 1 Namen im Nachnamenfilter - Frage: Was passiert, wenn man erneut die Filterfunktion aufruft?

Potentiell können beliebig viele Filter parallel vorgehalten werden. Wenn man nun die Filterfunktion aufruft und es gibt bereits definierte Filter, dann wird zusätzlich eine Übersicht der vorhandenen Filterdefinitionen eingeblendet. In dieser Liste wählt man per Checkbox-Häkchen eine Definition aus, die Namen werden in das Textfeld übernommen. Aktiviert man dort die Namensliste, erscheint unterhalb wieder die bekannte Auflistung und man kann weitere Namen anhaken oder abwählen. Würde man diesen Zustand direkt zurückschreiben, dann wäre der aktuelle Filter verändert - man hätte eine neue Situation, aber keine Alternative. Wählt man in der Übersicht der vorhandenen Filterfunktionen statt des für die Namensliste herangezogenen den allerersten - leeren - Eintrag, dann wird beim Zurückschreiben eine neue zusätzliche Filterdefinition weggeschrieben.

Entsprechend stehen dann beim wiederum erneuten Aufruf der Filterfunktion jetzt die leere Zeile und 2 mit Namen gefüllten Definition in der Übersicht. Braucht man eine davon nicht mehr, kann man diese über das Abfalltonnen-Symbol rechts von der entsprechenden Zeile aus der Übersicht entfernen, sie wird endgültig gelöscht und taucht beim nächsten Aufruf nicht mehr auf.

Es ist zu beachten, dass beim Zurückschreiben immer eine Definition ausgewählt ist. Schreibt man ohne Auswahl zurück, wird das Filterfeld geleert und es sind wieder alle Knoten in der Darstellung aktiviert.

<gallery widths=210px heights=132px mode="slideshow">
File:huhwt-wtlin Viewport-NF F0.png|-0- Übersicht Filterdefinitionen
File:huhwt-wtlin Viewport-NF F1.png|-1- Definition gewählt, dazu Namensliste aktiviert
File:huhwt-wtlin Viewport-NF F2.png|-2- weiterer Namen gewählt
File:huhwt-wtlin Viewport-NF F3.png|-3- leere Definition gewählt, Zurückschreiben
File:huhwt-wtlin Viewport-NF F4.png|-4- Darstellung erweitert um Personen mit 2. Namen (+ Partner), Filterfeld mit 2 Namen
File:huhwt-wtlin Viewport-NF F5.png|-5- Übersicht Filterdefinitionen, jetzt mit 2 Einträgen mit Namen
File:huhwt-wtlin Viewport-NF F6.png|-6- Definition mit 1 Namen gewählt, Zurückschreiben
File:huhwt-wtlin Viewport-NF F7.png|-7- Darstellung wieder eingeschränkt auf Personen nur eines Namens (+Partner)
File:huhwt-wtlin Viewport-NF F8.png|-8- Übersicht Filterdefinitionen, 2. Eintrag - Löschaktion
File:huhwt-wtlin Viewport-NF F9.png|-9- Übersicht Filterdefinitionen, nur noch 1 Eintrag
File:huhwt-wtlin Viewport-NF F10.png|-10- Zurückschreiben ohne gesetzte Filterdefinition - alle Knoten in Darstellung
File:huhwt-wtlin Viewport-NF F11.png|-11- alle Knoten in Darstellung - Menübereich ausgeblendet
</gallery>

Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/TAM und Lineage/Lineage

2023-03-14T20:41:32Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Abschnitt 8.10.1.2|info=1}}{{WT-Inhaltsverzeichnis|Kapitel 8|G|Abschnitt 8.10|Abschnitt 8.10.1|Abschnitt 8.10.1.2}}

Das [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodul]] '''Lineage''' ist ein Visualisierungsmodul, das ein Knoten-Kanten-Diagramm<ref>{{wikipedia-Link|Graphentheorie}}</ref> verwendet, um genealogische Beziehungen darzustellen.

Dieses [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule|Erweiterungsmodul]] für webtrees hat viele Ähnlichkeiten mit dem [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule|Erweiterungsmodul]] [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule/TAM_und_Lineage/TAM|TAM]], so dass gemeinsame Funktionen und Eigenschaften auf der übergeordneten Seite "[[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule/TAM_und_Lineage|TAM und Lineage]]" beschrieben sind.

Das Programm '''Lineage''' wurde ursprünglich von Ben Garvey veröffentlicht.<ref>[https://github.com/bengarvey/lineage bengarvey/lineage] auf GitHub</ref> Horst Stern hat es in einer angepassten Version auf seiner Homepage verwendet.<ref>Webseite [https://knoten.familie-stern.de knoten.familie-stern.de]</ref> Max Hagspiel hat ebenfalls eine angepasste Version entwickelt, die es erlaubte GEDCOM-Daten einzulesen.<ref>(nicht mehr im Web auffindbar)</ref> Die hier vorliegende Version kombiniert die Konzepte des Originals mit Elementen aus [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule/TAM_und_Lineage/TAM|TAM]] und fügt einige [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule/TAM_und_Lineage/Lineage#Besonderheiten|Erweiterungen]] hinzu.
{{-}}
{{Wichtig|Das Modul '''Lineage''' befindet sich in der Beta-Phase; noch nicht alle Aktionen führen zu den gewünschten Ergebnissen, die primären Funktionen sind jedoch bereits stabil.
 
Die vorliegende Anleitung beschreibt den Stand der aktuellen Entwickler-Version, Abweichungen zur veröffentlichten Version sind daher möglich. Die Abweichungen werden Bestandteil des nächsten Releases sein.}}

== Beschreibung ==
[[Datei:Wtlin-screen.png|right|mini|720x720px|Eine Person ist hervorgehoben - zusätzliche Informationen werden eingeblendet, wenn die Maus darüber schwebt]]

'''Lineage''' ('''LIN''') stellt die Verbindungen von Eltern und ihren Kindern und die Verbindungen zwischen den Eltern als Verbindungslinien (Kanten) dar. Die Personen werden als Knoten visualisiert.

Die primäre Darstellung ist die Baum-Ansicht mit den verknüpften Personen. Alternativ können die Personen auch in einer Zeitleiste oder nach Familiennamen gruppiert dargestellt werden (siehe nachfolgender Abschnitt "[[#Alternative Darstellungen|Alternative Darstellungen]]").

Die Verbindungen zwischen den Eltern und ihren Kindern sind gerichtet (Pfeilspitze zum Kind); Verbindungslinien zu männlichen Nachkommen und zu Nachkommen mit unbekanntem Geschlecht sind sie in hellblau, zu weiblichen in helllila dargestellt. Es wird bei der Darstellung dieser Verbindungen nicht zwischen biologischen Eltern und Adoptiveltern unterschieden. Die Verbindungen zwischen den beiden Eltern sind ungerichtet (ohne Pfeilspitzen); sie sind gestrichelt und in lindgrün visualisiert.

Die Personen-Knoten werden in ihrer Darstellung nach Geschlecht differenziert - Männer werden als Quadrate, Frauen und Personen mit unbekanntem Geschlecht werden als Kreise präsentiert.

Die Farbe der Knoten variiert, je nach Familienname. webtrees bietet neben dem Nachnamen im Klartext auch die Umsetzung gemäß Soundex<ref>{{wikipedia-Link|Soundex}}</ref>, sowohl in der Standardvariante als auch in der Daitch–Mokotoff-Variante (SoundDM) an. Alle drei Ausprägungen der Namen werden in Lineage übernommen. Die SoundDM-Ausprägung dient dabei als Index bei der Wahl der Knotenfarbe im verwendeten Farbraum. Familiennamen, die sich z.B. in Groß- und Klein-Schreibung oder in alternativen Umlaut-Schreibweisen unterscheiden, werden so gleichfarbig dargestellt; dies wäre anders, wenn man den Namen im Klartext für die Farbwahl verwenden würde.

=== Besonderheiten ===
Eine wesentliche Ergänzung gegenüber der Ursprungsversion von Lineage besteht in der Möglichkeit, den Bezugszeitpunkt der Darstellung zu wählen. Der Darstellungszeitraum ist auf die Zeitspanne von 1500 bis zum Zeitpunkt des letzten relevanten Ereignisses im Leben der dargestellten Personen eingestellt, wobei auf Zehnjahresstufen aufgerundet wird. Sollte ein Ereignis bei einer Person vor dem Jahr 1500 gefunden werden, erweitert sich der Zeitraum entsprechend in Stufen von einhundert Jahren. Im Menü-Bereich sind Sprungmarken eingefügt, so dass man den Bezugszeitpunkt auf eine Jahrhundert-Marke einstellen kann. Im oberen Bereich des Bildschirms befindet sich ein Steuerelement, mit dem man den Bezugszeitpunkt sowohl in 10-Jahres-Schritten als auch präzise um jeweils ein Jahr vor und zurück verändern kann.

Beim Wechsel des Bezugszeitpunkts werden solche Knoten, deren Bezugsjahr außerhalb des Zeitraums liegt, automatisch entfernt bzw. auch wieder eingefügt, wenn die Grenzwerte (Startjahr des Darstellungszeitraums - aktueller Bezugszeitpunkt) das Bezugsjahr mit einschließen.

Eine weitere Ergänzung zu Lineage in der Ursprungsversion betrifft die Option, Teilmengen der Nodes nach Familiennamen abzugrenzen. Man kann eine umfassende Liste der Familiennamen aufrufen, wahlweise sortiert nach Häufigkeit oder alphabetisch und innerhalb der Gesamtmenge auch noch abgrenzbar nach Anfangs-Buchstaben. Mittels Checkboxen können nun Namen ausgewählt und als Filter-Kriterium hinterlegt werden. Dabei können auch mehrere Filter-Definitionen gebildet und im weiteren Verlauf zwischen diesen gewechselt werden. Wie beim Bezugsjahr werden alle Nodes, deren Namenskriterium nicht dem aktiven Filter entsprechen, aus der Darstellung entfernt. Das relevante Namenskriterium ergibt sich gemäß der Vorgabe des Names-Schemas (siehe oben), ist z.B. SoundDM gesetzt, werden alle dem SoundDM-Wert eines Namens im Filter entsprechenden Nodes mit angezeigt, auch wenn deren Klarnamen davon abweicht.

Namensfilter und Zeitsteuerung sind hierarchisch angeordnet - auf die Grundgesamtheit der Personen im Datenbestand wird zuerst der Namensfilter angewendet, auf die dadurch abgegrenzte Teilmenge wirkt dann der Zeitfilter. In der Anwendung sind sie allerdings unabhängig - man kann also erst den Bezugszeitpunkt verändern und damit Personen ausblenden, und dann in einem zweiten Schritt zusätzlich noch einen Namensfilter setzen. Wird der Bezugszeitpunkt dann wieder auf das Endjahr gesetzt, bleibt der Namensfilter weiterhin wirksam.

=== Alternative Darstellungen ===
Die klassische '''Baum-Ansicht''' ist die primäre Darstellung, mit dieser Ansicht wird LIN bei jedem Aufruf gestartet.

Daneben - und grundsätzlich ähnlich ausgestattet - gibt es auch die '''Zeitleiste-Ansicht''' und die '''Gruppen-Ansicht'''. Diese beiden Ansichten stellen nur Knoten, d.h. Personen dar; die Kanten, d.h. die Familienverbindungen sind bei diesen Darstellungen nicht relevant.

Die '''Gruppen-Ansicht''' führt alle Personen gleichen Familiennamens zusammen.

Die '''Zeitleiste-Ansicht''' ordnet die Personen von links nach rechts entsprechend ihres Geburtsdatums an.

Hier zum Vergleich ein Testdatenbestand mit den drei verschiedenen Ansichten:

<gallery widths=500px heights=280px>
File:Huhwt-wtlin Viewport-Baum.png|Testdaten - Baum-Ansicht
File:Huhwt-wtlin Viewport-Zeitleiste.png|Testdaten - Zeitleiste-Ansicht
File:Huhwt-wtlin Viewport-Gruppen.png|Testdaten - Gruppen-Ansicht
</gallery>

{{Infobox|"Gruppen" und "Zeitleiste" sind noch nicht abschließend definiert, ihre konkrete Ausgestaltung wird sich wahrscheinlich noch ändern.}}

== Bedienoberfläche ==
[[Datei:Huhwt-wtlin Viewport-v2K.png|rechts|mini|800x600px|Anzeigefläche von Lineage mit den Bedienfeldern und den Informationselementen]]

Der komplette Bildschirm dient als Anzeigefläche (Viewport) für das Knoten-Kanten-Diagramm; überlagert sind einige Bereiche, die Bedienfelder und Informationstexte beinhalten. In der nebenstehenden Abbildung sind diese Bereiche gelb markiert.

* Am linken Rand befindet sich das Steuermenü ([[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule/TAM_und_Lineage/Lineage#Menübereich|'''Menübereich''']]). Es kann durch einen Klick auf die Schaltfläche "Menü" ([[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule/TAM_und_Lineage/Lineage#Menü-Toggle|'''Menü-Toggle''']]) am oberen Rand ausgeblendet werden - die Schaltfläche ist dann weiterhin sichtbar, ein erneuter Klick darauf blendet den Menübereich wieder ein.
* Am oberen Rand befindet sich die [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule/TAM_und_Lineage/Lineage#Zeitsteuerung|'''Zeitsteuerung''']].
* Oben rechts befinden sich Steuerflächen ([[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule/TAM_und_Lineage/Lineage#Aktionen|'''Aktionen''']]), die die Darstellung beeinflussen, und zwei Informationsfelder, die auf Details hinweisen ("'''Hitze'''", "'''Transform'''").
* Unten in der Mitte werden Informationen zum Bezugszeitpunkt und der Anzahl der dargestellten Knoten eingeblendet ([[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule/TAM_und_Lineage/Lineage#Infobereich|'''Infobereich''']]).
 

Die gesamte Darstellung des Knoten-Kanten-Diagramms lässt sich auf der Bildschirmfläche verschieben ('''Pan''') und nach Belieben vergrößern und verkleinern ('''Zoom'''). Einzelne Knoten lassen sich durch einen ''Klick'' auswählen und auf eine andere Position in der Darstellung verschieben ('''Drag-n-Drop'''), dabei wird auch ihre Position fixiert. Solche fixierten Knoten sind durch eine andere Größe besonders hervorgehoben. Ein Knoten lässt sich auch durch einen ''Doppel-Klick'' auf seiner aktuellen Position fixieren. Ein ''Klick'' auf einen fixierten Knoten gibt ihn wieder frei.

Fährt die Maus über einen Knoten, werden Informationen zur Person als Tooltip angezeigt (siehe Abbildung ganz oben).

=== Aktive Elemente ===
[[Datei:Wtlin-screen Aktions-Buttons.png|rechts|mini|800x600px|Aktive Elemente im Viewport]]

Alle aktiven Elemente, also jene bei denen ein ''Klick'' darauf eine Veränderung auslöst - Alternative Darstellung, Folgeaktionen, Viewport-Steuerung - färben sich beim Darüberfahren mit der Maus (Hovern) grün ein.

=== Bedienelemente Linke Seite ===

==== Menü-Toggle ====
Ein ''Klick'' auf diese Schaltfläche blendet den Menübereich aus, die Schaltfläche selbst schiebt sich an den linken Rand. Ein erneuter ''Klick'' lässt den Menübereich wieder erscheinen, die Schaltfläche wandert entsprechend mit.

==== Menübereich ====
In diesem Bereich können verschiedene Folgeaktionen ausgelöst und Viewport-Veränderungen bewirkt werden. Der Menübereich ist selbst wiederum in verschiedene Bereiche unterteilt, die in den folgenden Abschnitten beschrieben werden.

===== Öffnen / Speichern =====
: Ein ''Klick'' auf diese Schaltfläche öffnet im Menübereich einen zusätzlichen Block, in dem man Lese- und Schreiboperationen im Dateisystem oder in der IndexedDB (IDB) steuern kann. Wählt man die Datei-Aktionen, werden als Folgeaktion die üblichen Datei-Dialoge aufgerufen. Für IDB-Aktionen wird der Viewport mit einer Übersicht über die verfügbaren IDB-Slots geöffnet. Zwischen den Schaltflächenbereichen wird der Name der gewählten Datei bzw. des IDB-Slots angezeigt und kann auch beschrieben werden.

===== Knotenansichten =====
: Hier kann man zwischen den alternativen Darstellungsvarianten umschalten.

===== Nachnamenfilter =====
: Dieser Unterbereich ist selbst noch einmal untergliedert
: * obere Zeile - 1 Schaltfläche, Checkbox ''beliebig'', Checkbox ''mit Partnern
:* Schaltfläche - Der angezeigte Text zeigt, welches Substitutionsschema derzeit aktiv ist. ''Klick'' auf die Schaltfläche öffnet eine Übersicht mit weiteren Schaltflächen für die verfügbaren Schemata - surName, soundDM, soundSTD - ''Klick'' auf eine dieser zusätzlichen Schaltflächen bewirkt im Hintergrund entsprechende Reaktionen - die Knoten-Einfärbungen können sich ändern, in der Gruppen-Ansicht auch die Verteilung.
:* Checkbox ''beliebig'' - ...
:* Checkbox ''mit Partnern'' - diese Checkbox zeigt ihre Wirkung dann, wenn ein Nachnamen-Filter gesetzt ist. Der Filter bewirkt eine primäre Einschränkung der dargestellten Nodes auf solche Personen, deren Nachname dem aktuellen Namens-Substitutionsschema entspricht. Da Partner üblicherweise mit ihrem eigenen Familiennamen geführt werden, deren Umsetzung dann auch entsprechend anders ausfällt, scheinen sie in der Darstellung nicht auf. Ist die Checkbox gesetzt, werden sie aber doch mit angezeigt. Um solche Nodes von denen zu differenzieren, die dem Filterkriterium entsprechen, werden die Partner-Nodes in halber Größe angezeigt.
: * mittlere Zeile - Hinweistext, 1 Schaltfläche
:* Hinweistext - Man kann grundsätzlich auch selbst direkt Einträge im Filterfeld machen. Stellt man dabei mehrere Namen ein, muss man diese mit ''';''' trennen, damit das System die Namen voneinander abgrenzen kann.
:* Schaltfläche - ''Klick'' auf diese Schaltfläche öffnet im Viewport einen modalen Dialog - er wird anschließend beschrieben.
: * untere Zeile - Filterfeld: Hier stehen die im aktuellen Filter definierten Namen. Das Feld wird entweder über den speziellen Dialog oder durch eine direkte Eingabe gefüllt. Bei direkter Eingabe ist auf das abschließende Semikolon ";" zu achten.
: Ausführliche Informationen hierzu in eigenem Abschnitt [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule/TAM_und_Lineage/Lineage/Nachnamenfilter|Bereich und Aktionen im Detail]].

{{Infobox|Die Namen werden wie geschrieben übernommen, Groß- und Kleinschreibung, Umlaute und Aktzentuierengen etc. sind relevant. Die Soundex-Operationen nehmen zwar diverse Normalisierungen und Anpassungen vor, der Klarnamen wie im Gedcom hinterlegt ist allerdings der relevante Schlüssel, mit dem die dazu passende Substituierung gefunden wird. Die Soundex-Ausprägungen werden aus webtrees übernommen, die Operationen dahinter sind komplex und umfangreichen Regeln unterworfen, welche nicht hier nachgebaut worden sind. Die Namen müssen also so geschrieben sein, wie man sie im Stammbaum findet, damit das Verfahren wirken kann.}}

===== Navigation / Animation =====
: Dieses Element besteht aus einem Feld mit Jahreszahlen, die Schaltflächen sind. Ein ''Klick'' auf eine Schaltfläche setzt den Bezugszeitpunkt auf den entsprechenden Jahreswert, der Umfang der Darstellung wird entsprechend angepasst.

===== Graph Darstellung =====
: Ein ''Klick'' auf diese Schaltfläche öffnet im Menübereich einen zusätzlichen Block, in dem man verschiedene Eigenschaften der Darstellung im Viewport verändern kann. Diese betreffen nur die Oberfläche, nicht die Anzahl der Knoten.
: * Checkbox ''' ''Graph zeigen'' ''' - Wählt man die Option ab, werden die Nodes und Links ausgeblendet.
: * Checkbox ''' ''Links zeigen'' ''' - Wählt man die Option ab, werden die Links ausgeblendet.
: * Checkbox ''' ''Namen zeigen'' ''' - Wählt man die Option ab, verschwinden die Namen unter den Nodes, die Nodes selbst bleiben erhalten.
: * Checkbox ''' ''Node Info zeigen'' ''' - Wählt man die Option ab, wird kein Tooltip mit den Informationen zur Person gezeigt.
: * Spinner ''' ''Link Intensität'' ''' - Verändert man den Wert, werden die Links entsprechend kräftiger oder blasser/dünner gezeichnet.
: * Spinner ''' ''Node Radius'' ''' - Verändert man den Wert, werden die Nodes entsprechend größer oder kleiner gezeichnet. (Option derzeit nicht aktiv)
: * Spinner ''' ''Node Text Deckkraft'' ''' - Verändert man den Wert, werden die Text zu den Nodes entsprechend kräftiger oder blasser dargestellt (betrifft nur die Texte, nicht den Tooltip).

===== Sprache =====
: Ein ''Klick'' auf diese Schaltfläche öffnet im Menübereich einen zusätzlichen Block, in dem man die Anzeigesprache umstellen kann.
: * de - Deutsch
: * en - Englisch
: * nl - Niederländisch.

: Die Schaltflächentexte, die Meldungen usw. sind alle übersetzt worden. Korrekturwünsche und Übersetzungen in weitere Sprachen können über [https://github.com/huhwt/huhwt-wtlin GitHub] gemeldet bzw. eingereicht werden.

=== Bedienelemente Mitte Oben ===
Die Bedienelemente am oberen Bildschirmrand dienen zur Zeitsteuerung.

==== Zeitsteuerung ====
: Dieses Bedienelement erlaubt es den Bezugszeitpunkt neu einzustellen, zum einen durch Verschieben eines Sliders, zum anderen durch den "Play-Modus" - das ist der automatische Jahreswechsel im Vorlauf oder auch zurück zum Anfangsjahr. Sowohl im "Play-Modus" als auch durch entsprechende Steuerflächen im Block wird um jeweils 1 Jahr gewechselt, die Slider haben ein 10-Jahres Raster.
[[Datei:Wtlin-screen Viewport-Zeitsteuerung_Buttons.png|right|mini|240x240px|Schaltflächen]]
: * Links ein Block von Schaltflächen:
:* Oben: "Play-Modus" Zurück, Stop, Vor
:* Unten: 1 Jahr Minus, 1 Jahr Plus.
 
[[Datei:Wtlin-screen Viewport-Zeitsteuerung_Slider.png|right|mini|720x240px|Slider]]
: * Rechts ein doppelter Slider
:* Oben: 10-Jahre Raster, der Schieber kann von Tick zu Tick bewegt werden
:* Unten: 10-Jahre Raster, 2 Schieber definieren Anfangs- und Endzeitpunkt für den oberen Schieber sowie den Zeitrahmen für den "Play-Modus"

=== Bedienelemente und Informationsfelder Rechte Seite ===
Auf der rechten Seite des Bildschirms befinden sich Aktions- und Informationsfelder.

==== Aktionen ====
Die '''Aktionen''' sind als Symbole dargestellt.
[[Datei:Wtlin-screen Viewport-Aktionen_Liste.png|right|80x80px|Aktion - Export SVG]]
*''' ''Export SVG'' '''(Listen-Symbol) - Ein Schnappschuss der Darstellung wird im SVG-Format exportiert und kann dann später in einem Betrachter (Browser oder SVG-Viewer) aufgerufen werden.
 
[[Datei:Wtlin-screen Viewport-Aktionen_Stop.png|right|80x80px|Aktion - Simulation Stop]]
*''' ''Simulation Stop'' '''(Stop-Symbol) - Die Simulationsschleife wird unterbrochen und der Darstellung wird eine Höhenlinien-Darstellung des zeitlichen Bezugsrahmens unterlegt. Das erneute Betätigen blendet die Hintergrundkarte wieder aus, und die Simulationsschleife wird fortgesetzt.
 
[[Datei:Wtlin-screen Viewport-Aktionen_Thermometer.png|right|80x80px|Aktion - Simulation Animieren]]
*''' ''Simulation Animieren'' '''(Thermometer-Symbol) - Die Simulations-Schleife durchläuft einen Zyklus abnehmender Intensität. Bei komplexen Zusammenhängen, das hängt auch von der Anzahl der Knoten und Verbinden ab, ist der Zustand der Darstellung noch nicht so, dass die Auffächerung der Verteilung gemäß den Randbedingungen das Optimum erreicht hätte. Mit diesem Schalter wird ein weiterer Iterations-Zyklus gestartet. Ist die Auffächerung nahezu optimal, wird sich keine wesentliche Veränderung mehr ergeben, ansonsten wird man anfänglich wieder deutliche Positions-Änderungen sehen.
 
[[Datei:Wtlin-screen Viewport-Aktionen_Zielscheibe.png|right|80x80px|Aktion - Zentrieren]]
*''' ''Zentrieren'' '''(Zielscheiben-Symbol) - Mit Zoom und Pan lässt sich die Darstellung im Viewport nach Belieben verschieben. Diese Schaltfläche zentriert die Darstellung wieder auf den visuellen Nullpunkt und setzt die Skalierung auf 100% zurück.
 

==== Informationsfelder ====
Die beiden Informationsfelder zeigen Werte zur Simulation und zur grafischen Darstellung.
[[Datei:Wtlin-screen Viewport-Information_alpha.png|right|300x70px|Information- ''Hitze'']]
* ''' ''Hitze'' ''' - Zeigt den Wert ''alpha'', das ist der "Energie-Level" der Simulation; man kann erkennen, wie dieser Wert im Verlauf der Iterationen in der Simulation abnimmt.
 
[[Datei:Wtlin-screen Viewport-Information_transform.png|right|300x120px|Information - ''Transform'']]
*''' ''Transform'' ''' - Zeigt die Werte ''zoom'' sowie ''x'' und ''y'', also die aktuelle Skalierung sowie die Verschiebung des Mittelpunkts der Darstellung durch die Funktionen Zoom und Pan.{{WT-ToDo|Ist das neu?}}
 

=== Informationsfeld Mitte Unten ===
Am unteren Rand des Bildschirms wird der Infobereich dargestellt.

==== Infobereich ====
Im Infobereich werden der aktuelle Bezugszeitpunkt sowie die Anzahl der aktiven und der ausgeblendeten Knoten angezeigt.
* Oben: aktuelles Bezugsjahr der Darstellung
* Unten: Anzahl der Knoten in der Darstellung und die Anzahl der gegebenenfalls gerade nicht angezeigten Knoten (Namensfilter, außerhalb der Zeitscheibe).

== Beispiele für Visualisierungen ==
Die Besonderheit der Visualisierung in diesem Modul gegenüber anderen [[Webtrees Handbuch/Anleitung für Besucher#Diagramme|Diagrammen]] in webtrees liegt darin, dass die Darstellung sehr interaktiv und dynamisch erfolgt. Die Ergebnisse können vom Benutzer sehr weitgehend beeinflusst werden. Daher geben statische Screenshots nur einen sehr unvollkommenen Eindruck von der Mächtigkeit der Visualisierungsmöglichkeiten. Einige Beispiele sollen hier jedoch einen ersten Eindruck vermitteln.

=== Familiennamengruppen bei den Bewohnern eines Dorfes ===
[[Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Familiennamengruppen.png|mini|600x600px|Familiennamengruppen bei den Bewohnern eines Dorfes|links|verweis=Special:FilePath/WT_2.1_Erweiterungsmodul_Sammelbehälter_Familiennamengruppen.png]]
{{-}}

== Einzelnachweise ==
<references />

[[Kategorie:Webtrees]]

Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/TAM und Lineage

2023-03-14T20:41:22Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Abschnitt 8.10.1|info=1}}{{WT-Inhaltsverzeichnis|Kapitel 8|F|Abschnitt 8.10|Abschnitt 8.10.1|Abschnitt 8.10.1}}

Die beiden [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodule]] '''TAM''' und '''Lineage''' dienen zur Visualisierung von genealogischen Strukturen. Beide verwenden Knoten-Kanten-Diagramme<ref>{{wikipedia-Link|Graphentheorie}}</ref>. Die beiden Module haben einige Gemeinsamkeiten; diese werden in diesem Abschnitt zusammen beschrieben; die Besonderheiten werden jeweils in Unterseiten dokumentiert.

== Steckbrief ==
*[[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule/TAM_und_Lineage/TAM|TAM]]
*[[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule/TAM_und_Lineage/Lineage|Lineage (Beta-Version)]]

Die folgenden Punkte kennzeichnen diese Module
* Modulnamen
** huhwt-wttam (TAM)
** huhwt-wtlin (Lineage)
* Autor: huhwt (EW.H)
* Passende webtrees-Version: 2.1
* Speicherort
** TAM: [https://github.com/huhwt/huhwt-wttam GitHub]
** Lineage: [https://github.com/huhwt/huhwt-wtlin GitHub]
* Modulkategorie: Sonstige
* Modulfunktion: Diagramm "TAM" bzw. Diagramm "Lineage"

== Beschreibung ==

=== Architektur ===
[[Datei:WT 2.1 huhwt-wtviz.png.png|alternativtext=Architektur der Erweiterungsmodule TAM und Lineage|links|mini|600x600px|Architektur der Erweiterungsmodule TAM und Lineage]]
Anders als bei den meisten anderen [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodulen]] sind die Anteile des PHP<ref>{{wikipedia-Link|PHP}}</ref>-Codes in diesen beiden Modulen sehr gering; der PHP-Code dient primär der Einbindung in die Modulverwaltung von webtrees und umfasst jeweils nur wenige Dutzend Zeilen Code. Beide Module bestehen vor allem aus mehreren Tausend Zeilen JavaScript<ref>{{wikipedia-Link|Javascript}}</ref>-Anweisungen. Diese Schwerpunktverschiebung ist mit ein Grund dafür, dass diese Module nicht direkt im Bildschirmkontext von webtrees ausgeführt werden, sondern jeweils in einem eigenen neuen Tab im Browser gestartet werden, sobald die Funktion "Visualisierung" im Erweiterungsmodul "[[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Sammelbehälter|Sammelbehälter]]" gestartet wird.

==== Datenströme ====
PHP wird auf dem Server ausgeführt, JavaScript demgegenüber ausschließlich im Browser, also auf dem lokalen Computer des Nutzers. Die Server- und die Browser-Welt sind aus Sicherheitsgründen grundsätzlich gegeneinander abgeschottet, das heißt man kann vom Browser nicht direkt auf Server-seitige Daten zugreifen und man kann vom Server nicht ohne explizite Benutzeransprache Daten auf dem lokalen Computer ablegen.

Die Zugriffsmechanismen wirken nun wie folgt zusammen
* Das Erweiterungsmodul "[[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Sammelbehälter|Sammelbehälter]]" legt die dort gesammelten Datensätze als Referenzen in einem für alle Server-Prozesse zugänglichen Bereich ab, dem Sammelbehälter.
* Der PHP-Anteil von TAM beziehungsweise von Lineage sammelt die notwendigen Daten, auf die die Referenzen im Sammelbehälter verweisen, und schreibt sie in einen Kanal, der für die Kommunikation mit der Browser-Seite verfügbar ist.
* Die JavaScript-Komponente der Visualisierungsmodule liest aus diesem Kanal und schreibt die Informationen dann in eine Browser-seitige Datenbank (IndexedDB), auf die dann die Darstellungsfunktion dieser Visualisierungsmodule zugreifen kann.
Der Datentransfer läuft im Hintergrund ab, Aktionen durch den Benutzer werden nicht angefordert. Je nach Umfang der Daten kann der Transfer etliche Sekunden benötigen; die PHP-Seite der Module teilt dem Benutzer den vollständigen Transfer mit und ermöglicht ihm dann die eigentliche Visualisierung zu starten.

IndexedDB, die Browser-seitige Datenbank, bietet nun den Vorteil, dass man mehr oder weniger nach Belieben auch selbst Daten wegschreiben kann. Es lassen sich also einmal zusammengestellte Datenbestände für spätere Analysen aufheben, ohne dass man erneut die einzelnen Teilmengen im CCE sammeln muss. Dabei lassen sich auch unterschiedliche Darstellungsvarianten separat speichern.

Die Webtrees-Daten werden im originalen GEDCOM-Format angeliefert, TAM und LIN können diese dann auch zusätzlich als "echte" Datei auf den lokalen Computer herausschreiben bzw. lesen. Somit können die Daten auch physisch eigenständig gespeichert werden. IDB hat nämlich einen inhärenten Nachteil: es wird vom Browser verwaltet und unterliegt gewissen quantitativen Beschränkungen - es handelt sich zwar um Giga-Byte Größenordnungen und es lassen sich so auch große Datenbestände vorhalten. Nutzt man andererseits intensiver die Option, Simulations-Zwischenstände in großer Zahl zu speichern, kann man irgendwann doch an eine Grenze stoßen. Jeder Browser hat seine eigene IDB-Umgebung, nutzt man beispielsweise sowohl Chrome als auch Firefox (oder Edge) parallel, so sind die jeweiligen IDB-Bestände im anderen Browser zwangsläufig nicht bekannt. Schließlich kann man IDB-Datenbanken nicht eigenständig sichern, physikalisch sind sie irgendwo tief unten in den Profil-Dateien lokalisiert und lassen sich nicht separat abgreifen. (Übrigens ist die IDB-Umgebung auch an die Homepage gebunden - hat man eine lokale Webtrees-Datenbank und eine Provider-Installation, so sind das auch bei an sich identischem Datenbestand für den Browser zwei vollkommen gegeneinander abgeschottete Datenwelten, man kann nicht auf die entsprechenden IDB-Bestände der jeweils anderen Quelle zugreifen und Daten miteinander mischen oder überleiten).

=== Darstellung ===
[[Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Partnerketten_mit_Hintergrund.png|mini|400x400px|Partnerketten (mit einem temporalen Feld als Hintergrund)]]
Es handelt sich um '''Knoten-Kanten-Diagramme''', wobei die Knoten für die Personen und die Verbindungslinien für die Verwandtschaftsbeziehungen stehen. Die Darstellungen sind dynamisch und interaktiv. Die Dynamik ergibt sich aus dem Darstellungsverfahren, siehe nächsten Abschnitt. Das Interaktive stellt sich so dar, dass man den Bildschirminhalt insgesamt nach Belieben verschieben kann ('''Pan'''), die Darstellung sich in weiten Grenzen vergrößern und verkleinern lässt ('''Zoom''' - die Mausposition gibt den Focus-Punkt der Veränderung vor) und schließlich sich auch einzelne Knoten durch Klick selektieren und an jede gewünschte andere Position verschieben und dort fixieren lassen ('''Drag-n-Drop''').

==== Darstellungsverfahren ====
Das '''Darstellungsverfahren''' ist Force-Simulation, ein Verfahren aus dem Baukasten von D3.js<ref>{{wikipedia-Link|en:D3.js}}</ref>, einer seit vielen Jahren und weithin eingesetzten umfassenden Bibliothek von Prozeduren und Funktionen, mit denen sich umfangreiche und komplexe Datenbestände elegant und intuitiv darstellen und analysieren lassen. Mittlerweile wohlbekannte Einsatzfälle von D3.js sind zum Beispiel die Covid-Dashboards der Johns-Hopkins-Universität oder auch des RKI sowie einschlägige Nachrichtenseiten großer Magazine und Tageszeitungen, wo wirtschaftliche, politische und gesellschaftliche Sachverhalte grafisch aufbereitet dokumentiert und diskutiert werden.

Force-Simulation bezeichnet den Ansatz, dass den Knoten (und Links) abstoßende und anziehende Kräfte zugeschrieben werden. Die Darstellung ergibt sich dann und entwickelt sich aus dem fortlaufenden und immer wieder aufs Neue durchgeführten Aufrechnen (iteratives Verfahren) der Wirkungen der Kräfte auf die Knoten und ihre Verteilung. Jede neu aufgerufene Visualisierung startet mit einer dichten Zusammenballung aller Knoten, von Durchgang zu Durchgang werden sie dann durch die wirkenden Kräfte auf andere neue Positionen verschoben und wechseln fortlaufend ihren Platz. Das Verfahren ist einerseits sehr rechenintensiv, andererseits hocheffizient umgesetzt. Tatsächlich ist die konkrete Bildschirmdarstellung eigentlich ein Schnappschuss der jeweils aktuellen Verteilung, von einem Neuzeichnen des Bildschirms zum nächsten sind im Hintergrund jeweils mehrere Iterations-Schritte abgearbeitet worden. Daraus folgt, dass die Positionswechsel zu Beginn einer Visualisierung sehr sprunghaft zu sein scheinen, die Kräfte wirken noch sehr heftig, mit steigender Iterations-Zahl wird die Wirkung abgeschwächt und die Darstellung wird zunehmend ruhiger.

Das Verfahren ist der Grund, dass die Darstellung abhängig von den Startwerten und Randbedingungen - dazu gehört nicht zuletzt die Zahl der dargestellten Knoten und Verbindungen - unter Umständen nie wirklich zu einem ausgeglichenen Endzustand kommen kann bzw. wird. In beiden Modulen lässt sich trotzdem vorübergehend die Darstellung "einfrieren", damit man den Zustand in Ruhe analysieren kann (siehe die jeweiligen Beschreibungen). Im eingefrorenen Zustand wird ein ''Temporales Feld'', eine Darstellung der zeitlichen Zusammenhänge in der Art einer Höhenlinien-Darstellung wie auf einer Landkarte unterlegt.

==== '''''Einfrieren''''' ====
Das Einfrieren passiert dann, wenn der vorgegebene End-Energiewert Null erreicht bzw. auf Null gesetzt wird. Ist ein End-Energiewert ungleich Null vorgegeben, dann verschieben sich die Knoten und Verbindungen fortwährend um einen gewissen in der Schrittweite vom Energiewert abhängigen Betrag. Je geringer der Wert, desto geringer die Verschiebungen. Ist der End-Energiewert sehr niedrig angesetzt, scheint die Darstellung nahezu statisch, erst bei großem Zoom sieht man dann, dass sich die Knoten noch immer leicht verschieben. Der Nachteil dabei ist, dass bei großer Knotenzahl die Verteilung noch nicht wirklich optimal im Sinne des Verfahrens ist, also alle Kräfte sich quasi gegenseitig aufheben, die Darstellung ist zwar ruhig, es gibt aber noch viele Überschneidungen und Überlagerungen. Ist der End-Energiewert höher, ruckeln die Knoten solange hin und her, bis dann irgendwann doch der Gleichgewichtszustand erreicht ist. Je nach Datenlage können sich Knotenstränge dabei aber auch durchaus gegenseitig blockieren, wird die Darstellung auch nach einiger Zeit nicht nachhaltig ruhiger, kann man versuchsweise durch Drag-n-Drop Knoten in einen anderen Bereich verschieben und dort wieder freigeben - dabei ändert sich die interne Gleichgewichtslage nachhaltig und es entsteht eine neue Ausgangssituation.
TAM und LIN verfolgen diesbezüglich unterschiedliche Ansätze:
: TAM gibt einen vergleichsweise hohen End-Energiewert vor, die Darstellung verbleibt die ganze Zeit in einem gewissen "Unruhestand". Das ist auch darin begründet, dass wegen der Familien- und den davon abhängigen Personen-Knoten das Austarieren der Kräfte komplexer als bei einer nur 1-stufigen Hierarchie wie in LIN gerät. Auch in TAM kann die Darstellung irgendwann nahezu statisch erscheinen, es ist aber eher unwahrscheinlich.
: LIN setzt die End-Energiewerte ausgesprochen niedrig an, wie ausgeführt ist es sehr wahrscheinlich, dass die dann erreichte Verteilung noch verbessert werden könnte. Es gibt deshalb eine Option, den Energie-Wert wieder auf den Startwert 100% hochzusetzen und damit eine weitere Abfolge von Iterationen zu starten. Bei großer Knoten-Anzahl wird sich das in weiteren Verschiebungen bemerkbar machen, liegt die Anzahl in eher niedrigem Bereich von maximal einigen 100ern, wird sich die Darstellung eher nicht mehr verändern, da ein stabiler Gleichgewichtszustand der wirkenden Kräften eingetreten sein dürfte.

== Bedienoberfläche ==
<div><ul>
<li style="display: inline-block; vertical-align: bottom;"> [[File:huhwt-wtviz-TAMviewport-regions.png|thumb|none|800px|TAM Bildschirm]] </li>
<li style="display: inline-block; vertical-align: bottom;"> [[File:huhwt-wtviz-LINviewport-regions.png|thumb|none|800px|LIN Bildschirm]] </li>
</ul></div>
 

Beide Module haben als primäres Element den '''''Viewport''''', die Darstellungsfläche. Ebenfalls sind beide mit einem '''''Menü''''' ausgestattet. Das LIN-Modul hat weitere wichtige Bereiche - '''''Zeitsteuerung''''', '''''Aktionsbereich''''' und '''''Infobereich'''''. Einzelheiten dazu siehe [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/TAM und Lineage/Lineage|Lineage - Detaillierte Beschreibung]].

Der Viewport bei TAM teilt sich den Bildschirm mit dem Menü - Knoten und Links werden vom Menü komplett überdeckt. LIN andererseits verwendet den ganzen Bildschirm als Darstellungsfläche, die Knoten und Links werden auch unterhalb des Menüs noch gezeichnet, bei Bedarf lässt sich das Menü komplett ausblenden. Zoomt man weit genug in die Darstellung hinein, sieht man, dass auch unter den zusätzlichen Bereichen Knoten und Links gezeichnet werden, die aktiven Elemente der Bereiche liegen allerdings oberhalb der Zeichnung, so dass man keine Reaktion der Knoten auf Maus-Ereignisse mehr erhält.

Die Darstellung wird mit 6000 Pixeln Höhe und Breite erzeugt, ist also deutlich größer als ein üblicher Computer-Monitor.

Die '''Darstellung''' unterstützt '''Zoom''', '''Pan''' und '''Drag-n-Drop''':
;Zoom
: Mit dem Mausrad kann man die Darstellung nach Belieben vergrößern und verkleinern.
;Pan
: Mit einem Klick in einen freien Bereich der Darstellung - kein Knoten unter der Maus - kann man den gesamten Baum im Viewport verschieben.
;Drag-n-Drop
: Beim Klick auf einen Knoten wird dessen Größe verdoppelt. Zieht man ihn in diesem Zustand an eine andere Position, wird er dort fixiert, unterliegt nicht mehr dem Iterations-Verfahren und stabilisiert als Nebeneffekt auch die Positionen der mit ihm über Links verbundenen anderen Nodes. Ein erneuter Klick auf den Node hebt die Fixierung auf, die Größe wird auf den regulären Wert zurückgesetzt und der Node folgt wieder den Simulations-Effekten.

Überstreicht der Mauszeiger einen Knoten, werden die zugehörigen Informationen als Tooltip angezeigt.

Man kann einen Knoten auch per Doppelklick fixieren, ohne ihn an eine andere Position zu ziehen; er wird gleichermaßen hervorgehoben und mit einem einfachen Klick wieder freigesetzt.

Die '''Menü'''s enthalten verschiedene Funktions-Blöcke, die sich bei Klick auf die jeweiligen Block-Überschriften öffnen. Es können mehrere Bereiche gleichzeitig eingeblendet sein. Die Teilbereiche bieten Aktionen und Einstellungen, die es erlauben relevante Charakteristika des Verfahrens oder Aspekte der Umsetzung in weiten Bereichen zu beeinflussen - von Daten-Operationen über Stellgrößen der Simulation bis hin zur Sprache der Benutzeroberfläche. Die konkreten Optionen siehe die Detail-Beschreibungen [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/TAM und Lineage/Lineage|LIN]] und [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/TAM und Lineage/TAM|TAM]].

== IndexedDB ==

Das Konzept wird in [https://de.wikipedia.org/wiki/Indexed_Database_API diesem Artikel] erläutert, technische Aspekte siehe [https://developer.mozilla.org/de/docs/Web/API/IndexedDB_API/Using_IndexedDB hier].

Die Module bieten eine eigene eingebaute Schnittstelle an, aber man kann auch sozusagen "unter die Haube" blicken, indem man über die Kommando-Sequenz '''Strg-Shift-I''' den Browser anweist, die integrierte IDE zu öffnen und sich dort mit dem Reiter '''Application''' (Chrome) bzw. '''Web-Speicher''' (Firefox) die Browser-eigenen Datenspeicher anzeigen lässt. Am linken Rand findet man eine strukturierte Übersicht der verschiedenen Kategorien, Klick auf '''IndexedDB''' bzw. '''Indexed DB''' zeigt dann die aktuell hinterlegten Inhalte.

Bitte beachten:
: IndexedDB (IDB) ist Browser-abhängig und an eine Domain gebunden - man muss also in einer '''Webtrees'''-Seite (ob TAM-/LIN- oder Hauptansicht, spielt keine Rolle, da alle in der selben Domain beheimatet sind) sein, damit man tatsächlich die Daten angezeigt bekommt.

Man sieht sowohl für TAM als auch für LIN eigene IDB-Slots, die ihrerseits selbst untergliedert sind. Die konkreten Inhalte sind hier nicht so relevant, es sei jedoch darauf verwiesen, dass es sich um JSON-Strukturen handelt und die Inhalte in der Konsole nicht verändert, sondern nur angezeigt werden können.

Es handelt sich um vordergründig einfache Key-Value-Konstrukte - mit dem Key (Schlüssel) werden Inhalte eindeutig gekennzeichnet, der Value (Inhalt) transportiert dann die Daten an sich. Für IDB sind nur Zeichenketten zulässig, darin können dann aber beliebig komplex gestaltete JSON-Strukturen abgelegt sein, so dass (unterstützt durch entsprechende programmseitige Auf- und Vorbereitung) praktisch jede gewünschte Information abgelegt werden kann.

Im Umkehrschluss bedeutet das dann entsprechend, dass zur Interpretation der Daten unbedingt die umgebende Programmlogik vorhanden sein muss.

=== huhwt-Schnittstelle ===

TAM und LIN bieten für die Handhabung der IDB-Datenstrukturen eigene Funktionen. Das Wegschreiben geschieht transparent, man kann dabei fallweise einen Schlüssel vorgeben. Für das Einlesen zeigen die Funktionen den Inhalt der zugewiesenen IDB-Slots an, aus denen man einen Inhalt über den Schlüssel auswählen kann. In der Übersicht gibt es auch die Option, den entsprechenden Inhalt zu löschen. Bedingt durch die technischen Randbedingungen kann man nicht sofort alle IDB-Inhalte sehen, vielmehr muss man erst einen Store wählen, bevor die dort eingetragenen Schlüssel aufgelistet werden.

== Beispiele ==

=== Visualisierung genealogischer Strukturen ===
==== Alternativen ====
<gallery perrow="2" widths="500" heights="500">
Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Ahnenkreise_mit_Hintergrund.png|Visualisierung von Ahnenkreisen mit '''TAM''' (mit einem temporalen Feld als Hintergrund)
Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Familiennamengruppen.png|Visualisierung von Familiennamengruppen bei den Bewohnern eines Dorfes mit '''Lineage'''
</gallery>

==== Partnerketten (visualisiert mit TAM) ====
<gallery perrow="2" widths="500" heights="500">
Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Partnerketten_ohne_Hintergrund.png|Partnerketten (ohne Hintergrund)
Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Partnerketten_mit_Hintergrund.png|Partnerketten (mit einem temporalen Feld als Hintergrund)
</gallery>

{{-}}

== Anforderungen ==
Diese Module erfordern die webtrees-Version 2.1 oder höher. Es gibt von TAM auch noch eine ältere, nicht mehr gepflegte Version für die Version 2.0.

Diese Module wurden mit der webtrees-Version 2.1.5 und allen verfügbaren Themen und allen anderen Erweiterungsmodulen getestet.

== Installation ==
Bitte beachten Sie die folgenden Installationsanweisungen

* Laden Sie die neueste Version von TAM bei [https://github.com/huhwt/huhwt-wttam/releases/latest GitHub] herunter, Lineage finden Sie auch bei [https://github.com/huhwt/huhwt-wtlin/releases/latest GitHub]. Der einsatzfähige Code befindet sich dort als ZIP-Datei.
* Entpacken Sie das jeweilige [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodul]] in das Verzeichnis modules_v4/huhwt-wttam bzw. modules_v4/huhwt-wtlin des Webservers. Wenn dieses Verzeichnis bereits vorhanden ist, können Sie es einfach überschreiben.
* Melden Sie sich als Administrator bei webtrees an, gehen Sie zu Systemsteuerung/Module und suchen Sie die Module in der Liste "Alle Module". Sie heißen "ℍ&ℍwt TAMchart" bzw. "ℍ&ℍwt LINchart" und befinden sich eher am Ende der Liste, wenn sie diese alphabetisch nach Modulnamen sortieren. Überprüfen Sie , ob sie jeweils ein Häkchen für "Aktiviert" haben.
* Klicken Sie abschließend auf "Speichern", um die Konfiguration zu sichern.

== Upgrade ==
Ersetzen Sie zum Aktualisieren einfach die bestehenden Dateien durch diejenigen aus der neuesten Version.

== Übersetzung ==
Sie können helfen, dieses Modul zu übersetzen. Es verwendet das po/mo-System. Sie können über einen [https://github.com/huhwt/huhwt-cce/pulls Pull-Request in GitHub] (wenn Sie wissen wie das geht) oder per [mailto:git@huh-netz.de E-Mail an den Programmautor] weitere Übersetzungen beitragen.

Die JavaScript-Teile der Module haben jeweils eigene Übersetzungsfunktionen, die außerhalb des po/mo-Systems liegen. Die dort zu übersetzenden Texte werden durch Paare von Schlüsselwörtern und deren Übersetzung dargestellt. Die entsprechenden Inhalte können in "translations.js" gefunden werden.

Aktualisierte Übersetzungen werden in der jeweils nächsten Version dieser Module enthalten sein.

Folgende Sprachen sind für TAM und Lineage verfügbar

* Englisch
* Deutsch
* Niederländisch.
Die Übersetzungen für das Modul Lineage sind noch in Arbeit.

== Unterstützung ==
Sie können Fehler oder Wünsche für Erweiterungen auf den "issue"-Seiten bei GitHub melden
* [https://github.com/huhwt/huhwt-wttam/issues TAM]
* [https://github.com/huhwt/huhwt-wtlin/issues Lineage].

Sie können bei Fragen auch das [https://www.webtrees.net/index.php/en/forum webtrees-Forum] mit dem Themenbereich "Customising" nutzen.

== Lizenz ==
Das Modul TAM geht auf Arbeiten von R. Preiner und seinem Team an der Universität Graz zurück.

Das Modul Lineage wurde ursprünglich von Ben Garvey veröffentlicht.

* © 2022 huhwt - EW.H

Diese beiden Programme ist freie Software: Sie können es unter den Bedingungen der GNU General Public License, veröffentlicht von der Free Software Foundation, entweder in Version 3 der Lizenz oder (nach Ihrer Wahl) jeder späteren Version, weitergeben und/oder modifizieren.

Diese Programm werden in der Hoffnung verteilt, dass sie nützlich sein werden, aber OHNE JEGLICHE GEWÄHRLEISTUNG; ohne auch nur die stillschweigende Gewährleistung der MARKTFÄHIGKEIT oder EIGNUNG FÜR EINEN BESTIMMTEN ZWECK. Weitere Einzelheiten finden Sie in der GNU General Public License, die Sie unter http://www.gnu.org/licenses/ finden.

== Einzelnachweise ==
<references />

[[Kategorie:Webtrees]]

Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Sammelbehälter

2023-03-14T20:41:12Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Abschnitt 8.10.1|info=1}}{{WT-Inhaltsverzeichnis|Kapitel 8|E|Abschnitt 8.10|Abschnitt 8.10.1}}

Der Standard-[[Webtrees_Handbuch/Anleitung_für_Mitglieder#Sammelbeh.C3.A4lter|Sammelbehälter]] von webtrees kann durch ein Erweiterungsmodul ersetzt werden, das die Datensätze im Sammelbehälter nicht nur als GEDCOM herunterladen kann, sondern diese auch visualisieren lassen kann. Zusätzlich zu den Vorfahren und Nachkommen einer Person und anderen einzelnen Datensätzen können globale Datensatzsammlungen dem [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Sammelbeh.C3.A4lter|Sammelbehälter]] hinzugefügt werden, etwa alle [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule/Sammelbehälter#Partnerketten_(visualisiert_mit_TAM)|Partnerketten]] oder alle [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule/Sammelbehälter#Ahnenkreise_in_einem_Stammbaum_(visualisiert_mit_TAM)|Ahnenkreise]] in einen Stammbaum.

== Steckbrief ==
* Modulname: huhwt-cce (clippings cart enhanced)
* Autor: huhwt (EW.H); Hermann Hartenthaler hat das Konzept für dieses Erweiterungsmodul und die erste Beta-Version erstellt.
* Passende webtrees-Versionen: 2.1 (oder 2.0)
* Speicherort
** für webtrees 2.1: [https://github.com/huhwt/huhwt-cce GitHub]
** für webtrees 2.0: [https://github.com/huhwt/huhwt-cce20 GitHub] (nicht mehr gepflegt)
* Modulkategorie: Genealogie
* Modulfunktion: Menü "[[Webtrees_Handbuch/Anleitung_für_Mitglieder#Sammelbeh.C3.A4lter|Sammelbehälter]]"

== Beschreibung ==
[[Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Systemarchitektur.png|alternativtext=Systemarchitektur des erweiterten Sammelbehälters|mini|800x800px|Systemarchitektur des erweiterten Sammelbehälters|links]]
{{WT-ToDo|Grafik um GVExport ergänzen und Heiratsketten in Partnerketten umbenennen}}
Dieses benutzerdefinierte Modul ersetzt das ursprüngliche Modul „Sammelbehälter“ (engl. "clippings cart"). Das Systemkonzept des erweiterten Sammelbehälters ist in der nebenstehenden Grafik dargestellt.

Verschiedene Module können GEDCOM-Datensätze im Sammelbehälter ablegen und diese können dann an verschiedene Auswertungs-, Export- oder Visualisierungsmodule weitergegeben werden. Der Benutzer des Moduls kann entscheiden, welche Datensätze an den Sammelbehälter gesendet werden sollen und welche Aktionen mit diesen Datensätzen ausgeführt werden sollen. Der Sammelbehälter ist also während einer Browser-Sitzung eine Art Datendrehscheibe für einen Stammbaum.

Als Quellen kommen für den Sammelbehälter in Frage

* das Standardmodul „Sammelbehälter", das zu einer Person oder einem anderen Datensatz die Möglichkeit bietet, diesen und eventuell auch weitere Datensätze in den Sammelbehälter einzustellen (etwa eine Person und ihre Vorfahren oder Nachkommen, ggf. mit deren Familien); das Standardmodul kann aber auch deaktiviert werden, da alle seine Funktionen auch im Erweiterungsmodul enthalten sind.
* dieses Erweiterungsmodul, das, zusätzlich zu den genannten Funktionen des herkömmlichen Moduls, nun auch [[#Partnerketten_(visualisiert_mit_TAM)|Partnerketten]] oder [[#Ahnenkreise_in_einem_Stammbaum_(visualisiert_mit_TAM)|Ahnenkreise]] in einem Stammbaum sucht und die zugehörigen Datensätze in den Sammelbehälter schieben kann
* das Erweiterungsmodul Vesta-Sammelbehälter, das Ortsdatensätze (_LOC) oder auch alle Personen mit Bezug zu einem geteilten Ort in den Sammelbehälter legen kann

Derzeit noch nicht realisiert, aber denkbar wären auch

* die Suche in der Systemsteuerung nach [[Webtrees_Handbuch/Anleitung_für_Verwalter#Finde_unverbundene_Personen|unverbundenen Personen]] in einem Stammbaum (mit einem neuen Button „in den Sammelbehälter legen")
* die ganz normale [[Webtrees_Handbuch/Anleitung_für_Besucher#Suchen|webtrees-Suche]] (auch mit einem neuen Button "in den Sammelbehälter legen"), so dass man nach ganz beliebigen Dingen frei suchen könnte inklusive der Möglichkeit alle bereits derzeit angebotenen Filterfunktionen auf die Suchergebnisse zu nutzen
* die [[Webtrees_Handbuch/Anleitung_für_Besucher#Listen|Listenanzeige]]-Funktionen "Familien" und "Familienzweige", so dass man etwa alle Personen mit gleichem Familiennamen oder alle Personen aus einem Clan in den Sammelbehälter einstellen könnte
* bestehende Erweiterungsmodule, wie das Modul „[[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Großfamilie|Großfamilie]]“, das eine komplette Großfamilie mit allen zugehörigen Datensätzen in den Sammelbehälter packen könnte.

Die Datensätze können gruppiert nach ihrem Typ aufgelistet werden. Diese Gruppen kann man durch Klick auf die Gruppenüberschrift ein- und ausklappen. Der Benutzer kann ausgewählte Datensätze oder Gruppen von Datensätzen des gleichen Typs im Sammelbehälter löschen. Er kann den Sammelbehälter auch komplett löschen.

Der Benutzer des Moduls kann entscheiden, welche Aktion mit den Datensätzen im Sammelbehälter ausgeführt werden soll. So etwa
* der Export in eine GEDCOM-Datei, genau so wie im bisherigen Sammelbehälter-Modul
* die Weitergabe der Datensätze im Sammelbehälter an andere Erweiterungsmodule, die diese Daten visualisieren oder statistisch auswerten. Verfügbar sind hier die Erweiterungsmodule [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/TAM und Lineage/TAM|TAM (Topographic Attribute Map)]], [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/TAM und Lineage/Lineage|Lineage]] und [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/GVExport|GVExport]]. Diese Erweiterungsmodule müssen separat in webtrees installiert werden.

Derzeit noch nicht realisiert, aber denkbar, wäre auch

* die Anzeige der Datensätze im Sammelbehälter mit der Standard-[[Webtrees Handbuch/Anleitung für Besucher#Listen|Listenanzeige]] von webtrees mit der dort vorhandenen Möglichkeit, diese Liste zu sortieren und zu filtern.

== Bedienoberfläche ==
Im folgenden werden die verschiedenen Menüs dieses Moduls beschrieben.

[[Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Hauptmenü.png|mini|600x600px|Hauptmenü|links|verweis=Special:FilePath/WT_2.1_Erweiterungsmodul_Sammelbehälter_Hauptmenü.png]]
Im Kopfmenü der Seite sieht man, dass hier drei Sammelbehälter-Module nebeneinander aktiviert sind

* Standard-Modul
* ℍ&ℍwt Sammelbehälter (dieses Modul hier)
* Vesta-Sammelbehälter.
Das Hauptmenü des erweiterten Sammelbehälters zeigt, abhängig davon, ob der Sammelbehälter bereits Datensätze enthält, verschiedene Optionen an. In der Abbildung sieht man alle fünf möglichen Menüpunkte

* Datensätze im Sammelbehälter - hier wird immer die Anzahl der Datensätze angezeigt; wenn es Datensätze im Sammelbehälter gibt, kann man durch einen ''Klick'' die Liste der Datensätze anzeigen lassen (siehe unten)
* Zum Sammelbehälter hinzufügen - dieser Menüpunkt wird nur dann angezeigt, wenn man im Hauptteil der Seite gerade einen Datensatz sieht, der zum Sammelbehälter hinzugefügt werden kann; ein ''Klick'' führt zum Menü, das die Details des Hinzufügens festlegt. Je nachdem welche Art von Datensatz dem Sammelbehälter hinzugefügt werden soll gibt es verschiedene Optionen
** INDI: hier wird das sich öffnende Menü zum Hinzufügen eines Personendatensatzes in der übernächsten Abbildung genauer beschrieben
** FAM: dieses Menü ist ähnlich zum Menü bei INDI; man kann die Familie hinzufügen, die Familie mit ihren Kindern oder die Familie mit allen Nachkommen
** NOTE: die Notiz kann im Sammelbehälter abgelegt werden
** OBJE: das Medienobjekt kann dem Sammelbehälter hinzugefügt werden
** SOUR: es kann im sich öffnenden Menü entschieden werden, ob nur die Quelle selbst hinzugefügt wird oder ob auch alle Personen hinzugefügt werden, bei denen sich Ereignisse auf diese Quellen beziehen
** REPO: beim Hinzufügen eines Archivs werden immer auch alle Quellen, die sich auf dieses Archiv beziehen, hinzugefügt
** SUBM: der Übermittler-Datensatz wird hinzugefügt
** _LOC: der Datensatz mit dem gemeinsamen Ort kann in den Sammelbehälter gelegt werden; das Vesta-Sammelbehälter-Modul bietet hier zusätzlich noch zwei weitere Optionen an: zum einen den Ortsdatensatz und die Personen und Familien, die darauf verweisen, hinzuzufügen und zum anderen den Ortsdatensatz und die Einzelpersonen und Familien, die sich darauf beziehen, einschließlich der Eltern, Geschwister, Ehegatten und Kinder der einzelnen Personen hinzuzufügen.
* Globale Datensammlungen zum Sammelbehälter hinzufügen - hier kann man Datensammlungen aus dem Stammbaum hinzufügen; zwei Kriterien sind definiert: alle [[#Partnerketten_(visualisiert_mit_TAM)|Partnerketten]] und alle [[#Ahnenkreise_in_einem_Stammbaum_(visualisiert_mit_TAM)|Ahnenkreise]] im Stammbaum (siehe unten)
* Datensätze im Sammelbehälter löschen - man kann den gesamtem Sammelbehälter leeren, man kann einzelne Datensätze in der Listenansicht löschen oder man kann alle Datensätze eines Typs (INDI, FAM, NOTE, ...) löschen (siehe unten)
* Weiterführende Aktionen mit den Datensätzen im Sammelbehälter - zwei Typen von Aktionen sind verfügbar; zum einen das Herunterladen der Datensätze im Sammelkorb als GEDCOM-Datei (genau so wie beim Standard-Sammelbehälter-Modul) und zum anderen das Visualisieren der Datensätze mit den Erweiterungsmodulen TAM oder Lineage (siehe unten); zur Visualisierung des Inhalts des Sammelbehälters mit GVExport muss dieses Modul im Hauptmenü "Diagramme" ausgewählt werden.
{{-}}

[[Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Liste.png|mini|600x600px|Listenansicht der Datensätze im Sammelbehälter (gruppiert nach Typen)|links|verweis=Special:FilePath/WT_2.1_Erweiterungsmodul_Sammelbehälter_Liste.png]]
Die Listenansicht zeigt jeweils einen Datensatz pro Zeile. Die Datensätze sind nach Typen gruppiert und die Gruppen können durch einen Klick auf die Überschriftenzeile ein- und ausgeklappt werden. Jeder Datensatz wird zusätzlich durch ein Typ-Symbol gekennzeichnet Jeder einzelne Datensatz kann individuell gelöscht werden.
{{-}}

[[Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Personen_Familien.png|mini|600x600px|Hinzufügen von Vorfahren und Nachkommen einer Person|links|verweis=Special:FilePath/WT_2.1_Erweiterungsmodul_Sammelbehälter_Personen_Familien.png]]
Wenn man auf einer Personenseite in der Bedienoberfläche von webtrees das Menü des erweiterten Sammelbehälters aufruft, kann man die Option "Datensatz hinzufügen" auswählen. Danach öffnet sich das nebenstehend abgebildete Menü, das verschiedene Optionen zur Übernahme in den Sammelbehälter anbietet

* die Person selbst
* die Person mit Eltern und Geschwistern
* die Person mit Partnerinnen und Kindern
* die Person und ihre Vorfahren - hier wird auch angegeben wie viele Vorfahrengenerationen im Stammbaum existieren
* die Person und ihre Vorfahren bis zu 4 Generationen für ein H-Diagramm
* die Person und ihre Vorfahren zusammen mit derer Familien
* die Person mit ihren Partnern und deren Nachkommen
* die Partner-Ketten zu denen die Person gehört - dieser Punkt erscheint nur dann, wenn die Person Partner hatte; er erlaubt alle Partner der Person sowie deren Partner (und so weiter) in den Sammelbehälter zu legen

Man kann getrennt festlegen wie viele Generationen in Richtung der Vorfahren und wie viele in Richtung der Nachkommen berücksichtigt werden sollen. Die Generation 1 sind die Eltern bzw. die Kinder.
{{-}}

[[Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_globale_Daten.png|mini|600x600px|Hinzufügen von globalen Datensatzmengen|links|verweis=Special:FilePath/WT_2.1_Erweiterungsmodul_Sammelbehälter_globale_Daten.png]]
Wenn man die Option "Globale Datensammlungen zum Sammelbehälter hinzufügen" ausgewählt hat, öffnet sich das nebenstehende Menü das zwei Optionen anbietet: zum einen können alle [[#Partnerketten_(visualisiert_mit_TAM)|Partnerketten]] oder zum anderen können alle [[#Ahnenkreise_in_einem_Stammbaum_(visualisiert_mit_TAM)|Ahnenkreise]] in den Sammelbehälter gelegt werden (die dritte abgebildete Option ist derzeit nicht implementiert).
{{-}}

[[Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Löschen.png|mini|600x600px|Löschen von Datensätzen im Sammelbehälter|links|verweis=Special:FilePath/WT_2.1_Erweiterungsmodul_Sammelbehälter_Löschen.png]]
Wenn man die Option "Datensätze im Sammelbehälter löschen" auswählt, öffnet sich ein Menü das drei Optionen anbietet

* alle Datensätze löschen
* Datensätze eines Typs löschen - hier werden die Typen von Datensätzen im Sammelbehälter angezeigt und die Anzahl der Datensätze des jeweiligen Typs; man kann eine oder mehrere Typen komplett löschen
* Datensätze zum Löschen auswählen - hier öffnet sich das Listenmenü in dem man dann einzelne Datensätze selektiv löschen kann.
{{-}}

[[Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Aktion.png|mini|600x600px|Weiterführende Aktionen im erweiterten Sammelbehälter|links|verweis=Special:FilePath/WT_2.1_Erweiterungsmodul_Sammelbehälter_Aktion.png]]
Nach der Auswahl der Option "Weiterführende Aktionen mit den Datensätzen im Sammelbehälter" kann man unter zwei Typen von Aktionen wählen

* Datensätze herunterladen - hier hat man die gleichen Möglichkeiten wie im Standard-Sammelbehälter-Modul; die GEDCOM-Datei oder die GEDCOM-Datei mit den Mediendateien in einem ZIP-Archiv wird auf den Rechner des Nutzers heruntergeladen
* Datensätze graphisch in einem Diagramm auswerten - hier kann man zwischen zwei Visualisierungsmethoden auswählen: TAM und Lineage (siehe Beispiele in den folgenden Abschnitten). Wenn die Datensätze mit GVExport visualisiert werden sollen, muss der entsprechende Punkt im Hauptmenü unter "Diagramme" ausgewählt werden (sofern dieses Erweiterungsmodul installiert ist).

Dabei kann man die verwendeten Datensätze noch an Hand der Datenschutzeinstellungen selektieren. Entsprechend der hier ausgewählten Rolle werden die Datensätze ggf. reduziert. Dabei können aber nur Rollen gewählt werden, die eine geringere Berechtigung aufweisen als die Rolle des gerade angemeldeten Nutzers.
{{-}}

[[Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Aktion_Abschluss.png|mini|600x600px|Abschluss einer Visualisierungsaktion|links|verweis=Special:FilePath/WT_2.1_Erweiterungsmodul_Sammelbehälter_Aktion.png]]
Nach der Auswahl der Option Visualisierung mit "TAM" oder mit "Lineage" werden die INDI- und FAM- Datensätze an das ausgewählte Erweiterungsmodul übertragen. Nach einem ''Klick'' auf die Schaltfläche "... in neuem Tab starten" öffnet sich ein weiteres Browserfenster mit der gewählten Visualisierungsanwendung.
{{-}}

== Datenstrukturen und ihre Visualisierung ==

Die Möglichkeit zur Visualisierung der Datensätze im Sammelbehälter erlaubt ganz neue Einsichten in die Struktur der Daten in einem Stammbaum. Vergleichbare Visualisierungsmöglichkeiten gab es bislang bei webtrees nicht. Man kann zwar mit dem Diagramm "Beziehungen" Verbindungen zwischen zwei Personen darstellen und sogar mehrere alternative Beziehungspfade anzeigen, aber für größere Beziehungsnetze ist diese Darstellung nicht ausreichend. Passend zu den Visualisierungsmöglichkeiten bringt dieses Modul auch die Ermittlung von zwei neuen Datensammlungen mit

* [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Sammelbehälter#Ahnenkreise in einem Stammbaum (visualisiert mit TAM)|Ahnenkreise]]
* [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Sammelbehälter#Partnerketten (visualisiert mit TAM)|Partnerketten]].

Diese Datenstrukturen von miteinander verbundenen Personen werden in den beiden folgenden Abschnitten näher beschrieben.

=== Ahnenkreise in einem Stammbaum (visualisiert mit TAM) ===
<gallery perrow="2" widths="500" heights="500">
Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Ahnenkreise_ohne_Hintergrund.png|Ahnenkreise (ohne Hintergrund)
Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Ahnenkreise_mit_Hintergrund.png|Ahnenkreise (mit einem temporalen Feld als Hintergrund)
</gallery>
{{WT-ToDo|In diesem Abschnitt muss der Text komplett überarbeitet (entpersönlicht) werden.}}
Dieses Diagramm wurde mit dem "globalen Hinzufügen-Menü" erstellt, indem "Alle Kreise hinzufügen" ausgewählt wurde. Diese Funktion entfernt rekursiv alle Blätter in einem Baum. Eine Familie mit zwei Elternteilen und ihrem Kind ist ein trivialer Kreis (Kind -> Mutter -> Ehemann -> Kind) und wird daher nicht erfasst. Kreise ergeben sich zum Beispiel, wenn Cousins zusammen verheiratet sind. Solche Kreise sind verantwortlich für den Stammbaumkollaps (auf Deutsch: Ahnenschwund oder Implex). Nach den Verbindungen der Ehe oder Partnerschaft finden sich Kreise, wenn zwei Familien durch mehr als eine Ehe miteinander verbunden sind. Vielleicht können solche Kreise eine Länge von 30, 40 oder 50 Schritten haben. Sie können mehrere Familien miteinander verbinden und es ist nicht einfach, sie zu finden. Solche weit entfernten Verbindungen in einem Baum verbinden verschiedene Teile einer Familie. Ich nenne sie deshalb manchmal "Ahnenautobahn". Die erste Autobahn, die ich vor vielen Jahren in meinen Baum gebaut habe, war die Verbindung zu Johann Wolfgang von Goethe in mehr als 50 Stufen. Zum Beispiel sind meine Eltern durch mehrere solcher Zirkel miteinander verbunden (neben der trivialen Verbindung durch ihre eigene Ehe). In Webtrees können Sie nach solchen Verbindungen suchen, indem Sie Diagramme / Beziehungen / Alle möglichen Beziehungen finden verwenden. Aber bisher gab es keine Möglichkeit, alle diese Kreise in einem Baum darzustellen.

=== Partnerketten (visualisiert mit TAM) ===
<gallery perrow="2" widths="500" heights="500">
Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Partnerketten_ohne_Hintergrund.png|Partnerketten (ohne Hintergrund)
Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Partnerketten_mit_Hintergrund.png|Partnerketten (mit einem temporalen Feld als Hintergrund)
</gallery>
Eine Partnerkette (oder Heiratskette) ist eine Kette von Partnern von Partnern von Partnern von ... Wenn ein Ehepartner vorher oder später mit einem anderen Partner verheiratet war, ist dies eine Kette von drei Partnern. Triviale Ketten, die nur aus zwei Partnern (Ehemann/Ehefrau) bestehen, werden hier nicht betrachtet. Falls einer der Partner dreimal oder öfter verheiratet war, wird aus der Kette ein Baum aus Ketten.

Bisher gab es in webtrees keine Möglichkeit, solche Partnerkettenbäume zu visualisieren. Durch die Visualisierungsmodule TAM und Lineage kann man nun solche Ketten darstellen. Während sich Genealogie sonst meist in der Zeitachse bewegt (von einer Person zu ihren Vorfahren), bieten Heiratsketten eine Orientierung in senkrechter Richtung dazu: von einer Familie zur nächsten und zur übernächsten.

In der nebenstehenden Abbildung wurde ein recht komplexer Partnerkettenbaum mit TAM visualisiert. Etwas oberhalb des Zentrums erkennt man John F. Kennedy, der eine Familie mit seiner Frau Jacqueline bildet, die wiederum eine Familie mit Aristoteles Onassis bildet, der wiederum ... In der zweiten Abbildung wurde im Hintergrund ein temporales Feld eingeblendet. Die Zeit wird hier ähnlich wie Höhenlinien auf einer Geländekarte dargestellt. Besonders dunkelblaue Bereiche liegen weiter in der Vergangenheit, die hellen Bergrücken ehr in der Gegenwart. So kann man auf einen Blick die älteren Personen in den Partnerketten identifizieren.

=== Kompaktes H-Diagramm (visualisiert mit TAM) ===
[[Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_H-Diagramm.png|mini|600x600px|H-Diagramm|links|verweis=Special:FilePath/WT_2.1_Erweiterungsmodul_Sammelbehälter_H-Diagramm.png]]

Ein kompaktes H-Diagramm gibt es bereits in webtrees. Wenn man ...
{{-}}

=== Familiennamengruppen bei den Bewohnern eines Dorfes (visualisiert mit Lineage) ===
[[Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Familiennamengruppen.png|mini|600x600px|Familiennamengruppen bei den Bewohnern eines Dorfes|links|verweis=Special:FilePath/WT_2.1_Erweiterungsmodul_Sammelbehälter_Familiennamengruppen.png]]

Mit dem Vesta-Sammelbehältermodul kann man alle Personen zum Sammelbehälter hinzufügen, die einen Bezug zu einem gemeinsamen Ort haben, das sind etwa alle Bewohner des Ortes. Dazu ruft man den gemeinsamen Ort auf, öffnet das Vesta-Sammelbehälter-Menü und wählt "Ortsdatensatz" hinzufügen. Danach kann man auswählen, dass man alle Personen mit Bezug zu diesem Ort dem Sammelbehälter hinzufügen möchte. Wenn man dann bei den globalen Aktionen des hier beschriebenen Erweiterungsmoduls die Visualisierung durch "Lineage" auswählt, werden die Personen des Ortes in einem zweiten Browser-Fenster angezeigt. Die Darstellung der zeitlichen Entwicklung der Gruppen von Personen mit einem gleichen oder ähnlichen Familiennamen ist besonders spannend. Man sieht etwa sehr schön, dass irgend ein Namensträger zu einem Zeitpunkt in das Dorf gezogen ist, Nachkommen bekommen hat und sich so der Familienname über die Zeit im Dorf in wachsender Anzahl verbreitet.
{{-}}

== Anforderungen ==
Dieses Modul erfordert die webtrees-Version 2.1 oder höher. Es gibt auch noch eine ältere, nicht mehr gepflegte Version für die Version 2.0. Dieses Erweiterungsmodul kann das bestehende Sammelbehälter-Modul ersetzen oder parallel zu diesem betrieben werden. Um die zusätzlichen Funktionen des Vesta-Sammelbehälter-Moduls zu nutzen, muss dieses parallel installiert und aktiviert sein.

Dieses Modul wurde mit der webtrees-Version 2.1.4 und allen verfügbaren Themen und allen anderen Erweiterungsmodulen getestet. Icons werden nur für einige der Themen bereit gestellt.

== Installation ==
Bitte beachten Sie die folgenden Installationsanweisungen

* Laden Sie die neueste Version von [https://github.com/huhwt/huhwt-cce GitHub] herunter.
* Entpacken Sie das Erweiterungsmodul in das Verzeichnis webtrees/modules_v4/huhwt-cce des Webservers. Wenn dieses Verzeichnis bereits vorhanden ist, können Sie es einfach überschreiben.
* Melden Sie sich als Administrator bei webtrees an, gehen Sie zu Systemsteuerung/Module/Genealogie/Menüs und suchen Sie das Modul. Es heißt "ℍ&ℍwt Sammelbehälter". Überprüfen Sie, ob es ein Häkchen für "Aktiviert" hat. Bearbeiten Sie diesen Eintrag, um die Zugriffsrechte für jeden Stammbaum festzulegen und den Menüpunkt nach ihren Wünschen zu positionieren. Auf Grund der umfangreichen Möglichkeiten mit diesem Modul auf die Daten in ihrem Stammbaum zuzugreifen, sollten Sie es eher nicht für Besucher sichtbar machen.
* Sie können den Menüpunkt des Standardmoduls "Sammelbehälter" deaktivieren. Klicken Sie abschließend auf "Speichern", um die Konfiguration zu sichern.

== Upgrade ==
Ersetzen Sie zum Aktualisieren einfach die bestehenden Dateien durch diejenigen aus der neuesten Version.

== Übersetzung ==
Sie können helfen, dieses Modul zu übersetzen. Es verwendet das po/mo-System. Sie können über einen [https://github.com/huhwt/huhwt-cce/pulls Pull-Request in GitHub] (wenn Sie wissen wie das geht) oder per [mailto:git@huh-netz.de E-Mail an den Programmautor] weitere Übersetzungen beitragen. Aktualisierte Übersetzungen werden in der jeweils nächsten Version dieses Moduls enthalten sein.

Folgende Sprachen sind verfügbar

* Englisch
* Deutsch
* Niederländisch
* Russisch.

== Unterstützung ==
Sie können Fehler oder Wünsche für Erweiterungen auf der [https://github.com/huhwt/huhwt-cce/issues "issue"-Seite bei GitHub] melden,

Sie können bei Fragen auch das [https://www.webtrees.net/index.php/en/forum webtrees-Forum] mit dem Themenbereich "Customising" nutzen.

== Lizenz ==
Dieses Modul ist ursprünglich vom Vesta-Erweiterungsmodul "Sammelbehälter" abgeleitet worden.

* © 2022 huhwt - EW.H
* © 2021 Hermann Hartenthaler
* © 2021 Richard Cissée
* abgeleitet von webtrees - © 2021 webtrees-Entwicklungsteam

Dieses Programm ist freie Software: Sie können es unter den Bedingungen der GNU General Public License, veröffentlicht von der Free Software Foundation, entweder in Version 3 der Lizenz oder (nach Ihrer Wahl) jeder späteren Version, weitergeben und/oder modifizieren.

Dieses Programm wird in der Hoffnung verteilt, dass es nützlich sein wird, aber OHNE JEGLICHE GEWÄHRLEISTUNG; ohne auch nur die stillschweigende Gewährleistung der MARKTFÄHIGKEIT oder EIGNUNG FÜR EINEN BESTIMMTEN ZWECK. Weitere Einzelheiten finden Sie in der GNU General Public License, die Sie unter http://www.gnu.org/licenses/ finden.

[[Kategorie:Webtrees]]

Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Kundenindividuelle Beziehungsbezeichnungen

2023-03-14T20:41:02Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Abschnitt 8.10.1|info=1}}{{WT-Inhaltsverzeichnis|Kapitel 8|E|Abschnitt 8.10|Abschnitt 8.10.1}}

Das Modul ...

== Steckbrief ==
* Modulname: Kundenindividuelle Beziehungsbezeichnungen (hh_relation_is_descriptor)
* Autor: Hermann Hartenthaler
* Passende webtrees-Versionen: 2.1
* Speicherort: [https://github.com/hartenthaler/hh_relation_is_descriptor GitHub]
* Modulkategorie: Personenseite
* Modulfunktion: Reiter "Großfamilie"

== Beschreibung ==

{{WT-ToDo|Alles Folgende ist aus dem alten webtrees-Wiki und muss noch bearbeitet werden.}}

=== Benutzerdefinierte Beziehungen ===
Der Beziehungs-Deskriptor '''RELA''', der im Beziehungs-Merkmal ('''ASSO''', Beziehung zu einer Person) verwendet wird, soll basierend auf dem GEDCOM 5.5.1 Datei-Format Freitext sein. webtrees unterstützt jedoch nur eine Auswahlliste von Beziehungen, die im Source-Code fest hinterlegt ist. Daher muss man tatsächlich den zugrunde liegenden PHP Code ändern, um eine Beziehung, die nicht in der Liste vordefiniert ist, hinzuzufügen. Glücklicherweise ist dies recht einfach, auch wenn Sie keinen Programmierer sind, solange Sie Zugriff auf Ihre Installation und die zugehörigen Quelldateien haben. Möglicherweise müssen Sie auch die '''Sprach'''-Dateien bearbeiten, um die neu hinzugefügten '''Beziehungen''' in anderen Sprachen zu unterstützen.

Siehe Allgemeine_Leitlinien für einige Hinweise zum Anpassen von webtrees bei der Änderung des Quellcodes. Insbesondere können Ihre Änderungen von zukünftigen Updates überschrieben oder nicht in der gleichen Weise in zukünftigen Versionen unterstützt werden, je nachdem wie sich der Code entwickelt. In der Tat hat webtrees nach der Abspaltung von der Original '''PHPGedView''' Code-Basis die Unterstützung für Kontext-sensitive Geschlechts-Bezeichnungen bei '''Beziehungen''' hinzugefügt. Das hat vorangegangene Änderungen überflüssig gemacht und erforderte, wieder welche einzuprogrammieren. Siehe auch Benutzerdefinierte_Merkmale für mehr Warnungen und eine allgemeine Übersicht. Die Methode, wie Sie ein benutzerdefiniertes Merkmal hinzufügen, ist sehr ähnlich dazu, wie Sie eine Beziehung hinzufügen. Aber im Gegensatz zu benutzerdefinierten Merkmalen werden zusätzliche Beziehungen gefördert und vom Standard erlaubt. Es ist nur diese Programm-Implementierung, die sie einschränkt.

Wenn Sie denken, dass Ihre Anpassungen zum Systemkern gehören, sollten Sie das im Forum besprechen.

==== Änderung der Auswahlliste ====
Dies vorausgeschickt, werden die erforderlichen Änderungen, um die Liste der '''Beziehungs'''-Titel in der Auswahlliste anzupassen, in einer separaten Datei gemacht im Baum der Installationsquellen: '''library/WT/Gedcom/Code/Rela.php'''. Obwohl es eine PHP Quellcode-Datei ist, hat sie eine klare Struktur, die auch nicht-Programmierer einfach und fehlerfrei ändern können sollten. Es gibt zwei Hauptteile des hier betroffenen Codes. Die '''$TYPE''' Matrix-Definition der internen Code-Namen und die Funktion '''getValue()''', die den gespeicherten Code-Namen für die Anzeige oder Ausgabe in Text konvertiert. Beide Bereiche müssen bearbeitet werden, um eine neue '''Beziehung''' zu aktivieren.

===== Rela.php $TYPES Matrix bearbeiten =====
private static $TYPES=array(
....
);
Die Matrix wird definiert als eine Liste von Namen in einfachen Anführungszeichen, die durch Kommas getrennt sind. Da es Codenamen sind, gibt es keine Leerzeichen zwischen den einzelnen Anführungszeichen. Verwenden Sie einen Unterstrich anstelle eines Leerzeichens. Der Konvention folgend sind die Code-Namen an englische Basis-Standard-Namen angelehnt. Während die Einträge nicht in einer bestimmten Reihenfolge vorliegen und die Reihenfolge in der Matrix und der Funktion nicht übereinstimmen müssen, legt ein guter Programmierstil nahe, sie in aufsteigender alphabetischer Reihenfolge zu halten und sie so bei der Durchsicht der Datei leichter zu finden. Es sind lediglich interne Namen, die vom PHP-Quellcode verwendet werden, um die anzuzeigende Sprachversion zu finden. Code-Namen in dieser Matrix unterscheiden Groß- und Kleinschreibung (behalten Sie die gleiche Schreibweise bei allen Vorkommen bei).

Es gibt keine wirkliche Grenze für die Anzahl der durch Kommas getrennten Code-Namen in einer Zeile. Der Konvention folgend sollten Sie Ihre Ergänzungen der Liste in richtiger Reihenfolge jeweils in eine eigene Zeile mit einem nachfolgenden Kommentar eintragen, der angibt, dass Sie den Code eingefügt haben. Also, wenn wir den Code 'sponsor' einfügen würden in der vorhandenen Zeile < 'slave', 'ward', 'witness' > dann würde das vor und nach der Änderung so aussehen:
BEFORE:
'slave', 'ward', 'witness',
AFTER:
'slave',
'sponsor', // Added by REH on 10/30/2011
'ward', 'witness',
Der doppelte Schrägstrich (//) kennzeichnet einen nicht zu interpretierenden Textkommentar (wie eine GEDCOM Bemerkung) bis zum Ende der Zeile.

===== Rela.php getValue() Funktion bearbeiten =====
webtrees ist in U.S. Englisch geschrieben und verwendet U.S. Englisch intern. Also wird Text, der für Benutzer sichtbar sein soll, standardmäßig auf Basis der englischen Version kodiert. webtrees unterstützt viele Sprachen, einige mit kontext-abhängigen Geschlechter-Abhängigkeiten. Also den Text für das '''ASSO'''ciate (Partner) Merkmal '''RELA'''tionships (Beziehungen) zu definieren, ist ein wenig komplizierter, als wahrscheinlich zuerst vermutet. Daher sehen Sie einige der Geschlechter switch-case-Anweisungen in der Code-Basis mit einigen Beziehungs-Namen.

Die '''getValue()'''-Funktion ist einfach eine große switch-case-Anweisung. Betrachten Sie es als eine "Auswahl". Bei Eingabe eines Matrix-Eintrags oder Code-Werts erzeugt sie einen Aufruf einer Text-Übersetzungs-Funktion für diesen Wert. Wenn Sie einen Eintrag in die Matrix oben hinzufügen, müssen Sie also einen '''case'''-Einstiegspunkt in die '''switch'''-Anweisung hinzufügen.

Es gibt hier zwei Arten von Einträgen. Mögliche geschlechts-abhängige Namen und unisex oder geschlechts-unabhängige Namen. Obwohl im Englischen nicht üblich, sind geschlechts-abhängige Namen in vielen anderen Sprachen geläufig. Aber es gibt sie auch im Englischen. Ein Elternteil ist unisex, während ein Vater oder Mutter traditionell eine geschlechts-abhängige Variante ist. Ebenso ist ein Patenkind unisex, während ein Patensohn oder Patentochter geschlechts-abhängig ist. Was hier wichtig ist, ist nicht, was Tradition oder eine mögliche Ausnahme ist, die Sie unterstützen möchten, sondern was ist das übliche Konstrukt zur Verwendung in anderen Sprachen. Wenn eine Sprache traditionell Varianten auf der Grundlage von Geschlechtern verwendet, unterstützen Sie das hier im Code.

Unter Fortsetzung unseres obigen Beispiels würde der Eintrag für einen '''sponsor''' in der '''getValue()''' switch-Anweisung wie folgt aussehen:
case 'slave':
switch ($sex) {
case 'M': return WT_I18N::translate_c('MALE', 'Slave');
case 'F': return WT_I18N::translate_c('FEMALE', 'Slave');
default: return WT_I18N::translate ( 'Slave');
}
'''case 'sponsor': // Added REH 10/30/2011'''
'''// no sex implied'''
'''return WT_I18N::translate('Sponsor');'''
case 'ward':
switch ($sex) {
Der Aufruf der Funktion '''WT_I18N::translate()''' führt zur Sprach-Übersetzung und sucht das passende Wort in der Sprachdatei. Eine Variante des Aufrufs führt das Geschlecht als ersten Parameter.

Beachten Sie, dass der Parameter innerhalb der Klammern die englische Form der Beziehung darstellt und nicht den Codewert, der in der vorangehenden case-Anweisung verwendet wird. Deshalb werden innerhalb der einfachen Anführungszeichen auch Leerzeichen und Groß- und Kleinschreibung akzeptiert. Die Code-Namen in der Matrix werden ausschließlich innerhalb der PHP-Code switch-Anweisung verwendet, um die Matrix zu indizieren. Der Name, der an die '''WT_I18N::translate()'''-Funktion übergeben wird, ist die englische Grundform, die benutzt wird, um die Sprachdateien und die übersetzte Version zu finden. Es ist nur diese letztere Form, die Sie in der Benutzeroberfläche von webtrees oder in der GEDCOM-Datei-Ausgabe sehen werden.

==== Lokale Sprachdateien anpassen ====
Vergleichen Sie die Seite Benutzerdefinierte Übersetzungen, wie lokale Sprachdateien angepasst werden. Wichtig ist, dass Sie die neuen '''Beziehungen''' auch in die Übersetzungs-Dateien und zum Quellcode hinzufügen. Neben der Basis-Sprachdatei können Sie sie auch zu anderen Sprachen hinzufügen. Wenn keine Sprachdateien geändert werden, wird standardmäßig einfach das Englisch, das im Quellcode einprogrammiert ist, für alle Ausgaben und Anzeigen verwendet. Die Änderung der Sprachdatei ist also nicht erforderlich, um Ihre Veränderung zu aktivieren, aber ein notwendiger Schritt, um andere Sprachen in der Benutzeroberfläche zu unterstützen.

==== Überprüfen Sie Ihre Änderungen ====
Um zu sehen, ob Ihre Veränderungen erfolgreich waren, sowohl in Bezug auf die neue Beziehung als auch auf die Unversehrtheit des Programms und der Code-Basis, sollten Sie immer die geänderte Funktionalität überprüfen.

Gehen Sie einfach zu einer Person und fügen ein '''ASSO'''ciate Merkmal (Partner) hinzu oder bearbeiten ein '''EVEN'''t (Ereignis) wie eine Geburt, Tod oder ähnliches und fügen ein '''ASSO'''ciate Merkmal hinzu. Es gibt zwei Parameter für die Eingabe, die aktuelle ID einer anderen Person und die '''Beziehung''' zu ihr. Für jede Sprache, die Sie geändert haben, klicken Sie auf das Auswahlfeld der '''Beziehung''', um zu sehen, ob Ihre zusätzlichen Beziehungen vorhanden sind (und die vorangegangenen ebenfalls). Sie müssen dazu geschlechtlich unterschiedliche Personen prüfen, um alle Versionen komplett zu sehen. Was hier erscheint, ist der Inhalt aus einer Sprachdatei oder, falls nicht übersetzt, der ursprüngliche englische Text, der im PHP-Code-Aufruf an die Translate-Funktion übergegeben wird.

==== Verwendung des ASSOciate-Merkmals ====
Der GEDCOM 5.5.1 Standard definiert '''ASSO'''ciate als Merkmal der Stufe 1, das nur in einem Personen Datensatz (oberste Ebene) verfügbar ist. Es soll eine Person mit einer anderen Person direkt verbinden. Tatsächlich kennt das '''ASSO'''ciate Merkmal die '''Xref_ID''' einer Person ('''INDI''') als Parameter. Dies ist ein gangbarer Weg, um Menschen anders als mit dem '''FAMI'''lien-Datensatz zu verknüpfen.

Viele Programme, webtrees eingeschlossen, erlauben das '''ASSO'''ciate Merkmal auch innerhalb von Ereignis-Merkmalen ('''EVEN''') in Personen- ('''INDI''') und '''FAMI'''lien-Datensätzen. Einige sogar innerhalb von Quellen ('''SOUR''') und anderen Top-Level-Datensätzen. Wo immer von webtrees erlaubt, wird das '''ASSO'''ciate Merkmal in der entsprechenden GEDCOM-Datei an dieser Stelle gezeigt. Also achten Sie darauf, dass diese Verbindungen außer als Top-Level-Merkmal in einem Personen-Datensatz möglicherweise nicht in andere Programme übernommen werden können, obwohl die Verbindungen in diesem Programm an diesen zusätzlichen Stellen unterstützt werden.

Die Verbindungs-Beschreibung ('''RELA''') innerhalb des '''ASSO'''ciate-Merkmals ist als ein Freitextfeld definiert und nicht als computerlesbarer Name. Obwohl fester Bestandteil im webtrees Code, haben die vordefinierten Namen keine besondere Bedeutung im Programm. Es ist ein reiner Deskriptor, um die Verbindung zu einer anderen Person zu beschreiben. Da es ein Deskriptor ist, wurde die Liste vordefiniert, so dass er für die Schnittstelle in andere Sprachen richtig übersetzt werden kann.

Die häufigste Verwendung des '''ASSO'''ciate Merkmals liegt in traditionellen religiösen Ereignissen wie Taufe, Konfirmation/BarMitzvah/Najote und Hochzeit. Das Merkmal erlaubt es, Paten, Sponsoren und Hochzeitsgäste anzugeben. Vor allem für die Ehe ist die Liste, so wie heute im Programm definiert, für die meisten Traditionen in gängigen Religionen nicht vollständig. Daher muss ergänzt werden, was in einer Beziehung erlaubt ist.

Beachten Sie, dass '''ASSO'''ciates Verbindungen in einer Richtung sind. Das bedeutet, wenn Sie einen Patenonkel im Tauf-Datensatz eines Kindes (Einzelperson) angeben, gibt es keine Möglichkeit, dies zu erfahren, wenn man etwas anderes als den Kind-Datensatz betrachtet. Sie müssen ein '''ASSO'''ciate Merkmal im Patenonkel-Datensatz (Einzelpersonen) anlegen, um festzulegen, wer das Patenkind ist, damit die Verbindung bidirektional und bei beiden Personen sichtbar wird.

Beachten Sie auch, obwohl dies ein alternativer Weg ist, Personen außerhalb der Familie zu verknüpfen, dass die meisten Programme, die GEDCOM's verarbeiten, diesen Link nur für Anzeigezwecke erkennen. Daher kann z.B. das '''Beziehungs'''-Diagramm in webtrees diese Verbindungen nicht verfolgen. Auch das '''Sammelbehälter'''-Werkzeug kann keine verknüpfte Teilmenge Ihrer Datenbank extrahieren.

==== Vorhandene und vorgeschlagene Beziehungs-Werte ====
In webtrees ist die folgende Liste von Beziehungen ('''RELA''') für das '''ASSO'''ciate Merkmal definiert:
'attendant', 'attending', 'best_man', 'bridesmaid', 'buyer',
'circumciser', 'civil_registrar', 'employee', 'employer', 'foster_child',
'foster_father', 'foster_mother', 'friend', 'godfather', 'godmother',
'godparent', 'godson', 'goddaughter', 'godchild', 'guardian',
'informant', 'lodger', 'nanny', 'nurse', 'owner',
'priest', 'rabbi', 'registry_officer', 'seller', 'servant',
'slave', 'ward', 'witness',
In der '''PHPGedView''' Code-Basis ist auch noch definiert:
'twin', 'twin_brother', and 'twin_sister'
webtrees erkennt sie jedoch automatisch. Nützliche Beziehungen, die man erwägen könnte, sind beispielsweise:
'flower_girl', 'groomsman', 'maid_of_honor', 'matron_of_honor', 'officiant', 'ring_bearer', 'sponsor', and 'usher'
Manchmal ist die Beziehung einem Ereignis nicht wirklich zugeordnet, sollte jedoch bei einer Person oder Familie auf oberster Ebene stehen. Dies gilt insbesondere für enge Freunde, die teilweise wichtiger als Blutsverwandte gewesen sein können. In diesem Fall kann man überlegen, Beziehungen hinzufügen wie:
'friend', 'close_friend', 'best_friend', 'family_friend', 'fiance', and the like.
Es muss hier noch nicht enden; genau wie bei modernen sozialen Netzwerken. Sie können alle Arten von Klassifikationen oder Kreisen von Menschen zulassen. Vielleicht benötigen Sie:
'colleague', 'classmate', 'war_buddy' and so on.
Entscheidend ist, dass die Liste vordefiniert ist und Sie so die Flexibilität für die Forscher erhöhen, zur Erfassung von Informationen, die sie über Menschen in dieser besser verarbeitbaren Form sammeln. Die '''ASSO'''ciate Beziehung ermöglicht genau das, indem man von Person zu Person über die definierten Beziehungs-Verknüpfungen navigiert.

Der größte Nachteil beim Hinzufügen von mehr Beziehungen ist, dass die Liste als eine Auswahlliste angezeigt wird. Je länger also die Liste ist, desto mehr Probleme kann ein Benutzer möglicherweise haben, die Beziehung zu finden, die er sucht. Die Liste beachtet keine Teilmengen bezogen auf den Kontext eines Ereignisses oder Datensatztyp, zu dem Sie die Beziehung hinzufügen. Für ein Taufereignis wird daher die vollständige Liste angezeigt, einschließlich 'Lodger', 'Seller' und dergleichen.

== Anforderungen ==
Dieses Modul erfordert die webtrees-Version 2.1 oder höher.

Dieses Modul wurde mit der webtrees-Version 2.1.5 und allen verfügbaren Themen und allen anderen Erweiterungsmodulen getestet.

== Installation ==
Bitte beachten Sie die folgenden Installationsanweisungen

* Laden Sie die neueste Version von [https://github.com/hartenthaler/hh_relation_is_descriptor/releases GitHub] herunter.
* Entpacken Sie das Erweiterungsmodul in das Verzeichnis <code>/modules_v4/hh_relation_is_descriptor</code> des webtrees-Webservers. Wenn dieses Verzeichnis bereits vorhanden ist, können Sie es einfach überschreiben.
* Melden Sie sich als Administrator bei webtrees an, gehen Sie zu Systemsteuerung/Module/Personenseite/Reiter und suchen Sie das Modul. Es heißt "xxx". Durch einen Klick auf den Schraubenschlüssel können sie die Einstellungen des Moduls verändern. Überprüfen Sie, ob es ein Häkchen für "Aktiviert" hat. Bearbeiten Sie diesen Eintrag, um die Zugriffsrechte für jeden Stammbaum festzulegen und den Menüpunkt nach ihren Wünschen zu positionieren.
* Klicken Sie abschließend auf "Speichern", um die Konfiguration zu sichern.

== Upgrade ==
Ersetzen Sie zum Aktualisieren einfach die bestehenden Dateien durch diejenigen aus der neuesten Version.

== Übersetzung ==
Sie können helfen, dieses Modul zu übersetzen. Die Sprachinformationen sind in der Datei "resources/lang/ExtendedFamilyTranslation.php" abgelegt. Der deutsche Teil ist der aktuellste und kann als Grundlage für Ihre Übersetzung verwendet werden. Verwenden Sie einen lokalen Editor wie Notepad++, um die Übersetzungen zu erstellen. Das Zurücksenden geht per [https://github.com/hartenthaler/hh_extended_family/pulls Pull-Request in GitHub] (wenn Sie wissen wie das geht) oder per [mailto:git@hartenthaler.de E-Mail an den Programmautor]. Aktualisierte Übersetzungen werden in der jeweils nächsten Version dieses Moduls enthalten sein.

Folgende Sprachen werden neben Deutsch und Englisch unterstützt

* Niederländisch
* Tschechisch.

== Unterstützung ==
Sie können Fehler oder Wünsche für Erweiterungen auf der [https://github.com/hartenthaler/hh_relation_is_descriptor/issues "issue"-Seite bei GitHub] melden,

Sie können bei Fragen auch das [https://www.webtrees.net/index.php/en/forum webtrees-Forum] mit dem Themenbereich "Customising" nutzen.

== Lizenz ==
* © 2022 Hermann Hartenthaler
* abgeleitet von webtrees - © 2022 webtrees-Entwicklungsteam

Dieses Programm ist freie Software: Sie können es unter den Bedingungen der GNU General Public License, veröffentlicht von der Free Software Foundation, entweder in Version 3 der Lizenz oder (nach Ihrer Wahl) jeder späteren Version, weitergeben und/oder modifizieren.

Dieses Programm wird in der Hoffnung verteilt, dass es nützlich sein wird, aber OHNE JEGLICHE GEWÄHRLEISTUNG; ohne auch nur die stillschweigende Gewährleistung der MARKTFÄHIGKEIT oder EIGNUNG FÜR EINEN BESTIMMTEN ZWECK. Weitere Einzelheiten finden Sie in der GNU General Public License, die Sie unter http://www.gnu.org/licenses/ finden.

== Einzelnachweise ==
<references />

[[Kategorie:Webtrees]]

Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Impressum

2023-03-14T20:40:52Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Abschnitt 8.10.1|info=1}}{{WT-Inhaltsverzeichnis|Kapitel 8|E|Abschnitt 8.10|Abschnitt 8.10.1}}

Im Fußbereich der Web-Seiten wird ein Verweis auf ein "Impressum" und eine "Datenschutzerklärung" hinzugefügt. Diese Funktion kann von privaten Einzelpersonen oder auch von genealogischen Vereinen auf einer Vereinsseite genutzt werden.

Die Angaben für die Impressumsseite und die Texte zur Datenschutzerklärung und zu weiteren rechtlichen Regelungen können vom Administrator im Verwaltungsmenü festgelegt werden.

'''Haftungsausschluss:''' Die erstellten Inhalte stellen keine Rechtsberatung dar. Die für die Website verantwortliche Person ist alleine in vollem Umfang für die Aussagen in den erzeugten Seiten verantwortlich (in allen angezeigten Sprachen). Es wird dringend geraten vor der Nutzung ein Code-Review durchzuführen und die Inhalte ggf. an die eigenen Bedürfnisse anzupassen. Dazu bietet es sich an, das GitHub Repository zu clonen.

== Steckbrief ==
* Modulname: hh_impress
* Autor: Hartenthaler
* Passende webtrees-Versionen: 2.1
* Speicherort: [https://github.com/hartenthaler/hh_imprint GitHub]
* Modulkategorie: Webseite
* Modulfunktion: Fußzeile "Impressum und Datenschutzerklärung"

== Beschreibung ==
Dieses Modul fügt allen Seiten einer webtrees-Site einen Verweis auf eine modulare Seite mit einem Impressum, einer Datenschutzerklärung und ggf. weiteren rechtlichen Regelungen hinzu. Der Verweis kann noch um eine Notiz zum Copyright ergänzt werden.

Es wird unter Juristen kontrovers diskutiert, ob eine Website, wie sie von webtrees erzeugt wird, ein "Impressum" oder eine "Datenschutzerklärung" benötigen. Dies ist abhängig vom lokalen Recht und dem Charakter der Website. Näheres dazu findet sich in den nationalen Gesetzen

* Deutschland: §5 Telemediengesetz (TMG) und §4 Medienstaatsvertrag (MStV)
* Österreich: § 5 Abs. 1 E-Commerce-Gesetz (ECG)
* Schweiz: Art. 3 des Bundesgesetzes gegen den unlauteren Wettbewerb (UWG).
{{WT-ToDo|Ausgewählte Literatur, Hinweise der Landesdatenschützer etc ergänzen. Links zu den deutschen Gesetzen ergänzen.}}

Der webtrees Administrator kann im Verwaltungsmenü für den "Verantwortlichen" der Website folgende Datenfelder definieren

* Name der verantwortlichen Person (erforderlich)
* Name des genealogischen Vereins oder der Organisation
* Anschrift (erforderlich)
* Telefon- und Faxnummern
* E-Mail-Adresse (mit oder ohne Betreff und Text der E-Mail)
* Umsatzsteuer-Identifikationsnummer oder andere Registrierungsnummer (z. B. Vereinsregisternummer)
Die Angaben sind optional, sofern sie nicht als "erforderlich" gekennzeichnet sind.

Der webtrees Admin kann wählen, ob die folgenden zusätzlichen Teile angezeigt werden sollen

* Hinweis auf das Copyright in der Fußzeile.
* Bild des Verantwortlichen als [https://gravatar.com Gravatar]
* Liste der Ansprechpartner für einen Stammbaum (genealogisch und technisch)
* Liste der Administratoren dieser Website mit ihren Verweisen auf ein Kontaktformular.
Die folgenden Teile sind ein erster Entwurf. Sie sind nur in deutscher Sprache verfügbar. Der Administrator kann sie aktivieren oder deaktivieren, aber die Reihenfolge kann derzeit noch nicht ausgewählt werden.

* Datenschutzerklärung
* Rechtliche Regelungen

Es ist beabsichtigt, diesen beiden Kapiteln mehr Inhalt hinzuzufügen und diesen modular nutzbar zu machen. Einzelne Abschnitte werden einzeln aktivierbar und in ihrer Reihenfolge änderbar sein. Die Inhalte werden übersetzbar gemacht werden.

== Bedienoberfläche ==
[[Datei:WT 2.1 Erweiterungsmodul Impressum.png|rechts|300x600px|Impressum|verweis=Special:FilePath/WT_2.1_Erweiterungsmodul_Impressum.png]]
Es gibt für Besucher als einziges Element der Bedienoberfläche den Link "Impressum und Datenschutzerklärung" im Fußbereich der Seiten. Nach einem Klick darauf öffnet sich die Impressums-Seite. Diese kann so wie rechts abgebildet aussehen.
{{-}}

=== Verwaltungsmenü ===
[[Datei:WT 2.1 Erweiterungsmodul Impressum Verwaltungsmenü.png|rechts|600x1200px|Verwaltungsmenü Impressum|verweis=Special:FilePath/WT_2.1_Erweiterungsmodul_Impressum_Verwaltungsmenü.png]]
Der Administrator kann im Verwaltungsmenü (siehe Abbildung rechts) alle erforderlichen Einstellungen vornehmen.

{{WT-ToDo|alle Parameter kurz beschreiben; Screenshots aktualisieren; Screenshot zur Fußzeile ergänzen;}}
== Anforderungen ==
Dieses Modul erfordert die webtrees-Version 2.1 oder höher.

Dieses Modul wurde mit der webtrees-Version 2.1.15 und allen verfügbaren Themen und allen anderen Erweiterungsmodulen getestet.

== Installation ==
Bitte beachten Sie die folgenden Installationsanweisungen

* Laden Sie die neueste Version von [https://github.com/hartenthaler/hh_imprint/releases GitHub] herunter.
* Entpacken Sie das Erweiterungsmodul in das Verzeichnis <code>/modules_v4/hh_imprint</code> des webtrees-Webservers. Wenn dieses Verzeichnis bereits vorhanden ist, können Sie es einfach überschreiben.
* Melden Sie sich als Administrator bei webtrees an, gehen Sie zu Verwaltung/Module/Webseite/Fußzeilen und suchen Sie das Modul. Es heißt "Impressum und Datenschutzerklärung". Durch einen Klick auf den Schraubenschlüssel können sie die Einstellungen des Moduls verändern. Überprüfen Sie, ob es ein Häkchen für "Aktiviert" hat.
* Eventuell wollen Sie das Modul "Kontaktangaben" deaktivieren, abhängig davon was Sie in den Einstellungen des Impressum-Moduls dazu festgelegt haben.
* Klicken Sie abschließend auf "Speichern", um die Konfiguration zu sichern.

== Upgrade ==
Ersetzen Sie zum Aktualisieren einfach die bestehenden Dateien durch diejenigen aus der neuesten Version.

== Übersetzung ==
Sie können helfen, dieses Modul zu übersetzen. Dieses Erweiterungsmodul verwendet das po/mo-System für Übersetzungen in andere Sprachen. Die Sprachinformationen können mit der Web-Anwendung [https://poeditor.com/join/project/zscMiujN1m PO Editor project] bearbeitet werden.

{{WT-ToDo|Übersetzungsdienst kurz beschreiben}}

Sie können die Sprachdateien aber auch mit POEdit oder Notepad++ lokal bearbeiten. Diese liegen im Unterverzeichnis <code>resources/lang/</code> des Erweiterungsmoduls. Das Zurücksenden von so überarbeiten Sprachdateien geht dann per [https://github.com/hartenthaler/hh_imprint/pulls Pull-Request in GitHub] (wenn Sie wissen wie das geht) oder per [mailto:git@hartenthaler.de E-Mail an den Programmautor].

Aktualisierte Übersetzungen werden in der jeweils nächsten Version dieses Moduls enthalten sein.

Folgende Sprachen werden derzeit unterstützt

* Deutsch
* Englisch
* Niederländisch.

== Unterstützung ==
Sie können Fehler oder Wünsche für Erweiterungen auf der [https://github.com/hartenthaler/hh_imprint/issues "issue"-Seite bei GitHub] melden, Dort können Sie auch für einzelne rechtliche Aussagen ggf. einen Diskussionspunkt eröffnen.

Sie können bei Fragen auch das [https://www.webtrees.net/index.php/en/forum webtrees-Forum] mit dem Themenbereich "Customising" nutzen.

== Lizenz ==
* © 2023 Hermann Hartenthaler
* GNU General Public License V3 (abgeleitet von webtrees - © 2023 webtrees-Entwicklungsteam)

== Einzelnachweise ==
<references />

[[Kategorie:Webtrees]]

Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/GVExport/Versionsgeschichte

2023-03-14T20:40:42Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Abschnitt 8.10.1.1|info=1}}{{WT-Inhaltsverzeichnis|Kapitel 8|G|Abschnitt 8.10|Abschnitt 8.10.1|Abschnitt 8.10.1.1}}

Die Versionsgeschichte des Erweiterungsmoduls GVExport lässt sich in zwei Abschnitte gliedern: die Versionen für PhpGedView, die mit "0." beginnen und die Versionen für webtrees, die mit "2." beginnen. Dazwischen liegt eine Pause von mehr als zwölf Jahren, in denen das Modul nicht mehr weiter entwickelt worden ist.

== Version 2.1.9 (2022-08-30) ==

* Neu: Einige Einstellungen sind jetzt standardmäßig in den neuen, jeweiligen Menüabschnitt „Erweitert“ verschoben.
* Neu: Eine Toast-Meldung wird bei einer ungültigen Startperson (falsche XREF) bereitgestellt. Es werden nun auch mehrere Toast-Nachrichten unterstützt.
* Neu: GVExport überprüft jetzt, ob die genutzte Version auf dem neuesten Stand ist.
* Geändert: Pflegekinder werden nicht mehr als blutsverwandt angezeigt.
* Behoben: Der Export nach SVG, PNG oder JPEG ohne Graphviz funktioniert jetzt auch in Chrome- und Edge-Browsern.
* Behoben: Ein Problem im Modus „Kombiniert“ mit Stopp-Personen wurde korrigiert.
* Behoben: Der gewählte Ausgabetyp wird gemerkt.

== Version 2.1.8 (2022-08-21) ==
* Neu: SVG, PNG und JPG können nun exportiert werden, ohne dass Graphviz installiert sein muss.
* Neu: Sprache „Norwegisch Bokmål“ hinzugefügt.
* Geändert: mehrerer bevorzugte Namensteile werden unterstützt.
* Behoben: Großeltern werden für adoptierte Startpersonen nun wieder angezeigt.
* Geändert: Mouse-Hover-Texte aufgeräumt.
* Geändert: Aktualisierungsbezogene Prüfung zur Verbesserung der Genauigkeit.

== Version 2.1.7.2 (2022-08-13) ==
* Behoben: Prüfung der Verfügbarkeit der exec-Funktion funktioniert nun.

== Version 2.1.7.1 (2022-08-12) ==
* Geändert: Weiterer Versuch, das Problem zu beheben, wenn die exec-Funktion in einer Systemumgebung nicht aktiviert ist.
* Behoben: Nicht übersetzter Toast ist nun übersetzbar.

== Version 2.1.7 (2022-08-12) ==
* Neu: Hinweis wie viele Personen und Familien eingeschlossen worden sind, wird ausgegeben (Grundlage für andere Nachrichten wurde geschaffen).
* Neu: Texteingabefelder werden auf korrekten Inhalt hin überprüft, um zu verhindern, dass ungültige Daten Fehler verursachen.
* Geändert: „Toast“-Meldungen wurden hinzugefügt.
* Geändert: Übersetzung von Warnungen wurde korrigiert.
* Geändert: Versuch, das Problem zu beheben, wenn die exec-Funktion in einer Systemumgebung nicht aktiviert ist.

== Version 2.1.6 (2022-08-10) ==
* Neu: Option „Jeder“ – Man kann jetzt auch beliebige Verbindungen verfolgen, d.h. man ist nicht mehr auf Verwandte und Ehepartner beschränkt (z. B. kann jetzt auch die die Familie eines Ehepartners eingeschlossen werden).
* Neu: Das Diagramm wird jetzt sofort geladen, wenn die Seite geladen wird.
* Neu: Der bevorzugte Name einer Person (gekennzeichnet mit einem angehängten Stern) wird jetzt unterstrichen.
* Geändert: Einstellungen zur Anzeige der XREF im Vesta-Modul und in GVExport werden gleichermaßen respektiert.
* Geändert: „Reset“-Parameter wird aus der URL entfernt.
* Geändert: Adoptierte Personen werden nicht mehr mit der falschen Farbe für blutsverwandte Personen markiert.
* Geändert: Die Farben der Verwandten wurden korrigiert, wenn die Startperson adoptiert worden ist.
* Geändert: Übersetzungen wurden aktualisiert.

== Version 2.1.5.1 (2022-07-26) ==
* Behoben: Bei den Optionsfeldern zu den Abständen konnte es bei der Eingabe mit Prozentwerten zu Fehlern kommen.

== Version 2.1.5 (2022-07-24) ==
* Neu: Übersetzungen ins Spanische, Katalanische, Niederländische, Russische
* Neu: Wenn es Personen-Datensätze im Sammelbehälter gibt, kann dennoch die interne Personenauswahl verwendet werden, wenn der Nutzer das so möchte.
* Neu: Wenn GraphViz nicht installiert ist, wird das Format DOT fest ausgewählt und es erscheint eine Information für die Nutzer.
* Geändert: Option "Cousins" wurde umbenannt in "Alle Verwandten". Wenn „Alle Verwandten“ aktiviert ist, wird geprüft ob „Geschwister“ ebenfalls aktiviert ist. Wenn "Geschwister" deaktiviert ist, während "Alle Verwandten" aktiviert ist, wird "Alle Verwandten" deaktiviert.
* Geändert: Die Schaltfläche "Vorschau" wurde wieder in "Aktualisierung" umbenannt
* Behoben: Probleme mit Übersetzungen
* Behoben: Bei den Optionsfeldern zu den Abständen konnte es bei der Eingabe mit Prozentwerten zu Fehlern kommen.

== Version 2.1.4.3 (2022-06-23) ==
* Behoben: Wenn der Sammelbehälter keinen Personendatensatz, aber andere Datensatztypen enthält, wird der Sammelbehälter nun nicht mehr als Datenquelle verwendet.
* Behoben: PHP Codierungsprobleme

== Version 2.1.4 (2022-06-22) ==
* Neu: Der Sammelbehälter kann nun als Quelle für die Personen, Familien und Medienobjekte verwendet werden.
* Neu: GVExport ist jetzt vollständig übersetzbar; es gibt nun eine vollständige Übersetzung für Deutsch
* Neu: Mehr Optionen für die Abkürzung von Ortsnamen ergänzt; Optionen zur Verwendung von ISO-Codes mit zwei oder drei Buchstaben hinzugefügt.
* Neu: Unterstützung für das Geschlecht „Andere“ (X) hinzugefügt; standardmäßig wird dafür die gleiche gelbe Farbe wie bei webtrees verwendet. Dieses Update ändert auch die Standardfarbe für das Geschlecht "Unbekannt" (U) in grün, das webtrees verwendet, anstatt in grau.
* Geändert: Die Anordnung der Optionen im Bedienmenü wurde geändert, damit diese besser zur jeweiligen Überschrift passen.
* Geändert: Die Abstandsoptionen für die Knoten verwenden jetzt % anstelle von undefinierten Zahlen. 100 % entspricht dem vorherigen Standardwert.
* Geändert: Die Option in der Systemsteuerung, keine Fotos in Diagramme aufzunehmen, wird nun beachtet. Wenn dies ausgewählt ist, wird die Option zum Hinzufügen von Fotos in GVExport nicht mehr angezeigt.

== Version 2.1.3 (2022-06-12) ==
* Geändert: Fotos werden jetzt in SVG-Dateien eingebettet, zuvor funktionierten Fotos nicht. Wenn die Datei zu groß wird (ca. 10 MB oder 10 Personen mit Fotos), können Bildbetrachter sie leider nicht mehr öffnen. Sie können jedoch mit dem Browser geöffnet werden.
* Behoben: Fehler in Download-Option behoben.

== Version 2.1.2 (2022-06-04) ==
* Behoben: Einige Server-Setups geben andere Pfadinformationen zurück als andere (vollständig oder relativ), was auf einigen Systemen zu einem Fehler führte.
* Behoben: Auswahl der Download-Option wird gemerkt.
* Geändert: X-Button bleibt stehen, wenn im Bedienmenü gescrollt wird.

== Version 2.1.1 (2022-06-01) ==
* Behoben: Darstellung von Personen ohne Partner, die im kombinierten Modus nicht angezeigt werden.
* Behoben: Option „Nicht Blutsverwandte markieren“ kann deaktiviert werden.
* Behoben: Aktualisierung von page.phtml.

== Version 2.1.0 (2022-06-02 / 2022-05-10 ?) ==
* Neu: Unterstützung von webtrees 2.1.2 bis 2.1.4.
* Neu: Anführungszeichen um Spitznamen werden in der Ausgabe beibehalten; Stern (*) beim bevorzugten Namen wird unterstützt (erscheint am Anfang des Namens).

== Version 2.0.0 (2021-05-23) ==
* Neu: Kompatibilität mit webtrees 2.0 (nach vorheriger Anpassung an webtrees 1.7.
* Neu: Clientseitiges Graphviz-Rendering über viz.js, d.h. ohne eine Graphviz-Installation auf dem Server können SVG-Grafiken auf dem Client im Browser erzeugen können.
* Geändert: Vollständiges Formular / Anpassung von JavaScript zur Kompatibilität mit webtrees
* Geändert: Unterstützung des aktuellen Übersetzungssystems unter Verlust der bestehenden Übersetzungen.

== Versionen 0.x für PhpGedView ==
Die Entwicklung von GVExport beginnt mit der Version 0.1 im November 2007. Bis Ende 2009 sind dann 34 weitere Releases für PhpGedView erschienen. Danach ist die Entwicklung zum Erliegen gekommen. Erst im Mai 2021 wurde das Modul mit der Version 2.0.0 für webtrees 2.0 reaktiviert.
* Version 0.8.3 (2009-11-24)
** Neu: Zusätzliche Einstellungen zum Steuern des Aussehens des Baums (dpi, ranksep, nodesep)
** Behoben: Kombinierter Baum (Anfrage von Meliza Amity)
** Behoben: Datumsbehandlung für 4.2.3SVN-Kompatibilität, richtig lokalisierte Daten (von Łukasz Wileński)
** Geändert: Polnische Übersetzung aktualisiert (von Łukasz Wileński)
* Version 0.8.2 (2009-08-23)
** Neu : Baumverarbeitung bei gegebenen INDIs stoppen (Anfrage von Marcel Beerli)
* Version 0.8.1a (2009-08-16)
** Behoben: Fehler in der Bedienoberfläche, wenn kein Graphviz-Pfad angegeben ist
* Version 0.8.1 (2009-04-11)
** Neu: Mehrere Indis können für Teilbäume hinzugefügt werden (Anfrage von Bruno Spiquel)
* Version 0.8.0 (2009-02-15)
** Behoben: Kompatibilität mit 4.2/4.2SVN (von Ely Schoenfeld)
** Neu: Fotos in kombinierten Boxen (von Ely Schoenfeld)
** Geändert: In config.php konfigurierte Ausgabedateitypen (von Ely Schoenfeld)
* Version 0.7.2 (2008-10-23)
** Behoben: Anklickbare Container (INDI und FAM) - funktionieren jetzt wieder
** Neu: Familien-Container konnten abgeschaltet werden, daher ist die Grafik jetzt kompakter (es ist durchaus brauchbar für Stammbaum- und Nachkommenstabellen)
** Neu: PostScript-Ausgabe funktioniert (irgendwie), dies wird benötigt, wenn der Seitenumbruchmodus verwendet wird
* Version 0.7.1 (2008-10-19)
** Behoben: Funktioniert korrekt mit 4.1.6 SVN (Dateibenennungsunterschied: person_class.php vs class_person.php)
* Version 0.7.0 (2008-07-27)
** Behoben: Funktioniert korrekt mit 4.1.5 & 4.1.6 SVN (Datumsbehandlung)
** Neu: Kleinere Verbesserungen in der Benutzerfreundlichkeit
* Version 0.6.6 (2008-05-01)
** Neu: UI-Einstellungen werden in Cookie gespeichert (von Till Schulte-Coerne)
** Neu: Mehrere Datumsformate (in Entwicklung)
* Version 0.6.5 (2008-04-06)
** Behoben: Problemumgehung für den Fehler in der Methode Family->getSpouseId() Änderungen in der Bedienoberfläche (von Till Schulte-Coerne)
* Version 0.6.4 (2008-03-22)
** Neu: Deutsche Übersetzung (von Hermann Schulte-Coerne)
** Neu: Name der benutzerdefinierten Schriftart
* Version 0.6.3 (2008-02-01)
** Behoben: Multi-Plattform-Betriebsfähigkeit (von Thomas Ledoux), jetzt sollten GVExport & Graphviz auf Win OS zusammenarbeiten.
* Version 0.6.2 (2008-01-31)
** Neu: Benutzerdefiniertes Limit für die Suchtiefe (Level) für Vorfahren und Nachkommen
** Neu: Suche nach Cousines (jetzt ein separates Kontrollkästchen)
** Neu: Französische Übersetzung (von Thomas Ledoux)
** Behoben: URLs im kombinierten Modus
* Version 0.6.1 (2008-01-23)
** Neu: Verknüpfte GEDCOMs (nur im partiellen Baummodus, nicht wenn "Jeder" ausgewählt ist), URLs funktionieren auch für verknüpfte GEDCOMs.
** Behoben: INDIs mit unbekanntem Geschlecht im "kombinierten" Modus
** Behoben: INDI-ID fehlt im "dekorierten" Modus
** Behoben: FAM-ID-Probleme im "kombinierten" Modus (verknüpfte GEDCOMs)
** Behoben: Polnische Übersetzung ist aktuell (von wooc)
* Version 0.6.0 (2008-01-22)
** Neu: Neugestaltung der Benutzeroberfläche
** Geändert : Debug-Modus selbsterklärender
* Version 0.5.4 (2008-01-16)
** Neu: PDF-Ausgabe (abhängig von der Graphviz-Version)
** Neu: Benutzerdefiniertes Medienverzeichnis
** Behoben: Absolute URLs in indi/fam-Links
** Behoben: Fehler in HTML-formatierten Texten (&-Zeichen)
** Behoben: Benennung des Heiratsortes (Abkürzung versus ausführliche Angabe)
** Behoben: Linksbündige Texte
** Behoben: Vermeidung geschätzter Geburtsdaten (wenn Sterbedatum vorhanden ist)
* Version 0.5.3 (2008-01-14)
** Neu: Anpassbarer Text auf dem Diagramm (in der Konfigurationsdatei)
** Neu : Vollständiger oder abgekürzter Ortsname (in der Konfigurationsdatei)
** Neu: Randgröße (in Konfigurationsdatei)
** Behoben: Entfernen von doppelten Anführungszeichen (") aus Namen
* Version 0.5.2 (2007-12-20)
** Neu: Polnische Übersetzung (von wooc)
* Version 0.5.1a (2007-12-13)
** Behoben: MCLIMIT-Einstellung (funktionierte überhaupt nicht)
* Version 0.5.1 (2007-12-12)
** Neu: MCLIMIT-Einstellung
* Version 0.5.0 (2007-12-02)
** Behoben: PHP-Fehler während der "einfachen" Graphverarbeitung
** Neu: INDI-ID und FAM-ID können im Diagramm angezeigt werden
** Neu: Anklickbare Container (INDI und FAM), die die INDI/FAM-Seite in PhpGedView öffnen
** Neu: Der Benutzername des letzten Bearbeiters kann angezeigt werden
* Version 0.4.9 (2007-11-30)
** Behoben: (Jetzt wirklich behoben) Nicht validierte Personen und Familien werden angezeigt
** Neu: Diagrammrichtung wählbar (von oben nach unten oder von links nach rechts)
** Neu: Kombinierter Diagrammmodus (Ehemann und Ehefrau in einer einzelnen Zelle zusammen mit Heiratsinformationen) - funktioniert nur im partiellen Baummodus korrekt
** Neu : Im Container angezeigte Daten können ausgewählt werden
* Version 0.4.8 (2007-11-29)
** Behoben: Nicht validierte Personen und Familien werden angezeigt (TODO #1)
* Version 0.4.7 (2007-11-28)
** Behoben: Fehlerbehandlung für GraphViz-Exec (Pasquale Ceres <pasquale_ceres at yahoo it>)
** Neu: Grafik kann im Browserfenster angezeigt werden (Pasquale Ceres <pasquale_ceres at yahoo it>)
* Version 0.4.6 (2007-11-27)
** Neu : Personen mit nicht validierten Daten können markiert werden
* Version 0.4.5 (2007-11-27)
** Neu: Ausgabe mit Seitenumbruch konnte ausgewählt werden (wirkt nur auf DOT-Dateien)
* Version 0.4.4 (2007-11-25)
** Neu: Neuer Diagrammtyp - Dekoriert mit Fotos (könnte langsam sein!)
** Neu: Nicht blutsverwandte Personen können mit unterschiedlicher Farbe markiert werden (auf Teilbaum)
** Neu: Geschwister können in den Teilbaum aufgenommen werden
** Geändert: Einige UI-Änderungen
* Version 0.4.3 (2007-11-24)
** Neu: Benutzerdefinierte Schriftgröße, die im Diagramm verwendet wird
* Version 0.4.2 (2007-11-24)
** Neu: Vorfahren, Nachkommen und Ehepartner sind im Teilbaummodus wählbar
* Version 0.4.1 (2007-11-24)
** Behoben: Syntaxfehler in der DOT-Datei, wenn der "decorated"-Modus verwendet wird
* Version 0.4 (2007-11-23)
** Neu: Logik neu geschrieben
** Neu: Teilbaumauswahl ist verfügbar (INDI und seine/ihre Vorfahren)
** Neu: Italienische Sprachdatei hinzugefügt (Pasquale Ceres <pasquale_ceres at yahoo it>)
** Neu: SVG-Ausgabeformat hinzugefügt, scheint aber fehlerhaft zu sein
** Geändert: Etwas Beschleunigung bei der vollständigen Baumgenerierung
** Geändert: Code-Bereinigung (Dateien erforderlich)
** Geändert: Standardfarben in config.php Version 0.3.2 (2007-11-22)
** Behoben: Wenn eine lokalisierte Sprachdatei fehlt, wird "en" verwendet
* Version 0.3.1 (2007-11-22)
** Neu: Die Grundkonfiguration ist in einer dedizierten Konfigurationsdatei verfügbar
** Behoben: Korrekte Verwendung von Sprachdateien
** Geändert: Keine JavaScript-Popups mehr (gvexport_output.php ist jetzt veraltet)
* Version 0.3 (2007-11-22)
** Neu: Simple / Decorated (HTML) Diagramm
** Neu: Benutzerdefinierte Farben für das Diagramm
** Behoben: PHP-Bug (Pasquale Ceres)
* Version 0.2 (2007-11-21)
** Behoben: PHP4-Kompatibilität (Pasquale Ceres)
** Geändert: Temporäre Dateien werden im System-Temp-Verzeichnis statt im Unterverzeichnis "session_id" gespeichert, sodass jetzt weniger Verzeichnisse erstellt werden
* Version 0.1 (2007-11-15)
** Erste Version von GVExport

Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/GVExport

2023-03-14T20:40:32Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Abschnitt 8.10.1.1|info=1|sticksort=1}}{{WT-Inhaltsverzeichnis|Kapitel 8|F|Abschnitt 8.10|Abschnitt 8.10.1|Abschnitt 8.10.1.1}}

Das Erweiterungsmodul stellt ein Diagramm zur Verfügung, das einen oder mehrere vollständige Bäume mit Ehepartnern, Vorfahren, Nachkommen oder verschwägerten Personen anzeigt.

== Steckbrief ==
* Modulname: GVExport
* Autor: Neriderc
* Passende webtrees-Versionen: 2.1
* Speicherort: [https://github.com/Neriderc/GVExport GitHub]
* Modulkategorie: Genealogie
* Modulfunktion: Diagramm "GVExport"

== Beschreibung ==
[[Datei:WT_2.1_GVExport_typische_Ansicht.png|links|mini|650x650px|Typische Ansicht des Bedienmenüs und eines Diagramms im Hintergrund|verweis=Special:FilePath/WT_2.1_GVExport_typische_Ansicht.png]]{{WT-ToDo|Grafik aktualisieren}}
GVExport ist ein Erweiterungsmodul, das die Graphviz<ref>[https://graphviz.org/ Graphviz Projektseite]</ref>-Software verwendet, um eine grafische Darstellung eines Stammbaums zu erstellen.

Mit einem auf dem Server installierten Graphviz-Programm kann man Grafikdateien mit dem Diagramm in vielen Formaten wie JPG, PNG, SVG oder PDF erzeugen und dann herunterladen. Man kann sogar ein PDF oder SVG mit anklickbaren Links exportieren, so dass der Nutzer beim ''Klick'' auf eine Person in der Darstellung, die webtrees-Seite für diese Person angezeigt bekommt.

Auch ohne installiertes Graphviz-Programm können ''"anklickbare"'' Diagramme im Browser angezeigt werden (dies funktioniert nicht mit Android oder iOS). Damit können die Zusammenhänge in Personengruppen übersichtlich dargestellt werden. Oder es kann eine Übersicht über gezielt selektierte Gruppen von Personen hergestellt werden.

=== Auswahl der Personen ===
Für die Auswahl der darzustellenden Personen und Familien und deren Beziehungen untereinander kommen zwei Quellen in Frage.
* Zum einen kann man eine oder mehrere Startpersonen aus dem Stammbaum auswählen. Dann wählt man zu diesen Startpersonen Vorfahren oder Nachkommen in einer wählbaren Anzahl von Generationen aus, dazu eventuell auch die Geschwister oder die Partner oder alle Verwandten. Es ist also nicht nur eine Darstellung der Vorfahren oder Nachkommen möglich, sondern von gesamten Familienzweigen. Darüber hinaus kann man auch die angeheirateten Familien mit aufnehmen.
* Zum anderen kann man den Inhalt des [[Webtrees Handbuch/Anleitung für Mitglieder#Sammelbehälter|Sammelbehälters]] als Quelle für die Visualisierung verwenden. Man legt dazu eine beliebige Menge an Personen, Familien und Medienobjekten in den Sammelbehälter. Diese werden dann dargestellt. Wenn mindestens ein Personendatensatz (INDI) im Sammelbehälter liegt, kann der Sammelbehälter als Datenquelle verwendet, ansonsten kommt die oben genannte erste Quelle zum Tragen.

=== Darstellungsarten ===
Man kann zwischen drei grundsätzlichen Darstellungsarten wählen, von denen zwei das Anzeigen von Fotos für die Personen im Stammbaum unterstützen. GVExport hat etliche konfigurierbare Optionen, etwa bezüglich der Anzeige von Geburts- oder Todesdatum und zugehörigen Ortsdaten.

=== Geschichte des Erweiterungsmoduls ===
Das [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodul]] GVExport hat eine turbulente Geschichte hinter sich. Das Modul wurde mehrere Male von neuen Bearbeitern übernommen, weil die bisherigen Betreuer nicht mehr weiter daran arbeiten konnten oder wollten.

Das Erweiterungsmodul wurde ursprünglich im November 2007 für [[PhpGedView]] erstellt, den Vorgänger von webtrees. Im Jahre 2021 wurde die Software, die mehr als ein Jahrzehnt lang nicht mehr gepflegt worden war, für webtrees 2.0 verfügbar gemacht. Im Juni 2022 ist das Modul an webtrees 2.1 angepasst worden und wird seither laufend verbessert.

Eine vollständige Übersicht über die Änderungen, die in den verschiedenen Versionen vorgenommen worden sind, gibt es auf der Unterseite "[[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/GVExport/Versionsgeschichte|Versionsgeschichte]]" und in der Datei <code>changelog.txt</code> (in Englischer Sprache), die dem Erweiterungsmodul beiliegt. An dieser Stelle hier erfolgt eine Darstellung der wichtigsten Änderungen seit der Version 2.0.0.
* Version 2.1.9 (30.08.2022): GVExport überprüft jetzt, ob die genutzte Version auf dem neuesten Stand ist. Pflegekinder werden nicht mehr als blutsverwandt angezeigt. Der Export nach SVG, PNG oder JPEG ohne Graphviz auf dem Server funktioniert jetzt auch in Chrome- und Edge-Browsern. Einige Einstellungen sind jetzt standardmäßig in den neuen, jeweiligen Menüabschnitt „Erweitert“ verschoben.
* Version 2.1.8 (21.08.2022): Nun können Dateien im Format SVG, PNG und JPG exportiert werden, ohne dass Graphviz installiert sein muss. Diverse kleinere Fehler wurden behoben.
* Version 2.1.7.2 (13.08.2022): Die Prüfung der Verfügbarkeit der internen exec-Funktion funktioniert nun.
* Version 2.1.7.1 (12.08.2022): Weiterer, nicht erfolgreicher, Versuch, das Problem zu beheben, wenn die exec-Funktion in einer Systemumgebung nicht aktiviert ist.
* Version 2.1.7 (12.08.2022): Es wurde die Möglichkeit geschaffen Statusnachrichten („Toast“) darzustellen. Es erfolgt damit ein Hinweis wie viele Personen und Familien eingeschlossen worden sind. Texteingabefelder werden auf korrekten Inhalt hin überprüft, um zu verhindern, dass ungültige Daten Fehler verursachen. Erster Versuch, das Problem zu beheben, wenn die exec-Funktion in einer Systemumgebung nicht aktiviert ist.
* Version 2.1.6 (10.08.2022): Es gibt nun eine neue Option „Jeder“ mit der man auch beliebige Verbindungen verfolgen lassen kann, d.h. man ist nicht mehr auf Verwandte und Ehepartner beschränkt (z. B. kann jetzt auch die die Familie eines Ehepartners eingeschlossen werden). Das Diagramm wird jetzt sofort geladen, wenn die Seite geladen wird. Der bevorzugte Name einer Person (gekennzeichnet mit einem angehängten Stern) wird jetzt unterstrichen dargestellt. Die Einstellungen zur Anzeige der XREF im Vesta-Modul und in GVExport werden gleichermaßen respektiert. Adoptierte Personen werden nicht mehr mit der falscher Farbe für blutsverwandte Personen markiert. Die Farben der Verwandten wurden korrigiert, wenn die Startperson adoptiert worden ist.
* Version 2.1.5.1 (26.07.2022): Die Fehlerbehandlung bei der Eingabe von Optionen mit Prozentwerten wurde überarbeitet.
* Version 2.1.5 (24.07.2022): Es wurde eine Möglichkeit hinzugefügt, den Sammelbehälter zu überschreiben, d.h. wenn sich Personendatensätze im Sammelbehälter befinden, kann man diese jetzt ignorieren und stattdessen die interne Auswahl von Personen verwenden. Wenn Graphviz nicht auf dem Server installiert ist, wird als Ausgabeformat nur DOT als verfügbar angezeigt; es wird in einem Hinweistext erklärt, warum die Auswahloptionen entsprechend eingeschränkt sind. Es wurden Übersetzungen für Spanisch, Niederländisch, Russisch und Katalanisch hinzugefügt.
* Version 2.1.4.3 (23.06.2022): Wenn der Sammelbehälter keine Personendatensätze, aber andere Datensätze enthält, kam es zu einem Fehler, der nun behoben wurde.
* Version 2.1.4 (22.06.2022): Als neue Funktion ist hinzugekommen, dass nun auch der Sammelbehälter als Quelle für die Personen, Familien und Medienobjekte verwendet werden kann. Die Optionen zur Verkürzung der Ortsnamen sind erweitert worden, wodurch sich die Personenkästchen im Diagramm kompakter gestalten lassen. Das Erweiterungsmodul ist nun auch wieder in verschiedene Sprachen übersetzbar, die deutsche Übersetzung ist als erste hinzugekommen. Diese Version unterstützt, wie allgemein in '''webtrees,''' nun auch die Kennung für das Geschlecht „Andere“ (X). Die Anordnung der Optionen im Bedienmenü wurde geändert, damit diese besser zur jeweiligen Überschrift passen.
* Version 2.1.3 (12.06.2022): Die Darstellung des persönlichen Fotos einer Person funktioniert nun wieder.
* Version 2.1.2 (04.06.2022): Kleinere Fehler in der Verwaltung der Optionen wurden behoben; der X-Button zum Schließen des Bedienmenüs bleibt nun stehen, wenn im Menü gescrollt wird.
* Version 2.1.1 (01.06.2022): Personen ohne Partner werden auch in der Darstellungsart "Kombiniert" angezeigt; die Option zur Markierung von nicht blutsverwandten Personen in einer anderen Farbe kann deaktiviert werden.
* Version 2.1.0 (02.06.2022 oder 10.05.2022 ?): Nun wird webtrees 2.1.2 bis 2.1.4 unterstützt. Anführungszeichen um Spitznamen werden in der Ausgabe beibehalten; der Stern (*) als Kennzeichen für den bevorzugten Namen wird unterstützt.
* Version 2.0.0 (23.05.2021): Die Kompatibilität mit webtrees 2.0 wurde hergestellt. Das Clientseitige Graphviz-Rendering über viz.js wurde implementiert, d.h. ohne eine Graphviz-Installation auf dem Server können nun SVG-Grafiken auf dem Client im Browser erzeugen werden. Die Unterstützung des aktuellen Übersetzungssystems wurde vorbereitet (unter Verlust der bestehenden Übersetzungen).

== Bedienoberfläche ==
Um auf GVExport zuzugreifen, klicken Sie im Hauptmenü auf [[Webtrees Handbuch/Anleitung für Besucher#Diagramme|Diagramme]] und wählen dann GVExport aus der Liste aus.

Als Benutzer können Sie zum einen mit dem Diagramm interagieren und zum anderen im [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/GVExport#Bedienmenü|Bedienmenü]] Einstellungen vornehmen. Es gibt für dieses Modul kein Konfigurationsmenü in der Systemsteuerung.

=== Beispiel zur Erstellung eines Diagramms ===
[[Datei:WT_2.1_GVExport_Darstellung_einfach.png|rechts|mini|650x650px|Diagramm in der "einfachen" Darstellung|verweis=Special:FilePath/WT_2.1_GVExport_Darstellung_einfach.png]]
Lassen Sie uns eine einfache Stammbaumausgabe erstellen. Wir wollen für die Startperson Maria von Stradonitz ihre Eltern, ihre Kinder, die Enkelkinder und die jeweiligen Ehepartner in die Darstellung im Diagramm einbeziehen. Dazu selektieren wir im Feld „Alle, die verwandt sind" die Startperson Maria von Stradonitz. Dies kann entweder durch die Eingabe von Namensbestandteilen oder durch die Eingabe der XREF des Personendatensatzes erfolgen. Die XREF ist eine im aktuellen Stammbaum eindeutige Kennung für den Datensatz einer Person oder einer Familie.

Wir könnten auch mehrere Startpersonen auswählen, indem wir auf den Pfeil "↵" in der nächsten Zeile klicken, um die [[GEDCOM/XREF ID|XREF]] der aktuellen Person zum Sammelfeld in der nächsten Zeile hinzufügen. Danach könnten wir nach einer weiteren Person suchen und diese ebenfalls hinzufügen. Aber bleiben wir für dieses Beispiel bei der einen Startperson.

Wir lassen die Felder "Beende Bearbeitung bei" leer, wählen dann "Vorfahren einbeziehen" aus und geben eine 2 im Feld "Maximale Generationen" ein. Da für die Startperson keine Großeltern im Muster-Stammbaum hinterlegt sind, werden im Diagramm aber nur die Eltern von Maria von Stradonitz erscheinen.

Dann wählen wir „Geschwister“ und „Alle Verwandten“ nicht aus, wohl aber „Partner“, damit letztere in die Darstellung eingeschlossen werden. Diese Auswahl bezieht sich sowohl auf die Generation der Startperson, als auch auf die Vorfahren- und auch auf die Nachkommen-Generationen.

Nun wählen wir die Option "Nachkommen einbeziehen" aus und geben eine 2 im Feld "Maximale Generationen" ein. Die Nachkommen-Generationen umfassen damit die Kinder und die Enkelkinder der Startperson, aber nicht ihre Urenkelkinder. Die Partner der Kinder und Enkelkinder werden ebenfalls dargestellt.

Lassen Sie uns viele der weiteren Optionen auf der Standardeinstellung belassen und gleich zum Ende des Bedienmenüs springen. Dort ''klicken'' wir auf die Schaltfläche „Aktualisieren“, um die Darstellung des Diagramms auf der Seite zu erzeugen. Sie können auf das "x" in der rechten oberen Ecke des Bedienmenüs klicken, um dieses Feld auszublenden und somit den Diagramm-Bereich vollständig sichtbar zu machen.

=== Diagramm-Bereich ===
Das Diagramm erscheint in einem rechteckigen Bereich auf der webtrees-Seite (Viewport), der teilweise hinter dem Bedienmenü liegt (wenn dieses aufgeklappt ist).

Sie können nun das Diagramm mit der Maus ziehen, um es zu verschieben ('''Pan'''), oder Sie können die Darstellung mit dem Mausrad vergrößern oder verkleinern ('''Zoom''').

Wenn man die Option "URL hinzufügen zu Personen und Familien" auswählt, sind die Grafikelemente im Diagramm „anklickbar“, d. h. durch ''Klicken'' werden die entsprechenden Informationsseiten der Person beziehungsweise der Familie in einem neuen Browser-Tab geöffnet (dies funktioniert nicht mit Android oder iOS).

{{WT-ToDo|Screenshots einfügen für den Typ Einfach und den Typ Kombiniert}}

==== Diagrammtypen "Einfach" und "Dekoriert" ====
Die Personen werden in rechteckigen Kästchen dargestellt. Die gezeigten Informationen, wie etwa zur Geburt oder dem Tod, werden entsprechend der gewählten Optionen in diesem Kästchen präsentiert. Die Kästchen sind entsprechend dem Geschlecht der Person und der eventuell bestehenden Blutsverwandtschaft zu den Startpersonen farbig gefärbt, wenn die entsprechende Option ausgewählt worden ist. Wenn der Diagrammtyp "Dekoriert" gewählt wurde, dann wird ein persönliches Foto der Person gezeigt, sofern dieses vorhanden ist.

Ausgehend von einer Person gibt es Pfeile zu den Familien in denen die Person als Partner vorkommt. Die Familien werden als Ellipsen dargestellt. In den Ellipsen stehen ggf. Angaben zur Heirat, wenn die entsprechenden Optionen gewählt worden sind. Von den Ellipsen gehen Pfeile zu den leiblichen und zu den Adoptiv- oder Pflegekindern einer Familie.

==== Diagrammtyp "Kombiniert" ====
Bei der Auswahl des Diagrammtyps "Kombiniert" werden keine Familienellipsen dargestellt. Die beiden Partner einer Familie werden in einem umfassenden Kästchen kombiniert, nebeneinander dargestellt. Darunter befinden sich dann ggf. Angaben zur Heirat. Ansonsten erfolgt die Darstellung der Personenkästchen wie im Diagrammtyp "Dekoriert", also ggf. mit einem persönlichen Bild.

Ausgehend von einem kombinierten Kästchen zeigen Pfeile auf die Kinder aus dieser Familie, so wie im Diagrammtyp "Einfach".

=== Bedienmenü ===
Im den folgenden Abschnitten wird nun das Bedienmenü im Detail beschrieben. Es befindet sich am linken Bildschirmrand. Mit einem ''Klick'' auf das "x" in der oberen, rechten Ecke kann das Menü zugeklappt werden. Dann erscheint stattdessen am linken Bildschirmrand ein Feld "Zeige Auswahl" und ein ''Klick'' auf dieses Feld klappt das Bedienmenü wieder auf.

Das Bedienmenü gliedert sich in die folgenden Teile
* [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/GVExport#Einzubeziehende Personen|Einzubeziehende Personen]]
* [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/GVExport#Gestaltung des Diagramms|Gestaltung des Diagramms]]
* [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/GVExport#Ausgabe-Einstellungen|Ausgabe-Einstellungen]]
* [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/GVExport#Aktions-Schaltflächen|Aktions-Schaltflächen]]

==== Einzubeziehende Personen ====
[[Datei:WT_2.1_GVExport_Einzubeziehende_Personen.png|rechts|mini|350px|Bedienmenü: Einzubeziehende Personen|verweis=Special:FilePath/WT_2.1_GVExport_Einzubeziehende_Personen.png]]{{WT-ToDo|Grafik aktualisieren}}{{WT-ToDo|Erklärung und Screenshot für die Wahloption den Sammelbehälter zu verwenden oder zu ignorieren.}}
In diesem Abschnitt können Sie auswählen, welche Personen und Familien angezeigt werden sollen. Wenn im Sammelbehälter mindestens ein Personendatensatz liegt, dann ist dieser Abschnitt komplett ausgegraut, da dann die Informationen aus dem Sammelbehälter dargestellt werden.

===== Alle, die verwandt sind =====
Wählen Sie hier eine Person aus dem Stammbaum aus, um die herum das Diagramm erstellt werden soll. Wenn Sie sich auf einer Personenseite befinden und dann das Diagramm GVExport im Menü auswählen, dann ist hier diese Person vorausgewählt. Sobald Sie jemanden ausgewählt haben, können Sie auf den Pfeil am Ende des unteren Feldes ''klicken'', um die XREF der ausgewählten Person zu der dort befindlichen Liste hinzuzufügen. Sie können dann weitere Personen auswählen, die als Ausgangspunkte für weitere Teilbäume hinzugefügt werden sollen. Sie können beliebig viele Startpersonen ergänzen. Sie können die XREFs sogar direkt im Auswahlfeld eingeben und bearbeiten.

Die Person in der Personenauswahlbox und jede Person, die sich in der XREF-Liste befindet, werden beim Erstellen des Diagramms berücksichtigt.

Die XREF-Informationen in der Liste werden gespeichert, wenn man "Aktualisieren" oder "Herunterladen" auswählt, so dass diese Informationen dann wieder bereit stehen, wenn man die Seite GVExport erneut auswählt.

===== Beende Bearbeitung bei =====
Wenn das Modul bei der Durchsuchung des Stammbaumes, ausgehend von den Startpersonen, eine der hier angegebenen Personen erreicht, wird die weitere Suche an dieser Stelle beendet. Wenn Sie beispielsweise sich selbst als Startperson gewählt haben, können Sie alle Blutsverwandten mit Ausnahme der mütterlichen Seite der Familie selektieren, indem Sie ihre Mutter als Person bei "Beende Bearbeitung bei" hinzufügen. Der dargestellte Stammbaum enthält weiterhin Ihre Mutter, aber nicht die Eltern oder Geschwister Ihrer Mutter.

===== Vorfahren einbeziehen =====
Aktivieren Sie diese Option, um die Vorfahren der Startperson(en) im darzustellenden Stammbaum einzubeziehen.

Unter "Maximale Generationen" geben Sie an, wie viele Generationen an Vorfahren einbezogen werden sollen. Wenn Sie beispielsweise sich selbst als Startperson gewählt haben, möchten Sie beispielsweise, dass das Diagramm Verwandte bis zu Ihren Urgroßeltern enthält. In diesem Fall würden Sie in dieses Feld 3 eingeben, um die Generation der Eltern, der Großeltern und der Urgroßeltern einzuschließen. Wenn Sie "Vorfahren einbeziehen" nicht auswählen oder bei der Anzahl der Generationen eine Null eingeben, wird nur die Startperson selbst einbezogen, aber keine Vorfahren.

===== Einbeziehen =====
In diesem Abschnitt können Sie entscheiden, welche Arten von Verwandten beim Erstellen des Diagramms berücksichtigt werden sollen.

* Geschwister: voll- und halbbürtige Geschwister werden dargestellt; es werden auch Adoptiv- oder Pflegegeschwister und andere nicht vollbürtige Geschwister einbezogen (sofern die Elterngeneration einbezogen ist)
* Partner: die Ehemänner, Ehefrauen und Partner der Personen im Stammbaum werden einbezogen, auch wenn sie keine Blutsverwandten sind.
* {{WT-ToDo|Die beiden weiteren Optionen beschreiben}}

Diese Optionen gelten sowohl für die Vorfahren- als auch die Nachkommen-Generationen.

Es gibt eine weitere Option "Nicht blutsverwandte Personen mit anderer Farbe markieren", die es ermöglicht, diese Personen in einem blasseren Farbton darzustellen.

===== Nachkommen einbeziehen =====
Hier können Sie wählen, ob Kinder, Enkelkinder usw. von Personen, die im Stammbaum aufgeführt sind, eingeschlossen werden sollen.

Unter "Maximale Generationen" geben Sie an, wie viele Generationen an Nachkommen einbezogen werden sollen. Wenn Sie beispielsweise sich selbst als Startperson gewählt haben, und wenn Sie wollen, dass das Diagramm Nachkommen bis zu Ihren Enkeln enthält, dann müssen Sie 2 in dieses Feld eingeben, um Ihre Kinder, Ihre Enkel und andere Personen in diesen beiden Generationen einzuschließen.

===== Markierung von nicht blutsverwandten Personen in einer anderen Farbe =====
Wenn Ehepartner im Abschnitt „Einzubeziehende Personen“ aufgenommen wurden und mit keiner der Startpersonen blutsverwandt sind, werden sie bei Auswahl dieser Option in einer viel schwächeren Farbe als dem standardmäßigen Blau/Rosa für Verwandte hervorgehoben. Entsprechendes gilt etwa für Adoptivkinder.

==== Gestaltung des Diagramms ====
[[Datei:WT_2.1_GVExport_Gestaltung_des_Diagramms.png|rechts|mini|350px|Bedienmenü: Gestaltung des Diagramms|verweis=Special:FilePath/WT_2.1_GVExport_Gestaltung_des_Diagramms.png]]
In diesem Abschnitt des Bedienmenüs können Sie den Ausgabestil des Diagramms auswählen.

===== Diagrammrichtung =====
Hier gibt es zwei Darstellungsmöglichkeiten, wobei die Standardoption "Von links nach rechts" ist; hierbei werden die älteren Generationen links und die jüngeren rechts erstellt. Die andere Möglichkeit ist "Von oben nach unten"; hier werden die älteren Generationen oben und die jüngeren unten angeordnet.

===== Diagrammtyp =====
Die drei Optionen hier sind

* Einfach - Pro Person wird eine Box angezeigt; je nach Geschlecht wird diese eingefärbt. Es können keine Fotos angezeigt werden. Die Familien (Partner- oder Elternfamilien) werden als Ovale dargestellt.
* Dekoriert - Die Darstellung erfolgt wie im Typ "Einfach", aber das Einfügen von Fotos wird ermöglicht.
* Kombiniert - Jedes Paar ist in einer Box untergebracht. Es gibt keine separate Darstellung der Familien. Wenn eine Person mehrfach mit Partnern zusammen war, wird sie mehrfach im Diagramm aufgeführt. Die Präsentation von Fotos ist möglich.

===== Fotos hinzufügen =====
Hier kann ausgewählt werden, ob das Vorzugsfoto einer Person im Diagramm angezeigt werden soll. Dies wird nur für die Diagrammtypen "Dekoriert" und "Kombiniert" unterstützt. Wenn der Administrator in den Einstellungen festgelegt hat, dass für diesen Stammbaum gar keine Vorzugsfotos angezeigt werden sollen, dann erscheint diese Option überhaupt nicht.

===== URL hinzufügen zu Personen und Familien =====
Wenn diese Option ausgewählt ist, dann kann man im Diagramm-Bereich auf Personen oder Familien klicken und gelangt so direkt auf die entsprechende Personen- oder Familienseite.

Bei der Ausgabe von SVG- und PDF-Dokumenten werden diese Links ins Dokument eingefügt, wenn diese Option gesetzt ist. Auf diese Weise können die Nutzer der so erzeugten Dokumente auf die Person im Diagramm klicken, um zur entsprechenden webtrees-Seite zu gelangen.

===== Benutzung abgekürzter Ortsnamen =====
Bei Auswahl dieser Option werden Ortsnamen (für Geburtsort, Heiratsort, Ort des Todes) so gekürzt, dass sie nur den ersten und letzten Abschnitt enthalten. Zum Beispiel kann "Süßen, Göppingen, Baden-Württemberg, Deutschland" bei der Ausgabe abgekürzt werden zu "Süßen, Deutschland". Neben dieser Auswahloption "Ort und Staat" und der Option "Vollständige Ortsnamen" stehen noch zwei weitere Optionen zur Verfügung: "Ort und 2-Buchstaben ISO-Länder-Code" und "Ort und 3-Buchstaben ISO-Länder-Code". Dies würde zu den Darstellungen "Süßen, DE" beziehungsweise "Süßen, DEU" führen, allerdings nur, wenn das Land in der Ursprungsversion in Englisch angegeben wird, also in der Form "Süßen, Göppingen, Baden-Württemberg, Germany".

===== Zeige XREF einer Person =====
Diese Option legt fest, ob die XREF einer Person direkt hinter dem Namen der Person ausgegeben werden soll.

Die Anzeige der XREF ist hilfreich, wenn das Diagramm schrittweise um weitere Familienzweige erweitert werden soll. Dann kann die XREF für eine oder mehrere Personen aus dem Diagramm abgelesen werden und für die nächste Erweiterung direkt in die Sammelliste unter „Einzubeziehende Personen“ eingetragen werden. Vor dem Drucken des Diagramms kann die Anzeige von XREF bei Bedarf wieder abgewählt werden.

===== Zeige Geburtsdatum =====
Hier wird festgelegt, ob das Geburtsdatum in die Ausgabe aufgenommen werden soll. Bei der Auswahl von "Jahr" wird nur das Geburtsjahr angezeigt, ansonsten wird das vollständiges Geburtsdatum ausgegeben.

===== Zeige Geburtsort =====
Diese Option legt fest, ob der Geburtsort in der Ausgabe angezeigt werden soll.

===== Zeige Sterbedatum =====
Hier wird festgelegt, ob das Datum des Todes im Diagramm angezeigt werden soll. Bei der Auswahl von "Jahr" wird nur das Jahr des Todes angezeigt, ansonsten wird das vollständige Sterbedatum ausgegeben.

===== Zeige Sterbeort =====
Diese Option legt fest, ob der Ort des Todes in der Ausgabe angezeigt werden soll.

===== Zeige XREF einer Familie =====
Diese Option legt fest, ob die XREF einer Familie ausgegeben werden soll.

===== Zeige Heiratsdatum =====
Hier wird festgelegt, ob das Heiratsdatum in der Ausgabe angezeigt werden soll. Bei der Auswahl von "Jahr" wird nur das Jahr der Heirat angezeigt, ansonsten wird das vollständige Hochzeitsdatum ausgegeben.

===== Zeige Heiratsort =====
Diese Option legt fest, ob der Ort der Eheschließung in der Ausgabe angezeigt werden soll.

===== Anzahl der Iterationen =====
Diese Option bezieht sich auf die Versuche von Graphviz, die Anzahl der Kreuzungen in der Grafik zu minimieren. Weitere Informationen dazu finden Sie in der Graphviz-Dokumentation.<ref>[https://graphviz.org/docs/attrs/mclimit/ Graphviz - Attributes - mclimit]</ref>

===== DPI (Punkte pro Zoll) =====
Bei der Erzeugung einer Grafikdatei, etwa vom Typ JPG, GIF oder PNG, führt diese Einstellung zu einer Ausgabe mit entsprechender Qualität. Je höher der Wert ist, desto besser ist die Qualität; aber es erhöht sich auch die Dateigröße entsprechend. Für die Ansicht am Bildschirm reichen 70 dpi bis 90 dpi, für die Ausgabe auf einem Drucker werden Werte zwischen 300 dpi und 600 dpi empfohlen.

Bei einer SVG- und einer PDF-Ausgabedatei hat der dpi-Wert keinen Einfluss auf die Auflösung bzw. Qualität, weil das Diagramm verlustfrei skalierbar gespeichert ist. Man beeinflusst mit diesem Parameter jedoch die Maße einer PDF-Seite. Dies ist nützlich, wenn etwa eine PDF-Datei auf einem Plotter ausgedruckt werden soll, der die Maße der Datei nur unverändert übernimmt. Dann kann man den dpi-Wert durch Ausprobieren so einstellen, dass die Maße der Datei dem Druckbereich des Plotters angepasst sind.

===== Abstand zwischen den Generationen =====
Diese Option bestimmt, wie groß der Abstand zwischen den Generationen in der Ausgabe sein soll. Der Standardwert liegt bei 100%. Kleinere Zahlen reduzieren bei der Ausgabe von links nach rechts den horizontalen Abstand der Personenkästchen, während größere Zahlen diese weiter auseinander schieben. Entsprechendes gilt bei der Ausgabe von oben nach unten für den vertikalen Abstand.

===== Abstand zwischen den Personen auf der selben Ebene =====
Mit dieser Option wird bestimmt, wie groß der Abstand zwischen den Personen in der gleichen Generation sein soll. Der Standardwert liegt bei 100%. Kleinere Zahlen verringern bei der Ausgabe von links nach rechts den vertikalen Abstand zwischen den Personenkästchen, während größere Zahlen sie weiter auseinander ziehen. Entsprechendes gilt bei der Ausgabe von oben nach unten für den horizontalen Abstand.

==== Ausgabe-Einstellungen ====
{{WT-ToDo|Grafik mit den Schaltflächen aktualisieren}}
[[Datei:WT_2.1_GVExport_Ausgabe-Einstellungen.png|rechts|mini|350px|Bedienmenü: Ausgabe-Einstellungen und Aktions-Buttons|verweis=Special:FilePath/WT_2.1_GVExport_Ausgabe-Einstellungen.png]]
In diesem Abschnitt können Sie eine Option für die Ausgabe festlegen.

===== Ausgabedatei-Typ =====
Mit dieser Option wird der Typ der Ausgabedatei festgelegt. Zur Verfügung stehen DOT, PNG, JPG, GIF, SVG, PDF und PS. Alle anderen Dateitypen als DOT erfordern die Installation von Graphviz auf dem Server. Der Ausgabetyp PDF wird empfohlen, da er die kleinsten Dateien liefert und da diese leicht skalierbar sind. Der gewünschte Typ der Ausgabedatei hat keine Relevanz für Darstellung des Diagramms im Browser, er wird nur beim Erzeugen der Ausgabedatei verwendet.

==== Aktions-Schaltflächen ====
Am unteren Rand des Bedienfeldes befinden sich stets sichtbar die drei Aktions-Schaltflächen, die in der obigen Grafik abgebildet sind.

===== Aktualisieren =====
Nach einem ''Klick'' auf die Schaltfläche "Aktualisieren" wird das Diagramm im Vorschaufenster erstellt. Wann immer Sie Optionen, wie etwa die Anzahl der Vorfahren-Generationen, geändert haben, ''klicken'' Sie erneut auf „Aktualisieren“, damit das Diagramm erneut dargestellt wird.

===== Herunterladen =====
Wenn die Schaltfläche "Herunterladen" ausgewählt wird, wird die Ausgabedatei erzeugt und dann heruntergeladen.

Wenn als Ausgabedatei-Typ "DOT" gewählt wurde, dann erfolgt diese Aktion lokal im Browser. Für alle anderen Ausgabedatei-Typen erfolgt die Erzeugung der Ausgabedatei auf dem Server. Dazu muss Graphviz auf dem Server installiert sein. Die heruntergeladene Datei kann dann ganz normal gedruckt werden. Für sehr große Grafiken, etwa 1 m mal 2 m, ist ein Plotter gut geeignet. Solche Grafiken können in spezialisierten Copy-Shops ausgegeben werden und sind in der Regel erheblich billiger, als gleich große Foto-Poster.

===== Einstellungen zurücksetzen =====
Für alle Optionen gibt es eine Standardeinstellung. Mit einem ''Klick'' auf die Schaltfläche "Einstellungen zurücksetzen" werden alle Optionen auf die Standardwerte gesetzt.

== Erzeugen einer druckbaren Darstellung, wenn Graphviz nicht auf dem Server installiert ist ==
{{WT-ToDo|Die Vorgehenskette mit DotEditor und Inkscape von der .dot zu .svg zu .pdf beschreiben, die Franz ausgeknobelt hat.}}

== Beispiele ==
{{WT-ToDo|Typischen Screenshot für "kombinierte" Darstellung mit Fotos und sehr große Datei als png/jpg einfügen.}}

== Anforderungen ==
Dieses Modul erfordert die webtrees-Version 2.1 oder höher.

Dieses Modul wurde mit der webtrees-Version 2.1 und allen verfügbaren Themen und allen anderen Erweiterungsmodulen getestet.

Für webtrees-Versionen vor 2.0.21 können Sie ein früheres [https://github.com/tillsc/GVExport Quell-Repository] ausprobieren, das aber für Versionen ab 2.0.22 abhängig von der verwendeten PHP-Version ggf. nicht mehr funktioniert und in der Funktionalität mit der aktuellen Version nicht vergleichbar ist.

=== Graphviz auf dem Server ===
Um druckbare PDF-, PNG-, GIF-, PS- oder JPG-Ausgaben zu erhalten, ist das Programm Graphviz in einer aktuellen Version auf dem Server erforderlich (siehe nachfolgender Abschnitt "[[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/GVExport#Installation von Graphviz auf dem Server|Installation von Graphviz auf dem Server]]"). Eine solche Installation wird aber wohl nur auf lokalen oder auf dedizierten Servern möglich sein.

== Installation ==
Bitte beachten Sie die folgenden Installationsanweisungen

* Laden Sie die neueste Release-Version von [https://github.com/Neriderc/GVExport/releases GitHub] herunter.
* Entpacken Sie das Erweiterungsmodul in das Verzeichnis <code>/modules_v4/GVExport</code> des webtrees-Webservers. Wenn dieses Verzeichnis bereits vorhanden ist, können Sie es einfach überschreiben.
* Melden Sie sich als Administrator bei webtrees an, gehen Sie zu Systemsteuerung / Module / Genealogie / Diagramme und suchen Sie das Modul. Es heißt "GVExport". Überprüfen Sie, ob es ein Häkchen für "Aktiviert" hat. Bearbeiten Sie diesen Eintrag, um die Zugriffsrechte für jeden Stammbaum festzulegen.
* Klicken Sie abschließend auf "Speichern", um die Konfiguration zu sichern.

=== Installation von Graphviz auf dem Server ===
Eine Installation von Graphviz auf dem webtrees-Server kommt nur dann in Frage, wenn Sie das Recht haben, dort Software zu installieren. Dies wird in der Regel nicht der Fall sein, wenn Sie für den webtrees-Server die Dienste eines Shared-Hosting-Anbieters nutzen. Sie benötigen einen Zugang auf der Kommandozeilen-Ebene des Servers (Shell). Es wird erwartet, dass sich Graphviz im Verzeichnis <code>/usr/bin/dot/</code> des Servers befindet.

Wenn Sie ein Debian-basiertes Betriebssystem (wie Ubuntu) ausführen, können Sie Graphviz installieren, indem Sie den Befehl <code>sudo apt install graphviz</code> ausführen.

Wenn Sie Docker verwenden, können Sie den Prozess Dockerfile apt-install so aktualisieren, dass er Graphviz enthält, oder Sie könnten einmalig das folgende Kommando ausführen <code>docker exec -it webtrees apt update && docker exec -it webtrees apt install graphviz</code>. Beachten Sie jedoch, dass dieser Befehl zwar Graphviz im Container installiert, aber wenn Sie später den Container neu erstellen, müssen Sie diesen Befehl erneut ausführen.

== Upgrade ==
Ersetzen Sie zum Aktualisieren einfach die bestehenden Dateien durch diejenigen aus der neuesten Version.

== Übersetzung ==
Dieses Erweiterungsmodul verwendet das po/mo-System für Übersetzungen in andere Sprachen. Es wird eine Online-Übersetzungsmöglichkeit bereit gestellt: [https://poeditor.com/join/project/YqPRBXZnlf PO Editor project].

Die Sprachen Deutsch, Englisch, Katalanisch, Niederländisch, Russisch und Spanisch sind verfügbar.

Für frühere Versionen dieses Moduls lagen auch Übersetzungen in folgende Sprachen vor: Französisch, Italienisch, Polnisch und Ungarisch.

== Unterstützung ==
Sie können Fehler oder Wünsche für Erweiterungen auf der [https://github.com/Neriderc/GVExport/issues "issue"-Seite bei GitHub] melden,

Sie können bei Fragen auch das [https://www.webtrees.net/index.php/en/forum webtrees-Forum] mit dem Themenbereich "Customising" nutzen.

== Lizenz ==
* © 2022 Neriderc
* Frühere Autoren
** Ferenc Kurucz
** [https://github.com/pceres Pasquale Ceres]
** [https://github.com/IJMacD Iain MacDonald]
** [https://github.com/tillsc Till Schulte-Coerne]
* Abgeleitet von webtrees - © 2022 webtrees-Entwicklungsteam

Dieses Programm ist freie Software: Sie können es unter den Bedingungen der GNU General Public License, veröffentlicht von der Free Software Foundation, entweder in Version 3 der Lizenz oder (nach Ihrer Wahl) jeder späteren Version, weitergeben und/oder modifizieren.

Dieses Programm wird in der Hoffnung verteilt, dass es nützlich sein wird, aber OHNE JEGLICHE GEWÄHRLEISTUNG; ohne auch nur die stillschweigende Gewährleistung der MARKTFÄHIGKEIT oder EIGNUNG FÜR EINEN BESTIMMTEN ZWECK. Weitere Einzelheiten finden Sie in der GNU General Public License, die Sie unter http://www.gnu.org/licenses/ finden.

== Einzelnachweise ==
<references />

[[Kategorie:Webtrees]]

Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Großfamilie

2023-03-14T20:40:22Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Abschnitt 8.10.1|info=1}}{{WT-Inhaltsverzeichnis|Kapitel 8|E|Abschnitt 8.10|Abschnitt 8.10.1}}

Das Modul stellt die Großfamilie zu einer Person in einem Reiter auf der Personenseite dar. Für die Darstellung können Urgroßeltern, Großeltern, Eltern, Schwiegereltern, Onkel, Tanten, Cousins und Cousinen, Partner, Geschwister, Neffen und Nichten, Kinder, Enkelkinder und noch weitere Personengruppen ausgewählt werden.

== Steckbrief ==
* Modulname: Großfamilie (hh_extended_family)
* Autor: Hermann Hartenthaler
* Passende webtrees-Versionen: 2.1
* Speicherort: [https://github.com/hartenthaler/hh_extended_family GitHub]
* Modulkategorie: Personenseite
* Modulfunktion: Reiter "Großfamilie"

== Beschreibung ==
[[Datei:WT_2.1_Erweiterungsmodul_Großfamilie_Kopf.png|alternativtext=|rechts|600x600px]]
Dieses Modul stellt den Kern und die erweiterte Familie eines Probanden vor. Es basiert auf dem Verwandtschaftssystem der Eskimos<ref>{{wikipedia-Link|Verwandtschaftssystem#Eskimosystem}}</ref>.

Der Benutzer kann die angezeigten Ergebnisse filtern, sofern der Administrator dies so eingestellt hat. Die Filtermöglichkeiten umfassen

* Geschlecht (durch Auswahl der Optionen für männlich ♂ / weiblich ♀ / unbekannt <big>◦</big>)
* nur lebende bzw. nur verstorbene Personen (durch Auswahl der entsprechenden Optionen).
Falls es der Administrator so konfiguriert hat, hat der Benutzer die Möglichkeit die Mitglieder der Großfamilie in den Sammelbehälter zu kopieren (Personen, Familien und alle zugehörigen Quellen-, Ortsdatensätze, etc). Dies erlaubt unter Nutzung des Erweiterungsmoduls "[[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule/Sammelbehälter|Sammelbehälter]]" den GEDCOM-Export oder die Visualisierung der Großfamilie mit den Erweiterungsmodulen [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule/TAM und Lineage|"TAM", "Lineage"]] oder [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/GVExport|GVExport]].

=== Bestandteile der Großfamilie ===
Die standardmäßige Präsentationsreihenfolge der Großfamilienteile orientiert sich an der Generation der Personen in diesem Teil, relativ zum Probanden
{| class="wikitable"
|+
!Familienteil
!Generation
|-
|Urgroßeltern
| +3
|-
|Großeltern
| +2
|-
|Onkel und Tanten
| +1
|-
|Angeheiratete Onkel und Tanten
| +1
|-
|Eltern
| +1
|-
|Schwiegereltern
| +1
|-
|Gegenschwiegereltern
| 0
|-
|Partner und Partnerketten
|0
|-
|Geschwister
|0
|-
|Schwäger und Schwägerinnen
|0
|-
|Schwippschwäger und Schwippschwägerinnen
|0
|-
|Cousins und Cousinen
|0
|-
|Neffen und Nichten
| -1
|-
|Kinder
| -1
|-
|Schwiegerkinder
| -1
|-
|Enkelkinder
| -2
|-
|Schwiegerenkelkinder
| -2
|}
Diese Reihenfolge kann aber durch den Administrator flexibel angepasst werden und es können durch ihn auch einzelne Teile der Großfamilie ausgeblendet werden.

=== Prinzipieller Aufbau eines Großfamilienteils ===
Jeder Block für einen Familienteil hat einen ähnlichen Aufbau. Im Kopf steht der Name des Familienteils (etwa "Urgroßeltern"). Danach erfolgt eine Angabe wie viele verschiedene Personen zu diesem Teil der Großfamilie gehören (aus der Sicht des Probanden); diese Anzahl wird nach Geschlecht aufgeschlüsselt.

Wenn der Administrator es vorgesehen hat, dann wird der Familienteil noch durch zwei Parameter gekennzeichnet, die gegebenenfalls am rechten Rand aufgeführt werden

* Generationenabstand zum Probanden: dieser ist etwa für Kinder "-1", für Großeltern "+2".
* Verwandtschaftskoeffizient<ref>{{wikipedia-Link|Verwandtschaftskoeffizient}}</ref>: Dieser Koeffizient zeigt den Grad der genetischen Verwandtschaft zum Probanden an. Er ist etwa für Kinder 50%, für Enkelkinder 25%.

{{WT-ToDo|Den prinzipiellen Aufbau der Anzeige beschreiben (Gliederung in Kästen, Gruppierung nach Familien, ...)}}
{{WT-ToDo|Partnerketten mit zwei Screenshots beschreiben (einmal die Textform und ergänzend die TAM-Darstellung).}}{{WT-ToDo|Labels beschreiben}}

=== GEDCOM-Datensätze zur Kennzeichnung spezieller Situationen ===
Hier sind einige Beispiele zur Gestaltung von GEDCOM-Datensätzen, die die oben beschriebenen speziellen Situationen wiedergeben. Solchermaßen gestaltete GEDCOM-Datensätze führen dazu, dass den betreffenden Personen ein Etikett zugeordnet wird, das auf die spezielle Situation hinweist (wie etwa „adoptiertes Kind“, „Pflegekind“, „Drilling“, „totgeboren“ oder „Verbindungsproblem“ ).

==== Drilling ====
Man kann Drillinge dadurch kennzeichnen, dass man von jedem der Drillinge zu jedem anderen verweist.

<code>1 BIRT

2 _ASSO @I123@

3 RELA triplett</code>

oder

<code>1 ASSO @I123@

2 RELA triplett</code>

==== Person ist "tot geboren" oder "als Säugling gestorben" ====
<code>1 BIRT

2 AGE STILLBORN</code>

oder

<code>1 DEAT

2 AGE INFANT</code>

==== Besonderer Verknüpfungsstatus zur Elternfamilie ====
Der Status der Verknüpfung eines Kindes mit seiner Elternfamilie kann die Werte "angefochten", "widerlegt" oder "bewiesen" erhalten.

<code>1 FAMC @F123@

2 STAT CHALLENGED</code>

== Bedienoberfläche ==
[[Datei:WT 2.1 Erweiterungsmodul Großfamilie Verwaltungsmenü.png|alternativtext=Verwaltungsmenü|rechts|600x1200px|Verwaltungsmenü xxx]]

Neben der Bedienung des bereits oben beschriebenen

* Filtermenüs und
* der Schaltfläche zum Kopieren der Großfamilie in den Sammelbehälter und
* dem Nutzen der diversen Links in den Personentabellen

gibt es keine weiteren Interaktionsmöglichkeiten für die Benutzer dieses Moduls.

=== Verwaltungsmenü ===
Der Administrator kann im Verwaltungsmenü (siehe Abbildung rechts) über diverse Einstellungen entscheiden.

* Welche Großfamilienteile sollen gezeigt werden und in welcher Reihenfolge sollen diese präsentiert werden; die Familienteile können mit einem Klick auf die Pfeile nach oben oder unten verschoben werden.
* Sollen die Filteroptionen (Geschlecht, nur lebende bzw. nur verstorbene Personen) für Benutzer angezeigt werden?
* Soll am Ende des Reiters ein zusammenfasender Abschnitt mit einigen Kenngrößen zur Großfamilie angezeigt werden?
* Wie sollen leere Teile der Großfamilie dargestellt werden? Es gibt drei verschiedene Möglichkeiten: entweder werden leere Familienteile am vorgesehenen Platz angezeigt (mit einem Hinweis, dass es dazu keine passenden Personen gibt), oder der leere Familienteil wird bei der Ausgabe unterdrückt, wobei allerdings im zusammenfassenden Abschnitt am Ende des Reiters ein entsprechender Hinweis erfolgt, oder der leere Teil wird gänzlich unterdrückt.
* Sollen die Mitglieder der Partnerketten zur erweiterten Familie gezählt werden? Die Partnerketten sind in ihrer Darstellung etwas besonderes und wenn sich in mehreren Schritten Partner an Partner reihen, wird man im Normalfall die entfernten Partner von Partnern nicht mehr als Teile der Großfamilie betrachten. Wenn man hier "nein" auswählt, dann werden die zusätzlichen Mitglieder in den Partnerketten nicht zur Gesamtzahl der Mitglieder der erweiterten Familie gezählt (die direkten Partner und deren Partner aus dem Familienteil "Partner" gehören aber zur Großfamilie) . Und die darüber hinausgehenden Personen und Familien werden auch nicht ausgewählt, wenn ein Anwender sich entscheidet, die erweiterte Familie in den Sammelbehälter zu kopieren. Aber auch in diesem Fall können diese Personen und Familien in den Sammelbehälter kopiert werden, indem ein spezieller Menüpunkt im Erweiterungsmodul [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Sammelbehälter|Sammelbehälter]] ausgewählt wird: "füge Partnerketten für eine Person hinzu". Dieser Entscheidungspunkt ist nur dann relevant, wenn man in der Tabelle der Familienteile ausgewählt hat, dass die Partnerketten ein Teil der erweiterten Familie sind.
* Soll eine Kurzform oder der vollständige Name des Probanden angezeigt werden? Der vollständige Name besteht aus dem Vor- und dem Nachnamen, die Kurzform ist etwa der Rufname, der Spitzname oder der erste Vorname. Wenn für den Probanden Namensbestandteile fehlen, wird eine entsprechend verkürzte Namensform verwendet.
* Sollen in besonderen Situationen Etiketten angezeigt werden? Die Etiketten können mit Bezeichnungen wie „adoptiertes Kind“, „Pflegekind“, „Drilling“, „totgeboren“ oder „Verbindungsproblem“ beschriftet sein und werden an Personen angeheftet um auf besondere Situationen hinzuweisen. Wie diese Situationen beschrieben werden, wird im nachfolgenden Abschnitt "[[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Großfamilie#GEDCOM-Datensätze zur Kennzeichnung spezieller Situationen|GEDCOM-Datensätze zur Kennzeichnung spezieller Situationen]]" dargestellt.
* Sollen Parameter für jeden Teil der Großfamilie angezeigt werden? Diese Parameter kennzeichnen den jeweiligen Familienteil durch den Generationenabstand zum Probanden und den Verwandtschaftskoeffizienten für die biologisch verwandten Personen in diesem Familienteil.
* Soll das kompakte Design verwendet werden? Im kompakten Design wird für eine Person nur der Name und die Lebensspanne in Jahren angezeigt. In der alternativen angereicherte Version wird auch ein Foto sowie die vollständige Geburts- und Todesinformationen angezeigt.
* Soll ein Button "In den Sammelbehälter kopieren" angezeigt werden oder wird diese Funktion nicht angeboten? Wenn der Button angezeigt wird, kann der Nutzer entscheiden, dass er die Mitglieder der Großfamilie in den Sammelbehälter kopieren möchte (ggf. in der gefilterten Zusammenstellung). Das macht aber natürlich nur Sinn, wenn der Sammelbehälter für den Nutzer als zugreifbar konfiguriert ist.

== Anforderungen ==
Dieses Modul erfordert die webtrees-Version 2.1 oder höher. Es gibt auch noch eine ältere, nicht mehr gepflegte Version für die Version 2.0.

Dieses Modul wurde mit der webtrees-Version 2.1 und allen verfügbaren Themen und allen anderen Erweiterungsmodulen getestet.

== Installation ==
Bitte beachten Sie die folgenden Installationsanweisungen

* Laden Sie die neueste Version von [https://github.com/hartenthaler/hh_extended_family/releases GitHub] herunter.
* Entpacken Sie das Erweiterungsmodul in das Verzeichnis <code>/modules_v4/hh_extended_family</code> des webtrees-Webservers. Wenn dieses Verzeichnis bereits vorhanden ist, können Sie es einfach überschreiben.
* Melden Sie sich als Administrator bei webtrees an, gehen Sie zu Systemsteuerung/Module/Personenseite/Reiter und suchen Sie das Modul. Es heißt "Großfamilie". Durch einen Klick auf den Schraubenschlüssel können sie die Einstellungen des Moduls verändern. Überprüfen Sie, ob es ein Häkchen für "Aktiviert" hat. Bearbeiten Sie diesen Eintrag, um die Zugriffsrechte für jeden Stammbaum festzulegen und den Menüpunkt nach ihren Wünschen zu positionieren.
* Klicken Sie abschließend auf "Speichern", um die Konfiguration zu sichern.

== Upgrade ==
Ersetzen Sie zum Aktualisieren einfach die bestehenden Dateien durch diejenigen aus der neuesten Version.

== Übersetzung ==
Sie können helfen, dieses Modul zu übersetzen. Die Sprachinformationen sind in der Datei <code>resources/lang/ExtendedFamilyTranslation.php</code> abgelegt. Der deutsche Teil ist der aktuellste und kann als Grundlage für Ihre Übersetzung verwendet werden. Verwenden Sie einen lokalen Editor wie Notepad++, um die Übersetzungen zu erstellen. Das Zurücksenden geht per [https://github.com/hartenthaler/hh_extended_family/pulls Pull-Request in GitHub] (wenn Sie wissen wie das geht) oder per [mailto:git@hartenthaler.de E-Mail an den Programmautor]. Aktualisierte Übersetzungen werden in der jeweils nächsten Version dieses Moduls enthalten sein.

Folgende Sprachen werden neben Deutsch und Englisch unterstützt

* Chinesisch (traditionelle und vereinfachte Version)
* Französisch
* Hindi
* Italienisch
* Katalanisch
* Niederländisch
* Norwegisch
* Russisch
* Slowakisch
* Spanisch
* Tschechisch
* Ukrainisch
* Vietnamesisch.

== Unterstützung ==
Sie können Fehler oder Wünsche für Erweiterungen auf der [https://github.com/hartenthaler/hh_extended_family/issues "issue"-Seite bei GitHub] melden,

Sie können bei Fragen auch das [https://www.webtrees.net/index.php/en/forum webtrees-Forum] mit dem Themenbereich "Customising" nutzen.

== Lizenz ==
* © 2022 Hermann Hartenthaler
* GNU General Public License V3 (abgeleitet von webtrees - © 2022 webtrees-Entwicklungsteam)

== Einzelnachweise ==
<references />

[[Kategorie:Webtrees]]

Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule

2023-03-14T20:40:12Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Abschnitt 8.10|info=1|sticksort=1}}{{WT-Inhaltsverzeichnis|Kapitel 8|D|Abschnitt 8.10}}

Erweiterungsmodule werden aus der Benutzergemeinschaft zur Ergänzung des Kerns von webtrees programmiert. Diese [[Webtrees Handbuch/Anleitung für Administratoren#Module|Module]] stellen neue Funktionen zur Verfügung oder erweitern die Darstellungsmöglichkeiten.

Eine Übersicht von Erweiterungsmodulen findet man auf der offiziellen [https://webtrees.net/download/modules Seite] von webtrees. Ergänzend kann man bei [https://github.com/ GitHub] nach solchen Modulen suchen, da dort die meisten Erweiterunsgmodule publiziert werden. Dazu gibt man auf der GitHub-Seite im Suchfeld "webtrees" ein und selektiert dann "All Github".

Die Erweiterungsmodule werden wie alle Module des webtrees-Kerns in die folgenden Kategorien eingeteilt
* '''Genealogie'''
** Menü-Module ergänzen die Menüpunkte um neue Funktionen
** Diagramm-Module verbessern die grafischen Darstellungen von genealogischen Daten oder ergänzen ganz neue Darstellungen
** Listen-Module verbessern oder ergänzen die Darstellungen von genealogischen Daten in Listenform
** Berichts-Module verbessern oder ergänzen die genealogischen Berichte
** Datenkorrektur-Module
* '''Webseite'''
** Fußzeilen-Module
** Tracking- und Analyse-Module
** Themen-Module, die alternative Darstellungen der Bedienoberfläche von webtrees ergänzen
** Sprachen-Module
* '''Startseite'''
** Block-Module
* '''Personenseite'''
** Reiter-Module
** Navigationsleisten-Module, die etwa eine Sosa-Stradonitz-Nummer einblenden oder eine Suchmöglichkeit in diversen genealogischen Systemen erlauben
** Module mit historischen Ereignisdaten, die den Lebenslauf einer Person mit historischen Daten unterlegen und so eine historische Einordnung erlauben
* '''Sonstige'''
** diverse sonstige Erweiterungsmodule, die einzelne Darstellungselemente modifizieren oder die eine Anbindung an externe Datenquellen realisieren
Erweiterungsmodule werden vom Webmaster installiert (siehe Abschnitt "[[Webtrees Handbuch/Anleitung für Webmaster#Installation%20von%20Erweiterungsmodulen|Installation von Erweiterungsmodulen]]" im Kapitel "[[Webtrees Handbuch/Anleitung für Webmaster|Anleitung für Webmaster]]"); dazu kopiert dieser den Modulcode ins webtrees-Verzeichnis <code>modules_v4</code>. Die Erweiterungsmodule können vom Verwalter oder Administrator aktiviert oder deaktiviert werden; manche Erweiterungsmodule erlauben zusätzlich, wie bei anderen Modulen auch, eine Konfiguration durch den Verwalter oder den Administrator.

Die Anpassung vorhandener webtrees-Module an eigene Bedürfnisse ist mit ein wenig Einarbeitungszeit in eingeschränkter Form auch für Nicht-Programmierer möglich; eine Neuentwicklung setzt Kenntnisse im objektorientierten Programmieren von Web-Anwendungen voraus. Näheres dazu finden Sie im Abschnitt "[[Webtrees Handbuch/Entwicklungsumgebung#Anpassung%20und%20Entwicklung%20eigener%20Module|Anpassung und Entwicklung eigener Module]]" im Kapitel "[[Webtrees Handbuch/Entwicklungsumgebung#Anpassung%20und%20Entwicklung%20eigener%20Module|Entwicklungsumgebung]]".

== Übersicht über bekannte Erweiterungsmodule ==
Die folgende Tabelle enthält eine Übersicht über einige der verfügbaren Erweiterungsmodule.

<div class="stickysorttablewrapperhc1">
{| class="wikitable sortable"
|+ Übersicht von Erweiterungsmodulen
|-
! Name || Autor || Download-Link || Kategorie || Funktion || Beschreibung || Kompatibilität
|-
| [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Großfamilie|hh_extended_family]] || Hartenthaler ||[https://github.com/hartenthaler/hh_extended_family GitHub] || Personenseite || Reiter "Großfamilie" || Die Großeltern, Eltern, Schwiegereltern, Onkel, Tanten, Cousins und Cousinen, Partner, Geschwister, Neffen und Nichten, Kinder und Enkelkinder einer Person werden dargestellt. || data-sort-value="2.1" | 2.0 oder 2.1
|-
| [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Sammelbehälter|huhwt-cce]] || Heinrich / Hartenthaler || [https://github.com/huhwt/huhwt-cce GitHub] || Genealogie || Menü "[[Webtrees_Handbuch/Anleitung_für_Mitglieder#Sammelbehälter|Sammelbehälter]]" || Der Standard-[[Webtrees_Handbuch/Anleitung_für_Mitglieder#Sammelbeh.C3.A4lter|Sammelbehälter]] wird durch ein erweitertes Modul ersetzt, das die Daten nicht nur als GEDCOM herunterladen kann, sondern diese auch visualisieren kann. Zusätzlich können globale Datensätze dem [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Sammelbeh.C3.A4lter|Sammelbehälter]] hinzugefügt werden, etwa alle Heiratsketten oder alle Ahnenkreise in einen Stammbaum. ||data-sort-value="2.1"| 2.0 oder 2.1
|-
| [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/TAM_und_Lineage|huhwt-wttam]] || Heinrich ||[https://github.com/huhwt/huhwt-wttam GitHub] || Sonstige || Diagramm "TAM" || TAM (Topographic Attribute Maps) ist ein Knoten-Kanten-Diagramm mit einer überlagerten Zeitdarstellung in einem zusätzlichen Browserfenster, das die Daten im [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Sammelbeh.C3.A4lter|Sammelbehälter]] visualisieren kann.||data-sort-value="2.1"| 2.0 oder 2.1
|-
|[[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/TAM_und_Lineage|huhwt-wtlin]] || Heinrich ||[https://github.com/huhwt/huhwt-wtlin GitHub] || Sonstige || Diagramm "Lineage" || Lineage ist ein Knoten-Kanten-Diagramm in einem zusätzlichen Browserfenster, das die Daten im [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Sammelbeh.C3.A4lter|Sammelbehälter]] visualisieren kann. Die Daten können in einem Baum, in einer Zeitleiste oder nach Namensgruppen sortiert dargestellt werden. ||data-sort-value="2.1"| 2.1
|-
| [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Kundenindividuelle Beziehungsbezeichnungen|hh_relation_is_descriptor]] || Hartenthaler ||[https://github.com/hartenthaler/hh_relation_is_descriptor GitHub] || Sonstige || Nutzerindividuelle Beziehungsbezeichnungen || Wenn von einer Person oder einem Ereignis auf eine andere Person verwiesen wird, gibt es vordefinierte Bziehungsbezeichnungen, wie etwa Pate oder Trauzeuge. Das Modul erlaubt es diese Liste um weitere Begriffe zu erweitern (etwa Vermieter). ||data-sort-value="2.1"| 2.1
|-
| wt-UnlinkedIndividual || dis-maja ||[https://github.com/dis-maja/wt-UnlinkedIndividual GitHub] || Startseite || Block "Unverbundene Person" || Bietet eine Funktion an, die das Anlegen einer unverbundenen Person im Baum ermöglicht.||data-sort-value="2.0"| 2.0
|-
| fancy-research-links || JustCarmen ||[https://github.com/JustCarmen/webtrees-fancy-research-links GitHub] || Personenseite || Navigationsleiste "Research Links" || Blendet im Navigationsmenü einen Reiter mit Links zu sehr vielen Internet-Portalen ein, so dass man dort einfach und gezielt nach den Daten zu einer Person suchen kann.||data-sort-value="2.1"| 2.0 oder 2.1
|-
| Treeview-Extended || Heinrich ||[https://github.com/huhwt/huhwt-xtv GitHub] || Genealogie || Diagramm "Interaktives Sanduhrdiagramm XT" || Alternative zu dem existierenden Modul "Interaktives Sanduhrdiagramm" mit zusätzlichen Informationen und einer verbesserten Auswahl der anzuzeigenden Personen. Teilbäume können auf- und zugeklappt werden.||data-sort-value="2.1"| 2.0 und 2.1
|-
| [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/GVExport|GVExport]] || Neriderc || [https://github.com/Neriderc/GVExport GitHub] || Genealogie || Diagramm "GVExport" || Ein vollständiger Baum mit Partnern, Geschwistern, Vorfahren und Nachkommen kann angezeigt werden. Als Quelle für die Visualisierung kann auch der [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Sammelbeh.C3.A4lter|Sammelbehälter]] verwendet werden. || data-sort-value="2.1" | 2.1
|-
| Topola || PeWu || [https://github.com/PeWu/topola-webtrees GitHub] || Genealogie || Diagramm "Interaktiver Baum (Topola)" || Ein vollständiger Baum aus Vorfahren und Nachkommen wird angezeigt. Dieser ist interaktiv, so dass der betrachtete Schwerpunkt frei gewählt werden kann. Die genealogischen Daten sind ohne Beachtung der Sicherheitseinstellungen in webtrees für Internet-Suchmaschinen sichtbar, so dass hier gravierende Datenschutzbedenken bestehen.|| data-sort-value="2.1" | 2.0 und 2.1
|-
| Family navigator - show parent families last || Chris || [https://github.com/tronsmit/fam-nav-parents-last GitHub] || Personenseite || Navigationsleiste "Familienlotse" || Im Block Familienlotse in der Navigationsleiste werden - im Gegensatz zum Standard - die Familien des Probanden mit seinen Partnern/innen und den eigenen Kindern vor den Familien der Eltern des Probanden dargestellt.||data-sort-value="2.1"| 2.0 und 2.1
|-
| Multi Tree View || Heinrich || [https://github.com/huhwt/huhwt-mtv GitHub] || Sonstige || Verwaltung "Duplikate suchen" || Bei der Überprüfung von gefundenen Duplikaten in einem Stammbaum werden die interaktiven Sanduhrdiagramme dieser Personen untereinander zum Vergleich dargestellt.||data-sort-value="2.1"| 2.0 und 2.1
|-
| [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Nachkommentafel|webtrees-descendants-chart]] || Sonntag (magic-sunday) || [https://github.com/magicsunday/webtrees-descendants-chart GitHub] || Genealogie || Diagramm "Nachkommentafel" || Alternative zu dem existierenden Diagramm "Nachkommen" mit reduzierten Informationen aber mehr darstellbaren Generationen und skalierbarer Grafik.||data-sort-value="2.1"| 2.0 oder 2.1
|-
| SA-history || Chris || [https://github.com/tronsmit/SA-history-4-webtrees GitHub] || Personenseite || [[Webtrees Handbuch/Anleitung für Administratoren/Module#Historische_Ereignisse|Historische Ereignisse]] || Historische Daten zu Ereignissen in Südafrika können in die Lebensgeschichte einer Person eingeblendet werden.||data-sort-value="2.1"| 2.0 und 2.1
|-
| webtrees-branch-statistics || squatteur || [https://github.com/squatteur/webtrees-branch-statistics GitHub] || Genealogie || Diagramm "Generationenstatistik" || Zusätzliches Diagramm, das anzeigt wie viele Personen pro Generation in der Reihe der Vorfahren einer Person erfasst worden sind.||data-sort-value="2.1"| 2.0 und 2.1
|-
| jp-theme-colors || Prause || [https://github.com/jpretired/jp-theme-colors GitHub] || Webseite || Themen "Jp-barvy" || Ersatz für das Standardthema colors: zeigt zu den Menü-Icons auch noch die beschreibenden Texte an.||data-sort-value="2.1"| 2.0 und 2.1
|-
| [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Handbuch|jp-main-menu-manual]] || Prause || [https://github.com/jpretired/jp-main-menu-manual GitHub] || Webseite || Menü "Handbuch" || Ergänzung eines Hauptmenüpunktes mit einem Link zu einem Handbuch für webtrees.|| data-sort-value="2.1" | 2.1
|-
| jc-simple-menu-1 || JustCarmen || [https://github.com/JustCarmen/webtrees-simple-menu GitHub] || Webseite || Menü || Ergänzung eines Hauptmenüpunktes mit einer Webseite.||data-sort-value="2.1"| 2.0 und 2.1
|-
| jc-simple-footer-1 || JustCarmen || [https://github.com/JustCarmen/webtrees-simple-footer GitHub] || Webseite || Fußzeile || Über einen Eintrag in den Fußzeilen kann eine einfach zu bearbeitende Seite aufgerufen werden.||data-sort-value="2.1"| 2.1
|-
| [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Vorfahrentafel|webtrees-pedigree-chart]] || Sonntag (magic-sunday) || [https://github.com/magicsunday/webtrees-pedigree-chart GitHub] || Genealogie || Diagramm "Vorfahrentafel" || Alternative zur existierenden Vorfahrentafel mit reduzierten Informationen aber mehr darstellbaren Generationen.|| data-sort-value="2.1" | 2.0 oder 2.1
|-
| webtrees-reminder || UksusoFF || [https://github.com/UksusoFF/webtrees-reminder GitHub] || Sonstige || Sonstige || Erinnerung über anstehende Geburtstage per e-Mail.|| data-sort-value="2.1" | 2.0 oder 2.1
|-
| [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Justlight|jc-theme-justlight]] || JustCarmen || [https://github.com/JustCarmen/webtrees-theme-justlight GitHub] || Webseite || Themen "JustLight" || Zusätzliches [[Webtrees_Handbuch/Anleitung_für_Besucher#Thema|Thema]] mit weißem oder schwarzem Hintergrund und klaren, einfachen Formatelementen.||data-sort-value="2.1"| 2.0 oder 2.1
|-
| [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Justlight|jc-fancy-treeview]] || JustCarmen || [https://github.com/JustCarmen/webtrees-fancy-treeview GitHub] || Personenseite, Genealogie || Reiter "Nachkommen und Vorfahren", Menü "Fancy Treeview" || Eine Auflistung der Vorfahren oder Nachkommen einer Person in einer erzählenden Darstellung.||data-sort-value="2.1"| 2.1
|-
| jc-fancy-imagebar || JustCarmen || [https://github.com/JustCarmen/webtrees-fancy-imagebar GitHub] || Sonstige || Webseite || Dekorative Leiste im Kopf der Webseite mit Fotos aus dem jeweiligen Stammbaum.||data-sort-value="2.1"| 2.0 oder 2.1
|-
| dk-epidemier, dk-konflikter, dk-politik, dk-regenter || Rasmussen || [https://github.com/filicis/paradiso GitHub] || Personenseite || [[Webtrees Handbuch/Anleitung für Administratoren/Module#Historische_Ereignisse|Historische Ereignisse]] || Historische Daten zu Epidemien, Konflikten, politischen Ereignissen und Herrschern in Dänemark können in die Lebensgeschichte einer Person eingeblendet werden.||data-sort-value="2.1"| 2.0 und 2.1
|-
| finnish-historical-facts || ardhtu || [https://github.com/ardhtu/finnish-historical-facts GitHub] || Personenseite || [[Webtrees Handbuch/Anleitung für Administratoren/Module#Historische_Ereignisse|Historische Ereignisse]] || Historische Daten zu Ereignissen in Finnland können in die Lebensgeschichte einer Person eingeblendet werden.||data-sort-value="2.1"| 2.0 und 2.1
|-
| swiss-historic-events || Hartenthaler || [https://github.com/hartenthaler/swiss-historic-events GitHub] || Personenseite || [[Webtrees Handbuch/Anleitung für Administratoren/Module#Historische_Ereignisse|Historische Ereignisse]] || Historische Daten zu Ereignissen in der Schweiz können in die Lebensgeschichte einer Person eingeblendet werden.||data-sort-value="2.1"| 2.0 und 2.1
|-
| german chancellors presidents || Hartenthaler || [https://github.com/hartenthaler/german-chancellors-presidents GitHub] || Personenseite || [[Webtrees Handbuch/Anleitung für Administratoren/Module#Historische_Ereignisse|Historische Ereignisse]] || Historische Daten zu den Bundespräsidenten und Bundeskanzler der Bundesrepublik Deutschland seit 1949 können in die Lebensgeschichte einer Person eingeblendet werden.||data-sort-value="2.1"| 2.0 und 2.1
|-
| german wars battles worldwide || Hartenthaler || [https://github.com/hartenthaler/german-wars-battles-worldwide GitHub] || Personenseite || [[Webtrees Handbuch/Anleitung für Administratoren/Module#Historische_Ereignisse|Historische Ereignisse]] || Historische Daten zu den weltweiten Kriegen und Schlachten seit dem Jahr 900 können in die Lebensgeschichte einer Person eingeblendet werden.||data-sort-value="2.1"| 2.0 und 2.1
|-
| argon || jchue || [https://github.com/jchue/argon-webtrees-theme GitHub] || Webseite || Themen "Argon" || Zusätzliches [[Webtrees_Handbuch/Anleitung_für_Besucher#Thema|Thema]], das eine sehr klare Darstellung zum Ziel hat (basiert auf dem Argon-Design-System).||data-sort-value="2.1"| 2.1
|-
| argon-Light || Galli (06Games) ||[https://github.com/06Games/Webtrees-ArgonLight GitHub] || Webseite || Themen "Argon-Light" || Zusätzliches [[Webtrees_Handbuch/Anleitung_für_Besucher#Thema|Thema]], das eine sehr klare Darstellung zum Ziel hat (basiert auf dem Argon-Design-System) und sehr gut kompatibel mit anderen Modulen ist.||data-sort-value="2.1"| 2.0 und 2.1
|-
| webtrees-theme-modern || JessewebDotCom ||[https://github.com/JesseWebDotCom/webtrees-theme-modern GitHub] || Webseite ||Themen "modern" || Zusätzliches modernes [[Webtrees_Handbuch/Anleitung_für_Besucher#Thema|Thema]] mit mehreren Farbpaletten, das vor allem unterschiedlich große Bildschirme sehr gut unterstützt.|| data-sort-value="2.1" | 2.1
|-
| custom-css || Peters (makitso) || [https://github.com/makitso/custom-css GitHub] || Sonstige || Themen || Passt die Darstellung in allen webtrees-Themen an (vor allem zur Nutzung auf großen Bildschirmen); Schriftgrößen und Abstände zwischen grafischen Elementen werden verkleinert.||data-sort-value="2.1"| 2.0 und 2.1
|-
| faces || UksusoFF || [https://github.com/UksusoFF/webtrees-faces GitHub] || Personenseite || Reiter "Faces" || Auf Fotos, auf denen mehrere Personen abgebildet sind, können einzelne Bereiche der dort dargestellten Person zugeordnet werden.||data-sort-value="2.1"| 2.0 oder 2.1
|-
| myartjaub_ruraltheme || Jaubart || [https://github.com/jon48/webtrees-theme-rural GitHub] || Webseite || Themen "Rural" || Zusätzliches [[Webtrees_Handbuch/Anleitung_für_Besucher#Thema|Thema]], das eine erdverbundene und ökologisch orientierte Darstellung zum Ziel hat.||data-sort-value="2.1"| 2.0 oder 2.1
|-
| [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/vesta classic look and feel|vesta classic look and feel]] || Cissée (ric2015) || [https://github.com/vesta-webtrees-2-custom-modules/vesta_classic_laf GitHub] || Sonstige || Themen || Gestaltet die Oberfläche von webtrees kompakter und greift in alle webtrees-Themen ein. Dadurch wird ein Erscheinungsbild erzeugt, das näher an der Version 1 liegt. Zusätzlich kann die XREF-Vergabe wie in Version 1 erfolgen (I###, F### statt X###).|| data-sort-value="2.1" | 2.0 und 2.1
|-
| [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/vesta clippings cart|vesta clippings cart]] || Cissée (ric2015) || [https://github.com/vesta-webtrees-2-custom-modules/vesta_clippings_cart GitHub] || Genealogie || Menü "[[Webtrees_Handbuch/Anleitung_für_Mitglieder#Sammelbeh.C3.A4lter|Sammelbehälter]]" || Erweiterung des Sammelbehälters um die Möglichkeit gemeinsame Ortsdatensätze oder auch alle Bewohner eines Ortes hinzuzufügen.|| data-sort-value="2.1" | 2.0 und 2.1
|-
| [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/vesta extended relationships|vesta extended relationships]] || Cissée (ric2015) || [https://github.com/vesta-webtrees-2-custom-modules/vesta_extended_relationships GitHub] || Genealogie || Diagramm "Beziehungen" / Listen "Personen mit Patriarchen" || Ausgefeilte Berechnung von verwandschaftlichen Beziehungen und anderen Verbindungen. Wird als Ersatz für das Standard-Diagramm "Beziehungen" verwendet.||data-sort-value="2.1"| 2.0 und 2.1
|-
| [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/vesta gov4webtrees|vesta gov4webtrees]] || Cissée (ric2015) || [https://github.com/vesta-webtrees-2-custom-modules/vesta_gov4webtrees GitHub] || Sonstige || Sonstige || Die Nutzung von Daten aus dem geschichtlichen Ortsverzeichnis GOV erlaubt die Darstellung von historischen und aktuellen Ortsangaben inkl. der jeweiligen Verwaltungshirarchie.||data-sort-value="2.1"| 2.0 und 2.1
|-
| [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/vesta location data|vesta location data]] || Cissée (ric2015) || [https://github.com/vesta-webtrees-2-custom-modules/vesta_location_data GitHub] || Sonstige || Sonstige || Bereitstellung von Ortsdaten für andere webtrees-Module.|| data-sort-value="2.1" | 2.0 und 2.1
|-
| [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/vesta personal facts|vesta personal facts]] || Cissée (ric2015) || [https://github.com/vesta-webtrees-2-custom-modules/vesta_personal_facts GitHub] || Personenseite || Reiter "Tatsachen und Ereignisse" || Ein Reiter zur Anzeige der Tatsachen und Ereignisse einer Person. Ersetzt den Original-Reiter.||data-sort-value="2.1"| 2.0 und 2.1
|-
| [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/vesta places and pedigree map|vesta places and pedigree map]] || Cissée (ric2015) || [https://github.com/vesta-webtrees-2-custom-modules/vesta_places_and_pedigree_map GitHub] || Personenseite / Genealogie || Reiter "Orte" / Diagramm "Vorfahrenkarte" / Listen "Gemeinsame Orte" || Orte zu den Ereignissen einer Person werden in einem Reiter, in einem Diagramm und einer Liste dargestellt. Die entsprechenden Standardfunktionen werden ersetzt.||data-sort-value="2.1"| 2.0 und 2.1
|-
| [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/vesta relatives|vesta relatives]] || Cissée (ric2015) || [https://github.com/vesta-webtrees-2-custom-modules/vesta_relatives GitHub] || Personenseite || Reiter "Familien" || Ein Reiter zur Anzeige von nahen Verwandten einer Person. Ersetzt den entsprechenden Original-Reiter.||data-sort-value="2.1"| 2.0 und 2.1
|-
| [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/vesta research suggestions|vesta research suggestions]] || Cissée (ric2015) || [https://github.com/vesta-webtrees-2-custom-modules/vesta_research_suggestions GitHub] || Personenseite || Reiter "Tatsachen und Ereignisse" || Wenn neue Ereignisse erfasst werden, werden dazu passende Quellen, die bereits angelegt sind, automatisch vorgeschlagen.||data-sort-value="2.1"| 2.0 und 2.1
|-
| [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/vesta shared places|vesta shared places]] || Cissée (ric2015) || [https://github.com/vesta-webtrees-2-custom-modules/vesta_shared_places GitHub] || Genealogie || Listen "Gemeinsame Orte" || Ortsdatensätze als GEDCOM-Objekte auf Ebene 0 erlauben es geteilte Ortsinformationen darzustellen. Dies basiert auf dem GEDCOM-L Addendum zum GEDCOM-Standard 5.5.1.||data-sort-value="2.1"| 2.0 und 2.1
|-
| vytux cousins || Krivickas ||[https://github.com/vytux-com/vytux_cousins GitHub] || Personenseite || Reiter "Cousinen" || Auf der Personenseite werden in einem zusätzlichen Reiter die Cousins und Cousinen einer Person dargestellt.||data-sort-value="2.1"| 2.1
|-
| [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Fächerdiagramm|webtrees fan-chart]] || Sonntag (magic-sunday) || [https://github.com/magicsunday/webtrees-fan-chart GitHub] || Genealogie || Diagramm "Fächerdiagramm" || Das Standard-Fächerdiagramm wird in deutlich besserer Qualität ersetzt.||data-sort-value="2.1"| 2.0 oder 2.1
|-
| family-tree-home || Chapin (miqrogroove) || [https://github.com/miqrogroove/family-tree-home GitHub] || Sonstige || Sonstige || Nach der Anmeldung auf der webtrees-Seite landet der Nutzer nicht mehr auf seiner persönlichen Seite, sondern auf der Startseite eines Stammbaums. || data-sort-value="2.1" | 2.0 oder 2.1
|-
| sosa || gustine || [https://gustine.eu/mode_emploi/sosa.php gustine.eu] || Personenseite || Navigationsleiste "Sosa" || Für eine ausgewählte Startperson wird für alle Vorfahren die Sosa-Nummer berechnet und auf der Seite dieser Personen angezeigt.||data-sort-value="2.1"| 2.1
|-
|autocomplete_place_location || Kempf || [https://github.com/tkempf/autocomplete_place_location GitHub] || Sonstige || Sonstige || Bei der Eingabe von Ortsdaten wird eine Autocomplete-Funktion bereit gestellt, die die interne Datentabelle mit geografischen Daten (place_location) über alle Stammbäume durchsucht.|| data-sort-value="2.1" | 2.1
|-
|ChangeLanguageWithURL || Jefferson49 || [https://github.com/Jefferson49/ChangeLanguageWithURL GitHub] || Sonstige || Sonstige || Die webtrees-Sprache kann durch eine URL-Anfrage geändert werden. Die gewünschte Sprache wird als URL-Parameter bereit gestellt. Dies kann hilfreich sein, wenn webtrees etwa in einer Joomla-Umgebung betrieben wird.|| data-sort-value="2.1" | 2.0 und 2.1
|-
|DownloadGedcomWithURL || Jefferson49 || [https://github.com/Jefferson49/DownloadGedcomWithURL GitHub] || Sonstige || Sonstige || Die GEDCOM-Datei für einen Stammbaum wird auf eine URL-Anforderung hin heruntergeladen, wobei der Stammbaumname, der GEDCOM-Dateiname und die anzuwendende Autorisierungsstufe als Parameter innerhalb der URL bereitzustellen sind. Es kann gewählt werden, ob die exportierte GEDCOM-Datei entsprechend dem Standard 5.5.1 (ggf. mit Addendum nach GEDCOM-L) oder 7.0 erfolgen soll. Die Möglichkeit zum Herunterladen wird durch einen geheimen Schlüssel abgesichert.|| data-sort-value="2.1" | 2.1
|-
|RepositoryHierarchy || Jefferson49 || [https://github.com/Jefferson49/RepositoryHierarchy GitHub] || Genealogie || Liste "Archiv Hierarchie" und Datenkorrektur || Darstellung einer hierarchisch strukturierten Liste der Quellen in einem Archiv, basierend auf den Signaturen der Quellen.|| data-sort-value="2.1" | 2.1
|-
|Webtrees-MailSystem || Galli (06Games) || [https://github.com/06Games/Webtrees-MailSystem GitHub] || Sonstige || Sonstige || Die letzten Änderungen und bevorstehende Ereignisse in einem Stammbaum werden an ausgewählte Nutzer geschickt. || data-sort-value="2.1" | 2.1
|-
| [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Impressum|hh_imprint]] || Hartenthaler ||[https://github.com/hartenthaler/hh_imprint GitHub] || Webseite || Fußzeile "Impressum" || Im Fußbereich der Seiten wird ein Impressum hinzugefügt. Die Angaben können vom Administrator im Verwaltungsmenü festgelegt werden. || data-sort-value="2.1" | 2.1
|-
| tree view full screen || UksusoFF || [https://github.com/UksusoFF/webtrees-tree_view_full_screen GitHub] || Personenseite || Reiter "Interaktives Sanduhrdiagramm" || Darstellung des interaktiven Sanduhrdiagramms auf einer Personenseite bei Bedarf auf dem ganzen Bildschirm statt in dem kleinen Fenster. Dieses Modul wird nicht mehr benötigt, da diese Funktion seit webtrees 2.1.8 ein fester Bestandteil ist.|| data-sort-value="2.1" | 2.0 und 2.1
|-
| webtrees-extended-slide-show || Hieber || [https://github.com/hieberst/webtrees-extended-slide-show GitHub] || Sonstige || Block "Diaschau" || Hinter dem Namen der abgebildeten Person wird die Lebensspanne eingeblendet.|| data-sort-value="2.1" | 2.1
|}
</div>

{{Infobox|
;Die folgenden Erweiterungsmodule sind empfehlenswert
* Thema "JustLight" (klare und moderne Oberfläche)
* Reiter und Menü "Fancy Treeview" (Bericht zu Nachkommen und Vorfahren in Erzählform)
* Diagramme "Fächerdiagramm", "Ahnentafel" und "Nachkommentafel" (mit einer verbesserten Darstellung)
* Reiter "Großfamilie" (Übersicht über die gesamte Großfamilie einer Person)
* Vesta-Module (u.a. für Ortsdatensätze und zur Nutzung von GOV), nur für Fortgeschrittene, da auch der Kern modifiziert wird}}

[[Kategorie:Webtrees]]

Webtrees Handbuch/Anleitung für Webmaster/Anleitung Upgrade 21

2023-03-14T20:40:02Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Abschnitt 8.5.1.4.1|info=1}}{{WT-Inhaltsverzeichnis|Kapitel 8|C|Abschnitt 8.5.1.4.1}}

Die wichtigsten Änderungen beim Upgrade auf die webtrees Version 2.1 betreffen die Art der Umsetzung des GEDCOM-Standards. Die Version 2.1 von webtrees unterstützt den GEDCOM-Standard 5.5.1 und einige Dialekte von GEDCOM, wie sie von diversen Genealogieprogrammen genutzt werden.
Zur Vorbereitung auf den GEDCOM-Standard 7.0 wurden bereits in der Version 2.1.0 von webtrees die im folgenden beschriebenen Anpassungen vorgenommen.

== Mehrere RESN-Tags in einem Datensatz ==
<div style="display:flow-root;">
{{Wichtig|Ein Administrator oder ein Verwalter sollte prüfen, ob die folgende Änderung eventuell datenschutzrelevante Auswirkungen auf Informationen in einem Stammbaum haben könnte und deshalb Anpassungen nötig sind (eventuell unter Nutzung der Funktion "[[Webtrees_Handbuch/Anleitung_für_Verwalter#Datenkorrekturen|Suchen und Ersetzen]]").}}
</div>

Laut GEDCOM 5.5.1 darf ein Datensatz oder Fakt nur maximal ein RESN-Tag haben (siehe Abschnitt "[[Webtrees_Handbuch/Allgemeine_Erläuterung_des_Programms#Datenschutz_für_Fakten|Datenschutz für Fakten]]"). Es gibt jedoch zwei Arten von Einschränkungen, zum einen bezüglich des Anzeigens und zum anderen bezüglich des Bearbeitens von Daten.

In webtrees bis zur Version 2.0 wurde diese Inkonsistenz im Standard dadurch gelöst, dass mehrere Tags zugelassen wurden. Zum Beispiel
0 @X1@ INDI
1 RESN privacy
1 RESN locked
Die GEDCOM 7.0-Spezifikation besagt, dass mehrere Werte in einem einzigen Tag als Auflistung kombiniert werden sollen.<ref>Vgl. https://gedcom.io/specifications/FamilySearchGEDCOMv7.html#enum-RESN.</ref> Zum Beispiel
0 @X1@ INDI
1 RESN PRIVACY, LOCKED
webtrees 2.1 verwendet nun dieses neue Format. Wenn in einem Stammbaum bislang beide Einschränkungen in einem Datensatz in zwei RESN-Zeilen verwendet werden, muss dies manuell korrigiert werden, da nur noch das erste RESN-Tag verwendet wird. Dadurch könnten eventuell zu schützende Daten unbeabsichtigt sichtbar oder bearbeitbar werden.

== Groß- und Kleinschreibung ==
Laut dem GEDCOM-Standard 5.5.1 sind Groß- und Kleinschreibung bei vordefinierten Attributen (Aufzählungswerten) gleichwertig. Beispielsweise werden die folgenden Datensätze gleich behandelt:
1 NAME
2 TYPE married
oder
1 NAME
2 TYPE MARRIED
oder
1 NAME
2 TYPE mArRiEd

Ähnliches gilt auch bei vielen weiteren vordefinierten Attributen, zum Beispiel bei speziellen Altersangaben, etwa bei der Angabe, ob ein Kind tot geboren wurde:
1 DEAT
2 DATE 13 MAY 1984
2 AGE stillborn
oder
1 DEAT
2 DATE 13 MAY 1984
2 AGE STILLBORN
In GEDCOM 7.0 müssen alle Attribut-Werte in Großbuchstaben geschrieben werden. webtrees 2.1 unterstützt weiterhin Werte in Groß- und Kleinschreibung, allerdings werden neue Werte ab jetzt nur noch in Großbuchstaben erstellt.

== Zeitangaben ==
Häufig wird in vornehmlich deutschen Geburts- oder Sterbedokumenten neben dem Datum auch die genaue Uhrzeit angegeben. Laut GEDCOM-Standard 5.5.1 sind Uhrzeitangaben als Ergänzung zu Datumsangaben nicht zulässig. Diese sind erst mit dem GEDCOM-Standard 7 erlaubt. Da webtrees diese Angaben schon sehr lange unterstützt hat, wurde diese Möglichkeit ab der Version 2.1.2 wieder aktiviert, nachdem sie beim Upgrade auf 2.1.0 zunächst nicht mehr verfügbar war. Bei der [[Webtrees Handbuch/Anleitung für Verwalter#Fehlersuche|Fehlersuche]] von webtrees nach GEDCOM 5.5.1 erscheinen diese Felder korrekterweise als Fehler.

== GEDCOM ==
Die Interpretation von GEDCOM-Inhalten wurde komplett überarbeitet und orientiert sich nun strikter am Standard, wobei aber auch viele GEDCOM-Dialekte explizit und kontrolliert toleriert werden. Die [[Webtrees Handbuch/Anleitung für Verwalter#Fehlersuche|Suche nach GEDCOM-Fehlern]] in den Daten wurde erheblich ausgebaut.

== Erweiterungsmodule ==
Beim Wechsel von der Version 2.0 auf die Version 2.1 sind sehr viele interne Schnittstellen geändert worden. Im Ergebnis waren dadurch fast alle [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodule]] nicht mehr kompatibel und mussten entsprechend an die Version 2.1 angepasst werden.

== Einzelnachweise ==
<references />

[[Kategorie:Webtrees]]

Webtrees Handbuch/Anleitung für Webmaster/Anleitung Upgrade 20

2023-03-14T20:39:52Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Abschnitt 8.5.1.4.2|info=1}}{{WT-Inhaltsverzeichnis|Kapitel 8|C|Abschnitt 8.5.1.4.2}}

Beim Upgrade von einer webtrees Version 1.7 auf die Version 2.0 sollten Sie zuerst entscheiden, ob Sie ein Upgrade durchführen wollen oder ob Sie eine ganz neue Instanz von webtrees aufsetzen möchten. Letzteres hat den Vorteil, dass Sie alle alten Dinge loswerden, die sich ggf. im Lauf der Jahre angesammelt haben. Der Nachteil ist, dass Sie Dinge, die nicht in einer GEDCOM-Datei gespeichert werden können, verlieren bzw. dass Sie einige Informationen von Hand transferieren müssen, wenn diese beibehalten werden sollen. Dazu gehören etwa
* [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Geschichten|Geschichten]]
* [[Webtrees_Handbuch/Anleitung_für_Administratoren/Module#Bl.C3.B6cke|Nachrichten]]
* [[Webtrees_Handbuch/Anleitung_für_Administratoren/Module#Bl.C3.B6cke|Journal]]
* [[Webtrees_Handbuch/Anleitung_für_Administratoren/Module#Bl.C3.B6cke|Neuigkeiten]]
* [[Webtrees_Handbuch/Anleitung_für_Administratoren/Module#Bl.C3.B6cke|Favoriten]] der Benutzer und der Stammbäume
* [[Webtrees_Handbuch/Anleitung_für_Administratoren/Module#Bl.C3.B6cke|Inhalte der html-Blöcke]] auf den Benutzerseiten und den Stammbaum-Startseiten
* Einstellungen, die im Modul "[[Webtrees_Handbuch/Anleitung_für_Administratoren/Module#CSS_und_JS|CSS und JS]]" gemacht wurden
* Einstellungen im Erweiterungsmodul "Faces" (Kennzeichnung von Personen auf Gruppenfotos)
* Einstellungen in vielen anderen Erweiterungsmodulen
* [[Webtrees Handbuch/Anleitung für Administratoren#Benutzer|Verwaltungseinträge für die Benutzer der Webseite]]

<div style="display: flow-root;">
{{WT-ToDo|noch beschreiben: wie übernimmt man diese Informationen per Datenbanktabellentransfer in eine neue Instanz}}
</div>
{{-}}

== Generell erforderliche Schritte für das manuelle Upgrade ==
Beim manuellen Upgrade auf die Version 2 sind diverse Änderungen an den Einstellungen, der Serverkonfiguration und eventuell auch Anpassungen in den genealogischen Daten notwendig. Daher sollten Sie unbedingt auch die [https://webtrees.net/upgrade/2.0/ Hinweise] in der englischsprachigen Dokumentation vor diesem Umstieg beachten. Die folgenden Schritte sind in ähnlicher Form immer bei einem manuellen Upgrade erforderlich. Sie sind im Abschnitt "[[Webtrees Handbuch/Anleitung für Webmaster#Manuelles_Upgrade|Manuelles Upgrade]]" im Kapitel "[[Webtrees Handbuch/Anleitung für Webmaster|Anleitung für Webmaster]]" genauer beschrieben.

* Sichern Sie sowohl alle Stammbäume als auch das Verzeichnis <code>/data</code> und die SQL-Datenbank.
* Erstellen Sie eine Datei <code>/data/offline.txt</code>.
* Laden Sie die aktuellste Version von webtrees 2.0 herunter (das ist die Version 2.0.25).
* Löschen Sie alle Ordner ihrer alten webtrees-Installation auf dem Server bis auf das Verzeichnis <code>/data</code>.
* Entpacken Sie die Dateien und laden Sie sie in das webtrees-Verzeichnis auf dem Webserver hoch.
* Ändern Sie ggf. die Version von PHP auf ihrem Server auf 7.4.
* Löschen Sie nun die Datei <code>/data/offline.txt</code> bzw. benennen Sie sie um in <code>/data/offline.txt.disable</code>.

Da ihre Datenbankverbindungsdaten in der Datei <code>config.ini.php</code> im Verzeichnis <code>/data</code> erhalten geblieben sind, sollte Ihre Datenbank beim nächsten Zugriff über einen Webbrowser auf eine webtrees-Seite automatisch aktualisiert werden.

== Änderungen in der webtrees Version 2.0 ==
Im Folgenden werden die wesentlichen Änderungen beschrieben, die eventuell dazu führen, dass beim Umstieg auf die Version 2.0 Anpassungen vorgenommen werden müssen.

=== Erweiterungsmodule ===
In der webtrees Version 1.7 lagen alle Erweiterungsmodule im Verzeichnis <code>/modules_v3</code>. Keines dieser Module ist mit der Version 2.0 von webtrees kompatibel.

Falls solche Module installiert waren, müssen nach dem Upgrade korrespondierende neue Versionen dieser [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule#.C3.9Cbersicht_.C3.BCber_bekannte_Erweiterungsmodule|Erweiterungsmodule]] im Ordner <code>/modules_v4</code> installiert werden.

=== Basis-URL-Erkennung ===
In der Version 1.7 versucht webtrees die URL der Webseite automatisch zu ermitteln. Dies war nicht immer zuverlässig oder je nach Server-Konfiguration auch gar nicht möglich.

In der Version 2.0 muss die URL der Webseite in der Datei <code>[[Webtrees Handbuch/Anleitung für Webmaster#config.ini.php|/data/config.ini.php]]</code> explizit angeben werden. Eine Zeile mit dem folgendem Inhalt muss hinzugefügt werden:
<syntaxhighlight lang="ini">
base_url="https://www.example.com/webtrees"
</syntaxhighlight>
Der Link muss individuell angepasst werden.

=== Alte URLs auf neue URLs umleiten ===
Die URL-Struktur hat sich geändert. Daher funktionieren Bookmarks, die Benutzer gesetzt hatten und auch Suchmaschinen-Links nicht mehr.

Wenn Sie jedoch die neue Funktion "[[Webtrees_Handbuch/Anleitung_für_Webmaster#Pretty-URLs|Pretty URLs]]" aktivieren, werden geeignete Umleitungen von den alten URLs auf die neuen URLs erzeugt und alle vorhandenen Lesezeichen funktionieren weiterhin. Beispielsweise wird die alte URL <code>individual.php?ged=demo&pid=X123</code> auf die neue URL <code>trees/demo/individual/X123</code> umgeleitet.

Beachten Sie, dass diese Funktion möglicherweise nicht funktioniert, wenn die alten PHP-Skripte von webtrees 1.7 noch im Ordner der obersten Ebene der webtrees-Installation vorhanden sind. Deshalb müssen dort bis auf <code>index.php</code> alle php-Dateien gelöscht werden.

=== Medienordner mit "/../" ===
In der Version 1.7 konnte die Pfadangabe der Medienordner <code>/../</code> enthalten, um so einen Ordner außerhalb des Ordners <code>/data</code> anzugeben.

In webtrees 2.0 ist dies nicht mehr erlaubt. Medienordner und -dateien müssen unterhalb des Ordners <code>/data</code> liegen (oder unterhalb desjenigen Ordners, den Sie in der [[Webtrees_Handbuch/Anleitung_für_Administratoren/Webseite#Datenverzeichnis|Systemverwaltung]] dafür angegeben haben).

=== Symbolische Links ===
In webtrees 1.7 konnte der Ordner <code>/data</code> symbolische Links enthalten.

In der Version 2.0 sind symbolische Links nicht erlaubt.

=== Senden von E-Mail ===
webtrees 2.0 bietet nicht mehr die Option "PHP Mail" für das [[Webtrees_Handbuch/Anleitung_für_Administratoren/Webseite#E-Mail-Versand|Versenden von E-Mails]]. "PHP Mail" weist schwerwiegende Sicherheitslücken auf und wird daher von den großen Mail-Bibliotheken nicht mehr unterstützt.

Sie müssen sendmail verwenden (falls ihr Server dies anbietet) oder einen SMTP-Server konfigurieren.

=== robots.txt ===
In der Version 1.7 mußten Sie die Datei <code>[[Webtrees Handbuch/Anleitung für Webmaster#robots.txt|robots.txt]]</code> im Wurzelverzeichnis selbst erstellen, indem Sie <code>robots-example.txt</code> als Muster verwenden.

Wenn Sie in webtrees 2.0 "[[Webtrees_Handbuch/Anleitung_für_Webmaster#Pretty-URLs|Pretty URLs]]" aktivieren, wird diese Datei automatisch erzeugt.

=== sitemap.xml ===
Die URL der Datei <code>[[Webtrees Handbuch/Anleitung für Webmaster#sitemap.xml|sitemap.xml]]</code> hat sich geändert.

Wenn webtrees im Wurzelverzeichnis installiert ist und "[[Webtrees_Handbuch/Anleitung_für_Webmaster#Pretty-URLs|Pretty URLs]]" aktiviert sind, werden Suchmaschinen die neuen Dateien automatisch finden.

Wenn webtrees in einem Unterordner installiert ist oder wenn "[[Webtrees_Handbuch/Anleitung_für_Webmaster#Pretty-URLs|Pretty URLs]]" nicht aktiviert sind, dann müssen Sie die Sitemap bei den Suchmaschinen selber bekannt geben.

{{WT-ToDo|Bei allen folgenden Abschnitten müssen noch Links zu den Stellen im Handbuch gesetzt werden, an denen diese Themen behandelt werden.}}

=== Sichtbarkeit und Datenschutz beim Ausblenden der Reiter Notizen, Medien oder Quellen ===
In webtrees 1.7 hat die Einstellung der Zugriffsberechtigung für den Reiter "Notizen" implizit auch eine Einschränkung der Privatsphäre für die Notizen selbst bedeutet. Das Ausblenden des Reiters hat auch die Notizen selbst ausgeblendet.

Wenn Sie in webtrees 2.0 den Zugriff auf die Reiter Notizen, Medien oder Quellen deaktivieren oder einschränken, werden die Informationen zu Notizen, Medien oder Quellen stattdessen auf dem Reiter "Fakten und Ereignisse" angezeigt.

Sie sollten daher nun eine explizite Datenschutzeinschränkung für Notizen, Medien oder Quellen hinzufügen, wenn Sie sich bislang auf diese Funktionalität verlassen haben.

=== "Primäre" Eltern ===
Eine Person kann mehrere Eltern haben, etwa durch Geburt und Adoption.

In der Version 1.7 wurden immer die leiblichen Eltern in Ahnentafeln, Berichten und an anderen Stellen verwendet, wenn dort nur ein Satz von Eltern angezeigt werden konnte.

In der Version 2.0 werden die erstgenannten Eltern verwendet, die im Datensatz der Person vorkommen. Es gibt eine neue Bearbeitungsoption, um die [[Webtrees_Handbuch/Anleitung_f%C3%BCr_Bearbeiter#Personen-Datens.C3.A4tze|Eltern einer Person neu zu ordnen]].

=== Status einer Ehe ===
In webtrees 1.7 wurde ein Paar standardmäßig als verheiratet beschrieben, es sei denn, es existiert eine Angabe durch das benutzerdefinierte GEDCOM-Tag "_NMR" (not married).

Ab der Version 2.0 wird [[Webtrees_Handbuch/Anleitung_f%C3%BCr_Bearbeiter#Familien-Datens.C3.A4tze|ein Paar standardmäßig als nicht verheiratet]] beschrieben, es sei denn, es liegt ein Ehe-Ereignis vor. Diese Änderung ermöglicht es, unverheiratete Paare zu erstellen, ohne ein benutzerdefiniertes Tag verwenden zu müssen.

=== Mehrere Mediendateien in einem Medienobjekt ===
webtrees 2.0 erlaubt nun, dass ein [[Webtrees_Handbuch/Anleitung_f%C3%BCr_Bearbeiter#Medien-Datens.C3.A4tze|Medienobjekt mehrere Mediendateien enthalten]] kann. Wenn Sie z.B. beide Seiten eines Dokuments scannen, dann können Sie diese zusammen in einem Medienobjekt speichern. Das gleiche gilt, wenn Sie ein Foto in der originalen und in einer bearbeiteten Version speichern möchten. Diese GEDCOM-konforme Funktionalität wird aber nur von wenigen anderen Genealogieprogrammen unterstützt.

Die erste Mediendatei in einem Medienobjekt, die ein Foto enthält, wird als Miniaturansicht für das Objekt verwendet. Wenn ein Medienobjekt also ein Video und ein Bild enthält, wird das Bild als Miniaturansicht verwendet.

=== "Primäres" Foto ===
'''Webtrees''' muss ein Foto für eine Person auswählen, um es in Diagrammen oder an anderen Stellen zu verwenden.

In der Version 1.7 konnte dieses Bild mit einem benutzerdefinierten GEDCOM-Tag "_PRIMARY Y" festgelegt werden.

In webtrees 2.0 wird als [[Webtrees_Handbuch/Anleitung_f%C3%BCr_Bearbeiter#Prim.C3.A4res_Foto|primäres Foto]] einer Person das erste Medienobjekt verwendet, das im Datensatz der Person enthalten ist. Sind mehrere Medien vorhanden, gibt es eine neue Bearbeitungsoption, um die Medienobjekte einer Person zu sortieren.

Es kommt vor, dass Bilder mit einer Person verknüpft sind, obwohl diese eigentlich mit einem Fakt oder einem Ereignis verknüpft sein sollten. Beispielsweise sollte eine Geburtsurkunde mit dem Geburtsereignis und nicht mit der Person verknüpft werden. Dies kann dazu führen, dass einige unpassende Bilder als "Primärbild" ausgewählt werden. Das Bedienfeld verfügt nun über eine Option, mit der ein solches Bild von einer Personen zu einem Ereignis verschoben werden kann.

=== Benutzerdefinierte Miniaturansichten ===
In der Version 1.7 konnte man eine [[Webtrees_Handbuch/Anleitung_f%C3%BCr_Bearbeiter#Benutzerdefinierte_Miniaturansichten|benutzerdefinierte Miniaturansicht]] für ein Medienobjekt erstellen. Dabei konnte es sich um ein Standbild aus einem Video oder um eine zugeschnittene Version eines Gruppenfotos handeln. Dazu wurde auf dem Server eine Datei hinterlegt, die die Standard-Miniaturansicht ersetzt (dies war nie eine offiziell unterstützte Funktion, wurde aber von einigen Anwendern benutzt).

In der Version 2.0 erstellt man benutzerdefinierte Miniaturansichten, indem man eine zweite Mediendatei mit dieser Minituransicht zu einem Medienobjekt hinzufügt. Medienobjekte können ja mehrere Mediendateien enthalten. Die Miniaturansicht muss im Objekt an die erste Stelle verschoben werden.

Es gibt im Verwaltungsmenü ein Werkzeug, das das Auffinden und Importieren von benutzerdefinierten Miniaturansichten erleichtert (siehe Abschnitt "[[Webtrees_Handbuch/Anleitung_für_Administratoren/Multimedia#Benutzerdefinierte_Vorschaubilder_aus_webtrees_1_importieren|Benutzerdefinierte Vorschaubilder aus webtrees 1 importieren]]" im Kapitel "[[Webtrees Handbuch/Anleitung für Administratoren|Anleitung für Verwalter und Administratoren]]").

=== Registrierung von Benutzern ===
In der Version 1.7 wurden die Registrierungsanfragen der Benutzer per E-Mail an den für einen Baum festgelegten Genealogie-Kontakt geschickt. Das bedeutete, dass sich Besucher nicht auf Webseiten registrieren konnten, auf denen alle Bäume privat sind. Die Genealogie-Kontaktperson musste dann einen Administrator bitten, den Benutzer von Hand anzulegen und die Zugriffsberechtigungen festzulegen.

In webtrees 2.0 werden Anfragen zur Benutzerregistrierung per E-Mail immer an die Administratoren geschickt, sie sind also unabhängig von einem konkreten Stammbaum.

In ähnlicher Weise werden E-Mails für Dinge, wie etwa vergessene Passwörter, jetzt mit Bezug zur Webseite gesendet und nicht mehr mit einem Bezug zu einem konkreten Stammbaum.

=== XREF ===
In webtrees 1.7 war das Präfix der Querverweisbezeichner, der eindeutigen Kennung (XREF), die jedem Datensatz bzw. Objekt in einer GEDCOM-Datei zugewiesen wird, für jeden Objekttyp unterschiedlich (etwa "I" für Einzelpersonen, "F" für Familien, "S" für Quellen usw.). Es bestand auch die Möglichkeit, die XREF-Präfixe für jeden Stammbaum individuell anzupassen.

Aufgrund der Verwechslungsgefahr (I mit 1, S mit 5, O mit 0 usw.) haben alle neuen Datensätze, die in webtrees 2.0 erstellt werden, eine XREF, die mit X beginnt, unabhängig vom Objekttyp. Alle vorhandenen Objekte in einem Stammbaum behalten ihre bisherige XREF mit dem alten Präfix, es sei denn, sie werden neu nummeriert.

Wenn diese Neuerung für die Vergabe von XREF nicht gewünscht wird, kann der Webmaster das Vesta-Erweiterungsmodul "[[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule#.C3.9Cbersicht_.C3.BCber_bekannte_Erweiterungsmodule|classic look and feel]]" aktivieren, so dass weiter mit alten Präfixen gearbeitet werden kann.

[[Kategorie:Webtrees]]

Webtrees Handbuch/Anleitung für Webmaster

2023-03-14T20:39:42Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Kapitel 8|info=1}}{{WT-Inhaltsverzeichnis|Kapitel 8|B}}

== Systemarchitektur ==
[[Datei:WT 2.1 Systemarchitektur.png|mini|650x650px|Systemarchitektur (Client, Server, Backend)|links|verweis=Special:FilePath/WT_2.1_Systemarchitektur.png]]
Die Systemarchitektur für die Anwendung webtrees umfasst einen Client, einen Server und das Backend mit dem Archiv für webtrees bei [https://github.com/fisharebest/webtrees GitHub].

=== Client ===
Der Client ist das Endgerät des Nutzers auf dem irgendein aktueller Browser installiert ist (Firefox, Chrome, Edge, Safari, usw.). Als Endgerät kommen etwa Laptop, Tablet oder Smartphone in Frage. Abhängig von der Rolle des Benutzers in webtrees werden ggf. zusätzlich zum Browser noch weitere lokal installierte Anwendungen benötigt.

Besucher sowie Mitglieder oder Moderatoren benötigten nur den Browser um auf alle Funktionen von webtrees zugreifen zu können. Mitglieder und Moderatoren benötigen für die erstmalige Anmeldung eine E-Mail-Möglichkeit. Der Administrator kann aus webtrees heraus E-Mails an die Nutzer verschicken.

Ein Verwalter oder Administrator benötigt darüber hinaus ein Programm mit dem er E-Mails empfangen kann. Er wird auf diesem Weg darüber informiert, dass ein neuer Nutzer ein Konto beantragt hat. Sobald eine neue Version von webtrees auf dem Backend-Server verfügbar ist, erfolgt ebenfalls eine Nachricht an die Administratoren.

Der Webmaster benötigt ein ftp-Programm ([https://de.wikipedia.org/wiki/Kategorie:FTP-Client ftp-Client]) mit dem er Daten auf den Server hochladen und von diesem herunterladen kann. Und er benötigt ein Programm mit dem er die webtrees-Datenbank verwalten kann. Näheres dazu ist im nachfolgenden Abschnitt "[[Webtrees_Handbuch/Anleitung_für_Webmaster#Werkzeuge_für_den_Webmaster|Werkzeuge für den Webmaster]]" beschrieben.

=== Server ===
Der webtrees-Server kann ein physischer oder ein virtueller Server sein. Als physischer Server kommt vor allem ein dedizierter oder geteilter Server bei einem Hosting-Anbieter in Frage (siehe nächster Abschnitt "[[#Auswahl_eines_Hosting-Anbieters|Auswahl eines Hosting-Anbieters]]"), aber auch ein eigener Rechner zu Hause, wie etwa ein PC, ein RaspberryPi oder ein Netzlaufwerk (siehe nachfolgender Abschnitt "[[#Lokal_installierter_Server|Lokal installierter Server]]"). Als [[#Virtueller_Server|virtueller Server]] kommt etwa ein Docker-Container in Frage. Eine Sonderform der Installation wäre, dass der Client und der Server auf dem selben Endgerät, also lokal, installiert sind.

Die einzelnen Komponenten des Servers sind
* [[#Datenbank|Datenbank]]
* ftp-Server
* Zertifikatsspeicher
* Laufwerk mit den Programmdateien
* [[#Web-Server|Web-Server]]
* [[#PHP|PHP-Interpreter]]
* [[#E-Mail|E-Mail-Server]]

<div style="display:flow-root;">
{{WT-ToDo|Noch beschreiben: genaue Funktion aller Server-Komponenten mit ggf. einem Verweis auf die Abschnitte unter "Voraussetzungen"; insbesondere wie geht das mit der http-Kompression und wie geht das mit dem Interpretieren von PHP und wie geht das mit kompaktem JavaScript; fehlt noch eine Server-Komponente "JavaScript-Interpreter?}}
{{WT-ToDo|Was ist mit Nachrichten über das Formular? Interne Benachrichtigung und/oder E-Mail?}}
</div>

=== Backend-Server ===
Der Backend-Server für webtrees liegt bei [https://github.com/fisharebest/webtrees GitHub]. Dort liegen die aktuelle Version von webtrees und die in Entwicklung befindlichen Versionen. Auch fast alle Erweiterungsmodule liegen bei GitHub. Beim automatischen Upgrade, veranlasst durch einen Administrator, lädt webtrees eigenständig eine neue webtrees-Version vom Backend-Server auf den webtrees-Server.

webtrees prüft regelmäßig über eine Abfrage auf dem Backend-Server, ob dort eine neuere Version vorliegt. Dazu wird die Datei <code>dev.webtrees.net/build/latest-version.txt</code> vom Backend-Server geladen. Diese Prüfaktion wird immer dann angestoßen, wenn irgendeine webtrees-Seite aufgerufen wird; die Prüfung erfolgt aber innerhalb 24 Stunden nur einmal. Für den Fall, dass ein Upgrade vorliegt, werden die Administratoren per E-Mail einmalig darüber informiert. Zusätzlich wird für einen angemeldeten Administrator an verschiedenen Stellen in der Bedienoberfläche ein Hinweis angezeigt.

Um eine Übersicht über die weltweit installierten webtrees-Instanzen zu bekommen, wird bei dieser Prüfung auf eine neue Version auch eine Information mit den wichtigsten Parametern des webtrees-Servers übertragen. Die dabei übermittelten Informationen sind
* eine eindeutige, anonymisierte Kennung der webtrees-Installation
* installierte webtrees-Version
* von webtrees verwendete PHP-Version
* von webtrees verwendeter Typ und Version der Datenbank.
Die gewonnenen Statistikinformationen werden auf dieser [https://dev.webtrees.net/statistics.html webtrees-Seite] publiziert.

=== Kommunikationsnetz ===
In den meisten Fällen kommunizieren die Client-Rechner mit dem webtrees-Server über eine Internet-Verbindung. Diese sollte möglichst schnell und verschlüsselt sein (https).

Die Verbindung zum Backend-Server erfolgt immer über das Internet und ist immer verschlüsselt.
<div style="display:flow-root;">
{{WT-ToDo|Im gesamten obigen Abschnitt für die Fachbegriffe noch Links auf die wikipedia einfügen}}
</div>

== Server-Typen ==

=== Server im Internet ===
Der größte Teil der webtrees-Server befindet sich in einem Rechenzentrum eines Hosting-Anbieters und ist dort über das Internet erreichbar. Man kann einen webtrees-Server aber auch zu Hause betreiben (siehe nachfolgender Abschnitt "[[Webtrees Handbuch/Anleitung für Webmaster#Lokal installierter Server|Lokal installierter Server]]").

==== Auswahl eines Hosting-Anbieters ====
Nach der Entscheidung für einen Server-Typ muss entschieden werden, wer diesen Server betreibt. Wenn man den Server nicht lokal installiert und selbst betreiben möchte, kommt dafür ein Hosting-Anbieter in Frage. Mit diesem schließt man einen entsprechenden Vertrag, der meist auch die Bereitstellung einer Internet-Domäne beinhaltet.

===== Spezialisierte Hosting-Anbieter für webtrees =====
Es gibt derzeit zwei [https://webtrees.net/hosting/ Hosting]-Anbieter, die sich auf webtrees spezialisiert haben. Sie bieten eine fertige und speziell auf die Anforderungen von webtrees ausgerichtete Installation auf Servern in der EU an und kümmern sich um die grundlegende Betriebssicherheit. Die Installation auf einem Server in der EU ist wichtig, da somit die europäischen Datenschutzregelungen greifen.

Ein webtrees-Hosting-Paket ist ideal für diejenigen, die webtrees nutzen möchten, sich aber nicht mit der Einrichtung und dem Betrieb der Anwendung beschäftigen möchten. Sie erhalten ein komplett installiertes und vorkonfiguriertes System und müssen sich nur um die genealogischen Daten kümmern. Alles andere erledigt der Dienstleister im Hintergrund. Er kümmert sich in der Rolle als Webmaster um die Technik, administriert das System und sorgt dafür, dass webtrees und die notwendigen Systemkomponenten immer auf dem neuesten Stand sind.

{| class="wikitable sortable" style="width:100%;"
|+ Hosting-Anbieter - auf webtrees spezialisiert
|-
! Anbieter || Land || Sprache || Preis ||class="unsortable"| Besonderheiten
|-
| [https://genonline.de/index.php/de/ GenOnline] || Deutschland || de || 131,40 €/a || persönliche Beratung bei der Nutzung von webtrees
|-
| [https://hosting.webtrees.net/ Hosting webtrees] || Irland || en || 99 GBP/a || persönliche Beratung und kundenspezifische Anpassungen als Extra
|}

===== Hosting mit einem dedizierten oder geteilten Server im Internet =====
Hosting-Anbieter haben sehr unterschiedliche Angebote, so dass man sich genau überlegen sollte, welche Auswahlkriterien einem wichtig sind. Als erstes Kriterium muss man sich für die Art des Servers entscheiden
* Die günstigeren Angebote basieren darauf, dass man sich mit anderen Kunden einen physischen Server teilt. Man hat hier nur eingeschränkte Rechte und keinen vollen Zugriff auf Betriebssystem und Dateisystem des Servers.
* Wenn man einen Server exklusiv nutzen möchte, kommt ein dedizierter Server in Frage, der aber entsprechend teurer ist. Dafür wird auch die Performance entsprechend besser sein als bei einen Server, den man mit anderen Kunden teilt.
* Des weiteren gibt es virtuelle Server, die man exklusiv nutzt. Ein solcher Server ist eine virtuelle Maschine (VM), die auf einem physischen Server erstellt wird; die VM nutzt die Ressourcen des physischen Servers gemeinsam mit weiteren Virtuellen Servern.
Die in der folgenden Tabelle aufgeführten Angebote basieren alle auf einem Server, den man mit anderen Kunden gemeinsam nutzt, also entsprechend dem ersten Punkt in der obigen Liste.

webtrees benötigt nur eine Datenbank, so dass diese Anforderung von allen hier aufgeführten Anbietern erfüllt wird. Einen verschlüsselten Zugang über das Internet bieten ebenfalls alle diese Anbieter. Die meisten Anbieter bieten auch noch viele weitere Anwendungen wie etwa [https://de.wikipedia.org/wiki/WordPress WordPress] zur Installation an, aber das ist im Zusammenhang mit webtrees irrelevant.

Wenn es darum geht die Kriterien für einen Servertyp festzulegen, dann kommt es weniger auf die Größe des Stammbaumes an, sondern eher auf die Anzahl der gleichzeitig zu unterstützenden Nutzer. Wenn es weniger als 5 Nutzer sind, die gleichzeitig mit webtrees arbeiten sollen, dann reicht in der Regel ein geteilter Server aus und alle unten aufgeführten Angebote kommen in Frage. Neben dem Preis ist sicherlich das wichtigste Kriterium der stabile Betrieb durch einen Anbieter und die gute Erreichbarkeit seiner Hotline im Störungsfall. Hier lohnt es sich Referenzen und Beurteilungen durch andere Nutzer auszuwerten. Aus Datenschutzgründen sollten nur Anbieter ausgewählt werden, die ihre Server in der EU betreiben und somit den Regelungen der EU unterworfen sind.
{| class="wikitable sortable" style="width:100%;"
|+ Hosting-Anbieter - Beispielauswahl von Webspace-Angeboten
|-
! Anbieter || Land || Sprache || Performance || Preis || class="unsortable" | Besonderheiten
|-
|[https://www.hetzner.com/de/webhosting Hetzner]|| DE || de || ? > 5000 Personen || 22,80 €/a 58,80 €/a || 1 Datenbank, [https://de.wikipedia.org/wiki/WordPress WordPress] 10 Datenbanken, [https://de.wikipedia.org/wiki/WordPress WordPress]
|-
|[https://alfahosting.de/webhosting Alfahosting]|| DE || de || ? || 24,00 €/a || 10 Datenbanken [https://de.wikipedia.org/wiki/WordPress WordPress], [https://de.wikipedia.org/wiki/Joomla Joomla!], [https://de.wikipedia.org/wiki/TYPO3 Typo3], [https://de.wikipedia.org/wiki/Drupal Drupal]
|-
|[https://www.dogado.de/website/hosting Dogado]|| DE || de || ? || 48,00 €/a || 10 Datenbanken [https://de.wikipedia.org/wiki/Joomla Joomla!], [https://de.wikipedia.org/wiki/TYPO3 Typo3], [https://de.wikipedia.org/wiki/Drupal Drupal]
|-
|[https://www.strato.de/hosting/ Strato]|| DE || de || ? || 48,00 €/a || 2 Datenbanken [https://de.wikipedia.org/wiki/WordPress WordPress], [https://de.wikipedia.org/wiki/Joomla Joomla!], [https://de.wikipedia.org/wiki/TYPO3 Typo3], [https://de.wikipedia.org/wiki/Drupal Drupal]
|-
|[https://www.ionos.de/hosting/webhosting ionos by 1&1]|| DE || de || ? ||48,00 €/a || 5 Datenbanken [https://de.wikipedia.org/wiki/WordPress WordPress], [https://de.wikipedia.org/wiki/Joomla Joomla!], [https://de.wikipedia.org/wiki/TYPO3 Typo3], [https://de.wikipedia.org/wiki/Drupal Drupal]
|-
|[https://all-inkl.com/webhosting/paketvergleich/ ALL-INKL.COM]|| DE || de || 50 GB, 100 Kunden pro Server 250 GB, 50 Kunden pro Server  || 59,40 €/a 119,40 €/a  || 5 Datenbanken 50 Datenbanken [https://de.wikipedia.org/wiki/WordPress WordPress], [https://de.wikipedia.org/wiki/Joomla Joomla!], [https://de.wikipedia.org/wiki/TYPO3 Typo3], [https://de.wikipedia.org/wiki/Drupal Drupal]
|-
|[https://www.bplaced.net/pro bplaced pro]|| AT || de || Speicherlimit 128 MB CPU-Zeitlimit 30 s || 36,00 €/a || 16 Datenbanken
|}

=== Lokal installierter Server ===
Für einen lokalen Server, der direkt beim Webmaster steht, kommen als Betriebssystem Windows, MacOS oder Linux in Frage. In Abhängigkeit davon werden für den Serverbetrieb unterschiedliche Softwarepakete benötigt, die im folgenden beschrieben werden.

Man kann webtrees aber auch auf einem Netzlaufwerk der Marke Synology oder auf einen Kleinstcomputer der Marke RaspberryPi betreiben.

==== Windows ====
{{WT-ToDo|Installation auf einem lokalen Windows-Rechner beschreiben}}

==== MacOS ====
{{WT-ToDo|Installation auf einem lokalen MacOS-Rechner beschreiben}}

==== Linux ====
Wenn Sie webtrees auf ihrem eigenen Linux-Rechner installieren wollen, sind die im Folgenden beschriebenen Schritte erforderlich.

Als Betriebssystem kommen etwa in Frage<ref>siehe auch {{Wikipedia-Link|Liste_von_Linux-Distributionen}}</ref>

* Debian<ref>siehe {{Wikipedia-Link|Debian}}</ref>
* Ubuntu<ref>siehe {{Wikipedia-Link|Ubuntu}}</ref>
* [[Webtrees Handbuch/Anleitung für Webmaster#RaspberryPi|Raspberry Pi OS]]<ref>siehe {{Wikipedia-Link|Raspberry Pi OS}}</ref>
* openSUSE<ref>siehe {{Wikipedia-Link|openSUSE}}</ref>

Falls ihr Betriebssystem Ubuntu ist, gibt es für die Installation ein vom Nutzer ''Tuetenk0pp'' auf GitHub bereit gestelltes [https://github.com/Tuetenk0pp/webtrees-mngr Skript], das interaktiv durch die Installation führt. Die Voraussetzung dafür ist ein frisch installiertes, aktuelles Ubuntu-System. Dieses Skript hat aber einige Unzulänglichkeiten, die im [https://www.webtrees.net/index.php/en/forum/2-open-discussion/37692-how-to-upgrade-local-server-to-php8-2#9 Forum] in einem Beitrag des Nutzers ''miletrac'' beschrieben worden sind.

Die grundsätzlich erforderlichen Schritte sind
* Linux-Betriebssystem installieren
* Kompletten LAMP-Stacks installieren und einrichten
** Apache Webserver
** Datenbank (z.B. MariaDB)
** PHP (Version 8, eventuell maximale Upload-Größe und andere Parameter vergrößern)
** Firewall
** Bereitstellung eines SSL-Zertifikats
* webtrees herunterladen, entpacken, Dateirechte setzen und einrichten (ggf. [[Webtrees Handbuch/Anleitung für Webmaster#Pretty-URLs|PrettyURLs]] aktivieren); siehe Abschnitt "[[Webtrees Handbuch/Anleitung für Webmaster#Erstinstallation%20von%20webtrees|Erstinstallation von webtrees]]"
* Backup-Möglichkeit schaffen und testen

==== Synology Netzlaufwerk ====
Netzlaufwerke (NAS<ref>siehe {{Wikipedia-Link|Network_Attached_Storage}}</ref>) von [https://synology.de Synology] nutzen als Betriebssystem ''DiskStation Manager (DSM)'', ein Linux-basiertes Betriebssystem. Je nach Leistungsfähigkeit der verwendeter Hardware ist die Nutzung von webtrees möglich. Es kann z.B. eine auf [[Webtrees Handbuch/Anleitung für Webmaster#Virtueller Server|Docker]]<ref>siehe {{Wikipedia-Link|Docker_(Software)}}</ref> basierende Installation erfolgen.

{{WT-ToDo|Installation auf einem Netzlaufwerk von Synology genauer beschreiben}}

==== Raspberry Pi ====
Das für einen ''Raspberry Pi''<ref>siehe {{Wikipedia-Link|Raspberry_Pi}}</ref> empfohlene Betriebssystem ist das auf Debian basierende Raspberry Pi OS. Die Leistungsfähigkeit eines Raspberry Pi reicht mit einigen Einschränkungen durchaus für eine Nutzung von webtrees aus. Allerdings ist die Anzahl gleichzeitiger Nutzerzugriffe und die Größe der Stammbäume limitiert.
{{WT-ToDo|Installation unter Raspberry Pi OS genauer beschreiben}}

=== Virtueller Server ===
{{WT-ToDo| docker beschreiben}}

== Installation von webtrees ==
Nachdem der Hosting-Anbieter bzw. der Server ausgewählt worden sind, steht die Installation von webtrees auf dem Server an. Die im Folgenden beschriebenen Schritte sind dabei erforderlich
* [[Webtrees_Handbuch/Anleitung_für_Webmaster#Voraussetzungen_für_die_Installation|Voraussetzungen für die Installation herstellen]] (Systemumgebung und Server-Zugang prüfen, PHP konfigurieren, Datenbank anlegen, Web-Server und Internet-Anbindung konfigurieren)
* [[Webtrees_Handbuch/Anleitung_für_Webmaster#Erstinstallation_von_webtrees|Programmdateien auf den Server laden]]
* [[Webtrees_Handbuch/Anleitung_für_Webmaster#Ersteinrichtung|Konfigurationsassistenten für die Ersteinrichtung nutzen]]
* [[Webtrees_Handbuch/Anleitung_für_Webmaster#Test_der_Installation|Installation testen und GEDCOM-Testdaten hochladen]]
* [[Webtrees_Handbuch/Anleitung_für_Webmaster#Installation_von_Erweiterungsmodulen|Erweiterungsmodule installieren]]

Anstatt webtrees selbst zu installieren, kann man auch fertige Installationsdienste oder vorgefertigte Container-Lösungen nutzen, wenn der vorgesehene Host das unterstützt (etwa Docker, Installatron, OpenSuse, Puppet, Softaculous, Yunohost). Dazu gibt es ergänzende Hinweise in der [https://webtrees.net/install/ Original-webtrees-Dokumentation]. Für einige Hosting-Anbieter und Servertypen liegen dort ebenfalls noch zusätzliche Hinweise (für Bluehost, Cloudflare, Microsoft/IIS, OVH). Ansonsten zeigen die folgenden Abschnitte exemplarisch alle Schritte bei der Installation. Da jeder Server und jede Installationsumgebung Unterschiede aufweisen können, wird es auch bei Ihrer Installation Abweichungen geben.

=== Voraussetzungen für die Installation ===
Bevor webtrees installiert werden kann, muss die Systemumgebung geprüft oder vorbereitet werden. Bei den meisten Hosting-Angeboten wird bereits alles passend parat stehen, was für webtrees benötigt wird. Wenn man einen Server selbst aufsetzt, muss man die im folgenden beschriebenen Systemkomponenten installieren und konfigurieren. '''Insbesondere muss man sich um die erforderliche System-Sicherheit permanent und selber kümmern'''.

==== Systemumgebung ====
Die Webpräsenz sollte zumindest über einen FTP-Zugang<ref>{{wikipedia-Link|File_Transfer_Protocol}}</ref> erreichbar sein, um den Datentransfer zu ermöglichen. Besser ist noch zusätzlich ein Fernwartungszugang per SSH<ref>{{wikipedia-Link|Secure_Shell}}</ref> oder RDP<ref>{{wikipedia-Link|Remote_Desktop_Protocol}}</ref>, da hierüber noch mehr Möglichkeiten bestehen (bspw. Einrichtung von Cronjobs<ref>{{wikipedia-Link|Cron}}</ref> oder Anpassung der [[#Datensicherheit_und_Datenschutz|Dateirechte]]).

Für die webtrees-Anwendung werden etwa 116 MB an '''Speicherplatz''' benötigt.<ref>Der Speicherplatzbedarf verteilt sich auf die Unterverzeichnisse 18 MB ./resources, 82 MB ./vendor, 9 MB ./app und 8 MB ./public.</ref> Dazu kommt der individuelle Platzbedarf für Medien- und GEDCOM-Dateien sowie Speicher für [[Webtrees_Handbuch/Anleitung_f%C3%BCr_Webmaster/Erweiterungsmodule|Erweiterungsmodule]], Cachedaten und [[#Upgrade|Upgrade]]-Dateien.

Weitere Anforderungen an die '''Server-Performance''' hängen stark von den eigenen Wünschen und Bereitschaft ab, was für die Webpräsenz investiert werden soll, mit welcher Anzahl Benutzern zu rechnen ist und der Menge an zu verwaltenden Datensätzen. Eine Idee für die Anforderungen an Arbeitsspeicher und zugesicherter Ausführungszeit der PHP-Skripte gibt Abschnitt [[#Server_.C3.BCberpr.C3.BCfen|Server überprüfen]].

==== PHP ====
PHP muss für die aktuelle Version von webtrees in einer der folgenden Versionen installiert sein: 7.4, 8.0, 8.1 oder 8.2. Die Version 7.4 wird noch bis zum 28. November 2022 gepflegt werden; danach wird diese Version auch von webtrees nicht mehr unterstützt, d.h. spätestens bis zu diesem Termin sollten alle alten webtrees-Installationen auf eine Version 2.1.x aktualisiert werden.

Je nachdem welche PHP-Version auf dem Web-Server installiert ist, können verschiedene Versionen von webtrees genutzt werden (näheres zu den Versionsbezeichnungen bei webtrees ist im nachfolgenden Abschnitt "[[Webtrees_Handbuch/Anleitung_für_Webmaster#Versionen_von_webtrees|Versionen von webtrees]]" beschrieben). Die folgende Tabelle zeigt die Abhängigkeiten zwischen den PHP- und den webtrees-Versionen.
{| class="wikitable"
|+ Übersicht der PHP-Unterstützung durch webtrees
|-
!PHP-Version
!letzte webtrees-Version
!Status für webtrees
|-
|8.0–8.2
|ab 2.1.0
|volle Unterstützung
|-
|7.4
|2.0.26 und ab 2.1.0
|volle Unterstützung bis zum 28.11.2022
|-
|7.1–7.3
|2.0.26
|größere Fehler und Sicherheitsprobleme werden noch behoben
|-
|5.3–7.3
|1.7.20
|nicht mehr gepflegt
|-
|5.2–5.6
|1.4.6
|nicht mehr gepflegt
|}

webtrees benötigt die folgenden Erweiterungsbibliotheken<ref>Zu den erforderlichen Erweiterungsbibliotheken vgl.:
* https://repo.packagist.org/packages/fisharebest/webtrees
* https://github.com/fisharebest/webtrees/blob/main/composer.json
* https://github.com/fisharebest/webtrees/blob/main/app/Services/ServerCheckService.php</ref>
* ext-ctype
* ext-curl
* ext-exif
* ext-fileinfo
* ext-gd
* ext-iconv
* ext-intl
* ext-json
* ext-mbstring
* ext-pcre
* ext-pdo (und die Treiber für die verwendete Datenbank - mysql/postgres/etc.)
* ext-session
* ext-simplexml
* ext-xml
* ext-zip
Die Situation ist allerdings nicht ganz einfach, denn es gibt für einige der erforderlichen Erweiterungen auch Ersatzlösungen<ref>{{wikipedia-Link|Polyfills}}</ref>. Zum Beispiel werden in webtrees Funktionen von „php-mbstring“ verwendet, aber diese werden zusätzlich auch über „symfony/polyfill-mbstring“ eingebunden. webtrees funktioniert also auch ohne die PHP-Erweiterung, wenngleich auch etwas langsamer.

Dasselbe gilt für „php-calendar“, das von „fisharebest/ext-calendar“ ersetzt werden kann. Es kann auch noch weitere Funktionen geben, die in ähnlicher Form, eventuell mit eingeschränkter Funktionalität arbeiten, wenn die eigentliche Bibliothek fehlt.

Welche PHP-Erweiterungen aktuell installiert sind, lässt sich über den Menüpunkt "Webseite / [[Webtrees Handbuch/Anleitung für Administratoren/Webseite#Server_Information|Server Information]]“ im Verwaltungsmenü anzeigen.

{{Halt|Die Erweiterung php-psr sollte nicht installiert werden, da es dann zu Fehlern mit webtrees kommen kann.<ref>siehe Artikel "[https://webtrees.net/install/ubserspace/ Uberspace webhosting]" im webtrees-Forum</ref>}}

==== Datenbank ====
webtrees verwendet die [https://laravel.com/docs/8.x/database Laravel-Datenbankkomponente] und unterstützt damit folgende gängige Datenbankmanagementsysteme (DBMS)<ref>{{wikipedia-Link|DBMS}}</ref> <ref>Für das gewünschte DBMS ist dann ggf. die Installation/Aktivierung weiterer php-extensions erforderlich.</ref>:<ref>Übersetzung des Abschnitts "Database Requirements" von https://webtrees.net/install/requirements/ wurde hier eingearbeitet.</ref>
* MySQL<ref>{{wikipedia-Link|MySQL}}</ref> - Version 5.7 oder höher
* MariaDB<ref>{{wikipedia-Link|MariaDB}}</ref> - Version 10.3 oder höher
* PostgreSQL<ref>{{wikipedia-Link|PostgreSQL}}</ref> - Version 9.6 oder höher
* SQLite<ref>{{wikipedia-Link|SQLite}}</ref> - Version 3.8.8 oder höher
* Microsoft SQL Server<ref>{{wikipedia-Link|Microsoft_SQL_Server}}</ref> - 2017 oder höher

MySQL/MariaDB wird für Produktionsserver empfohlen. webtrees verwendet die Sortierfunktionen von MySQL, um Namen in verschiedenen Sprachen korrekt zu suchen und zu sortieren. 
PostgreSQL und SQL-Server sind weitgehend ungetestet, sollten aber funktionieren. 
SQLite eignet sich gut für kleine Websites, ist aber bei vielen gleichzeitigen Benutzern nicht gut skalierbar.

Bei der [[#Datenbankanbindung_konfigurieren|Einrichtung der Datenbank]] besteht mit dem Tabellennamen-Präfix (Vorgabewert ist <code>wt_</code>) die Möglichkeit mehrere Anwendungen in einer Datenbank kollisionsfrei abzuspeichern. Dies sollte nur erfolgen, wenn nicht ausreichend Datenbanken im Hosting-Paket enthalten sind. Grundsätzlich sollte für jede Anwendung eine eigene Datenbank zum Einsatz kommen, was den Betrieb<ref>Beispielsweise sind die Ausfälle durch Wartungen nur auf eine Anwendung berenzt und Backup & Restore sind ohne Seiteneffekte umsetzbar.</ref> vereinfacht. Aus Sicherheitsgründen ist auch die Verwendung unterschiedlicher Datenbanknutzer für die verschiedenen Anwendungen sinnvoll.

{{Halt|Derzeit unterstützt webtrees bei der Zeichenkodierung in der Datenbank nur UTF8_MB3, aber nicht UTF8_MB4. Dadurch ist es nicht möglich Texte oder andere Datenfelder zu speichern, die etwa Emoji enthalten.<ref>Vgl. auch: https://github.com/fisharebest/webtrees/issues/2950.</ref>}}

==== Web-Server ====
{{WT-ToDo|Beschreiben: welche Webserver kommen in Frage (Apache, Microsoft IIS, ...)?}}

==== Internet-Anbindung ====
Entweder ist eine Internet-Domäne bereits Bestandteil des Vertrages mit dem Hosting-Anbieter oder diese muss separat bei einem Anbieter von Internet-Domänen gemietet werden. Als Beispiel wird im Folgenden die Domäne <code>musterfamilie.de</code> verwendet.

Der Zugang zu webtrees sollte in jedem Fall verschlüsselt erfolgen, d.h. es sollte das [[#Sichere_Kommunikationsverbindung|Protokoll https]] zur Verwendung kommen. Von einer ungesicherten Anbindung mit http wird abgeraten.

Es gibt zwei mögliche Konfigurationen, wie webtrees über das Internet von einem Browser adressiert werden kann

* ''webtrees'' direkt in die Heimatseite integriert: <code><nowiki>https://musterfamilie.de</nowiki></code>
* ''webtrees'' in einer Subdomain, etwa "ahnen", zur Heimatseite: <code><nowiki>https://ahnen.musterfamilie.de</nowiki></code>

Die Variante mit der Subdomain bietet sich insbesondere dann an, wenn noch weitere Anwendungen in der Domäne installiert werden sollen (etwa Wordpress). Nicht in jedem Mietvertrag für die Heimatseite wird es eine Option geben, die die freie Wahl von Subdomains vorsieht. Wenn man die Variante mit der Subdomain wählt, dann installiert man webtrees in einen Unterordner des Hauptverzeichnisses des Web-Servers, etwa in den Ordner "webtrees" und ordnet in der Domänen-Verwaltung des Servers diesen Unterordner der Subdomain zu.

Aber auch wenn man keine Subdomain nutzen möchte oder kann, sollte man webtrees in einen eigenen Unterordner des Hauptverzeichnisses des Web-Servers installieren, etwa in den Ordner "webtrees". Dann ist es möglich zukünftig auch noch andere Anwendungen in der Domäne zu betreiben und zu adressieren. Die Adressierung in einem auf webtrees zugreifenden Browser sieht dann so aus

* ''webtrees'' in einem Unterordner der Heimatseite integriert: <code><nowiki>https://musterfamilie.de/webtrees</nowiki></code>

Die Anbindung an das Internet sollte eine hohe Datenrate bieten und ausfallsicher gestaltet sein. Wenn man ein Hosting-Angebot nutzt, wird man sich darum nicht kümmern müssen. Wenn man webtrees auf einem lokalen Server installiert hat und den Wunsch hat, dass dieser aus dem Internet erreichbar sein soll, dann muss man sich eine dynamische Internet-Adresse besorgen, diese einrichten und im eigenen Router eine Port-Weiterleitung zu dem eigenen Web-Server konfigurieren.

{{WT-ToDo|Noch beschreiben: Installation der Zertifikate für https (für Domain bzw. Subdomain)}}

==== E-Mail ====
Um die optionalen E-Mail-Funktionen von webtrees nutzen zu können, muss ein E-Mail-Konto vorhanden sein. Die Konfiguration ist im Abschnitt "[[Webtrees_Handbuch/Anleitung_für_Administratoren/Webseite#E-Mail-Versand|E-Mail-Versand]]" im Kapitel "[[Webtrees_Handbuch/Anleitung_für_Administratoren|Anleitung für Administratoren]]" beschrieben.

==== Werkzeuge für den Webmaster ====
Neben den Voraussetzungen auf der Seite des Servers, benötigt man als Webmaster noch lokale Programme.
{{WT-ToDo|Beschreiben: Browser, ftp-Programm, Datenbankmanagement-Programm, E-Mail, ...}}

==== Werkzeuge für einen Programmierer ====
Neben den Werkzeugen, die ein Webmaster benötigt, sollte ein Programmierer von Erweiterungsmodulen noch weitere Programme installieren.
{{WT-ToDo|Programmiertools wie PhpStorm kurz beschreiben.}}

=== Erstinstallation von webtrees ===
Nachdem das ZIP-Archiv der aktuellen Version vom webtrees-GitHub-Server (siehe [https://github.com/fisharebest/webtrees/releases github.com/fisharebest/webtrees/releases]) heruntergeladen wurde, müssen die Dateien entpackt und im Zielordner auf dem Webserver abgelegt werden. Wie dies erfolgt, hängt von der Konstellation ab. Bei einem lokalen Webserver auf dem eigenen Arbeitsrechner kann das Entpacken und Ablegen direkt geschehen. Bei einem gehosteten Server kann dies auch per SSH oder RDP möglich sein oder es muss über den Zwischenschritt des temporären Entpackens auf dem Arbeitsrechner und dem Hochladen per FTP auf den Server erledigt werden. Zumindest die gesetzten Dateirechte sollten in diesem Schritt geprüft werden, damit der Webserver die Dateien auch lesen und verarbeiten darf.

Danach erfolgt die Ersteinrichtung wie im nachfolgenden Abschnitt beschrieben.

{{Halt|Bei der Speicherung der Programmdateien und Daten auf dem Server dürfen keine "Symbolischen Verknüpfungen"<ref>{{wikipedia-Link|Symbolische_Verknüpfung}}</ref> genutzt werden, da diese seit Version 2.0 nicht mehr unterstützt werden.<ref>Vgl. "Differences in 2.0" (https://webtrees.net/upgrade/2.0/) und "Error if Data on the web server contains a 'symbolic link' and the user clicks 'Clean up data folder' #2984" (https://github.com/fisharebest/webtrees/issues/2984).</ref>}}

== Ersteinrichtung ==
Nach dem Kopieren der webtrees-Anwendungsdaten auf den Webserver muss für den Abschluss der Ersteinrichtung in einem Web-Browser die neue Site aufgerufen werden. Dies sollte unmittelbar passieren, damit niemand Unbefugtes in der Zwischenzeit Schaden anrichten kann.

Wird die Konfigurationsdatei <code>data/config.ini.php</code> bei der Ausführung nicht gefunden, wird automatisch der Einrichtungsassistent angezeigt. Die Konfigurationsdatei wird am Ende des Vorgangs automatisch erstellt, so dass zukünftig beim Start von webtrees der Einrichtungsassistent nicht mehr erscheinen wird.

=== Sprache festlegen ===
[[Datei:WT_2.1_Einrichtungsassistent1-Sprachauswahl.png|thumb|right|250px|Einrichtungsassistent (Seite 1) - Sprachauswahl|verweis=Special:FilePath/WT_2.1_Einrichtungsassistent1-Sprachauswahl.png]]
Der erste Schritt ist die Auswahl der Sprache, in der die Dialogführung im weiteren erfolgen soll.
{{-}}

=== Server überprüfen ===
[[Datei:WT_2.1_Einrichtungsassistent2-Serverleistung.png|thumb|right|250px|Einrichtungsassistent (Seite 2) - Serverleistung prüfen|verweis=Special:FilePath/WT_2.1_Einrichtungsassistent2-Serverleistung.png]]
Es folgt die Prüfung der Serverleistung<ref>Anpassungen für den bereitgestellten Arbeitsspeicher und die Ausführungszeit müssen in der Konfiguration von [[#PHP|PHP]] über die php.ini-Direktiven [http://php.net/memory-limit memory_limit] und [http://php.net/max-execution-time max_execution_time] vorgenommen werden.</ref>: Die Speicher- und Prozessorzeit-Anforderungen sind abhängig von der Anzahl der Personen in Ihrem Stammbaum und den Möglichkeiten des genutzten Webhostings. Die Seite zeigt eine kurze Liste typischer Anforderungen:
* Kleiner Stammbaum (500 Personen): 16-32 MB Hauptspeicher, 10-20 Sekunden Prozessorzeit
* Mittlerer Stammbaum (5000 Personen): 32-64 MB Hauptspeicher, 20-40 Sekunden Prozessorzeit
* Großer Stammbaum (50000 Personen): 64-128 MB Hauptspeicher, 40-80 Sekunden Prozessorzeit
{{-}}

=== Datenbankanbindung konfigurieren ===
[[Datei:WT_2.1_Einrichtungsassistent3-DBMS-Auswahl.png|thumb|right|250px|Einrichtungsassistent (Seite 3) - DBMS-Auswahl|verweis=Special:FilePath/WT_2.1_Einrichtungsassistent3-DBMS-Auswahl.png]]
Bei den meisten Installationen dürfte MySQL/MariaDB zum Einsatz kommen (siehe dazu der oben stehende Abschnitt "[[Webtrees_Handbuch/Anleitung_für_Webmaster#Datenbank|Datenbank]]").
{{-}}<gallery perrow="2" widths="250" caption="Einrichtungsassistent (Seite 4) - Konfiguration der Datenbank-Verbindung">
Datei:WT_2.1_Einrichtungsassistent4-DBMS-MySQL.png|MySQL/MariaDB/Percona
Datei:WT_2.1_Einrichtungsassistent4-DBMS-SQLite.png|SQLite
Datei:WT_2.1_Einrichtungsassistent4-DBMS-PostgreSQL.png|PostgreSQL
Datei:WT_2.1_Einrichtungsassistent4-DBMS-MSSQL.png|Microsoft SQL Server
</gallery>

Je nach DBMS-Wahl müssen unterschiedliche Parameter für die Datenbank-Verbindung angegeben werden
* Servername (wahrscheinlich in vielen Fällen <code>localhost</code>, da der Datenbank-Server häufig auf dem selben Host wie der Webserver ausgeführt wird)
* Portnummer (Standard: MySQL=3306 / PostgreSQL=5432 / MS SQL=1433)
* Datenbankbenutzer und Passwort
* ggf. ein Tabellenpräfix (wenn in einer Datenbank Tabellen für unterschiedliche Anwendungen angelegt werden)
Bei SQLite beschränken sich die Angaben auf den Ablagepfad der Datei und das Tabellenpräfix.

=== Administratorkonto einrichten ===
[[Datei:WT_2.1_Einrichtungsassistent5-Adminkonto.png|thumb|right|250px|Einrichtungsassistent (Seite 5) - Administratorkonto|verweis=Special:FilePath/WT_2.1_Einrichtungsassistent5-Adminkonto.png]]
Zum Abschluss der Einrichtung werden noch Informationen für die Erstellung des Administratoren-Kontos abgefragt.
Danach erfolgt die Weiterleitung zum Formular, um den ersten [[Webtrees_Handbuch/Anleitung_für_Administratoren/Stammbäume#Einen_Stammbaum_erstellen|Stammbaum anzulegen]].
{{-}}

=== config.ini.php ===
Die Haupt-Konfigurationsdatei von webtrees <code>data/config.ini.php</code> wird bei der Ersteinrichtung automatisch erstellt. Sie kann dann folgendermaßen aussehen:
<syntaxhighlight lang="php">
; <?php return; ?> DO NOT DELETE THIS LINE
dbtype="mysql"
dbhost="localhost"
dbport="3306"
dbuser="webtrees"
dbpass="Geheimes-Passwort"
dbname="webtrees"
tblpfx="wt_"
base_url="https://musterfamilie.de/webtrees"
rewrite_urls="0"
</syntaxhighlight>

Es ist eigentlich eine INI-Datei<ref>{{wikipedia-Link|Initialisierungsdatei}}</ref> mit Schlüssel-Wert-Paaren, die in einer PHP-Datei verpackt wurde. Zur zusätzlichen Absicherung der Daten - neben dem [[#Zugriffsschutz|Verzeichnisschutz]] - ist die erste Zeile wichtig, da sie die Ausgabe im Browser verhindert. Weitere Details können auch dem Abschnitt zu [[#Pretty-URLs|Pretty-URLs]] entnommen werden.

{{Infobox|Insbesondere beim Erstellen oder nachträglichen Ändern der Datei auf Windows-Systemen ist zu beachten, dass diese in der richtigen Kodierung - UTF-8<ref>{{wikipedia-Link|UTF-8}}</ref> (ohne Byte-order-Mark/BOM) - gespeichert und hochgeladen wird. Ansonsten kann es zu Fehlern kommen.<ref>Vgl. auch: https://webtrees.net/faq/config-ini-php/.</ref>}}

==== Blockieren ganzer Netzwerke/Organisationen ====

Der "Bad Bot Blocker"<ref>Vgl. Commit https://github.com/fisharebest/webtrees/commit/617057d4ae09fbcd822ba635c6ed70514af7603a.</ref> kann auch ganze Netzwerke blockieren.<ref>Übersetzung des Abschnitte "Blocking entire networks/organisations" auf der Seite https://webtrees.net/admin/block/.</ref>

Das Internet besteht aus vielen kleineren, miteinander verbundenen Netzwerken. Jedes dieser Netze hat eine Kennung, die so genannte "AS-Nummer"<ref>{{Wikipedia-Link|Autonomes_System}}</ref>.

Sie können die AS-Nummer für eine IP-Adresse mit einer WHOIS<ref>{{Wikipedia-Link|Whois}}</ref>-Suche herausfinden.

Um diese Möglichkeit zu aktivieren, erstellen Sie einen Eintrag für <code>block_asn</code> in der Datei <code>data/config.ini.php</code>. Dies ist ein freies Format - webtrees sucht nach den Zeichenfolgen ASnnnnn an beliebiger Stelle in diesem Eintrag. Zum Beispiel:
<syntaxhighlight lang="php">
block_asn="Bad company=AS123456, Evil organisation=AS654321"
</syntaxhighlight>

In der Regel werden Sie damit Server-Hosting-Unternehmen blockieren, die in dem Ruf stehen, ihren Kunden jede Art von Diensten (Spamming, Scanning, Hacking usw.) zu erlauben, ohne Fragen zu stellen. Dies wird oft als "kugelsicheres Hosting"<ref>Vgl. https://en.wikipedia.org/wiki/Bulletproof_hosting.</ref> bezeichnet.

Dieses Feature wurde über die Konfigurationsdatei implementiert, um auf diese Weise leicht Hunderte von Anfragen pro Sekunde blockieren zu können. Müsste erst eine "teure" Verbindung zur Datenbank aufgebaut werden, könnte ein Angreifer den Server leicht überlasten, indem er zu viele Datenbankanfragen stellt.<ref>Vgl. Forumsbeitrag "Help for version 2.1 > any plans to block certain IP-adresses from trying to login": https://www.webtrees.net/index.php/en/forum/help-for-release-2-1-x/37854-any-plans-to-block-certain-ip-adresses-from-trying-to-login</ref>

=== Test der Installation ===
Nachdem die Erstinstallation abgeschlossen ist, sollte in einem ersten Test die einwandfreie Funktion der Website geprüft werden.

{{WT-ToDo|Noch beschreiben: wie testet man am besten?}}

==== Test mit dem Import einer GEDCOM-Datei ====

==== Test der eMail-Funktion ====

=== Installation von Erweiterungsmodulen ===
Nach dem erfolgreichen Test können nun noch [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodule]] installiert werden (siehe dazu den Abschnitt "[[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodule]]"). Dies sollte schrittweise erfolgen, damit bei eventuell auftretenden Problemen das verursachende Erweiterungsmodul leichter identifiziert werden kann.

Als Webmaster können Sie auf dem Server im Ordner <code>/modules_v4</code> installierte [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodule]] durch eine Umbenennung auf einfache Art deaktivieren. Dazu müssen Sie in den Ordnernamen einen "." (Punkt) einfügen, etwa indem Sie an den Ordnernamen ein ".disable" anhängen. Also indem Sie etwa den Ordner <code>jc-theme-justlight</code> in <code>jc-theme-justlight.disable</code> umbenennen. Solche Ordner sind dann für webtrees unsichtbar. Durch das Entfernen des angehängten Namensbestandteils zu einem späteren Zeitpunkt, wird das Erweiterungsmodul wieder für webtrees sichtbar. Diese Funktion reicht somit tiefer als das Aktivieren oder Deaktivieren von [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodulen]] im Menü "[[Webtrees_Handbuch/Anleitung_für_Administratoren/Module#Alle_Module|Module]]" durch einen Administrator und ist immer dann zu empfehlen, wenn vermutet wird, dass ein Erweiterungsmodul Fehler verursacht.

== Upgrade ==
Eine Aktualisierung von webtrees geht schnell und einfach. Falls der Kern von webtrees auf einen neuen Versionsstand gebracht werden soll, stehen zwei verschiedene Wege zur Verfügung: das automatische und das manuelle Verfahren. Für die Aktualisierung eines Erweiterungsmoduls steht nur das manuelle Verfahren zur Verfügung.

=== Upgrade von webtrees ===
[[Datei:WT 2.0 Update_verfügbar.png|thumb|right|600px|Hinweis auf eine neue Version|verweis=Special:FilePath/WT_2.0_Update_verfügbar.png]]
Das Vorliegen einer neuen Version wird dem Administrator in einer Hinweiszeile angezeigt. Es wird dringend empfohlen, die Installation zu aktualisieren, sobald eine neue Version von webtrees zur Verfügung steht. Selbst kleinere Upgrades enthalten in der Regel eine erhebliche Anzahl von beseitigten Fehlern sowie Verbesserungen in der Bedienoberfläche oder Programmerweiterungen. Gefundene und behobene Sicherheitslücken führen immer zu einer neuen Version, die dann schnellstmöglich eingespielt werden sollte. Falls nicht sowieso regelmäßig Datensicherungen erstellt werden, sollte vor einem Update immer eine [[Webtrees Handbuch/Anleitung für Webmaster#Backup_der_genealogischen_Daten_und_der_Datenbank|Sicherung]] durchgeführt werden.
{{-}}

==== Versionen von webtrees ====
Die Versionsnummern von webtrees in der Form x.y.z, also etwa 2.1.3, folgen folgendem Schema

* die erste Zahl "x" kennzeichnet eine Hauptversion, die nicht miteinander kompatible Versionen unterscheidet.
Die Datenbankstruktur von webtrees in der Version 1 und die internen Schnittstellen der Module passen nicht zur Version 2. [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodule]] für webtrees 1 funktionieren also nicht mit der Version 2 und umgekehrt. Ein Upgrade bei einem Wechsel der Hauptversion ist nur manuell möglich. Hierzu gibt es eine spezielle Anleitung und es müssen umfangreiche Vorbereitungen für das Upgrade getroffen werden.

* die zweite Zahl "y" kennzeichnet eine neue Version, die grundsätzlich neue Funktionen und geänderte interne Schnittstellen mit sich bringt.
[[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodule]] können kompatibel sein, sind es aber wahrscheinlich eher nicht. Vor dem Einspielen eines Updates sollte also geprüft werden, ob alle im Einsatz befindlichen Erweiterungsmodule in einer kompatiblen Version vorliegen. Der Wechsel von Version 2.0 zur Version 2.1 etwa betrifft so viele interne Schnittstellen, dass die meisten [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodule]] angepasst werden müssen. Bei einem Wechsel der webtrees-Version kann es auch vorkommen, dass andere Versionen von PHP unterstützt werden, so dass der Webmaster gleichzeitig auch einen Wechsel der PHP-Version vornehmen kann oder muss.

* die dritte Zahl "z" kennzeichnet eine Unterversion, die etwa gefundene Fehler behebt oder kleinere Anpassungen mit sich bringt.
Im Normalfall werden die meisten [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodule]] von diesen Änderungen nicht betroffen sein und können deshalb weiter verwendet werden.

Eine Übersicht über alle bislang vorliegenden Versionen von webtrees ist im Kapitel [[Webtrees Handbuch/Allgemeine Erläuterung des Programms#Versionsgeschichte|"Allgemeine Erläuterung des Programms"]] aufgeführt.

==== Automatisches Upgrade ====
[[Datei:WT 2.0 Aktualisierungsassistent Ablauf.png|thumb|right|600px|Protokoll des Aktualisierungsablaufs|verweis=Special:FilePath/WT_2.0_Aktualisierungsassistent_Ablauf.png]]
webtrees hat die Fähigkeit, sich automatisch zu aktualisieren. Im Rhythmus von nicht weniger als 24 Stunden sucht webtrees frühestens nach einer aktualisierten Version. Sollte ein Upgrade verfügbar sein, erscheint eine Hinweiszeile mit einem Link, sofern man als Administrator angemeldet ist. Durch einen Klick auf den Link kann der Administrator den Upgrade-Assistenten für das automatische Update nutzen.

Automatische Upgrades sind von Berechtigungen und Ressourcen auf dem Server abhängig. Die verwendeten PHP-Skripte benötigen die Berechtigung
* Dateien vom [https://github.com/fisharebest/webtrees/releases webtrees-GitHub-Server] über eine gesicherte Kommunikation auf den webtrees-Server zu kopieren.
* Dateien auf dem Server zu überschreiben. Wenn der Webserver Skripte als anonymer Benutzer ausführt, dann wird er keine Berechtigung haben, Dateien zu aktualisieren. Wenn Sie also aufgefordert werden, die Berechtigungen des Ordners <code>./data</code> auf 777 zu ändern, können Sie das automatische Upgrade nicht verwenden; sie müssen in diesem Fall dann ein [[Webtrees_Handbuch/Anleitung_für_Webmaster#Manuelles_Upgrade|manuelles Upgrade]] durchführen oder die Voraussetzungen für das automatische Upgrade schaffen.

Der Server muss ausreichend leistungsfähig sein, um das Upgrade abzuschließen, ohne CPU- und Speichergrenzen zu überschreiten. Der Server muss ungefähr 130 MB freien Speicherplatz haben, um die neue Version zu speichern und zu entpacken. Das Upgrade dauert normalerweise zwischen 15 und 60 Sekunden. Wenn nach fünf Minuten keine Antwort erfolgt ist, dann wurde wahrscheinlich eine CPU-Zeitbegrenzung erreicht und das Upgrade ist fehlgeschlagen.
{{-}}
{{Infobox|Wenn das automatische Upgrade aus irgendeinem Grund fehlschlägt, sollten Sie als Webmaster zuerst versuchen das zu Grunde liegende Problem zu lösen und alternativ ein manuelles Update durchführen. Das Verzeichnis <code>./data/tmp/upgrade</code> auf dem Server sollte in diesem Fall manuell gelöscht werden.}}

{{WT-ToDo|Noch beschreiben: was muss der Webmaster genau tun, damit sein Server die benötigten Fähigkeiten hat}}

Der automatische Upgrade-Prozess erfolgt in den folgenden Schritten
[[Datei:WT_2.0_Aktualisierungsassistent_Warnung.png|thumb|right|600px|Warnung bei installierten Erweiterungsmodulen|verweis=Special:FilePath/WT_2.0_Aktualisierungsassistent_Warnung.png]]
# Falls die [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule|Vesta-Erweiterungsmodule]] installiert sind, erfolgt ggf. eine Warnung, dass diese [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodule]] eventuell mit der neuen [[Webtrees_Handbuch/Anleitung_für_Webmaster#Versionen_von_webtrees|Version]] von webtrees nicht kompatibel sein könnten (siehe nebenstehende Abbildung). Hier sollte man also den Prozess ggf. abbrechen, wenn man erst die Kompatibilität prüfen möchte. Andere [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodule]] verwenden keine solche Benachrichtigungsfunktion. Hilfreich ist immer ein Blick ins webtrees-Forum und auf die GitHub-Seiten der installierten [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule#.C3.9Cbersicht_.C3.BCber_bekannte_Erweiterungsmodule|Erweiterungsmodule]]. Ein Upgrade auf einem webtrees-Testserver kann die Sicherheit bringen, dass sich die installierten [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodule]] mit der neuen webtrees-Version vertragen werden; erst danach sollte dann das Upgrade im Produktivsystem eingespielt werden.
# Danach wird ein Verzeichnis <code>./data/tmp/upgrade</code> angelegt, in das temporär die neuen Dateien geladen werden.
# Nun wird geprüft, ob es noch Änderungen von Daten in den Stammbäumen gibt, die noch nicht vom Moderator freigegeben wurden (siehe Abschnitt [[Webtrees_Handbuch/Anleitung_für_Moderatoren|"Freigeben von Änderungen durch einen Moderator"]]). Der Upgrade-Prozess bricht aber nicht ab, wenn noch solche Änderungen vorliegen, es erfolgt lediglich eine Warnmeldung.
# Alle Stammbäume werden automatisch exportiert, d.h. es wird für jeden Stammbaum im Verzeichnis <code>./data</code> eine aktuelle GEDCOM-Datei angelegt (der Dateiname enthält das Datum des Exports).
# Vom [https://github.com/fisharebest/webtrees/releases webtrees-GitHub-Server] wird die neue webtrees-Version als zip-Datei in das im Schritt 2 angelegte Verzeichnis kopiert.
# Dateien in den Verzeichnissen <code>./app</code>, <code>./resources</code> und <code>./vendor</code>, die nicht mehr benötigt werden, werden gelöscht.
# Die zip-Datei wird in das temporäre Verzeichnis entpackt und die entpackten Dateien werden dann an das Zielverzeichnis kopiert.
# Zum Abschluss öffnet sich das Verwaltungsmenü. Hier kann vom Administrator kontrolliert werden, ob die neue Version korrekt angezeigt wird.

==== Manuelles Upgrade ====
Beim manuellen Upgrade<ref>Vgl. auch https://webtrees.net/upgrade/manual/</ref> lädt der Webmaster eine neue, freigegebene Version von webtrees auf einen lokalen Rechner herunter und entpackt diese Version dort. Falls [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodule]] installiert sind, sollte überprüft werden, ob diese mit der neuen Version von webtrees kompatibel sind. Eventuell stehen für diese Module auch Upgrades zur Verfügung.

Während neue Dateien hochgeladen werden, würde ein Besucher der Website auf eine Mischung aus alten und neuen Dateien stoßen. Dies würde ein unvorhersehbares Verhalten oder Fehler verursachen. Um dies zu verhindern, muss vor dem Kopieren die Datei <code>/data/offline.txt</code> angelegt werden. Solange diese Datei existiert, werden die Besucher der Website eine Meldung sehen wie "Die Webseite befindet sich im Wartungsmodus. Sie sollten es in einigen Minuten erneut versuchen.". Wenn die Datei "offline.txt" leer ist, wird diese Standardnachricht angezeigt; alternativ kann man eine besondere Nachricht in diese Datei schreiben, so dass die Besucher ersatzweise diese Meldung sehen. Man sollte als nächstes die Verzeichnisse <code>/app</code>, <code>/resources</code> und <code>/vendor</code> löschen, damit alte Dateien entfernt werden. Dann werden alle Ordner und Dateien mit einem [https://de.wikipedia.org/wiki/Kategorie:FTP-Client ftp-Programm] in das webtrees-Verzeichnis auf dem Webserver kopiert. Nach dem Kopieren der Dateien auf den Server muss die Datei <code>/data/offline.txt</code> wieder entfernt werden. Auch wenn der Administrator in der Systemsteuerung ein anderes Verzeichnis für den Datenordner gewählt haben sollte, der Speicherort für diese Datei ist immer im Verzeichnis <code>/data</code>.

Beim Wechsel von einer Unterversion zu einer anderen, kann man üblicherweise den Inhalt der Dateien auf dem Server einfach überschreiben. Beim Wechsel zu einer neuen Version oder gar einer Hauptversion empfiehlt es sich alle Dateien im webtrees-Verzeichnis auf dem Server zuvor zu löschen. Davon ausgenommen ist die Datei <code>.htaccess</code> im Stammverzeichnis von webtrees und die Dateien im Unterverzeichnis <code>/data</code>.

{{Infobox|
Wenn im Zuge eines Upgrades auch Datenbank-Upgrades erforderlich sind, dann werden diese automatisch durchgeführt, sobald ein Nutzer die Website das nächste Mal besucht. Aus diesem Grund kann es dann länger dauern, bis die erste Seite angezeigt wird.}}

==== Upgrade in Abhängigkeit von der Ausgangsversion ====
Wenn Sie derzeit eine der unten aufgeführten älteren Versionen von webtrees verwenden, gibt es beim Upgrade auf eine neuere Version zusätzliche Dinge zu beachten. Da die Hinweise, die bei einem solchen Versionswechsel zu beachten sind, teilweise recht umfangreich sind und den Umfang dieses Abschnittes sprengen würden, sind diese teilweise auf Unterseiten ausgelagert

* [[Webtrees_Handbuch/Anleitung_für_Webmaster/Anleitung_Upgrade_21|Upgrade auf die Version 2.1]]
* [[Webtrees_Handbuch/Anleitung_für_Webmaster/Anleitung_Upgrade_20|Upgrade auf die Version 2.0]]

oder es wird auf die englischsprachigen Originalseiten verwiesen. Im folgenden finden Sie eine Liste der Ausgangsversionen mit den Hinweise, was zu beachten ist, wenn Sie von einer solchen Version auf eine neuere Version wechseln wollen.

* webtrees 2.1.8 und 2.1.9: Diese Versionen enthalten einen Fehler im Auto-Upgrade-Code. Das automatische Upgrade scheint erfolgreich ausgeführt zu werden, es werden jedoch keine Dateien installiert. Daher wurden diese Versionen schnell ersetzt, aber einige Benutzer haben sie installiert. Um den automatischen Upgrade-Assistenten wieder verwenden zu können, muss eine Datei ersetzt werden: <code>app/Http/RequestHandlers/UpgradeWizardStep.php</code>. Die aktualisierte Version dieser Datei kann [https://raw.githubusercontent.com/fisharebest/webtrees/3bcf98433336b5a90f37394d98c25184064324ae/app/Http/RequestHandlers/UpgradeWizardStep.php hier] heruntergeladen werden.
* webtrees bis 2.0.25: beim Update auf die Version 2.1 ändern sich in Vorbereitung auf den GEDCOM-Standard 7.0 einige [[Webtrees_Handbuch/Anleitung_für_Webmaster/Anleitung_Upgrade_21|Datenfelder]]
* webtrees 2.0.8: Diese Version enthält einen Fehler im Auto-Upgrade-Code, daher wurde die Version schnell ersetzt, aber einige Benutzer haben sie installiert. Um den automatischen Upgrade-Assistenten wieder verwenden zu können, müssen zwei Dateien bearbeitet werden
** Bearbeiten Sie zunächst <code>/app/Factories/FilesystemFactory.php</code> und ändern Sie Zeile 40 von <code>/../../..</code> in <code>/../…</code>. Dies behebt den Fehler.
** Bearbeiten Sie zweitens <code>/app/Webtrees.php</code> und ändern Sie Zeile 101 von „2.0.8“ in „2.0.7“. Dadurch wird das automatische Upgrade wieder aktiviert.
* webtrees 1.7.10 – 1.7.20: Es sind vor einem manuellen Upgrade auf die Version 2 diverse Änderungen an den Einstellungen, der Serverkonfiguration und eventuell auch Anpassungen in den genealogischen Daten notwendig. Daher sollten Sie unbedingt diese [[Webtrees_Handbuch/Anleitung_für_Webmaster/Anleitung_Upgrade_20|Anleitung]] vor dem Upgrade beachten.
* webtrees 1.4.0 – 1.7.9: Es muss vor einem Umstieg auf die Version 2 erst ein Upgrade auf die Version 1.7.20 erfolgen.
* webtrees 1.0.0 – 1.3.2: Vor einem Upgrade muss zuerst die „Medien-Firewall“ deaktiviert werden (siehe [https://webtrees.net/upgrade/media-firewall/ Anleitung] in englischer Sprache); dann muss ein manuelles Upgrade auf die Version 1.7.20 durchgeführt werden.
* phpGedView: In webtrees 1.7.20 ist ein spezieller Migrationsassistent für das Vorgänger-Programm phpGedView integriert. Sie sollten daher diese Version als neue Instanz neben phpGedView installieren und dann den Migrationsassistenten nutzen. Beachten Sie, dass Sie keine funktionierende phpGedView-Installation benötigen. Sie benötigen nur die Datenbank und den Ordner "index". Nähere Hinweise finden Sie in der englischsprachigen [https://webtrees.net/upgrade/phpgedview/ Dokumentation].

{{Infobox|
;Alle hier eventuell benötigten älteren Versionen von webtrees findet man auf der [https://webtrees.net/download webtrees-Download-Übersichtsseite].}}

=== Upgrade eines Erweiterungsmoduls ===
Wenn eines der [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodule]] in einer neuen Version vorliegt, erhält der Administrator beim Aufruf der Verwaltungsseite eine entsprechende Nachricht.
{{WT-ToDo|Noch beschreiben: wie findet man heraus welches Erweiterungsmodul die Meldung erzeugt hat und wo man die aktuellere Version findet}}
Dann lädt man als Webmaster das neue Release des Erweiterungsmoduls auf den lokalen Rechner herunter und entpackt den Inhalt. Eventuell muss man den gefundenen Ordnernamen noch entsprechend der Anleitung zu diesem Modul umbenennen, etwa von einer angehängten Versionsnummer befreien. Danach lädt man den Ordner mit einem ftp-Programm ins Verzeichnis modules_v4 der webtrees-Installation und überschreibt den dortigen Inhalt
(man kann auch den alten Ordner mit dem Erweiterungsmodul auf dem Server zuvor löschen).

Zum Abschluss muss im Browser das Fenster mit webtrees erneut geladen, d.h. aufgefrischt werden, damit die Änderung sichtbar wird.

{{Vorlage:Warnung|Laden Sie immer nur freigegebene Versionen von [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodulen]] herunter (Releases), nie Zwischenstände im Entwicklungszustand!}}

== Pretty-URLs ==
Internet-Adressen, wie <code><nowiki>https://musterfamilie.de</nowiki></code>, werden für Unterseiten durch weitere Bestandteile ergänzt. Für webtrees gibt es dabei zwei mögliche Varianten, wie diese Adressen aussehen können. In ihrer Funktion sind sie identisch. Die URL-Varianten sind<ref>Übersetzung der Seite https://webtrees.net/faq/urls/.</ref>
* Standard-URL: <pre>https://musterfamilie.de/webtrees/index.php?route=/tree/demo</pre>
* Pretty-URL<ref>{{wikipedia-Link|Clean URL}}</ref>: <pre>https://musterfamilie.de/webtrees/tree/demo</pre>

Die zweite Variante hat den Vorteil, dass sie keinen Rückschluss darüber zulässt, welche Technik hinter der Website steckt (bei der ersten Variante erkennt man sofort, dass PHP verwendet wird). Daher ist die zweite Variante aus Sicherheitsgründen zu bevorzugen. Und diese Variante ist auch für Menschen einfacher zu lesen. Um Pretty-URLs ("hübsche URLs") zu aktivieren, benötigen Sie zwei Dinge

# Sie müssen den Webserver so konfigurieren, dass er "Pretty-URLs" akzeptiert und diese an webtrees weiterleitet. Die genaue Konfiguration ist bei jedem Webserver anders (Apache<ref>{{Wikipedia-Link|Apache_HTTP_Server}}</ref>, NGINX<ref>{{Wikipedia-Link|Nginx}}</ref>, IIS<ref>{{Wikipedia-Link|Microsoft_Internet_Information_Services}}</ref>, ...). Die Grundkonfiguration ist wie folgt
#* Statische Dateien werden in <code>/public</code> aufbewahrt. Diese können direkt ausgeliefert werden, wobei lange expires-Header verwendet werden.
#* Dynamische Seiten werden von <code>index.php</code> generiert. Alle nicht-statischen URLs sollten auf <code>/index.php</code> abgebildet werden.
#* Andere Dateien und Ordner sind privat und sollten nicht zugänglich sein, z. B. <code>/app</code>, <code>/data</code>, <code>/modules_v4</code>, <code>/resources</code>, <code>/vendor</code>.
# Sie müssen webtrees anweisen, Pretty-URLs zu erzeugen. Dazu müssen in der Datei [[Webtrees_Handbuch/Anleitung_für_Webmaster#config.ini.php|<code>data/config.ini.php</code>]] zwei Zeilen hinzugefügt oder geändert werden:
<syntaxhighlight lang="ini">
base_url="https://musterfamilie.de/webtrees"
rewrite_urls="1"
</syntaxhighlight>

Nachdem Sie Pretty-URLs aktiviert haben, erkennt webtrees weiterhin die Standard-URLs. Alle bereits vorhandenen Lesezeichen und Suchmaschinenverweise funktionieren also weiterhin.

=== Beispiel-Konfiguration für NGINX ===
Hier ein Beispiel für eine NGINX-Konfiguration für webtrees, die in einem Unterordner <code>/webtrees/</code> installiert ist.
<syntaxhighlight lang="nginx">
# Static files have versions in their URLs, and can be cached indefinitely.
location /webtrees/public {
expires 365d;
access_log off;
}

# GIT config files can contain credentials or other sensitive data.
location /webtrees/.git {
deny all;
}

# User data is stored here by default.
location /webtrees/data {
deny all;
}

# Nothing sensitive here, but there is no need to publish it.
location /webtrees/app {
deny all;
}
location /webtrees/modules {
deny all;
}
location /webtrees/resources {
deny all;
}
location /webtrees/vendor {
deny all;
}

# Rewrite all other requests onto the webtrees front-controller.
location /webtrees/ {
rewrite ^ /webtrees/index.php last;
}

# webtrees runs from this one script.
location = /webtrees/index.php {
include fastcgi.conf;
fastcgi_pass unix:/run/php/php7.3-fpm.sock;
}
</syntaxhighlight>

=== Beispiel-Konfiguration für Apache ===
Unterstützt der Server [[Webtrees_Handbuch/Anleitung_für_Webmaster#.htaccess|.htaccess]]-Dateien? Um dies zu testen, versuchen Sie, die webtrees-Konfigurationsdatei im Browser anzuzeigen (z. B. <code><nowiki>https://musterfamilie.de/data/config.ini.php</nowiki></code>). Wenn <code>.htaccess</code>-Dateien unterstützt werden, erhalten Sie den Fehler "403/Access-denied"<ref>{{Wikipedia-Link|HTTP-Statuscode}}</ref>. Wenn nicht, dann sehen Sie eine Seite, die nur ein Semikolon enthält.

Speichern Sie die folgende <code>.htaccess</code>-Datei im Root-Ordner <code>/webtrees</code>:
<syntaxhighlight lang="apacheconf">
### .htaccess file for webtrees

<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /webtrees/

# GIT config files can contain credentials or other sensitive data.
RewriteRule \.git - [F]

# User data is stored here by default.
RewriteRule ^data(/|$) - [F]

# Nothing sensitive here, but there is no need to publish it.
RewriteRule ^app(/|$) - [F]
RewriteRule ^modules - [F]
RewriteRule ^resources(/|$) - [F]
RewriteRule ^vendor(/|$) - [F]

RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]
</IfModule>
</syntaxhighlight>

Ändern Sie den Eintrag für <code>RewriteBase</code> so, dass er mit dem Pfadteil der webtrees-URL übereinstimmt; wenn webtrees in einer Subdomäne installiert wurde, etwa <code><nowiki>https://webtrees.musterfamilie.de</nowiki></code>, dann lautet dieser Eintrag <code>RewriteBase /</code>.

== Datensicherheit und Datenschutz ==

=== Sichere Kommunikationsverbindung ===
https ...

=== Logfile-Überwachung ===

=== Zugriffsschutz ===

==== Dateirechte ====

==== .htaccess ====
<code>.htaccess</code><ref>{{Wikipedia-Link|.htaccess}}</ref> (englisch hypertext access „Hypertext-Zugriff“) ist eine Konfigurationsdatei auf einem Webservern wie Apache<ref>{{Wikipedia-Link|Apache_HTTP_Server}}</ref>. In dieser Datei können verzeichnisbezogene Regeln aufgestellt werden.

Wenn man einen Apache-Webserver nutzt, kann eine <code>.htaccess</code>-Datei mit einem Texteditor erstellt und in das Root-Verzeichnis von webtrees kopiert werden. Ein Beispiel dazu, das Pretty-URLs erlaubt, ist im Abschnitt "[[Webtrees Handbuch/Anleitung für Webmaster#Pretty-URLs|Pretty-URLs]]" in diesem Kapitel beschrieben.

Beispielsweise kann man mit den Festlegungen in der <code>.htaccess</code>-Datei ein Verzeichnis oder einzelne Dateien durch HTTP-Authentifizierung vor unberechtigten Zugriffen schützen. Auch Fehlerseiten (wie die Seite "404"<ref>{{Wikipedia-Link|HTTP-Statuscode}}</ref>) oder Weiterleitungen innerhalb des Servers lassen sich darin festlegen, ohne dass der Webserver neu gestartet werden muss; Änderungen in der <code>.htaccess</code>-Datei treten sofort in Kraft, weil die Datei bei jeder Anfrage an den Webserver ausgewertet wird. Festlegungen in .<code>htaccess</code> gelten für das Verzeichnis, in dem die Datei gespeichert ist, und in allen Unterverzeichnissen; diese Festlegungen können aber in den Unterverzeichnissen überschrieben werden.

Um etwa im webtrees-Ordner <code>/data</code> den Zugriff auf die dort liegende Mediendateien und ggf. auch <code>.ged</code>-Dateien von außen einzuschränken, kann man dort eine <code>.htaccess</code>-Datei mit dem folgenden Inhalt hinterlegen:
<syntaxhighlight lang="apacheconf">
order allow,deny
deny from all
</syntaxhighlight>

Mit der ersten Zeile wird festgelegt, dass zuerst alle "allow"-Regeln bearbeitet werden und dann alle "deny"-Regeln<ref>siehe Dokumentation der [https://httpd.apache.org/docs/trunk/mod/mod_access_compat.html#order Order Directive]</ref>. Die Ablehnung von Zugriffen ist damit der Standard. Mit der zweiten Zeile wird der Zugriff für alle externen Rechner gesperrt<ref>siehe Dokumentation der [https://httpd.apache.org/docs/trunk/mod/mod_access_compat.html#deny Deny Directive]</ref>. Diese <code>.htaccess</code>-Datei im Ordner <code>/data</code> ist die einzige, die in der webtrees-Installation bei der Auslieferung enthalten ist.

Um Weiterleitungsregeln in der <code>.htaccess</code>-Datei zu testen, kann man die Webseite [https://htaccess.madewithlove.com/ <code>htaccess.madewithlove.com</code>] verwenden.

=== Unerwünschte Zugriffe auf die Website blockieren ===
Um unerwünschte Zugriffe auf die '''webtrees-'''Website zu blockieren, gibt es einige standardmäßig aktive Funktionen in webtrees. Im Bedarfsfall können diese noch angepasst werden. Zugriffsversuche werden im [[Webtrees Handbuch/Anleitung für Webmaster#Logfile-.C3.9Cberwachung|'''webtrees-'''Logfile]] dokumentiert und können dort analysiert werden.

==== Kategorien von Besuchern ====
Die Besucher Ihrer Website können ganz generell als gut oder schlecht eingestuft werden.

Zu den guten Besuchern gehören

* Menschen
* Suchmaschinen, die es Menschen ermöglichen, Ihre Website zu finden; zum Beispiel Google, Bing, DuckDuckGo, usw.
* Werkzeuge zur Überwachung der Verfügbarkeit der Website, Website-Qualitätstestprogramme usw.

Zu den schlechten Besuchern gehören

* Robots (Webcrawler), die Daten über Ihre Website sammeln, um sie an andere zu verkaufen. Zum Beispiel Werbetreibende, Abmahnanwälte, Suchmaschinenoptimierer.
* Robots, die nach Schwachstellen auf Ihrer Website suchen.
* Schlecht geschriebene Robots, die den Server stark belasten und ihn so für die guten Besucher verlangsamen.

Das Ziel ist es nun, die schlechten Nutzer in effizienter Art und Weise am Zugriff zu hindern ohne die guten Nutzer auszusperren.

==== robots.txt für seriöse Robots ====
Nach der Übereinkunft des Robots-Exclusion-Standard-Protokolls liest ein Robot beim Auffinden einer Webseite zuerst die Datei <code>robots.txt</code> im Stammverzeichnis („root“) einer Domain. In dieser Datei kann festgelegt werden, ob und wie die Webseite von einem Webcrawler besucht werden darf. Der Webmaster hat so die Möglichkeit, ausgesuchte Bereiche der Website für (bestimmte) Suchmaschinen zu sperren. Das Protokoll ist rein hinweisend und ist auf die Mitarbeit des Robots angewiesen.
{{WT-ToDo|Beschreiben wie robots.txt funktioniert und dass es ggf. von webtrees automatisch erzeugt wird.}}

==== Standardmäßig blockierte Robots ====
webtrees enthält eine "Bad Bot Blocker"-Komponente. Diese filtert jede Anfrage an ihre Website.

Die folgenden Robots werden standardmäßig blockiert

* Robots mit einem User-Agent-String, der sie als Datensammler für Werbetreibende oder Suchmaschinenoptimierer usw. ausweist.
* Robots, die ihren User-Agent-String fälschen. Zum Beispiel Robots, die behaupten, von Google zu sein, aber nicht von einer Google-IP-Adresse aus operieren<ref>Daher muss bei der Konfiguration von Webserver und Proxy darauf geachtet werden, dass die zugreifende IP-Adresse an webtrees durchgereicht wird.</ref>.
Wenn ein Robot blockiert wurde, wird im Webprotokoll ein Statuscode 406 angezeigt.

==== Blockieren ganzer Netze oder Organisationen ====
Der "Bad Bot Blocker" kann auch ganze IP-Netze blockieren. Das Internet besteht aus vielen kleineren, miteinander verbundenen Netzen. Jedes dieser Netze hat eine Kennung, die so genannte "AS-Nummer". Sie können die AS-Nummer für eine konkrete IP-Adresse mit einer WHOIS-Suche herausfinden.

Um diese Funktion zu aktivieren, erstellen Sie einen Eintrag für <code>block_asn</code> in der Datei <code>/data/config.ini.php</code>. Dies ist ein freies Format - webtrees sucht nach den Zeichenfolgen ASnnnnn an beliebiger Stelle in diesem Eintrag. Zum Beispiel:

<code>block_asn="Böse Firma=AS123456, Böse Organisation:AS654321"</code>

Normalerweise werden Sie dies verwenden, um Server-Hosting-Unternehmen zu blockieren, die in dem Ruf stehen, Kunden jede Art von Dienst (Spamming, Scanning, Hacking usw.) zu erlauben, ohne Fragen zu stellen.

==== Blockieren von IP-Adressbereichen ====
Einzelne IP-Adressen oder ganze IP-Adressbereiche können über eine Funktion des Apache-Webservers für den Zugriff gesperrt werden, sofern ein solcher im Einsatz ist. Dazu erfolgt ein Eintrag in der <code>.htaccess</code>-Datei, der beispielsweise so aussehen kann, um zwei konkrete IP-V4-Adressen auszuschließen:
Order Allow,Deny
Allow from all
Deny from 5.188.62.21 5.188.62.26
Neben der Sperrung von einzelnen IP-V4 oder -V6-Adressen, können die Zugriffe auch für ganze Subnetze gesperrt werden.<ref>siehe https://htaccessbook.com/block-ip-address/</ref>

=== Cookies ===
webtrees verwendet ein First-Party-Session-Cookie namens "__Secure-WT-ID". Es ist technisch erforderlich und bedarf daher nicht der Zustimmung des Nutzers.
{{WT-ToDo|Hinweis auf weitere Cookies, etwa von GVExport oder von Drittdiensten}}

=== Drittdienste ===
{{WT-ToDo|beschreiben, dass die Statistikgrafiken derzeit auf Google-Technik basieren und daher IP-Adressen an Google transferiert werden}}
Die html-Blöcke auf der Startseite eines Stammbaums und auf der "Meine Seite" unterstützen auch die Einbindung von externen Webseiten (etwa um externe Grafiken oder externen Code dort einzubinden). Damit gelangen auch Informationen über die Nutzer der Website an Drittdienste, so dass diese Funktionen in einer individuell erstellten Datenschutzerklärung dokumentiert werden müssen.

=== Nachverfolgungs- und Analyse-Dienste ===
{{WT-ToDo|Die einzelnen Dienste noch genauer beschreiben}}
Der Administrator kann in webtrees verschiedene [[Webtrees Handbuch/Anleitung für Administratoren/Module|Nachverfolgungs- und Analyse-Module]] aktivieren.
* Bing™ Webmaster Tools - https://www.bing.com/toolbox/webmaster
* Google™ Analytics - https://www.google.com/analytics
* Google™ Webmaster Tools - https://www.google.com/webmasters
* Matomo™ / Piwik™ Analytics - https://matomo.org
* Statcounter™ - https://statcounter.com
Diese Module erfassen und speichern Nutzungsinformationen und bereiten diese in Statistiken auf. Sobald diese Module aktiviert werden, werden die Hinweise in der automatisch erzeugten Datenschutzerklärung entsprechend ergänzt.

=== Datenschutzerklärung und Impressum ===
{{WT-ToDo|Die Standard-Erklärung beschreiben; Erweiterungsmodul anpassen als Alternativlösung beschreiben.}}
*

== Suchmaschinenoptimierung ==
Die Auffindbarkeit von webtrees-Seiten durch Suchmaschinen kann erwünscht oder unerwünscht sein.

Wenn man nicht möchte, dass die Seiten gefunden werden, muss man die im Abschnitt "[[Webtrees Handbuch/Anleitung für Webmaster#robots.txt|robots.txt]]" beschriebene Funktion nutzen und die Einstellungen in der webtrees-Verwaltung wie im Abschnitt "[[Webtrees_Handbuch/Anleitung_für_Verwalter#Datenschutz|Datenschutz]]" verwenden, um Informationen für Besucher unsichtbar zu machen. Suchmaschinen greifen mit den selben Rechten auf webtrees-Seiten zu wie Besucher.

Auf der anderen Seite kann es sinnvoll sein, dass einige der Informationen, die man in den Stammbäumen hinterlegt hat, durch Suchmaschinen indiziert werden. So können andere Familien- oder Ahnenforscher oder entfernte Familienmitglieder auf diese Informationen aufmerksam werden, wenn sie etwa nach einem Familiennamen im Internet suchen. Dadurch kann man dann mit diesen in Kontakt kommen und so die eigene Forschung entsprechend erweitern.

{{WT-ToDo|
; Noch beschreiben: Was beeinflusst die Rangfolge bei den Suchtreffern? Wie unterstützt webtrees dies?
}}

==== sitemap.xml ====
{{WT-ToDo|
;Die Funktion und der Aufbau von sitemap.xml muss noch beschrieben werden ...
}}
{{WT-ToDo|
;Ergänzen von Hinweisen zu den Seiten von Suchmaschinen wo man die sitemap.xml einreichen kann
}}

== Backup der genealogischen Daten und der Datenbank ==
Da ein jedes IT-System durch technische Probleme, durch Fehlkonfigurationen, Anwenderfehler oder durch Cyber-Attacken gestört werden kann, ist es unbedingt erforderlich ein Backup-Konzept zu erstellen. Die webtrees-Anwendung selbst kann jederzeit wieder frisch installiert werden, aber die genealogischen Daten und die in der Datenbank hinterlegten Einstellungen müssen regelmäßig gesichert werden.

Eventuell legt der Hosting-Anbieter bereits automatisch regelmäßige Backups an. Wenn dies nicht der Fall sein sollte, muss der Webmaster sich selbst darum kümmern.

=== Backup der genealogischen Daten ===
Um die genealogischen Daten zu sichern, sollten alle in webtrees angelegten Stammbäume regelmäßig durch den Webmaster als [[GEDCOM]]-Datei [[Webtrees_Handbuch/Anleitung_für_Verwalter#Export|exportiert]] werden. Diese [[GEDCOM]]-Dateien sollten mit einem Datum im Dateinamen versehen werden und nicht nur auf dem Server gespeichert werden, sondern auch auf einem anderen sicheren Datenträger archiviert werden. Dieser Datenträger sollte nicht online sein, d.h. er sollte nicht permanent aus dem Internet zugänglich sein.

Auch die Ortseinträge im Verwaltungsmenü ganz unten sollten regelmäßig als separate Datei exportiert werden.

Die Mediendateien, die etwa im webtrees-Verzeichnis <code>/data/media</code> gespeichert sind, müssen ebenfalls regelmäßig mit Hilfe eines [https://de.wikipedia.org/wiki/Kategorie:FTP-Client ftp-Programms] gesichert werden. Die Vorschaubilder (thumbnails) müssen nicht gesichert werden, da sie von webtrees automatisch wieder neu erzeugt werden.

Auch die Einstellungen in <code>/data/config.ini.php</code> müssen gesichert werden.

{{Infobox|'''Alternative''' 
webtrees bietet alternativ auch die Möglichkeit, dass der Verwalter oder der Administrator anstelle des Webmasters die Datensicherung übernehmen können. Dazu muss der Verwalter für seinen Stammbaum oder der Administrator für alle Stammbäume das [[Webtrees_Handbuch/Anleitung_für_Verwalter#Export|Verwaltungsmenü]] aufrufen und dort einen Export der [[GEDCOM]]-Daten und der zugehörigen Mediendateien, in einer ZIP-Datei verpackt, anstoßen.}}

=== Backup der webtrees-Datenbank ===
Laut der [https://dev.webtrees.net/statistics.html Installationsstatistik] wird produktiv im wesentlichen das DBMS MySQL/MariaDB eingesetzt. Daher beschränken sich die Beschreibungen in diesem Abschnitt der Einfachheit halber nur darauf.

<gallery perrow=1 widths="250" caption="phpMyAdmin v5.2.0" style="float:right;">
Datei:WT_phpMyAdmin_Export.png|Export/Datensicherung
Datei:WT_phpMyAdmin_Import.png|Import/Wiederherstellung
</gallery>
Ein gebräuchliches webbasiertes Werkzeug ist "phpMyAdmin"<ref>{{wikipedia-Link|PhpMyAdmin}}</ref>, worüber Hosting-Anbieter zumeist auch den Zugang zu der von webtrees genutzten Datenbank ermöglichen.

Wählen Sie für die '''Datensicherung''' im Hauptfenster von phpMyAdmin im oberen Menü "Exportieren" für die gewünschte Datenbank aus. In der Regel sollte die Exportmethode "schnell" bereits die notwendigen Optionen gesetzt haben. Wichtig ist, dass als Ausgabeformat SQL genutzt wird. Nach Klicken auf die Schaltfläche "Exportieren" bzw. OK muss nach einigen Sekunden lediglich der Speicherort benannt werden, um die Sicherung auf Ihren Computer herunterzuladen.

Für die '''Wiederherstellung''' bzw. Installation einer gesicherten Datenbank wechseln Sie in phpMyAdmin zur gewünschten Ziel-Datenbank oder erstellen eine neue. Sofern die Datenbank noch Tabellen enthält, sollten diese in Abhängigkeit von den Exporteinstellungen der Datensicherung/der SQL-Datei ggf. vor dem Import gelöscht werden.<ref>Ein Blick in den SQL-Quelltext gibt Aufschluss, ob die Datenbank vorbereitet werden muss: Sind dort Angaben wie <code>DROP TABLE IF EXISTS [TABELLENNAME]; CREATE TABLE [TABELLENNAME] ...</code> ersichtlich, ist nichts zu tun.</ref>
Wählen Sie im Hauptfenster im oberen Menü „Importieren“ aus. Im darauf folgenden Formular sollte es ausreichend sein lediglich die Quell-Datei anzugeben und den Vorgang mit den gegebenen Voreinstellungen über Klicken auf die Schaltfläche "Importieren" bzw. OK zu starten. phpMyAdmin gibt Auskunft über das Ergebnis der Wiederherstellung.
{{-}}

Für das '''Vorgehen per Kommandozeile''' nachfolgend Beispiel-Kommandos in 2 Varianten (mit [1] komprimierter und [2] unkomprimierter Datei) für die Eingabe in einer Linux-Shell. Das gewünschte Beispiel-Kommando ohne Zeilennummer kopieren und die in eckigen Klammern gesetzten Platzhalter entsprechend durch die eigenen Angaben ersetzen. Eine Adaptierung auf andere Betriebssysteme sollte zumindest in der unkomprimierten Form unproblematisch sein.

Sicherung:
<syntaxhighlight lang="Bash" line>
mysqldump --single-transaction --quick -u [Datenbankbenutzer] -p [Datenbankname] | gzip > ~/datenbankexport.sql.gz
mysqldump --single-transaction --quick -u [Datenbankbenutzer] -p [Datenbankname] > ~/datenbankexport.sql
</syntaxhighlight>

Der Datenbank-Benutzer sollte dabei über PROCESS-Privilegien<ref>Vgl. https://dev.mysql.com/doc/refman/5.7/en/privileges-provided.html#priv_process</ref> verfügen oder es muss zusätzlich die Option <code>--no-tablespaces</code> übergeben werden.<ref>Vgl. https://dba.stackexchange.com/questions/271981/access-denied-you-need-at-least-one-of-the-process-privileges-for-this-ope</ref>

Für die Automatisierung von zeitgesteuerten Backups könnte das Kommando folgendermaßen aussehen:
<syntaxhighlight lang="Bash" line>
mysqldump --defaults-extra-file=[Konfigurationsdatei] --single-transaction --quick --no-tablespaces [Datenbankname] | gzip > ~/datenbankexport.sql.gz
mysqldump --defaults-extra-file=[Konfigurationsdatei] --single-transaction --quick --no-tablespaces [Datenbankname] > ~/datenbankexport.sql
</syntaxhighlight>
Die genannte Konfigurationsdatei muss zuvor mit nachfolgendem Inhalt erstellt werden:
<syntaxhighlight lang="ini">
[client]
user=[Datenbankbenutzer]
password=[Datenbankbenutzer-Passwort]
</syntaxhighlight>

Wiederherstellung:
<syntaxhighlight lang="Bash" line>
gunzip -c ~/datenbankexport.sql.gz | mysql -u [Datenbankbenutzer] -p [Datenbankname]
mysql -u [Datenbankbenutzer] -p [Datenbankname] < ~/datenbankexport.sql
</syntaxhighlight>

=== Neuinstallation von webtrees-Dateien ===
Löschen Sie alle Ordner im webtrees-Verzeichnis bis auf den Ordner <code>/data</code>. Löschen Sie im Hauptverzeichnis alle Dateien bis auf die Datei <code>.htaccess</code>. Nun laden Sie wie bei der [[Webtrees_Handbuch/Anleitung_für_Webmaster#Erstinstallation_von_webtrees|Erstinstallation]] die aktuellste Version von webtrees auf ihren lokalen PC und dann mit einem [https://de.wikipedia.org/wiki/Kategorie:FTP-Client ftp-Programm] auf ihren Server ins Verzeichnis webtrees.

== [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule|Erweiterungsmodule]] ==
webtrees ist so konzipiert, dass es durch Module erweitert und modifiziert werden kann. Erweiterungsmodule sind entweder funktionale Erweiterungen des webtrees-Kerns oder zusätzliche Themen (Gestaltung der Bedienoberfläche), welche von Mitgliedern der webtrees-Gemeinschaft erstellt und der Allgemeinheit zur Verfügung gestellt wurden. Erweiterungsmodule sind nicht Bestandteil der Erstinstallation von webtrees oder von Upgrades und müssen daher separat installiert und aktualisiert werden.

Auf einer eigenen [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule|Unterseite]] werden alle bekannten Erweiterungsmodule aufgeführt, welche entweder auf der webtrees-Seite "[https://webtrees.net/download/modules Download - Modules and themes]" oder in [https://github.com GitHub] veröffentlicht wurden.

{{Infobox|'''Downgrade'''

Im allgemeinen ist ein Downgrade, also der Übergang auf eine frühere Version von webtrees, nicht möglich. Die Ursache liegt darin, dass Upgrades eventuell Änderungen an der Datenbankstruktur (oft als „Schema“ bezeichnet) vornehmen. Der Code einer früheren Version funktioniert dann nicht mit der neuen Datenbankstruktur. Daher können Sie nur auf eine Version downgraden, die die gleiche Datenbankstruktur verwendet.

Um das zu verifizieren, müssen Sie in der Datei <code>app/Webtrees.php</code> nach einer Zeile suchen, die so ähnlich aussieht:
<code>define('WT_SCHEMA_VERSION', 34);</code>. Wenn beide Versionen von webtrees dieselbe Schemaversion haben, können Sie ein Downgrade durchführen. Befolgen Sie für ein Downgrade dasselbe Verfahren wie für ein manuelles Upgrade.}}

== Einzelnachweise ==
<references />

[[Kategorie:Webtrees]]

Webtrees Handbuch/Anleitung für Verwalter

2023-03-14T20:39:32Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Kapitel 6|info=1}}{{WT-Inhaltsverzeichnis|Kapitel 6|A}}

<div style="float:left; margin-right:2em;">[[Datei:WT_2.0_Meine-Seiten-Menue-Verwaltung.png|thumb|250px|Kopfmenü: Meine Seiten - Verwaltung]]</div>
Ein '''Verwalter''' bekommt seine Berechtigungen immer nur bezogen auf einen spezifischen Stammbaum. Sind in der webtrees-Instanz mehrere Stammbäume angelegt, sieht der Verwalter im Verwaltungsmenü nur diejenigen Stammbäume für die er eine Berechtigung besitzt. Er kann also keine Benutzer verwalten, keine Einstellungen der Website ändern und keine Module aktivieren oder deaktivieren. Er hat aber die Möglichkeit, die Zugangsberechtigung zu seinen Stammbäumen und die Konfiguration seiner Stammbäume zu ändern. Der Verwalter öffnet zur Verwaltung seiner Stammbäume im Kopfmenü "Meine Seiten" den Punkt "Verwaltung".

<div style="clear:left;"/>

== Stammbäume verwalten ==
<div style="float:right;">[[Datei:WT_2.1_Stammbaeume-verwalten-Verwalteransicht.png|thumb||350px|Stammbäume verwalten - Verwalteransicht]]</div>
Wenn der Verwalter einen der angezeigten Stammbaum auswählt, öffnet sich dort das zu diesem Stammbaum gehörige Aufklapp-Element (genannt "Akkordeon-Menü") mit den im folgenden beschriebenen Bearbeitungsoptionen, die in vier Kategorien eingeteilt sind
* [[#Stammbaum|Stammbaum]]
* [[#Genealogische_Daten|Genealogische Daten]]
* [[#Nicht_verknüpfte_Datensätze_hinzufügen|Nicht verknüpfte Datensätze hinzufügen]]
* [[#GEDCOM-Datei|GEDCOM-Datei]]
{{-}}

=== Stammbaum ===
Unter dieser Kategorie sind alle Funktionen für die Verwaltung eines Stammbaums zusammengefasst.
{{-}}

==== Startseite ====
Mit diesem Link kann direkt auf die "'''Startseite'''" dieses Stammbaums gesprungen werden. Dort kann dann diese Startseite modifiziert werden.
{{-}}

==== Einstellungen ====
Unter diesem Punkt öffnet sich eine sehr umfangreiche Konfigurationsseite mit vielen Möglichkeiten die Einstellungen des Stammbaums zu ändern.

[[Datei:Webtrees- Verwaltung - Stammbäume Einstellungen Allgemeines.png|alternativtext=Stammbaum-Einstellungen Allgemeines|thumb|350px|Stammbaum-Einstellungen Allgemeines]]
Im ersten Abschnitt "'''Allgemeines'''" sind die beiden Namensfelder "Titel des Stammbaums" und "Internetadresse" zu finden, die auch bei der Anlage eines neuen Stammbaums vergeben werden.

Die Startperson kann aus den Daten der bereits erfassten Personendatensätze ausgewählt werden. In vielen Auswertungen wird zunächst auf die Startperson Bezug genommen. Diese Vorbelegung kann jedoch individuell geändert werden.

webtrees verfügt über mächtige Kalenderfunktionen und automatische Umrechnungen zwischen verschiedenen Kalendersystemen. Die beiden Auswahlfelder bieten die Möglichkeit häufig verwendete Kalender zu selektieren und festzulegen.

Mit der Einstellung "Eindeutige Kennungen hinzufügen" kann für jeden Datensatz automatisch ein entsprechender Schlüssel erzeugt und in einem Datensatz mit dem GEDCOM-Kennzeichen "_UID" abgespeichert werden. Diese Einstellung kann beim Austausch mit anderen Genealogieprogrammen von Bedeutung sein. Für den Betrieb von webtrees ist sie nicht erforderlich.
{{-}}

[[Datei:Webtrees- Verwaltung - Stammbäume Einstellungen für Kontaktangaben und Webseite.png|alternativtext=Stammbaum-Einstellungen für Kontaktangaben und Webseite|thumb|350px|Stammbaum-Einstellungen für Kontaktangaben und Webseite]]
Im Abschnitt "'''Kontaktangaben'''" werden aus den in der Benutzerverwaltung angelegten Personen die entsprechenden Ansprechpartner für genealogische bzw. technische Fragen bestimmt. Diese Angaben stehen zur Verwendung im Seitenfuß zur Verfügung.

Unter "'''Webseite'''" können Angaben zu Titel und Metadaten hinzugefügt werden, die im Header-Bereich der Webseite aufgenommen werden und damit für Besucher und Suchmaschinen von Bedeutung sind.
{{-}}

[[Datei:WT_2.1_Verwaltung-Stammbaeume_Einstellungen_Mediendateien.png|alternativtext=Stammbaum-Einstellungen für Mediendateien|thumb|350px|Stammbaum-Einstellungen für Mediendateien]]
Zum Umgang mit "'''Mediendateien'''" kann per Auswahlfeld festgelegt werden, wer Dateien in den Stammbaum hochladen darf und wer einen Downloadlink angezeigt bekommen soll.
{{-}}

[[Datei:WT 2.1 Verwaltung-Stammbaeume Einstellungen Vorschaubilder und Wasserzeichen.png|alternativtext=Stammbaum-Einstellungen Vorschaubilder und Wasserzeichen|thumb|350px|Stammbaum-Einstellungen Vorschaubilder und Wasserzeichen]]
Im Abschnitt "'''Vorschaubilder'''" wird festgelegt, ob sie angezeigt werden, und ob neutrale Platzhalter verwendet werden, wenn kein Vorschaubild vorhanden ist.

Vorschaubilder können mit überlagertem "'''Wasserzeichen'''" angezeigt werden, um die Herkunft der Bilder zu kennzeichnen und damit einen - wenn auch kleinen - Schutz gegen unberechtigte Verwendung zu haben. Als Standard-Wasserzeichen wird ein kleines "w" für webtrees verwendet. 
Eine Personalisierung des Wasserzeichens ist leider nur durch Austauschen der Datei <code>resources/img/watermark.png</code><ref>https://github.com/fisharebest/webtrees/blob/main/resources/img/watermark.png</ref> möglich, was bei einem [[Webtrees_Handbuch/Anleitung_f%C3%BCr_Webmaster#Upgrade|Upgrade]] wiederholt werden muss. Die Datei sollte einen transparenten Hintergrund und eine dezente Overlay-Grafik enthalten, damit das eigentliche Bild nicht zu sehr überdeckt wird.<ref>Vgl. dazu auch den Forumsbetrag https://www.webtrees.net/index.php/en/forum/help-for-1-7/33483-solved-custom-watermark</ref>
{{-}}

[[Datei:WT 2.1 Verwaltung-Stammbaeume Einstellungen Listen und Diagramme.png|alternativtext=Stammbaum-Einstellungen Listen und Diagramme|thumb|350px|Stammbaum-Einstellungen Listen und Diagramme]]
Der Abschnitt "'''[[Webtrees_Handbuch/Anleitung_für_Besucher#Listen|Listen]]'''" beeinflusst deren Darstellung in dem entsprechenden Kopf-Menü. Sie können die Darstellungsform, die Anzahl der angezeigten Namen, die Anzeige von geschätzten Geburts- und Sterbedaten sowie die Anzeige der letzten Aktualisierung festlegen.

Auch die Darstellung der "'''[[Webtrees_Handbuch/Anleitung_für_Besucher#Diagramme|Diagramme]]'''" im entsprechenden Kopf-Menu kann beeinflusst werden. Die erste Auswahl legt fest, ob das Alter der Eltern neben dem Geburtsdatum des Kindes erscheinen soll. Zusätzliche Ereignisse können durch Mehrfachauswahl im entsprechenden Feld hinzugefügt werden.{{-}}

[[Datei:WT 2.1 Verwaltung-Stammbaeume Einstellungen Personenseite und Orte.png|alternativtext=Stammbaum-Einstellungen Personenseite und Orte|thumb|350px|Stammbaum-Einstellungen Personenseite und Orte]]
Im Abschnitt "'''[[Webtrees_Handbuch/Anleitung_für_Besucher#Personenseite_mit_Reitern_und_Navigationsleiste|Personenseite]]'''" kann mit den vorhandenen Optionen die Darstellung des Karteireiters "Tatsachen und Ereignisse" geändert werden. Durch die Auswahl der Checkboxen hier wird festgelegt, welche Ereignisse von nahen Verwandten angezeigt werden, wenn auf der jeweiligen Personenseite die Checkbox "Ereignisse naher Verwandter" aktiviert ist.

Tatsachensymbole sind abhängig von den eingestellten Themen und können ein- oder ausgeschaltet werden.

Mit den beiden weiteren Einstellungen lässt sich festlegen, ob beim Aufruf der Personenseite die dort vorhandenen "Notizen" und "Quellenangaben" bereits automatisch aufgeklappt werden sollen.

Unter "'''Orte'''" lässt sich einstellen, wie viele Ebenen (maximal 9) der Ortsnamen "Altstadt, Dresden, Sachsen, Deutschland" angezeigt werden sollen und ob dabei von vorne oder hinten angefangen wird.
{{-}}

[[Datei:WT 2.1 Verwaltung-Stammbaeume Einstellungen Text und Allgemeines.png|alternativtext=Stammbaum-Einstellungen Text und Allgemeines|thumb|350px|Stammbaum-Einstellungen Text und Allgemeines]]
webtrees bietet die Möglichkeit, Texte in den dafür vorgesehenen Feldern unformatiert oder formatiert darzustellen. Unter "'''Text'''" kann zwischen "unformatierter Text" oder "Markdown" gewählt werden. Markdown nutzt eine installierte Zusatzbibliothek, die eine einfache Textformatierung mittels festgelegter Sonderzeichen erlaubt. Um die Kompatibilität mit anderen Genealogieanwendungen zu gewährleisten, sollten Notizen, Texte und Abschriften als einfacher, unformatierter Text aufgenommen werden. Allerdings ist eine Formatierung oft wünschenswert, um die Präsentation und das Verständnis der Informationen zu unterstützen. Markdown ist ein einfaches System für solche Formatierungen. Es nutzt unaufdringliche Satzzeichen, um Überschriften, fette und kursive Texte, Listen, Tabellen usw. zu erstellen. <ref>Weitere Details zur eingesetzten Bibliothek CommonMark sind unter https://commonmark.org/ zu finden. Eine zusätzliche Anreicherung des Textes mit HTML-Tags, wie sie bei GEDCOM 7.0 vorgesehen ist, wird nicht unterstützt.</ref> Die mit Markdown angereicherten Texte sind aber immer noch gut lesbar, auch wenn kein Markdown-Interpreter verwendet wird.

Unter "'''Allgemeines'''" legen Sie fest, ob Sie den Besuchern des Stammbaums Einsicht in die GEDCOM-Rohdaten gestatten wollen und ob Sie GEDCOM-Fehler anzeigen lassen.

Auch die Anzeige eines "Besucherzählers" lässt sich hier aktivieren.
{{-}}

[[Datei:WT 2.1 Verwaltung-Stammbaeume Einstellungen Personenereignisse und Familienereignisse.png|alternativtext=Stammbaum-Einstellungen Personenereignisse und Familienereignisse|thumb|350px|Stammbaum-Einstellungen Personenereignisse und Familienereignisse]]
Für die "'''Personenereignisse'''" wird zwischen Neuanlage und späterem Editieren unterschieden. Mit dem oberen Auswahlfeld können Sie mittels Mehrfachauswahl festlegen, welche Eingabemasken bei der Neuanlage von Personen zur Verfügung stehen sollen. Mit dem unteren Auswahlfeld können Sie ebenfalls mittels Mehrfachauswahl festlegen, welche Ereignisse zur schnelleren Bearbeitung in einer Kurzliste für das spätere Hinzufügen von Personendaten am unteren Ende des Personendatensatzes angeboten werden sollen.

Für "'''Familienereignisse'''" gilt das unter Personenereignisse gesagte entsprechend.
{{-}}

[[Datei:WT 2.1 Verwaltung-Stammbaeume Einstellungen Andere.png|alternativtext=Stammbaum-Einstellungen Andere Einstellungen|thumb|350px|Stammbaum-Einstellungen Andere Einstellungen]]
Unter "'''Andere Einstellungen'''" stehen weitere Optionen zur Verfügung.

Die "Nachnamens-Tradition" legt fest, gemäß welcher in der Welt vorhandenen Tradition die Namen in Ihrem Stammbaum in der Mehrzahl folgen. In Einzelfällen kann davon jederzeit abgewichen werden.

Ob Sie "Vollständige Quellenzitate benutzen" wollen oder müssen, hängt von dem bei Ihnen gebräuchlichen Schema ab und kann hier gesteuert werden. Es ist kein Nachteil diese Einstellung auf "Nein" zu belassen, da Quellen trotzdem vollständig beschrieben werden können, wenn das erforderlich ist.

Unter "Quellenzitatentyp" legen Sie beim Hinzufügen von Personen fest, ob Quellenangaben gemacht werden und ob diese zur Tatsache (BIRT, DEAD oder [[GEDCOM/MARR-Tag|MARR]]) bzw. zum Datensatz ([[GEDCOM/INDI-Tag|INDI]] oder [[GEDCOM/FAM-Tag|FAM]]) gehören sollen. Auch diese Festlegung kann durch späteres Editieren der Personendatensätze jederzeit angepasst werden.

Wenn ein Datensatz bearbeitet wird, werden der Benutzer und der Zeitstempel aufgezeichnet. Manchmal ist es wünschenswert, die bestehenden Informationen zur "letzten Änderung" beizubehalten, z.B. wenn nur kleinere Korrekturen an den Daten einer anderen Person vorgenommen werden. Mit der Option "Den Eintrag Letzte Änderung beibehalten" wird gesteuert, ob diese Funktion standardmäßig ausgewählt ist.
{{-}}

==== Datenschutz ====
[[Datei:WT 2.1 Verwaltung-Stammbaeume Datenschutz.png|alternativtext=Datenschutzeinstellungen eines Stammbaums|thumb|350px|Datenschutzeinstellungen eines Stammbaums]]

===== Datenschutz für Stammbäume =====
Standardmäßig sind Stammbäume öffentlich sichtbar, wobei jeder Datensatz innerhalb des Stammbaums seinen eigenen Datenschutzregeln unterliegt.
In der Option "Den Stammbaum zeigen" kann zwischen "sichtbar für Besucher" (= vollständig öffentlich) und "sichtbar für Mitglieder" (= vollständig vertraulich) gewählt werden. Für noch wenig erfahrene webtrees-Anwender wird für den Anfang die Einstellung "sichtbar für Mitglieder" empfohlen, bis genügend Erfahrung und Übersicht über die gesamten Datenschutz-Einstellungen gegeben sind. Dadurch ist der Baum zunächst für Besucher und Suchmaschinen nicht sichtbar. In der Einstellung "sichtbar für Besucher" sind weitere Datenschutzeinstellungen erforderlich bzw. ist auch eine völlige Freigabe der Daten möglich.

===== Datenschutzregeln für alle Personen =====
Wenn Sie "Verstorbene Personen zeigen" auf "sichtbar für Besucher" stellen, sind die weiteren Einstellungen von Bedeutung.

webtrees kann ausgehend vom Geburtsdatum mit dem "Alter, ab dem angenommen wird, dass eine Person verstorben ist" kalkulieren. Diese Eingabe ist wahlfrei und abhängig von Ihren Daten und beeinflusst damit verschiedene Zähler und Auswertungen.

Wenn Sie "Lebende Personen zeigen" auf "sichtbar für Besucher" stellen, wird der Stammbaum vollständig öffentlich und alle Datenschutzprüfungen deaktiviert. Sie können dies bei einem Stammbaum tun, der nur öffentliche Informationen enthält. Die Deaktivierung der Datenschutzprüfungen verbessert die Verarbeitungsgeschwindigkeit.

Die Option "Datenschutz auf Verstorbene ausweiten" steuert, nach wie viel Jahren ab Geburtsjahr bzw. ab Todesjahr die Person nicht mehr unter Datenschutz fällt. Nach deutschem Datenschutzrecht müssen hier 110 Jahre ab Geburt und 30 Jahre ab Tod eingehalten werden.

Die Option "Namen vertraulicher Personen zeigen" wird in der Regel auf "sichtbar für Mitglieder" eingestellt sein. Sie können den Datenschutz jedoch lockern, indem Sie auf "sichtbar für Besucher" stellen. Damit werden zwar die Namen, aber keine weiteren Informationen von noch unter Datenschutz fallenden Personen angezeigt.

Ähnliches gilt für Option "Vertrauliche Beziehungen anzeigen". Mit der Einstellung "sichtbar für Besucher" bleiben die Familienverknüpfungen zwischen vertraulichen Datensätzen erhalten. Das bedeutet, dass Sie leere "Vertraulich"-Platzhalter in Diagrammen und Listen sehen werden.

===== Datenschutz für einzelne Personen =====
{{WT-ToDo|Noch beschreiben: RESN kann bei webtrees in allen Datensatztypen verwendet werden, das widerspricht dem GEDCOM-Standard 5.5.1, ist aber konform mit GEDCOM-L und GEDCOM 7.0}}

===== Datenschutz für alle Datensätze eines Typs =====
Die Objekte im Stammbaum wie Personen, Familien, Quellen oder Medienobjekte werden in Datensätzen gespeichert. Datenschutzbeschränkungen für einzelne Datensätze werden in der Bedienoberfläche auf die gleiche Weise hinzugefügt wie andere Fakten wie etwa Geburt, Heirat oder Tod.

Unter "'''Einschränkungen Datenschutz'''" können Sie generelle Zugriffsrechte für einzelne Datensätze setzen, indem Sie eine Einschränkung hinzufügen. Wenn ein Datensatz keine individuelle Einschränkung (RESN) aufweist, gelten die eingestellten Einschränkungen.{{-}}

Wenn ein Datensatz keine individuelle Datenschutzbeschränkung hat, berücksichtigt webtrees die "Datenschutzregeln" in den [[Webtrees_Handbuch/Anleitung_für_Verwalter#Datenschutz|Datenschutzeinstellungen des Stammbaums]]. Wenn ein Datensatz eine individuelle Datenschutzbeschränkung aufweist, hat diese Vorrang vor der des Stammbaums. Auf diese Weise lässt sich der Schutz einzelner Datensätze sowohl erhöhen als auch verringern.

Sie können eine Regel für alle Datensätze eines bestimmten Typs festlegen (mit Ausnahme von Einzelpersonen und Familien, für die eine besondere Logik gilt).

Sie können auch eine Regel für einen bestimmten Datensatz festlegen. Diese Funktion ist für Personen gedacht, die webtrees verwenden, um Daten anzuzeigen, welche in einer anderen Anwendung verwaltet werden, die keine Einschränkungen der Privatsphäre unterstützt. Je nach Bedürfnis, können Sie den Datensätzen selbst Datenschutzbeschränkungen hinzufügen.

Standardmäßig haben neue Stammbäume Regeln, um alle Quellen, Archive und Einreicher vertraulich zu behandeln.

Wenn es keine Datenschutzregel für den Datensatz gibt, dann verwendet webtrees die folgende Logik für jeden Datensatztyp:

'''Personensätze''' Lebende Personen sind vertraulich, verstorbene Personen sind öffentlich. Wenn es keine ausreichenden Informationen gibt, um festzustellen, ob die Person lebt oder verstorben ist, geht webtrees davon aus, dass sie lebt.

In den meisten Ländern endet das Recht auf Privatsphäre mit dem Tod. In anderen Ländern kann es noch z.B. wie in Deutschland für 30 Jahre aufrecht erhalten werden. In den Datenschutzeinstellungen gibt es eine Option, die dies unterstützt. Bitte beachten Sie, dass diese Option zu einer geringfügigen Beeinträchtigung der Leistung führt.

Sie können auch Datenschutzbeschränkungen auf nicht unmittelbare Familienmitglieder anwenden. Wenn ein Benutzer einem einzelnen Datensatz in einem Stammbaum zugeordnet ist und zugleich eine Rolle als Mitglied, Bearbeiter oder Moderator ausübt, können Sie den Zugriff auf Details von entfernten, lebenden Verwandten verhindern. Hierzu muss in der Benutzerverwaltung der Person die Anzahl der Beziehungsgrade angegeben werden, die der Benutzer sehen darf. Wenn Sie zum Beispiel eine Stufenweite von 2 angeben, wird diese Person in der Lage sein, ihre Enkel (Kind, Kind), ihre Tante (Eltern, Geschwister), ihre Stieftochter (Ehepartner, Kind), nicht aber ihre Cousine (Eltern, Geschwister, Kinder) zu sehen. Beachten Sie, dass diese Option bei einer großen Anzahl von Stufen zu Performanceverlusten führen kann.

Optional können Sie in den Stammbaumeinstellungen den Datenschutz für Einzelpersonen lockern. Damit werden die Namen, aber keine anderen Informationen von Privatpersonen angezeigt.

'''Familieneinträge''' Familieneinträge sind vertraulich, wenn irgendein Familienmitglied vertraulich ist. Dies gilt sowohl für die Kinder als auch für die Ehegatten. Sie können die Privatsphäre in Bezug auf Familien optional lockern. Dadurch wird die Struktur der Familien angezeigt, ohne dass die Details angezeigt werden.

'''Medien- und Notizdatensätze''' Medien- und Notizdatensätze sind vertraulich, wenn sie mit einem vertraulichen Datensatz verknüpft sind. Ansonsten sind sie öffentlich.

'''Quellen-Datensätze''' Quellen sind vertraulich, wenn sie mit vertraulichen Archiven verknüpft sind. Andernfalls sind sie öffentlich.

'''Andere Datensatztypen''' Andere Datensätze werden als öffentlich angesehen.

===== Datenschutz für einzelne Ereignisse und Fakten =====
Der Datenschutz für Fakten (Tatsachen oder Ereignisse wie z. B. Geburt, Heirat und Tod) verwendet Datenschutzbeschränkungen und -regeln auf dieselbe Weise wie Datensätze.
Unter "'''Einschränkungen Datenschutz'''" können Sie generelle Zugriffsrechte für einzelne Tatsachen oder Ereignisse setzen, indem Sie eine Einschränkung hinzufügen. Wenn eine Tatsache oder ein Ereignis keine individuelle Einschränkung (RESN) aufweist, gelten die eingestellten Einschränkungen.{{-}}

Sie können explizite Einschränkungen zu bestimmten Fakten hinzufügen oder die "Datenschutzregeln" verwenden, um sie auf alle Fakten eines bestimmten Typs anzuwenden.

Eine häufige Anwendung ist es, den Datensatz einer lebenden Person öffentlich zu machen, aber einige der Fakten vertraulich zu behandeln. Manche webtrees-Benutzer tun dies für ihren eigenen individuellen Datensatz.

{{WT-ToDo|Hier muss noch genauer beschrieben werden, wie "confidential", "locked" und "privacy" in webtrees interpretiert werden, da diese Interpretation vom GEDCOM-Standard stark abweicht. Die vom Standard abweichende Ergänzung durch "none" muss auch ausführlicher erklärt werden.}}
{{Infobox|In der Version 2.1.0 gibt es eine eventuell datenschutzrelevante Änderung bei der Verwendung des RESN-Tags gegenüber den Vorgängerversionen
(siehe Abschnitt "[[Webtrees_Handbuch/Anleitung_für_Webmaster/Anleitung_Upgrade_21#Mehrere_RESN-Tags_in_einem_Datensatz|Mehrere RESN-Tags in einem Datensatz]]").}}

===== Datenschutz für Attribute von Ereignissen und Fakten =====
Sie können keine individuellen Datenschutzeigenschaften für die Attribute eines Ereignisses oder Fakts anwenden, wie etwa ein Datum oder einen Ort, etc. Das liegt daran, dass dies vom GEDCOM-Standard nicht unterstützt wird.

Sie können jedoch zwei Versionen eines Ereignisses oder Fakts erstellen, die sich in einem Attribut unterscheiden, und nur eine davon mit einer Datenschutzbeschränkung versehen. Legen Sie die vertraulichen Details in der Version mit der Einschränkung ab.

Dies wird häufig verwendet, um die Todesursache einer Person zu verbergen.

==== Datenkorrekturen ====
{{Wichtig|Machen Sie sich unbedingt erst vertraut mit den Funktionen und den unterschiedlichen Wirkungsweisen der hier beschriebenen Datenkorrekturmöglichkeiten. Übung macht den Meister. Überlegen Sie gut, was Sie ändern wollen. Machen Sie vor den ersten Gehversuchen unbedingt eine Datensicherung in Form eines [[#Export|GEDCOM-Exports]]. Die Gefahr einer ungewollten Beschädigung der Daten im Stammbaum ist durchaus gegeben!}}

[[Datei:WT 2.1 Verwaltung-Stammbaeume Datenkorrekturen Auswahl.png|alternativtext=Datenkorrekturen Auswahl|thumb|350px|Datenkorrekturen Auswahl]]
In webtrees stehen mehrere mächtige Funktionen zur übergreifenden Korrektur der genealogischen Daten zur Verfügung. Einige dieser Funktionen dienen der Datenanpassung an die Vorgaben gemäß dem Standard GEDCOM 5.5.1. Die Verwendung ist für alle Funktionen ähnlich und wird unten beschrieben. Zunächst legen Sie in einem Auswahlfeld fest, welche Art von '''Datenkorrektur''' ausgeführt werden soll.

* Aktualisiere Ortsnamen - dient der Änderung von Ortsnamen oder Teilen der Ortshierarchie (GEDCOM-Tag PLAC)
* Doppelte Verknüpfungen entfernen - mehrfache Verknüpfungen zum selben Datensatz, etwa wenn ein Kind mehr als einmal in einem Familien-Datensatz aufgeführt ist, lassen sich finden und beheben
* Fehlende DEAT (Tod) Datensätze hinzufügen - ergänzt fehlende Todesereignisse in den Personendatensätzen und trägt damit zur Performance-Steigerung bei
* INDI:_WT_OBJE_SORT-Kennzeichen in GEDCOM 5.5.1 konvertieren - ersetzt früher verwendete Sortierkennzeichen für präferierte Bilder einer Person durch eine entsprechende Bilderreihenfolge
* INDI:BURI:CEME-Kennzeichen in GEDCOM 5.5.1 konvertieren - ersetzt in GEDCOM 5.5 gültige Friedhofkennzeichen durch entsprechende Ortseinträge
* INDI:NAME:_XXX-Kennzeichen in GEDCOM 5.5.1 konvertieren - konvertiert Namensdatensätze mit Tags wie _MARNM und _AKA. in mehrfache Namens-Datensätze
* OBJE:_PRIM-Kennzeichen in GEDCOM 5.5.1 konvertieren - überführt früher verwendete Sortierkennzeichen für präferierte Fotos einer Person in die entsprechende Bilderreihenfolge
* Schräg- und Leerzeichen in Namen korrigieren - regelwidrige Namenseinträge können mit dieser Funktion bereinigt werden
* Suchen und Ersetzen - siehe direkt hier nachfolgend
Durch [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodule]] können noch weitere Datenkorrekturfunktionen hinzukommen.[[Datei:WT 2.1 Verwaltung-Stammbaeume Datenkorrekturen Suchen und Ersetzen.png|alternativtext=Datenkorrekturen Suchen und Ersetzen|thumb|350px|Datenkorrekturen Suchen und Ersetzen]]
'''Suchen und Ersetzen''' ist die mächtigste von allen Korrekturfunktionen. Sie bietet unter anderem die Möglichkeit reguläre Ausdrücke<ref>{{wikipedia-Link|Regulärer_Ausdruck}}</ref> zu verwenden.

Wie bei einer Textverarbeitung geben Sie zunächst einen "Suchtext" (Suchregel) und einen "Ersatztext" vor.

Mit der "Suchmethode" legen Sie fest, wie die Suche erfolgen soll. (Die anderen oben genannten Korrekturfunktionen arbeiten nach einer intern festgelegten Suchmethode.)

Ob Groß- und Kleinschreibung berücksichtigt werden soll, können Sie ebenfalls einstellen.

Im Auswahlfeld "Datensätze" wird der Typ der zu durchsuchenden Datensätze (Archive, Familien, Medienobjekte, Notizen, Orte, Personen, Quellen, Übermittler) selektiert.

Das folgende gilt für alle obigen Korrekturfunktionen. Mit dem Button "Suche" werden zu Ihren Vorgaben passende Datensätze gesucht und in einer Tabelle angezeigt. Die Ergebniszeilen ermöglichen durch einen ''Klick'' auf den Datensatz in der linken Spalte direkt dorthin zu verzweigen. Der Button "Vorschau" in der rechten Spalte zeigt die Wirkung der Änderung in der GEDCOM-Struktur, ohne jedoch die Daten zu verändern. Dabei kann das Ergebnis eine Änderung, mehrere Änderungen oder auch keine Änderung beinhalten. Erst durch die Auswahl des Buttons "Bearbeiten" in der rechten Spalte oder "Alles bearbeiten" darüber wird die Korrektur der Daten ausgelöst. Vor einer einzelnen oder der gesamten Änderung der Daten ist die Vorschau dringend anzuraten, da man damit auch eigene Denkfehler entdecken kann.
{{-}}
{{Infobox|Die Verwendung regulärer Ausdrücke kann für extrem komplexe Such- und Ersetzungsmuster verwendet werden. Dieses Handbuch kann hier nicht auf alle Feinheiten eingehen, das würde den Rahmen sprengen. Weitergehende Fragen können auch im [https://www.webtrees.net/index.php/en/forum webtrees-Forum] geklärt und gestellt werden.}}

=== Genealogische Daten ===
Unter dieser Kategorie sind alle Verwaltungsfunktionen für die '''Pflege der "Genealogischen Daten"''' zusammengefasst.
{{-}}

==== Finde Duplikate ====
[[Datei:WT 2.1 Verwaltung-Stammbaeume Finde Duplikate.png|alternativtext=Finde Duplikate in einem Stammbaum|thumb|382x382px|Finde Duplikate in einem Stammbaum]]
Mit der Funktion "Finde Duplikate" durchsucht webtrees Archive, Quellen, Personendaten, Familiendaten und Medienobjekte.

Zum Auffinden von Duplikaten verwendet webtrees bei

* Personen: Namensgleichheit und ein Ereignis mit gleichem Datum
* Familien: Partnergleichheit
* Archiven, Quellen und Medienobjekten: Titelgleichheit

Wenn Dubletten gefunden werden, erscheinen Links auf die internen Referenzen (XREF) der Datensätze sowie eine Funktion zum "Zusammenfügen" oder "Verschmelzen" der Datensätze. Mit Anklicken der Funktion "'''Verschmelzen'''", gelangen Sie zur Überprüfung auf eine weitere Seite, mit der Sie die Datensätze zusammenfügen können (siehe nächster Abschnitt).
{{-}}

==== Datensätze zusammenfügen ====
[[Datei:WT 2.1 Verwaltung-Stammbaeume Datensaetze zusammenfuegen Auswahl.png|alternativtext=Auswahl der zusammenzufügenden Datensätze|thumb|350px|Auswahl der zusammenzufügenden Datensätze]]
Mit der Funktion "Datensätze zusammenfügen" gelangen Sie zunächst auf eine Auswahlmaske. Sie legen als erstes den Datensatztyp fest. Als nächstes wählen Sie den ersten und den zweiten Datensatz aus dem Bestand in diesem Stammbaum aus, entsprechend dem ausgewählten Datensatztyp. Sie können hier entweder Teile des Titels des Datensatzes zur Suche eingeben oder die XREF des Datensatzes, wenn sie diese kennen. Der erste Datensatz wird erhalten bleiben, der zweite wird nach der erfolgten Verschmelzung gelöscht. Die folgenden Datensatztypen stehen bei der Zusammenfügung zur Verfügung

* Personen (INDI)
* Familien (FAM)
* Quellen (SOUR)
* Archive (REPO)
* Notizen (NOTE) - gemeinsame Notizen
* Medienobjekte (OBJE)
* Übermittler (SUBM)
* Orte (_LOC) - Ortsdatensätze, die nicht Teil des GEDCOM-Standards sind<ref>Ortsdatensätze sind im [https://genealogy.net/GEDCOM/ GEDCOM-L Addendum] definiert. Sie müssen vom Administrator aktiviert werden. Bitte beachten: Ortsangaben bei einem Ereignis (PLAC) sind keine Ortsdatensätze; diese können nicht zusammengefügt werden; wenn man Ortsdatenangaben vereinheitlichen möchte, dann muss die Funktion [[Webtrees_Handbuch/Anleitung_für_Verwalter#Datenkorrekturen|Datenkorrektur]] "Aktualisiere Ortsnamen" ausgewählt werden.</ref>

{{-}}

[[Datei:WT 2.1 Verwaltung-Stammbaeume Datensaetze zusammenfuegen.png|alternativtext=Datensätze zusammenfügen|thumb|350px|Datensätze zusammenfügen]]
Im Weiteren (auch nach [[#Finde_Duplikate|"Finde Duplikate"]]) gelangen Sie zur Überprüfung auf die nächste Seite, mit der Sie die Datensätze zusammenfügen können. Auf der Seite finden Sie folgende drei Blöcke

* Die folgenden Tatsachen und Ereignisse wurden in beiden Datensätzen gefunden. (Dieser Block kann leer sein, wenn Sie zwei völlig unterschiedliche Datensätze ausgewählt haben.)
* Die folgenden Tatsachen und Ereignisse wurden nur im Datensatz "1" gefunden.
* Die folgenden Tatsachen und Ereignisse wurden nur im Datensatz "2" gefunden.

Neben den einzelnen Ereignissen bei den jeweiligen Datensätzen, die in der GEDCOM-Syntax dargestellt werden, befinden sich vorausgewählte Checkboxen. Sie können für jedes Ereignis festlegen, welches in den verschmolzenen Datensatz übernommen werden soll. Wenn etwa zwei verschiedene Schreibweisen für einen Namen vorliegen, müssen Sie sich nicht für eine Schreibweise entscheiden; sie können durchaus auch beide auswählen und so beide übernehmen. Mit Anklicken des Buttons "Speichern" lösen Sie die Verschmelzungsaktion aus. Überlegen Sie vorher gut, was Sie auswählen oder ausschließen!

Nach dem erfolgreichen Zusammenführen der Datensätze erhalten Sie am oberen Bildschirmrand eine entsprechende Kontrollmeldung. Der links dargestellte Datensatz enthält dann das verschmolzene Ergebnis, der rechts dargestellte Datensatz wird gelöscht. Alle Verweise auf diese beiden Datensätze werden automatisch korrigiert.
{{-}}

==== Fehlersuche ====
Mit dieser Funktion können Sie als Verwalter oder Administrator in dem ausgewählten Stammbaum nach grundlegenden Fehlern in den [[GEDCOM]]-Datensätzen suchen. Bei der Prüfung werden drei Stufen des Schweregrades der gefundenen Probleme unterschieden: Fehler (rot), Warnungen (gelb) und Informationen (blau).

* '''Falsche Struktur einer [[GEDCOM]]-Zeile''' Der [[GEDCOM]]-Standard gibt die Syntax einer Zeile vor; die Zeilen müssen immer mit einer Zahl, der Ebenennummer, beginnen; darauf folgt ein GEDCOM Kennzeichen; abhängig davon folgt ein Zeilenumbruch oder weiterer Inhalt. Wenn diese Syntax nicht eingehalten wird, liegt ein gravierender Fehler vor und kann zu unerwünschten Ergebnissen in der Anzeige der Daten führen.

* '''Falsche Ebenennummer''' Die Ebenennummer muss bei verschachtelten Strukturen jeweils um eine Stufe erhöht werden. Wenn bei der Prüfung ein Sprung um mehr als eine Stufe gefunden wird, dann ist das ein Fehler.

* '''Ungültige [[Webtrees Handbuch/Anleitung für Administratoren/Webseite#GEDCOM-Kennzeichen|GEDCOM-Kennzeichen]]''' Die [[Webtrees Handbuch/Anleitung für Administratoren/Webseite#GEDCOM-Kennzeichen|GEDCOM-Kennzeichen]], die verwendet werden dürfen, sind im Standard vollständig definiert. Sie können um benutzerspezifische Kennzeichen ergänzt werden, aber diese müssen mit einem Unterstrich eingeleitet werden. So etwa für Ortsdatensätze "[[GEDCOM/ LOC-Tag|_LOC]]". Wenn ein Kennzeichen auftaucht, das weder im Standard definiert ist noch mit einem Unterstrich beginnt, ist das ebenfalls ein Fehler.

* '''Verwendung von benutzerspezifischen [[Webtrees Handbuch/Anleitung für Administratoren/Webseite#GEDCOM-Kennzeichen|GEDCOM-Kennzeichen]]''' Wenn benutzerspezifische [[Webtrees Handbuch/Anleitung für Administratoren/Webseite#GEDCOM-Kennzeichen|GEDCOM-Kennzeichen]] auftauchen, die webtrees nicht bekannt sind, erfolgt eine Warnung.

* '''Verweise auf den falschen Datensatztyp''' Es wird geprüft ob die Verweise in den Datensätzen (XREF) überhaupt auf einen existierenden Datensatz verweisen (Ebene 0) und ob dieser Verweis auf einen Datensatz des richtigen Typs erfolgt, d.h. ob der Verweis auf eine zugeordnete Person bei einem Ereignis (ASSO oder _ASSO) auch tatsächlich auf einen Personendatensatz zeigt ([[GEDCOM/INDI-Tag|INDI]]). Oder ob zum Beispiel der Verweis bei einem Ereignis auf einen Ortsdatensatz ([[GEDCOM/ LOC-Tag|_LOC]]) auch wirklich auf einen Ortsdatensatz ([[GEDCOM/ LOC-Tag|_LOC]]) zeigt.

* '''Verweise nicht an der richtigen Stelle''' Es wird geprüft, dass Verweise auf andere Datensätze nur an der korrekten Stelle vorkommen. Ein Verweis auf Kinder (CHIL) kann nur im Familiendatensatz ([[GEDCOM/FAM-Tag|FAM]]) vorkommen, aber nicht in einem Personendatensatz ([[GEDCOM/INDI-Tag|INDI]]). In einem Ortsdatensatz kann nur auf die folgenden Datensatzarten '[[GEDCOM/SOUR-Tag|SOUR]]', '[[GEDCOM/OBJE-Tag|OBJE]]', '[[GEDCOM/ LOC-Tag|_LOC]]' und '[[GEDCOM/NOTE-Tag|NOTE]]' verwiesen werden. Das heißt, in einem Ortsdatensatz kann auf einen anderen Ortsdatensatz verwiesen werden (etwa einen in der Hierarchie übergeordneten Ortsdatensatz), nicht aber auf einen Personendatensatz. Man kann also in einem Ortsdatensatz nicht auf den Bürgermeister des Ortes verweisen, da dies die Spezifikation im [https://genealogy.net/GEDCOM/ Addendum] der [[GEDCOM-L|GEDCOM-L-Gruppe]] nicht vorsieht.

* '''Rückwärtsverweise fehlen''' Der [[GEDCOM]]-Standard sieht vor, dass an einigen Stellen zu jedem Verweis auch der entsprechende Rückwärtsverweis existiert. Wenn von einem Kind ([[GEDCOM/INDI-Tag|INDI]]) auf die Familie mit den Eltern verwiesen wird ([[GEDCOM/FAMC-Tag|FAMC]]), dann muss in diesem Familiendatensatz auch auf die Kinder dieser Familie verwiesen werden. Gleiches gilt beim Verweis der Ehegatten auf den Familiendatensatz und zurück auf die Ehegatten. Diese Informationen sind im Prinzip redundant, aber der Standard sieht sie vor, um die entsprechende Struktur robuster zu gestalten. Falls bei Änderungen (direkt auf der [[GEDCOM]]-Ebene außerhalb von webtrees) inkonsistente Informationen erzeugt worden sind, dann fallen diese hier bei der Fehlersuche von webtrees auf.

* '''Ungültige Art und Anzahl von Ehepartnern in einer Familie''' In einem Familiendatensatz ([[GEDCOM/FAMC-Tag|FAMC]]) gibt es je nur einen Partner vom Typ HUSB und WIFE. HUSB stammt aus der früheren Interpretation für "Ehemann", "WIFE" aus der für "Ehefrau". Das Geschlecht der beiden Partner ergibt sich aber nicht durch diese überholte Namenskonvention, dennoch müssen auch in gleichgeschlechtlichen Beziehungen HUSB und WIFE verwendet werden. Beziehungen mit mehr als zwei Partnern lassen sich in [[GEDCOM]] nicht ausdrücken.

* '''Verwendung von Inline-Quellenangaben''' Inline-Quellenangaben sollen nicht mehr verwendet werden und führen zu einer Fehlermeldung. Die Verwendung von Quellenangaben (SOUR) mit nachfolgendem Text sind nicht zulässig und sollten durch die entsprechende GEDCOM-Struktur (SOUR, PAGE, DATA, TEXT, CONT, DATE, QUAY, OBJE), die durch Nutzung der Oberfläche regelkonform erzeugt wird, ersetzt werden.

* '''Unbekanntes Dateiformat bei Multimediaobjekten''' Wenn in einem Multimediaobjekt eine Datei mit einem undefinierten Dateityp verwendet wird, erfolgt eine Fehlermeldung.
{{-}}

==== Finde unverbundene Personen ====
[[Datei:WT 2.1 Verwaltung-Stammbaeume Finde unverbundene Personen.png|alternativtext=Finde unverbundene Personen|thumb|350px|Finde unverbundene Personen]]
Falls es in den Daten Personen ohne Verknüpfung zu anderen Objekten gibt, zeigt diese Funktion die betroffenen Datensätze an.

Zusätzlich können Sie noch angeben, ob verbundene Personen (_ASSO) oder Alias-Namen (AKA) in die Suche eingeschlossen werden sollen.

Über die Links können Sie direkt zu den Personendaten verzweigen und erforderliche Änderungen vornehmen.

Wenn in der Benutzerverwaltung der aktuelle Benutzer mit einem Personendatensatz im Stammbaum verknüpft ist, werden die aufgelisteten Personen in Bezug zu dieser Person angegeben, im Beispiel also "Mia Manuela Musterfrau".

{{-}}

==== Neu nummerieren ====
[[Datei:WT 2.1 Verwaltung-Stammbaeume Stammbaum neu nummerieren.png|alternativtext=Stammbaum neu nummerieren|thumb|350px|Stammbaum neu nummerieren]]
Als Querverweis werden in Stammbäumen interne Referenznummern („XREF“ genannt) verwendet. Beispielsweise können diese wie folgt aussehen F123, I1, M77, S12 oder X4711. Mit dieser Funktion lassen sich die Datensätze im ausgewählten Stammbaum "'''neu nummerieren'''". Damit werden diese internen Referenznummern so modifiziert, dass sie in keinem anderen Stammbaum vorkommen. Ist nur ein Stammbaum vorhanden, kann die Funktion nicht ausgeführt werden. Diese Funktion wird etwa benötigt, wenn ein Administrator beabsichtigt zwei Stammbäume zu einem [[Webtrees_Handbuch/Anleitung_f%C3%BCr_Administratoren/Stammb%C3%A4ume#Stammb.C3.A4ume_zusammenf.C3.BChren|zusammenzuführen]].

Vor der Aktion wird angezeigt, wie viele Datensätze im Vergleich zu anderen Stammbäumen übereinstimmende „XREF“ verwenden. Nach der Ausführung ändert sich die Meldung auf 0 Datensätze.

Die Änderung der Daten ist abhängig von der Größe der Stammbäume und kann einige Zeit in Anspruch nehmen.
{{-}}

==== Änderungsprotokoll ====
[[Datei:WT 2.1 Verwaltung-Stammbaeume Aenderungsprotokoll.png|alternativtext=Änderungsprotokoll eines Stammbaums|thumb|350px|Änderungsprotokoll eines Stammbaums]]
Im '''Änderungsprotokoll''' werden alle Veränderungen der genealogischen Daten dokumentiert. Die generierte Liste ist beim Aufruf in chronologischer Reihenfolge sortiert beginnend mit den letzten Aktionen. Gezeigt werden der Zeitstempel, Status, Datensatz, Daten, Benutzer und Stammbaum. Die im Kopfbereich befindlichen Felder dienen als Filter, um die Liste auf relevante Ereignisse einschränken zu können. Sie können wählen das Startdatum "von", Enddatum "bis", "Status", "Datensatz" sprich interne Referenz, "alte Daten" sprich veränderte Daten, "neue Daten" sprich geänderte Daten, "Benutzer" sprich wer hat geändert und in welchem "Stammbaum".
{{-}}

=== Nicht verknüpfte Datensätze hinzufügen ===
Unter dieser Kategorie sind Verwaltungsfunktionen, mit denen '''"Nicht verknüpfte Datensätze hinzugefügt"''' werden können, zusammengefasst. In der Regel bestehen bei einem Stammbaum immer Verknüpfungen zwischen Personen, Familien oder anderen Datensätzen. Nicht verknüpfte Datensätze sind daher als Sonderfälle zu betrachten.
{{-}}

==== Person ====
Unter diesem Menüpunkt lässt sich mit der üblichen Erfassungsmaske ein '''Personendatensatz''' (INDI) ohne Verknüpfungen zu anderen Objekten erzeugen. Die ist etwa erforderlich, wenn man einen Trauzeugen bei einer Hochzeit als Person erfassen möchte, der nicht mit dem Brautpaar verwandt ist. Anschließend kann der Trauzeuge dann über einen Verweis im Heiratsereignis verknüpft werden. Ein anderer Anwendungsfall für diese Funktion ist gegeben, wenn man einen ganz neuen (Teil-) Baum beginnen möchte und dazu die Ausgangsperson erzeugen muss.

Eine Alternative zu dieser Funktion, die von jedem Bearbeiter genutzt werden kann (also keine Berechtigung als Verwalter voraussetzt) besteht darin, eine unverbundene Person erst einmal als Kind einer bestehenden Familie hinzuzufügen und dann diese Verbindung zu lösen indem man die neue Person wieder aus der Familie entfernt.{{-}}

==== Quelle ====
Unter diesem Menüpunkt lässt sich mit der üblichen Erfassungsmaske ein '''Quellendatensatz''' (SOUR) ohne Verknüpfungen zu anderen Objekten erzeugen.{{-}}

==== Archiv ====
Unter diesem Menüpunkt lässt sich mit der üblichen Erfassungsmaske ein '''Archivdatensatz''' (REPO) ohne Verknüpfungen zu anderen Objekten erzeugen.{{-}}

==== Medienobjekt ====
Unter diesem Menüpunkt lässt sich mit der üblichen Erfassungsmaske ein '''Mediendatensatz''' (OBJE) ohne Verknüpfungen zu anderen Objekten erzeugen.{{-}}

==== Gemeinsame Notiz ====
Unter diesem Menüpunkt lässt sich mit der üblichen Erfassungsmaske ein '''Notizdatensatz''' (NOTE) ohne Verknüpfungen zu anderen Objekten erzeugen.{{-}}

==== Übermittler ====
Unter diesem Menüpunkt lässt sich mit der üblichen Erfassungsmaske ein '''Übermittlerdatensatz''' (SUBM) ohne Verknüpfungen zu anderen Objekten erzeugen.{{-}}

==== Ortsdatensätze ====
Zum Anlegen von nicht verknüpften Ortsdatensätzen (_LOC) gibt es an dieser Stelle keinen Menüpunkt. Wenn Sie die im GEDCOM-Standard nicht enthaltenen Ortsdatensätze unter Verwendung der Vesta-Erweiterungsmodule nutzen, können Sie im Listen-Menü den Vesta-Menüpunkt "Gemeinsame Orte" finden. Dort finden sie oberhalb der Liste der gemeinsamen Ortsdatensätze in der linken oberen Ecke ein "+"-Zeichen; dieses erlaubt das Anlegen nicht verknüpfter neuer Ortsdatensätze.
{{-}}

=== GEDCOM-Datei ===
Unter diesem Menüpunkt befinden sich die '''Funktionen zum Export und Import''' von GEDCOM-Dateien.
{{-}}

==== Export ====
[[Datei:WT 2.1 Verwaltung-Stammbaeume GEDCOM-Export.png|alternativtext=GEDCOM-Export|thumb|350px|GEDCOM-Export]]
Zur [[Webtrees_Handbuch/Anleitung_für_Webmaster#Backup_der_genealogischen_Daten|Datensicherung]] oder zum [[Webtrees_Handbuch/Nutzungserfahrungen#Datenaustausch_mit_anderen_Genealogieprogrammen|Austausch mit anderen Genealogieprogrammen]] ist es nützlich, sämtliche GEDCOM-Daten eines Stammbaums in eine Datei im GEDCOM-Format zu exportieren. Nicht enthalten in diesem Export sind Daten wie
* GEDCOM-fremde Inhalte wie die [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Geschichten|Geschichten]]
* Benutzerverwaltung
* Konfiguration von Website, Stammbaum und Modulen.

Gelegentlich kann ein Export mit einem anschließenden Import nützlich sein. Dabei können eventuelle Inkonsistenzen in der Datenbank behoben werden.

Der Export erfolgt immer mit Bezug auf den GEDCOM-Standard 5.5.1.

Im linken Teil des Menüs besteht die Möglichkeit die erzeugte GEDCOM-Datei in das in den Stammdaten festgelegte Serververzeichnis zu exportieren (normalerweise ist das der Ordner <code>/data</code>). Hierbei kann nur der Dateiname angegeben werden. Die Dateierweiterung der Datei, wie etwa ".ged", wird automatisch angehängt.

Der rechte Teil des Menüs steht für den Export als Download auf das lokale Rechner-Laufwerk des Benutzers zur Verfügung. Als mögliche Export-Einstellungen sind aufgeführt
* '''Format'''
** GEDCOM - entsprechend dem GEDCOM-Standard 5.5.1 wird nur die Textdatei (*.ged) unkomprimiert erzeugt
** ZIP - die Textdatei (*.ged) wird in einem komprimiertes ZIP-Archiv mit gleichem Namen erzeugt (*.zip)
** ZIP (enthält Mediendateien) - die Textdatei (*.ged) sowie die darin referenzierten Mediendateien werden unter Beibehaltung der Ordnerstruktur als komprimiertes ZIP-Archiv erzeugt (*.zip)
** GEDZIP (enthält Mediendateien) - entsprechend dem GEDCOM-Standard 7.0 wird die Textdatei (gedcom.ged) und die darin referenzierten Mediendateien in einem Verzeichnis im komprimierten ZIP-Archiv mit dem gewählten Dateinamen (*.gdz) exportiert (es ist darauf zu achten, dass es keine Mediendatei mit dem Namen gedcom.ged gibt)
* '''Dateiname''' - der Stammbaumname wird vorgeschlagen und kann geändert werden
* '''Zeichencodierung''' - verschiedene Codierungen stehen zur Auswahl; es sollte im Normalfall immer UTF-8 gewählt werden
* '''Zeilenenden''' - für die Verarbeitung auf unterschiedlichen Plattformen kann die Art der Zeilenabschlüsse gewählt werden
* '''Datenschutzeinstellungen''' - sind von niedrigem Schutz zu hohem Schutz angeordnet; "keine" exportiert alle Daten; "Verwalter" exportiert nur Daten, die ein Verwalter sehen darf; "Mitglied" exportiert nur Daten, die ein Mitglied sehen darf; "Besucher" exportiert nur Daten, die entsprechend dem Datenschutzkonzept als "öffentlich" eingestuft werden
{{-}}

==== Import ====
[[Datei:WT 2.1 Verwaltung-Stammbaeume GEDCOM-Import.png|alternativtext=GEDCOM-Import|thumb|350px|GEDCOM-Import]]
Mit der Import-Funktion werden alle Daten aus einer GEDCOM-Datei in den aktuellen Stammbaum übernommen. Bereits vorhandene Daten werden dabei vollständig überschrieben. Wenn man Stammbäume zusammenführen möchte, muss man die GEDCOM-Datei erst in einen neuen Stammbaum einlesen und dann die Funktion "[[Webtrees_Handbuch/Anleitung_f%C3%BCr_Administratoren/Stammb%C3%A4ume#Stammb.C3.A4ume_zusammenf.C3.BChren|Stammbäume zusammenführen]]" nutzen.

Um die Importdatei auszuwählen, können Sie alternativ in einem lokalen Laufwerk auf Ihrem Computer suchen oder aus dem festgelegten Daten-Laufwerk auf dem Webserver eine der angebotenen Dateien auswählen. Die maximale Größe einer Datei beim Upload auf den Server kann limitiert sein.<ref>In PHP gibt es eine maximale Größe für das Hochladen von Dateien. Standardmäßig sind das 8 MB. Der Webmaster kann diese Einstellungen eventuell in der <code>php.ini</code> ändern. Er muss auch <code>upload_max_filesize</code> und <code>post_max_size</code> ändern.

Alternativ kann der Webmaster die zu importierende GEDCOM-Datei per FTP in den Ordner <code>/data</code> hochladen und Sie können diese als Verwalter dann direkt vom Server importieren.</ref>

Für den Import stehen verschiedene "Zeichencodierungen" zur Auswahl. Damit werden die gängigen Formate abgedeckt, die von anderen Programmen erzeugt werden. Im Normalfall sollte die vordefinierte Einstellung "automatisch" ausgewählt werden. Dann verwendet webtrees die Zeichencodierung, die im Kopf der GEDCOM-Datei angegeben ist. Falls die dortige Angabe falsch ist, kann man diese Angabe durch eine explizite Auswahl in diesem Menüpunkt überschreiben.

Nur wenn Sie Medienobjekte in webtrees erstellt haben und diese GEDCOM-Datei anschließend mit einem anderen Genealogieprogramm bearbeitet haben, das die Medienobjekte löscht, wählen Sie beim Re-Import die Option "Medienobjekte behalten", um die aktuellen Medienobjekte im Stammbaum mit der modifizierten GEDCOM-Datei wieder zusammenzuführen. Normalerweise sollte die Aktivierung dieser Option nicht erforderlich sein.

Nur wenn Sie die zu importierende GEDCOM-Datei mit einem anderen Genealogieprogramm erstellt haben, das beim Umbruch langer Zeilen die Leerzeichen weglässt, wählen Sie die Option "Leerzeichen dort hinzufügen, wo lange Zeilen umgebrochen werden", um die fehlenden Leerzeichen beim Import wieder einzufügen. Dies sollte im Normalfall nicht notwendig sein.

Einige Genealogieprogramme erstellen GEDCOM-Dateien, die Mediendateinamen mit vollständigen Pfaden enthalten, wie sie auf dem erzeugenden System vorhanden sind. Diese Pfade sind auf dem webtrees-Webserver jedoch nicht vorhanden. Damit webtrees die Mediendateien finden kann, muss der führende Teil des angegebenen Pfades entfernt werden. In dem Feld "Entfernen Sie den GEDCOM-Medienpfad aus den Dateinamen" definieren Sie den zu entfernenden Teil der Pfadangaben.

{{Infobox|Sofern man einen Stammbaum vor einer extern durchgeführten Änderung exportiert hat und nun wieder importieren möchte, sollte bedacht werden, dass die [[#.C3.84nderungsprotokoll|Änderungshistorie]] beim Import für den betreffenden Stammbaum gelöscht wird. Wird hierauf noch Wert gelegt, muss die Tabelle 'change' (gefiltert nach dem Stammbaum / Feld 'gedcom_id') im Vorfeld mittels eines Dritt-Werkzeugs wie bspw. phpMyAdmin<ref>{{wikipedia-Link|PhpMyAdmin}}</ref> gesichert und im Nachgang wieder manuell eingespielt werden.}}

== Einzelnachweise ==
<references />

[[Kategorie:Webtrees]]

Webtrees Handbuch/Anleitung für Mitglieder

2023-03-14T20:39:22Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Kapitel 3|info=1}}{{WT-Inhaltsverzeichnis|Kapitel 3|A}}

Im wesentlichen werden Sie als Mitglied auf das selbe Aussehen und die selben Menüpunkte stoßen wie [[Webtrees Handbuch/Anleitung für Besucher|Besucher]]. In diesem Kapitel werden diejenigen Punkte ergänzt, die für ihre Rolle zusätzlich hinzukommen. Es wird also im folgenden vorausgesetzt, dass Sie sich als Mitglied mit ihrem Nutzernamen und ihrem Passwort angemeldet haben.

== Kopfmenü ==
Das [[Webtrees_Handbuch/Anleitung_für_Besucher#Kopfmen.C3.BC|Kopfmenü]] wird beim Anmelden von Mitgliedern um Untermenüs mit für die jeweilige Rolle vorbehaltenen Funktionen erweitert.

=== Meine Seiten ===
[[Datei:WT 2.1 Meine Seiten-Menue-Meine Seite.png|alternativtext=Meine Seiten - Menü Meine Seite|thumb|left|350px|Meine Seiten - Menü Meine Seite]]
"Meine Seite" ist die Startseite jedes registrierten Benutzers, die nach dem Login angezeigt wird. Diese "Meine Seite" ist unabhängig von den Startseiten der Stammbäume.

Im Kopfmenü wird das zugehörige Untermenü erst nach der Anmeldung sichtbar und enthält die in den nachfolgenden Unterabschnitten genannten Menüeinträge. Über das Kopfmenü "Meine Seiten" > "Meine Seite" kann jederzeit auf die eigene Seite gewechselt werden.
{{-}}

==== Mein Datenblatt ====
[[Datei:WT 2.1 Meine Seiten-Menue-Mein Datenblatt.png|alternativtext=Meine Seiten - Menü Mein Datenblatt|thumb|350px|Meine Seiten - Menü Mein Datenblatt]]
Mit diesem Menüpunkt kann auf den eigenen [[Webtrees_Handbuch/Anleitung_f%C3%BCr_Besucher#Personenseite_mit_Reitern_und_Navigationsleiste|Personen-Datensatz bzw. Personenseite]] im Stammbaum verzweigt werden. 
Dieser Eintrag ist nur sichtbar, wenn Ihr Benutzerkonto einem [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Mein_Konto|Personendatensatz]] zugeordnet wurde.
{{-}}

==== Meine Abstammung ====
[[Datei:WT 2.1 Meine Seiten-Menue-Meine Abstammung.png|alternativtext=Meine Seiten - Menü Meine Abstammung|mini|350x350px|Meine Seiten - Menü Meine Abstammung]]
Mit diesem Menüpunkt kann auf das Diagramm "[[Webtrees_Handbuch/Anleitung_f%C3%BCr_Besucher#Diagramme|Vorfahrentafel]]" zur Anzeige der eigenen Ahnen verzweigt werden. 
Dieser Eintrag ist nur sichtbar, wenn Ihr Benutzerkonto einem [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Mein_Konto|Personendatensatz]] zugeordnet wurde.
{{-}}

==== Mein Konto ====
[[Datei:WT 2.1 Meine Seiten-Menue-Mein Konto.png|alternativtext=Meine Seiten - Menü Mein Konto|thumb|350px|Meine Seiten - Menü Mein Konto]]
Zum Ansehen oder Bearbeiten der Daten des eigenen Benutzerkontos wird dieser Menüpunkt aufgerufen.
{{-}}

[[Datei:WT 2.1 Meine Seiten-Menue-Mein Konto-Maske.png|alternativtext=Meine Seiten - Menu Mein Konto Bearbeitungsmaske|thumb|350px|Meine Seiten - Menu Mein Konto Bearbeitungsmaske]]
Auf dieser Seite können Sie folgende Daten einsehen und bearbeiten:
* '''Benutzername''' - Ihr Anmeldename Benutzernamen ignorieren Groß-und Kleinschreibung und Buchstaben mit Akzenten, so dass „Chloe“, „chloë“ und „CHLOE“ als identisch betrachtet werden.
* '''Vollständiger Name''' - am besten Ihr Vor- und Nachname, wird nicht nach außen propagiert
* '''Personendatensatz''' - Position im Stammbaum, wird nur angezeigt, eine [[Webtrees_Handbuch/Anleitung_für_Administratoren/Benutzer#Bearbeiten|Änderung ist nur durch den Administrator]] möglich
* '''Startperson''' - angezeigte Person mit der webtrees nach dem Login startet Diese Person wird standardmäßig als Ausgangsperson in Darstellungen und Berichten gewählt.
* '''Passwort''' - das bestehende Passwort wird nicht angezeigt, es kann jedoch ein neues vergeben werden Passwörter müssen mindestens 8 Zeichen lang sein. Groß-/Kleinschreibung werden berücksichtigt, so dass „geheim“ von „GEHEIM“ abweicht. Passwort leer lassen, um das aktuelle Passwort beizubehalten.
* '''Sprache''' - aus den freigeschalteten Sprachen kann diejenige Sprache ausgewählt werden, mit der webtrees nach dem Login startet
* '''Zeitzone''' - die Zeitzone des Nutzers kann ausgewählt werden, mit der webtrees nach dem Login startet Die Angabe der Zeitzone wird für die Datumsberechnungen, wie z. B. das heutige Datum, benötigt.
* '''E-Mail-Adresse''' - diese kann geändert werden Diese E-Mail-Adresse dient dem Versand von Passworterinnerungen, Webseitenbenachrichtigungen und Nachrichten von anderen Familienmitgliedern, die auf der Seite registriert sind.
* '''Kontaktmöglichkeit''' - kann ausgewählt werden Angemeldete Nutzer können sich untereinander Nachrichten schreiben. Sie können auswählen, wie diese Nachrichen an Sie versandt werden oder ob Sie überhaupt Nachrichten empfangen möchten. Hinweis: Diese Einstellung gilt auch für den Kontakt-Link in der Fußzeile, welcher auch von nicht angemeldeten Besuchern genutzt werden kann.
* '''Sichtbar, wenn angemeldet''' - verhindert die Anzeige, dass man angemeldet ist, für andere Nutzer, nicht jedoch für Administratoren Wenn deaktiviert sehen Sie aber auch keine andere angemeldeten Benutzer mehr.

Sofern es sich nicht um das einzige Administratoren-Konto handelt, ist es auch möglich das Konto über die rote Schaltfläche zu löschen.{{-}}

==== Verwaltung ====
[[Datei:WT 2.1 Meine Seiten-Menue Verwaltung 2.png|alternativtext=Meine Seiten - Menu Verwaltung|thumb|350px|Meine Seiten - Menu Verwaltung]]
Wenn Ihr Account mit der Rolle Administrator oder Verwalter verbunden ist, wird im Untermenü zusätzlich der Punkt "Verwaltung" angezeigt. Über diese Auswahl gelangen Sie auf die [[Webtrees Handbuch/Anleitung für Administratoren|Verwaltungsseiten]].
{{-}}

==== Diese Seite anpassen ====
[[Datei:WT 2.1 Meine Seiten-Menue-Diese Seite anpassen.png|alternativtext=Meine Seiten - Menü Diese Seite anpassen|mini|350x350px|Meine Seiten - Menü Diese Seite anpassen]]
Ergänzend zu den [[Webtrees_Handbuch/Anleitung_für_Verwalter#Startseite|Stammbaum-Startseiten]] können sich angemeldete Benutzer eine eigene persönliche Seite aus den verfügbaren Blöcken zusammenstellen (siehe hierzu den Abschnitt [[Webtrees Handbuch/Anleitung für Administratoren/Module#Module-Startseite|Startseite (Module)]]).

Der Administrator wird in der Regel eine Standard-Seite für alle neuen Benutzer anlegen, die später individuell angepasst werden kann. Wenn der Menupunkt "Diese Seite anpassen" im Menü vorhanden ist, kann die Blockzusammenstellung auf der Seite geändert werden.
{{-}}

[[Datei:WT_2-0_Meine-Seite-anpassen.png|thumb|350px|Konfiguration der Blöcke auf "Meine Seite"]]
Sofern die Blöcke auf der Seite geändert werden dürfen, wird links neben dem Block-Titel ein Schraubenschlüssel als Icon angezeigt. Durch Klicken gelangt man zur entsprechenden Block-Konfigurationsseite.

Auf der Konfigurationsseite finden sich im oberen Teil die bereits ausgewählten Blöcke und im unteren Teil die Auswahl der noch verfügbaren Blöcke. Durch Anklicken und Ziehen können die Blöcke von unten nach oben bzw. von links nach rechts und umgekehrt verschoben werden. Das Entfernen von Blöcken im oberen Abschnitt erfolgt durch Klick auf das Symbol "Mülleimer".

Am unteren Rand der Seite können mit den Buttons "Speichern" und "Abbrechen" die Änderungen gesichert oder verworfen werden. Zusätzlich lässt sich über den Link "Das Standardblocklayout wieder herstellen" das vom Administrator vorbereitete Layout wieder herstellen.

Weitere Ausführungen zur Verwendung des nützlichen [[Webtrees_Handbuch/Anleitung_für_Administratoren/Stammbäume#html-block|HTML-Blocks]] sind im Abschnitt "[[Webtrees Handbuch/Anleitung für Administratoren/Stammbäume#Standardblöcke für neue Stammbäume festlegen|Standardblöcke für neue Stammbäume festlegen]]" im Kapitel "[[Webtrees Handbuch/Anleitung für Administratoren|Anleitung für Administratoren]]" zu finden.
{{-}}

== Hauptmenü ==
Das Hauptmenü von Webtrees kann vom Administrator angepasst werden und einige Menüpunkte können für Mitglieder sichtbar sein, die [[Webtrees Handbuch/Anleitung für Besucher|Besucher]] nicht sehen können. Dies wird wahrscheinlich der Menüpunkt „Sammelbehälter“ sein.

=== Sammelbehälter ===
[[bild:WT 2.0 Sammelbehaelter Hauptmenue.png|thumb|right|500px|Hauptmenü des Sammelbehälters]] 
Der Sammelbehälter ermöglicht es, Teile des Stammbaums zusammenzustellen und diese Auswahl als [[GEDCOM]]-Datei herunterzuladen. Das ist insbesondere dann sinnvoll, wenn man Teilmengen des Baumes, etwa alle Nachkommen einer Person oder auch alle Vorfahren, in einem externen Genealogieprogramm analysieren oder visualisieren möchte. Nur ein Verwalter oder Administrator hat die Möglichkeit im Verwaltungsmenü einen gesamten Stammbaum als [[GEDCOM]]-Datei herunterzuladen. Für Mitglieder ist also der Weg über den Sammelbehälter der einzige Weg um zumindest Teildatenbestände als [[GEDCOM]]-Datei zu exportieren. [[GEDCOM]] ist der Dateityp, der von nahezu allen Genealogieprogrammen unterstützt wird, so dass die heruntergeladenen Daten ohne Probleme in einem anderen Programm geladen werden können sollten.

Um etwas in den Sammelbehälter zu legen, navigieren Sie zu dem entsprechenden Datensatz. Dazu rufen Sie zum Beispiel die Seite einer Person auf. Dann öffnen Sie im Menüpunkt "Sammelbehälter" den Punkt "Zum Sammelbehälter hinzufügen". Der ausgewählte Datensatz wird nun in den Sammelbehälter gelegt; dies kann etwa ein Personendatensatz sein oder der Datensatz einer Familie oder auch ein Quellendatensatz. Der Datensatztyp richtet sich dabei nach den im [[GEDCOM]]-Standard definierten Datensatztypen
* Personendatensatz ([[GEDCOM/INDI-Tag|INDI]])
* Familiendatensatz ([[GEDCOM/FAM-Tag|FAM]])
* Notizdatensatz ([[GEDCOM/NOTE-Tag|NOTE]])
* Medienobjektdatensatz ([[GEDCOM/OBJE-Tag|OBJE]])
* Quellendatensatz ([[GEDCOM/SOUR-Tag|SOUR]])
* Archivdatensatz (REPO)
* Übermittlerdatensatz ([[GEDCOM/SUBM-Tag|SUBM]])

Mehr Informationen zu den GEDCOM-Datensatztypen findet man bei den oben hinterlegten Links und auch in der inoffiziellen [http://www.daubnet.com/ftp/gedcom-551-deutsch.pdf deutschen Übersetzung des GEDCOM-Standards].

[[bild:WT-2_0-de-Sammelbehälter-Personendatensätze.png|thumb|right|500px|Hinzufügen von Personendatensätzen zum Sammelbehälter]] 
Im Falle, dass Sie einen Personendatensatz ausgewählt haben, haben Sie nun die Wahl, nur die Details von genau dieser Person in den Sammelbehälter zu legen oder diese Person zusammen mit ihren Eltern und Geschwistern, ihren Ehepartnern und ihren Kindern, ihren Vorfahren, ihren Vorfahren und deren Familien oder ihren Ehepartnern und Nachkommen zu speichern.

Diesen Vorgang können Sie für diese Person mit einer anderen Auswahl wiederholen, also etwa neben den Vorfahren auch alle Nachkommen in den Sammelbehälter kopieren. Automatisch werden alle mit diesen Personen verbundenen anderen Datensatztypen dem Sammelbehälter hinzugefügt, also etwa zugeordnete Notizen oder Quellen. Sie können auch zu anderen Personen navigieren oder zu Datensätzen einer anderen Art und dann diese hinzufügen.

Falls Sie einen Quellendatensatz ausgewählt haben, können sie entweder nur diese Quelle in den Sammelbehälter legen oder auch alle Personen, die diese Quelle referenzieren. Wenn Sie also Teile eines Kirchenbuches erfasst haben sollten, können Sie so einfach alle diejenigen Personen exportieren, die Ereignisse vorweisen, die sich als Quelle auf das entsprechende Kirchenbuch beziehen.

Wenn Sie ein Archiv ausgewählt haben und dieses dem Sammelbehälter hinzufügen, werden automatisch auch alle Quellen hinzugefügt, die ihre Heimat in diesem Archiv haben.

So sammeln Sie im Sammelbehälter immer mehr Informationen. Wenn Sie sich den Inhalt des Sammelbehälters durch die Auswahl des ersten Menüpunkts "Sammelbehälter" anzeigen lassen, erscheint eine Liste aller gesammelten Datensätze. Die Icons in der ersten Spalte kennzeichnen dabei den Datensatztyp. Sie haben nun die Möglichkeit einzelne Datensätze durch einen Klick auf das rote Kreuz in der Spalte "Löschen" zu löschen.

Sobald Sie mit ihrer Auswahl zufrieden sind, können Sie den Sammelbehälter durch den Aufruf des Menüpunktes "Herunterladen" als [[GEDCOM]]-Datei herunterladen. Oder Sie wählen im sich öffnenden Fenster aus, dass Sie auch alle referenzierten Mediendateien in einer zip-Datei dazu gepackt haben wollen. Das Entpacken der heruntergeladenen zip-Datei zeigt dann die [[GEDCOM]]-Datei und gegebenenfalls einen Medienordner mit den Bildern und weiteren Mediendateien.

Vor dem Export kann man noch wählen ob und welche Datenschutzeinstellungen angewendet werden sollen. Verwalter haben die Möglichkeit, alle Details (einschließlich Details zu noch lebenden Personen) herunterzuladen. Es kann sein, dass Sie als Mitglied durch eine Einstellung des Administrators auf verstorbene Personen beschränkt sind.

Sie können den Inhalt des Sammelbehälters jederzeit über den Aufruf des entsprechenden Menüpunktes "Sammelbehälter leeren" komplett löschen.

Der Sammelbehälter ist einem Stammbaum fest zugeordnet, d.h. wenn Sie zu einem anderen Stammbaum wechseln, dann sehen Sie dort einen anderen Sammelbehälter. Die Sammelbehälter werden in jedem Fall gelöscht, sobald die Browser-Sitzung beendet wird.

{{Infobox|
;Zum Sammelbehälter gibt es mehrere [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodule]]
}}
:* Aus der Serie der Vesta-Module gibt es ein [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Sammelbehälter-Vesta|Sammelbehälter-Erweiterungsmodul]], das auch das Hinzufügen eines Ortsdatensatzes (_LOC) erlaubt. Dabei können Sie auch noch alle Personen dem Sammelbehälter hinzufügen, die einen Bezug zu diesem Ort haben.
:* Ein weiteres [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Sammelbehälter|Sammelbehälter-Erweiterungsmodul]] ersetzt den Standard-Sammelbehälter komplett durch eine erheblich erweiterte Version, die es erlaubt nicht nur eine [[GEDCOM]]-Datei herunterzuladen, sondern auch die im Sammelbehälter gesammelten Daten gleich flexibel zu visualisieren. Zusätzlich erlaubt es dieses Erweiterungsmodul globale Datensätze eines Stammbaumes auszuwählen und hinzuzufügen, etwa alle Partnerketten oder Ahnenkreise im gesamten Stammbaum.
:* Zur Visualisierung der Daten im Sammelbehälter gibt es drei [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodule]]: [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/TAM und Lineage/TAM|TAM]], [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/TAM und Lineage/Lineage|Lineage]] und [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/GVExport|GVExport]].

=== Geschichten ===
Es gibt eine Möglichkeit ein Modul für Geschichten zu aktivieren. Hierzu muss der der Admin im Verwaltungsbereich bei Modulen und individuellen Seiten-Tabs die entsprechenden Einstellungen vornehmen. Wenn zu einem Personendatensatz eine Geschichte angelegt wurde, erscheint ein weiterer Tab, unter dem die Geschichte angezeigt wird.

Im Geschichtenmodul können formatierter Text, Links und Medienobjekte verwendet werden. Allerdings werden sämtliche Inhalte '''nur in der zugehörigen Datenbank''' abgelegt und werden '''nicht Teil der GEDCOM-Struktur'''. Diese Form der Geschichten ist ein Erbe noch aus der Vorgänger-Software phpGedView. Weitere Informationen finden sich im Bereich [[Webtrees_Handbuch/Anleitung_f%C3%BCr_Bearbeiter#Geschichten|Anleitung für Bearbeiter]].

[[Kategorie:Webtrees]]

Webtrees Handbuch/Anleitung für Besucher/Diagramme Vergleichstabelle

2023-03-14T20:39:12Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Kapitel 2 Anlage|info=1|sticktable=1}}

Die folgende Tabelle erlaubt den Vergleich der in webtrees nutzbaren [[Webtrees Handbuch/Anleitung für Besucher#Diagramme|Diagrammfunktionen]]. Diese Übersicht soll helfen folgende Arten von Fragen zu beantworten

* Was macht die verschiedenen Diagrammarten aus? Worin unterscheiden sie sich?
* Zu welchen Standarddiagrammen gibt es entsprechende (verbesserte) Erweiterungsmodule?
* Ich benötige eine bestimmte Funktion. Welches Diagramm hilft mir da am besten? Etwa: “Ich möchte einen großen Baum ausdrucken - welches Diagramm unterstützt das?”

Die Tabelle listet in den Zeilen verschiedene Charakteristika auf. In den Spalten sind die verfügbaren Diagramme aufgeführt; diese werden von Erweiterungsmodulen oder durch die Standarddiagrammmodule bereit gestellt.<ref>Die hinter den Spaltenüberschriften liegenden Verweise führen entweder zu einer Seite in diesem Handbuch (teilweise sind diese Seiten noch nicht angelegt) oder zu der Seite in GitHub, wo das entsprechende Erweiterungsmodul beschrieben ist.</ref> Zu den Standarddiagrammen sind teilweise korrespondierende Erweiterungsmodule aufgeführt, die diese in verbesserter Form ersetzen können.

{{WT-ToDo|Tabelle fertig ausfüllen; Unterschiede von TAM und LIN besser herausarbeiten; fehlende Screenshots einfügen (u.a. für alle Erweiterungsmodule)}}

<div class="stickytablewrapperhc1">
{| class="wikitable"
|+ Diagramme-Vergleich
|-
!
![[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/GVExport|Erweiterung GVExport]]
![[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/TAM und Lineage/TAM|Erweiterung TAM]]
![[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/TAM und Lineage/Lineage|Erweiterung LIN]]
![https://github.com/PeWu/topola-webtrees Erweiterung Topola]
!Interaktives Sanduhrdiagramm / [https://github.com/huhwt/huhwt-xtv Erweiterung huhwt-xtv]
!Sanduhrdiagramm
!Beziehungen / [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/vesta extended relationships&action=edit&redlink=1|Erweiterung Vesta extended relationships]]
!Fächerdiagramm / [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Fächerdiagramm&action=edit&redlink=1|Erweiterung Fächerdiagramm]]
!Familienbuch
!Kompakte Vorfahrentafel
!Lebensspannen
!Zeitleiste
!Nachkommen
!Vorfahren
!Vorfahrentafel / [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Vorfahrentafel&action=edit&redlink=1|Erweiterung Vorfahrentafel]]
!Vorfahrenkarte / [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/vesta_places_and_pedigree_map&action=edit&redlink=1|Erweiterung Vesta places and pedigree map]]
!Statistiken
![https://github.com/squatteur/webtrees-branch-statistics Erweiterung Generationenstatistik]
|-
|Art der Darstellung
|Knoten-Kantendiagramm (komplex)
|Knoten-Kantendiagramm (komplex)
|Knoten-Kantendiagramm (komplex)
|Knoten-Kantendiagramm (komplex)
|Knoten-Kantendiagramm (Sanduhr)
|Knoten-Kantendiagramm (Sanduhr)
|Knoten-Kantendiagramm (Pfad)
|Fächer
|mehrere Knoten-Kantendiagramme
|Knoten-Kantendiagramm (in spezieller kompakter H-Form)
|Balkendiagramm
|Balkendiagramm
|Kästchenliste
|Knoten-Kantendiagramm
|Knoten-Kantendiagramm
|Landkarte
|Statistiken
|Statistik zu den Vorfahrengenerationen
|-
|typische Darstellungen
|
|
|
|
|[[Datei:WT 2.0 Diagramm-Interaktive-Sanduhr.png|mini]]
|[[Datei:WT 2.0 Diagramm-Sanduhr.png|mini]]
|[[Datei:WT_2.0_Diagramm-Beziehungen.png|mini]]
|[[Datei:WT_2.0_Diagramm-Faecher-Halbkreis.png|mini]]
|[[Datei:WT_2.0_Diagramm-Familienbuch.png|mini]]
|[[Datei:WT_2.0_Diagramm-kompakte-Vorfahrentafel.png|mini]]
|[[Datei:WT_2.0_Diagramm-Lebensspannen.png|mini]]
|[[Datei:WT_2.0_Diagramm-Zeitleiste.png|mini]]
|[[Datei:WT_2.0_Diagramm-Nachkommen.png|mini]]
|[[Datei:WT_2.0_Diagramm-Vorfahren.png|mini]]
|[[Datei:WT_2.0_Diagramm-Vorfahrentafel.png|mini]]
|[[Datei:WT_2.1_Anleitung-fuer-Besucher_Vorfahrenkarte.png|mini]]
|[[Datei:WT_2.0_Diagramm-Statistiken.png|mini]]
|
|-
|Datenschutz
|ja
|ja
|ja
|nein<ref>Die Regeln von webtrees zum Schutz der Daten werden nicht beachtet: auch als vertraulich gekennzeichnete Inhalte sind für Suchmaschinen sichtbar. Daher ist vom Einsatz des Diagramms "Topola" auf Servern im Internet dringend abzuraten.</ref>
|ja
|ja
|ja
|ja
|ja
|ja
|ja
|ja
|ja
|ja
|ja
|ja
|ja
|ja
|
|-
|Elemente der Darstellung
|Personen und Familien sowie deren Verknüpfung
|Personen und Familien sowie deren Verknüpfung; temporales Feld
|Personen und Familien sowie deren Verknüpfung; Cluster von Familiennamen; temporales Feld
|Personen und Familien sowie deren Verknüpfung
|Personen und Familien sowie deren Verknüpfung
|Personen und Familien sowie deren Verknüpfung
|Zwei Personen sowie deren Beziehungspfade / zusätzlich konfigurierbare Suchoptionen
|Vorfahren
|mehrere Vorfahrendiagramme
|Vorfahren
|Lebensspannen ausgewählter Personen
|Ereignisse im Leben ausgewählter Personen
|Nachkommen
|Vorfahren
|Vorfahren
|Orte der Vorfahren
|umfangreiche statistische Daten
|Statistik zu den Vorfahrengenerationen
|
|-
|Darstellung von Datensätzen im Sammelbehälter
|ja
|ja
|ja
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|-
|Auswahl der dargestellten Elemente
|interaktiv (Start-/Stop-Personen), Vorfahren, Nachkommen, Geschwister, Partner, jeder; Anzahl der Vorfahren- und Nachkommen-Generationenn
|alle Personen und Familien aus dem Sammelbehälter
|alle Personen und Familien aus dem Sammelbehälter
|interaktiv ausgewählte Person und einige der Vorfahren und Nachkommen, sowie der Partner
|wählbare Anzahl der Vorfahren- und Nachkommen-Generationen / Teilzweige ein- und ausklappbar
|wählbare Anzahl der Vorfahren- und Nachkommen-Generationen
|Verbindung zwischen zwei wählbaren Personen (ggf. mehrere Diagramme für verschiedene Beziehungspfade)
|Anzahl der Generationen wählbar
|Anzahl der Generationen wählbar
|nein
|mehrere Personen auswählbar; Ort und Zeitraum auswählbar
|
|
|
|
|
|vordefinierte Art der Statistik; frei gestaltete statistische Auswertung
|Anzahl der Generationen wählbar
|-
|intuitive Verständlichkeit
| +++
| +
| +
| +++
| ++
| ++
| +++
| +++
| ++
| +
| ++
|<nowiki>+</nowiki>
|<nowiki>++</nowiki>
|<nowiki>++</nowiki>
|<nowiki>+++</nowiki>
|<nowiki>+++</nowiki>
|<nowiki>++</nowiki>
|<nowiki>++</nowiki>
|-
|Erzeugung von Grafikdateien
|svg, png, jpg, pdf, dot
|
|
|nein
|nein / png
|nein
|nein
|nein / png, svg
|nein
|nein
|nein
|nein
|nein
|nein
|nein / png, svg
|nein
|nein
|nein
|-
|Eignung zum Ausdrucken
| +++
| ---
| ---
| +
| - / +
| -
| +
| + / +++
|<nowiki>-</nowiki>
|<nowiki>+</nowiki>
|<nowiki>+</nowiki>
|<nowiki>+</nowiki>
|<nowiki>-</nowiki>
|<nowiki>-</nowiki>
|<nowiki>- / +++</nowiki>
|<nowiki>-</nowiki>
|<nowiki>---</nowiki>
|<nowiki>-</nowiki>
|-
|Eignung für große Mengen an dargestellten Elementen
| ++
| +++
| +++
| +
| + (in Vollbilddarstellung: ++)
| -
| ++
| -- / +++
|<nowiki>-</nowiki>
|<nowiki>-</nowiki>
|<nowiki>++</nowiki>
|<nowiki>---</nowiki>
|<nowiki>-</nowiki>
|<nowiki>-</nowiki>
|<nowiki>-</nowiki>
|<nowiki>-</nowiki>
|<nowiki>++</nowiki>
|<nowiki>++</nowiki>
|-
|Ausrichtung der Elemente wählbar (Vorfahren / Nachkommen)
|links nach rechts, oben nach unten
|dynamisch
|dynamisch
|oben nach unten
|rechts nach links
|rechts nach links
|oben nach unten
|außen nach innen
|rechts nach links
|außen nach innen
|links nach rechts
|oben nach unten
|
|
|
|Zoom
|drei Reiter
|unten nach oben
|-
|Vollbilddarstellung
|ja
|ja
|ja
|nein
|ja
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|ja
|nein
|nein
|-
|Drag-and-Drop von Darstellungselementen
|nein
|ja
|ja
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|-
|Navigation im Diagramm
|ja und Verweise
|nein
|nein
|ja
|ja und Verweise
|nein, Verweise
|nein, Verweise
|nein / ja
|nein, Verweise
|nein, Verweise
|nein
|nein, Verweise
|nein, Verweise
|nein, Verweise
|nein, Verweise
|nein, Verweise
|nein
|nein
|-
|abgekürzte Personennamen
|Initialen, nur Vorname; nur Nachnamen; unterdrückt
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|-
|abgekürzte Ortsnamen
|Ort und Land; unterdrückt
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|irrelevant
|-
|flexible Darstellung von Datumsangaben
|Jahr, Monat+Jahr, vollständig; unterdrückt
|nein
|nein
|nein
|nein
|nein
|nein
|nein / Heiratsdaten auswählbar
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|-
|flexible Darstellung von Ortsangaben
|Jahr; Monat+Jahr; vollständig; unterdrückt
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|-
|Auswahl von Farben
|für alle grafischen Elemente
|nein
|nein
|nein
|nein
|nein
|nein
|nein / Farbdarstellung aktivierbar
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|-
|Auswahl von Schrift
|aus einer Reihe von Fonts; Schriftgröße wählbar
|nein
|nein
|nein
|nein
|nein
|nein
|nein / Schriftgröße wählbar
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|nein
|}
</div>

== Einzelnachweise ==
<references />

[[Kategorie:Webtrees]]

Webtrees Handbuch/Anleitung für Besucher

2023-03-14T20:39:02Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Kapitel 2|info=1|sticksort=1}}{{WT-Inhaltsverzeichnis|Kapitel 2|B}}

Als Besucher müssen Sie sich nicht registrieren oder anmelden. Sie sehen aber nur Stammbäume, ausgewählte Teile darin und auch nur Menüpunkte, die der Administrator für die Öffentlichkeit freigegeben hat. Eventuell sehen Sie aber auch nur eine Anmeldemaske, falls der Administrator sonst nichts freigegeben hat.

Implementierungen von webtrees können variieren, je nachdem, wie der Administrator die Installation konfiguriert hat. Unterschiede können darin bestehen, dass einige Personen, Ereignisse oder Fakten möglicherweise nicht sichtbar sind. Der Administrator kann auch das Aussehen der Bedienoberfläche sehr weitgehend beeinflussen. Daher treffen die Informationen in dieser Anleitung möglicherweise nicht auf alle webtrees-Implementierungen zu.

Die Anleitung in diesem Kapitel setzt voraus, dass webtrees bereits richtig installiert und konfiguriert ist. Sie ist geschrieben für Benutzer, die bisher nur geringe Kenntnisse zu webtrees haben.

== Seitenaufbau ==
<div style="float:right;">[[Datei:WT_2.0_Seitenaufbau.png|border|right|600px|link=https://wiki-commons.genealogy.net/images/f/fb/WT_2.0_Seitenaufbau.png]]</div>
Die webtrees-Seite gliedert sich in die folgenden Bereiche, die im in diesem Kapitel näher beschrieben werden.
* Seitenkopf mit dem Namen des ausgewählten Stammbaums und dem [[Webtrees Handbuch/Anleitung für Besucher#Kopfmenü|Kopfmenü]]
* [[Webtrees Handbuch/Anleitung für Besucher#Hauptmenü|Hauptmenü]]
* [[#Bl.C3.B6cke_der_Startseite|individuell konfigurierte Blöcke]] mit diversen Informationen für Besucher
* [[Webtrees Handbuch/Anleitung für Besucher#Fußzeilen|Fußzeilen]], die unter anderem das [[Webtrees Handbuch/Anleitung für Webmaster#Datenschutzerklärung_und_Impressum|Impressum und die Datenschutzerklärung]] enthalten können.
{{-}}

== Kopfmenü ==
<div style="float:right;">[[bild:WT 2.0 Kopfmenue.png|thumb|right|400px|Kopfmenü]]</div>
Das Kopfmenü von webtrees befindet sich normalerweise in der oberen rechten oder linken Ecke (je nach gewähltem Thema) und enthält einen Menüpunkt zur Anmeldung, zur Auswahl des Themas und zur Auswahl der Sprache. Der Administrator legt fest, welche Menüpunkte für Besucher angezeigt werden. Beispielsweise kann ein einzelnes Thema fest ausgewählt sein, so dass der Menüpunkt "Thema" gar nicht erscheint.
{{-}}

=== Thema ===
Das Menü „Thema“ enthält ein Dropdown-Menü, mit dem Sie eines der Themen selektieren können. Durch die Auswahl wird sich die gesamte Bedienoberfläche in ihrem Aussehen ändern.

Die Themen steuern den Stil, das heißt das Aussehen der Webseiten, indem sie Festlegungen für Farben, Schriftarten, Symbolgrößen, und vieles anderes treffen. Die Themen können auch bedingt das Bedienkonzept der Webseiten modifizieren. Der Inhalt, die eigentlichen Information, sind davon nicht betroffen.

Wenn Sie die Seite mit unterschiedlichen Geräten (Laptop, Tablet, Handy) betrachten, dann wird sich das Aussehen der Seite auch an die jeweiligen Gegebenheiten dieses Gerätes anpassen, je nachdem wie gut dies vom gewählten Thema unterstützt wird.

Gegebenenfalls können Sie als Besucher nicht nur ein Thema auswählen, sondern auch noch ein Farbschema dazu wählen, wenn das gewählte Thema diese Möglichkeit anbietet.

[[Datei:WT 2.0 Thema auswaehlen.png|thumb|right|400px|Thema "Colors" mit der Palette "Sage"]]
Die folgenden sechs Themen gehören zum Standardumfang von webtrees
* [[#Clouds|Clouds]]
* [[#Colors|Colors]] mit einer zusätzlichen Farbpalette von sechzehn Farbschemen
* [[#F.A.B.|F.A.B.]]
* [[#minimal|minimal]]
* [[#webtrees|webtrees]]
* [[#Xenea|Xenea]]

Darüber hinaus stehen in der Form von [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodulen]] viele weitere Themen zur Verfügung, die der Webmaster installieren kann. Eine Übersicht findet sich im Abschnitt "[[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule#.C3.9Cbersicht_.C3.BCber_bekannte_Erweiterungsmodule|Übersicht über bekannte Erweiterungsmodule]]".
Wenn Sie die Tabelle dort in der Spalte "Funktion" sortieren, dann finden Sie alle möglichen Themen untereinander aufgelistet.

Der Administrator entscheidet welche Themen für die Besucher zur Auswahl stehen
(siehe Abschnitt [[Webtrees Handbuch/Anleitung für Administratoren/Module|"Module"]] im Kapitel [[Webtrees Handbuch/Anleitung für Administratoren|"Anleitung für Administratoren"]]). Wenn er kein Thema oder nur ein Thema selektiert, dann wird das Menü mit den Themen nicht angezeigt. Der Administrator legt auch das Standard-Thema für die Website fest. Darüber hinaus hat der Administrator weitere Möglichkeiten das Aussehen der Bedienoberfläche zu verändern
* das Modul "CSS und JS" erlaubt es sehr einfach die Darstellung von Elementen der Website zu ändern indem man den Webseiten individuell definierte CSS-Anweisungen oder JavaScript-Funktionen mitgibt
* mit [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodulen]], wie dem Modul "classic look and feel", kann das Aussehen und die Funktionalität der Seiten grundsätzlich verändert werden
Im Ergebnis muss deshalb eine konkrete webtrees-Installation nicht so aussehen wie es in den folgenden Screenshots gezeigt wird. Hier werden die Standard-Themen von webtrees kurz beschrieben.

==== Clouds ====
[[Datei:WT_2.0_Thema_Clouds.png|thumb|right|500px|Thema "Clouds"]]
Das Thema "Clouds" ist durch ein Wolkenband am oberen Bildschirmrand gekennzeichnet. Ansonsten ist das Thema durch einen himmelblauen Hintergrund und die Verwendung von blauer Schrift geprägt. Das [[#Hauptmen.C3.BC|Hauptmenü]] besteht nur aus kleinen Icons ohne Beschriftung.
{{-}}

==== Colors ====
<gallery perrow=1 widths=500px heights=300px style="float:right;" mode="nolines">
Datei:WT_2.0_Thema_Colors_Sage.png|Thema "Colors" mit der Palette "Sage"
Datei:WT_2.0_Thema_Colors_Farbpalette.png|Menü "Farbpalette" für das Thema "Colors"
</gallery>
Das Thema "Colors" unterstützt eine ganze Palette von verschiedenen Farben. In jedem der sechzehn Unterthemen gibt es eine andere Menge von aufeinander abgestimmten Farbelementen. Das [[#Hauptmen.C3.BC|Hauptmenü]] besteht aus Icons ohne Beschriftung.
{{-}}

==== F.A.B. ====
[[Datei:WT_2.0_Thema_FAB.png|thumb|right|500px|Thema "F.A.B."]]
Das Thema "F.A.B." vereinigt das [[#Kopfmen.C3.BC|Kopf-]] und das [[#Hauptmen.C3.BC|Hauptmenü]] in einem Gestaltungselement am oberen Bildschirmrand. Es werden keine Icons für die Menütitel verwendet.
{{-}}

==== minimal ====
[[Datei:WT_2.0_Thema_minimal.png|thumb|right|500px|Thema "minimal"]]
Das Thema "minimal" kommt mit sehr einfachen grafischen Gestaltungselementen aus. Es werden keine Icons verwendet und das Thema ist fast nur in schwarz/weiß gehalten.
{{-}}

==== webtrees ====
[[Datei:WT_2.0_Thema_webtrees.png|thumb|right|500px|Thema "webtrees"]]
Das Thema "webtrees" ist die Standard-Oberfläche. Das [[#Hauptmen.C3.BC|Hauptmenü]] besteht aus beschrifteten Icons. Das [[#Kopfmen.C3.BC|Kopf-]] und [[#Hauptmen.C3.BC|Hauptmenü]] benötigen relativ viel Platz am oberen Bildschirmrand.
{{-}}

==== Xenea ====
[[Datei:WT_2.0_Thema_Xenea.png|thumb|right|500px|Thema "Xenea"]]
Das Thema "Xenea" ist weitgehend in blauen Farbtönen gehalten. Das [[#Kopfmen.C3.BC|Kopfmenü]] ist in einer plastisch erscheinenden Farbleiste untergebracht. Das [[#Hauptmen.C3.BC|Hauptmenü]] besteht aus beschrifteten Icons und auch viele der Ereignisse sind mit individuellen Icons gestaltet.
{{-}}

=== Sprache ===
Das Menü „Sprache“ öffnet ein Dropdown-Menü in dem Sie unter den vom Administrator vorausgewählten Sprachen eine Anzeigesprache auswählen können (siehe dazu den entsprechenden Abschnitt im Kapitel "[[Webtrees Handbuch/Anleitung für Administratoren/Webseite#Sprache|Anleitung für Verwalter und Administratoren]]").

Standardmäßig präsentiert sich die Bedienoberfläche von webtrees in derjenigen Sprache, die in ihrem Browser eingestellt ist. Sie benötigen dieses Menü also nur dann, wenn Sie eine von dieser Voreinstellung abweichende Sprache verwenden wollen.

Es ist aber zu beachten, dass die im Menü ausgewählte Sprache zwar die Sprache für die webtrees Bedienoberfläche ändert, aber Daten, die in einer anderen Sprache erfasst sind, nicht automatisch übersetzt werden. Wenn zum Beispiel in deutscher Sprache als "Todesursache: Herzinfarkt" erfasst wurde, dann wird daraus im Englischen "Cause of death: Herzinfarkt", d.h. die Benennung des Feldes wird übersetzt, der Inhalt "Herzinfarkt" aber nicht.

Manche genealogischen Datenfelder können allerdings mehrsprachig eingegeben werden. So werden zum Beispiel Beziehungen zwischen Personen, wie etwa "Trauzeuge" oder "Taufpatin", in der ausgewählten Sprache angezeigt, sofern die Wörter in der Übersetzungstabelle bereits vorhanden sind; in der GEDCOM-Datenbank werden diese Begriffe in englischer Sprache hinterlegt.

Man kann einer Person auch mehrere Namen zuordnen und somit einen Namen sowohl in der Landessprache (etwa in chinesischen Schriftzeichen) als auch in einer transkribierten Form zuordnen. Aber erst mit dem neuen, noch nicht von webtrees unterstützten GEDCOM-Standard 7.0, wird man auch die Details dabei genau beschreiben können.

Für die Beschreibung von Ortsnamen hat die [[GEDCOM-L|GEDCOM-L-Gruppe]] in ihrem [https://genealogy.net/GEDCOM Addendum] festgelegt, wie diese Ortsnamen in gemeinsamen Ortsdatensätzen (_LOC) mehrsprachig definiert werden können. Sofern der Administrator diese Erweiterung des GEDCOM-Standards aktiviert hat und im Stammbaum solche Ortsdatensätze genutzt werden, können Sie als Nutzer, der die deutsche Sprache ausgewählt hat, einen gemeinsamen Ort etwa so angezeigt bekommen:
Schanghai, China
während ein Nutzer aus China diesen so angezeigt bekommen kann:
上海, 中华人民共和国.

Es gibt Teile der webtrees-Oberfläche, die vom Administrator oder den Mitgliedern multilingual angelegt werden können. Dazu gehören die [[Webtrees Handbuch/Anleitung für Besucher#Blöcke_der_Startseite|Informationsblöcke]] auf der Startseite eines Stammbaums. Und dazu gehören auch die [[Webtrees Handbuch/Anleitung für Besucher#Geschichten|Geschichten]], die zu einer Person im Stammbaum erfasst werden können, und die Beiträge im [[Webtrees Handbuch/Anleitung für Besucher#Häufige_Fragen_(FAQ)|FAQ-Menü]]. Wenn die Anzeigesprache gewechselt wird, können solche Elemente verschwinden, auftauchen oder ihr Inhalt kann sich passend zur gewählten Sprache ändern. Sinnvollerweise sollte man also beim Anlegen solcher mehrsprachiger Teile der Oberfläche immer dafür sorgen, dass zumindest eine Version existiert, die in englischer Sprache angelegt ist und die für alle Sprachen angezeigt wird, indem für diese Version keine Sprache explizit aktiviert wird.

Die folgende Tabelle zeigt nur diejenigen Sprachen, für die die Bedienoberfläche mit einem Anteil von mehr als 25% der vorkommenden Phrasen übersetzt worden ist. Darüber hinaus sind noch Übersetzungen in weitere Sprachen in Arbeit, wie man auf dem Übersetzungsportal [https://translate.webtrees.net/projects/webtrees/ weblate] sehen kann. Der in der Tabelle angegebene Sprachcode entspricht dem Code, den ein Browser an webtrees sendet. Dieser Sprachcode ist in der [https://www.ietf.org/ IETF]-Spezifikation [https://www.rfc-editor.org/rfc/bcp/bcp47.txt BCP47] festgelegt.

<div class="stickysorttablewrapperh">
{| class="wikitable sortable" style="margin:1em 1em 1em 0; border:solid 1px darkgreen; border-collapse:collapse; empty-cells:show; width:60%"
|+ [https://translate.webtrees.net/projects/webtrees/ Verfügbare Sprachen (Stand März 2022)]
|-
!Sprache
!Sprachcode
!Übersetzungsgrad
|-
|Afrikaans || af || 99,8%
|-
|Albanisch || sq || 90,8%
|-
|Arabisch || ar || 93,2%
|-
|Bosnisch || bs || 80,7%
|-
|Bulgarisch || bg || 38,3%
|-
|Chinesisch || zh-Hant || 94,8%
|-
|Chinesisch (vereinfacht) || zh-Hans || 96,2%
|-
|Dänisch || da || 96,6%
|-
|Deutsch || de || 100%
|-
|Englisch || en, en-AU, en-GB, en-US || 100%
|-
|Estnisch || et || 99,3%
|-
|Finnisch || fi || 99,7%
|-
|Französisch || fr || 99,8%
|-
|Französisch (Kanada) || fr-CA || 96,3%
|-
|Georgisch || ka || 66,5%
|-
|Griechisch || el || 91,5%
|-
|Hebräisch || he || 99,7%
|-
|Hindi || hi || 100%
|-
|Indonesisch || id || 92,5%
|-
|Isländisch || is || 99,8%
|-
|Italienisch || it || 98,9%
|-
|Jiddisch || yi || 61,4%
|-
|Kasachisch || kk || 91,3%
|-
|Katalanisch || ca || 99,8%
|-
|Koreanisch || ko || 99,8%
|-
|Kroatisch || hr || 66,3%
|-
|Kurdisch || ku || 65,4%
|-
|Lingála || ln || 64,6%
|-
|Litauisch || lt || 87,9%
|-
|Marathi || mr || 33,3%
|-
|Niederländisch || nl || 100%
|-
|Norwegisch (Bokmål) || nb || 100%
|-
|Norwegisch (Nynorsk) || nn || 100%
|-
|Okzitanisch || oc || 31%
|-
|Polnisch || pl || 99,8%
|-
|Portugiesisch || pt || 74,7%
|-
|Portugiesisch (Brasilien) || pt-BR || 99,1%
|-
|Russisch || ru || 96,6%
|-
|Schwedisch || sv || 99,7%
|-
|Serbisch (lateinisch) || sr || 96,5%
|-
|Slowakisch || sk || 100%
|-
|Slowenisch || sl || 25,7%
|-
|Spanisch || es || 96,1%
|-
|Tatarisch || tt || 26,4%
|-
|Tschechisch || cs || 99,8%
|-
|Türkisch || tr || 99,8%
|-
|Ukrainisch || uk || 99,5%
|-
|Ungarisch || hu || 98,6%
|-
|Vietnamesisch || vi || 94,5%
|-
|Walisisch || cy || 91,6%
|}
</div>
{{-}}

{{WT-ToDo|Noch ergänzen: wie erfolgen generell Übersetzungen für webtrees}}

{{WT-ToDo|Noch ergänzen: benutzerspezifische Übersetzungen in einem Modul}}

{{WT-ToDo|Noch ergänzen: Vorgehensweise zur Eingabe von fremdsprachigen Zeichen, die nicht direkt über die Tastatur erreichbar sind}}

=== Anmelden ===
[[Datei:WT 2.0 Anmeldung.png|thumb|right|400px|Anmeldemaske]]

Das Menü „Anmelden“ führt zu einer Maske zum Einloggen mit Benutzername und Passwort, um mit dem jeweiligen Konto verbundene weitere [[Webtrees Handbuch/Anleitung für Administratoren/Benutzer#Rollen|rollenspezifische Funktionen]] nutzen zu können.

In Benutzernamen werden Groß-und Kleinschreibung und Buchstaben mit Akzenten ignoriert, so dass „Chloe“, „chloë“ und „CHLOE“ als identisch betrachtet werden.

Passwörter müssen mindestens 8 Zeichen lang sein. Groß-/Kleinschreibung werden berücksichtigt.

[[Datei:WT_2.0_Neues-Passwort-anfragen.png|thumb|left|150px|Neues Passwort anfragen]]
Sollte man das Passwort für sein Benutzerkonto vergessen haben, besteht die Möglichkeit unter Angabe der E-Mail-Adresse einen Link zum Zurücksetzen des Passwortes anzufordern. Der Link ist eine Stunde gültig.
 

Sofern durch den Administrator in den [[Webtrees Handbuch/Anleitung für Administratoren/Webseite#Anmeldung und Registrierung|Einstellungen]] freigegeben, gibt es auf diesem Formular auch einen Link mit dem Sie ein neues Benutzerkonto anfordern können, falls Sie noch keines haben.

{{-}}

[[Datei:WT_2.0_Neues-Benutzerkonto-anfragen.png|thumb|right|250px|Neues Benutzerkonto anfragen]]
Mit dem Formular '''"Neues Benutzerkonto anfragen"''' werden folgende Daten abgefragt (vgl. hierzu auch den Abschnitt "[[Webtrees Handbuch/Anleitung für Administratoren/Benutzer#Einen Benutzer hinzufügen|Einen Benutzer hinzufügen]]")
* Vollständiger Name
* E-Mail-Adresse
* Benutzername
* Passwort und
* Bemerkung - hiermit sollte dem Administrator nachvollziehbar mitgeteilt werden, warum sich jemand registrieren will und welche Verbindung bzw. Interesse zum bzw. am betreffenden Stammbaum besteht.

Nach dem vollständigen Ausfüllen des Formulars wird an die angegebene Adresse eine Überprüfungs-E-Mail geschickt. Der in der E-Mail enthaltene Link muss angeclickt werden, um die E-Mail-Adresse zu verifizieren. Falls innerhalb von 7 Tagen keine Reaktion erfolgt, wird die Registrierungsanfrage automatisch verworfen.

Wenn die E-Mail-Adresse erfolgreich bestätigt wurde, erhält der Administrator die Anfrage, um das Benutzerkonto noch zu aktivieren, bevor eine erste Anmeldung erfolgen kann.

{{-}}

{{WT-ToDo|
Gibt es eigentlich auch Captchas zur Absicherung des Anmelde-/Registrierungsprozess? (Vgl. https://github.com/fisharebest/webtrees/issues/2901)
}}

=== Suchfeld ===
[[bild:WT 2.0 suchen.png|thumb|right|400px|Suchen]]
Es gibt im Kopfmenü immer ein "Suchfeld" mit dem Sie etwa nach einer Person oder einem Ort suchen können. Es entspricht vom Funktionsumfang der '''Allgemeinen Suche''' - siehe hierzu die Erläuterungen weiter unten zum [[#Suchen|Suchen-Menü]].

Dieses Suchfeld beinhaltet noch zwei Sondersuchfunktionen bei der Suche nach
* [[GEDCOM/HEAD-Tag|HEAD]]: der Kopfbereich der GEDCOM-Datei dieses Stammbaums wird angezeigt
* SUBN: der Übermittlungsdatensatz in der GEDCOM-Datei wird angezeigt (dieser Datensatztyp wird schon lange nicht mehr verwendet).
{{-}}

== Hauptmenü ==
[[Datei:WT 2.0 Hauptmenue.png|thumb|right|400px|Hauptmenue]]
Das Hauptmenü von Webtrees kann vom Administrator angepasst werden und einige Menüpunkte können für Besucher, registrierte Mitglieder oder nur für Manager und Administratoren sichtbar sein.
Alternativ kann der Administrator einige Teile des Menüs deaktivieren und sie so vor allen verbergen.

Die Liste der Menüpunkte kann vom Administrator in beliebiger Reihenfolge neu angeordnet werden, sodass sie möglicherweise nicht in der unten beschriebenen Reihenfolge vorliegen. Andere Elemente können dem Hauptmenü durch [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodule]] hinzugefügt werden, die nicht Teil des webtrees-Standards sind.
{{-}}

=== Stammbäume ===
[[datei:WT_2.0_Stammbaum.png|thumb|right|400px|Stammbaum]]
Manche webtrees Installationen enthalten nur einen Stammbaum, in anderen können durchaus mehrere vorhanden sein. Durch Klicken auf das Symbol „Stammbäume“ werden die Namen aller auf der Website angelegten Bäume angezeigt. Durch Klicken auf einen der Namen gelangen Sie zu diesem Baum.

{{-}}

=== Diagramme ===
[[datei:WT_2.0_Diagramme.png|thumb|right|400px|Diagramme]]
Die Diagramme ermöglichen die Erschließung und Visualisierung der Stammbaumdaten am Bildschirm; einige der Diagramme können auch gut ausgedruckt werden. Es werden unterschiedliche Parameter für die Erstellung abgefragt - in der Regel eine Bezugsperson und beispielsweise die Anzahl der zu berücksichtigenden Generationen. Einen Vergleich aller für webtrees verfügbaren Diagramme findet man auf einer Unterseite in einer [[Webtrees Handbuch/Anleitung für Besucher/Diagramme Vergleichstabelle|Tabelle]].

Folgende Diagramme werden mit webtrees ausgeliefert
* Beziehungen
* Familienbuch
* Fächerdiagramm
* Interaktives Sanduhrdiagramm
* Kompakte Vorfahrentafel
* Lebensspannen
* Nachkommen
* Sanduhrdiagramm
* Statistiken
* Vorfahren
* Vorfahrenkarte
* Vorfahrentafel
* Zeitleiste
{{-}}

Für einen schnellen Überblick über die Datenbasis eignet sich etwa das '''Statistiken'''-Diagramm: Es gibt Auskunft über Personen und Familien, die Verteilung auf Geschlechter, Ereignisse, Namenshäufigkeiten, Durchschnittsalter, Familiengrößen, verwendete Medienobjekte, Quellen für Personen, Quellen für Familien, etc.

Mit dem '''Interaktiven Sanduhrdiagramm''' kann der Stammbaum von einem Ahn ausgehend in Richtung Vor- und Nachfahren erkundet werden. Dieses Diagramm kommt auch auf dem [[#Interaktives_Sanduhrdiagramm|gleichnamigen Reiter]] bei der Anzeige der Personendaten zum Einsatz.

Das '''Beziehungen'''-Diagramm findet die Verbindungen zwischen zwei Personen und nennt dazu die entsprechenden verwandtschaftlichen Bezeichnungen.

Die Diagramme '''Vorfahren''' und '''Nachkommen''' listen die Ahnen bzw. die Nachkommen in einer vertikalen Baumstruktur auf oder stellen die Personen bzw. Familien tabellarisch dar.

Die '''Lebensspannen''' von mehreren Personen oder aller Personen mit Bezug zu einem Ort können im gleichnamigen Diagramm über- und nebeneinander visualisiert werden.

Ereignisdaten von mehreren Personen können in einer vertikalen '''Zeitleiste''' nebst optionalen Alterszeigern der Personen gegenübergestellt werden.

Die '''Vorfahrentafel''' ordnet die Ahnen in einer typischen Baumstruktur (Ausrichtung links<->rechts oder oben<->unten) an. Bei der '''Kompakten Vorfahrentafel''' werden die Ahnen bis zur 5. Generation in einem rechteckigen Raster verteilt, ausgehend von der Bezugsperson in der Mitte.

Beim '''Fächerdiagramm''' werden die Ahnen im Halb-, Dreiviertel- oder Vollkreis um die Bezugsperson in der Mitte angeordnet.

Im '''Familienbuch''' werden von der Bezugsperson ausgehend jeweils horizontale Bäume je Familie für eine bestimmbare Anzahl Nachkommengenerationen untereinander dargestellt. Dabei wird die Bezugsperson, die jeweils in der Mitte des Familienbaums angezeigt wird, durchgewechselt. Die pro Familie gleichzeitig angezeigten Generationen - sozusagen der Sichtbereich - kann von 2 bis 5 festgelegt werden.

Das '''Sanduhrdiagramm''' entspricht der Darstellungsform (horizontaler Baum, Bezugsperson in der Mitte) wie sie beim Familienbuch Verwendung findet.

Auf der '''Vorfahrenkarte''' werden zur ausgewählten Person die Geburtsorte der Vorfahren und die Verbindungen zu ihnen nach Generationen eingezeichnet. In der Spalte rechts neben der Karte befinden sich die Namen der Vorfahren. Durch Anclicken eines der Symbole in der Karte oder eines der Namen in der rechten Spalte werden die jeweiligen Personen mit ihren Geburtsdaten hervorgehoben.

<gallery perrow=5>
Datei:WT_2.0_Diagramm-Beziehungen.png|Beziehungen
Datei:WT_2.0_Diagramm-Faecher-Halbkreis.png|Fächerdiagramm (Halbkreis)
Datei:WT_2.0_Diagramm-Familienbuch.png|Familienbuch
Datei:WT_2.0_Diagramm-Interaktive-Sanduhr.png|Interaktives Sanduhrdiagramm
Datei:WT_2.0_Diagramm-kompakte-Vorfahrentafel.png|Kompakte Vorfahrentafel
Datei:WT_2.0_Diagramm-Lebensspannen.png|Lebensspannen
Datei:WT_2.0_Diagramm-Nachkommen.png|Nachkommen
Datei:WT_2.0_Diagramm-Sanduhr.png|Sanduhrdiagramm
Datei:WT_2.0_Diagramm-Statistiken.png|Statistiken
Datei:WT_2.0_Diagramm-Vorfahren.png|Vorfahren
Datei:WT_2.1_Anleitung-fuer-Besucher_Vorfahrenkarte.png|Vorfahrenkarte
Datei:WT_2.0_Diagramm-Vorfahrentafel.png|Vorfahrentafel
Datei:WT_2.0_Diagramm-Zeitleiste.png|Zeitleiste
</gallery>

=== Listen ===
<gallery perrow=1 widths="250" caption="Listen-Menü" style="float:right;">
Datei:WT_2.1_Listen_Besucher.png|Besucher-Ansicht
Datei:WT_2.1_Listen_Admin.png|Administratoren-Ansicht
</gallery>
Folgende Listen sind verfügbar für die Erschließung der Daten nach den jeweiligen Ressourcentypen (auch wenn sie standardmäßig für unterschiedliche Rollen sichtbar sind, werden sie hier alle erläutert):

Besucher:
* Familien
* Familienzweige
* Gemeinsame Notizen
* Medienobjekte
* Personen
Mitglieder:
* Archive
* Hierarchie der Orte
* Orte
* Quellen
Verwalter:
* Übermittler

Die Sichten '''Archive''', '''Gemeinsame Notizen''', '''Orte''', '''Quellen''' und '''Übermittler''' listen die jeweiligen Datensätze tabellarisch auf.

<gallery perrow=3 widths="250">
Datei:WT_2.1_Listen-Archive.png|Archive
Datei:WT_2.1_Listen-Notizen.png|Gemeinsame Notizen
Datei:WT_2.1_Listen-Orte.png|Orte
Datei:WT_2.1_Listen-Quellen.png|Quellen
Datei:WT_2.1_Listen-Uebermittler.png|Übermittler
</gallery>

'''Personen''' und '''Familien''' lassen sich nach dem Anfangsbuchstaben des Nachnamens eingrenzen. Die aggregierte Übersichtsliste der Nachnamen kann je nach [[Webtrees_Handbuch/Anleitung_für_Verwalter#Einstellungen|Einstellung für den Stammbaum]] als (mehrspaltige) Liste, Tabelle oder Namenswolke dargestellt werden. Von dort erreicht man dann eine tabellarische Auflistung der gewünschten Personendatensätze. Ob eine weitere Unterteilung der Personenliste durchgeführt wird, steuert die Stammbaum-Einstellung "Maximale Anzahl von Nachnamen auf der Personenliste".<ref>Lange Listen von Personen mit gleichem Nachnamen können nach dem Anfangsbuchstaben dessen Vornamen in kleinere Listen aufgeteilt werden. Mit dieser Option geben Sie die maximale Listenlänge der Nachnamen an ab der die Unterteilung durchgeführt wird.</ref>

<gallery perrow=4 widths="200" caption="Personen">
Datei:WT_2.1_Listen-Personen.png|Personen (Personenliste)
Datei:WT_2.1_Listen-Personen-Nachname.png|Personen (Nachnamenliste als Tabelle)
Datei:WT_2.1_Listen-Personen-Nachname-Liste.png|Personen (Nachnamenliste als Liste)
Datei:WT_2.1_Listen-Personen-Unterteilung.png|Personen (Personenliste mit Unterteilung)
</gallery>
<gallery perrow=4 widths="200" caption="Familien">
Datei:WT_2.1_Listen-Familien-Personen.png|Familien (Personenliste)
Datei:WT_2.1_Listen-Familien-Nachnamen.png|Familien (Nachnamenliste als Tabelle)
Datei:WT_2.1_Listen-Familien-Nachnamen-Wolke.png|Familien (Nachnamenliste als Wolke)
</gallery>
Die Tabellen für die Auflistung nach Personen ermöglichen dabei weitreichende Filtermöglichkeiten über einen benutzerdefinierten Text und vorgegebenen Filterknöpfen (bspw. Geschlecht oder ob noch lebend bzw. gestorben). Ferner können die Eltern sowie ein Statistikdiagramm engeblendet werden.

<gallery perrow=1 widths="250" style="float:right;">
Datei:WT_2.1_Listen-Familienzweige.png|Familienzweige
Datei:WT_2.1_Listen-Medienobjekte.png|Medienobjekte
Datei:WT_2.1_Listen-Ortshierarchie.png|Hierarchie der Orte
</gallery>
'''Familienzweige''' erfordert eine Nachnamen-Suche (auch phonetisch) zur Eingrenzung des Ergebnisses. Die Treffer werden nummeriert und entsprechend ihrer Hierarchieebene eingerückt dargestellt.

'''Medienobjekte''' können nach Verzeichnis, Medientyp und weiterem Suchtext gefiltert werden. Die Auflistung der Objekte erfolgt in einer Art Kachelanordnung mit Vorschaubild, Metadaten und ggf. vorhandenen Verknüpfungen (zu Personen, Familien, Quellen).

Mit der '''Hierarchie der Orte''' können die georeferenzierten Orte auf einer Karte visualisiert und über ein Ereignis dem jeweiligen Ort zugeordnete Personen- und Familiendatensätze in einer Tabelle darunter angezeigt werden.

<div style="display:flow-root;">
{{Infobox|Die [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule|Vesta-Module]] erlauben noch eine Erweiterung um die Listen '''Gemeinsame Orte''' und '''Personen mit Patriarchen'''.}}
</div>
{{-}}

=== Kalender ===
[[datei:WT_2.0_Kalender.png|thumb|right|400px|Kalender]]
Mit dem "Kalender" wird ausgehend vom aktuellen Datum die Datenbasis des gewählten Stammbaums auf Datensätze gefiltert, deren Ereignisse an dem Tag und Monat, innerhalb des Monats oder im gewählten Jahr liegen.

Neben der Selektionsmöglichkeit für Tag, Monat und Jahr kann der Datenbestand weiter eingegrenzt werden auf:
* "Alle Personen", "Lebende Personen" und "Jüngere Ereignisse (< 100 Jahre)"
* nach Geschlecht (alle, männlich oder weiblich)
* und Ereignistyp:
** Geburt/Heirat/Tod
** Alle
** Geburt
** Taufe
** Heirat
** Scheidung
** Tod
** Bestattung
** Auswanderung
** Benutzerdefiniertes Ereignis

In der Tages- und Jahresansicht werden Personen- und Familiendatensätze in zwei Listen nebeneinander getrennt dargestellt. Die Monatsansicht ist ein Monatskalenderblatt mit gleich großen Zellen für jeden Tag: Die Datensätze (zunächst für Personen, dann für Familien) werden innerhalb der jeweiligen Zelle für den betreffenden Tag aufgelistet. Bei Bedarf werden Seitenrollbalken eingeblendet. Keinem Tag zuordbare Datensätze schließen sich oben links oder unten rechts an.

Es wird die Darstellung im gregorianischen<ref>{{wikipedia-Link|Gregorianischer Kalender}}</ref>, julianischen<ref>{{wikipedia-Link|Julianischer Kalender}}</ref>, jüdischen<ref>{{wikipedia-Link|Jüdischer Kalender}}</ref>, islamischen<ref>{{wikipedia-Link|Islamischer Kalender}}</ref> und Jalali-Kalender<ref>https://en.wikipedia.org/wiki/Jalali_calendar</ref> unterstützt.

Weitere Details zu [[Webtrees_Handbuch/Anleitung_f%C3%BCr_Bearbeiter#Datumsangaben|Datumsangaben]] können dem gleichnamigen Abschnitt im Bearbeiter-Kapitel entnommen werden.

<gallery perrow="3" widths="300" caption="Kalender-Ansichten">
Datei:WT_2.1_Kalender-Tag.png|An diesem Tag
Datei:WT_2.1_Kalender-Monat.png|In diesem Monat
Datei:WT_2.1_Kalender-Jahr.png|In diesem Jahr
</gallery>

=== Berichte ===
[[datei:WT_2.0_Berichte.png|thumb|right|400px|Berichte]]
Mittels der Berichte können die genealogischen Daten für den Druck aufbereitet werden.

Mögliche Ausgabeformate sind HTML<ref>Abkürzung für Hypertext Markup Language. HTML-Dokumente sind die Grundlage des World Wide Web; ihre Darstellung erfolgt mit einem Browser (siehe {{wikipedia-Link|HTML}}).</ref> und PDF<ref>Abkürzung für Portable Document Format (siehe {{wikipedia-Link|Portable_Document_Format}}).</ref>.

Folgende Berichte werden mit webtrees ausgeliefert
* Bestattungen
* Eheschließungen
* Familie
* Geburten
* Nachkommen
* Person
* Personendaten
* Sterbefälle
* Verwandte Personen
* Vorfahren
* Vorfahrentafel

{{-}}
{{Infobox|
Veraltete Berichte
 Die Berichte in webtrees stammen noch aus der Zeit des Vorgängerprogramms [[PhpGedView]]. Sie werden seit langer Zeit nicht mehr gepflegt und müssen irgendwann komplett neu implementiert werden. Daher ist die Gestaltung der Berichte antiquiert und es muss mit Fehlern in der Darstelung gerechnet werden.
}}

=== Suchen ===
[[datei:WT_2.0_Suchen.png|thumb|right|400px|Suchen]]
Das Suchen-Menü enthält drei Suchmöglichkeiten
* Allgemeine Suche
* Phonetische Suche
* Erweiterte Suche

Über die '''Allgemeine Suche''' wird nach Vorkommen der gegebenen Stichworte irgendwo in den gewünschten Datensätzen (Personen, Familien, Quellen, Archive, Gemeinsame Notizen) der Stammbäume gesucht. Standardmäßig sind Personen- und Familien-Datensätze und der aktuelle Stammbaum vorausgewählt. Diese Suche wird auch über das Suchfeld oberhalb des Hauptmenüs bedient.

Wenn im Suchfeld mehr als ein Begriff eingegeben wird, dann wird nach all diesen Begriffen gesucht, unabhängig von deren Reihenfolge. Zum Beispiel findet die Suche nach dem Begriff <code>new york</code> den Eintrag "ADDR 1 York Street, Newfoundland". Die Klein-/Großschreibung spielt bei der Suche keine Rolle. Einige GEDCOM-Kennzeichen sind von der Suche ausgenommen, zum Beispiel <code>_UID</code>. Wird der Suchbegriff in doppelte Anführungszeichen eingeschlossen, wird genau nach dem eingeschlossenen Begriff gesucht. Die Suche nach <code>"new york"</code> findet in diesem Fall die Einträge "New York State" und "New York City", aber nicht die zuvor gefundene Adresse. Allerdings wird auch der Begriff "John Agnew Yorkston" gefunden.<ref>Vgl. Forumsbeitrag "Help for version 2.1 > General Search": https://www.webtrees.net/index.php/en/forum/help-for-release-2-1-x/37644-general-search</ref> 
Anders als etwa bei der Google-Suche wird ein Platzhalter wie <code>*</code> nicht unterstützt; es gibt auch keine logischen Verknüpfungen wie <code>|</code> oder <code>-</code>.

Bei der '''Phonetischen Suche''' können Vor- und Nachname sowie der Ort für das Auffinden von ähnlich klingenden Treffer-Worten in Personen-Datensätzen wählbarer Stammbäume herangezogen werden. Standardmäßig wird der [https://de.wikipedia.org/wiki/Soundex Russell]-Algorithmus zugrunde gelegt, möglich ist auch die Auswahl von [https://en.wikipedia.org/wiki/Daitch%E2%80%93Mokotoff_Soundex Daitch-Mokotoff] (besser geeignet für slawische und jiddische Namen).

Sehr spezifische Suchen über die Personen-Datensätze im aktuell gewählten Stammbaum erlaubt die '''Erweiterte Suche''': Hier können so ziemlich alle möglichen Eigenschaftswerte mit einbezogen werden. Bei Namens- (Genau, Beginnt mit, Enthält, Lautet wie) und Datumsfeldern (genaues Datum oder näherungsweise von 1 bis 20 Jahren) kann zudem die Suchgenauigkeit bestimmt werden.

Die Treffer werden in Tabellen getrennt nach Datensatz-Typ aufgelistet. Es werden nur Treffer angezeigt für die der Nutzer die entsprechend seiner Rolle definierten Zugriffsrechte hat.

Über für jede Datensatzart spezifische vordefinierte Filter-Knöpfe und ein weiteres Filter-Suchfeld können die Treffer weiter eingegrenzt werden. Zusätzlich lassen sich die jeweiligen Eltern der gefundenen Personen bei den Treffern mit einblenden und ein Statistik-Diagramm anzeigen. Auf welchen Stammbaum sich der Treffer bezieht, ist lediglich anhand des Links in der Statuszeile des Browsers zu erkennen, wenn man mit dem Mauscursor über den Namenswerten in der ersten Tabellenspalte verweilt.

<gallery perrow="3" widths="250">
Datei:WT_2.1_Menue-Suche-Allgemein.png|Allgemeine Suche
Datei:WT_2.1_Menue-Suche-Phonetisch.png|Phonetische Suche
Datei:WT_2.1_Menue-Suche-Erweitert.png|Erweiterte Suche
</gallery>

Neben der für Besucher verfügbaren Suche, so wie sie hier beschrieben ist, gibt es für Verwalter und Administratoren eine [[Webtrees Handbuch/Anleitung für Verwalter#Datenkorrekturen|weitere Möglichkeit zum Suchen und Ersetzen]], die noch mächtiger ist und auch reguläre Ausdrücke<ref>{{wikipedia-Link|Regulärer_Ausdruck}}</ref> unterstützt.

=== Geschichten ===
[[Datei:WT_2.1_Personenseite-Reiter-Geschichte.png|thumb|right|250px|Personenseite - Reiter 'Geschichten']]
Das Modul "Geschichten" ist standardmäßig nicht aktiv und muss erste durch den [[Webtrees_Handbuch/Anleitung_für_Administratoren/Module#Alle_Module|Administrator konfiguriert]] werden.
Sofern die Sichtbarkeit für die Rolle entsprechend gegeben ist und für die Person eine [[Webtrees_Handbuch/Anleitung_für_Bearbeiter#Geschichten|Geschichte durch den Administrator erstellt]] wurde, wird der Reiter 'Geschichten' angezeigt.
{{-}}

=== Häufige Fragen (FAQ) ===
[[datei:WT_2.0_FAQ.png|thumb|right|400px|FAQ]]
im Menü "Häufig gestellte Fragen" (FAQ<ref>{{wikipedia-Link|Frequently_Asked_Questions}}</ref>) werden vorbereitete Antworten angeboten, die dazu dienen, den Benutzern der Webseite Informationen, Regeln, Methoden und Vorgehensweisen näher zu bringen. Die Fragen bewegen sich im allgemeinen um die Bereiche Benutzerkonten und Zugang, Copyright und Datenschutz, verwendete Inhalte, Anforderungen an Quellenzitate, usw.

Sowohl die Bereitstellung dieses Menüs als auch die Erstellung der Beiträge erfolgt durch den Administrator für einen oder alle Stammbäume. Das zugehörige Formular ähnelt dem des [[Webtrees_Handbuch/Anleitung_für_Administratoren/Stammbäume#html-block|HTML-Blocks]]. Die Antworten können daher mit HTML formatiert werden und Links enthalten. Für jede FAQ in weiteren Sprachen muss je ein weiterer Block erstellt werden.

<gallery perrow=2 widths="250">
Datei:WT_2.1_Modul-FAQ-Liste.png|Liste der vorhandenen FAQ-Beiträge
Datei:WT_2.1_Modul-FAQ-Eintrag-bearbeiten.png|Erstellen/Bearbeiten eines FAQ-Beitrags
</gallery>
{{-}}

== Blöcke der Startseite ==
<div style="float:right;">
Die Blöcke der Startseite können folgendermaßen aussehen:
[[Datei:WT 2.0 Bloecke Startseite.png|border|right|400px |link=http://wiki-commons.genealogy.net/images/b/b2/WT_2.0_Bloecke_Startseite.png]]
</div>

Die Startseite ist der Ausgangspunkt beim Besuch eines [[#Stammb.C3.A4ume|Stammbaum]]. Als Blöcke sind rechteckige Einheiten zu verstehen, die automatisch Informationen zu den jeweiligen [[#Stammb.C3.A4ume|Stammbäumen]] generieren oder benutzerdefinierte Inhalte bereitstellen.

Standardmäßig werden folgende Blöcke angezeigt:
* Hauptbereich:
** Statistiken
** Neuigkeiten
** Favoriten
* seitlicher Bereich:
** Startseite
** Diashow
** Anstehende Ereignisse
** Wer ist online

Mehr Details zu den verfügbaren Blöcken können dem Abschnitt [[Webtrees_Handbuch/Anleitung_für_Administratoren/Module#Startseite|Startseite]] entnommen werden.
{{-}}

== Personenseite mit Reitern und Navigationsleiste ==
[[Datei:WT_2.1_Personenseite.png|thumb|right|350px|Personenseite]]
Die "Personenseite" stellt die Informationen eines Personendatensatzes mit den in nachfolgenden Unterabschnitten beschriebenen Seitenelementen dar.

Je nach Konfiguration und ggf. weiteren installierten Modulen - vgl. hierzu den Abschnitt [[Webtrees_Handbuch/Anleitung_für_Administratoren/Module|Anleitung für Administratoren > Module]] - kann die Darstellung variieren. Hier wird der Standard von webtrees beschrieben.
{{-}}

=== Reiter ===
Die zu einer Person erfassten Daten werden in mehreren Karteiblättern gruppiert, die über Reiter erreichbar sind, und unter den folgenden Begriffen zusammengefasst:
* [[#Tatsachen_und_Ereignisse|Tatsachen und Ereignisse]]
* [[#Familien|Familien]]
* [[#Quellen|Quellen]]
* [[#Notizen|Notizen]]
* [[#Multimedia|Multimedia]]
* [[#Album|Album]]
* [[#Interaktives_Sanduhrdiagramm|Interaktives Sanduhrdiagramm]]

Ein Klick auf den jeweiligen Reiternamen bringt die damit assoziierten Informationen zum Vorschein.
{{-}}

==== Tatsachen und Ereignisse ====
[[Datei:WT_2.1_Personenseite-Reiter-Tatsachen+Ereignisse.png|thumb|right|350px|Reiter "Tatsachen und Ereignisse"]]
Auf diesem Reiter werden die Tatsachen und Ereignisse (bspw. Geburt, Ausbildung, Wohnorte, Heirat, Tod) zur Person zusammengefasst. Durch Aktivierung der Option "Ereignisse naher Verwandter" (Eltern, Geschwister und Kinder) können selbige hier auch mit eingeblendet werden.

Sofern Module für "Historische Ereignisse" durch den Administrator installiert wurden, ermöglicht eine gesondert aktivierbare Option die Aufnahme von in die Lebenszeit fallenden Einträgen in die gemeinsame Ansicht. Nachfolgender Unterabschnitt liefert hierzu noch mehr Details.
{{-}}

===== Historische Ereignisse =====
In den Lebenslauf einer Person können bei Bedarf historische Ereignisse eingeblendet werden, so dass man den Zeitbezug besser erkennen kann. Dazu selektiert der Besucher die entsprechende Option, die dann für den weiteren Verlauf der Browser-Sitzung ausgewählt bleibt.

Die folgenden Module stehen im webtrees-Kern zur Verfügung
* British monarchs
* British prime ministers
* British social history
* Bundespräsidenten Österreichs
* Čeští panovníci a prezidenti
* Faits historiques de France
* Historische Ereignisse Österreich
* Lijst van premiers en kabinetten van Nederland
* Machthebbers van de Lage Landen
* Nederlandse Monarchiën
* United States presidents
Es gibt darüber hinaus noch eine Vielzahl von zusätzlichen Modulen mit historischen Daten, die im Abschnitt [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule#.C3.9Cbersicht_.C3.BCber_bekannte_Erweiterungsmodule|"Übersicht über bekannte Erweiterungsmodule"]] beschrieben werden.

Der Verwalter oder der Administrator selektiert aus diesem Angebot die für einen Stammbaum anzuzeigenden Module. Das Problem dabei ist, dass es nicht immer klar ist, welche Module relevant sein könnten. Wenn eine Person, deren Lebensereignisse dargestellt werden, immer nur in einem Land lebte, etwa in Österreich, dann sind in diesem Fall sicherlich vor allem historische Ereignisse aus Österreich für diese Person relevant. In einem Stammbaum gibt es aber viele Personen, etwa welche, die nach den USA ausgewandert sind, so dass auch die Präsidenten der USA relevant sein können. Die Auswahl der Module gilt aber immer für alle Personen in einem Stammbaum. Und es kommt noch hinzu, dass nicht nur die betrachtete Person relevant ist, sondern auch der potentiell unbekannte Nutzer der Website. Wenn etwa ein Nutzer aus China den Lebenslauf einer Person aus Österreich betrachtet, würden ihn vielleicht auch zeitgleiche historische Ereignisse in China interessieren, da er die Zeitgeschichte Chinas besser kennt und ihm die zeitliche Einordnung der Lebensereignisse der dargestellten Person leichter fallen würde, wenn er diese in einen für ihn geläufigen Rahmen einbetten könnte. Die Vorauswahl der Module mit historischen Daten ist also immer eine sehr unscharfe Näherung an den vermuteten Bedarf.

==== Familien ====
[[Datei:WT_2.1_Personenseite-Reiter-Familien.png|thumb|right|350px|Reiter "Familien"]]
Sofern mit der Person Familien verknüpft sind, werden diese in der Reihenfolge "Familie mit Eltern" und Familien mit Ehepartnern jeweils in einer 2-spaltigen Tabelle präsentiert:
* In der ersten Spalte wird die Beziehung zur dargestellten Person bezeichnet,
* in der zweiten Spalte wird ein ggf. verfügbares Portrait, der Name, sowie Geburts- und Sterbedaten angezeigt. Über ein Lupensymbol mit Pluszeichen auf der rechten Seite können weitere Ereignisdaten, Referenznummer und Eindeutige Kennung in einem Popup eingeblendet werden. Das darunter befindliche Symbol eröffnet über ein weiteres Popup die Möglichkeit [[#Diagramme|Diagramme]] aufzurufen, die diese Person als Ausgangspunkt haben.

<gallery perrow=2 widths="250">
Datei:WT_2.1_Personenseite-Reiter-Familien-Lupen-Popup.png|Lupen Popup-Menü
Datei:WT_2.1_Personenseite-Reiter-Familien-Pedigree-Popup.png|Stammbaum Popup-Menü
</gallery>

Mittels Selektion der Option "Datendifferenzen zeigen" kann der Bezeichnung in der ersten Spalte noch eine Zeitdifferenzangabe des jeweiligen Familiendatensatzes zum Vorgänger angefügt werden. Hierbei werden auch Hinweise gegeben, wenn die Geburten von Geschwistern weniger als 9 Monate auseinander liegen.

Das Anklicken des jeweiligen Namens führt zum zugehörigen Personendatensatz, das der Familienbezeichnung oberhalb der Tabellen zur Seite des Familiendatensatzes.

[[Datei:WT_2.1_Familienseite.png|thumb|left|350px|Familienseite]]

{{-}}

==== Quellen ====
[[Datei:WT_2.1_Personenseite-Reiter-Quellen.png|thumb|right|350px|Reiter "Quellen"]]
Standardmäßig werden hier zunächst nur die direkt mit dem Personen- oder Familiendatensatz verknüpften [[Webtrees_Handbuch/Genealogischer_Prozess#Quellenzitat|Quellenzitate]] ([[GEDCOM/SOUR-Tag|SOUR-Tag]] auf Ebene 1) angezeigt. Durch Aktivieren der Option "Alle Quellen anzeigen" können auch die mit Ereignissen verbundenen Zitate eingeblendet werden.

[[Datei:WT_2.1_Quellenseite-Details.png|thumb|left|350px|Quellenseite]]
Der Titel des Quellenzitats ist ein Hyperlink zur '''Quellenseite'''. Hier werden alle Details zum Quellendatensatz aufgelistet. Weitere Reiter fassen nach Personen, Familien, Medienobjekten und Notizen die Datensätze zusammen, in denen auf den Quellendatensatz referenziert wird. Die Zahl hinter den Reiter-Namen weist auf die Anzahl der Verknüpfungen hin.
{{-}}

==== Notizen ====
[[Datei:WT_2.1_Personenseite-Reiter-Notizen.png|thumb|right|350px|Reiter "Notizen"]]{{WT-ToDo|Noch beschreiben: Unterschied zw. Inline und gemeinsamen Notizen.}}
Analog zu den Quellen verhält es sich auch bei den [[Webtrees_Handbuch/Genealogischer_Prozess#Notiz|Notizen]] ([[GEDCOM/NOTE-Tag|NOTE-Tag]]): Die Option "Alle Notizen anzeigen" ermöglicht das Einblenden auch der auf Tatsachen und Ereignisse bezogenen Notizen neben den Inline- bzw. gemeinsamen Notizen der obersten Ebene im Personendatensatz.

[[Datei:WT_2.1_Notizenseite-Details.png|thumb|left|350px|Notizenseite (Gemeinsame Notizen)]]
Sofern es sich nicht um eine Inline- sondern Gemeinsame Notiz handelt, 
[[Datei:WT_2.1_Personenseite-Reiter-Notizen-Ausschnitt-Gemeinsame-Notiz.png|300px|link=|alt=Darstellung einer Gemeinsamen Notiz auf dem Reiter 'Notizen']] 
gelangt man über den ggf. verkürzten als Titel dargestellten Text auf die '''Notizenseite'''.

Auf der Notizenseite werden alle Details zur Gemeinsamen Notiz aufgelistet. Über weitere Reiter werden geordnet nach Personen, Familien, Medienobjekten, Quellen, Archiven und Übermittlern die Datensätze aufgelistet, in denen auf den Notizdatensatz referenziert wird. Die Anzahl der Verknüpfungen wird durch die Zahl hinter den Reiter-Namen repräsentiert.
{{-}}

{{WT-ToDo|Mit 2.1.7 wurde die Darstellung von Gemeinsamen Notizen der Ebene 1 geändert ([https://github.com/fisharebest/webtrees/issues/4371 "#4371 - level 1 shared notes shown only as links"]): Sie haben keinen Link mehr zur Notizseite, bei Gemeinsamen Notizen der Ebene 2 gibt es sie noch in unterschiedlichen Varianten. Überarbeitung erforderlich bzw. warten, ob hier noch etwas angepasst wird.}}

==== Multimedia ====
[[Datei:WT_2.1_Personenseite-Reiter-Multimedia.png|thumb|left|350px|Reiter "Multimedia"]]
Ohne aktivierte Option "Alle Medien anzeigen" werden nur die direkt mit dem Personendatensatz verknüpften [[Webtrees_Handbuch/Genealogischer_Prozess#Medienobjekt|Medien-Objekte]] ([[GEDCOM/OBJE-Tag|OBJE-Tag]]) tabellarisch aufgelistet, ansonsten auch jene Objekte aus [[Webtrees_Handbuch/Genealogischer_Prozess#Quellenzitat|Quellenzitaten]].

[[Datei:WT_2.1_Medienseite-Details.png|thumb|right|350px|Medienseite]]
Klicken auf den Titel des Medienobjekts unterhalb des Vorschaubilds öffnet die '''Medienseite'''. Dort werden alle Details und Werte des Medienobjekts aufgelistet. Über weitere Reiter werden geordnet nach Personen, Familien, Quellen und Notizen die Datensätze aufgelistet, in denen auf das Medienobjekt referenziert wird. Die Zahl hinter den Reiter-Namen weist auf die Anzahl der Verknüpfungen hin.
<div style="clear:left;" />

==== Album ====
[[Datei:WT_2.1_Personenseite-Reiter-Album.png|thumb|left|350px|Reiter "Album"]]
Die gleiche Menge [[Webtrees_Handbuch/Genealogischer_Prozess#Medienobjekt|Medien-Objekte]] wie unter Reiter "Multimedia" mit aktivierter Option "Alle Medien anzeigen" wird hier nebeneinander angezeigt - jeweils mit Bild und Titel. Lediglich die Möglichkeit zur Bearbeitung der Verknüpfung fehlt (verglichen mit der [[Webtrees_Handbuch/Anleitung_für_Bearbeiter#Medien-Datens.C3.A4tze|Bearbeitungsansicht des Reiters "Multimedia"]]). Ein Klick auf den Titel führt zur Anzeige des Medienobjekt-Datensatzes auf der Medienseite. Wie auch auf dem Reiter "Multimedia" zeigt das Klicken auf das Bild die Mediendatei vergrößert in einer Lightbox<ref>{{Wikipedia-Link|Lightbox}}</ref> an.
{{-}}

==== Interaktives Sanduhrdiagramm ====
[[Datei:WT_2.1_Personenseite-Reiter-Interaktives-Sanduhrdiagramm.png|thumb|right|350px|Reiter "Interaktives Sanduhrdiagramm"]]
Dieses Element entspricht dem gleichnamigen [[#Diagramme|Diagramm]], das in die Seite eingebettet wurde und den dargestellten Personendatensatz als Ausgangspunkt nimmt.

{{-}}

=== Navigationsleiste ===
Die Navigationsleiste beherbergt in einem "Akkordeon-Menü" folgende drei Aufklapp-Elemente:
* Zusätzliche Information
* Familienlotse (standardmäßig expandiert)
* Nachkommen

Über die [[Webtrees_Handbuch/Anleitung_für_Administratoren/Module#Navigationsleisten|Moduleinstellungen]] kann der Administrator die Sichtbarkeit steuern.
{{-}}

==== Zusätzliche Information ====
[[Datei:WT_2.1_Personenseite-Zusaetzliche-Informationen.png|thumb|right|250px|Zusätzliche Informationen]]
In diesem Kasten werden Referenznummer ([[GEDCOM-Tags|REFN-Tag]]), Eindeutige Kennung ([[GEDCOM/UID-Tag|_UID-Tag]]) und Informationen zum Zeitpunkt der letzten Änderung und Bearbeiter angezeigt ([[GEDCOM-Tags|CHAN-Tag]]).
{{-}}

==== Familienlotse ====
[[Datei:WT_2.1_Personenseite-Familienlotse.png|thumb|right|250px|Familienlotse]]
Die Darstellung erfolgt ähnlich wie unterhalb des Reiters "[[#Familien|Familien]]", nur ist sie vereinfacht ohne Bilder und auf den Namen mit Lebens-Jahreszahlen reduziert. Der Name ist ein Link auf den Personendatensatz, über den Bezeichner in der ersten Spalte (sofern dieser mit einem nach unten gerichteten Dreieck gekennzeichnet ist) kann ein Popup-Menü mit Sprungmöglichkeiten zu weiteren assoziierten Eltern, Familien und Kindern (Familien- und Personen-Datensätze) eingeblendet werden.
{{-}}

==== Nachkommen ====
[[Datei:WT_2.1_Personenseite-Nachkommen.png|thumb|right|250px|Nachkommen]]
Die Nachkommen der aktuellen Person werden in einer flachen Liste dargestellt mit Namen und in Klammern den Jahren der Lebenszeit. Durch Klicken auf das Plus- bzw. Minus-Icon und den Namens-Link werden die Nachkommen der betreffenden Person ein- bzw. ausgeblendet. Nach dem Namen werden Personen-Icons angezeigt, worüber zur entsprechenden Personenseite gewechselt werden kann. Hinter den aufgelisteten Frauennamen können zudem noch Familien-Icons angezeigt werden, die entsprechend zur [[Webtrees_Handbuch/Anleitung_für_Bearbeiter#Familien-Datens.C3.A4tze|Familienseite]] verzweigen.

Über das Eingabefeld oberhalb der Namensliste wird nicht nur in den Nachkommen, sondern über den gesammten Stammbaum gesucht. Die Suchtreffer werden unter dem Feld aufgeführt. Das Zurücksetzen der Liste ist nur durch einen Neuaufruf der Personenseite möglich.
{{-}}

== Fußzeilen ==
[[Datei:WT 2.1 Verwaltung-Module Fusszeilen Beispiel.png|alternativtext=Verwaltung - Beispiel für Fußzeilen|thumb|right|350px|Beispiel für Fußzeilen]]
Am Ende der Seite können zusätzliche Informationen und Links (Unterstützt von webtrees, Kontaktangaben, Besucherzähler und Datenschutzerklärung) dargestellt werden. Details hierzu können der korrespondierenden [[Webtrees_Handbuch/Anleitung_für_Administratoren/Module#Fu.C3.9Fzeilen|Einstellungsseite]] entnommen werden.
{{-}}

== Einzelnachweise ==
<references />

[[Kategorie:Webtrees]]

Webtrees Handbuch/Anleitung für Bearbeiter

2023-03-14T20:38:51Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Kapitel 4|info=1|sticktable=1}}{{WT-Inhaltsverzeichnis|Kapitel 4|A}}
{{#css:#calsys table { width:95%;} }}

== Allgemeines zur Bearbeitung von Informationen ==
Ab der Rolle Bearbeiter kann man die Datenfelder grundsätzlich über verfügbare '''Bearbeitungsformulare''' aufrufen.
* Dabei stehen Eingabehilfen wie Katalogwerte, Kalendersteuerelemente und Datensatzsuchfelder (sowie die Möglichkeit auch neue Datensätze für Medienobjekte, Quellen oder Notizen über die Plus-Schaltfläche zu erstellen) zur Verfügung.
* Ferner wird die Zuordnung von untergeordneten Datenfeldern durch Gruppierung und Einrückungen kenntlich gemacht. Zur besseren Übersicht ist auch das Ein-/Ausblenden möglich.
* Abhängig von den durch den Administrator getroffenen Einstellungen zu den [[Webtrees_Handbuch/Anleitung_für_Administratoren/Webseite#GEDCOM-Kennzeichen|GEDCOM-Kennzeichen]] werden vermutlich nicht alle Datenfelder eingeblendet. Durch Klicken auf den Verweis "Mit allen GEDCOM-Kennzeichen bearbeiten" am Ende des Formulars kann die gesamte Palette an Datenfeldern in einem längeren Formular dargestellt werden. [[Datei:WT_2.1_Bearbeitungsformular-Fusszeile-alle-Kennzeichen.png|400px|link=|alt=Bearbeitungsformular-Fußzeile Link "Mit allen GEDCOM-Kennzeichen bearbeiten"]]
* Es ist möglich den Änderungszeitstempel des Datensatzes durch die Bearbeitung unverändert zu belassen. Dazu muss lediglich das Ankreuzfeld oberhalb der Schaltfläche "Speichern" aktiviert werden. [[Datei:WT_2.1_Bearbeitungsformular-Fusszeile-Aenderung-beibehalten.png|400px|link=|alt=Bearbeitungsformular-Fußzeile Checkbox "Den Eintrag 'Letzte Änderung' beibehalten"]]

<div style="display:flow-root; padding-right:5px;">
{{Infobox|Wenn für das zur Bearbeitung verwendete Benutzerkonto vorgenommene Änderungen NICHT automatisch genehmigt und damit übernommen werden, sollten Sie die Ausführungen zum Freigabeprozess in Kapitel [[Webtrees_Handbuch/Anleitung_für_Moderatoren|Anleitung für Moderatoren]] beachten.}}
</div>

=== Bearbeiten der GEDCOM-Rohdaten ===
Eine weitere Möglichkeit zur Änderung von genealogischen Daten besteht in der direkten Bearbeitung der GEDCOM Rohdaten (siehe auch Abschnitt "[[Webtrees Handbuch/Nutzungserfahrungen#Arbeiten%20auf%20der%20GEDCOM-Ebene|Arbeiten auf der GEDCOM-Ebene]]" im Kapitel [[Webtrees Handbuch/Nutzungserfahrungen|"Nutzungserfahrungen"]]): Verwalter und Administratoren haben die erforderlichen Rechte sowie Bearbeiter, wenn in den [[Webtrees_Handbuch/Anleitung_für_Verwalter#Einstellungen|Einstellungen des Stammbaums]] die Option "Besuchern erlauben die GEDCOM-Rohdaten anzusehen" aktiviert wurde. Für den Wechsel des Bearbeitungsmodus erscheint am Ende des regulären Formulars der Link "GEDCOM Rohdaten bearbeiten". Außerdem kann im Kontextmenü "Bearbeiten" diese Funktion auch direkt ausgewählt werden.

Die Rohdaten können komplett für Ebene-0-Datensätze oder auch nur einzelne Datenfelder bearbeitet werden: Für die bessere Übersicht werden im ersten Fall die Datenfelder durch Überschriften und getrennte Eingabefelder sichtbar voneinander abgegrenzt. Eine Änderung der Reihenfolge der Datenfelder ist durch Drag-and-Drop über Klicken auf die Überschriftenzeile oder die Knöpfe mit der Beschriftung "erster / oben / unten / letzte" möglich. Der GEDCOM-Quelltext für neue Datenfelder kann im letzten Eingabefeld "Eine Tatsache hinzufügen" eintragen werden. Die Daten können nach dem Bearbeiten nur dann gespeichert werden, wenn sie syntaktisch richtigem GEDCOM entsprechen.

<gallery perrow=3 widths="250" caption="GEDCOM Rohdaten bearbeiten">
Datei:WT_2.1_Person-bearbeiten-alle-GEDCOM-Rohdaten.png|Ebene-0-Datensatz
Datei:WT_2.1_Bearbeitungsformular-Fusszeile-Rohdaten.png|Bearbeitungsformular mit Link "GEDCOM Rohdaten bearbeiten"
Datei:WT_2.1_Person-bearbeiten-Datenfeld-GEDCOM-Rohdaten.png|Datenfeld
</gallery>

<div style="display:flow-root; padding-right:5px;">
{{Wichtig|Beim Bearbeiten der GEDCOM Rohdaten können Sie die üblichen Bearbeitungsformulare umgehen und die zugrunde liegenden Daten direkt bearbeiten. Hierbei handelt es sich um eine erweiterte Option, die Sie nicht verwenden sollten, ohne das GEDCOM-Format vollständig verstanden zu haben (Details siehe [https://webtrees.net/downloads/gedcom-5-5-1.pdf GEDCOM-Standard 5.5.1] und den Abschnitt [[Webtrees_Handbuch/Nutzungserfahrungen#Arbeiten_auf_der_GEDCOM-Ebene|Arbeiten auf der GEDCOM-Ebene]]). Hier begangene Fehler können nur sehr schwer identifiziert und behoben werden.<ref>Eventuell kann ein Verwalter noch mit den Funktionen der [[Webtrees_Handbuch/Anleitung_für_Verwalter#Fehlersuche|Fehlersuche]] etwas retten.</ref>}}Einschränkungen bzgl. der sichtbaren Datenfelder kann es geben, wenn der Verwalter für den betreffenden Stammbaum [[Webtrees_Handbuch/Anleitung_für_Verwalter#Datenschutz|Datenschutz-Regeln]] definiert hat.
</div>

== Suchen-Menü ==
[[Datei:WT_2.1_Menue-Suchen-Bearbeiter.png|thumb|left|100px|Suchmenü-Eintrag]]
[[Datei:WT_2.1_Suchen-und-Ersetzen-Bearbeiter.png|thumb|right|300px|'Suchen und Ersetzen' Formular]]
Ab der Bearbeiter-Rolle enthält das [[Webtrees_Handbuch/Anleitung_für_Besucher#Suchen|Suchen-Menü]] als weiteren Eintrag "Suchen und Ersetzen". Dies hat nichts mit der gleichnamigen Funktion bei den [[Webtrees_Handbuch/Anleitung_für_Verwalter#Datenkorrekturen|Datenkorrekturen]] zu tun und ist auch nicht so mächtig. Es handelt sich um eine Suche ohne Berücksichtigung von Groß- und Kleinschreibung. Als Suchoptionen stehen zur Verfügung ganzer Datensatz, Namen oder Orte.
{{-}}

{{Wichtig|Bei der Nutzung ist Vorsicht geboten, da es keine Vorschaufunktion gibt. Am besten sollte die Ausführung mit einem Nutzerkonto geschehen, dessen Änderungen durch die [[Webtrees_Handbuch/Anleitung_für_Moderatoren|Moderatoren-Freigabeprüfung]] müssen. Beim Absenden des Formulars wird die Änderung direkt durchgeführt und nur mit der Anzeige der Aktualisierungsanzahl quittiert.}}
{{-}}

== Personen-Datensätze ==
Gewünschte Personen können über die [[Webtrees_Handbuch/Anleitung_für_Besucher#Listen|Personen-Liste]] oder die [[Webtrees_Handbuch/Anleitung_für_Besucher#Suchfeld|Suche]] gefunden und ausgewählt werden.

Die Bearbeitung vorhandener Personen-Datensätze ([[GEDCOM/INDI-Tag|INDI]]) erfolgt auf der [[Webtrees_Handbuch/Anleitung_für_Besucher#Personenseite_mit_Reitern_und_Navigationsleiste|Personenseite]] über die nachfolgend aufgeführten Wege:
<div style="float: right;">
<gallery perrow=2 widths="150">
Datei:WT_2.1_Person-bearbeiten-Kontextmenue.png|Person bearbeiten Kontextmenü
Datei:WT_2.1_Familie-neu-ordnen.png|Familien neu ordnen
</gallery>
</div>
# Kontextmenü
#* Teilen: das Datum eines Ereignisses im Leben der Person kann als Kalendereintrag heruntergeladen werden und die Webadresse der Personenseite kann in die Zwischenablage kopiert werden.
#* [[Webtrees_Handbuch/Genealogischer_Prozess#Namen|Namen]] hinzufügen und ordnen: eine Person kann mehrere Namen tragen; diese können hier hinzugefügt und sortiert werden (der erstgenannte Name ist der bevorzugt angezeigte Name).
#* Geschlecht ändern: das Geschlecht einer Person kann hier geändert werden (männlich, weiblich, unbekannt, sonstige); eine Person kann aber nur ein Geschlecht haben, das hier genannte Geschlecht ist das Geschlecht bei der Geburt (spätere Geschlechtsänderungen müssen als Ereignis dokumentiert werden).
#* Familien neu ordnen<ref>siehe Abschnitt [[Webtrees_Handbuch/Anleitung_für_Webmaster/Anleitung_Upgrade_20#.22Primäre.22_Eltern|"Primäre" Eltern]].</ref>: die Reihenfolge der Partnerschaften einer Person sollte chronologisch sortiert sein.
#* Medienobjekt hinzufügen und neu ordnen: der Person können mehrere Medienobjekte zugeordnet werden; die erste Mediendatei im zuerst genannten Medienobjet wird bevorzugt zur Anzeige als persönliches Bild der Person verwendet.
#* Löschen der Person: die Person kann aus dem Stammbaum entfernt werden; Verweise auf die Person werden konsistent überall gelöscht.
#* GEDCOM Rohdaten bearbeiten (kompletter Datensatz): die Angaben zum INDI-Datensatz werden auf der GEDCOM-Ebene zur Bearbeitung geöffnet.
# Reiter "[[Webtrees_Handbuch/Anleitung_für_Besucher#Tatsachen_und_Ereignisse|Tatsachen und Ereignisse]]"
#* Icons Bearbeiten, Kopieren und Löschen bei vorhandenen Tatsachen-Feldern [[Datei:WT_2.1_Icons-Bearbeiten-Kopieren-Loeschen.png|100px|link=|alt=Icons Bearbeiten / Kopieren / Löschen]]
#* Am unteren Ende der Auflistung Kurzliste<ref>Die Konfiguration der Kurzliste erfolgt durch den Verwalter in den [[Webtrees_Handbuch/Anleitung_für_Verwalter#Einstellungen|Stammbaum-Einstellungen]] im Abschnitt "Personenereignisse".</ref> und Auswahlbox für noch mehr Felder [[Datei:WT_2.1_Personenseite-Reiter-Tatsachen+Ereignisse-hinzufügen.png|400px|link=|alt=Eine Tatsache hinzufügen - Kurzliste und Auswahlliste]]
# Reiter "[[Webtrees_Handbuch/Anleitung_für_Besucher#Familien|Familien]]" Hier ist das Hinzufügen von weiteren Personen-Datensätzen über Verknüpfung mit existierenden Datensätzen möglich.[[Datei:WT_2.1_Ein-Kind-hinzufuegen.png|Ein Kind hinzufügen|thumb|right|150px|Ein Kind hinzufügen]] [[Webtrees_Handbuch/Anleitung_für_Verwalter#Nicht_verkn.C3.BCpfte_Datens.C3.A4tze_hinzuf.C3.BCgen|Nicht verknüpfte Datensätze]] können durch den Verwalter im Verwaltungs-Backend erstellt werden.
# Reiter "[[Webtrees_Handbuch/Anleitung_für_Besucher#Quellen|Quellen]]" Link "Ein Quellenzitat hinzufügen" am Ende der Auflistung (betrifft Zitate zum gesamten Personen-Datensatz; siehe auch Abschnitt zu [[#Quellen-Datensätze|Quellen-Datensätzen]] weiter unten)
# Reiter "[[Webtrees_Handbuch/Anleitung_für_Besucher#Notizen|Notizen]]" Link "Eine Notiz hinzufügen" am Ende der Auflistung (betrifft Inline und Gemeinsame Notizen zum gesamten Personen-Datensatz; siehe auch Abschnitt zu [[#Notizen-Datensätze|Notizen-Datensätzen]] weiter unten)
# Reiter "[[Webtrees_Handbuch/Anleitung_für_Besucher#Geschichten|Geschichten]]" Link "Eine Geschichte hinzufügen" am Ende der Auflistung

Nachfolgender Screenshot zeigt beispielhaft ein aktuelles Formular für die Tatsache "Geburt" in der Standardansicht; über den Link gelangt man zum gleichen Formular mit allen verfügbaren Kennzeichen:
[[Datei:WT_2.1_Person-bearbeiten-Geburt.png|thumb|left|250px|Formular zur Bearbeitung des Datenfelds Geburt ([https://wiki.genealogy.net/images/8/8f/WT_2.1_Person-bearbeiten-Geburt-alle-Kennzeichen.png mit allen Kennzeichen]) ]]
{{-}}

Weitere Details zu den auf der Personenseite erstellbaren anderen Datensätzen (Familien mit weiteren Personen-Datensätze, Gemeinsame Notizen und Quellen) werden in den nachfolgenden Abschnitten erläutert.
{{-}}

== Familien-Datensätze ==
[[Datei:WT_2.1_Personenseite-Reiter-Familien-bearbeiten.png|thumb|right|250px|Reiter 'Familien' auf der Personenseite]]
Wie bereits im vorhergehenden Abschnitt angedeutet, kann auf der [[Webtrees_Handbuch/Anleitung_f%C3%BCr_Besucher#Personenseite_mit_Reitern_und_Navigationsleiste|Personenseite]] über den '''Reiter "[[Webtrees_Handbuch/Anleitung_für_Besucher#Familien|Familien]]"''' der Familien-Datensatz ([[GEDCOM/FAM-Tag|FAM]]) bearbeitet werden. 
Folgende Aktionen stehen zur Verfügung, um die [[Webtrees_Handbuch/Genealogischer_Prozess#Personen.2C_Familien_und_ihre_Beziehungen|familiären Beziehungen]] zu gestalten
* Eine/n Mutter/Vater hinzufügen
* Diese Person als Kind mit einer existierenden Familie verknüpfen
* Eine/n Ehefrau/Ehemann hinzufügen
* Eine existierende Person als Ehefrau/Ehemann hinzufügen
* Ein Kind hinzufügen, um gleichzeitig eine Familie mit nur einem Elternteil zu erstellen
* Bei erstellten Familien
** Ehedetails hinzufügen
** Eltern: Ein/e/n Geschwisterkind/Schwester/Bruder hinzufügen; Kinder neu ordnen
** andere Familien: Ein/e/n Kind/Tochter/Sohn hinzufügen; Kinder neu ordnen

<gallery perrow=2 widths="250">
Datei:WT_2.1_Person-mit-Familie-verknuepfen.png|Diese Person als Kind mit einer existierenden Familie verknüpfen
Datei:WT_2.1_Existierende-Person-Ehepartner-hinzufuegen.png|Eine existierende Person als Ehepartner hinzufügen
</gallery>

{{-}}

[[Datei:WT_2.1_Titel-Familie-mit.png|112px|link=|alt=Titel 'Familie mit...']] Über den Titel "Familie mit..." kann die korrespondierende '''Familienseite''' geöffnet werden:
[[Datei:WT_2.1_Familienseite-bearbeiten.png|thumb|left|250px|Familienseite]]
{{-}}

Auf der Familienseite werden folgende Funktionen bereitgestellt:
# Kontextmenü [[Datei:WT_2.1_Familienseite-bearbeiten-Kontextmenü.png|thumb|right|150px|Familie bearbeiten Kontextmenü]]
#* Familienmitglieder ändern
#* Ein Kind hinzufügen und Kinder neu ordnen
#* Medienobjekt hinzufügen
#* Löschen der Familie
#* GEDCOM Rohdaten bearbeiten (Familien-Datensatz)
# Links in der [[Webtrees_Handbuch/Anleitung_für_Besucher#Diagramme|Sanduhrdiagramm-ähnlichen]] Darstellung der Familie mit Kindern und Eltern der Eheleute
#* Eine/n Mutter/Vater hinzufügen
#* Ein/e/n Kind/Tochter/Sohn hinzufügen
#* Kinder neu ordnen
# Ergänzen von Tatsachen und Ereignissen zur Familie über eine Auswahl- und Kurzliste am Ende der Seite [[Datei:WT_2.1_Familienseite-Tatsachen+Ereignisse-hinzufügen.png|400px|link=|alt=Eine Tatsache hinzufügen - Kurzliste und Auswahlliste]]

<gallery perrow=2 widths="250">
Datei:WT_2.1_Familienseite-bearbeiten-Familienmitglieder-aendern.png|Familienmitglieder ändern
Datei:WT_2.1_Familienseite-bearbeiten-Kinder-neu-ordnen.png|Kinder neu ordnen
</gallery>

Ein Paar gilt in webtrees standardmäßig als nicht verheiratet, es sei denn, es liegt ein Ehe-Ereignis vor.<ref>siehe Abschnitt "[[Webtrees_Handbuch/Anleitung_für_Webmaster/Anleitung_Upgrade_20#Status_einer_Ehe|Status einer Ehe]]".</ref>

Gewünschte Familien können über die [[Webtrees_Handbuch/Anleitung_für_Besucher#Listen|Familien-Liste]] oder die [[Webtrees_Handbuch/Anleitung_für_Besucher#Suchfeld|Suche]] gezielt gefunden und ausgewählt werden.

== Quellen-Datensätze ==
Das "Ursprungsmaterial, aus dem die Informationen stammen" werden als Quellen-Datensätze ([[GEDCOM/SOUR-Tag|GEDCOM-Kennzeichen SOUR]]) erfasst.

Die Quellen werden über die Verknüpfung mit anderen Datensätzen (wie Personen, Familien etc.) mittels Quellenzitaten in Beziehung gesetzt und, sofern noch nicht vorhanden, erstellt. Dies geschieht im Bearbeitungsdialog des jeweiligen Kennzeichens.

<gallery perrow=2 widths="250">
Datei:WT_2.1_Quellenzitat-bearbeiten.png|Quellenzitat bearbeiten (Formularausschnitt)
Datei:WT_2.1_Quelle-erstellen.png|Quelle erstellen
</gallery>

Die [[Webtrees_Handbuch/Anleitung_für_Besucher#Listen|Quellen-Liste]] und die [[Webtrees_Handbuch/Anleitung_für_Besucher#Suchen|Allgemeine Suche]] (mit aktivierter Option "Quellen") helfen beim Auffinden der Quellen-Datensätze.

<gallery perrow=2 widths="250">
Datei:WT_2.1_Listen-Quellen.png|Quellen-Liste
Datei:WT_2.1_Quellenseite-Details-bearbeiten.png|Quellenseite - Reiter 'Details' (Bearbeitungsansicht)
</gallery>

Eine im GEDCOM-Kennzeichen "Veröffentlichung" ([[GEDCOM-Tags|GEDCOM-Kennzeichen PUBL]]) eingetragene URL<ref>{{wikipedia-Link|Uniform_Resource_Locator}}</ref>, wird bei der Anzeige als anklickbarer Verweis dargestellt.

== Archive-Datensätze ==
Als Archiv ([[GEDCOM-Tags|GEDCOM-Kennzeichen REPO]]) wird eine "Einrichtung oder Person, die das betroffene Objekt in ihrer Sammlung hat" verstanden. Archive sind lediglich mit Quellendatensätzen verknüpft.

Zum Auffinden der gewünschten Datensätze dienen die [[Webtrees_Handbuch/Anleitung_für_Besucher#Listen|Archive-Liste]] oder die [[Webtrees_Handbuch/Anleitung_für_Besucher#Suchen|Allgemeine Suche]] (mit aktivierter Option "Archive").

<gallery perrow=2 widths="250">
Datei:WT_2.1_Listen-Archive.png|Archive-Liste
Datei:WT_2.1_Archiveseite-Details-bearbeiten.png|Archiveseite - Reiter 'Details' (Bearbeitungsansicht)
</gallery>

Bei der Erstellung eines Quellen-Datensatzes lassen sich leider nur vorhandene Archive-Datensätze verknüpfen. Neue Archive-Datensätze können über die Quellenseite erzeugt werden durch Klicken auf den Plus-Button am Datenfeld "Archiv" beim Bearbeiten der Archiv-Verknüpfung.
<gallery perrow=2 widths="250">
Datei:WT_2.1_Archiv-verknuepfen.png|Archiv-Verknüpfung bearbeiten
Datei:WT_2.1_Archiv-erstellen.png|Formular zur Erstellung des Archive-Datensatzes
</gallery>

== Notizen-Datensätze ==
Bei Notizen ([[GEDCOM/NOTE-Tag|GEDCOM-Kennzeichen NOTE]]) gibt es die Inline-Variante innerhalb eines anderen Datenfelds/Kennzeichens oder den eigenständigen Datensatz (Gemeinsame Notiz).

Sollen '''Gemeinsame Notizen''' zielgerichtet gefunden werden, sind die [[Webtrees_Handbuch/Anleitung_für_Besucher#Listen|Notizen-Liste]] oder die [[Webtrees_Handbuch/Anleitung_für_Besucher#Suchen|Allgemeine Suche]] (mit aktivierter Option "Gemeinsame Notizen") die Mittel der Wahl.
<gallery perrow=3 widths="250">
Datei:WT_2.1_Listen-Notizen.png|Liste Gemeinsame Notizen
Datei:WT_2.1_Notizenseite-Details-bearbeiten.png|Notizenseite - Reiter 'Detail' (Bearbeitungsansicht)
Datei:WT_2.1_Notizenseite-bearbeiten.png|Notizenseite - Bearbeitungsformular einer Gemeinsamen Notiz
</gallery>

Der Personen- oder Familien-Datensatz, der gewünschte '''Inline-Notizen''' enthält, lässt sich auch ganz einfach über das [[Webtrees_Handbuch/Anleitung_für_Besucher#Suchfeld|Suchfeld]] finden. Danach kann man die Stelle im Datensatz recht gut auf dem Reiter "[[Webtrees_Handbuch/Anleitung_für_Besucher#Notizen|Notizen]]" mit aktivierter Option "Alle Notizen zeigen" ermitteln. Sollen Inline-Notizen in Quellen-, Archiv- oder Orts-Datensätzen aufgefunden werden, sollte wiederum die "Allgemeine Suche" bemüht werden.

Zum Erstellen von Notizen stehen folgende Funktionen zur Verfügung:
[[Datei:WT_2.1_Eine-Notiz-hinzufuegen.png|thumb|right|250px|Eine Notiz hinzufügen (Formular)]]
* Personenseite / Reiter "[[Webtrees_Handbuch/Anleitung_für_Besucher#Notizen|Notizen]]" Link "Eine Notiz hinzufügen" am Ende der Auflistung (betrifft Inline und Gemeinsame Notizen zum gesamten Personen-Datensatz)
* Beim Bearbeiten von Kennzeichen (bspw. auf der Personenseite / Reiter "[[Webtrees_Handbuch/Anleitung_für_Besucher#Tatsachen_und_Ereignisse|Tatsachen und Ereignisse]]" und "[[Webtrees_Handbuch/Anleitung_für_Besucher#Quellen|Quellen]]", aber auch auf den Seiten der anderen Datensätze): [[Datei:WT_2.1_Personenseite-Reiter-Notizen-bearbeiten-Ausschnitt.png|350px|link=|alt=Bearbeitungsformular eines Kennzeichens - zwei Notizen-Datenfelder (Ausschnitt)]]
* Das Notizfeld hat in der rechten unteren Ecke einen "Anfasser", der es erlaubt das Feld mit der Maus in der Größe zu ändern, so dass man auch längere Texte übersichtlich eingeben kann.
* Am unteren Ende einer Kennzeichen-Auflistungen besteht die Möglichkeit die Notiz je nach Konfiguration aus der Kurzliste bzw. Auswahlbox auszuwählen [[Datei:WT_2.1_Personenseite-Reiter-Tatsachen+Ereignisse-hinzufügen.png|350px|link=|alt=Eine Tatsache hinzufügen - Kurzliste und Auswahlliste]]

Die Erfassung einer Notiz erfolgt als einfacher Text, webtrees erlaubt auch die Interpretation von [[Webtrees_Handbuch/Anleitung_für_Verwalter#Markdown|Markdown]], sofern dies konfiguriert wurde.{{-}}

== Medien-Datensätze ==
Medien-Datensätze ([[GEDCOM/OBJE-Tag|GEDCOM-Kennzeichen OBJE]]) enthalten Verweise auf Daten wie Bild-, Audio- und Video-Daten (z.B. Fotos, eingescannte Dokumente, Interviews mit Familienmitgliedern). Zu einem Medien-Datensatz gehört ein Titel, der den Inhalt beschreiben sollte. Man kann nach diesem Titel suchen.

Lediglich über die [[Webtrees_Handbuch/Anleitung_für_Besucher#Listen|Medienobjekte-Liste]] (Multimedia) lassen sich die gewünschten Dateien und Datensätze auffinden. Über die Medienseite kann der Datensatz bearbeitet und um weitere Mediendateien ergänzt werden.

{{WT-ToDo|Noch beschreiben: Wie organisiert man am besten Mediendateien in Ordnern? Wie benennt man Mediendateien? Welche Medienformate werden unterstützt? Wie groß dürfen Mediendateien sein? Was ist bezüglich der Bildrechte zu beachten? Welche Medieninhalte sind eventuell nicht geeignet (nackte Kinder, Nazi-Symbole, ...)?}}

Medienobjekte können mehrere Mediendateien enthalten. Wenn Sie zum Beispiel beide Seiten eines Dokuments scannen, können Sie diese zusammen in einem Medienobjekt speichern. Eine andere Anwendung für mehrere Mediendateien in einem Medienobjekt ist etwa eine Audioaufzeichnung eines Gesprächs und die in Text transkribierte Form dieses Interviews. Wenn man ein Originalfoto und die nachbearbeitete Version davon zusammen halten möchte, dann kann man beide Fotos in einem Medienobjekt ablegen.

webtrees verwendet die erste Mediendatei in einem Medienobjekt, die ein Bild enthält, als Vorschaubild. Wenn Ihr Medienobjekt also ein Video und ein Bild enthält, wird das Bild als Vorschaubild verwendet.<ref>Übersetzung des Abschnitts "Media objects can now contain many media files" von der Seite https://webtrees.net/upgrade/2.0/.</ref>

<gallery perrow=2 widths="250">
Datei:WT_2.1_Listen-Medienobjekte.png|Medienobjekte-Liste (Multimedia)
Datei:WT_2.1_Medienseite-Details-bearbeiten.png|Medienseite - Reiter 'Details' (Bearbeitungsansicht)
Datei:WT_2.1_Mediendatei-hinzufuegen.png|Mediendatei hinzufügen
Datei:WT_2.1_Medienobjekt-verknuepfen-Person.png|Medienobjekt verknüpfen mit einer Person
</gallery>

Medienobjekte können mit Personen, Familien, Quellen oder Notizen verknüpft werden. Außer bei den Notizen ist dies ausgehend sowohl vom Medienobjekt als auch dem zu verknüpfenden Datensatz möglich, die Beziehung zur Notiz wird am Medien-Datensatz als "Gemeinsame Notiz" hinterlegt. Auf der Medienseite im Reiter "Notizen" werden Beziehungen zwischen Medienobjekt und "Gemeinsamer Notiz" aufgeführt, die indirekt über ein Quellenzitat (mit Verknüpfung zu eben diesem Medienobjekt) an der Notiz bestehen.

Die Erstellung der Medienobjekte ist ebenfalls nur bei der Bearbeitung der Medien-Verknüpfung an den Personen-, Familien- und Quellen-Datensätzen möglich: Dazu muss lediglich auf die Schaltfläche mit dem Plus-Zeichen am Medienobjekt-Datenfeld geklickt werden.

<gallery perrow=2 widths="250">
Datei:WT_2.1_Personenseite-Reiter-Multimedia-bearbeiten.png|Personenseite - Reiter 'Multimedia' (Bearbeitungsansicht)
Datei:WT_2.1_Person-Medienobjekt-bearbeiten.png|Personenseite - Medienobjektverknüpfung bearbeiten bzw. hinzufügen
</gallery>

=== Primäres Foto ===
webtrees kann nur ein Bild für eine Person auswählen, um es in Diagrammen usw. zu verwenden.<ref>Übersetzung des Abschnitts "Primary photo" von der Seite https://webtrees.net/upgrade/2.0/.</ref>

In webtrees 1.7 wurde das ausgewählte Bild mithilfe des benutzerdefinierten GEDCOM-Kennzeichens [[GEDCOM/_PRIM-Tag|_PRIM]] und anderer Logik festgelegt. Im Verwaltungsmenü gibt es eine [[Webtrees Handbuch/Anleitung für Administratoren/Module#Datenkorrekturen|Datenkorrektur]]-Option, die die Medienverknüpfungen entsprechend der Priorisierung durch das [[GEDCOM/_PRIM-Tag|_PRIM-Kennzeichen]] sortiert. Denn seit webtrees 2.0 wird das erste Medienobjekt im GEDCOM-Datensatz verwendet, das ein anzeigbares Bild enthält. Wenn dieses Medienobjekt mehrere Bilder enthält, wird davon das erste verwendet. Es gibt Bearbeitungsoptionen zur Umsortierung der Medienobjekte und der Mediendateien in einem Medienobjekt.

Gelegentlich kommt es vor, dass Bilder mit einer Person verknüpft werden, obwohl sie eigentlich mit einem Fakt oder Ereignis verknüpft sein sollten. Zum Beispiel sollte eine Geburtsurkunde mit dem Ereignis der Geburt verknüpft werden, nicht mit der Person. Dies kann dazu führen, dass ein solches ungeeignetes Bild als "Primärbild" ausgewählt wird. Das Bedienfeld bietet eine Option, mit der diese Bilder einfach von Personen zu Fakten bzw. Ereignissen verschoben werden können.

Anmerkung: In webtrees 2 kann immer noch die Tatsache "Hervorgehobenes Bild" hinzugefügt werden. Man sollte jedoch besser das primäre Bild wie hier beschrieben über die Reihenfolge steuern.

=== Benutzerdefinierte Miniaturansichten ===
In webtrees 1.7 konnte eine benutzerdefinierte Miniaturansicht bzw. ein Vorschaubild (sogenannte "Thumbnails") für ein Medienobjekt erstellt werden. Dabei kann es sich um ein Standbild aus einem Video oder um eine beschnittene Version eines Gruppenfotos handeln.<ref>Übersetzung des Abschnitts "Custom thumbnails" von der Seite https://webtrees.net/upgrade/2.0/.</ref> Auf dem Server wurde hierfür eine Datei erstellt, die das Standard-Thumbnail ersetzte. (Hinweis: Diese Funktion wurde zwar nie offiziell unterstützt, jedoch vielfach genutzt).

Seit webtrees 2.0 werden benutzerdefinierte Miniaturansichten erstellt, indem eine zweite Mediendatei zu einem Medienobjekt hinzugefügt wird.

Für den Administrator gibt es eine [[Webtrees_Handbuch/Anleitung_für_Administratoren/Multimedia#Benutzerdefinierte_Vorschaubilder_aus_webtrees_1_importieren|Verwaltungsfunktion]], mit der benutzerdefinierte Miniaturansichten gefunden und importiert werden können.

== Datumsangaben ==
Datumsangaben kommen in vielen unterschiedlichen Ereignisfeldern vor. Sie werden intern im GEDCOM-Format mit englischen Abkürzungen gespeichert. Als Alternative zu den Abkürzungen können bei der Eingabe auch Tastenkürzel genutzt werden.

Datumsangaben können einen definierten Zeitpunkt beschreiben, etwa den Zeitpunkt der Geburt, oder einen Zeitraum, etwa die Zeitdauer in der eine Person an einem Ort wohnte. Zeitpunkte können auf einen Tag genau definiert werden, sie können aber auch unscharf angegeben werden, etwa auf einen Monat oder ein Jahr genau. Das gilt auch für die beiden Zeitpunkte, die einen Zeitraum definieren.

Die Angabe "2022" etwa beschreibt einen exakten, aber nicht genau bekannten Zeitpunkt, der irgendwann im Jahr 2022 liegt, also einen Tag zwischen dem 1. Januar 2022 und dem 31. Dezember 2022. Die Angabe "von 1900 bis zum 1.02.1905" beschreibt einen Zeitraum, der irgendwann an einem Tag im Jahr 1900 begonnen hat und genau am 1. Februar 1905 endete.

Zeitangaben ohne eine Jahresangabe sind nicht möglich. Wenn etwa ein Geburtstag (etwa 1. Mai) bekannt ist, aber nicht das Geburtsjahr, kann die Angabe nur als interpretierter Wert erfolgen, etwa in der Form <code>INT 1 MAY (year unknown)</code>.

An verschiedenen Orten und zu verschiedenen Zeiten gelten und galten auch verschiedene Kalendersysteme, von denen einige von webtrees unterstützt werden (siehe dazu unten mehr). In einigen Kalendern beginnen die Tage um Mitternacht, in anderen beginnen sie mit Sonnenuntergang. Daher weicht bei allen zwischen Sonnenuntergang und Mitternacht erfolgten Ereignissen das Ereignisdatum ggf. um einen Tag ab. Eine Datumserfassung sollte immer in dem Kalender erfolgen, der zum relevanten Zeitpunkt am relevanten Ort gültig war.

=== Zeitpunkte ===
Im Folgenden werden einige Beispiele zur Angabe von Zeitpunkten gegeben. Die Eingabe erfolgt in der Form, wie sie in der Spalte "internes Format" oder in der Spalte "Tastenkürzel" angegeben ist.
{| class="wikitable"
|+ Datumsangaben - Zeitpunkte
!Zeitpunkt
!internes Format
!Tastenkürzel
|-
|1900
|1900
|
|-
|Januar 1900
|JAN 1900
|
|-
|Februar 1900
|FEB 1900
|
|-
|März 1900
|MAR 1900
|
|-
|April 1900
|APR 1900
|
|-
|Mai 1900
|MAY 1900
|
|-
|Juni 1900
|JUN 1900
|
|-
|Juli 1900
|JUL 1900
|
|-
|August 1900
|AUG 1900
|
|-
|September 1900
|SEP 1900
|
|-
|Oktober 1900
|OCT 1900
|
|-
|November 1900
|NOV 1900
|
|-
|Dezember 1900
|DEC 1900
|
|-
|um 1900
|ABT 1900
|~1900
|-
|geschätzt 1900
|EST 1900
|*1900
|-
|berechnet 1900
|CAL 1900
|#1900
|-
|Ostern 1900
|INT 15 APR 1900 (Ostern 1900)
|
|-
|11. Dezember 1913
|11 DEC 1913
|11.12.1913
11-12-1913

11/12/1913
|-
|1. Februar 2003
|01 FEB 2003
|01.02.03
01-02-03

01/02/03
|}
Die Genauigkeit ist aus der Art der Angabe abzuleiten. Wenn nur ein Jahr genannt wird, dann bedeutet das, dass das Ereignis an einen unbekannten Tag im angegebenen Jahr stattfand. Entsprechend ist die Angabe "JAN 1900" so zu interpretieren, dass sich das Ereignis an einem Tag zwischen dem 1. und dem 31. Januar 1900 ereignete.

Die Angabe "um" bedeutet, dass es sich um eine ungefähre Angabe handelt. Ein Ereignis, das "um 1900" stattfand, kann also auch 1898 oder 1903 stattgefunden haben. Entsprechend bedeutet "um 24.12.1900", dass dieses Ereignis ein paar Tage vor oder nach Weihnachten 1900 herum stattgefunden hat.

Wenn etwa in einer Quelle genannt wird, dass die Person "am 1. Juli 1960 im Alter von 60 Jahren" verstorben ist, dann kann man daraus das Geburtsjahr berechnen: 1900. Das Geburtsdatum gibt man in diesem Fall mit "berechnet 1900" an. Allerdings kann die Person auch 1899 oder 1901 geboren sein, je nach dem konkreten Geburtstag im Jahr und der Art wie lokal Lebensjahre gezählt worden sind.

Wenn man ein Hochzeitsdatum kennt, etwa den 1.6.1922, aber das Geburtsdatum der Ehefrau unbekannt ist, dann kann man dieses schätzen, da Frauen zur fraglichen Zeit etwa meist im Alter zwischen 20 und 25 Jahren geheiratet haben. Man kann also beim Geburtsdatum angeben "geschätzt 1900". Das tatsächliche Geburtsdatum kann aber dann durchaus ein paar Jahre früher oder später gewesen sein. Auch hier gilt, dass die Genauigkeit der Datumsangabe entscheidend ist: eine Angabe "geschätzt 15.4.1900" würde bedeuten, dass das Ereignis auf Grund einer Annahme und einem konkreten Datum ermittelt worden ist und der fragliche Zeitraum ein paar Tage vor und nach diesem Datum umfasst.

=== Zeitpunkt in einer Zeitspanne ===
Eine Zeitspanne wird benutzt, um anzuzeigen, dass ein Ereignis, wie eine Geburt, an einem nicht genau bekannten Datum innerhalb eines Zeitraums stattfand. Die Eingabe erfolgt in der Form, wie sie in der Spalte "internes Format" oder in der Spalte "Tastenkürzel" angegeben ist.
{| class="wikitable"
|+ Datumsangaben - Zeitpunkte in Zeitspannen
!Zeitspanne
!internes Format
!Tastenkürzel
|-
|zwischen 1900 und 1910
|BET 1900 AND 1910
|1900-1910
|-
|nach 1900
|AFT 1900
|>1900
|-
|vor 1910
|BEF 1910
|<1910
|-
|zwischen Januar 1900 und März 1900
|BET JAN 1900 AND MAR 1900
|Q1 1900
|-
|zwischen April 1900 und Juni 1900
|BET APR 1900 AND JUN 1900
|Q2 1900
|-
|zwischen Juli 1900 und September 1900
|BET JUL 1900 AND SEP 1900
|Q3 1900
|-
|zwischen Oktober 1900 und Dezember 1900
|BET OCT 1900 AND DEC 1900
|Q4 1900
|}
Die angegebenen Grenzen gehören dabei jeweils dazu, d.h. "nach 1900" ist so zu interpretieren, dass das Ereignis im Jahr 1900 oder einem späteren Jahr stattgefunden hat. Dies steht im Widerspruch zum verwendeten Tastenkürzel ">1900", es müsste eigentlich "≥1900" heißen. Das gleiche gilt entsprechend für die Angabe "vor".

=== Zeitraum ===
Ein Zeitraum wird benutzt, um anzuzeigen, dass etwa eine Beschäftigung, über einen definierten Zeitraum hin andauerte. Die angegebenen Grenzen gehören zum Zeitraum dazu. Die Eingabe erfolgt in der Form, wie sie in der Spalte "internes Format" oder in der Spalte "Tastenkürzel" angegeben ist.
{| class="wikitable"
|+ Datumsangaben - Zeiträume
!Zeitraum
!internes Format
!Tastenkürzel
|-
|ab 1900 bis 1910
|FROM 1900 TO 1910
|1900~1910
|-
|ab 1900
|FROM 1900
|1900-
|-
|bis 1910
|TO 1910
| -1910
|}

=== Kalendersysteme ===
webtrees unterstützt neben den im GEDCOM-Standard aufgeführten Kalendern (julianischer, gregorianischer, jüdischer Kalender und Französischer Revolutionskalender) auch noch den Jalali-Kalender und den islamischen Kalender.

Eine Dateneigabe eines einfachen Datums wird grundsätzlich als gregorianisches Datum interpretiert. Um ein spezifisches Datum in einem anderen Kalender einzugeben, ist das entsprechende Schlüsselwort vor dem Datum einzugeben. Dies kann entfallen, wenn das Datum durch das Format von Monat und Jahr eindeutig ist. Die Schlüsselwörter sind

* gregorianisches Datum: @#DGREGORIAN@ (dies ist der Standard und muss deshalb nicht genannt werden)
* julianisches Datum: @#DJULIAN@
* jüdisches Datum: @#DHEBREW@
* islamisches Datum: @#DHIJRI@
* Jalali-Datum: @#DJALALI@
* Datum nach dem französischen Revolutionskalender: @#DFRENCH R@

<div id="calsys" class="stickytablewrapperh">
{| class="wikitable"
|+ Datumsangaben - Kalendersysteme
!Datum
!internes Format
|-
| colspan="2" style="background-color:#fdf9dd; font-weight:bold; font-style:italic; padding-left:5em;" |Julianisch
|-
|14. Januar 1700 n. Chr.
|@#DJULIAN@ 14 JAN 1700
|-
|44 v. Chr.
|@#DJULIAN@ 44 B.C.
|-
|20. Februar 1742/43 n. Chr.
|@#DJULIAN@ 20 FEB 1742/43
|-
|zwischen 1. September 1752 n. Chr. und 30. September 1752
|BET @#DJULIAN@ 01 SEP 1752 AND @#DGREGORIAN@ 30 SEP 1752
|-
| colspan="2" style="background-color:#fdf9dd; font-weight:bold; font-style:italic; padding-left:5em;" |Jüdisch
|-
|5481
|@#DHEBREW@ 5481
|-
|Tischri 5481
|@#DHEBREW@ TSH 5481
|-
|um Cheschwan 5481
|ABT @#DHEBREW@ CSH 5481
|-
|zwischen Kislew 5481 und Tewet 5481
|BET @#DHEBREW@ KSL 5481 AND @#DHEBREW@ TVT 5481
|-
|ab Schwat 5481 bis Adar 5481
|FROM @#DHEBREW@ SHV 5481 TO @#DHEBREW@ ADR 5481
|-
|nach Adar 5481
|AFT @#DHEBREW@ ADR 5481
|-
|nach Adar II 5480
|AFT @#DHEBREW@ ADS 5480
|-
|vor Nisan 5481
|BEF @#DHEBREW@ NSN 5481
|-
|um Ijar 5481
|ABT @#DHEBREW@ IYR 5481
|-
|ab Siwan 5481
|FROM @#DHEBREW@ SVN 5481
|-
|bis Tammus 5481
|TO @#DHEBREW@ TMZ 5481
|-
|geschätzt Aw 5481
|EST @#DHEBREW@ AAV 5481
|-
|3. Elul 5481
|@#DHEBREW@ 03 ELL 5481
|-
| colspan="2" style="background-color:#fdf9dd; font-weight:bold; font-style:italic; padding-left:5em;" |Islam
|-
|1497
|@#DHIJRI@ 1497
|-
|Muharram 1497
|@#DHIJRI@ MUHAR 1497
|-
|um Safar 1497
|ABT @#DHIJRI@ SAFAR 1497
|-
|zwischen Rabi’ al-awwal 1497 und Rabi’ al-thani 1497
|BET @#DHIJRI@ RABIA 1497 AND @#DHIJRI@ RABIT 1497
|-
|ab Jumada al-awwal 1497 bis Jumada al-thani 1497
|FROM @#DHIJRI@ JUMAA 1497 TO @#DHIJRI@ JUMAT 1497
|-
|nach Rajab 1497
|AFT @#DHIJRI@ RAJAB 1497
|-
|vor Sha’aban 1497
|BEF @#DHIJRI@ SHAAB 1497
|-
|um Ramadan 1497
|ABT @#DHIJRI@ RAMAD 1497
|-
|ab Shawwal 1497
|FROM @#DHIJRI@ SHAWW 1497
|-
|bis Dhu al-Qi'dah 1497
|TO @#DHIJRI@ DHUAQ 1497
|-
|3. Dhu al-Hijjah 1497
|@#DHIJRI@ 03 DHUAH 1497
|-
| colspan="2" style="background-color:#fdf9dd; font-weight:bold; font-style:italic; padding-left:5em;" |Jalali
|-
|1497
|@#DJALALI@ 1497
|-
|Farvardin 1497
|@#DJALALI@ FARVA 1497
|-
|um Ordibehesht 1497
|ABT @#DJALALI@ ORDIB 1497
|-
|zwischen Khordad 1497 und Tir 1497
|BET @#DJALALI@ KHORD 1497 AND @#DHIJRI@ TIR 1497
|-
|ab Mordad 1497 bis Shahrivar 1497
|FROM @#DJALALI@ MORDA 1497 TO @#DHIJRI@ SHAHR 1497
|-
|nach Mehr 1497
|AFT @#DJALALI@ MEHR 1497
|-
|vor Aban 1497
|BEF @#DJALALI@ ABAN 1497
|-
|um Azar 1497
|ABT @#DJALALI@ AZAR 1497
|-
|ab Dey 1497
|FROM @#DJALALI@ DEY 1497
|-
|bis Bahman 1497
|TO @#DJALALI@ BAHMA 1497
|-
|1497
|@#DJALALI@ 03 XXXXX 1497
|-
| colspan="2" style="background-color:#fdf9dd; font-weight:bold; font-style:italic; padding-left:5em;" |Französischer Revolutionskalender
|-
|An XII
|@#DFRENCH R@ 12
|-
|Vendémiaire An XII
|@#DFRENCH R@ VEND 12
|-
|um Brumaire An XII
|ABT @#DFRENCH R@ BRUM 12
|-
|zwischen Frimaire An XII und Nivôse An XII
|BET @#DFRENCH R@ FRIM 12 AND @#DFRENCH R@ NIVO 12
|-
|ab Pluviôse An XII bis Ventôse An XII
|FROM @#DFRENCH R@ PLUV 12 TO @#DFRENCH R@ VENT 12
|-
|nach Germinal An XII
|AFT @#DFRENCH R@ GERM 12
|-
|vor Floréal An XII
|BEF @#DFRENCH R@ FLOR 12
|-
|um Prairial An XII
|ABT @#DFRENCH R@ PRAI 12
|-
|ab Messidor An XII
|FROM @#DFRENCH R@ MESS 12
|-
|bis Thermidor An XII
|TO @#DFRENCH R@ THER 12
|-
|geschätzt Fructidor An XII
|EST @#DFRENCH R@ FRUC 12
|-
|3. Ergänzungstage An XII
|@#DFRENCH R@ 03 COMP 12
|}
</div>
{{WT-ToDo|Noch beschreiben: Jahresanfang nicht immer zum 1. Januar, daher ggf. Doppeldeutigkeit und Angabe in einem Format wie 1741/42.}}

=== Uhrzeitangaben ===
Die Angabe einer Uhrzeit zu einem Ereignis ist im GEDCOM-Standard 5.5.1 nicht möglich; sie ist aber im GEDCOM-Standard 7.0 möglich und wird bereits jetzt von webtrees unterstützt, wenn der Verwalter dies so aktiviert hat. Eine Uhrzeit ist immer einem Datum untergeordnet. Eine Geburt, die etwa am 1. Juli 1957 um 12:34 stattfand, kann also vollständig erfasst werden.

Uhrzeitangaben erfolgen im 24-Stundenformat. Derzeit unterstützt webtrees nur die Angabe in der lokalen Zeit (also ohne Angabe einer Zeitzone). Eine Angabe der A- oder B-Uhrzeit bei der Umstellung von der Sommerzeit auf die Normalzeit ist nicht möglich. Die Angabe kann in folgenden Formaten erfolgen: <code>01:23</code>, <code>01:23:45</code> oder auch noch genauer <code>01:23:45.6789</code>.

== Ortsangaben ==
{{WT-ToDo|Noch beschreiben: GEDCOM-Standard mit Ortshierarchie; Erweiterung nach GEDCOM-L mit _LOC; Varianten: historische oder aktuelle Ortsdaten.}}

== Forschungsaufgaben ==
[[Datei:WT_2.1_Forschungsaufgabe-bearbeiten.png|thumb|right|250px|Forschungsaufgabe bearbeiten - oben: Formularansicht / unten: GEDCOM-Rohdaten ]]
Forschungsaufgaben sind besondere Einträge, die zu Personen oder Familien in einem Stammbaum hinzugefügt werden können, um die Notwendigkeit weitergehender genealogischer Forschungen zu beschreiben. Man kann sie als Erinnerung nutzen, etwa um Tatsachenbehauptungen noch mit Hilfe von zuverlässigeren Quellen zu überprüfen oder um auf widersprüchliche Informationen hinzuweisen, die noch aufgelöst werden müssen.

Um neue Forschungsaufgaben erstellen zu können, muss durch einen Verwalter zuerst die "Forschungsaufgabe" zur Liste der Tatsachen und Ereignisse in den [[Webtrees_Handbuch/Anleitung_für_Verwalter#Einstellungen|Stammbaumeinstellungen]] hinzugefügt worden sein.

Zu einer Forschungsaufgabe gehören folgende Informationen
* Forschungsaufgabe: "Was ist zu tun?"
* Datum: "Bis wann ist die Aufgabe zu erledigen bzw. wann wurde die Aufgabe erfasst?"
* Benutzer: "Wer soll die Aufgabe erledigen bzw. durch wen wurde die Aufgabe erfasst?"

In der Bedienoberfläche werden neue Aufgaben immer dem gerade angemeldeten Nutzer zugeordnet, der Bearbeiter kann aber auch frei definiert werden.

{{-}}
Die Aufgaben-Liste kann im gleichnamigen Block "Forschungsaufgaben" auf der [[Webtrees_Handbuch/Anleitung_f%C3%BCr_Administratoren/Module#Startseite|Startseite bzw. der persönlichen Seite des Benutzers]] eingeblendet werden. Die Datensätze werden dort tabellarisch aufgelistet mit Forschungsaufgaben-Datum, Verweis zum Personen- bzw. Familiendatensatz, Forschungsaufgaben-Benutzer und dem Text zur Forschungsaufgabe. Welche Datensätze sichtbar sind, kann über die Block-Einstellungen festgelegt werden.

<gallery perrow=2 widths="250">
Datei:WT_2.1_Meine-Seite-Forschungsaufgaben-Block.png|Anzeige des Blocks 'Forschungsaufgaben' auf 'Meine Seite'
Datei:WT_2.1_Block-Forschungsaufgaben-Einstellungen.png|Einstellungen des Blocks 'Forschungsaufgaben'
</gallery>
{{-}}

[[Datei:WT_2.1_Personenseite-Reiter-Tatsachen+Ereignisse-Forschungsaufgabe-Bearbeiter.png|thumb|right|250px|Ansicht der 'Forschungsaufgabe' auf Personenseite im Register 'Tatsachen und Ereignisse']]
Für Besucher und Mitglieder sind Forschungsaufgaben auf der Seite einer Person im Reiter "[[Webtrees_Handbuch/Anleitung_für_Besucher#Tatsachen_und_Ereignisse|Tatsachen und Ereignisse]]" sichtbar, wenn sie definiert sind (mit Text und zugeordnetem Nutzer) - analog werden die Einträge auch auf der Seite des Familiendatensatzes angezeigt.

Die Information zu einer Forschungsaufgabe wird im [[GEDCOM/INDI-Tag|INDI]]- und [[GEDCOM/FAM-Tag|FAM]]-Datensatz als [[GEDCOM/TODO-Tag|GEDCOM-Kennzeichen _TODO]] auf Ebene 1 abgelegt und kann somit eventuell auch mit einem anderen Programm ausgetauscht werden, sofern dieses Forschungsaufgaben unterstützt. Im [https://genealogy.net/GEDCOM/ GEDCOM-L-Addendum] wird im Diskussionsteil ein Vorschlag für eine erweiterte Form von Forschungsaufgaben vorgestellt; webtrees folgt diesem Vorschlag aber nicht.

== Geschichten ==
Diese Form der Geschichten ist ein Erbe noch aus der Vorgänger-Software phpGedView. Die Erstellung und Bearbeitung von Geschichten ist nur für den Administrator möglich. Das Formular ähnelt dem des [[Webtrees_Handbuch/Anleitung_für_Administratoren/Stammbäume#html-block|HTML-Blocks]], nur dass keine Variablenauswertung erfolgt und auch keine [[GEDCOM/XREF_ID|XREF-IDs]]<ref>Möglichkeit zur einheitlichen Handhabung von Querverweisen siehe [[Webtrees_Handbuch/Entwicklungsumgebung#Beispiel_-_Querverweise_zu_Datensätzen|Beispiel - Querverweise zu Datensätzen]].</ref> durch Links ersetzt werden. Eine Geschichte kann formatierten Text, Links oder Medienobjekte beinhalten. Geschichten können in mehreren Sprachen angelegt werden, so dass Besucher der Webseite die Geschichte in ihrer persönlichen Sprache zu sehen bekommen. Die Erstellung einer Geschichte erfolgt mit einem einfachen Editor, bei Bedarf auch mit direkter Bearbeitung des HTML-Quellcodes.

<gallery perrow=2 widths="250">
Datei:WT_2.1_Personenseite-Reiter-Geschichte-bearbeiten.png|Personenseite - Reiter 'Geschichten' (Bearbeitungsansicht)
Datei:WT_2.1_Geschichte-hinzufuegen.png|'Eine Geschichte hinzufügen' zu einer Person
</gallery>

{{Warnung|
;vor der Verwendung! 
Es wird nicht empfohlen, das Geschichten-Modul zu verwenden! Die Inhalte der Geschichten sind nicht Teil der GEDCOM-Struktur und werden nur in der Datenbank gespeichert. Das bedeutet, dass sie bei einen GEDCOM-Export nicht enthalten sind.}}
{{Infobox|
Die bessere Alternative ist anstelle von Geschichten '''Notizen''' oder "[[#Notizen-Datens.C3.A4tze|Gemeinsame Notizen]]" zu verwenden.
* Eine Notiz kann zusammen mit Abbildungen und Quellenangaben einer Tatsache (GEDCOM-Kennzeichen FACT) oder einem Ereignis (GEDCOM-Kennzeichen EVEN) zugeordnet werden, welche man wiederum einer Person zuordnet (beispielsweise "Besuch beim Erbonkel in den USA").
* Man kann gemeinsame Notizen auch mit mehr als einem [[#Personen-Datensätze|Personen-Datensatz]] verknüpfen.
* Mit [[Webtrees_Handbuch/Anleitung_für_Verwalter#Markdown|Markdown]] ist auch eine einfache Textformatierung möglich (lediglich das Einbinden von Bildern gelingt nicht so einfach).

Dieses Vorgehen bietet folgende Vorteile
* Die Informationen werden in der GEDCOM-Datei gespeichert und können somit exportiert werden.
* Die Erstellung ist nicht auf Administratoren beschränkt.

Allerdings können Notizen - anders als Geschichten - nicht einer Sprache zugeordnet werden, so dass Besucher der Webseite die Notiz nicht nach ihrer Sprache gefiltert angezeigt bekommen.}}

== HEAD- und SUBN-Datensätze ==
Es gibt zwei besondere Datensatzarten, die nur über den Weg der Suche im Kopfmenü bearbeitbar sind. Die eine Art ist der HEAD-Datensatz, der immer zu Beginn einer GEDCOM-Datei existiert und die ganze Datei näher kennzeichnet, und die andere Art ist der SUBN-Datensatz, der aber in Genealogieprogrammen schon lange keine Rolle mehr spielt.

=== Bearbeiten des Kopfbereichs der GEDCOM-Datei ===
[[Datei:WT_2.1_GEDCOM-Datei-bearbeiten-HEAD.png|thumb|right|350px|Formular zur Bearbeitung des Kopfbereichs der GEDCOM-Datei]]
Um den Kopfbereich der GEDCOM-Datei zu bearbeiten, gibt man im Suchfeld im Kopfmenü das Stichwort "[[GEDCOM/HEAD-Tag|HEAD]]" ein und erhält dann als Suchtreffer eine Anzeige des HEAD-Bereichs, den man strukturiert oder per "GEDCOM Rohdaten"<ref>siehe Abschnitt "[[Webtrees_Handbuch/Nutzungserfahrungen#Arbeiten_auf_der_GEDCOM-Ebene|Arbeiten auf der GEDCOM-Ebene]]" im Kapitel "[[Webtrees_Handbuch/Nutzungserfahrungen|Nutzungserfahrungen]]"</ref> bearbeiten kann. Allerdings wird beim Erzeugen einer GEDCOM-Datei der Kopfbereich automatisch neu erzeugt und einige der hier bearbeitbaren Felder werden dann dynamisch überschrieben oder ignoriert.

=== Bearbeiten des Übermittlungsdatensatzes der GEDCOM-Datei ===
[[Datei:WT_2.1_GEDCOM-Datei-bearbeiten-SUBN.png|thumb|left|350px|Formular zur Bearbeitung des Übermittlungsdatensatzes der GEDCOM-Datei]]
Der Datensatztyp "Übermittlung" (SUBN) wird schon lange nicht mehr verwendet. Er kann aber bei Bedarf noch bearbeitet werden, indem man im Suchfeld im Kopfmenü das Stichwort "SUBN" eingibt. Dann wird als Suchtreffer der SUBN-Datensatz angezeigt, den man strukturiert oder per "GEDCOM Rohdaten" bearbeiten kann.
{{-}}
{{Infobox|Es gibt eine interne (versteckte) Funktion, die das Bearbeiten aller möglichen Felder in einem Datensatz in einem einzigen Formular ermöglicht. Diese Funktion ist nicht über die Benutzungsschnittstelle erreichbar, sondern muss direkt über die Browser-Adresse angesteuert werden; man muss dort das Schlüsselwort "edit-record" vor der XREF des Datensatzes einfügen. Ein Beispiel zum Demo-Stammbaum ist (bitte mit editor/editor anmelden):
https://dev.webtrees.net/demo-dev/tree/demo/edit-record/I1
Ein Möglichkeit, die benötigte Browser-Adresse zu erzeugen, besteht darin, den Datensatz aufzurufen und dann die Funktion "GEDCOM Rohdaten bearbeiten" aufzurufen. In der dann sichtbaren Adresszeile, kann man dann "edit-raw" durch "edit-record" ersetzen.}}

== Einzelnachweise ==
<references />

[[Kategorie:Webtrees]]

Webtrees Handbuch/Anleitung für Administratoren/Webseite

2023-03-14T20:38:41Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Abschnitt 7.1|info=1}}{{WT-Inhaltsverzeichnis|Kapitel 7|C|Abschnitt 7.1}}

In diesem Abschnitt werden alle Einstellungen beschrieben, die die Webseite im Ganzen beeinflussen. Folgende Auswahlmöglichkeiten gibt es
<div style="display:inline-block;">
* [[#Einstellungen Webseite|Einstellungen Webseite]]
* [[#E-Mail-Versand|E-Mail-Versand]]
* [[#Anmeldung und Registrierung|Anmeldung und Registrierung]]
* [[#Webseitenprotokolle|Webseitenprotokolle]]
* [[#Datenordner bereinigen|Datenordner bereinigen]]
* [[#Server Information|Server Information]]
* [[#GEDCOM-Kennzeichen|GEDCOM-Kennzeichen]]
</div>

[[Datei:WT_2.1_Verwaltung-Webseite_neu.png|thumb|center|350 px|Verwaltung - Webseite]]

Seit der Version 2.1.16 gibt es die Möglichkeit mit der Schaltfläche 'check now' jederzeit nach der letzten aktuellen Version von webtrees zu suchen. 

[[Datei:WT_2.1_Verwaltung-Webseite-Neue_Versionen.png|thumb|center|350 px|Verwaltung - Neue Versionen]]

In der Überschriftenzeile dieses Abschnitts wird immer die derzeit installierte Versionsnummer von webtrees angezeigt (näheres zu den Versionsbezeichnungen finden Sie im Abschnitt "[[Webtrees Handbuch/Anleitung für Webmaster#Versionen_von_webtrees|Versionen von webtrees]]").

Auch für installierte [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodule]] kann hier ein Hinweis auf Aktualisierungen erscheinen, sofern die Module von dieser Möglichkeit Gebrauch machen.
{{-}}
== Einstellungen Webseite ==
[[Datei:WT_2.0_Einstellungen-Website.png|thumb|right|350px|Verwaltung "Einstellungen Website"]]
Die im folgenden beschriebenen Auswahlpunkte, die die gesamte Webseite betreffen, können hier konfiguriert werden.
{{-}}

=== <code>Datenverzeichnis</code> ===
Der hier festgelegte Ordner wird von webtrees verwendet, um Mediendateien, GEDCOM-Dateien, temporäre Dateien, etc. zu speichern. Diese Dateien könnten vertrauliche Daten enthalten und sollten nicht über das Internet verfügbar gemacht werden.

Um diese vertraulichen Daten zu schützen, verwendet webtrees eine Konfigurations-Datei für den [https://de.wikipedia.org/wiki/Apache_HTTP_Server Web-Server Apache] ([https://de.wikipedia.org/wiki/.htaccess .htaccess]), die jeden Zugriff auf dieses Verzeichnis verhindert. Falls Ihr Web-Server [[Webtrees Handbuch/Anleitung für Webmaster#.htaccess|.htaccess]]-Dateien nicht unterstützt und Sie den Zugriff auf dieses Verzeichnis nicht beschränken können, können Sie hier ein anderes Verzeichnis wählen.

Wenn Sie ein anderes Verzeichnis wählen, müssen Sie auch alle Dateien (außer den drei Dateien [[Webtrees Handbuch/Anleitung für Webmaster#config.ini.php|config.ini.php]], index.php und [[Webtrees Handbuch/Anleitung für Webmaster#.htaccess|.htaccess]]) in den neuen Ordner verschieben.

Das Verzeichnis kann mit dem vollen Pfad (z.B. /home/user_name/webtrees_data/) oder relativ zum Installationsverzeichnis (z.B. ../../webtrees_data/) angegeben werden. Der Standard für diese Konfigurationsoption ist "data/". URLs können hier nicht angegeben werden, so dass Cloud-Speicherdienste derzeit noch nicht adressiert werden können, was aber geplant ist. Diese Konfigurationsoption ist auch nötig, wenn Sie mehrere webtrees-Installationen parallel betreiben möchten, die alle auf die selben Mediendateien zugreifen sollen. Davon wird aber abgeraten.

=== <code>Zeitzone</code> ===
Die Angabe der Zeitzone<ref>{{wikipedia-Link|Zeitzone}}</ref> wird für Datumsberechnungen benötigt, wie etwa um das heutige Datum zu ermitteln. Es geht hier um die Zeitzone in der sich der webtrees-Server befindet. Eine Angabe von Sommer-/Winterzeit ist nicht möglich.

=== <code>Standardthema</code> ===
Sie können das Aussehen von webtrees mit vorgefertigten Layoutvorlagen (sogenannten „[[Webtrees Handbuch/Anleitung für Besucher#Thema|Themen]]“) ändern. Jedes [[Webtrees Handbuch/Anleitung für Besucher#Thema|Thema]] hat einen anderen Stil, ein spezielles Layout und verwendet eine eigene Farbgebung, etc. Hier wird das Thema festgelegt, das zur Anzeige kommt, wenn ein Besucher erstmalig auf die Webseite kommt. Bei der Auswahl des Standardthemas für die Webseite muss beachtet werden, dass das entsprechende Themen-Modul auch aktiviert ist (siehe Abschnitt "[[Webtrees Handbuch/Anleitung für Administratoren/Module|Module]]").
Andernfalls wird das Thema "[[Webtrees Handbuch/Anleitung für Besucher#webtrees|webtrees]]" als Standardthema verwendet (unabhängig davon ob das Themen-Modul "[[Webtrees Handbuch/Anleitung für Besucher#webtrees|webtrees]]" aktiviert ist oder nicht).

=== <code>Sprache</code> ===
Die hier festgelegte Sprache wird genutzt, wenn im Browser des Besuchers keine oder eine nicht unterstützte Sprache eingetragen ist. Diese Einstellung kommt auch zum Tragen, wenn Suchmaschinen die Seite besuchen. Bei der Auswahl der Standardsprache für die Webseite muss beachtet werden, dass das Modul für die entsprechende Sprache auch aktiviert ist (siehe Abschnitt "[[Webtrees Handbuch/Anleitung für Administratoren/Module|Module]]").

=== <code>Liste der Stammbäume zeigen</code> ===
Wenn es mehr als einen [[Webtrees Handbuch/Anleitung für Administratoren/Stammbäume|Stammbaum]] auf der Webseite gibt, kann hier gewählt werden, ob den Besuchern eine Auflistung der Stammbäume angezeigt werden soll, z.B. auf der Hauptseite oder bei der Suche. Selbstverständlich sehen Besucher nur diejenigen Stammbäume, auf die sie auch Zugriff haben. Wenn hier "nein" gewählt wird, wird einem Besucher der Standardbaum angezeigt und er sieht nicht, dass es ggf. noch weitere Stammbäume gibt, auf die er Zugriff hat. Um diese Stammbäume zu erreichen, muss er ihren Namen kennen und die passende URL als direkte Adresse verwenden.{{-}}

== E-Mail-Versand ==
[[Datei:WT 2.1 Verwaltung-E-Mail-Versand2.png|alternativtext=Verwaltung - E-Mail-Versand|thumb|551x551px|Verwaltung - E-Mail-Versand]]
Auf dieser Seite werden die Einstellungen vorgenommen, um den Versand von E-Mails aus webtrees heraus zu ermöglichen.

* Im Feld "<code>'''Nachrichten'''</code>" wird festgelegt, ob der Versand per "'''sendmail'''" oder "'''SMTP'''"<ref>{{wikipedia-Link|SMTP}}</ref> erfolgen soll. In den meisten Fällen wird man SMTP als gängige Methode wählen.

* Im Feld "<code>'''Absender'''</code>" ist ein Name einzugeben, unter dem die E-Mails verschickt werden.

* Das Feld "<code>'''E-Mail des Absenders'''</code>" muss die zugehörige E-Mail-Adresse enthalten.

Der Abschnitt "'''SMTP Mailserver'''" wird zur Konfiguration verwendet, wenn diese Versand-Methode unter Nachrichten ausgewählt wurde. Folgende Einstellungen können vorgenommen werden.

* <code>'''Servername'''</code> - eine gültige Mailserver-Adresse oder localhost, wenn der Mailserver auf dem gleichen Computer läuft wie der Webserver.
* <code>'''Portnummer'''</code> - für SMTP (unverschlüsselt) wird 25, für SMTPS (verschlüsselt) 465 verwendet.
* <code>'''Passwort verwenden'''</code> - ist abhängig von der Konfiguration des Mailservers.
* <code>'''Benutzername'''</code> - ist abhängig vom verwendeten Mailpostfach.
* <code>'''Passwort'''</code> - ist das für das verwendete Mailpostfach vergebene Passwort.
* <code>'''Gesicherte (SSL) Verbindung'''</code><ref>{{wikipedia-Link|Transport_Layer_Security}}</ref> - ist abhängig von der Konfiguration des Mailservers; hier kann ausgewählt werden zwischen "keine" - ohne Verschlüsselung "SSL/TLS" - TLS-Verschlüsselung mit Klartextaustausch am Anfang der Kommunikation "STARTTLS" - TLS-Verschlüsselung ohne Klartextaustausch
* <code>'''Name des Ausgangsservers'''</code> - eine gültige Mailserver-Adresse, kann der selbe Name sein wie "Servername".

Das DKIM-System<ref>{{wikipedia-Link|DomainKeys}}</ref> ("'''DomainKeys Identified Mail-Signatur'''") fügt eine verschlüsselte Signatur in den Kopf von E-Mails ein, die von einem E-Mail-Server gesendet werden, um zu beweisen, dass der angebliche Absender auch der tatsächliche ist. Es handelt sich um eine Art der E-Mail-Authentifizierung, die hauptsächlich von Unternehmen, bei privaten Webservern jedoch eher selten genutzt wird. Wenn Ihr E-Mail-Server DKIM anbietet, können Sie in den drei Feldern den <code>'''Domänennamen'''</code>, den bereitgestellten <code>'''Selektor'''</code> und den <code>'''privaten Schlüssel'''</code> eintragen.

Mit der Checkbox am Ende der Seite kann man "Eine Test-E-Mail mit diesen Einstellungen senden". Dabei versendet webtrees die E-Mail mit der oben angegebenen Absenderadresse an dieselbe als Empfänger.

== Anmeldung und Registrierung ==
[[Datei:WT_2.0_Anmeldung-und-Registrierung.png|thumb|right|350px|Anmeldung und Registrierung]]
Mit dem Formular "Anmeldung und Registrierung" kann der Administrator das Aussehen bzw. Verhalten der [[Webtrees Handbuch/Anleitung für Besucher#Anmelden|Anmeldeseite]] bestimmen.

Über die Einstellung des ersten Eingabefelds '''"<code>Begrüßungstext auf der Anmeldungsseite</code>"''' wird die Art festgelegt, wie den Besuchern mitgeteilt wird, für welche Gruppe von Mitgliedern die Website vorgesehen ist. Folgende Optionen stehen zur Auswahl (in Klammern steht der im Formular anzuzeigende Text)
* Kein vordefinierter Text
* Vordefinierter Text, der erklärt, dass alle Benutzer einen Zugang anfragen können ("Jeder mit einem Benutzerkonto kann auf diese Website zugreifen.")
* Vordefinierter Text, der erklärt, dass der Verwalter über die Benutzeranfrage entscheidet ("Sie müssen ein zugelassener Benutzer sein, um auf diese Website zuzugreifen.")
* Vordefinierter Text, der erklärt, dass nur Familienmitglieder einen Zugang anfragen können ("Sie müssen ein Familienmitglied sein, um auf diese Website zuzugreifen.")
* Selbsterstellter Text wie unten angegeben

Mit der letzten Option wird der Text im Feld '''"<code>Individualisierter Begrüßungstext</code>"''' zur Anzeige genutzt. Um diesen Text in eine andere Sprache zu übersetzen, müssen Sie zu dieser Sprache wechseln, dieses Formular erneut aufrufen und das Feld entsprechend erneut ausfüllen.

Mit dem Schalter '''"<code>Besuchern erlauben ein neues Benutzerkonto anzufordern</code>"''' wird der zusätzliche Hinweistext ("Sie können ein Benutzerkonto über den unten stehenden Link beantragen.") oberhalb des Anmelde-Formulars und der eigentliche Link "Neues Benutzerkonto anfragen" im unteren Bereich angezeigt.

Der Schalter '''"<code>Nutzungsbedingungen auf der Seite 'Neues Benutzerkonto anfragen' zeigen</code>"''' wirkt sich nur aus, wenn der vorgenannte Schalter aktiviert wurde. Hiermit wird auf dem bezeichneten Folge-Formular für die Selbstregistrierung der folgende '''Hinweis''' vorweg angezeigt:
<blockquote>
Mit dem Ausfüllen und Absenden dieses Formulars erklären Sie sich damit einverstanden:
* den Datenschutz von auf unserer Website aufgeführten lebenden Personen zu beachten
* und im Textfeld unten Ihr Verwandtschaftsverhältnis zu Personen dieser Website zu beschreiben, oder uns Informationen über jemanden zukommen zu lassen, der auf unserer Website aufgeführt werden sollte.
</blockquote>

Der Hinweis lässt sich nicht so ohne weiteres anpassen - er ist in den Übersetzungsdateien hinterlegt.

== Webseitenprotokolle ==
Mit den Webseitenprotokollen erhalten Sie Zugang zu verschiedenen Auswertungen für Administratoren, die im Folgenden beschrieben werden. Sie sollten als Administrator diese Funktion regelmäßig verwenden, um mögliche Schadensereignisse bei der Nutzung frühzeitig zu erkennen. So werden hier auch alle erfolglosen Login-Versuche protokolliert, denn im Internet gibt es ständig Versuche, Nutzerkennung und Passwort zu erraten, um damit unberechtigt Zugang zu Webseiten zu erhalten.

[[Datei:WT 2.1 Verwaltung-Webseitenprotokolle.png|alternativtext=Verwaltung - Webseitenprotokolle|thumb|right|350px|Verwaltung - Webseitenprotokolle]]

In den Feldern "<code>'''von'''</code>" und "<code>'''bis'''</code>" stehen beim Aufruf das Datum, wann dieser Stammbaum angelegt wurde und das aktuelle Tagesdatum. Beide Grenzen können vom Anwender geändert werden. Alle anderen Felder sind zunächst leer. Dadurch wird ein chronologisches Protokoll aller verwaltungsrelevanten Aktivitäten generiert. Die erzeugte Liste lässt sich durch Klick auf die Spaltenköpfe aufsteigend und absteigend sortieren.

Mit den weiteren Feldern kann die Liste eingeschränkt und gefiltert werden.

[[Datei:WT 2.1 Verwaltung-Webseitenprotokolle-Beispiel.png|alternativtext=Verwaltung - Beispiel Webseitenprotokolle|thumb|350px|Verwaltung - Beispiel Webseitenprotokolle]]
Unter "<code>'''Typ'''</code>" verbirgt sich eine Liste mit folgenden Möglichkeiten
* '''leer''' - das ist die Standardeinstellung und bedeutet alle Typen
* '''auth''' - dient der Anzeige von Authentfizierungsvorgängen, die in Zusammenhang mit dem Benutzerzugang stehen, wie z.B. Login, Login failed, Logout, Password request, Password reset, User created
* '''config''' - zeigt Änderungen der Konfiguration an, wie z.B. Site preference, Tree preference
* '''debug''' - soll die Fehlersuche unterstützen, wird aber derzeit von webtrees nicht verwendet
* '''edit''' - zeigt alle Bearbeitungsvorgänge von genealogischen Daten an
* '''error''' - damit lassen sich die von webtrees abgefangenen Fehler ansehen
* '''media''' - soll Änderungen an den Medien auflisten, wird aber derzeit von webtrees nicht verwendet
* '''search''' - hier wurden in früheren Versionen alle Suchvorgänge protokolliert, dies wird aber derzeit von webtrees nicht verwendet

Im Feld "<code>'''IP-Adresse'''</code>" kann auf eine vollständige Adresse oder Teile davon selektiert werden (Beginn der IP-Adresse).

Die Spalte Nachricht dient in der Auflistung der Beschreibung des jeweiligen Eintrags. Demnach kann mit dem Feld "<code>'''Nachricht'''</code>" auf das Vorkommen von Zeichen in den Nachrichten gefiltert werden.

Bei "<code>'''Benutzer'''</code>" handelt es sich um eine Auswahlliste, die alle in der Benutzerverwaltung angelegten Personen anzeigt, so dass man auf die Aktivitäten einzelner Benutzer eingrenzen kann.

Das letzte Feld "<code>'''Stammbaum'''</code>" erlaubt die Auswahl einzelner Stammbäume.

Mit der blauen Schaltfläche "<code style="background-color: blue; color: #fff;">suche</code>" wird entsprechend der eingestellten Filterbedingungen gesucht. Mit der grauen Schaltfläche "<code style="background-color: gray; color: #fff;">zurücksetzen</code>" werden die eingestellten Filterbedingungen gelöscht. Mit der grauen Schaltfläche "<code style="background-color: gray; color: #fff;">herunterladen</code>" lässt sich das in der Tabelle angezeigte Suchergebnis als csv-Datei auf den lokalen Datenträger herunterladen. Mit der roten Schaltfläche "<code style="background-color: red; color: #fff;">löschen</code>" lässt sich das in der Tabelle angezeigte Suchergebnis aus der Datenbank entfernen.

{{-}}

== Datenordner bereinigen ==
[[Datei:WT 2.1 Verwaltung-Datenordner bereinigen.png|alternativtext=Verwaltung - Datenordner bereinigen|thumb|350px|Verwaltung - Datenordner bereinigen]]
Das in den [[#Einstellungen_Webseite|Einstellungen Webseite]] konfigurierte Datenverzeichnis (in der Regel "data/") kann hier komfortabel um unnötigen Ballast bereinigt werden. Für die ordnungsgemäße Funktion notwendige Elemente und auch die Mediendateien sind davon nicht betroffen. Beispielsweise kann durch das Entfernen des Cache-Ordners der Neuaufbau des Cache forciert werden, was helfen kann, wenn der Cache inkonsistente Zustände enthält.{{-}}

== Server Information ==
[[Datei:WT 2.1 Verwaltung-Server Information.png|alternativtext=Verwaltung - Server Information|thumb|350px|Verwaltung - Server Information]]
Hier erfolgt die Ausgabe aller Informationen zur Konfiguration der Software-Umgebung auf dem Server, die mittels der PHP-Funktion [https://www.php.net/manual/de/function.phpinfo.php phpinfo()] erzeugt wird.

Diese Informationen können hilfreich sein, wenn es darum geht Fehler zu finden (siehe Abschnitt "[[Webtrees_Handbuch/Entwicklungsumgebung#Analyse_und_Meldung_von_Programmfehlern|Analyse und Meldung von Programmfehlern]]").

Die Liste ist unterteilt in die Abschnitte

* PHP Informationen
* Configuration
* Additional Modules
* Environment
* PHP Variables.

Dabei ist der Abschnitt "Configuration" der längste und in diverse Unterabschnitte gegliedert. Man findet darin alle installierten PHP-Module.{{-}}

== GEDCOM-Kennzeichen ==
[[Datei:WT 2.1 Verwaltung-GEDCOM-Kennzeichen Standard.png|alternativtext=Verwaltung - GEDCOM-Kennzeichen|thumb|350x350px|Verwaltung - GEDCOM-Kennzeichen]]
In diesem Abschnitt können verschiedene Festlegungen zu GEDCOM-Kennzeichen getroffen werden, mit denen deren Verwendung in der Bedienoberfläche beeinflusst wird. In einer Liste von eher selten benötigten Kennzeichen ist eine aktivierte bzw. deaktivierte Belegung vorausgewählt. Diese Einstellungen können auf die Bedürfnisse der Website, d.h. für alle Stammbäume gemeinsam, angepasst werden. In den meisten Fällen wird die von webtrees getroffene Vorauswahl passend sein.

Die Liste der konfigurierbaren GEDCOM-Kennzeichen ist untergliedert in thematische Abschnitte für "Namen", "Orte", "Adressen", "Quellenzitate", "Quellen", "Tatsachen und Ereignisse", "HLT Kirche", "Kennungen" und "Übermittler".

[[Datei:WT 2.1 Verwaltung-GEDCOM-Kennzeichen Benutzerdefiniert.png|alternativtext=Verwaltung - Benutzerdefinierte GEDCOM-Kennzeichen|thumb|350x350px|Verwaltung - Benutzerdefinierte GEDCOM-Kennzeichen]]
Man kann in diesem Abschnitt auch noch zusätzlich benutzerdefinierte GEDCOM-Kennzeichen aktivieren. Insbesondere Anwender, die ihre Daten ausschließlich mit webtrees erfassen und präsentieren, werden hier eher selten Hand anlegen müssen. Es kann aber erforderlich sein, bestimmte GEDCOM-Kennzeichen zu aktivieren, etwa wenn ein Datenaustausch mit anderen Genealogie-Programmen erfolgt. webtrees versteht sehr viele verschiedene GEDCOM-Dialekte und kann damit die meisten benutzerdefinierten Kennzeichen anzeigen. Es wird nicht empfohlen, benutzerdefinierte GEDCOM-Kennzeichen zu verwenden, denn diese Daten können verloren gehen, wenn Sie in andere Programme übertragen werden. Wenn man neue Daten unter Verwendung von benutzerdefinierten Kennzeichen in webtrees erstellen möchte, muss man diese hier aktivieren, damit sie dann in der Bedienoberfläche erscheinen können. Die hier gemachten Einstellungen gelten für '''alle''' angelegten Stammbäume.

Hier können nur solche benutzerdefinierte GEDCOM-Kennzeichen aus einer Liste ausgewählt werden, die zu Personen ([[GEDCOM/INDI-Tag|INDI]]) oder Familien ([[GEDCOM/FAM-Tag|FAM]]) gehören. Eine Auswahl von benutzerdefinierten Kennzeichen für andere Datensatztypen, wie Quellen ([[GEDCOM/SOUR-Tag|SOUR]]), Notizen ([[GEDCOM/NOTE-Tag|NOTE]]) oder Ortsdatensätzen (_LOC) ist hier nicht möglich. Wenn man für diese Datensatztypen benutzerdefinierte Kennzeichen benötigt, dann muss man dafür ein eigens zu erstellendes [https://github.com/webtrees/example-module-custom-tags Erweiterungsmodul] erzeugen.

In den Kirchenbüchern und Standesurkunden einiger Länder war und ist es üblich, neben dem Datum auch die Uhrzeit für Geburt, Tod, Beerdigung und Heirat niederzuschreiben. Viele Programme unterstützen daher die Möglichkeit, diese Uhrzeiten bei solchen Ereignissen zu erfassen. Dies ist gemäß GEDCOM 5.5.1 nicht zulässig, wohl aber bei GEDCOM 7.0. Mit der Checkbox "Uhrzeit der Geburt und des Todes zeigen" hat der Administrator die Möglichkeit, im Vorgriff auf GEDCOM 7.0, bereits jetzt die Erfassung von Uhrzeiten für Geburts- und Todesereignisse zu ermöglichen, obwohl sich webtrees ansonsten derzeit an GEDCOM 5.5.1 hält.

Darüber hinaus gibt es mit einer weiteren Checkbox die Möglichkeit, auch alle Erweiterungen zu aktivieren, die die [[GEDCOM-L|GEDCOM-L-Gruppe]] im [https://genealogy.net/GEDCOM/ Addendum] (Version R2) getroffen hat.

== Einzelnachweise ==
<references />
[[Kategorie:Webtrees]]

Webtrees Handbuch/Anleitung für Administratoren/Stammbäume

2023-03-14T20:38:31Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Abschnitt 7.2|info=1}}{{WT-Inhaltsverzeichnis|Kapitel 7|C|Abschnitt 7.2}}

<div style="float:right;">[[Datei:WT_2.0_Stammbaeume.png|thumb|center|350px|Abschnitt Stammbäume auf der Verwaltungsseite]]</div>
In der ersten Zeile dieses Abschnitts im Verwaltungsmenü steht die Anzahl der aktuell angelegten Stammbäume. Darunter können folgende Auswahlmöglichkeiten stehen
<div style="display:inline-block;">
* [[#Einen_Stammbaum_erstellen|Einen Stammbaum erstellen]]
* [[#Standardblöcke_für_neue_Stammbäume_festlegen|Standardblöcke für neue Stammbäume festlegen]]
* [[#Stammbäume_zusammenführen|Stammbäume zusammenführen]]
</div>

In der sich anschließenden Tabelle werden die verfügbaren Stammbäume aufgelistet und die jeweiligen aktuellen Zählerstände angegeben zu
* Ausstehenden Änderungen
* Personen
* Familien
* Quellen
* Archiven
* Multimedia-Objekten
* Notizen
* Übermittlern.

Die Zahlen sind zu den jeweiligen [[Webtrees Handbuch/Anleitung für Besucher#Listen|Listen]] für den Ressourcentyp im betreffenden Stammbaum bzw. zum Formular "[[Webtrees_Handbuch/Anleitung_f%C3%BCr_Moderatoren#Ausstehende_.C3.84nderungen|Ausstehende Änderungen]]" für die Übernahme oder Ablehnung der vorgenommenen, aber noch nicht freigegebenen Änderungen verlinkt. Ein Klick auf die Stammbaumnamen führt zur "[[#Stammbäume_verwalten|Stammbäume verwalten]]"-Seite.
<div style="clear: left;"></div>

== Einen Stammbaum erstellen ==
[[Datei:WT 2.1 Verwaltung-Einen Stammbaum erstellen.png|alternativtext=Einen Stammbaum erstellen|thumb|left|350px|Einen Stammbaum erstellen]]
Die Anlage eines neuen Stammbaums ist recht einfach. Es werden nur ein beschreibender Name (Titel) und ein Teil der Internetadresse eingegeben. Dieser Adressteil sollte keine Sonderzeichen und keine Leerzeichen enthalten. Der Titel des Stammbaums erscheint auf der zugehörigen [[Webtrees_Handbuch/Anleitung_für_Besucher#Blöcke_der_Startseite|Startseite]]. Die vollständige Internetadresse des Stammbaums besteht aus der Stammadresse der Domain gefolgt von <code>/tree/</code> und dem gewählten Adressteil (zu den URL-Varianten vgl. auch den Abschnitt zu "[[Webtrees_Handbuch/Anleitung_für_Webmaster#Pretty-URLs|Pretty-URLs]]").

Der neu erstellte Stammbaum enthält bereits einen [[Webtrees_Handbuch/Anleitung_für_Verwalter#Nicht_verkn.C3.BCpfte_Datens.C3.A4tze_hinzuf.C3.BCgen|nicht verknüpften]] Personendatensatz als Ausgangspunkt für die weiteren [[Webtrees_Handbuch/Anleitung_für_Bearbeiter|Bearbeitungen]].
{{-}}

== Standardblöcke für neue Stammbäume festlegen ==
[[Datei:WT 2.1 Verwaltung-Standardbloecke fuer neue Stammbaeume festlegen.png|alternativtext=Standardblöcke für neue Stammbäume festlegen|thumb|350px|Standardblöcke für neue Stammbäume festlegen]]
Mit dieser Funktion können die Blöcke ausgewählt werden, die standardmäßig auf der Startseite des Stammbaums angezeigt werden sollen. Die Anzahl der Blöcke, die in dieser Einstellung sichtbar sind, wird durch die Auswahl im Abschnitt "[[Webtrees Handbuch/Anleitung für Administratoren/Module#Startseite|Startseite]]" der "Anleitung für Administratoren/Module" bestimmt.

Die Bildschirm-Darstellung von webtrees besteht in der Regel aus einem breiteren Bereich auf der linken Seite und einem schmaleren auf der rechten. Auf mobilen Endgeräten wird der linke Darstellungsbereich oben und der rechte darunter angezeigt. Für die Darstellungsbereiche stehen verschiedene Elemente genannt Blöcke zur Verfügung, mit denen sich Inhalte aus den Stammbaumdaten in Textform, als Tabelle oder grafisch anzeigen lassen.

Die zugehörige Konfigurationsmaske besteht aus zwei Teilen, im oberen Bereich zur Darstellung der gewählten Bildschirmaufteilung und im unteren zur Auswahl der zur Verfügung stehenden Blöcke. Durch Anklicken des "Anfassers" links und Ziehen können die Blöcke von unten nach oben bzw. von links nach rechts und umgekehrt verschoben werden. Das Entfernen von Blöcken im oberen Abschnitt erfolgt durch Klick auf das Symbol "Mülleimer".

Am Seitenende können mit den Schaltflächen <code>'''Speichern'''</code> und <code>'''Abbrechen'''</code> die Änderungen gesichert bzw. verworfen werden.

{{-}}
Ein Block kann grundsätzlich auch mehrfach ausgewählt werden, dies ist jedoch nicht für alle Blocktypen sinnvoll. Vor allem der '''HTML-Block''' wird gerne mehrfach für unterschiedliche Anzeigen und Sprachen verwendet.

Unter folgendem Link befindet sich eine Übersicht über die verfügbaren [[Webtrees Handbuch/Anleitung für Administratoren/Module|Blöcke]]. Die meisten Blöcke sind in ihrer Wirkungsweise selbsterklärend. Beispielhaft für alle Blöcke wird nachfolgend der HTML-Block erklärt, da er sehr viele Möglichkeiten für eine individuelle Gestaltung bietet.
[[Datei:WT 2.1 Verwaltung-Module Bloecke HTML-Einstellungen.png|alternativtext=Verwaltung - Module - Einstellungen HTML-Block|mini|383x383px|Verwaltung - Module - Einstellungen HTML-Block]]
Zunächst wird der HTML-Block wie oben beschrieben in einen der beiden Bereiche gezogen. Nach dem Wechsel auf die entsprechende Startseite oder "Meine Seite" steht der noch leere Block bereit und kann mit dem Schraubenschlüssel konfiguriert werden. Auf der Seite gibt es die nachfolgend beschriebenen Einstellmöglichkeiten.

* '''Titel''' - hier wird der Text eingetragen, der den Block für den Betrachter kurz beschreibt
* '''Vorlagen''' - webtrees stellt vier Standard-Vorlagen zur Verfügung, die den Einstieg erleichtern können
**''Personalisiert'' - bietet die meisten Freiheitsgrade, hier kann mit dem Editor Freitext eingegeben und formatiert werden
** ''Schlagwortbeispiele'' - setzt in den Editor die mächtige Variable '''#getAllTagsTable#''' ein. Nach dem Speichern des Blocks werden damit '''alle''' verfügbaren Variablen angezeigt. Es empfiehlt sich daher, diese Vorlage nur auf "Meine Seite" zu nutzen, da die "Startseite" damit für Besucher sehr unübersichtlich wird. Die Variablen können aus Text oder aus grafischen Bestandteilen bestehen und in eigenen Texten verwendet werden, um damit gezielt Informationen aus dem System zur Anzeige zu bringen. Beispielsweise liefern die Variable '''#totalLiving#''' die Anzahl aller noch lebenden Personen im Stammbaum und die Variable '''#chartDistribution#''' die Grafik des Personenverteilungsdiagramms.
** ''Erzählerische Schreibweise'' - liefert im Editor ein Textbeispiel mit einigen Variablen
** ''Statistiken'' - liefert im Editor ein Beispiel für Statistiken in Tabellenform mit einigen Variablen
* '''Inhalt''' - stellt einen Texteditor ähnlich einer Textverarbeitung zur Verfügung. Wie unter Vorlagen beschrieben können Sie hier eigene Texte gestalten. Sie können in den Texten die Variablen für Informationen und Grafiken beliebig zum Einsatz bringen. Über dem Textfeld befinden sich Formatierungsoptionen, mit denen sich der Text je nach Geschmack und Können (Schriftart, Schriftstil, Schriftauszeichnung, etc.) gestalten lässt. Wer über HTML-Kenntnisse verfügt, kann mit dem Button "Quellcode" auch in die Programmierung des HTML-Blocks eingreifen.
* '''Datum und Zeit der Aktualisierung zeigen''' - legt fest, ob der Zeitstempel für die letzte Änderung des Blocks automatisch angezeigt werden soll.
* '''Diesen Block für welche Sprachen zeigen''' - legt fest in welcher der verfügbaren Sprachen der Block angezeigt werden soll. Wenn hier keine Sprache ausgewählt wird, wird der Block in allen Sprachen angezeigt. Davon sollte mit einer allgemeinen Bemerkung in Englisch Gebrauch gemacht werden, wenn zu erwarten ist, dass die Seite von vielen verschiedenen Nationen mit ihren Sprachen besucht werden. Wenn einzelne Sprachen festgelegt werden, wird der Block nur in diesen angezeigt. Wenn Sie eine mehrsprachige Seite anlegen wollen, müssen Sie für alle Texte je einen Block in jeder der gewünschten Sprachen anlegen. Die Übersetzung erfolgt nicht automatisch. Da alle Blöcke in der Konfiguration nur als HTML bezeichnet werden, empfiehlt sich hier eine eigene Systematik, da die Verwaltung sonst schnell unübersichtlich wird.

Am Seitenende können mit den Schaltflächen <code>'''Speichern'''</code> und <code>'''Abbrechen'''</code> die Änderungen gesichert bzw. verworfen werden.
[[Datei:WT 2.1 Verwaltung-Module Bloecke HTML-Admin-Block.png|alternativtext=Beispiel eines HTML-Admin-Blocks|thumb|350px|Beispiel eines HTML-Admin-Blocks]]
Ein Beispiel für einen HTML-Block für die "Meine Seite" sei der folgende Code-Block, der mit einigen Angaben zum gerade aktiven Stammbaum und beispielhaften Sprungmarken zu mehreren Stammbäumen versehen ist. Dieser Code kann hier kopiert und dann in einen HTML-Block eingefügt werden (dort in den Modus "Quellcode" umschalten).

{{-}}
Beispiel für den HTML-Code für einen Admin-Block:
<syntaxhighlight lang="html">
webtrees #webtreesVersion# 
aktuell #totalUsers# Benutzer

Stammbaum #gedcomFilename# zuletzt geändert am #gedcomUpdated# 
#hitCount# Seitenbesuche 
#totalIndividuals# Personen (#totalLiving# lebend - #totalSexFemales# Frauen - #totalSexMales# Männer) 
#totalFamilies# Familien 
#totalEvents# Einzelereignisse 
#totalMedia# Medienobjekte (#totalMediaDocument# Dokumente - #totalMediaCertificate# Urkunden - #totalMediaPhoto# Fotos - #totalMediaTombstone# Grabsteine) 
#totalSources# Quellen 
#totalPlaces# Orte

<a href="https://webtrees.my-page.de/tree/tree1/my-page">1 - Mein Baum</a> 
<a href="https://webtrees.my-page.de/tree/tree2/my-page">2 - Adelsgeschlechter</a> 
<a href="https://webtrees.my-page.de/tree/tree3/my-page">3 - Ortsfamilienbuch</a>

# getAllTagsTable# ist deaktiviert
</syntaxhighlight>
Das Schlüsselwort <code># getAllTagsTable#</code> kann durch das Entfernen des Leerzeichens am Anfang bei Bedarf aktiviert werden. Die Verweise <code><nowiki>https://webtrees.my-page.de/tree/tree1</nowiki></code> etc. müssen durch die passenden eigenen URLs ersetzt werden.
{{-}}

== Stammbäume zusammenführen ==
[[Datei:Webtrees- Verwaltung - Stammbäume zusammenführen.png|alternativtext=Stammbäume zusammenführen|thumb|350px|Stammbäume zusammenführen]]
Für die Verknüpfung von zwei Stammbäumen stellt webtrees eine mächtige Funktion zur Verfügung. Dazu werden aus den aktuell verfügbaren Stammbäumen oben derjenige ausgewählt, aus dem die Daten kommen sollen, und unten derjenige, in den die Daten aufgenommen werden.
{{-}}

[[Datei:WT 2.1 Verwaltung-Stammbaeume zusammenfuehren.png|alternativtext=Stammbäume zusammenführen mit erkannten Problemen|thumb|350px|Stammbäume zusammenführen mit erkannten Problemen]]
Sofern die Prüfung keine Probleme erkennt, wird der erste in den zweiten Stammbaum integriert.

Wenn in den Stammbäumen identische interne Referenzen gefunden werden, müssen Sie zuvor mit den erscheinenden Links einen der Stammbäume [[Webtrees_Handbuch/Anleitung_für_Verwalter#Neu_nummerieren|"neu nummerieren"]]. Danach kann die Verschmelzung mit dem Button "Weiter" ausgeführt werden.

Abhängig von Größe der Stammbäume und der Leistungsfähigkeit des Servers kann die Funktion einige Zeit in Anspruch nehmen oder sogar abbrechen. Ein Abbruch führt zu einem internen Rollback und verändert die Daten daher nicht.
{{-}}

== Stammbäume verwalten ==
[[Datei:WT_2.1_Stammbaeume-verwalten-Administratoransicht.png|thumb|right|350px|Stammbäume verwalten - Administratoransicht]]
Wenn der Administrator einen der Stammbaum aus der oben beschriebenen Tabelle auswählt, öffnet sich die Seite "Stammbäume verwalten" und dort das zu diesem Stammbaum gehörige Aufklapp-Element (genannt "Akkordeon-Menü").

Sind in der webtrees-Instanz mehrere Stammbäume angelegt, sieht der Administrator alle Stammbäume; ein Verwalter würde nur diejenigen Stammbäume sehen, für die er eine Berechtigung besitzt.

Die Bearbeitungs-Optionen sind in vier Kategorien unterteilt
* [[Webtrees_Handbuch/Anleitung_für_Verwalter#Stammbaum|Stammbaum]]
* [[Webtrees_Handbuch/Anleitung_für_Verwalter#Genealogische_Daten|Genealogische Daten]]
* [[Webtrees_Handbuch/Anleitung_für_Verwalter#Nicht_verkn.C3.BCpfte_Datens.C3.A4tze_hinzuf.C3.BCgen|Nicht verknüpfte Datensätze hinzufügen]]
* [[Webtrees_Handbuch/Anleitung_für_Verwalter#GEDCOM-Datei|GEDCOM-Datei]]

Davon werden hier nur die folgenden exklusiv dem Administrator vorbehaltenen Funktionen beschrieben
* unter "[[#Einstellungen|Einstellungen]]" die Option zum Ändern des "Medienordner"-Verzeichnisses
* "[[#Löschen|Löschen]]"
* "[[#Als Standard setzen|Als Standard setzen]]"

Erläuterungen zu den gemeinsamen Funktionen können dem Abschnitt "[[Webtrees_Handbuch/Anleitung_für_Verwalter|Anleitung für Verwalter]]" entnommen werden.
{{-}}

=== Einstellungen ===
Unter diesem Punkt öffnet sich eine sehr umfangreiche Konfigurationsseite mit vielen Einstellungsmöglichkeiten, die in aller Ausführlichkeit im [[Webtrees_Handbuch/Anleitung_f%C3%BCr_Verwalter#Einstellungen|gleichnamigen Verwalter-Abschnitt]] dargestellt werden. Hier beschränkt sich die Darstellung auf die Optionen für die Mediendateien und insbesondere für den Medienordner.

[[Datei:Webtrees Verwaltung-Stammbaeume Einstellungen Medienordner und Mediendateien.png|alternativtext=Stammbaum-Einstellungen für Medienordner und Mediendateien|thumb|350px|Stammbaum-Einstellungen für Medienordner und Mediendateien]]
Unter "'''Medienordner'''" wird das Stammverzeichnis für alle Mediendateien dieses Stammbaums festgelegt. Er befindet sich unterhalb des durch den Administrator festgelegten [[Webtrees Handbuch/Anleitung für Administratoren/Webseite#Datenverzeichnis|Datenverzeichnisses]]. Es lassen sich die Medien von mehreren installierten Stammbäumen in verschiedenen Ordnern getrennt verwalten.

Zum Umgang mit "'''Mediendateien'''" kann per Auswahlfeld festgelegt werden, wer Dateien in den Stammbaum hochladen darf und wer einen Downloadlink angezeigt bekommen soll.
{{-}}

=== Löschen ===
[[Datei:WT 2.1 Verwaltung-Stammbaeume loeschen.png|alternativtext=Stammbäume löschen|thumb|left|350px|Stammbäume löschen]]
Durch Anklicken der Option "'''Löschen'''", wird der Vorgang direkt gestartet. Sie erhalten jedoch eine Abfrage, ob Sie den Baum wirklich löschen wollen, sofern Sie die Abfragen nicht unterdrückt haben.

Die Option wird nicht angezeigt, wenn nur ein Stammbaum existiert.
{{-}}

=== Als Standard setzen ===
[[Datei:WT 2.1 Verwaltung-Stammbaeume Standardstammbaum.png|alternativtext=Stammbäume verwalten Standardstammbaum|thumb|100px|Stammbäume verwalten Standardstammbaum]]
Wenn mehrere Stammbäume angelegt sind, können Sie mit diesem Link "Als Standard setzen" jeweils einen Baum zum '''Standardstammbaum''' machen. Beim jeweiligen Baum steht dann der Text "Standardstammbaum" und ist nicht klickbar. Der Standardstammbaum wird auf der Startseite und bei der Stammbaumverwaltung immer zuerst angezeigt.
{{-}}

[[Kategorie:Webtrees]]

Webtrees Handbuch/Anleitung für Administratoren/Multimedia

2023-03-14T20:38:21Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Abschnitt 7.5|info=1}}{{WT-Inhaltsverzeichnis|Kapitel 7|C|Abschnitt 7.5}}

[[Datei:WT_2.0_Multimedia.png|thumb|left|300px|Verwaltung Abschnitt Multimedia]]
Mit den unter "Multimedia" bereitgestellten Werkzeugen lassen sich die Medienobjekte verwalten. In einer GEDCOM-Datei werden diese als OBJE-Datensätze abgelegt. Die in den Medienobjekten referenzierten Dateien, etwa Fotos, Dokumente oder Audioaufzeichnungen liegen außerhalb der GEDCOM-Datei im [[Webtrees Handbuch/Anleitung für Administratoren/Stammbäume#Einstellungen|Medienordner]] auf dem webtrees-Server.

Mediendateien können ein beliebiges Format haben, es gibt keine Einschränkungen, allerdings werden sie abhängig vom verwendeten Browser ggf. unterschiedlich gut unterstützt. Folgende Typen von Mediendateien werden häufig verwendet
* Fotos: Die am häufigsten verwendete Form von Mediendateien sind sicherlich Fotos. Auf Fotos abgebildet findet man Personen, Grabsteine, Dokumente, Kirchenbuchseiten, etc. Bei doppelseitigen Dokumenten kann man die Fotos von Vorder- und Rückseite in einem Medienobjekt zusammenpacken, was auch für Familienbilder möglich ist, die auf der Rückseite beschriftet worden sind. Unterstützte Dateiformate sind jpg, png, und einige weitere.
* Dokumente im jpg-, png- oder pdf-Format können amtliche Dokumente oder mehrseitige Werke, wie Buchauszüge oder Berichte, sowie Ahnenpässe sein. Da es für pdf-Dokumente kein Vorschaubild gibt, kann man ein Foto, etwa der Titelseite, anfertigen und dieses zusammen mit dem pdf-Dokument in einem Medienobjekt speichern.
* Urkunden stammen in der Regel aus den Standesaufzeichnungen oder Ausbildungs- und Berufsabschnitten und kommen ebenfalls oft im jpg-, png- oder pdf-Format vor.
* Audio- und Videodateien können z.B. zur Interviewaufzeichnung mit älteren Familienmitgliedern eingebunden und von webtrees wiedergegeben werden. Auch hier bietet es sich an, ein Vorschaubild anzufertigen und mit in das Medienobjekt zu packen.

Die im Screenshot gezeigten Aktionen werden in den nachfolgenden Abschnitten erläutert.
{{-}}

== Medien verwalten ==
[[Datei:WT_2.0_Multimedia-Medien-verwalten.png|thumb|right|400px|Verwaltung Multimedia - Medien verwalten]]
Hier werden sämtliche Mediendateien aufgelistet. Sie lassen sich grob gruppieren nach
# lokalen,
# externen und
# nicht benutzten Dateien.

Weitere Möglichkeiten die Ergebnisliste zu begrenzen, sind durch Einschränkung auf bestimmte lokale Medien- bzw. Speicherpfade unter Einbeziehung oder Ausschluss der Unterverzeichnisse und einem benutzerdefinierten Text-Filter (beispielsweise durch die Angabe einer Dateiendung) möglich.

In der Ergebnisliste werden der Mediendateipfad, ein Vorschaubild und in der Spalte Medienobjekt der Medientitel mit ggf. vorhandener Notiz und Links zu den verknüpften Datensätzen angezeigt. Jede Zeile repräsentiert ein Medienobjekt pro Stammbaum, dass heißt: wird eine Datei in mehreren Stammbäumen genutzt, erscheint diese Datei auch in mehreren Zeilen. Die Zuordnung zum jeweiligen Stammbaum ist lediglich über den Link des verknüpfen Datensatzes erkennbar.

Über die Gruppierung "nicht benutzte Dateien" werden auf dem Server vorhandene Dateien aufgelistet, die nicht in einem Medienobjekt referenziert werden. Ein Löschen möglicherweise überflüssiger Dateien oder das Erstellen von Medienobjekten für einen Stammbaum ist dann möglich.

{{-}}

== Mediendateien hochladen ==
[[Datei:WT_2.0_Multimedia-Mediendateien-hochladen.png|thumb|left|350px|Verwaltung Multimedia - Mediendateien hochladen]]
Mit diesem Formular ist es webgestützt möglich - alternativ zu einem FTP-Upload - in einem Arbeitsschritt bis zu zehn Dateien vom lokalen Rechner auf den Server zu laden. Dabei kann der Ziel-Verzeichnispfad und ggf. ein von der Quell-Datei abweichender Dateiname angegeben werden.

Die hochgeladenen Dateien lassen sich dann in einem gesonderten Arbeitsschritt mittels des Formulars [[#Medien_verwalten|Medien verwalten]] und Gruppieren nach "nicht benutzten Dateien" entsprechend mit Medienobjekten und Stammbäumen verknüpfen.

Alternativ können Mediendateien auch direkt beim Erzeugen eines Medienobjekts durch Mitglieder hochgeladen werden.

Die maximale Größe zum Hochladen der Dateien kann im Wesentlichen durch entsprechendes Setzen der php.ini-Direktiven [https://www.php.net/manual/de/ini.core.php#ini.upload-max-filesize upload_max_filesize] und [https://www.php.net/manual/de/ini.core.php#ini.post-max-size post_max_size] durch den Webmaster konfiguriert werden.<ref>Vgl. auch PHP-Handbuch > Features > Steuerung von Dateiuploads > Häufige Probleme: https://www.php.net/manual/de/features.file-upload.common-pitfalls.php.</ref>{{-}}

== Medienobjekte mit Tatsachen und Ereignissen verknüpfen ==
[[Datei:WT_2.0_Multimedia-Medienobjekte-verknuepfen.png|thumb|left|350px|Verwaltung Multimedia - Medienobjekte mit Tatsachen und Ereignissen verknüpfen]]
Dieses Werkzeug erlaubt es mit einer Personen verbundene Medienobjekte alternativ mit einer Tatsache oder einem Ereignis, das der jeweiligen Person zugeordnet ist, zu verknüpfen. Auf diese Weise kann es, falls erforderlich, so an die richtige Stelle verschoben werden. Für diese Neu-Verknüpfung muss man lediglich auf einen der in der Spalte "Tatsachen und Ereignisse" aufgeführten Buttons klicken.

Zu den aufgelisteten Medienobjekten werden als Informationen der Stammbaum, ein Vorschaubild, der Titel des Medienobjekts (Link) und eine verknüpfte Person (auch als Link) mit angezeigt. Die Liste kann über einen benutzerdefinierten Text-Filter auf das Titelfeld eingeschränkt werden.
{{-}}

== Benutzerdefinierte Vorschaubilder aus webtrees 1 importieren ==
[[Datei:WT_2.0_Multimedia-Vorschaubilder-WT1-importieren.png|alternativtext=Verwaltung - Benutzerdefinierte Vorschaubilder aus webtrees 1 importieren|thumb|right|350px|Verwaltung - Benutzerdefinierte Vorschaubilder aus webtrees 1 importieren]]

In webtrees Version 1.x konnte man durch das Erstellen von Dateien im Ordner "[[Webtrees Handbuch/Anleitung für Administratoren/Stammbäume#Einstellungen|Medienordner]]/thumbs" benutzerdefinierte Vorschaubilder zu Medienobjekten hinzufügen.<ref>Die Möglichkeit benutzerdefinierter Vorschaubilder wurde insbesondere für PDF-Dateien oft genutzt.</ref> In webtrees ab Version 2.0 werden benutzerdefinierte Vorschaubilder als eine zweite Mediendatei im gleichen Medienobjekt abgelegt.

Die gefundenen Dateien und Informationen werden in einer Tabelle dargestellt
# das '''Vorschaubild''',
# eine korrespondierende '''Mediendatei''' (sofern vorhanden),
# der Verweis zum passenden '''Medienobjekt''',
# Übereinstimmungswert in Prozent vom '''Vergleich''' der beiden Bilddateien und
# '''Aktion'''s-Schaltflächen (löschen und ggf. hinzufügen).

Sollte das Miniaturbild mit dem Originalbild (nahezu) identisch sein, wird es nicht mehr benötigt und sollte gelöscht werden. Wenn das Miniaturbild ein benutzerdefiniertes Bild ist, sollten Sie es zum Medienobjekt hinzufügen.

Sind die Dateien (nahezu) identisch oder gibt es kein Medienobjekt, wird der Löschen-Knopf optisch hervorgehoben oder ist als einzige Aktion verfügbar, ansonsten ist der Hinzufügen-Knopf hervorgehoben.{{-}}

== Einzelnachweise ==
<references />

[[Kategorie:Webtrees]]

Webtrees Handbuch/Anleitung für Administratoren/Module

2023-03-14T20:38:11Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Abschnitt 7.4|info=1}}{{WT-Inhaltsverzeichnis|Kapitel 7|C|Abschnitt 7.4}}

[[Datei:WT 2.1 Verwaltung-Module.png|alternativtext=Verwaltung - Menü Module|thumb|center|350px|Verwaltung - Menü Module]]
In der ersten Zeile dieses Abschnitts steht die Gesamtzahl der aktuell aktivierten und der in der konkreten Installation verfügbaren Module.

Mit dem obersten Menüpunkt "Alle Module" kann man sich eine Listenansicht aller verfügbaren Module anzeigen lassen.

Darunter folgen in sechs Kategorien die Verwaltungsfunktionen für die Module, die als Links ausgeführt sind. Neben den Links stehen die Anzahl der aktivierten und verfügbaren Module in der jeweiligen Kategorie. Die Kategorien sind wie folgt unterteilt:
*[[#Webseite|'''Webseite''']]
**[[#Fußzeilen|Fußzeilen]] - zur Verwaltung der Fußzeilen Darstellung und Inhalte
** [[#Tracking- und Analyse|Tracking- und Analyse]] - zur statistischen Analyse des Besucherverhaltens
** [[#Themen|Themen]] - Module für verschiedene Layoutvorlagen der Bedienoberfläche von webtrees
** [[#Sprachen-Module|Sprachen]] - zur Aktivierung und Deaktivierung verfügbarer Sprachen
*[[#Startseite|'''Startseite''']]
** [[#Blöcke|Blöcke]] - zur Festlegung des Standard-Layouts auf der Startseite neuer Benutzer
*[[#Geografische Daten|'''Geografische Daten''']]
** [[#Automatisch vervollständigen|Automatisch vervollständigen]] -
** [[#Geolokalisierung|Geolokalisierung]] -
** [[#Kartenlinks|Kartenlinks]] -
** [[#Kartenanbieter|Kartenanbieter]] -
*[[#Genealogie|'''Genealogie''']]
** [[#Menüs|Menüs]] - für die Funktionen im Hauptmenü
** [[#Diagramme|Diagramme]] - für die grafische Darstellung von genealogischen Daten
** [[#Listen|Listen]] - für die Darstellungen von genealogischen Daten in Listenform
** [[#Berichte|Berichte]] - für genealogische Berichte
** [[#Datenkorrekturen|Datenkorrekturen]] -
*[[#Personenseite|'''Personenseite''']]
** [[#Reiter|Reiter]] - für die linke Spalte im Hauptteil
** [[#Navigationsleisten|Navigationsleisten]] - für die rechte Spalte im Hauptteil
** [[#Historische Ereignisse|Historische Ereignisse]] - die den Lebenslauf einer Person mit historischen Daten unterlegen und so eine historische Einordnung erlauben
** [[#Geteiltes|Geteiltes]] -
*[[#Sonstiges|'''Sonstiges''']]
** [[#Alte Internetadressen (URLs)|Alte Internetadressen (URLs)]]
** [[#Check for new version|Check for new version]]
** [[#CKEditor™|CKEditor™]]
** [[#CSS und JS|CSS und JS]]
** [[#Sitemaps|Sitemaps]]
** [[#Volkszählungsassistent|Volkszählungsassistent]]

{{-}}
{{WT-ToDo|in der obigen Übersicht noch die Spiegelstriche kurz erläutern, wo dies fehlt}}

== Alle Module ==
[[Datei:WT 2.1 Verwaltung-Module-Alle Module.png|alternativtext=Verwaltung - Auflistung aller verfügbaren Module|thumb|350px|Verwaltung - Auflistung aller verfügbaren Module]]
Alle verfügbaren Module werden hier tabellarisch aufgelistet. Die Spalten haben folgende Bedeutung.
* Modul - Name des Moduls
* Aktiviert - Checkbox zum De-/Aktivieren des Moduls
* Beschreibung - erläutert kurz den Zweck des Moduls
* Kategorien - zeigen die Zuordnung der Module zu folgenden Gruppen
*# Einstellungen
*# Menüs
*# Reiter
*# Navigationsleisten
*# Blöcke
*# Diagramme
*# Listen
*# Berichte
*# Fußzeilen
*# Tracking und Analyse
*# Historische Ereignisse
*# Themen
*# Sprachen

Bis auf die Spalte "Beschreibung" kann die Tabelle durch Klicken auf den Spaltenkopf sortiert werden. Die Sortierung wirkt sich aber nur auf aktivierte Module aus.
[[Datei:WT 2.1 Verwaltung-Module Ausschnitt.png|alternativtext=Verwaltung - Ausschnitt aus der Tabelle aller Module|thumb|350px|Verwaltung - Ausschnitt aus der Tabelle aller Module]]
Man kann sich hier einen Überblick verschaffen, welche Module installiert sind und in welchen Bereichen bzw. Kategorien der Website sich diese auswirken. Auch ist aus der Tabelle ersichtlich, dass manche Module in mehreren Bereichen Funktionen bereitstellen wie etwa das [[Webtrees_Handbuch/Anleitung_für_Besucher#Interaktives_Sanduhrdiagramm|"Interaktive Sanduhrdiagramm"]] (Reiter und Diagramme) oder die [[Webtrees_Handbuch/Anleitung_für_Besucher#Geschichten|"Geschichten"]] (Menü und Reiter). Die Tabelle enthält sowohl alle Standard-Module des webtrees Kerns, als auch zusätzlich installierte [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodule]].

Über ein aktiviertes Schraubenschlüssel-Symbol können modulspezifische Konfigurationen auf weiteren Unterseiten erreicht werden.
{{-}}
[[Datei:WT 2.1 Verwaltung-Modul deaktiviert.png|alternativtext=Verwaltung - Bestätigung nachdem ein Modul deaktiviert wurde|thumb|350px|Verwaltung - Bestätigung nachdem ein Modul deaktiviert wurde]]
Wenn Sie Module aktiviert oder deaktiviert haben, '''vergessen Sie nicht das Speichern''' Ihrer Änderungen durch einen ''Klick'' auf die Schaltfläche <code style="background-color: blue; color: #fff;">Speichern</code> am unteren Seitenende! Danach erhalten Sie eine entsprechende Meldung.
{{-}}
[[Datei:WT 2.1 Verwaltung-Module Einstellungen loeschen.png|alternativtext=Verwaltung - Hinweis auf nicht mehr vorhandene Module|thumb|350px|Verwaltung - Hinweis auf nicht mehr vorhandene Module]]
Wenn es in der Datenbank Einträge zu einem Modul gibt, das nicht mehr installiert ist, dann erscheint oberhalb der Tabelle ein entsprechender Hinweis mit der Möglichkeit diese Einträge aus der Datenbank zu entfernen.
{{-}}

== Webseite ==
Hier werden Module mit Gültigkeit für die ganze [[Webtrees Handbuch/Anleitung für Administratoren/Webseite|Webseite]] verwaltet.

{{-}}

=== Fußzeilen ===
[[Datei:WT 2.1 Verwaltung-Module Fusszeilen.png|alternativtext=Verwaltung - Konfiguration der Fußzeilen|thumb|350px|Verwaltung - Konfiguration der Fußzeilen]]
[[Datei:WT 2.1 Verwaltung-Module Fusszeilen Beispiel.png|alternativtext=Verwaltung - Beispiel für Fußzeilen|thumb|350px|Verwaltung - Beispiel für Fußzeilen]]
webtrees bietet die Möglichkeit, auf den Webseiten automatisch Fußzeilen zu generieren und anzuzeigen. Zur Verfügung stehen die nachfolgenden vier Makros. Sie können in gewünschter Reihenfolge nach oben oder unten verschoben werden.

* '''Unterstützt von webtrees™''' - Logo von und Link zur Webseite von webtrees
* '''Kontaktangaben''' - wer für Fragen kontaktiert werden kann
* '''Besucherzähler''' - zeigt die Anzahl der Klicks seit die jeweilige Seite angelegt wurde
* '''Datenschutzerklärung''' - ist ein Link auf eine weitere Seite. Der Inhalt ist abhängig vom jeweiligen Land und liefert einen vorgefertigten Text. Dieser Text kann unter Nutzung eines [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmoduls]] auch angepasst werden.

{{-}}

=== Tracking- und Analyse ===
[[Datei:WT 2.1 Verwaltung-Module Tracking und Analyse.png|alternativtext=Verwaltung - Funktionen für Tracking und Analyse|thumb|350px|Verwaltung - Funktionen für Tracking und Analyse]]
Unter diesem Menüpunkt stehen Module zur Verfügung, die zur statistischen Analyse des Besucherverhaltens dienen. Sie nutzen bekannte Online-Dienste; dort muss jeweils ein Konto angelegt und mit dem Modul in webtrees verknüpft werden (Schaltfläche mit dem Werkzeugschlüssel). Die Module können aktiviert und deaktiviert werden. Weitere Hinweise finden sich auf den angegebenen Webseiten und im Abschnitt "[[Webtrees Handbuch/Anleitung für Webmaster#Nachverfolgungs- und Analyse-Dienste|Nachverfolgungs- und Analyse-Dienste]]" im Kapitel "[[Webtrees Handbuch/Anleitung für Webmaster|Anleitung für Webmaster]]".

{{-}}

=== Themen ===
In diesem Menüpunkt werden Themen verwaltet, die zum Kern von webtrees gehören und auch [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodule]], die zusätzliche Themen bereit stellen. Alle Themen können einzeln aktiviert und deaktiviert werden. Einige der Themen, die zu den [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodulen]] gehören, lassen sich durch einen Klick auf den "Schraubenschlüssel" hinter dem Modulnamen auf den zugehörigen Unterseiten konfigurieren.

Wenn kein einziges Modul aktiviert wird, wird immer das Standardthema "webtrees" verwendet. Wenn nur ein Thema aktiviert ist, muss darauf geachtet werden, dass es identisch ist mit dem Standardthema der Webseite.
(siehe Unterabschnitt "[[Webtrees Handbuch/Anleitung für Administratoren/Webseite#Standardthema|Standardthema]]" im Abschnitt "Einstellungen Webseite"). Dann wird nur dieses Thema verwendet und für die Benutzer erscheint kein Auswahlmenü für andere Themen
(siehe Kapitel "[[Webtrees Handbuch/Anleitung für Besucher#Thema|Anleitung für Besucher]]"). Sobald zwei oder mehr Themen aktiviert sind, können die Nutzer wählen, welches Thema sie verwenden möchten.

{{-}}

=== Sprachen-Module ===
Hier können alle in webtrees verfügbaren Sprachen einzeln aktiviert oder deaktiviert werden.

Wenn hier keine einzige Sprache aktiviert ist, wird immer das englischsprachige Modul verwendet. Damit für die Nutzer ein Sprachauswahlmenü angezeigt wird
(siehe entsprechender Abschnitt im Kapitel "[[Webtrees Handbuch/Anleitung für Besucher#Sprache|Anleitung für Besucher]]"),
müssen mindestens zwei Sprachen aktiviert sein.

{{-}}



== Startseite ==
Die Startseite ist der Ausgangspunkt für alle Stammbaum-Aktivitäten. Für jeden angelegten Stammbaumbaum gibt es eine eigene Startseite, die alle Besucher dieser Seite sehen, unabhängig von ihren Berechtigungen (natürlich nur dann, wenn der Stammbaum für Besucher überhaupt freigeschaltet ist).
[[Datei:WT 2.1 Meine Seiten-Menue-Diese Seite anpassen.png|alternativtext=Meine Seiten - Diese Seite anpassen|thumb|350px|Meine Seiten - Diese Seite anpassen]]
Zusätzlich gelangen alle Benutzer nach der Anmeldung auf eine persönliche Seite, die sie selbst anpassen können. Diese Seite erreicht man, wenn man im Kopfmenü "Meine Seiten" den Menüpunkt "Meine Seite" auswählt. Diese persönliche Seite eignet sich gut dafür Nachrichten und Forschungsaufgaben aber auch Auswertungen zu verwalten (Auswahl siehe nachfolgende Tabelle).

{{-}}

=== Blöcke ===
Unter diesem Menüpunkt geht es nur um die prinzipielle Bereitstellung der Blöcke. Einsatz und Konfiguration kann man unter "[[Webtrees Handbuch/Anleitung für Administratoren/Stammbäume#Standardbl.C3.B6cke%20f.C3.BCr%20neue%20Stammb.C3.A4ume%20festlegen|Standardblöcke für neue Stammbäume festlegen]]" nachlesen.

webtrees bietet Administratoren und Benutzern mit den Blöcken Gestaltungsmöglichkeiten und Informationsausgaben für die Startseite und die individuellen "Meine Seiten". Im Standard werden 23 Blöcke ausgeliefert; davon sind drei Blöcke nur für die Startseite, fünf Blöcke nur für "Meine Seite" und die übrigen 15 Blöcke für beide Seitenarten vorgesehen.

Der Block "Neuigkeiten" kann nur auf der "Startseite" und der Block "Journal" nur auf "Meine Seite" verwendet werden. Sie haben zwar die gleiche Funktionalität, werden jedoch entsprechend ihres Titels für einen unterschiedlichen Zweck eingesetzt.

Die Blöcke kommen an mehreren Stellen zum Einsatz:
* als [[Webtrees Handbuch/Anleitung für Administratoren/Stammbäume#Standardbl.C3.B6cke_f.C3.BCr_neue_Stammb.C3.A4ume_festlegen|Standardblöcke für neue Stammbäume festlegen]] durch den Administrator
* als [[Webtrees Handbuch/Anleitung für Administratoren/Benutzer#Standardbl.C3.B6cke_f.C3.BCr_neue_Benutzer_festlegen|Standardblöcke für neue Benutzer festlegen]] durch den Administrator
* als Blöcke für die [[Webtrees_Handbuch/Anleitung_für_Verwalter#Startseite|Startseite]] je Stammbaum durch den Verwalter
* als Blöcke für [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Meine_Seiten|Meine Seite]] durch angemeldete Benutzer

Die nachfolgende Tabelle enthält eine Kurzbeschreibung für jeden Block.

{{-}}

{| class="wikitable sortable" style="width:100%;"
|+ Verwaltung - Blöcke
|-
!Blockname
!Kurzbeschreibung des Blocks
!Verwendung
|-
|An diesem Tag || Auflistung der Jubiläen am heutigen Tag || [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Meine_Seiten|Meine Seite]] + Startseite
|-
|Änderung der Layoutvorlage || alternative Möglichkeit, eine neue Layoutvorlage zu wählen || [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Meine_Seiten|Meine Seite]] + Startseite
|-
|Anmelden || alternative An- oder Abmeldemöglichkeit || [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Meine_Seiten|Meine Seite]] + Startseite
|-
|Anstehende Ereignisse || Auflistung von Jubiläen in der nächsten Zeit || [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Meine_Seiten|Meine Seite]] + Startseite
|-
|Ausstehende Änderungen || Auflistung der Änderungen, die die Zustimmung des Moderators brauchen, sowie E-Mail-Benachrichtigungen || [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Meine_Seiten|Meine Seite]] + Startseite
|-
|Diagramme || alternative Möglichkeit, zur Anzeige von Diagrammen || [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Meine_Seiten|Meine Seite]] + Startseite
|-
|Diashow || Zufallsbilder aus dem aktuellen Stammbaum || [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Meine_Seiten|Meine Seite]] + Startseite
|-
|Favoriten || Auflistung der Favoriten auf der Startseite des Stammbaums || Startseite
|-
|Favoriten || Auflistung der Favoriten auf der "Meine Seite" eines Benutzers || [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Meine_Seiten|Meine Seite]]
|-
|Forschungsaufgaben || Auflistung der Aufgaben, die in dem Stammbaum hinterlegt sind || [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Meine_Seiten|Meine Seite]] + Startseite
|-
|Häufigst gesehene Seiten || Auflistung der am häufigst angesehenen Seiten || Startseite
|-
|Häufigste Nachnamen || Auflistung der häufigsten Nachnamen || [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Meine_Seiten|Meine Seite]]+ Startseite
|-
|Häufigste Vornamen || Auflistung der häufigsten Vornamen || [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Meine_Seiten|Meine Seite]] + Startseite
|-
|HTML || Freie Gestaltung eigener Texte und Grafiken mit Informationen aus dem Stammbaum, Beschreibung siehe unten || Meine Seite + Startseite
|-
|Journal || vertraulicher Bereich für Notizen oder ein Journal || [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Meine_Seiten|Meine Seite]]
|-
|Meine Seite || Begrüßungsnachricht für Mitglieder || [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Meine_Seiten|Meine Seite]]
|-
|Nachrichten || E-Mail-System zum Senden und Empfangen von Nachrichten mit anderen Nutzern innerhalb von webtrees || [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Meine_Seiten|Meine Seite]]
|-
|Neueste Änderungen || Auflistung der zuletzt aktualisierten Datensätze || [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Meine_Seiten|Meine Seite]] + Startseite
|-
|Neuigkeiten || Auflistung von Neuigkeiten mit frei wählbarem Inhalt || [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Meine_Seiten|Meine Seite]]
|-
|Startseite || Begrüßungsnachricht für Besucher || Startseite
|-
|Statistiken || vordefinierte Auswahl statischtischer Ereignisse im Stammbaum || [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Meine_Seiten|Meine Seite]] + Startseite
|-
|Wer ist online || Auflistung von Benutzern, die gerade angemeldet sind || [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Meine_Seiten|Meine Seite]] + Startseite
|-
|Yahrzeiten || Auflistung der kurz bevorstehenden hebräischen Todestage || [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Meine_Seiten|Meine Seite]] + Startseite
|-
|}

{{-}}

[[Datei:WT 2.1 Verwaltung-Module Bloecke.png|alternativtext=Verwaltung - Konfiguration der Blöcke|thumb|350px|Verwaltung - Konfiguration der Blöcke]]
Auf der Seite Blöcke können in der Spalte "'''Aktiviert'''" einzelne Blöcke de-/aktiviert werden. Damit wird gesteuert, ob sie auf den Seiten zur Blockauswahl verfügbar sind.

{{-}}
[[Datei:WT 2.1 Verwaltung-Module Bloecke Zugriffsrechte.png|alternativtext=Verwaltung - Zugriffsrechte der Blöcke|thumb|350px|Verwaltung - Zugriffsrechte der Blöcke]]
Über den Stift in der rechten Spalte unter "'''Zugriffsrechte'''" gelangt man auf die Einstellungsmaske der Zugriffsrechte für jeden einzelnen Stammbaum. Je Stammbaum kann die Sichbarkeit definiert werden von niedrigem zu hohem Schutz für "Besucher", "Mitglieder", "Verwalter" oder "niemand".
{{-}}

== Geografische Daten ==
In diesem Abschnitt sind alle Dienste zusammengefasst, mit denen sich die in webtrees verwendeten Ereignisorte lokalisieren und präzisieren lassen.

{{-}}

=== Automatisch vervollständigen ===
[[Datei:WT 2.1 Verwaltung-Module Geografische Daten Automatisch vervollstaendigen.png|alternativtext=Verwaltung - Module zum automatischen Vervollständigen geografischer Daten|thumb|350px|Verwaltung - Module zum automatischen Vervollständigen geografischer Daten]]
In diesem Konfigurationsmenü stehen Module bereit, mit denen die automatische Vervollständigung von '''Ortsnamen''' unterstützt wird. Mit den Checkboxen lassen sich die Module aktivieren und deaktivieren.

Nach der erfolgreichen Einrichtung werden für die Ortsangaben von Ereignissen Vorschläge in der Datenbank gesucht und angezeigt, sofern keine passenden Einträge in der eigenen Ortsdatenbank gefunden werden.
{{-}}
[[Datei:WT 2.1 Verwaltung-Module Geografische Daten Automatisch vervollstaendigen Bestaetigung.png|alternativtext=Verwaltung - Bestätigung für die Aktivierung eines Moduls zum automatischen vervollständigen|thumb|350px|Verwaltung - Bestätigung für die Aktivierung eines Moduls zum automatischen vervollständigen]]
Nach dem Speichern wird das Aktivieren eines Moduls durch eine Meldung bestätigt. Der Schraubenschlüssel hinter dem Namen erhält einen Link. Auf einer weiteren Konfigurationsseite können Einstellungen vorgenommen werden.
{{-}}
[[Datei:WT 2.1 Verwaltung-Module Geografische Daten GeoNames.png|alternativtext=Verwaltung - Einstellung für das Modul GeoNames|thumb|350px|Verwaltung - Einstellung für das Modul GeoNames]]
Um '''GeoNames'''<ref>https://www.geonames.org/login</ref> nutzen zu können, müssen Sie ein gültiges Benutzerkonto haben und den Benutzernamen hier eingeben. Weitere Informationen finden Sie auf der angegebenen Webseite.
{{-}}
[[Datei:WT 2.1 Verwaltung-Module Geografische Daten OpenRouteService.png|alternativtext=Verwaltung - Einstellung für das Modul OpenRouteService|thumb|350px|OpenRouteService]]
Um '''OpenRouteService'''<ref>https://openrouteservice.org/dev</ref> nutzen zu können, müssen Sie einen API-Schlüssel haben und hier eingeben. Weitere Informationen finden Sie auf der angegebenen Webseite.

{{-}}

=== Geolokalisierung ===
[[Datei:WT 2.1 Verwaltung-Module Geografische Daten Geolokalisierung.png|alternativtext=Einstellungen für die Vervollständigung von Ortkoordinaten|thumb|350px|Einstellungen für die Vervollständigung von Ortkoordinaten]]
In diesem Konfigurationsmenü stehen Module bereit, mit denen die automatische Vervollständigung von '''Ortskoordinaten''' unterstützt wird. Mit den Checkboxen lassen sich die Module aktivieren und deaktivieren. Nach dem Speichern wird das Aktivieren eines Moduls durch eine Meldung bestätigt. Der Schraubenschlüssel hinter dem Namen erhält einen Link. Auf einer weiteren Konfigurationsseite können Einstellungen vorgenommen werden.

Nach der erfolgreichen Einrichtung werden für die Ortsangaben von Ereignissen die Koordinaten in der Datenbank gesucht und übernommen.

Um '''GeoNames''' nutzen zu können, müssen Sie wie im vorigen Abschnitt unter "'''Automatisch vervollständigen'''" ein gültiges Benutzerkonto haben und den Benutzernamen hier eingeben. Weitere Informationen finden Sie auf der angegebenen Webseite.

Um '''OpenRouteService''' nutzen zu können, müssen Sie wie im vorigen Abschnitt unter "'''Automatisch vervollständigen'''" einen API-Schlüssel haben und hier eingeben. Weitere Informationen finden Sie auf der angegebenen Webseite.
{{-}}

=== Kartenlinks ===
[[Datei:WT 2.1 Verwaltung-Module Geografische Daten Kartenlinks.png|alternativtext=Auswahl der zur Verfügung stehenden Kartenlinks|thumb|350px|Auswahl der zur Verfügung stehenden Kartenlinks]]
Auf dieser Seite wird festgelegt, welche "'''Kartenlinks'''" verfügbar sein sollen, um Ereignisorte auf Karten anzuzeigen. Hierzu können die Checkboxen in der Spalte "Aktiviert" entsprechend gesetzt werden.
{{-}}

=== Kartenanbieter ===
[[Datei:WT 2.1 Verwaltung-Module Geografische Daten Kartenanbieter.png|alternativtext=Auswahl der zur Verfügung stehenden Kartenanbieter|thumb|350px|Auswahl der zur Verfügung stehenden Kartenanbieter]]
Auf dieser Seite wird festgelegt, welche "'''Kartenanbieter'''" verfügbar sein sollen, um Ereignisorte auf Karten anzuzeigen. Hierzu können die Checkboxen in der Spalte "Aktiviert" entsprechend gesetzt werden.

Etliche Kartenanbieter setzen voraus, dass man sich für die Nutzung registrieren und einen API-Schlüssel erzeugen muss. Dieser Schlüssel muss vom Administrator dann in webtrees hinterlegt werden indem man auf den Schraubenschlüssel hinter dem Kartendienst klickt.

{{WT-ToDo|Noch beschreiben: wofür ist welcher Kartenanbieter gut, welche Daten werden ggf. an wen übertragen?

Wo kann der Nutzer aus den hier aktivierten Anbietern seine Wahl zur Darstellung treffen? Screenshot!}}

{{-}}

== Genealogie ==
In diesem Abschnitt sind alle Werkzeuge zu finden, mit denen die in webtrees gespeicherten genealogischen Daten aufgerufen, in grafischer oder tabellarischer Form angezeigt, gedruckt oder korrigiert werden können.

{{-}}

=== Menüs ===
[[Datei:WT 2.1 Verwaltung-Module Genealogie Menues.png|alternativtext=Einstellung der verfügbaren Menüs in der Kopfzeile|thumb|350px|Einstellung der verfügbaren Menüs in der Kopfzeile]]
Auf dieser Seite wird festgelegt, welche "'''Menüs'''" im [[Webtrees_Handbuch/Anleitung_für_Besucher#Hauptmen.C3.BC|Hauptmenü]] enthalten sein sollen. Hierzu können die Checkboxen in der Spalte "Aktiviert" gesetzt und mit den Pfeilen die Reihenfolge im Hauptmenü bestimmt werden.

Dabei ist zu beachten, dass das Ausblenden eines Menüs bzw. Anzeigen ab einer definierten Rollenzugehörigkeit noch nicht die im Menü enthaltenen Funktionen auch vor dem Zugriff schützt. Dies geschieht an anderen Stellen: Soll beispielsweise der Zugriff auf das "[[Webtrees_Handbuch/Anleitung_für_Besucher#Interaktives_Sanduhrdiagramm|Interaktive Sanduhrdiagramm]]" eingeschränkt werden, muss dies bei den [[#Diagramme|Diagramme]]- und [[#Reiter|Reiter]]-Modulen geschehen.
{{-}}

=== Diagramme ===
[[Datei:WT 2.1 Verwaltung-Module Genealogie Diagramme.png|alternativtext=Einstellung der im Menü verfügbaren Diagramme|thumb|350px|Einstellung der im Menü verfügbaren Diagramme]]
Auf dieser Seite wird festgelegt, welche "'''Diagramme'''" im [[Webtrees_Handbuch/Anleitung_für_Besucher#Diagramme|zugehörigen Menü]] enthalten sein sollen. Hierzu können die Checkboxen in der Spalte "Aktiviert" gesetzt werden. Die Zugriffsrechte können über das Bearbeitungssymbol aufgerufen und für jeden vorhandenen Stammbaum separat eingestellt werden.

{{-}}

=== Listen ===
[[Datei:WT 2.1 Verwaltung-Module Genealogie Listen.png|alternativtext=Einstellung der im Menü verfügbaren Listen|thumb|350px|Einstellung der im Menü verfügbaren Listen]]
Auf dieser Seite wird festgelegt, welche "'''Listen'''" im [[Webtrees_Handbuch/Anleitung_für_Besucher#Listen|zugehörigen Menü]] enthalten sein sollen. Hierzu können die Checkboxen in der Spalte "Aktiviert" gesetzt werden. Die Zugriffsrechte können über das Bearbeitungssymbol aufgerufen und für jeden vorhandenen Stammbaum separat eingestellt werden.

{{-}}

=== Berichte ===
[[Datei:WT 2.1 Verwaltung-Module Genealogie Berichte.png|alternativtext=Einstellung der im Menü verfügbaren Berichte|thumb|350px|Einstellung der im Menü verfügbaren Berichte]]
Auf dieser Seite wird festgelegt, welche "'''Berichte'''" im [[Webtrees_Handbuch/Anleitung_für_Besucher#Berichte|zugehörigen Menü]] enthalten sein sollen. Hierzu können die Checkboxen in der Spalte "Aktiviert" gesetzt werden. Die Zugriffsrechte können über das Bearbeitungssymbol aufgerufen und für jeden vorhandenen Stammbaum separat eingestellt werden.

{{-}}

=== Datenkorrekturen ===
[[Datei:WT 2.1 Verwaltung-Module Genealogie Datenkorrekturen.png|alternativtext=Einstellung der in der Stammbaumverwaltung verfügbaren Korrekturfunktionen|thumb|350px|Einstellung der in der Stammbaumverwaltung verfügbaren Korrekturfunktionen]]
Auf dieser Seite wird festgelegt, welche "'''[[Webtrees Handbuch/Anleitung für Verwalter#Datenkorrekturen|Datenkorrekturen]]'''" in der Stammbaumverwaltung verfügbar sein sollen. Hierzu können die Checkboxen in der Spalte "Aktiviert" gesetzt werden. Die Zugriffsrechte können über das Bearbeitungssymbol aufgerufen und für jeden vorhandenen Stammbaum separat eingestellt werden.

{{-}}

== Personenseite ==
In diesem Abschnitt befinden sich die Einstellungen für die Personenseiten.

{{-}}

=== Reiter ===
[[Datei:WT 2.1 Verwaltung-Module Personenseite Reiter.png|alternativtext=Bearbeitung der auf den Personenseiten verfügbaren Reiter|thumb|350px|Bearbeitung der verfügbaren Reiter auf den Personenseiten]]
Auf dieser Seite wird festgelegt, welche "'''Reiter'''" und in welcher Reihenfolge sie auf den [[Webtrees_Handbuch/Anleitung_für_Besucher#Reiter|Personenseiten]] sichtbar sein sollen. Hierzu können die Checkboxen in der Spalte "Aktiviert" gesetzt und mit den Pfeilen die Positionen der Reiter eingestellt werden.

{{-}}

=== Navigationsleisten ===
[[Datei:WT 2.1 Verwaltung-Module Personenseite Navigationsleisten.png|alternativtext=Bearbeitung der auf den Personenseiten verfügbaren Seitennavigation|thumb|350px|Bearbeitung der auf den Personenseiten verfügbaren Seitennavigation]]
Auf dieser Seite wird festgelegt, welche "'''Navigationsleisten'''" und in welcher Reihenfolge sie in der Seitennavigation auf den [[Webtrees_Handbuch/Anleitung_für_Besucher#Navigationsleiste|Personenseiten]] sichtbar sein sollen. Hierzu können die Checkboxen in der Spalte "Aktiviert" gesetzt und mit den Pfeilen die Positionen der Navigationsleisten eingestellt werden.

{{-}}

=== Historische Ereignisse ===
[[Datei:WT 2.1 Verwaltung-Module Personenseite Historische-Ereignisse.png|alternativtext=Einstellung für die verfügbaren historischen Ereignisse|thumb|350px|Einstellung für die verfügbaren historischen Ereignisse]]
Auf dieser Seite wird festgelegt, welche "'''Historischen Ereignisse'''" angezeigt werden sollen, wenn auf den [[Webtrees_Handbuch/Anleitung_für_Besucher#Historische_Ereignisse|Personenseiten]] die entsprechende Checkbox im Kopf über den Ereignissen ausgewählt wird.

{{-}}

=== Geteiltes ===
[[Datei:WT 2.1 Verwaltung-Module Personenseite Geteiltes.png|alternativtext=Einstellung für geteilte Inhalte|thumb|350px|Einstellung für geteilte Inhalte]]
Auf der Seite "'''Geteiltes'''" wird festgelegt, welche Informationen zum Teilen mit andern bereitgestellt werden sollen.

{{-}}

== Sonstiges ==
Unter dieser Überschrift wird der Status einiger besonderer Module angezeigt. Diese können nur unter dem Menüpunkt [[Webtrees Handbuch/Anleitung für Administratoren/Module#Alle Module|Alle Module]] aktiviert und deaktiviert werden.

Dabei wird für die Module "Alte Internetadressen (URLs)", "Check for new version", "CKEditor™" und "Volkszählungsassistent" der Status, ob das Modul aktiviert oder deaktiviert ist, nur durch den Wechsel zwischen schwarz und grau signalisiert. Eine Einstellung ist nicht möglich.

Die Module "CSS und JS" und "Sitemaps" zeigen den Statuswechsel zwischen blau und grau an und erhalten einen Link, wenn sie aktiviert sind.

{{-}}

=== Alte Internetadressen (URLs) ===
Wenn dieses Modul aktiviert ist, können damit die alten Internetadressen (URLs) von webtrees Version 1 umgeleitet werden.

{{-}}

=== Check for new version ===
Wenn dieses Modul aktiviert ist, wird automatisch eine E-Mail an alle Administratoren gesendet, wenn ein neues Upgrade für webtrees verfügbar ist.

Hier fehlt

{{-}}

=== CKEditor™ ===
Bei dem Modul handelt es sich um einen „WYSIWYG“ Editor, ähnlich einer Textverarbeitung. Es wird von verschiedenen anderen Modulen zur Dateneingabe aufgerufen. Die Benutzer können den Text auf einfache Weise formatieren und müssen hierfür nicht HTML verwenden. Über einen Button kann jedoch zwischen formatierter Anzeige und HTML-Code hin- und hergewechselt werden. Weitere Informationen finden Sie auf der entsprechenden [https://ckeditor.com Webseite].

{{-}}

=== CSS und JS ===
[[Datei:WT 2.1 Modul-CSS-und-JS.png|alternativtext=Eingabefelder für das Modul "CSS und JS"|thumb|350px|Eingabefelder für das Modul "CSS und JS"]]
Mit dem Modul "CSS und JS" hat man die Möglichkeit seine webtrees-Instanz unkompliziert um kleinere JavaScript<ref>{{wikipedia-Link|Javascript}}</ref>-Funktionen oder CSS<ref>{{wikipedia-Link|Cascading Style Sheets}}</ref>-Direktiven zu ergänzen, die das Aussehen der Seite verändern.<ref>Eine Auslieferung der Modifikationen aus dem Modul "CSS und JS" erfolgt NICHT auf den Verwaltungsseiten.</ref> Gegenüber der Einarbeitung in die Thematik zur [[Webtrees_Handbuch/Entwicklungsumgebung#Anpassung_und_Entwicklung_eigener_Module|Entwicklung eigener Module]] oder dem nicht zu empfehlenden nachträglichen Patchen des webtrees-Programmcodes ist hier der Zugang einfacher. Die hier gemachten Ergänzungen oder Korrekturen bleiben auch bei einem [[Webtrees_Handbuch/Anleitung_für_Webmaster#Upgrade_von_webtrees|Upgrade]] von webtrees erhalten.

Das obere Eingabefeld ist für die Eingabe von CSS-Code - eingeschlossen in <[https://wiki.selfhtml.org/wiki/HTML/Elemente/style style]>-Tags - vorgesehen. JavaScript-Code - eingeschlossen in <[https://wiki.selfhtml.org/wiki/HTML/Elemente/script script]>-Tags - wird im unteren Feld eingetragen. Bei der Auslieferung der Webseiten durch den Webserver werden diese Angaben jeweils am Ende des <[https://wiki.selfhtml.org/wiki/HTML/Elemente/head head]>- bzw. <[https://wiki.selfhtml.org/wiki/HTML/Elemente/body body]>-Elements auf allen Seiten hinzugefügt (außer im Verwaltungsbereich). Der hier ergänzte Code kann auch als Datei eingebunden werden.<ref>Das Referenzieren des Pfades sollte dabei absolut erfolgen, wenn die einzubindende Datei etwa im public-Ordner der webtrees-Instanz abgelegt wird (vgl. https://wiki.selfhtml.org/wiki/HTML/Elemente/link#Stylesheets_einbinden und https://wiki.selfhtml.org/wiki/JavaScript/Tutorials/DOM/Einbindung_in_HTML).</ref>

Auch wenn eigentlich nicht dafür gedacht, ist prinzipiell auch die Angabe anderer HTML-Tags in den beiden Feldern denkbar.

Anwendungsbeispiele sind im Abschnitt [[Webtrees_Handbuch/Entwicklungsumgebung#Anpassungen_mit_dem_Modul_.22CSS_und_JS.22|Anpassungen mit dem Modul "CSS und JS"]] zu finden.

{{-}}

=== Sitemaps ===
[[Datei:WT 2.1 Verwaltung-Module Sitemaps.png|alternativtext=Verwaltung - Einstellungen für das Modul "Sitemaps"|thumb|350px|Verwaltung - Einstellungen für das Modul "Sitemaps"]]
Mit Sitemaps können die Seiten bestimmt werden, die zur Suche für Suchmaschinen freigegeben sind. Alle wichtigen Suchmaschinen unterstützen Sitemaps. Weiterführende Informationen können auf den angegebenen Webseiten gefunden werden.

Jeder Stammbaum kann einzeln für die Suche aktiviert und deaktiviert werden.

Mit den unten angegebenen Links können gängige Suchmaschinen auf die Sitemaps der Stammbaumseite aufmerksam gemacht werden.

{{-}}

=== Volkszählungsassistent ===
Das Modul bietet auf der Personenseite eine Erfassungskomponente, um damit zu bekannten Volkszählungen in verschiedenen Ländern Daten zu den Personen einzugeben.

{{WT-ToDo|Noch beschreiben: welche Länder, welche Zeiträume? Wie kann man ggf. eine Vorlage für weitere Volkszählungen ergänzen?}}

== Einzelnachweise ==
<references />

[[Kategorie:Webtrees]]

Webtrees Handbuch/Anleitung für Administratoren/Benutzer

2023-03-14T20:38:01Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Abschnitt 7.3|info=1}}{{WT-Inhaltsverzeichnis|Kapitel 7|C|Abschnitt 7.3}}

[[Datei:WT 2.1 Verwaltung-Benutzer.png|alternativtext=Verwaltung - Benutzer|thumb|center|350px|Verwaltung - Benutzer]]
In der ersten Zeile dieses Abschnitts steht die Anzahl der aktuell angelegten Benutzer.

Darunter befinden sich fünf Zeilen, in denen die Namen einiger Benutzer nach Rollen bzw. Status aufgelistet werden.
<div style="padding-left: 15px; display: flow-root;">
* Administratoren - alle im System angelegten Benutzer mit der Rolle "Administrator"
* Verwalter - alle im System angelegten Benutzer mit der Rolle "Verwalter"
* Moderatoren - alle im System angelegten Benutzer mit der Rolle "Moderator"
* Noch nicht selbstbestätigt - alle Besucher, die eine Registrierung beantragt haben, aber dem Bestätigungs-Link aus der Überprüfungs-E-Mail noch nicht gefolgt sind
* Noch nicht vom Administrator bestätigt - alle Besucher, die eine Registrierung beantragt haben, jedoch vom Administrator noch nicht bestätigt wurden
</div>

Im unteren Teil dieses Abschnitts befinden sich Links auf Funktionen zur Benutzerverwaltung.

Zuvor steht noch ein Einschub zu den in webtrees verfügbaren "'''Rollen'''". Damit werden die Berechtigungsstufen innerhalb der Benutzerhierarchie umschrieben.
{{-}}

== Rollen ==
[[Datei:WT 2.1 Verwaltung-Benutzerrollen.png|alternativtext=Verwaltung - Rollen in der Benutzerverwaltung|thumb|350px|Verwaltung - Rollen in der Benutzerverwaltung]]
Eine Zugangsrolle besteht aus einer Reihe von Zugriffsrechten, die es erlauben, Daten einzusehen, Daten zu ändern, Daten freizugeben, Einstellungen zu ändern, Benutzer zu verwalten, etc. Die Zugriffsrechte werden den Rollen zugewiesen und die Benutzer erhalten die Rollen entsprechend ihrer Fähigkeiten und beabsichtigten Berechtigung zugewiesen. Für jeden einzelnen Stammbaum können jeder Rolle unterschiedliche Zugriffsrechte zugeteilt werden und Benutzer können in jedem Stammbaum in unterschiedlichen Rollen tätig sein.

Die Reihenfolge in der nachstehenden Auflistung spiegelt die mit einer Rolle verbundene steigende Zahl an Berechtigungen wider. Das bedeutet, jede Rolle verfügt über die Rechte der Vorgänger-Rolle und erhält weitere hinzu.

*'''Besucher''' alle Besucher gehören zu dieser Rolle und besitzen die damit verbundenen geringen Berechtigungen. Insbesondere nicht angemeldete Besucher und Suchmaschinen haben damit die höchsten Einschränkungen.
*'''Mitglied''' bekommt zusätzliche Anzeigeberechtigungen für zuvor geschützte Daten, die durch die jeweilige Stammbaumkonfiguration gewährt werden. Eine Anmeldung als Benutzer ist erforderlich.
*'''Bearbeiter''' hat die Berechtigung zum [[Webtrees_Handbuch/Anleitung_für_Bearbeiter|Hinzufügen, Ändern und Löschen von Daten]]. Alle Änderungen müssen von einem Moderator genehmigt werden, bevor sie permanent in den Datenbestand übernommen werden, es sei denn, die Option „automatisches Akzeptieren von Änderungen“ wurde für den Nutzer bereits aktiviert.
*'''Moderator''' hat die Ermächtigung, [[Webtrees_Handbuch/Anleitung_für_Moderatoren|Änderungen anderer Benutzer]] zu übernehmen oder zu verwerfen.
*'''Verwalter''' kann die Zugangsberechtigung zu einem Stammbaum ändern und hat die Berechtigung, die [[Webtrees Handbuch/Anleitung für Verwalter|Konfiguration eines Stammbaums]] zu ändern.
*'''Administrator''' erhält zusätzlich zur Verwalter-Rolle in allen Stammbäumen noch die Berechtigung für Einstellungen der ganzen Webseite, Benutzerverwaltung, Installation und Konfiguration von Modulen.

Über die [[Webtrees Handbuch/Anleitung für Administratoren/Stammbäume#Einstellungen|Stammbaum-Einstellungen]] lassen sich die Berechtigungen im Detail anpassen. Bis auf die Rolle "Administrator" werden die Berechtigungen für alle Rollen auf der Ebene der Stammbäume vergeben. Details werden im folgenden Abschnitt beschrieben.

{{-}}

== Benutzerverwaltung ==
[[Datei:WT 2.1 Verwaltung-Benutzerverwaltung.png|alternativtext=Verwaltung - Benutzerverwaltung|thumb|350px|Verwaltung - Benutzerverwaltung]]
In der Benutzerverwaltung werden die Benutzerkonten aufgelistet. Durch Klicken auf die Spaltenköpfe (mit Ausnahme von "Bearbeiten") ist auf- und absteigendes '''Sortieren''' möglich. Ein benutzerdefinierter Text-Filter, der über die Spalten "Benutzername", "Vollständiger Name" und "E-Mail-Adresse" sucht, kann die Ergebnismenge einschränken. Folgende Informationen bzw. Spalten enthält die Tabelle:
* '''Bearbeiten''' eine Schaltfläche mit einem zusätzlichen Kontextmenu, s.u.
* '''Benutzername''' ist der Anmeldename
* '''Vollständiger Name''' sollte mit einem sprechenden Namen belegt sein
* '''E-Mail-Adresse''' muss eine gültige E-Mail-Adresse sein, damit der Benutzer für webtrees erreichbat ist
* '''Sprache''' wird vom Administrator vorbelegt und kann vom Benutzer jederzeit selber geändert werden
* '''Registrierungsdatum''' seit wann der Benutzer sich bei der webtrees-Installation registriert hat
* '''Letzte Anmeldung''' wann der Benutzer sich das letzte Mal angemeldet hat
* '''Bestätigt''' ob der Benutzer dem Bestätigungslink aus der Überprüfungs-E-Mail bereits gefolgt ist
* '''Genehmigt''' ob der Administrator den Benutzer bereits freigeschaltet hat

{{-}}

[[Datei:WT 2.1 Verwaltung-Benutzer bearbeiten Kontext Menu.png|alternativtext=Verwaltung - Benutzer bearbeiten - Kontext Menu|thumb|350px|Verwaltung - Benutzer bearbeiten - Kontext Menu]]
Die Bearbeiten-Spalte enthält ein '''Kontextmenü''' mit weiteren Aktionen für das betreffende Benutzerkonto. Die Bearbeitungsmöglichkeiten werden in den folgenden Abschnitten beschrieben.

{{-}}

=== Bearbeiten ===
[[Datei:WT 2.1 Verwaltung-Benutzer bearbeiten 1.png|alternativtext=Verwaltung - Benutzer bearbeiten|thumb|350px|Verwaltung - Benutzer bearbeiten]]
Auf dieser Seite werden Detailinformationen erfasst und Einstellungen für das Konto vorgenommen.

Folgende Einstellungen können für das Konto bearbeitet werden.
*'''Vollständiger Name''' ist der Anzeigename innerhalb webtrees, in der Regel der übliche Name des Benutzers.
*'''Benutzername''' ist der Name für die Anmeldung im '''Benutzerkonto''', eine Unterscheidung von Groß- und Kleinbuchstaben sowie von diakritischen Zeichen erfolgt nicht.
*'''Passwort''' zur Anmeldung am Benutzerkonto, muss mindestens 8 Zeichen lang sein und unterscheidet Groß- und Kleinbuchstaben.
*'''E-Mail-Adresse''' dient dem Versand von Webseitenbenachrichtigungen, Passwort-Erneuerungen und Nachrichten von anderen Familienmitgliedern, die auf der Seite registriert sind.
*'''Zugangsgenehmigung und Überprüfung E-Mail-Adresse '''enthält die Kennzeichen die den Zugang regeln. Ein Benutzer kann sich erst anmelden, wenn beide Optionen gesetzt sind. "E-Mail-Adresse überprüft" zeigt an, dass der Benutzer seine E-Mail per versandtem Link bereits überprüft und damit sichergestellt hat, dass sie korrekt ist. Falls das Benutzerkonto durch einen Administrator angelegt wird, ist diese Option automatisch ausgewählt. In diesem Fall wird keine E-Mail zur Überprüfung gesendet und die E-Mail-Adresse muss vom Administrator geprüft worden sein. "Vom Administrator zugelassen" zeigt an, dass ein Administrator das Konto überprüft und zur Benutzung freigegeben hat.
*'''Sprache''' wird vom Administrator vorbelegt und kann vom Benutzer jederzeit selber geändert werden.
*'''Zeitzone''' in der sich der Benutzer hauptsächlich aufhält, kann hier ausgewählt werden.
*'''Änderungen''' an den genealogischen Daten im Stammbaum müssen von einem Moderator bestätigt werden, es sei denn, diese Option ist gesetzt, damit dieser Vorgang automatisch erfolgt.
*'''Sichtbar, wenn angemeldet''' bedeutet, dass andere Mitglieder sehen können, ob dieser Benutzer angemeldet ist. Falls diese Option deaktiviert wird, kann der Benutzer andere und andere den Benutzer nicht sehen.
*'''Bevorzugte Methode zur Kontaktaufnahme''' stellt fünf Optionen bereit, wie der Nachrichtenversand an den Benutzer innerhalb von webtrees erfolgen soll.
**Interne Nachrichtenfunktion - empfängt und speichert Nachrichten anderer Benutzer nur intern
**Interne Nachrichtenfunktion mit E-Mails - empfängt und speichert Nachrichten anderer Benutzer intern und leitet sie auch an die hinterlegte E-Mail-Adresse des Benutzers weiter
**webtrees sendet E-Mails ohne sie zu speichern - empfängt Nachrichten anderer Benutzer ohne sie zu speichern und leitet sie an die hinterlegte E-Mail-Adresse des Benutzers weiter
**Mailto-Link - ???
**Kein Kontakt - unterdrückt die Anzeige des Benutzernamens in der Auswahl der E-Mail-Empfänger

{{WT-ToDo|Was bedeutet Mailto-Link senden?}}

*'''Thema '''ist das vom Administrator voreingestellte oder vom Benutzer ausgewählte '''[[Webtrees_Handbuch/Anleitung_für_Besucher#Thema|Thema]]''', das nach der Anmeldung am System wirksam wird.
*'''Bemerkungen des Administrators zu diesem Benutzer''' können in diesem Feld hinterlegt werden.
*'''Administrator''' hat im System die "Rolle" mit den höchsten Rechten; diese Rolle wird dem Benutzer durch Aktivieren dieses Ankreuzfeldes zugewiesen.
[[Datei:WT 2.1 Meine Seiten-Menue-Mein Konto.png|alternativtext=Menü: Meine Seiten - Mein Konto|thumb|350px|Menü: Meine Seiten - Mein Konto]]
Einige der obigen Einstellungen können auch vom Benutzer selbst über das Menu [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Mein_Konto|Meine Seiten / Mein Konto]] beeinflusst werden.

{{-}}

[[Datei:WT 2.1 Verwaltung-Benutzer bearbeiten 2.png|alternativtext=Verwaltung - Benutzer bearbeiten - Zugriffe|thumb|350px|Verwaltung - Benutzer bearbeiten - Zugriffe]]
Im unteren Bereich der Seite wird der "'''Zugriff auf Stammbäume und Einstellungen'''" durch Zuweisung von [[Webtrees Handbuch/Anleitung für Administratoren/Benutzer#Rollen|Rollen]], Positionen und Reichweiten festgelegt. Dabei wird für jeden angelegten Stammbaum automatisch eine Zeile generiert. Die individuellen Berechtigungen des Benutzers werden hier festgelegt.

Die erste Spalte enthält die "''Rolle''" des Benutzers.

In der Spalte "''Personendatensatz''" kann dem Benutzer sein Personendatensatz im Stammbaum zugewiesen werden.<ref>Vgl. auch die Funktion [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Mein_Datenblatt|Mein Datenblatt]] für Mitglieder.</ref> Das Feld kann leer bleiben. In diesem Fall startet der Benutzer nach dem Login immer mit der vom Administrator festgelegten Startperson.

Ferner kann in der dritten Spalte auch eine ''"Beschränkung auf die unmittelbaren Familienangehörigen"'' bestimmt werden. Wenn ein Benutzer einem einzelnen Datensatz in einem Stammbaum zugeordnet ist und zugleich eine Rolle als Mitglied, Bearbeiter oder Moderator ausübt, kann sein Zugriff auf Details von entfernten Verwandten verhindert werden. Angegeben wird die Anzahl der Beziehungsgrade, die der Benutzer sehen darf.

Wenn Sie zum Beispiel eine Stufenweite von 2 angeben, wird dieser Benutzer in der Lage sein, seine Enkel (Kind, Kind), seine Tante (Eltern, Geschwister), seine Stieftochter (Ehepartner, Kind), nicht aber seine Cousine (Eltern, Geschwister, Kinder) zu sehen.

Hinweis: Längere Pfade benötigen viele Berechnungen, was dazu führen kann, dass die Website für diese Nutzer langsam läuft.

{{-}}

=== Ausgeben als dieser Benutzer ===
Diese Funktion dient Administratoren zum Test des ausgewählten Benutzerkontos und zur eventuellen Problemlösung. Nach dem Aufruf wird direkt auf die Benutzer-Startseite "Meine Seite" mit dessen zugehörigen Berechtigungen gesprungen. Auf diese Weise kann der Administrator z.B. diese Startseite individualisieren und andere Funktionen testen. Auch im Zugangsprotokoll wird ein Eintrag für einen Login-Vorgang dieses Benutzers erzeugt. Um zurück in das aufrufende Administratorenkonto zu gelangen, muss das Benutzerkonto abgemeldet und der Administrator wieder angemeldet werden.

{{-}}

=== Löschen ===
[[Datei:WT 2.1 Verwaltung-Benutzer bearbeiten loeschen ok.png|alternativtext=Verwaltung - Benutzer bearbeiten - Löschen OK|thumb|350px|Verwaltung - Benutzer bearbeiten - Löschen OK]]
Nach dem Aufruf dieser Funktion erscheint zunächst eine Abfrage, ob das Konto wirklich gelöscht werden soll. Nach der Bestätigung mit dem Button "OK" erfolgt das Entfernen des Kontos.

Wenn der Benutzer die Rolle "Administrator" hat, wird die Option zum Löschen nicht angezeigt. Um einen solchen Nutzer zu löschen, muss ihm in den Benutzereinstellungen zuvor diese Rolle entzogen werden.

{{WT-ToDo|Hier brauchen wir eine Sprungmarke oben bei "Administrator", damit man von hier aus dorthin verlinken kann.}}

Um mehrere Nutzer zu löschen, die lange nicht aktiv waren, gibt es eine eigene Funktion (siehe nachfolgenden Abschnitt "[[Webtrees_Handbuch/Anleitung_für_Administratoren/Benutzer#Inaktive_Benutzer_löschen|Inaktive Benutzer löschen]]").
{{-}}

== Einen Benutzer hinzufügen ==
[[Datei:WT_2.0_Benutzer-hinzufuegen.png|thumb|right|350px|Benutzer hinzufügen]]
Sofern neue Benutzer nicht bereits selber eine [[Webtrees_Handbuch/Anleitung_für_Besucher#Anmelden|Registrierung]] beantragt haben, kann durch diesen Link das Formular zur Erfassung der Basisdaten mit folgenden Angaben aufgerufen werden.
* '''Vollständiger Name''' ist der Anzeigename innerhalb webtrees, in der Regel der übliche Name des Benutzers
* '''Benutzername''' ist der Name für die Anmeldung im Benutzerkonto, eine Unterscheidung von Groß- und Kleinbuchstaben sowie von diakritischen Zeichen erfolgt nicht
* '''Passwort''' zur Anmeldung am Benutzerkonto, muss mit mindestens 8 Zeichen lang sein und unterscheidet Groß- und Kleinbuchstaben
* '''E-Mail-Adresse''' dient dem Versand von Webseitenbenachrichtigungen, Passwort-Erneuerungen und Nachrichten von anderen Familienmitgliedern, die auf der Seite registriert sind.
Nach der Speicherung der Basisdaten erfolgt eine Weiterleitung zum Formular [[#Bearbeiten|Bearbeiten]], siehe oben.

{{-}}

== Inaktive Benutzer löschen ==
[[Datei:WT 2.1 Verwaltung-Benutzer Inaktive Benutzer loeschen.png|alternativtext=Verwaltung - Benutzer - Inaktive Benutzer löschen|thumb|350px|Verwaltung - Benutzer - Inaktive Benutzer löschen]]
Durch Auswahl dieser Option werden alle Benutzer, die schon lange nicht mehr (länger als 1 Jahr) aktiv waren, in einer Liste angezeigt. Die Checkboxen neben den Namen dienen der Auswahl der Benutzer, die gelöscht werden sollen. Mit Klick auf die Schaltfläche "löschen" am Ende der Seite wird der Löschvorgang ausgelöst.

{{-}}

== Standardblöcke für neue Benutzer festlegen ==
[[Datei:WT 2.1 Verwaltung-Standardbloecke fuer neue Stammbaeume festlegen.png|alternativtext=Verwaltung - Standardblöcke für neue Stammbäume festlegen|thumb|350px|Verwaltung - Standardblöcke für neue Stammbäume festlegen]]
Über diesen Link lassen sich in einer Bearbeitungsmaske die [[Webtrees Handbuch/Anleitung für Administratoren/Stammbäume#Standardbl.C3.B6cke_f.C3.BCr_neue_Stammb.C3.A4ume_festlegen|Standardblöcke für neue Benutzer festlegen]]. Die hier zusammengestellten Blöcke werden allen neuen Benutzern auf ihrer "Meine Seite" ausgerollt und können von diesen dann jederzeit individuell angepasst werden.

{{-}}

== Allen Benutzern eine Nachricht senden ==
[[Datei:WT 2.1 Verwaltung-Benutzer Allen Benutzern eine Nachricht senden.png|alternativtext=Verwaltung - Benutzer - Allen Benutzern eine Nachricht senden|thumb|350px|Verwaltung - Benutzer - Allen Benutzern eine Nachricht senden]]
Es gibt die Möglichkeit allen Benutzern dieselbe Nachricht zu senden. Bei Aufruf dieser Funktion wird das Formular zum Versenden einer Nachricht aufgerufen und im Feld "An" automatisch alle Benutzer aus der Benutzerverwaltung eingetragen. In den beiden weiteren Feldern geben Sie das "Betreff" und Ihre "Nachricht" ein. Durch Anklicken der entsprechenden Schaltfläche können Sie Ihre Nachricht "Absenden" oder den Vorgang "Abbrechen".

{{-}}

== Sende eine Nachricht an Benutzer, die sich noch nie angemeldet haben ==
Vgl. den vorangegangenen Punkt; der Unterschied liegt nur im ausgewählten Empfängerkreis.

{{-}}

== Nachricht an Benutzer senden, die sich innerhalb der letzten 6 Monate nicht angemeldet haben ==
Vgl. den vorangegangenen Punkt; der Unterschied liegt nur im ausgewählten Empfängerkreis.

{{-}}

== Einzelnachweise ==
<references />

[[Kategorie:Webtrees]]

Webtrees Handbuch/Anleitung für Administratoren

2023-03-14T20:37:51Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Kapitel 7|info=1}}{{WT-Inhaltsverzeichnis|Kapitel 7|B}}

[[Datei:WT_2.0_Meine-Seiten-Menue-Verwaltung.png|thumb|left|250px|Kopfmenü: Meine Seiten - Verwaltung]]

In vielen Fällen wird der Webmaster auch die Aufgaben des webtrees-Administrators mit übernehmen, aber manchmal werden die Rollen Administrator und Webmaster von verschiedenen Personen ausgeführt. Einige Einstellungen in diesem Kapitel des webtrees-Handbuchs gelten eher für Webmaster, so dass man teilweise auch noch weiter gehende Informationen im Kapitel [[Webtrees Handbuch/Anleitung für Webmaster|"Anleitung für Webmaster"]] finden kann. Die Funktionen, die ein Verwalter für die ihm zugeordneten Stammbäume ausführen kann, stehen dem Administrator für alle angelegten Stammbäume zur Verfügung (siehe Kapitel "[[Webtrees Handbuch/Anleitung für Verwalter|Anleitung für Verwalter]]").

Der '''Administrator''' hat alle Rechte bezüglich der webtrees-Einstellungen. Er kann im Kopfmenü unter "Meine Seiten" den Menüpunkt "Verwaltung" aufrufen. Das erscheinende Verwaltungsmenü gliedert sich in die folgenden Abschnitte, welche jeweils auf eigenen Unterseiten in diesem Wiki beschrieben sind. Im folgenden wird nur eine kurze Übersicht gegeben.

<div style="clear: left;" />

== [[Webtrees Handbuch/Anleitung für Administratoren/Webseite|Webseite]] ==
Hier werden alle Einstellungen bezüglich der Erscheinungsform der Website im Internet vorgenommen.

== [[Webtrees Handbuch/Anleitung für Administratoren/Stammbäume|Stammbäume]] ==
webtrees kann mehrere Stammbäume verwalten und alle Einstellungen erfolgen hier. Während der Administrator alle Stammbäume verwalten kann, hat ein [[Webtrees Handbuch/Anleitung für Verwalter|Verwalter]] nur das Recht die ihm zugeordneten Stammbäume zu verwalten.

== [[Webtrees Handbuch/Anleitung für Administratoren/Benutzer|Benutzer]] ==
Die Benutzerverwaltung regelt das Neuanlegen und Entfernen von Anwendern und gibt eine Übersicht über deren Status und ihre Rechte.

== [[Webtrees Handbuch/Anleitung für Administratoren/Module|Module]] ==
Der Standard von webtrees wird mit über 200 Modulen im Kern ausgeliefert. Darüber hinaus können zusätzliche [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodule]] installiert und verwaltet werden.

== [[Webtrees Handbuch/Anleitung für Administratoren/Multimedia|Multimedia]] ==
Für die zentrale Verwaltung sämtlicher Medien, wie Bilder, Dokumente, Grabsteine, Urkunden, etc. steht dieser Punkt zur Verfügung.

== [[Webtrees Handbuch/Anleitung für Administratoren/Landkarte|Landkarte]] ==
Unter diesem Punkt werden Einstellungen zu Ereignisorten mit deren geografischen Informationen vorgenommen.

{{-}}

[[Kategorie:Webtrees]]

Webtrees Handbuch/Allgemeine Erläuterung des Programms

2023-03-14T20:37:41Z

Bot1: Bot: Automatisierte Textersetzung (-'''webtrees''' +webtrees)

{{WT-Seitenkopf|prefix=Kapitel 1|info=1}}{{WT-Inhaltsverzeichnis|Kapitel 1|A}}
webtrees ist ein vollumfängliches, mehrsprachiges und kostenloses [[Genealogieprogramm]], das auf einem Server installiert wird. Dieses beliebte Open-Source-Programm ist weltweit auf über 6.100 Servern installiert, davon befinden sich über 1.900 Installationen im deutschsprachigen Raum (D/A/CH)<ref>[https://dev.webtrees.net/statistics.html Installation statistics] (Abruf 6.03.2023)</ref>. webtrees bietet verschiedene Darstellungsmöglichkeiten für die genealogischen Daten und unterstützt den [[GEDCOM]]-Standard für den Datenaustausch. Es lassen sich mehrere Stammbäume installieren und sehr große Datenmengen von mehreren Nutzern gemeinsam bearbeiten und verwalten.

webtrees dokumentiert die Familiengeschichte von Menschen, indem etwa die folgenden Ereignisse, Fakten und Beziehungen aufgezeichnet werden können
* Geburt
* Ehe(n) und Scheidung(en)
* Tod
* Kinder
* Eltern
* sowie zugehörige Multimedia-Dateien.

== Grundkonzept ==
[[Datei:WT 2.1 Personenseite Beispiel.png|thumb|links|350px|Beispiel einer Personenseite|verweis=Special:FilePath/WT_2.1_Personenseite_Beispiel.png]]
Die Anwendung ist besonders durch die Nutzung durch mehrere Anwender über das Internet und das dafür nötige Berechtigungskonzept gekennzeichnet. Ein wichtiger Aspekt hierbei ist der Schutz der personenbezogenen Daten vor unberechtigtem Zugriff.

In der ersten Abbildung links ist eine typische webtrees-Seite zu einer Person abgebildet. Für die Screenshots in diesem Handbuch wurde eine Musterdatei angelegt, die dann als Basis für alle Abbildungen diente.
<div style="clear:left;" />

=== Webanwendung ===
Die Anwendung webtrees ist webbasiert. Eine webbasierte Anwendung ist dadurch gekennzeichnet, dass eine Website als Bedienoberfläche verwendet wird. Die Benutzer von webtrees können also mit einem Browser von jedem Computer aus auf die Anwendung zugreifen (siehe unten stehende Abbildung rechts).

Eine Nutzung ist unabhängig von einem Betriebssystem über verschiedene Endgeräte möglich (PC, Laptop, Tablet, Smartphone, Smart-TV usw.). Die Darstellung der Anwendung erfolgt dabei in einer ansprechenden und auf das Zielgerät optimierten Form<ref>{{wikipedia-Link|Responsive Webesign}}</ref>. Mehrere Benutzer können die Anwendung gleichzeitig benutzen, die Daten liegen in einer zentralen Datenbank.

Das Konzept einer Webanwendung steht im Gegensatz zu Anwendungen, die auf einem lokalen Computer installiert werden, und zu Apps, die auf einem Smartphone bereit gestellt werden (siehe unten stehende Abbildung links). Solche Anwendungen können immer nur von einem Benutzer genutzt werden; die Anwendung und die Daten liegen lokal auf dem Rechner. Wobei die Unterschiede zwischen diesen beiden Konzepten in der letzten Zeit etwas verschwimmen, da immer mehr lokal installierte Anwendungen die Speicherung von Daten in einer Cloud unterstützen.

Der Server, auf dem webtrees installiert wird, kann von einem Hosting-Anbieter als dedizierter oder als gemeinsam genutzter Rechner bereit gestellt werden. Auch ein privater PC oder ein Netzlaufwerk können als Server zum Einsatz kommen. Der Server kann sich im Internet oder in einem lokalen Netz befinden.
{{-}}
<gallery perrow="2" widths="400" heights="200">
Datei:WT - konventionelles Genealogieprogramm.png|Lokal installiertes Genealogieprogramm
Datei:WT - webbasiertes Genealogieprogramm.png|Webbasiertes Genealogieprogramm (Client-Server Anwendung)
</gallery>

=== Berechtigungskonzept ===
[[Datei:WT - rollenbasierte Zugriffsrechte webtrees.png|rand|rechts|500px|rollenbasierte Zugriffsrechte|verweis=Special:FilePath/WT_-_rollenbasierte_Zugriffsrechte_webtrees.png]]
webtrees präsentiert Forschungsergebnisse im Internet und erlaubt eine gemeinsame Pflege der genealogischen Daten für registrierte Benutzer. Dem Datenschutz kommt daher eine besondere Bedeutung zu. Der Zugriff auf die Daten in webtrees wird über ein mehrstufiges, rollenbasiertes Rechtesystem geregelt. Die einzelnen Zugriffsrollen sind im Abschnitt "[[Webtrees Handbuch/Anleitung für Administratoren/Benutzer#Rollen|Rollen]]" im Kapitel "[[Webtrees Handbuch/Anleitung für Administratoren|Anleitung für Administratoren]]" beschrieben.

Zum Schutz der Privatsphäre trennt webtrees geschützte Daten von öffentlichen Daten durch ein ausgeklügeltes Datenschutzkonzept, welches allgemein gültige Datenschutzanforderungen sicherstellt, aber auch an spezifische Bedürfnisse angepasst werden kann. webtrees unterscheidet hierbei zwischen einem öffentlichen Bereich für Besucher und einem geschlossenen Bereich für registrierte Mitglieder. Im öffentlichen Bereich werden Besuchern nur die Daten angezeigt, welche hierfür freigeben wurden, zum Beispiel Namen und die Geburtsdaten von Personen, welche vor mehr als 110 Jahren geboren sind, von denen also angenommen werden kann, dass sie bereits verstorben sind. Im geschlossenen Bereich wird der Zugriff auf die Daten durch Benutzer über Rollen geregelt (Mitglied, Bearbeiter, Moderator, Verwalter).
{{-}}

=== Datenschutz ===
Beim Datenschutz geht es um den Schutz personenbezogener Daten vor Missbrauch, insbesondere um den Schutz personenbezogener Daten von lebenden Personen. Durch geeignete Schutzmaßnahmen ist sicherzustellen, dass vertrauliche bzw. personenbezogene Daten nicht in die Hände von Unbefugten gelangen.

Die Schutzmechanismen bei webtrees basieren zum einen auf dem rollenbasierten Berechtigungskonzept für Anwender und zum anderen auf entsprechende Konfigurationseinstellungen auf verschiedenen Ebenen. Die Voreinstellungen in webtrees sind für die meisten Anwender geeignet und schützen standardmäßig die Privatsphäre von lebenden Personen. Durch das Berechtigungskonzept entscheidet der Administrator des Systems bzw. der Verwalter eines Stammbaums, wer Zugang zu welchen Daten hat, wer Daten bearbeiten oder nur anschauen darf. Dies ist bei webtrees sogar in Abhängigkeit des Verwandtschaftsgrades möglich.

Die Datenschutz-Einstellungen sind auf verschiedenen Ebenen möglich (Details siehe im Abschnitt "[[Webtrees Handbuch/Anleitung für Verwalter#Datenschutz|Datenschutz]]" im Kapitel "[[Webtrees Handbuch/Anleitung für Verwalter|Anleitung für Verwalter]]")

* [[Webtrees_Handbuch/Anleitung_für_Verwalter#Datenschutz_f.C3.BCr_Stammb.C3.A4ume|Datenschutz für Stammbäume]]
* [[Webtrees_Handbuch/Anleitung_für_Verwalter#Datenschutzregeln_f.C3.BCr_alle_Personen|Datenschutz für alle]] und/oder [[Webtrees_Handbuch/Anleitung_für_Verwalter#Datenschutz_f.C3.BCr_einzelne_Personen|einzelne Personen]]
* [[Webtrees_Handbuch/Anleitung_für_Verwalter#Datenschutz_f.C3.BCr_alle_Datens.C3.A4tze_eines_Typs|Datenschutz für Datensätze]]
* [[Webtrees_Handbuch/Anleitung_für_Verwalter#Datenschutz_f.C3.BCr_einzelne_Ereignisse_und_Fakten|Datenschutz für Ereignisse und Fakten]]

=== Datensicherheit ===
Die Datensicherheit ist eine Voraussetzung für einen effektiven Datenschutz. Die Datensicherheit hat das technische Ziel, die Daten gegen Verlust, Manipulationen und andere Bedrohungen zu sichern.

Hier empfiehlt es sich, die webtrees-Anwendung auf sicheren Servern in einem deutschen oder europäischen Rechenzentren zu betreiben, um Datenschutzaspekte wie die Datenschutz-Grundverordnung (DSGVO) sicher zu stellen.

Für Zugriffe auf die webtrees-Seiten sollte eine verschlüsselte Kommunikationsverbindung (gesicherte Verbindung über https) genutzt werden. Dazu muss ein SSL-Zertifikat auf dem Server installiert werden.

=== Weitere Eigenschaften ===
Die Anwendung webtrees ist durch die folgenden weiteren Eigenschaften gekennzeichnet.
* webtrees ist ein vollumfängliches [[Genealogieprogramm]] zur Erfassung und Darstellung von genealogischen Daten.
* webtrees ist ein ergebnisorientiertes, also nicht evidenzbasiertes Programm. Es werden die Ergebnisse aus genealogischen Schlussfolgerungen dokumentiert.
* Die Software ist kostenlos, wobei für den Betrieb eines webtrees-Servers üblicherweise ein Abonnementmodell hinzukommt<ref>siehe Abschnitt "[[Webtrees_Handbuch/Anleitung_für_Webmaster#Auswahl_eines_Hosting-Anbieters|Auswahl eines Hosting-Anbieters]]" im Kapitel "[[Webtrees_Handbuch/Anleitung_für_Webmaster|Anleitung für Webmaster]]"</ref>.
* webtrees ist eine Open-Source-Software<ref>{{wikipedia-Link|Open Source|Open Source}}</ref>, d.h. sie wird von einer Gemeinschaft von Entwicklern ständig verbessert und für jedermann zur Nutzung nach dem Lizenzmodell GPL<ref>{{wikipedia-Link|GNU_General_Public_License|GPL-Lizenz}}</ref> bereit gestellt.
* Auch große Datenmengen können in Abhängigkeit von der Leistungsfähigkeit des Servers verarbeitet werden (etwa mit über einer Million Personen).
* Mit webtrees können parallel mehrere Stammbäume auf einer Website installiert werden<ref>Praktikabel sind maximal etwa 30 Stammbäume pro Installation.</ref>.
* Die Anzahl der verwalteten Nutzer einer webtrees-Instanz kann bei über 1.000 liegen; die maximale Anzahl der gleichzeitig aktiven Nutzer und die maximale Anzahl der der Änderungen pro Tag hängt von der Leistungsfähigkeit des eingesetzten Servers ab.<ref>Im [https://www.webtrees.net/index.php/en/forum/2-open-discussion/36016-webtrees-use-by-a-genealogical-association#86681 Forum] wurde eine Referenz auf eine Installation gegeben, die rund 1.000 Bearbeiter aufführt (mit etwa 50 recht aktiven Nutzern). Die Anzahl der Bearbeitungen liegt dort bei 500 bis 1.000 pro Tag.</ref>
* Die Software unterstützt den [[GEDCOM_5.5.1|GEDCOM-Standard in der Version 5.5.1]] in umfassender Form und ist daher mit allen wichtigen Genealogieprogrammen kompatibel.
* Es werden diverse GEDCOM-Dialekte unterstützt, wie etwa die Festlegungen der [[GEDCOM-L|GEDCOM-L-Gruppe]] (siehe [https://genealogy.net/GEDCOM/ Addendum]).
* Der Administrator einer Installation kann Module, Menüs, Diagramme, Berichte und vieles andere flexibel konfigurieren.<ref>siehe Kapitel "[[Webtrees_Handbuch/Anleitung_für_Administratoren|Anleitung für Administratoren]]"</ref>
* Zur individuellen Gestaltung der Bedienoberfläche stehen verschiedene Darstellungs-Module, "Themen" genannt, zur Verfügung<ref>siehe Abschnitt "[[Webtrees_Handbuch/Anleitung_für_Besucher#Thema|Thema]]" im Kapitel "[[Webtrees_Handbuch/Anleitung_für_Besucher|Anleitung für Besucher]]"</ref>. Neben den verschiedenen Themen, die zum webtrees-Kern gehören, stehen auch weitere Themen in der Form von [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodulen]] zur Verfügung.
* webtrees wird international eingesetzt und die Nutzer können aus mehr als 50 Sprachen auswählen<ref>siehe Abschnitt "[[Webtrees_Handbuch/Anleitung_für_Besucher#Sprache|Sprache]]" im Kapitel "[[Webtrees_Handbuch/Anleitung_für_Besucher|Anleitung für Besucher]]"</ref>. Auch Schreibrichtungen von rechts nach links werden unterstützt.
* Es können zahlreiche Namenskonventionen eingestellt werden, wie etwa Nachname-Vorname, matrilineare Nachnamenstradition, patronymische Nachnamen und mehr<ref>siehe Abschnitt "[[Webtrees_Handbuch/Anleitung_für_Verwalter#Einstellungen|Einstellungen]]" im Kapitel "[[Webtrees_Handbuch/Anleitung_für_Verwalter|Anleitung für Verwalter]]"</ref>.
* Es gibt eine Volltextsuche sowie weitere Suchfunktionen, durch die umfangreiche Datenbestände eingegrenzt werden können. Dazu gehört die Soundex-Suche (Namen nach Aussprache suchen)<ref>siehe Abschnitt "[[Webtrees_Handbuch/Anleitung_für_Besucher#Suchen|Suchen]]" im Kapitel "[[Webtrees_Handbuch/Anleitung_für_Besucher|Anleitung für Besucher]]"</ref>.
* Quellen, Archive, gemeinsame Notizen und Mediendaten in verschiedenen Formaten können bearbeitet werden.
* Verschiedene Kalendersysteme für Datumsangaben werden unterstützt<ref>siehe Abschnitt "[[Webtrees_Handbuch/Anleitung_für_Bearbeiter#Kalendersysteme|Kalendersysteme]]" im Kapitel "[[Webtrees_Handbuch/Anleitung_für_Bearbeiter|Anleitung für Bearbeiter]]"</ref>.
* Ortsdaten können Stammbaum-übergreifend verwaltet werden<ref>siehe Abschnitt "[[Webtrees_Handbuch/Anleitung_für_Administratoren/Landkarte|Landkarte]]" im Kapitel "[[Webtrees_Handbuch/Anleitung_für_Administratoren|Anleitung für Administratoren]]"</ref>; Ortsdatensätze und [http://gov.genealogy.net/ GOV] werden u.a. durch [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodule]] unterstützt (Vesta-Module).
* Es können in einem Medienobjekt mehrere Mediendateien enthalten sein; dies kann etwa verwendet werden um die Vorder- und Rückseite eines Dokuments in einem Objekt zu erfassen.
* webtrees unterstützt verschiedene Kartensysteme zur Anzeige von Orten und Ereignissen<ref>siehe Abschnitt "[[Webtrees_Handbuch/Anleitung_für_Administratoren/Module#Geografische_Daten|Geografische Daten]]" im Kapitel "[[Webtrees_Handbuch/Anleitung_für_Administratoren|Anleitung für Administratoren]]"</ref>.
* Genealogische Forschungsaufgaben lassen sich verwalten<ref>siehe Abschnitt "[[Webtrees_Handbuch/Anleitung_für_Bearbeiter#Forschungsaufgaben|Forschungsaufgaben]]" im Kapitel "[[Webtrees_Handbuch/Anleitung_für_Bearbeiter|Anleitung für Bearbeiter]]"</ref>.
* Massenänderungen der genealogischen Daten sind möglich<ref>siehe Abschnitt "[[Webtrees_Handbuch/Anleitung_für_Verwalter#Datenkorrekturen|Datenkorrekturen]]" im Kapitel "[[Webtrees_Handbuch/Anleitung_für_Verwalter|Anleitung für Verwalter]]"</ref>.
* Eine Datenschutzerklärung wird automatisch erzeugt<ref>siehe Abschnitt "[[Webtrees_Handbuch/Anleitung_für_Administratoren/Module#Fußzeilen|Fußzeilen]]" im Kapitel "[[Webtrees_Handbuch/Anleitung_für_Administratoren|Anleitung für Administratoren]]"</ref>.
* Für die Präsentation der genealogischen Daten stehen verschiedene grafische Auswertungen zur Verfügung, unter anderem Ahnen- und Familienbuch-Diagramm, Darstellung als „Sanduhr“, Stammbaum oder Nachfahrenbaum. Weitere Funktionen sind die Lebensspannenanzeige (parallele Darstellung der „Lebensleiste“ mehrerer Personen) oder die Berechnung der Verwandtschaftsbeziehung zwischen zwei Personen<ref>siehe Abschnitt "[[https://wiki.genealogy.net/Webtrees_Handbuch/Anleitung_für_Besucher#Diagramme|Diagramme]]" im Kapitel "[[Webtrees_Handbuch/Anleitung_für_Besucher|Anleitung für Besucher]]"</ref>.
* Die Anwendung basiert serverseitig auf dem PHP<ref>{{wikipedia-Link|PHP}}</ref>-Webframework Laravel<ref>{{wikipedia-Link|Laravel}}</ref> und einer Datenbank (etwa MySQL<ref>{{wikipedia-Link|MySQL}}</ref>); die Anwendung enthält clientseitig JavaScript-Funktionen<ref>{{wikipedia-Link|JavaScript}}</ref>.
* Durch die Verwendung der richtigen Kombination aus Tools von Drittanbietern, modernen Designtechniken und offenen Standards ist webtrees zukunftssicher, effizient und effektiv.
* Auf Grund des modularen Konzepts lassen sich alle Funktionen durch einen erfahrenen PHP-/Web-Programmierer erweitern<ref>siehe Abschnitt "[[Webtrees_Handbuch/Entwicklungsumgebung#Anpassung_und_Entwicklung_eigener_Module|Anpassung und Entwicklung eigener Module]]" im Kapitel "[[Webtrees_Handbuch/Entwicklungsumgebung|Entwicklungsumgebung]]"</ref>.

== Besonderheiten ==
Die Anwendung webtrees unterscheidet sich in einigen wichtigen Punkten von anderen webbasierten Genealogieprogrammen. Darauf wird im folgenden Abschnitt "[[#Vergleich mit anderen Programmen|Vergleich mit anderen Programmen]]" noch näher eingegangen.

=== Merkmale von webtrees ===
Die folgenden Merkmale sind für webtrees charakterisierend
* webtrees enthält kein Content Management System (CMS)<ref>{{wikipedia-Link|Content-Management-System}}</ref> und lässt sich auch nicht so einfach in ein solches integrieren. Die HTML-Blöcke auf der Startseite von webtrees können zur bebilderten Einführung in einen Stammbaum dienen, sind aber in ihren Funktionen im Vergleich zu einem CMS sehr rudimentär.
* Zur Dokumentation von genetischen (DNA)<ref>{{wikipedia-Link|Genetische Genealogie}}</ref> Informationen bietet webtrees keine direkte Unterstützung.
* An vielen Stellen, etwa in Notizen oder Quellen, wird das Markdown-Format<ref>{{wikipedia-Link|Markdown}}</ref> unterstützt. Mit diesem können Texte mit einfachen Steuerzeichen formatiert dargestellt werden; das kann man etwa bei der Darstellung von transkribierten Texten oder Tabellen zu Volkszählungen einsetzen ohne dass solche Textelemente ihre Austauschbarkeit mit anderen Genealogieprogrammen verlieren, die Markdown nicht unterstützen.
* Zu Personen können ausführliche, bebilderte [[Webtrees Handbuch/Anleitung für Bearbeiter#Geschichten|und übersetzbare Geschichten]] erstellt werden (als Alternative zu "shared Notes mit Markdown"). Allerdings lassen diese sich nicht im GEDCOM-Format exportieren und können somit nicht mit anderen Programmen ausgetauscht werden.

=== GEDCOM-Standards und webtrees ===
webtrees unterstützt den GEDCOM-Standard 5.5.1<ref>https://gedcom.io/specifications/ged551.pdf</ref> beim Im- und Export vollständig; teilweise wird aber von diesem Standard abgewichen, etwa im Vorgriff auf Festlegungen im GEDCOM-Standard 7.0<ref>https://gedcom.io/specifications/FamilySearchGEDCOMv7.pdf</ref>, der in einer zukünftigen Version von webtrees unterstützt werden wird. Diese Abweichungen vom GEDCOM-Standard 5.5.1 sind

* Rufnamen werden unterstrichen, wenn an den Rufnamen ein Stern "*" angehängt wird; etwa bei: Rainer Roman* Schuster.
* Spitznamen werden im Namensfeld in Anführungszeichen dargestellt; etwa bei: Josef "Sepp" Hinterhuber.
* Die Schreibweise von spanischen oder portugiesischen Namen kann auch mit zwei durch "/" abgegrenzten Namensbestandteilen erfolgen, etwa bei '''Óscar Arnulfo Romero y Galdámez'''
1 NAME Óscar Arnulfo /Romero/ y /Galdámez/
2 GIVN Óscar Arnulfo
2 SURN Romero, Galdámez

* In der Beziehung eines Kindes zu seinen Eltern wird neben einem adoptierten Kind oder einem Pflegekind auch "RADA" unterstützt (Kind im Bezug zu seiner Amme).
* Neben den üblichen Kalendersystemen (gregorianischer, julianischer, jüdischer Kalender sowie französischer Revolutionskalender) werden auch der islamische Kalender und der Jalali-Kalender unterstützt.<ref>siehe Abschnitt "[[Webtrees_Handbuch/Anleitung_für_Bearbeiter#Kalendersysteme|Kalendersysteme]]" im Kapitel "[[Webtrees_Handbuch/Anleitung_für_Bearbeiter|Anleitung für Bearbeiter]]"</ref>
* Viele unterschiedliche GEDCOM-Dialekte, wie sie von diversen genealogischen Programmen genutzt werden, können importiert, bearbeitet und auch wieder exportiert werden.<ref>siehe webtrees Quellcode "[https://github.com/fisharebest/webtrees/tree/main/app/CustomTags webtrees/app/CustomTags/]"</ref>
* Die Festlegungen im [https://genealogy.net/GEDCOM/ GEDCOM-L-Addendum] werden unterstützt, wenn der Administrator diese aktiviert.<ref>siehe Abschnitt "[[Webtrees_Handbuch/Anleitung_für_Administratoren/Webseite#GEDCOM-Kennzeichen|GEDCOM-Kennzeichen]]" im Kapitel "[[Webtrees_Handbuch/Anleitung_für_Administratoren|Anleitung für Administratoren]]"</ref>
* Es werden intern bereits jetzt etliche Konstruktionen des GEDCOM-Standards 7.0 unterstützt<ref>siehe webtrees Quellcode "[https://github.com/fisharebest/webtrees/blob/main/app/CustomTags/Gedcom7.php webtrees/app/CustomTags/Gedcom7.php]"</ref>, allerdings werden diese noch nicht alle in der Bedienoberfläche angeboten.
** Beim Geschlecht von Personen wird neben "M" (männlich), "F" (weiblich) und "U" (unbekannt) auch "X" unterstützt, was immer dann verwendet werden kann, wenn das binäre System "männlich/weiblich" nicht zutrifft.
** RESN ist in allen Typen von Datensätzen erlaubt; zusätzlich gibt es <code>RESN none</code>; als Aufzählungsform wird unterstützt <code>RESN PRIVACY, LOCKED.</code><ref>siehe Abschnitt "[[Webtrees_Handbuch/Anleitung_für_Webmaster/Anleitung_Upgrade_21#Mehrere_RESN-Tags_in_einem_Datensatz|Mehrere RESN-Tags in einem Datensatz]]"</ref>
** Datumsangaben können mit dem Zusatz "vor" (BEF) oder "nach" (AFT) erfolgen, etwa um anzugeben dass ein Ereignis vor dem 1.1.1900 stattgefunden hat. webtrees interpretiert eine solche Angabe so, dass das genannte Datum nicht dazu gehört; dies steht im Widerspruch zu der umstrittenen Definition im GEDCOM-Standard 7.0.
** TIME ist an vielen Stellen unter DATE erlaubt, etwa um den Geburtstermin oder den Todeszeitpunkt genauer zu beschreiben.
** FACT ist auch unter FAM erlaubt.
** Unter FAM:NCHI werden auch Detailangaben erlaubt; der Standard 5.5.1 erlaubt die weiteren Angaben zur Anzahl der Kinder (wie etwa eine Quellenangabe) nur unter INDI:NCHI.
**webtrees unterstützt in einer GEDCOM-Datei derzeit keine XREFs, die sich nur durch Groß-/Kleinschreibung unterscheiden. Im GEDCOM-Standard 7.0 sind in einer XREF nur Großbuchstaben (A..Z), Ziffern (0..9) und das Zeichen "_" (Unterstrich) erlaubt, so dass es keinen Sinn machen würde, am derzeitigen Verhalten von webtrees noch etwas zu ändern. Wenn webtrees selbst eine XREF erzeugt, hat diese die Struktur "Xnnn", also dem Großbuchstaben "X", gefolgt von einer beliebigen Folge von Ziffern. Durch ein Vesta-Erweiterungsmodul kann dieses Verhalten geändert werden.
** Der Export einer GEDCOM-Datei, die dem Standard 5.5.1 folgt, kann zusätzlich auch bereits nach dem mit GEDCOM 7.0 eingeführten Dateiformat <code>.gdz</code> erfolgen und alle Multimediadateien enthalten, die im Baum referenziert werden.<ref>[https://gedcom.io/specifications/FamilySearchGEDCOMv7.html#gedzip The FamilySearch GEDZIP file format]</ref>
== Vergleich mit anderen Programmen ==
Um webtrees mit anderen Genealogieprogrammen vergleichen zu können, muss man sich die verschiedenen Gruppen von Kategorien für solche Programme ansehen.

Zum einen kann man unterscheiden, auf welchen Systemen oder Plattformen ein Programm installiert ist

* Betriebssystem-abhängig
** PC mit [https://de.wikipedia.org/wiki/Microsoft_Windows Windows] oder [https://de.wikipedia.org/wiki/MacOS MacOS] oder [https://de.wikipedia.org/wiki/Linux Linux]
** Mobiles Gerät mit [https://de.wikipedia.org/wiki/Android_(Betriebssystem) Android] oder [https://de.wikipedia.org/wiki/IOS_(Betriebssystem) iOS]
* Betriebssystem-unabhängig (meist über einen Browser)
** eigener Server (im Internet oder lokal)
** Dienst im Internet (etwa als Software as a Service von [[MyHeritage]], [[FamilySearch]], [[Geneanet|GeneaNet]], [[Ancestry]], [[WikiTree]], usw.)

Zusätzlich kann auch nach dem grundsätzlichen Ansatz eines Programmes unterschieden werden
* vollumfängliches Programm (Bearbeiten und Darstellen von genealogischen Daten)
** ergebnisorientiert
** evidenzbasiert
* Hilfsprogramm (fokussiert etwa auf Plausibilitätstests oder auf die Druckausgabe von grafischen Darstellungen)

Und man kann die Programme nach ihrem kommerziellen Ansatz gruppieren
* kostenlos
* Einmalkauf
* Abonnement

Das Programm webtrees findet sich in der Klasse der vollumfänglichen, ergebnisorientierten, kostenlosen Programme auf einem eigenen Server (wobei für den Betrieb eines webtrees-Servers üblicherweise ein Abonnementmodell hinzukommt).

Es macht wenig Sinn webtrees mit genealogischen Hilfsprogrammen zu vergleichen und es macht nur sehr eingeschränkt Sinn webtrees mit einem Genealogieprogramm zu vergleichen, das auf einem PC oder einem mobilen Gerät installiert wird, da diese Programme dann eben nur von genau einem einzigen Nutzer bedient werden können, was sich sehr stark vom Ansatz von webtrees unterscheidet. Allerdings gibt es inzwischen einige Programme aus diesen beiden Kategorien, die die lokalen Genealogiedaten in eine Cloud spiegeln und dort für weitere Endgeräte eines Nutzers zugänglich machen oder sogar für weitere Nutzer zumindest darstellbar machen.

Auf den Vergleich mit Genealogiediensten wie [[FamilySearch]] oder [https://de.wikipedia.org/wiki/Geni.com Geni], bei denen man die Hoheit über die Daten aus der Hand gibt, wird in der Einleitung zum Kapitel "[[Webtrees Handbuch/Genealogischer Prozess|Genealogischer Prozess]]" eingegangen.

Sinnvoll ist also ein Vergleich von webtrees mit anderen Genealogieprogrammen, die auf einem eigenen Server im Internet betrieben werden können. Die beiden Programme [[TNG]] und [[GeneWeb]] sind von ihrer Bedeutung her mit webtrees gut vergleichbar. Sie werden deshalb in jeweils einem eigenen Abschnitt noch genauer beschrieben. Eine allgemeine Übersicht über Genealogieprogramme finden Sie im [[Portal:Software|Software-Portal im GenWiki]].

=== Allgemeine Informationen zu vergleichbaren Programmen ===
{| width="100%" border="0"
|-
| width="25%" style="vertical-align:top;" |
Die in der Tabelle rechts aufgeführten vollumfänglichen Genealogieprogramme werden üblicherweise auf einem Web-Server im Internet installiert. Sie verwenden alle html als Auszeichnungssprache. Der Zugriff auf die Server-Anwendungen erfolgt mit einem Browser auf dem Client-Rechner.
|
{| class="wikitable" style="font-size: 90%; text-align: center"
|+ Programm-Vergleich - Allgemeine Informationen
|-
! rowspan="2" | Programm
! colspan="2" | Letzte Version
! rowspan="2" | Lizenz
! rowspan="2" | kostenlos
! rowspan="2" | Programmiersprachen
! rowspan="2" | Datenbank
|-
! Version 
! Datum 
|-
| [http://www.geneotree.com GeneoTree]
| 4.1
| Januar 2022
| geschützt
| ja
| JavaScript, PHP
| MySQL
|-
| [[GeneWeb]]
| 7.0
| Oktober 2020
| GPL-2
| ja
| OCaml
| ?
|-
| [https://gramps-project.github.io/web/ Gramps Web]
| 0.14.0
| September 2022
| Affero GPL-3
| ja
| JavaScript, Python
| SQLite
|-
| [https://hoeh.family hoeh.family]
| Beta
| Anfang 2023
| ?
| ja
| JavaScript, PHP
| MySQL
|-
| [https://humogen.com/ HuMo-genealogy]
| 5.10
| März 2022
| GPL-3
| ja
| JavaScript, PHP
| MySQL
|-
| [[PhpGedView]]
| 4.3.0
| November 2017
| GPL-2
| ja
| JavaScript, PHP
| MySQL, PostgreSQL, SQLite, SQL-Server
|-
| [[TNG]]
| 14.0.1
| Februar 2023
| geschützt
| nein
| JavaScript, PHP
| MySQL
|-
| [[webtrees]]
| 2.1.16
| Januar 2023
| GPL-3
| ja
| JavaScript, PHP
| MySQL, MariaDB, PostgreSQL, SQLite, SQL-Server
|}
|}

=== Funktionen ===
{| class="wikitable" style="font-size: 90%; text-align: center;" width="100%"
|+ Programm-Vergleich - Funktionen
|-
! Programm
! Verwaltung
! GEDCOM
! Notizen
! Orte
! Fotos
! Suche
! Quellen
! Video
! WordPress Integration
! Web-API
|-
| [http://www.geneotree.com Geneotree]
| ja
| 5.5.1
| ja
| ja
| ja
| ja
| ja
| nein
| nein
|nein
|-
| [[GeneWeb]]
| ?
| 5.5.1
| ja
| nein
| ja
| ja
| ja
| nein
| nein
|nein
|-
| [https://gramps-project.github.io/web/ Gramps Web]
| ja
| 5.5.1
| ja
| ja
| ja
| ja
| ja
| nein
| nein
|ja
|-
| [https://hoeh.family hoeh.family]
| ja
| 5.5.1
| ja
| ja
| ja
| ja
| ja
| nein
| nein
|nein
|-
| [https://humogen.com/ HuMo-genealogy]
| ja
| 5.5.1
| ja
| ja
| ja
| ja
| ja
| ja
| nein
|nein
|-
| [[PhpGedView]]
| ja
| 5.5.1
| ja
| ja
| ja
| ja
| ja
| ja
| nein
|ja
|-
| [[TNG]]
| ja
| 5.5.1 (7.0)
| ja
| ja
| ja
| ja
| ja
| ja
| ja
|nein
|-
| [[webtrees]]
| ja
| 5.5.1 (7.0)
| ja
| ja
| ja
| ja
| ja
| ja
| nein
|nein
|}

=== Präsentationsformate ===
{| class="wikitable" style="font-size: 90%; text-align: center;"
|+ Programm-Vergleich - Präsentationsformate
|-
! Programm
!Personenansicht
!Familienansicht
! Vorfahrenbaum
! Nachkommenbaum
! Beziehungspfad
! Zeitlinien
!Landkarten
!Historische Daten
|-
| [http://www.geneotree.com Geneotree]
|ja
|ja
| ja
| ja
| nein
| nein
|ja
|nein
|-
| [[GeneWeb]]
|ja
|ja
| ja
| ja
| ja
| nein
|nein
|nein
|-
| [https://gramps-project.github.io/web/ Gramps Web]
|ja
|ja
| ja
| ja
| nein
| nein
|ja
|ja
|-
| [https://hoeh.family hoeh.family]
|ja
|ja
| ja
| nein
| nein
| nein
|nein
|nein
|-
| [https://humogen.com/ HuMo-genealogy]
|ja
|ja
| ja
| ja
| ja
| ja
|ja
|ja
|-
| [[PhpGedView]]
|ja
|ja
| ja
| ja
| ja
| ja
|ja
|nein
|-
| [[TNG]]
|ja
|ja
| ja
| ja
| ja
| ja
|ja
|ja
|-
| [[webtrees]]
|ja
|ja
| ja
| ja
| ja
| ja
|ja
|ja
|}

=== Verwaltungsfunktionen ===
{| class="wikitable" style="font-size: 90%; text-align: center;"
|+ Programm-Vergleich - Verwaltungsfunktionen
|-
! Programm
! Datensicherung
! Benutzerspezifische Ereignisse
! Genetik (DNA)
! Duplikate finden
! Datenzusammenführung
! Erweiterungsmodule
! Mehrere Stammbäume
! Datenschutzeinstellungen
! Plausibilitätsprüfungen
|-
| [http://www.geneotree.com Geneotree]
| ?
| ?
| ?
| ?
| ?
| ?
| ?
| ?
| ?
|-
| [[GeneWeb]]
| ja
| ?
| nein
| ?
| ?
| nein
| ja
| nein
| ?
|-
| [https://gramps-project.github.io/web/ Gramps Web]
| nein
| nein
| ?
| nein
| nein
| nein
| nein
| ja
| ?
|-
| [https://hoeh.family hoeh.family]
| geplant
| ja
| nein
| nein
| nein
| geplant
| ja
| ja
| nein
|-
| [https://humogen.com/ HuMo-genealogy]
| ja
| ja
| (ja)
| ja
| ja
| ja
| ja
| ja
| ja
|-
| [[PhpGedView]]
| ja
| ?
| nein
| nein
| ?
| nein
| ja
| ja
| nein
|-
| [[TNG]]
| ja
| ja
| ja
| ja
| ja
| ja
| ja
| ja
| (ja)
|-
| [[webtrees]]
| ja
| ja
| nein
| ja
| ja
| ja
| ja
| ja
| nein
|}

{{WT-ToDo|fehlende Informationen zu Geneotree und GeneWeb ergänzen}}

=== Bedienoberfläche ===
{| class="wikitable" style="font-size: 90%; text-align: center;"
|+ Programm-Vergleich - Bedienoberfläche
|-
! Programm
! Jahrestage
! Favoriten
! Fotoübersicht
! PDF Berichte
! Nutzerregistrierung
! Mehrsprachig
! Themen
! Hilfe
|-
| [http://www.geneotree.com Geneotree]
| ?
| ?
| ?
| ja
| ?
| ?
| ?
| ?
|-
| [[GeneWeb]]
| ?
| ?
| ?
| nein
| nein
| ja
| ?
| ?
|-
| [https://gramps-project.github.io/web/ Gramps Web]
| ja
| nein
| ja
| ja
| ja
| ja
| nein
| nein
|-
| [https://hoeh.family hoeh.family]
| nein
| ja
| nein
| nein
| nein
| ja
| nein
| geplant
|-
| [https://humogen.com/ HuMo-genealogy]
| ja
| ja
| ja
| ja
| ja
| ja
| ja
| ja
|-
| [[PhpGedView]]
| ja
| ja
| ja
| ja
| ja
| ja
| ja
| ja
|-
| [[TNG]]
| ja
| ja
| ja
| ja
| ja
| ja
| ja
| ja
|-
| [[webtrees]]
| ja
| ja
| ja
| ja
| ja
| ja
| ja
| ja
|}

{{WT-ToDo|fehlende Informationen zu Geneotree und GeneWeb ergänzen}}

=== Vergleich mit TNG ===
{{WT-ToDo|TNG beschreiben, siehe [https://www.tngsitebuilding.com/ TNG Homepage] und [[TNG|TNG im GenWiki]]}}

=== Vergleich mit GeneWeb ===
{{WT-ToDo|GeneWeb beschreiben, siehe [https://geneweb.tuxfamily.org/wiki/GeneWeb GeneWeb wiki] und [[GeneWeb|GeneWeb im GenWiki]]}}

{{WT-ToDo|Was ist eventuell mit einem Vergleich mit HuMo-genealogy, KiwiTrees oder hoeh.family?
 Oder mit einem der Genealogie-Dienste: My Great Big Family, TribalPages, Famberry, ...?}}

=== Test zum Import und Export von GEDCOM-Daten ===
Beim Austausch von genealogischen Daten mit anderen Programmen ist es sehr wichtig, dass es dabei zu keinen Datenverlusten kommt. webtrees schneidet dabei hervorragend ab, da sich bei diesem Programm die internen Datenstrukturen sehr eng an den auszutauschenden [[GEDCOM]]-Datenstrukturen orientieren.

==== Testreihe zum Vergleich verschiedener Programme ====
[[Datei:WT_2.0_Vergleich_Import_Export.png|800px|border|Vergleich nach Im- und Export von GEDCOM-Daten|link=https://wiki-commons.genealogy.net/images/9/96/WT_2.0_Vergleich_Import_Export.png]]

Im Rahmen von Arbeiten der [[GEDCOM-L|GEDCOM-L-Gruppe]] zur Konformität mit dem GEDCOM-Standard 5.5.1 wurden im Mai 2020 und in der Folgezeit diverse Genealogieprogramme daraufhin untersucht, wie sie sich beim Import und anschließenden Export einer GEDCOM-Testdatei verhalten. Es wurde analysiert ob es dabei zu Datenverlusten kommt.

Die getesteten Programme wurden in zwei Kategorien eingeteilt
* vollumfängliche Genealogieprogramme
* Präsentationsprogramme
Die Präsentationsprogramme sind im wesentlich dazu gedacht GEDCOM-Daten darzustellen. Daher spielt es bei ihnen keine Rolle, wenn Datensätze, die sowieso eher nicht zur Anzeige kommen sollen, wie etwa SUBM oder SUBN, erst gar nicht importiert werden.

Bei diesem sehr speziellen Test hat webtrees sehr gut abgeschnitten. webtrees war das einzige Programm, das alle importierten Datensätze auch wieder exportiert hat. Bei allen anderen Programmen gab es mehr oder weniger große Änderungen nach dem Export. Zur Spitzengruppe gehören
* [[webtrees]]
* [[Ahnenblatt]]
* [[GEN_DO|GEN_DO!]]
* [http://www.tcgr.bufton.org/tcgbover.htm The Complete Genealogy Builder (TCGB)]
Die Programme [[Stammbaumdrucker]] und [http://www.tcgr.bufton.org/tcgrover.htm The Complete Genealogy Reporter (TCGR)] haben in der Kategorie der Präsentationsprogramme ebenfalls gut abgeschnitten.

Die Auswahl der getesteten Programme ist eher willkürlich und richtet sich nach der Verfügbarkeit beim Testautor ([[Benutzer:Hartenthaler|Hermann Hartenthaler]]). Die [https://gitlab.genealogy.net/Hartenthaler/gedcom-testdatei/-/blob/main/addendum_R2_2021-02-03.ged Testdatei] ist konform zum
[[GEDCOM_5.5.1|GEDCOM-Standard in der Version 5.5.1]] mit Erweiterungen nach dem [https://genealogy.net/GEDCOM/ GEDCOM-Addendum] der [[GEDCOM-L|GEDCOM-L-Gruppe]]. Nicht alle der getesteten Programme erheben den Anspruch, die im Addendum gemachten Erweiterungen zu unterstützen.

Die [https://gitlab.genealogy.net/Hartenthaler/gedcom-testdatei/-/blob/main/addendum_R2_2021-02-03.ged Testdatei] enthält 39 miteinander in 19 Familien verbundene Personen sowie die zugehörigen Quellen, Archive, Medienobjekte, Notizen und Ortsdatensätze. Es werden in der Testdatei sehr viele Sonderfälle abgedeckt, so dass die Anforderungen bezüglich einer korrekten Verarbeitung eher hoch sind. Die Testdatei wurde in allen getesteten Programmen eingelesen und sofort wieder exportiert (das Präsentationsprogramm [http://www.tcgr.bufton.org/tcgrover.htm The Complete Genealogy Reporter (TCGR)] unterstützt keinen Export). Dann wurde die exportierte GEDCOM-Datei mit zwei Validator-Programmen auf Konformität mit dem GEDCOM-Standard 5.5.1 (und Addendum) getestet
* [[ShowMeGedcom]]
* [https://chronoplexsoftware.com/gedcomvalidator/ Chronoplex]
Die jeweils exportierte Datei eines Genealogieprogramms wurde im Programm Notepad++ mit der Ausgangsdatei verglichen. Es wurde geprüft, welche Datensätze nach dem Export noch mehr oder weniger unverändert vorhanden sind. Das entsprechende Element in der oben dargestellten Tabelle wurde entsprechend grün oder rot eingefärbt.

Der Kopf einer GEDCOM-Datei (HEAD) wird vom exportierenden Programm bestimmungsgemäß neu generiert, so dass man nicht davon ausgehen kann, dass dort enthaltene Informationen nach einem Import und Export noch vorhanden sind. Allerdings definiert das Addendum der GEDCOM-L-Gruppe Elemente des HEADs, die Besonderheiten in der GEDCOM-Datei beschreiben, und die man auch nach dem Export dort noch finden möchte. Keines der getesteten Programme unterstützt das.

Eigentlich müsste man im Test auch noch untersuchen, ob die importierten Daten auch auf der Bedienoberfläche des jeweiligen Programms korrekt angezeigt werden und bearbeitbar sind. Dies ist einer weiteren Testrunde vorbehalten. webtrees zeigt alle hier importierten GEDCOM-Datenfelder an und lässt eine Bearbeitung durch den Benutzer zu (dazu muss die Option "GEDCOM-L" in der Systemverwaltung aktiviert sein<ref>siehe Abschnitt "[[Webtrees_Handbuch/Anleitung_für_Administratoren/Webseite#GEDCOM-Kennzeichen|GEDCOM-Kennzeichen]]" im Kapitel "[[Webtrees_Handbuch/Anleitung_für_Administratoren|Anleitung für Administratoren]]"</ref>); der Nutzer kann bei webtrees die Daten auch immer direkt auf der Ebene der GEDCOM-Syntax bearbeiten<ref>siehe Abschnitt "[[Webtrees_Handbuch/Nutzungserfahrungen#Arbeiten_auf_der_GEDCOM-Ebene|Arbeiten auf der GEDCOM-Ebene]]" im Kapitel "[[Webtrees_Handbuch/Nutzungserfahrungen|Nutzungserfahrungen]]"</ref>.

Die von ShowMeGedcom gefundenen Fehler nach dem Export durch webtrees waren
* @-Zeichen in Anwenderdaten nicht gedoppelt (mehrfach): eigentlich müsste etwa eine E-Mail-Adresse wie "fam@mustermann.name" als "fam@@mustermann.name" exportiert werden, aber nahezu kein Programm hält sich an diese Vorgabe im GEDCOM-Standard
* GEDCOM-Wert darf nicht mit Leerzeichen beginnen: der GEDCOM-Standard gibt vor, dass eine Fortsetzungszeile (CONC) nicht mit einem Leerzeichen beginnen darf; die Interpretationen zu dieser Festlegung sind kontrovers
* Die Angabe zu TYPE_OF_DEMOGRAPICAL_DATA ist unzulässig (mehrfach): im Ortsdatensatz kann man zu einem Ort die Anzahl der Häuser oder die Einwohnerzahl angeben; die Festlegung im Addendum zu diesem Element ist nicht präzise und so sind hier die Testdatei und die Prüfroutine im Validator nicht konsistent.

Die im Chronoplex-Validator aufgezeigten Probleme haben ihre Ursache im wesentlichen in den verwendeten Sprachelementen aus dem Addendum der GEDCOM-L-Gruppe, die dem GEDCOM-Standard widersprechen.

Keiner der aufgezeigten Fehler von webtrees wird voraussichtlich beim Datenaustausch mit anderen Programmen zu einem Problem führen. Dies ist ein ausgezeichnetes Ergebnis.

==== Stresstests ====
Ein Genealogieprogramm sollte auch mit ungewöhnlichen Daten zurechtkommen. Dazu hat [https://vitabrevis.americanancestors.org/author/tjones/ Tamura Jones] mehrere [https://www.tamurajones.net/DownloadTortureTests.xhtml Stresstests] konzipiert
* Married1200.ged - ein Mann ist mit 1.200 Frauen verheiratet
* Siblings1200.ged - ein Mann hat 1.200 Frauen und mit jeder Frau ein Kind, d.h. ein solches Kind hat 1.199 Halbgeschwister
* Children1200.ged - eine Mutter hat 1.200 Töchter
* Long26CC.ged - hier wird die Länge von Nachnamen getestet, 26 Personen haben immer längere Nachnamen

webtrees importiert alle diese GEDCOM-Dateien fehlerlos und präsentiert sie korrekt. Nur bei den beiden ähnlichen Tests "Married1200" und "Siblings1200" erfolgt beim Versuch den Reiter "Familie" zu öffnen eine Fehlermeldung, da zu viel Speicher benötigt wird (zumindest ist das bei manchen Servern so). Da sehr viele andere getestete Genealogieprogramme bei diesen Stresstests versagt haben, ist das ein sehr gutes Ergebnis für webtrees.

==== Test zur Kompatibilität mit GEDCOM 7.0 ====
Im April 2022 hat die GEDCOM-Standardisierungsgruppe eine [https://github.com/FamilySearch/GEDCOM.io/blob/master/testfiles/gedcom70/maximal70.ged Testdatei] veröffentlicht, die alle wesentlichen Sprachelemente des GEDCOM-Standards 7.0 enthält. Zur Prüfung ob sich ein Genealogieprogramm konform zum GEDCOM-Standard 7.0 verhält, kann man nun in einem ersten rudimentären Test diese Testdatei im zu testenden Programm importieren und gleich wieder exportieren. Danach kann man die exportierte GEDCOM-Datei mit einem bereitgestellten Validator-Programm einlesen und auf den Erhalt der Strukturen aus der Testdatei und die Konformität mit dem Standard 7.0 testen.

webtrees ist in der aktuellen Version 2.1 noch nicht konform zum GEDCOM-Standard 7.0, kann aber GEDCOM-Dateien im Format des 7.0-Standards bereits importieren und die enthaltenen Datensätze zumindest eingeschränkt darstellen. Die Datensätze können von einem Nutzer auch bearbeitet werden. Ein Export als GEDCOM-Datei ist ebenso möglich, wobei dieser Export im Kopf der GEDCOM-Datei mit "5.5.1" gekennzeichnet wird, obwohl es sich um einen Inhalt nach "7.0" handelt (siehe unten).

Der am 24. April 2022 (von [https://team.genealogy.net/user/8105/ Peter Schulz]) durchgeführte Test ergab einen hervorragenden Kompatibilitätsindex von 99% für webtrees. Es wurden lediglich 4 Zeilen im Kopf der GEDCOM-Testdatei (HEAD) durch vier andere Zeilen ersetzt.

Structures removed: 4
Line 3: 2 HEAD.GEDC.VERS 7.0
Line 4: 1 HEAD.SCHMA
Line 5: 2 HEAD.SCHMA.TAG _SKYPEID http://xmlns.com/foaf/0.1/skypeID
Line 6: 2 HEAD.SCHMA.TAG _JABBERID http://xmlns.com/foaf/0.1/jabberID

Structures added: 4
Line 9: 2 HEAD.GEDC.VERS 5.5.1
Line 10: 2 HEAD.GEDC.FORM LINEAGE-LINKED
Line 11: 1 HEAD.CHAR UTF-8
Line 12: 1 HEAD.FILE tree1.ged

Diese von webtrees im Kopf der GEDCOM-Datei vorgenommenen Änderungen sind verständlich und werden voraussichtlich beim Datenaustausch mit anderen Programmen, die bereits zum Standard 7.0 konform sind, zu keinen Problemen führen. Dies ist ein ausgezeichnetes Ergebnis.

== Versionsgeschichte ==
Die derzeit aktuelle Version von webtrees ist 2.1.16 vom 16. Januar 2023. Diese Version ist eine stabile Version und daher für Produktivsysteme geeignet; sie ist auch die Grundlage für dieses Handbuch.

Eine Erklärung zur Syntax der Versionsbezeichnung findet sich im Kapitel [[Webtrees Handbuch/Anleitung für Webmaster#Versionen_von_webtrees|"Anleitung für Webmaster"]].

Neben einer aktuellen stabilen Version gibt es immer auch noch eine in Entwicklung befindliche nächste Version, die aber nur in Testsystemen zum Einsatz kommen sollte. Und es gibt die Version 1.7.20 als letzte Version aus der Entwicklungslinie der 1.7er-Versionen; diese Version wird nicht mehr gepflegt, sie ist aber eventuell noch relevant für Nutzer, die nicht auf eine aktuelle PHP-Version wechseln können (1.7.20 kann mit den PHP-Versionen 5.3 bis 7.3 genutzt werden). Die letzte Version aus dem 2.0-Strang ist die Version 2.0.26. Zur Version 2.0.26 wird es voraussichtlich keine weiteren Upgrades mehr geben.

webtrees wurde Anfang 2010 vom Genealogieprogramm [[PhpGedView]] abgezweigt<ref>{{wikipedia-Link|PhpGedView}}</ref>. Diese zweite Abzweigung (Ende 2005 wurde bereits [[Genmod]]<ref>[http://www.genmod.net/ www.genmod.net] (Abruf 30.10.2011)</ref><ref>[http://sourceforge.net/projects/phpgedview/forums/forum/185165/topic/1372794 Roland Dalmulder: A new start…] in PhpGedView Forums, 24.10.2005 (Abruf 07.06.2022)</ref> abgezweigt) wurde von der Mehrheit der aktiven PhpGedView-Entwickler getragen, die nicht mehr auf SourceForge weiterarbeiten wollten<ref>[http://sourceforge.net/projects/phpgedview/forums/forum/185165/topic/3549640 Greg Roach: PGV blocked in Cuba, Syria, etc.] in PhpGedView Forums, 10.02.2010 (Abruf 07.06.2022)</ref><ref>[http://sourceforge.net/projects/phpgedview/forums/forum/185165/topic/3558977 John Finlay: Future of PGV] in PhpGedView Forums, 18.02.2010 (Abruf 07.06.2022)</ref>. Ursache waren dortige Probleme beim Export verschlüsselter Software<ref>[http://sourceforge.net/blog/clarifying-sourceforgenets-denial-of-site-access-for-certain-persons-in-accordance-with-us-law/ Lee Schlesinger: Clarifying SourceForge.net’s denial of site access for certain persons in accordance with US law] in SourceForge blog, 25.01.2010 (Abruf 07.06.2022)</ref><ref>[http://sourceforge.net/blog/some-good-news-SourceForge-removes-blanket-blocking/ Lee Schlesinger: Some good news: SourceForge removes blanket blocking] in SourceForge blog, 07.02.2010 (Abruf 07.06.2022)</ref>.

Im Jahr 2011 hat sich das Programm [https://www.kiwitrees.net/ Kiwitrees] aus webtrees abgespalten und wird seither vom Entwickler Nigel Osborne unabhängig weiterentwickelt.

Die Architektur und der Funktionsumfang bis zur Version 1.7 war noch eng mit dem Vorgänger PhpGedView verwandt. Mit der Umstellung der kompletten Anwendung auf das Laravel-Framework<ref>{{wikipedia-Link|Laravel-Framework}}</ref> mit der webtrees-Version 2.0.0 im Dezember 2019 wurde der innere Aufbau wesentlich modularer und ermöglicht eine bessere Wartbarkeit und eine einfachere Möglichkeit zur Erweiterung. Die webtrees-Version 2.1 brachte die Unterstützung diverser GEDCOM-Dialekte und unterstützt nun PHP ab der Version 8.0, was wichtig ist, da es für PHP 7.4 seit dem 28. November 2022 keine Sicherheits-Updates mehr gibt (es sei denn dass der Anbieter eines Betriebssystems weiterhin für Sicherheits-Updates sorgt). Die für das erste Quartal 2023 geplante Version 2.2 von webtrees wird PHP 7.4 nicht mehr unterstützen, sie wird also PHP 8.0 bis 8.2 voraussetzen.

[[Datei:WT-Entwicklungsverlauf.svg|left|750px|Übersicht zur Entwicklung von webtrees|verweis=Special:FilePath/WT-Entwicklungsverlauf.svg]]

{| class="wikitable"
|+ [https://github.com/fisharebest/webtrees/releases Auszug der veröffentlichten Versionen]
|-
!Freigabedatum
!Release
|-
|25.08.2010 || 1.0
|-
|28.02.2011 || 1.1
|-
|07.06.2011 || 1.2
|-
|04.06.2012 || 1.3
|-
|06.03.2013 || 1.4
|-
|09.11.2013 || 1.5
|-
|12.10.2014 || 1.6
|-
|11.07.2015 || 1.7
|-
|07.12.2019 || 2.0.0 und 1.7.16
|-
|11.05.2020 || 1.7.17
|-
|18.06.2020 || 2.0.6
|-
|10.03.2021 || 1.7.18
|-
|11.03.2021 || 2.0.12
|-
|02.12.2021 || 1.7.19 und 2.0.18
|-
|16.03.2022 || 2.0.21 und 2.1.0-beta.1
|-
|03.04.2022 || 2.0.23
|-
|20.04.2022 || 2.1.0
|-
|29.04.2022 || 2.1.1
|-
|04.05.2022 || 2.1.2
|-
|21.05.2022
|2.1.3
|-
|22.05.2022
|2.1.4
|-
|04.06.2022
|2.1.5 und 1.7.20 (end of life v1.x) und 2.0.24
|-
|20.06.2022
|2.0.25
|-
|21.06.2022
|2.1.6

|-
|29.07.2022
|2.1.7
|-
|27.11.2022
|2.1.8
2.0.26 (end of life v2.0.x)
|-
|30.11.2022
|2.1.9
|-
|04.12.2022
|2.1.10
|-
|05.12.2022
|2.1.11
2.1.12
|-
|15.12.2022
|2.1.13
|-
|24.12.2022
|2.1.14
|-
|25.12.2022
|2.1.15
|-
|16.01.2023
|2.1.16
|}
{{-}}

== Beispielhafte Installationen ==
Es gibt zwei Demoversionen von webtrees
* [http://dev.webtrees.net/demo-stable Letzte stabile Version]
* [http://dev.webtrees.net/demo-dev/ Letzte Beta Version]
Man kann sich dort mit einem der folgenden Nutzerkonten und dem zugehörigen Passwort anmelden um die verschiedenen Rollen auszuprobieren
* member/member
* editor/editor
* moderator/moderator

webtrees wird weltweit auf mehr als 6.000 Servern betrieben, davon mehr als 1.800 im deutschsprachigen (D/A/CH) Raum (siehe [https://dev.webtrees.net/statistics.html Installationsstatistik]). Viele Installationen sind öffentlich zugänglich. Einige sind in einer [https://webtrees.net/demo/gallery/ Galerie] aufgelistet.

== Nutzerbeurteilung ==
Die Nutzer von webtrees sind überwiegend mit diesem Genealogieprogramm sehr zufrieden, wie im Folgenden näher dargestellt wird. Die erste Begegnung kann aber auch sehr frustrierend sein, da die Einstiegshürden für eine Web-basierte Anwendung ungleich höher sind im Vergleich zur Installation einer App oder eines Programmes für PC oder Mac.

=== Beurteilungen im Portal GenSoftReviews ===
[[Datei:Webtrees_GenSoftReviews_2022.png|thumb|right|400px|Beurteilung bei GenSoftReviews|verweis=Special:FilePath/Webtrees_GenSoftReviews_2022.png]]
Bei [https://www.gensoftreviews.com/?p=1244 GenSoftReviews] werden regelmäßig Beurteilungen von webtrees-Nutzern veröffentlicht. In der Kategorie der Online-Genealogieprogramme ist webtrees das dort derzeit (in 2022) am besten beurteilte Programm.

{{-}}

=== Testberichte in der Computergenealogie ===

Über webtrees wurde wiederholt in der Zeitschrift "[[Computergenealogie]]" berichtet. Verweise zu den entsprechenden Heften finden Sie im [[Computergenealogie/Register/W|Register der Zeitschrift unter W]].


In 2018 gab es eine Umfrage zur Zufriedenheit mit Genealogie-Software. Berichtet wurde darüber im März- und im April-Heft der [[Computergenealogie]] in drei Beiträgen:
* "Die „besten“ Genealogieprogramme unter Windows" ([[Computergenealogie/2018/Heft 3|Heft 3/2018]] mit Korrektur in [[Computergenealogie/2018/Heft 4|Heft 4/2018]])
* "Die „besten“ Genealogieprogramme für den Mac" ([[Computergenealogie/2018/Heft 4|Heft 4/2018]])
* "Die „besten“ Genealogieprogramme für Linux" ([[Computergenealogie/2018/Heft 4|Heft 4/2018]]).

webtrees ist zwar kein Programm für den Windows-PC oder einen Mac und auch nicht unbedingt für einen Linux-PC, kann aber natürlich mit einem Browser auf allen diesen Geräten genutzt werden; daher erschien webtrees in den jeweiligen Umfrageergebnissen.

Das Programm landete bei der Zufriedenheit der Windows-Nutzer auf dem vierten Platz, bei der Anzahl der Nutzer kam webtrees in dieser Kategorie aber nicht unter die ersten zehn. Die Reihung der vier bestbewerteten Programme unter Windows war: Gen_Pluswin, TNG, Stammbaumdrucker, webtrees (in der Ergebnisdarstellung im [[Computergenealogie/2018/Heft 3|Heft 3/2018]] gab es einen Fehler, der dann im [[Computergenealogie/2018/Heft 4|Heft 4/2018]] korrigiert worden ist).

Bei den Mac-Anwendern lag webtrees in der Zufriedenheit auf Platz 2 hinter dem Programm "MacStammbaum". Bezüglich der Anzahl der Nutzer landete webtrees bei den Mac-Nutzern auf Platz 8, knapp hinter TNG.

In der Umfrage zu den Genealogieprogrammen gab es nur wenige Nutzer, die einen Linux-PC verwenden. Von diesen nutzen die meisten das Programm "Gramps". webtrees landet bezüglich der Nutzeranzahl mit deutlichem Abstand auf Platz 2. In der Zufriedenheit der Linux-Anwender war die Reihung der vier besten Programme: TNG, Gramps, webtrees, GeneWeb.

<gallery widths="210" heights="190" perrow="3" caption="Beurteilungen und Nutzungszahlen" style="text-align:center">
Datei:WT-CG20184_Windows_Zufriedenheit_webtrees.png|Beurteilung der Zufriedenheit bei den Windows-Nutzern ([[Computergenealogie/2018/Heft 4|Computergenealogie Heft 4/2018)]])
Datei:WT-CG20184_Mac_webtrees.png|Beurteilung der Zufriedenheit bei den Mac-Nutzern ([[Computergenealogie/2018/Heft 4|Computergenealogie Heft 4/2018)]])
Datei:WT-CG20184_Linux_Nutzung_webtrees.png|Nutzungszahlen bei den Linux-PC-Nutzern ([[Computergenealogie/2018/Heft 4|Computergenealogie Heft 4/2018)]])
</gallery>

== Nutzeranforderungen ==
Um webtrees zufriedenstellend selbst betreiben zu können, benötigt man spezielle Kenntnisse
* Grundverständnis von Web-Servertechnik
* Grundkenntnisse der englischen Sprache

Und man muss einige Stunden Einarbeitungszeit spendieren.

Um webtrees selbst zu installieren, muss man bei einem [[Webtrees Handbuch/Anleitung_für_Webmaster#Auswahl_eines_Hosting-Anbieters|Anbieter]] einen sicheren Webserver mit einer Domain sowie eine Datenbank anmieten. Dann muss man die Software auf den Webserver hochladen und installieren und mit der Datenbank verknüpfen. Details zur Installation findet man in diesem Handbuch im Kapitel [[Webtrees Handbuch/Anleitung für Webmaster|"Anleitung für Webmaster"]]. Alternativ kann man sich für die Einrichtung und den Betrieb an einen auf webtrees spezialisierten [[Webtrees_Handbuch/Anleitung_für_Webmaster#Spezialisierte_Hosting-Anbieter_für_webtrees|Anbieter]] wenden.

Danach kann man Nutzer einrichten und dann mit der Eingabe genealogischer Daten beginnen oder eine GEDCOM-Datei hochladen.

Wenn man webtrees anpassen möchte, kann man [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodule]] aussuchen und installieren. Wenn man über Kenntnisse im objektorientierten Programmieren mit PHP und mit JavaScript verfügt, kann man solche Module auch selbst erstellen.

== Entwickler ==
Der Hauptentwickler von webtrees ist [https://github.com/fisharebest Greg Roach]. Daneben entwickeln viele weitere Programmierer [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule|Erweiterungsmodule]] für webtrees, die meist auf [https://github.com/ Github] veröffentlicht werden.

== Preis ==
Da webtrees als [https://de.wikipedia.org/wiki/Open_Source Open Source] veröffentlicht wird, fallen für dieses Programm keine Lizenzkosten an. Allerdings kostet das Betreiben eines Web-Dienstes abhängig von der konkreten Lösung zwischen 0 € und etwa 12 €/Monat. Näheres dazu findet sich im Abschnitt "[[Webtrees Handbuch/Anleitung für Webmaster#Auswahl_eines_Hosting-Anbieters|Auswahl eines Hosting-Anbieters]]" im Kapitel "[[Webtrees_Handbuch/Anleitung_für_Webmaster|Anleitung für Webmaster]]".

Wer sich für die Bereitstellung und Weiterentwicklung von webtrees bedanken möchte, kann auf einer [https://donate.webtrees.net/ Webseite] einen freiwilligen Betrag spenden.

== Weitere Informationen ==

=== Verweise ===
* [[Webtrees_Handbuch/Sonstige_Dokumentation_zu_webtrees|Sonstige Dokumentation]] zu webtrees
* [http://webtrees.net/ webtrees Webseite]
* {{wikipedia-Link|Webtrees}} (es gibt Artikel zu webtrees in folgenden Wikipedias: deutsch, englisch, griechisch, französisch, schwedisch und spanisch)
* [[Webtrees|Steckbrief des Programms im GenWiki]]
* [https://www.wikidata.org/wiki/Q309656 webtrees bei Wikidata]

=== Austauschforen ===
Das englischsprachige [https://www.webtrees.net/index.php/en/forum webtrees-Forum] dient dem Austausch mit anderen webtrees-Nutzern. Man sollte sich dort unbedingt als Nutzer anmelden, da in diesem Forum aktuelle Informationen verteilt werden und man dort zu allen Problemen sehr kurzfristig und kompetent Hilfe bekommt. Näheres dazu ist im Abschnitt "[[Webtrees Handbuch/Entwicklungsumgebung#Klärung_von_Fragen|Klärung von Fragen]]" beschrieben.

Im System "[https://discourse.genealogy.net Discourse]" von [https://www.compgen.de CompGen] gibt es einen eher wenig genutzten [http://list.genealogy.net/mm/listinfo/php-gedview-l Themenstrang] zu webtrees.

== Einzelnachweise ==
<references />

[[Kategorie:Webtrees]]