Difference between revisions of "Getting started with Gramps master"

From Gramps
Jump to: navigation, search
(Can I help finish GRAMPS 3?)
m (add link for moved User Manual translations page)
 
(54 intermediate revisions by 11 users not shown)
Line 1: Line 1:
GRAMPS 3 is the newest version of GRAMPS, but it isn't quite finished. It is in a state called "beta" which means that it is nearly done, but there are still places that need some refinement. You can help by trying this version and reporting feedback and bugs. Before embarking on this you should first read this page.
+
Gramps {{man label|master}} (previously called ''trunk'' when using SVN) is the newest version of Gramps, but it is under development. You can help by trying this version and reporting feedback and bugs. Before embarking on this you should first read this page.
  
== What's new in GRAMPS 3? ==
+
{{man warn|Warning:|A word of caution: {{man label|master}} is currently considered a ''development version'' and not for use on your real data. You can test {{man label|master}} on a copy of your data though. See below for more details.}}
  
There are many changes in GRAMPS 3. This section briefly describes the changes and their implications.
+
You should not ''install'' Gramps {{man label|master}} as that will overwrite your regular Gramps. However, you can download and compile {{man label|master}} locally, largely without interfering with your regular Gramps. Subtle interactions are easy to resolve for developers.  
  
=== New Family Tree Database ===
+
== Precautions ==
  
=== New Screens ===
+
Gramps {{man label|master}} should only be used on a copy of your Family Tree data! Here is a step-by-step guide to doing this:
  
# Quick Views - in most lists, you can right-click and run a Quick View. Further, on a Quick View you can double-click and entry and be taken to the associated object to view or edit. Quick View lists are also sortable on their columns
+
# Start your old version of Gramps
# Gramplets - Gramplets is an experimental new main view in GRAMPS. These are little interfaces to GRAMPS functionality. There are Gramplets that allow you to compute ages on a particular date (Age on Date), see events on a day in history (Calendar), see the top surnames in your Family Tree (Top Surnames), a TODO list, Python shell (with date calculator), a Session Log, and more.
+
# Export your data using the Gramps Package
# Notes - There is now a sophisticated method for attaching notes to any object, and a new Notes main view, complete with filter to find exactly what you're looking for
+
# Quit your old version of Gramps
 +
# Start Gramps {{man label|master}}
 +
# Create a new Family Tree
 +
# Import the Gramps package from step 2
  
== Precautions ==
+
== Can I run my older version of Gramps with this new version? ==
  
GRAMPS 3 should only be used on a copy of your Family Tree data! Here is a step-by-step guide to doing this:
+
Yes. See installation notes below.
  
# Start your old version of GRAMPS
+
== I have a suggestion or have found a bug. What do I do? ==
# Export your data using the GRAMPS Package
 
# Quit your old version of GRAMPS
 
# Start GRAMPS 3.0
 
# Create a new Family Tree
 
# Import the GRAMPS package from step 2
 
  
== Can I run my older version of GRAMPS with this new version? ==
+
Please make a note of your Feature Request, or your bug here: https://gramps-project.org/bugs/ This is one of the most important things you can do to help the state of Gramps.
  
Yes. Details...
+
== Can I help with Gramps {{man label|master}}? ==
  
== I have a suggestion or have found a bug. What do I do? ==
+
Yes! You could:
  
== Can I help finish GRAMPS 3? ==
+
# Help write documentation on how to use Gramps {{man label|master}}. See [[User manual|Gramps X.x User Wiki Manual]] and [[User_manual_translations|translating/updating the manual]]
 +
# Help translate Gramps into another language. See [[Portal:Translators|Internationalization]]
 +
# Test and follow-up on issues in the tracker. See https://gramps-project.org/bugs/
 +
# Donate money to Gramps. See [[Gramps:Site_support|Gramps Support]]
  
Yes! There is much left to be done. You could:
+
== Installing Gramps {{man label|master}} ==
  
# Help write documentation on how to use GRAMPS 3. See [[Gramps 3.0 Wiki Manual]]
+
Now that you have read all of the precautions, you are ready to begin exploring Gramps {{man label|master}}.  
# Help translate GRAMPS into another language. See [[Template:Developers/Internationalization|Internationalization]]
 
# Test and follow-up on issues in the tracker. See http://bugs.gramps-project.org/
 
# Donate money to GRAMPS. See [[GRAMPS:Site_support|GRAMPS Support]]
 
  
== Installing GRAMPS 3 ==
+
See [[Getting_started_with_Gramps_development#Run_Gramps_from_the_source|running Gramps from source]] for details to make the code work.
  
Now that you have read all of the precautions, you are ready to begin exploring GRAMPS 3. The easiest method of getting the beta version is to download it from http://sourceforge.net/project/showfiles.php?group_id=25770 under '''Unstable'''.
+
== Running parallel versions of {{man label|master}} and branches ==
  
If you are running Linux and a variation of Debian (Ubuntu), then you can download the .deb file and install it directly.
+
As stated in '''Installing Gramps {{man label|master}}''', you can only have a dedicated gramps.mo file on /usr/share/local/xx/.. . If you want to have both the {{man label|master}} and branches version with separate translations, consider using some '''[http://en.wikipedia.org/wiki/Comparison_of_platform_virtualization_software Virtual Machines]'''.
  
Otherwise, you should download the tar.gz file. Here is the basic installation instructions, assuming that the tar.gz file is in your current directory:
+
== See also ==
 +
* [[$GRAMPSHOME]]
 +
* [[Getting started with Gramps development]]
 +
* [[Installation alternatives]]
  
tar xfz gramps-2.90.0-beta.tar.gz
+
[[Category:Developers/General]]
cd gramps-2.90.0-beta
 
configure --prefix=/usr/local
 
make
 
su -c "make install"
 

Latest revision as of 02:15, 9 June 2020

Gramps master (previously called trunk when using SVN) is the newest version of Gramps, but it is under development. You can help by trying this version and reporting feedback and bugs. Before embarking on this you should first read this page.

Gnome-important.png
Warning:

A word of caution: master is currently considered a development version and not for use on your real data. You can test master on a copy of your data though. See below for more details.

You should not install Gramps master as that will overwrite your regular Gramps. However, you can download and compile master locally, largely without interfering with your regular Gramps. Subtle interactions are easy to resolve for developers.

Precautions

Gramps master should only be used on a copy of your Family Tree data! Here is a step-by-step guide to doing this:

  1. Start your old version of Gramps
  2. Export your data using the Gramps Package
  3. Quit your old version of Gramps
  4. Start Gramps master
  5. Create a new Family Tree
  6. Import the Gramps package from step 2

Can I run my older version of Gramps with this new version?

Yes. See installation notes below.

I have a suggestion or have found a bug. What do I do?

Please make a note of your Feature Request, or your bug here: https://gramps-project.org/bugs/ This is one of the most important things you can do to help the state of Gramps.

Can I help with Gramps master?

Yes! You could:

  1. Help write documentation on how to use Gramps master. See Gramps X.x User Wiki Manual and translating/updating the manual
  2. Help translate Gramps into another language. See Internationalization
  3. Test and follow-up on issues in the tracker. See https://gramps-project.org/bugs/
  4. Donate money to Gramps. See Gramps Support

Installing Gramps master

Now that you have read all of the precautions, you are ready to begin exploring Gramps master.

See running Gramps from source for details to make the code work.

Running parallel versions of master and branches

As stated in Installing Gramps master, you can only have a dedicated gramps.mo file on /usr/share/local/xx/.. . If you want to have both the master and branches version with separate translations, consider using some Virtual Machines.

See also