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 2012. You can view the site in three modes:

+

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

* 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).

Line 10:

Line 11:

Here, we'll update to let you know when you should remake your database, and keep you apprised of other changes.

Here, we'll update to let you know when you should remake your database, and keep you apprised of other changes.

** '''S,''' will give all people who have a surname that starts with "S"

** '''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"

** ''',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:

* There are some fields that you can also separate with commas:

** '''private=1, surname=Smith, given=Joe, death=1850, birth=2000'''

** '''private=1, surname=Smith, given=Joe, death=1850, birth=2000'''

Line 49:

Line 75:

== Windows ==

== Windows ==

−

1) Get Gramps from Trunk

+

1) Get Gramps from Trunk or Gramps 3.5

+

+

* https://gramps.svn.sourceforge.net/svnroot/gramps/trunk

+

* https://gramps.svn.sourceforge.net/svnroot/gramps/branches/gramps35

−

https://gramps.svn.sourceforge.net/svnroot/gramps/trunk

+

Trunk now uses Gtk3, so use trunk if you can. Gramps 3.5 uses Gtk2.

I use Tortoise SVN. I put gramps on the Desktop, but anywhere will work.

I use Tortoise SVN. I put gramps on the Desktop, but anywhere will work.

Line 68:

Line 97:

c:\Python27\Lib\site-packages\

c:\Python27\Lib\site-packages\

−

Django 1.3 would be best at this point.

+

Django 1.3 or greater is required. Well tested on Django 1.3.

4) Change to trunk\src\webapp

4) Change to trunk\src\webapp

Line 82:

Line 111:

8) Point your webbrowser to http://127.0.0.1:8000

8) Point your webbrowser to http://127.0.0.1:8000

−

Thanks it!

+

== Linux and Mac ==

−

== Linux and Mac ==

+

Get the latest version of Gramps (currently "trunk" or "branches/gramps35" from SVN; see [http://gramps-project.org/wiki/index.php?title=Brief_introduction_to_SVN Brief introduction to SVN]). This will become an easy-to-install package once Gramps 3.5/4.0 are released. Trunk uses Gtk3; Gramps 3.5 uses Gtk2.

−

Get the latest version of Gramps (currently "trunk" from SVN; see [http://gramps-project.org/wiki/index.php?title=Brief_introduction_to_SVN Brief introduction to SVN]). This will become an easy-to-install package once Gramps 3.5 is released. Below, it is assumed that you have the following installed:

* You can change the CSS theme in Admin -> Profile -> User. Give the name of the CSS file per user.

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

* 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 =

= Bugs =

Line 140:

Line 184:

# Not all items are private and living data protected. Need a security audit.

# Not all items are private and living data protected. Need a security audit.

−

# No on-line viewing of media yet

# Many of the secondary level of information (LDS, Location, etc) are accessible for viewing or edit

# Many of the secondary level of information (LDS, Location, etc) are accessible for viewing or edit

# Tags are not imported nor exported

# Tags are not imported nor exported

−

# References are showing up yet

−

# Tags not showing on view

−

−

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

−

# Privacy: "[Living]" is used, but names still appear in alphabetical order

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

#: 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 and localized (feature request {{bug|3417}})

+

# Need to be able to delete and move up/move down lists

−

# 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 =

−

# Import/Export 100% of all data

# Import/Export 100% of all data

−

## Tags missing

+

## Import/Export Tags

−

## Media missing (need a place to put them)

+

## Import Media (need a place to put them)

−

# Make 100% of data viewable

+

# Missing edit/delete functionality:

## Person

## Person

### Events

### Events

Line 246:

Line 260:

### References

### References

## Tag

## 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 =

= Running on a real system =

Line 312:

Line 348:

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

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

−

One everything is setup, restart the webserver:

+

Once everything is setup, restart the webserver:

service httpd restart

service httpd restart

+

+

[[Category:Developers/General]]

+

[[Category:GEPS]]

Revision as of 01:59, 28 January 2013

This page's factual accuracy may be compromised due to out-of-date information. Please help improve the Gramps Wiki as a useful resource by updating it.

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

logged in as regular user, ID: admin1, password: gramps. You can see all data, run reports, export data, but cannot change the database.

Linux and Mac

Get the latest version of Gramps (currently "trunk" or "branches/gramps35" from SVN; see Brief introduction to SVN). This will become an easy-to-install package once Gramps 3.5/4.0 are released. Trunk uses Gtk3; Gramps 3.5 uses Gtk2.

Below, it is assumed that you have the following installed:

Gramps 3.5 or 4.0 (in examples below, installed in a folder called "trunk")

Django version 1.3 or greater

Sqlite3

Once you have built Gramps trunk:

cd trunk

./autogen.sh

you are then ready to make and run Gramps-Connect. These are the basic steps for running in a test development:

cd trunk/src/webapp

make

this will build all tables, and populate with default information

you should also define a superuser ID/Password here when prompted (this will be the account which can edit data, and can create new accounts).

The data will begin to be imported. (Because, as a default, the data is going into a sqlite3 database backend that has little concurrency, you won't be able to do much until the import is done. Warning: this is a little slower than Gramps import.)

Once the import is done, you can browse most of the data (it is all there (except tags), which you can verify with an export)

Finally, you can also export data to Django while running the Gramps desktop version. Just select the Django export option.

Working

It should be the case that you can edit the main parts of all primary data. In fact, for the primary data, you can edit, add, delete, and link references to each (like add notes to a person).

You can run reports, exports, and imports from the web. All of these are listed in "Reports" for now, and you have to supply command-line 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:

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

Need to be able to delete and move up/move down lists

Import/Export 100% of all data

Import/Export Tags

Import Media (need a place to put them)

Missing edit/delete functionality:

Person

Events

Names

Citations

Attributes

Addresses

Notes

Gallery

Internet

Associations

LDS

References

Family

Children

Events

Citations

Attributes

Notes

Gallery

LDS

Event

EventRef

General

Notes

Attributes

Shared

General

Citations

Attributes

Notes

Gallery

References

Notes

Media

Citations

Attributes

Notes

References

Citation

General

Notes

Gallery

Data

References

Source

General

Notes

Gallery

Data

Repository

Reference

Place

General

Location

Alternate Locations

Citations

Notes

Gallery

Internet

References

Repository

General

Addresses

Internet

Notes

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.

Running on a real system

Gramps-connect is written using the Django web development framework. You can deploy a Django application using many methods. You can also use many different database backends, such as MySQL and Postgresql. In this example, we will deploy using the simplest options: wsgi and sqlite3, respectively.

Dependencies: Apache we server, mod_wsgi for Apache, Django, and sqlite3.