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

Info

Handbuch Im Aufbau...

Bitte haben Sie noch ein wenig Geduld..

Abschnitt 8.10.1 - GVExport <-  Zu Abschnitt 8.10 - Erweiterungsmodule <-  Zu Kapitel 8 - Anleitung für Webmaster <-  Zur Kapitelübersicht

Das Erweiterungsmodul stellt ein weiteres Diagramm zur Verfügung, das einen vollständigen Baum mit Ehepartnern, Vorfahren und Nachkommen anzeigen kann. Die Grafiken können mit GraphViz weiter bearbeitet werden (dieses Programm kann eventuell auch auf dem Server installiert werden).

Steckbrief

---

• Modulname: GVExport
• Autor: Neriderc
• Passende webtrees-Versionen: 2.1
• Speicherort: GitHub
• Modulkategorie: Genealogie
• Modulfunktion: Diagramm "GVExport"

Beschreibung

---

Der folgende Text stammt aus einem Forumsbeitrag und muss gründlich überarbeitet werden.

GVExport erstellt All-in-One-Bäume ausgehend von einzelnen oder mehreren ausgewählten Personen, einschließlich ausgewählter Arten von Verwandten (Vorfahren, Geschwister, Cousins, Nachkommen und Ehepartner) und einer ausgewählten Anzahl von Vorfahren- und Nachkommengenerationen. Die Ausgabe könnte als druckbares PDF, PNG oder JPG erstellt, aber auch auf dem Bildschirm angezeigt werden, wobei die SVG-Grafik die Grafiken „anklickbar“ macht, d. h. durch Klicken werden die Informationen der Person oder Familie geöffnet. Das Modul GVExport erzeugte gerade dot-Dateien, die eine Installation von GraphViz auf dem Server erforderten, um die schöne Grafikausgabe zu erhalten. Nach dem Erscheinen von webtrees erklärte der Autor Ferenc Kurucz, dass er seit über zwei Jahren nicht mehr an dem Modul gearbeitet habe und nicht vorhabe, es weiter zu tun. Mein Sohn hat GVExport auf webtrees 1.7 migriert und kürzlich auf webtrees 2.16 übernommen. Dadurch ergibt sich ein vereinfachtes und reduziertes Eingabemenü für die Diagrammpräferenzen. Seine wichtigste Änderung ist, dass Sie ohne GraphViz-Installation auf dem Server SVG-Grafiken auf dem Bildschirm Ihres Clients erzeugen können. Zu diesem Zweck ist im neuen GVExport-Modul ein Open-Source-graph.js-Modul (wie GraphViz in JavaScript) für die Clientanzeige enthalten. Um jedoch druckbare PDF-, PNG- oder JPG-Ausgaben zu erhalten, ist GraphViz immer noch auf dem Server erforderlich, auf dem Webtrees installiert ist. Es gibt einige bekannte Einschränkungen: keine Übersetzungen – nur Englisch (außer der Button-Beschriftung „Zurücksetzen“ = Reset) svg-anklickbare Ausgabe funktioniert nicht auf Android (Firefox) Fotos im dekorierten Diagrammtyp werden nur in der Client-Grafik angezeigt, nicht in der vom Server generierten Grafik Es gibt einige Problemumgehungen im Kernprogramm, die auf dem Buchstaben „F“ basieren, um die Familien-XRef zu starten. Ich verwende Vesta Classic Look&Feel, daher konnte ich mit den neuen eindeutigen „X“-xref-ids nicht auf Fehler testen. Beim Classic Look&Feel kommt man um die Anzeige individueller XRef-IDs nicht herum Da mein Sohn GVExport nicht mehr unterstützen kann, hoffe ich auf das Interesse fähiger Menschen in der webtrees-Community, den derzeitigen Stand von GVExport weiterzuentwickeln: github.com/tillsc/GVExport Aber einige von Ihnen finden das Modul vielleicht sogar im gegenwärtigen Zustand nützlich. So installieren Sie es auf dem Server: Laden Sie alle Dateien von obigem GitHub in das Verzeichnis modules_v4/GVExport herunter und aktivieren Sie das Plugin über die Modulverwaltungsseite. Um es in Webtrees zu verwenden: Wählen Sie es unter „Diagramme“ aus. In den „Diagrammeinstellungen“ wählen Sie mit dem Dropdown-Fenster Root-Personen („Jeden verwandten einbeziehen“) aus. Bevor Sie eine andere Stammperson hinzufügen, klicken Sie auf die CR-ähnliche Schaltfläche direkt unter dem Dropdown-Fenster. Die XRef-ID der vorangehenden Wurzelindividuen wird in das linke Fenster gestapelt. Sie können beliebig viele Root-Individuen hinzufügen. Sie können XRef-IDs sogar direkt im Fenster eingeben und bearbeiten. „Verarbeitung beenden bei“ kann verwendet werden, um die Auswahl von Vorfahren oder Nachkommen nach einem „Stopp-Individuum“ zu beenden, bevor die angegebene Anzahl von Generationen verarbeitet wurde. Die Eingabemethode für diese Felder ist die gleiche wie zuvor in „Jeden einbeziehen …“ Starten Sie die Anzeige des Baums auf Ihrem Bildschirm mit dem Button „Aktualisieren“. Wann immer Sie Eingabeparameter wie die Anzahl der Vorfahrengenerationen geändert haben, drücken Sie „Enter“ oder die Schaltfläche „Update“, um sofortige Ergebnisse zu erhalten. Mit der „X“-Taste oben rechts können Sie das Eingabemenü ausblenden. Das bisher Beschriebene funktioniert, ohne dass GraphViz auf dem Server installiert ist. Um eine druckbare Ausgabe zu erhalten, muss es installiert sein. Wählen Sie dann den Ausgabedateityp und drücken Sie „Serverseitig rendern“. Der Ausgabetyp pdf wird dringend empfohlen, da er die kleinsten Dateien liefert und leicht skalierbar ist, insbesondere für große Diagramme. Für sehr große Grafiken, z.B. 1x2 Meter gut geeignet für Plotter von Architekten. Solche Grafiken, die die Kapazität Ihres Heimdruckers übersteigen, werden von spezialisierten Online-Shops viel billiger als Poster verarbeitet als als Fotos oder Poster.

Geschichte des Erweiterungsmoduls GVExport

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 wollten.

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

• 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.
  • Geändert: X-Button-Patch und Mediendatei-Fix; Download-Option merken
• Version 2.1.1 (2022-06-01)
  • Behoben: von Personen ohne Partner, die im kombinierten Modus nicht angezeigt werden; Option „Nicht blutsverwandt markieren“; Aktualisieren von page.phtml
• Version 2.1.0 (2022-06-02)
  • 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 und Clientseitiges Graphviz-Rendering über viz.js
  • Geändert: Vollständiges Formular / Anpassung von JavaScript zur Kompatibilität mit webtrees; Unterstützung des aktuellen Übersetzungssystems unter Verlust der bestehenden Übersetzungen

• 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 Eheortes (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

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.

Für webtrees-Versionen vor 2.0.21 können Sie ein früheres Quell-Repository ausprobieren, das aber für Versionen ab 2.0.22 nicht mehr funktioniert.

Graphviz auf dem Server

Um druckbare ... wird auf dem Server Graphviz in einer aktuellen Version benötigt.

Installation

---

Bitte beachten Sie die folgenden Installationsanweisungen

• Laden Sie die neueste Version von GitHub herunter.
• Entpacken Sie das Erweiterungsmodul in das Verzeichnis /modules_v4/GVExport 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 und den Menüpunkt nach ihren Wünschen zu positionieren.
• Klicken Sie abschließend auf "Speichern", um die Konfiguration zu sichern.

Installation von Graphviz auf dem Server

Wenn Sie ein Debian-basiertes Betriebssystem (wie Ubuntu) ausführen, können Sie Graphviz installieren, indem Sie den Befehl sudo apt install graphviz 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 Folgendes ausführen docker exec -it webtrees apt update && docker exec -it webtrees apt install graphviz. Beachten Sie jedoch, dass dieser Befehl zwar Graphviz im Container installiert, aber wenn Sie 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

---

Derzeit unterstützt dieses Modul keine Übersetzungen in andere Sprachen. Es ist nur in Englisch verfügbar.

Für frühere Versionen dieses Moduls lagen Übersetzungen in folgende Sprachen vor: Deutsch, Französisch, Ungarisch, Italienisch und Polnisch.

Unterstützung

---

Sie können Fehler oder Wünsche für Erweiterungen auf der "issue"-Seite bei GitHub melden,

Sie können bei Fragen auch das webtrees-Forum mit dem Themenbereich "Customising" nutzen.

Lizenz

• © 2022 Neriderc
• Frühere Autoren
  • Ferenc Kurucz
  • Pasquale Ceres
  • Iain MacDonald
  • 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.

---