Difference between revisions of "De:Addon:Gramps Web"

From Gramps
Jump to: navigation, search
Line 1: Line 1:
{{languages/de|Gramps Web}}
+
{{man warn|
 +
Du kannst jetzt (2022) auch [[Gramps Web]] ausprobieren.|Da sich das Projekt noch in einem frühen Stadium befindet, denke daran, regelmäßig [[De:Wie_erstelle_ich_eine_Sicherung|Backups zu erstellen]], wenn du es für deine genealogischen Daten verwendest.}}
 +
{{languages/de|Addon:Gramps Web}}
 +
[[File:GrampsWeb-10.png|thumb|right|400px|Fig. {{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} GrampsWeb screenshot from GitHub project docs]]
 +
'''[https://gramps-project.github.io/web/ Gramps Web]''' is a web app developed by the Gramps community that allows authorized users to collaboratively edit genealogical information using a Gramps family tree database.
 +
==Is Gramps Web an add-on within Gramps?==
 +
No, Gramps Web runs on a server and is accessed via the web browser. It is '''''not''''' part of your desktop Gramps application.
 +
 
 +
Gramps Web is for limited simultaneous use by a number of authenticated users. It not meant to be exposed to the internet for unlimited public access. (More general access would demand a powerful server or expensive hosting.) User accounts can be created by the site owner via the command line or web interface, or by self-registration and subsequent approval by the site owner.
 +
 
 +
The server may be remote at a hosted service or on your local network. The supported architectures for local network include not only x86-64 (desktop systems), but also ARM systems such as a Raspberry Pi, which can serve as a low-cost, but powerful (enough) web server.
 +
 
 +
Gramps Web is a separate project based on the same code base as Gramps Desktop. It uses the Gramps Python library at its core to provide a REST API backend service leveraging the genealogical functions and database handling of Gramps. On top, it serves a modern, mobile-first web frontend.
 +
 
 +
===Deploying a Gramps Web instance===
 +
Configuring a Gramps Web instance on your own server or hosted service is an EXPERT level task. But there are deployment options using a '''[https://containerjournal.com/uncategorized/docker-containers-help-end-users/ Docker] container''' and a turnkey '''"[https://marketplace.digitalocean.com/apps/gramps-web 1-click App]"''' offered as a service if you have a (paid) Digital Oceans droplet account.
 +
 
 +
===Uploading fresh tree data to Gramps Web===
 +
'''[https://github.com/DavidMStraub/gramps-addon-webapisync Gramps Web Sync]''' addon snychronizes the Gramps Web online database with Gramps Desktop from the {{man menu|Tools -> Family Tree Processing}} submenu. It supports import and export of genealogical data in all formats supported by Gramps.
 +
 
 +
See the [https://gramps-project.github.io/web/ project documentation on GitHub].
  
Gramps Web ist eine Web-App, um gemeinsam Familienforschung übers Internet zu betreiben. Es verwendet die Python-Bilbiothek von Gramps als Grundlage und bietet darauf aufbauend einen REST-API-Dienst an, der die genealogischen Funktionen und die Datenbank-Verwaltung von Gramps ausnutzt. Als Benutzerschnittstelle dient ein moderne, mobilfreundliche Weboberfläche.
+
==Features==
 +
* Browse all objects in your family tree: people, families, events, places, repositories, sources, citations, media objects, and notes
 +
* Two different interactive pedigree views
 +
* Display all places on an interactive, searchable map
 +
* Blog section with blog articles stored in Gramps
 +
* Switch the language of the interface between any of 40 languages
 +
* Multi-user system with different levels of permissions
 +
* Edit all objects collaboratively and add new objects
 +
* Fully responsive & mobile friendly
 +
* Export the tree as Gramps XML or GEDCOM from the web interface
 +
* Import a tree (in Gramps XML or GEDCOM format)
 +
* Generate any report supported by Gramps from the web interface
 +
* Synchronize with your local Gramps database and use Gramps desktop in parallel
 +
* Tag people in photos with automatic face detection
  
Mehr Informationen über Grams Web findet man auf der (englischsprachigen) [https://gramps-project.github.io/web/ Dokumentationsseite].
+
==Setup Requirements==
  
{{man warn|
+
Gramps Web is a web app that runs on a server and is accessed via the web browser. It is meant to be made accessible to authenticated users via the internet.
Du kannst jetzt (2022) auch [[Gramps Web]] ausprobieren. Da sich das Projekt noch in einem frühen Stadium befindet, denke daran, regelmäßig [[De:Wie_erstelle_ich_eine_Sicherung|Backups zu erstellen]], wenn du es für deine genealogischen Daten verwendest.}}
+
 
 +
===Server Requirements===
 +
 
 +
The most convenient way to host Gramps Web is via Docker Compose. While this is not possible with ordinary "shared hosting" providers, this makes it possible to host the app on Linux, Mac, or Windows; it can be hosted on a virtual server or on a Raspberry Pi (we provide Docker images for the ARM architecture) in your basement.
 +
 
 +
Apart from Docker, you will also need some storage space to store your media files (images, documents).
 +
 
 +
Finally, Gramps Web is only secure when served via HTTPS, so you will require an SSL/TLS certificate.
 +
 
 +
{{man warn|[https://gramps.discourse.group/t/dynamic-web-report/2782/15 Von einem der Entwickler]|Gramps Web ist eine vollständige Gramps-Instanz, die auf einem Webserver läuft und die du mit deinem Desktop-Gramps synchronisieren kannst. Zugegeben, die Installation ist nicht trivial.
 +
 
 +
Die einfachste Option im Moment ist hier beschrieben: [https://gramps.discourse.group/t/gramps-web-digitalocean-1-click-app/2733 Gramps Web DigitalOcean 1-click app ]}}
 +
 
 +
==Siehe auch==
 +
* [[Web Solutions for Gramps]]
  
{{man warn|[https://gramps.discourse.group/t/dynamic-web-report/2782/15 Von einem der Entwickler]|Gramps Web ist eine vollständige Gramps-Instanz, die auf einem Webserver läuft und die du mit deinem Desktop-Gramps synchronisieren kannst. Zugegeben, die Installation ist nicht trivial, die (meiner Meinung nach) einfachste Option im Moment ist hier beschrieben: [https://gramps.discourse.group/t/gramps-web-digitalocean-1-click-app/2733 Gramps Web DigitalOcean 1-click app ]}}
+
[[Category:Documentation]]

Revision as of 12:22, 18 September 2023

Gnome-important.png
Du kannst jetzt (2022) auch Gramps Web ausprobieren.

Da sich das Projekt noch in einem frühen Stadium befindet, denke daran, regelmäßig Backups zu erstellen, wenn du es für deine genealogischen Daten verwendest.

Fig. 1 GrampsWeb screenshot from GitHub project docs

Gramps Web is a web app developed by the Gramps community that allows authorized users to collaboratively edit genealogical information using a Gramps family tree database.

Is Gramps Web an add-on within Gramps?

No, Gramps Web runs on a server and is accessed via the web browser. It is not part of your desktop Gramps application.

Gramps Web is for limited simultaneous use by a number of authenticated users. It not meant to be exposed to the internet for unlimited public access. (More general access would demand a powerful server or expensive hosting.) User accounts can be created by the site owner via the command line or web interface, or by self-registration and subsequent approval by the site owner.

The server may be remote at a hosted service or on your local network. The supported architectures for local network include not only x86-64 (desktop systems), but also ARM systems such as a Raspberry Pi, which can serve as a low-cost, but powerful (enough) web server.

Gramps Web is a separate project based on the same code base as Gramps Desktop. It uses the Gramps Python library at its core to provide a REST API backend service leveraging the genealogical functions and database handling of Gramps. On top, it serves a modern, mobile-first web frontend.

Deploying a Gramps Web instance

Configuring a Gramps Web instance on your own server or hosted service is an EXPERT level task. But there are deployment options using a Docker container and a turnkey "1-click App" offered as a service if you have a (paid) Digital Oceans droplet account.

Uploading fresh tree data to Gramps Web

Gramps Web Sync addon snychronizes the Gramps Web online database with Gramps Desktop from the Tools -> Family Tree Processing submenu. It supports import and export of genealogical data in all formats supported by Gramps.

See the project documentation on GitHub.

Features

  • Browse all objects in your family tree: people, families, events, places, repositories, sources, citations, media objects, and notes
  • Two different interactive pedigree views
  • Display all places on an interactive, searchable map
  • Blog section with blog articles stored in Gramps
  • Switch the language of the interface between any of 40 languages
  • Multi-user system with different levels of permissions
  • Edit all objects collaboratively and add new objects
  • Fully responsive & mobile friendly
  • Export the tree as Gramps XML or GEDCOM from the web interface
  • Import a tree (in Gramps XML or GEDCOM format)
  • Generate any report supported by Gramps from the web interface
  • Synchronize with your local Gramps database and use Gramps desktop in parallel
  • Tag people in photos with automatic face detection

Setup Requirements

Gramps Web is a web app that runs on a server and is accessed via the web browser. It is meant to be made accessible to authenticated users via the internet.

Server Requirements

The most convenient way to host Gramps Web is via Docker Compose. While this is not possible with ordinary "shared hosting" providers, this makes it possible to host the app on Linux, Mac, or Windows; it can be hosted on a virtual server or on a Raspberry Pi (we provide Docker images for the ARM architecture) in your basement.

Apart from Docker, you will also need some storage space to store your media files (images, documents).

Finally, Gramps Web is only secure when served via HTTPS, so you will require an SSL/TLS certificate.

Gnome-important.png

Gramps Web ist eine vollständige Gramps-Instanz, die auf einem Webserver läuft und die du mit deinem Desktop-Gramps synchronisieren kannst. Zugegeben, die Installation ist nicht trivial.

Die einfachste Option im Moment ist hier beschrieben: Gramps Web DigitalOcean 1-click app

Siehe auch