1,583
edits
Changes
→Getting Started with Gramps in Django
Many Gramps users would like to collaborate or share their genealogy data on the web. This GEP describes a webapp, a web-based application that runs in your browser, and requires a server. A prototype is now on-line at http://gramps-connect.org/ which is running trunk on a sample database . You can log into the site, as a:*superuser (id=admin, password=gramps)or a *regular user (id=admin1, password=gramps)or just view as an anonymous user. There are two additional pages on this project: * [[Gramps-Connect]] - getting started* [[Gramps-Connect:_Developer_Introduction]] - introduction for developers
== Motivation ==
=== Models/Views ===
Here is the model that defines the Person table from [http://gramps.svn.sourceforge.net/viewvc/gramps/trunk/src/webwebapp/grampsdb/models.py?view=markup src/webwebapp/grampsdb/models.py]:
<pre>
<pre>
% cd trunk
% PYTHONPATH=src DJANGO_SETTINGS_MODEL=webwebapp.settings python >>> from webwebapp.grampsdb.models import Person
>>> Person.objects.all()
[<Person>, <Person>, ...]
</pre>
The first retrieves all of the rows for the Person table; the second retrieves just the one record that has the unique, primary key 1, and the third retrieves the single record that has the unique handle of 'gh71234dhf3746347734'. Note that we never connected onto a database... Django is (currently) define to connect on to one database, and it does it on import. The database is set in src/webwebapp/settings.py.
An alternative method of interactively talking to the database is to use ''manage.py'':
<pre>
% cd trunk/src/web webapp
% PYTHONPATH=../../src python manage.py shell
>>>
<pre>
>>> from webwebapp.grampsdb.models import *
>>> Person.objects.filter(gender_type=1)
[<Person>, <Person>, ...]
[[Image:all-tables.gif]]
To see more graphical representations of the data, run "make docs" in the src/webwebapp/ directory, and then look in src/webwebapp/docs/.
=== Templates ===
A prototype of a GRAMPS Django webapp is now in trunk and gramps32. To run it, do the following:
# Download Django. You'll need version 1.13 or greater
## On yum-based systems, try "yum install Django"
## On apt-based systems, try "sudo apt-get install python-django"
## Other systems: get the sources from http://www.djangoproject.com/download/
# get the gramps trunk or branch/gramps32 from SVN
## cd ../..
## python src/gramps.py
# Download the Django Import/Export Addon from [[3.2_Addons3_Addons]]
# Run the Django Exporter
## Select Family Tree -> Export
# http://gramps.svn.sourceforge.net/viewvc/gramps/trunk/src/data/templates/ - HTML templates
# http://gramps.svn.sourceforge.net/viewvc/gramps/trunk/src/webwebapp/ - Webapp main directory## http://gramps.svn.sourceforge.net/viewvc/gramps/trunk/src/webwebapp/libdjango.py?view=markup - library interface## http://gramps.svn.sourceforge.net/viewvc/gramps/trunk/src/webwebapp/grampsdb - gramps table models# http://gramps-addons.svn.sourceforge.net/viewvc/gramps-addons/trunk/src/pluginscontrib/exportDjango/ExportDjango.py?view=markup - Exporter# http://gramps-addons.svn.sourceforge.net/viewvc/gramps-addons/trunk/src/pluginscontrib/importDjango/ImportDjango.py?view=markup - Importer
== Roadmap ==
* [http://groups.google.com/group/django-users/browse_thread/thread/c138ec11c6ad282e?hl=en# Django User Question]
** [http://groups.google.com/group/django-developers/browse_thread/thread/fd5d45fc6cd6a760 Developer discussion on topic]
== Example GMS Web Sites ==
Genealogy Management Systems on the web:
* http://www.dertinger.de/Dertinger_database/en/en_index.htm(Oxy-gen)* http://registry.phpgedview.net/index.php for example: [http://www.admiraal.org/]. (PhpGedView)
: Note here: the intro page is a collection of gadgets/controls, which then link into the real data.
* http://12webtrees.46net/demo/next (webtrees)* http://beck.127org.86il/bgrhumogen/BGR-o(HuMogen)* http:/p316/genealogies.htmgeneamania.net/servin/ (Généamania)* http://www.geneotree.com/geneotree/index.php (Geneotree)* http://ancestorsnow.com/ancestors* http://www.phpmyfamily.net/demo/
Collaborative database (user/wizard/password):
* http://roglo.eu/roglo?lang=en(GeneWeb) Source oriented: * http://solumslekt.org/forays/yggdrasil.php [http://code.google.com/p/yggdrasil-genealogy/][http://solumslekt.org/blog/] ==See also==*[[Gramps-Connect: Introduction|gramps-connect]]
[[Category:GEPS|SG]]
