Difference between revisions of "Getting started with Gramps master"

From Gramps
(Installing Gramps Master)
 
(3 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
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.
 
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.
  
{{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.}}
+
{{man warn|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.}}
  
 
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.  
 
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.  
Line 24: Line 24:
 
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.
 
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? ==
+
== Can I help with Gramps {{man label|master}}? ==
  
 
Yes! You could:
 
Yes! You could:
  
# Help write documentation on how to use Gramps {{man label|master}}. See [[User manual|Gramps X.x User Wiki Manual]]
+
# 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]]
 
# 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/
 
# Test and follow-up on issues in the tracker. See https://gramps-project.org/bugs/
Line 44: Line 44:
  
 
== See also ==
 
== See also ==
* [[$GRAMPSHOME]]
+
* [[GRAMPSHOME]]
 
* [[Getting started with Gramps development]]
 
* [[Getting started with Gramps development]]
 
* [[Installation alternatives]]
 
* [[Installation alternatives]]
  
 
[[Category:Developers/General]]
 
[[Category:Developers/General]]

Latest revision as of 23:41, 14 April 2025

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