15,534
edits
Changes
→Django 1.6
{{out of date}}
= Getting Started =
Without installing Gramps-Connect, you can test it on-line at http://gramps-connect.org/ I'll try to keep that up to date with the current code. It is current as of May 27 July 24 2012. You can view the site in three modes:
* not logged in - should see data of people dead and public. If either a person is dead, or any data is marked private, you should not be able to see it. Living people are marked with "[Living]" (as determined in Preferences -> Text).
Here, we'll update to let you know when you should remake your database, and keep you apprised of other changes.
July 27, 2012
'''New database format'''. The Database was changed to allow ordered families, parent_families, and tags.
'''Verified Import/Output'''. All genealogical data successfully imported and exported. Items missing from XML:
* researcher
* name formats
* home person
* bookmarks
* name maps
'''Cached Items'''. All items should get a cache when imported.
'''Updated SQL Samples'''. both empty.sql and example.sql where updated.
'''Speed Improvements'''. Added batch transactions and removed rebuild cache on import.
== Functionality ==
** '''S,''' will give all people who have a surname that starts with "S"
** ''',G''' will give all people who have a given name that starts with "G"
* You can use ^ and $ to signify beginning and end respectively:
** '''id=56''' (match all records that have a gramps_id that conatins 56)
** '''id=^M00''' (match all records that have a gramps_id that starts with M00)
** '''id=00$''' (match all records that have a gramps_id that ends with 00)
** '''id=^M00056$''' (match all records that have a gramps_id that is exactly M00056)
* You can add a period in any search term to search a subpart
** '''father.name.suffix=Jr''' (matches all Jrs on Family Browse view)
* There are some fields that you can also separate with commas:
** '''private=1, surname=Smith, given=Joe, death=1850, birth=2000'''
== Run your own Gramps-Connect in 30 seconds ==
=== Windows === 1) Get Gramps from Trunk or Gramps 3.5
I use Tortoise SVN. I put gramps on the Desktop, but anywhere will work.
c:\Python27\Lib\site-packages\
Django 1.3 would be best at this pointor greater is required. Well tested on Django 1.3.
4) Change to trunk\src\webapp
8) Point your webbrowser to http://127.0.0.1:8000
* Latest Gramps4.1 (in examples below, installed in a folder called "trunk")* Django version 1.2, 5 or 1.3greater
* Sqlite3
* cd trunk
* python3 setup./autogen.shpy build
you are then ready to make and run Gramps-Connect. These are the basic steps for running in a test development:
# cd trunk/srcgramps/webapp
# make
## this will build all tables, and populate with default information
# Point your browser to http://localhost:8000/ and begin using Gramps-Connect
== Django 1.4 ==
=== Django 1.4 ===
tannooba says:
# in settings.py, change TEMPLATE_CONTEXT_PROCESSORS from "django.core.context_processors.auth" to "django.contrib.auth.context_processors.auth".
# In settings.py, changed TEMPLATE_LOADERS to say "django.template.loaders.filesystem.Loader" instead of ...loaders.filesystem.Load_template_source.
=== Django 1.6 ===
* [http://sourceforge.net/p/gramps/source/merge-requests/12/ Git Merge Request #12: Gramps-connect: Django compatibility fixes (open)], ''This ought to make Gramps-connect compatible with Django 1.3 on up to Django 1.6.'' - Paul Kilgo 2014-06-16 ( [http://sourceforge.net/u/oneeyedparrot/gramps/ci/c6b0e5713bc5f0e5e84c62840efc00c3e7545f24/log/?path= Patches] )
= Options =
* You can change the CSS theme in Admin -> Profile -> User. Give the name of the CSS file per user.
* You can change the name of the site in Admin -> Config -> sitename.
== Temporary ==
Now that Gramps trunk has moved to Gtk GObject, Gramps depends on it. For older installs which don't have it, you might not be able to produce certain graphics, or output.
For the moment, I am using the branches/gramps35 repository (which I will mirror the non-gtk changes with trunk).
= Bugs =
Please list any item that is not listed yet:
# {{bug|7005}} unable to import GRAMPS example DBs
# Not all items are private and living data protected. Need a security audit.
# Many of the secondary level of information (LDS, Location, etc) are accessible for viewing or edit
# Tags are not imported nor exported
# Privacy: "[Living]" is used, but names still appear in alphabetical order
#: Related to patronymic privacy bug {{bug|4538}}? No, this is a different, gramps-connect specific issue. But the issue from #4538 is also a problem in Gramps-Connect, and will have to be solved a different way.
# Make it internationalized Need to be able to delete and localized (feature request {{bug|3417}})# Make it look nice## Some items need better CSS (tables)## Some items need better HTML (buttons)# Create interfaces for:## Reports### Options## Imports## Exports## User settings### CSS### Password, email, etc### Gramps preferences# Make 100% of data editable## Edit## Delete# Add additional functionality## Bookmarks## Maps## Advanced search = ToDo =move up/move down lists
# Import/Export 100% of all data
## Import/Export Tags missing## Import Media missing (need a place to put them)# Make 100% of data viewableMissing edit/delete functionality:
## Person
### Events
### References
## Tag
= Feature Requests =
There are a gazillion things that haven't been added yet. But this section lists some conceptual issues that will need to be thought out.
# Make it internationalized and localized (feature request {{bug|3417}})
# Make it look nice
## Some items need better CSS (tables)
## Some items need better HTML (buttons)
# Create interfaces for:
## Reports
### Options
## Imports
## Exports
## User settings
### CSS
### Password, email, etc
### Gramps preferences
# Add additional functionality
## Bookmarks
## Maps
## Advanced search
= Running on a real system =
import sys
os.environ['DJANGO_SETTINGS_MODULE'] = 'gramps.webapp.settings'os.environ['HOME'] = '/usr/local/wsgi/trunk'os.environ['GRAMPS_RESOURCES'] = '/usr/local/wsgi/trunk/'sys.path.append('/usr/local/wsgi/trunk/src')
import django.core.handlers.wsgi
Permissions:
* chmod a+rw trunk/srcgramps/webapp/sqlite.db * chmod a+xw trunk/srcgramps/webapp/
Additions to /etc/httpd/conf/httpd.conf, for example:
The Gramps-Connect source is defined to match sqlite3 and the above settings. If you would like to change any of this, you'll probably also have to change [http://gramps.svn.sourceforge.net/viewvc/gramps/trunk/src/webapp/settings.py?view=markup trunk/src/webapp/settings.py].
service httpd restart
[[Category:Developers/General]]
[[Category:GEPS]]
