# Gramps Offline User Manual / User Guide / Instructions

**URL:** <https://gramps.discourse.group/t/gramps-offline-user-manual-user-guide-instructions/3773>\
**Category:** User Manual\
**Created:** [July 5, 2023, 2:50am UTC](https://gramps.discourse.group/t/gramps-offline-user-manual-user-guide-instructions/3773 "2023-07-05T02:50:31Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![crum](https://avatars.discourse-cdn.com/v4/letter/c/8797f3/32.png) [@crum](https://gramps.discourse.group/u/crum)\
**Post date:** [July 5, 2023, 2:50am UTC](https://gramps.discourse.group/t/gramps-offline-user-manual-user-guide-instructions/3773/1 "2023-07-05T02:50:31Z")

</div>

Hallo.  
More than 90% of the time the laptop I am using is not connected to the internet.

I have installed Gramps successfully but I feel my stress levels elevate when I click on the **Help** menu then choose **Get Help**.

Is [an offline manual available](https://gramps-project.org/wiki/index.php/User_manual_translations#Gramps_5.2.x_Manual), so I can learn Gramps offline? I know that the Gramps developers don’t get feedback on what people are looking up when using an offline manual, but I think it would be extremely helpful for people who work offline to have the choice to…_learn Gramps offline._

What do you think?

---

<div class="post-metadata">

**Author:** ![emyoulation](https://yyz2.discourse-cdn.com/free1/user_avatar/gramps.discourse.group/emyoulation/32/67_2.png) [@emyoulation](https://gramps.discourse.group/u/emyoulation)\
**Post date:** [July 5, 2023, 4:24am UTC](https://gramps.discourse.group/t/gramps-offline-user-manual-user-guide-instructions/3773/2 "2023-07-05T04:24:49Z")

</div>

The [last downloadable manual](https://www.gramps-project.org/wiki/index.php/User_manual_translations#Gramps_3.3.x_Manual) was produced in 2012 for 3.3 version of Gramps. [[5.1.6 version](https://gramps-project.org/wiki/index.php/User_manual_translations#superseded) generated 27 Aug 2023] That was when the tools broke that were used to produce such an artifact.

---

<div class="post-metadata">

**Author:** ![emyoulation](https://yyz2.discourse-cdn.com/free1/user_avatar/gramps.discourse.group/emyoulation/32/67_2.png) [@emyoulation](https://gramps.discourse.group/u/emyoulation)\
**Post date:** [July 5, 2023, 9:41am UTC](https://gramps.discourse.group/t/gramps-offline-user-manual-user-guide-instructions/3773/3 "2023-07-05T09:41:32Z")

</div>

Although not a feature within Gramps or its addons, you might want to note that there are a number of tools which clone a website for offline use.

And you would not need the ENTIRE website with its thousands of pages. There are only a couple dozen pages in the core wiki. A few dozen more if you want the pages for each add-on.

A sufficiently motivated person could probably adapt a caching script from some of the wiki user manual’s [version rollover process](https://www.gramps-project.org/wiki/index.php/Rollover_for_the_manual).

---

<div class="post-metadata">

**Author:** ![PLegoux](https://yyz2.discourse-cdn.com/free1/user_avatar/gramps.discourse.group/plegoux/32/413_2.png) [@PLegoux](https://gramps.discourse.group/u/PLegoux)\
**Post date:** [July 5, 2023, 11:17am UTC](https://gramps.discourse.group/t/gramps-offline-user-manual-user-guide-instructions/3773/4 "2023-07-05T11:17:36Z")

</div>

On Windows I know the WinHttpTrack software which can “mirror” a website on your own disk drive and allow it to be read locally as if it were online

You could use it to replicate the [Gramps wiki](https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual#Table_of_Contents) on your computer

---

<div class="post-metadata">

**Author:** ![crum](https://avatars.discourse-cdn.com/v4/letter/c/8797f3/32.png) [@crum](https://gramps.discourse.group/u/crum)\
**Post date:** [July 6, 2023, 1:35am UTC](https://gramps.discourse.group/t/gramps-offline-user-manual-user-guide-instructions/3773/5 "2023-07-06T01:35:27Z")

</div>

Thank you all. I will look into saving the wiki pages as suggested.

**emyoulation** , that old version 3.3 manual is surprisingly well done. I just took a look at it now. A lot of work went into that. Just excellent.

---

<div class="post-metadata">

**Author:** ![crum](https://avatars.discourse-cdn.com/v4/letter/c/8797f3/32.png) [@crum](https://gramps.discourse.group/u/crum)\
**Post date:** [July 8, 2023, 1:15am UTC](https://gramps.discourse.group/t/gramps-offline-user-manual-user-guide-instructions/3773/6 "2023-07-08T01:15:09Z")

</div>

Hi Guys  
I tried httrack [https://www.httrack.com/](https://www.httrack.com/) (under Linux) 3 times It has failed me every time, despite trying to change settings. I get the main Gramps index page downloaded and then go to click on a link and get a missing page. I also get httrack stop things midwawy, having to resume the website download, and it still fails me.

I either need the correct settings to download things successfully in httrack, or I could just do with the files from someone who has done it already (and maybe zipped them up).

Has anyone tried and done it already? Or if possible, just share how to do it?

---

<div class="post-metadata">

**Author:** ![emyoulation](https://yyz2.discourse-cdn.com/free1/user_avatar/gramps.discourse.group/emyoulation/32/67_2.png) [@emyoulation](https://gramps.discourse.group/u/emyoulation)\
**Post date:** [July 8, 2023, 1:53am UTC](https://gramps.discourse.group/t/gramps-offline-user-manual-user-guide-instructions/3773/7 "2023-07-08T01:53:17Z")

</div>

If it was quick and easy, someone would have been a downloadable ZIP sometime in the last 10 years. (Since the previous method broke.)

In all that time, no one has volunteered to put in such an effort rather than just use a 'net connection.

There have been some recent conversations about finding a different too to build a [PDF from website tool](https://m.facebook.com/groups/370692133138445/permalink/2173390666201907) and make that a new download. No progress to report yet.

---

<div class="post-metadata">

**Author:** ![crum](https://avatars.discourse-cdn.com/v4/letter/c/8797f3/32.png) [@crum](https://gramps.discourse.group/u/crum)\
**Post date:** [July 19, 2023, 3:37am UTC](https://gramps.discourse.group/t/gramps-offline-user-manual-user-guide-instructions/3773/8 "2023-07-19T03:37:51Z")

</div>

I need to learn more about the technical side of things. LibreOffice always has offline help available [https://documentation.libreoffice.org/en/english-documentation/](https://documentation.libreoffice.org/en/english-documentation/) I don’t know about the technical details of what they are using, but I am interested to learn how they do it.

I would love to get something done for offline use but I have only ‘regular user’ knowledge about how it’s done.

---

<div class="post-metadata">

**Author:** ![codefarmer](https://avatars.discourse-cdn.com/v4/letter/c/b9e5f3/32.png) [@codefarmer](https://gramps.discourse.group/u/codefarmer)\
**Post date:** [July 20, 2023, 1:22am UTC](https://gramps.discourse.group/t/gramps-offline-user-manual-user-guide-instructions/3773/9 "2023-07-20T01:22:55Z")

</div>

After taking a brief look at the [Gramps wiki](https://gramps-project.org/wiki/index.php/Gramps_5.1_Wiki_Manual#Table_of_Contents), I gather that in older versions documentation might have been offline from which manuals were generated. At some point documentation was moved to a wiki and it had been possible to generate a PDF from it, but the process no longer works. Can someone confirm all this?

---

<div class="post-metadata">

**Author:** ![emyoulation](https://yyz2.discourse-cdn.com/free1/user_avatar/gramps.discourse.group/emyoulation/32/67_2.png) [@emyoulation](https://gramps.discourse.group/u/emyoulation)\
**Post date:** [July 20, 2023, 1:50am UTC](https://gramps.discourse.group/t/gramps-offline-user-manual-user-guide-instructions/3773/10 "2023-07-20T01:50:31Z")

</div>

There was a [discussion started on the **GRAMPS for Genealogists**](https://m.facebook.com/groups/370692133138445/permalink/2173390666201907/?mibextid=Nif5oz) group on Facebook looking for a volunteer to take up the creation of a PDF from the MediaWiki. (The Facebook group exibits little tolerance for code development or even add-on installation. So I hoped we might cultivate some volunteer activity on the documentation side. We found an artist and a translator in the past there.)

[Pediapress.com](http://Pediapress.com) seemed to be a match for the technical issues related to converting a set of MediaWiki pages. But their company seems to be less & less active.

---

<div class="post-metadata">

**Author:** ![Nick-Hall](https://yyz2.discourse-cdn.com/free1/user_avatar/gramps.discourse.group/nick-hall/32/95_2.png) [@Nick-Hall](https://gramps.discourse.group/u/Nick-Hall)\
**Post date:** [July 20, 2023, 5:41pm UTC](https://gramps.discourse.group/t/gramps-offline-user-manual-user-guide-instructions/3773/11 "2023-07-20T17:41:53Z")

</div>

Our wiki has pages describing:

[Manual Generation for Gramps 2.x and older](https://gramps-project.org/wiki/index.php/Manual_Generation)  
[Manual Generation for Gramps 3.x and newer](https://gramps-project.org/wiki/index.php/Manual_Generation_3.0)

and also a page for the last manual generated:

[Manual Generation for Gramps 3.3](https://gramps-project.org/wiki/index.php/Manual_Generation_3.0_Prince) using [Prince](https://www.princexml.com)

The MediaWiki site has a list of [PDF export](https://www.mediawiki.org/wiki/PDF_export) extensions. We appear to have used the first two approaches in the past. The workflow for 3.3 may actually still work, maybe using Pediapress rather than Prince. Someone would have to try.

Alternatively someone may want to investigate one of the other approaches.

If anyone is interested then let me know. We will probably have to install some MediaWiki extensions.

---

<div class="post-metadata">

**Author:** ![emyoulation](https://yyz2.discourse-cdn.com/free1/user_avatar/gramps.discourse.group/emyoulation/32/67_2.png) [@emyoulation](https://gramps.discourse.group/u/emyoulation)\
**Post date:** [September 3, 2023, 10:19am UTC](https://gramps.discourse.group/t/gramps-offline-user-manual-user-guide-instructions/3773/13 "2023-09-03T10:19:32Z")

</div>

An offline manual for 5.1.6 has been generated. [See the [list of manual translations and downloads](https://gramps-project.org/wiki/index.php/User_manual_translations#Gramps_5.2.x_Manual).]

> [@Gramps Offline/Print User Manual](https://gramps.discourse.group/t/gramps-offline-print-user-manual/4087):
>
> A compilation of all of the Wiki Manual is available as a PDF for offline use (or for printing) in English, Dutch, Hebrew, and Russian. This was assembled on 27 Aug 2023 and reflects the Wiki Manual as of that date. Download: [Complete English Offline Manual](https://gramps-project.org/wiki/images/7/7b/Gramps5.1UserManual.pdf) (20 MiB) Download: [Complete Dutch Offline Manual](https://gramps-project.org/wiki/images/e/eb/Gramps5.1UserManual_nl.pdf) (16 MiB) Download: [Complete Russian Offline Manual](https://gramps-project.org/wiki/images/b/bb/Gramps5.1UserManual_ru.pdf) (16 MiB) Download: [Complete Hebrew Offline Manual](https://gramps-project.org/wiki/images/7/72/Gramps5.1UserManual_he.pdf) (24 MiB) Please let us know what you think. Your feedback is welcome. Thanks to @GaryGr…

Gary has also added a [wiki page about creating these offline manual files](https://gramps-project.org/wiki/index.php/Manual_Generation_5.1). It describes the workflow for using the template Scripts to generate an offline 5.1.x HTML manual and converting that to a nicely cross-referenced PDF.

Separate script templates are included for creating the offline manual in 4 languages. Translators are encouraged to adapt the scripts for building offline manuals in their own language. New translations can be linked to the [User Manual Translations page](https://gramps-project.org/wiki/index.php/User_manual_translations#Gramps_5.1.x_Manual).

A [feature request [13318]](https://gramps-project.org/bugs/view.php?id=13318) has been created to have Help buttons fallback to an local resource (downloaded and specified in Preferences) when not connected.

---

<div class="post-metadata">

**Author:** ![emyoulation](https://yyz2.discourse-cdn.com/free1/user_avatar/gramps.discourse.group/emyoulation/32/67_2.png) [@emyoulation](https://gramps.discourse.group/u/emyoulation)\
**Post date:** [November 12, 2023, 2:10pm UTC](https://gramps.discourse.group/t/gramps-offline-user-manual-user-guide-instructions/3773/15 "2023-11-12T14:10:24Z")

</div>

> [@emyoulation](#):
>
> New translations can be linked to the [User Manual Translations page](https://gramps-project.org/wiki/index.php/User_manual_translations#Gramps_5.1.x_Manual).

@GaryGriffin has generated a new offline manual for French users. It has been linked for download.

Thanks Gary!

---

<div class="post-metadata">

**Author:** ![ennoborg](https://yyz2.discourse-cdn.com/free1/user_avatar/gramps.discourse.group/ennoborg/32/4659_2.png) [@ennoborg](https://gramps.discourse.group/u/ennoborg)\
**Post date:** [November 12, 2023, 4:39pm UTC](https://gramps.discourse.group/t/gramps-offline-user-manual-user-guide-instructions/3773/16 "2023-11-12T16:39:36Z")

</div>

I found a weird error in the Dutch one. The on-line version has a chapter named Gebruikersmap, which is the proper translation for user('s) folder, but the PDF says Gebruikersnaam, which means user name. The PDF also has an English glossary at the end, which doesn’t show in the on-line version.

I might just have missed the latter on-line.

---

<div class="post-metadata">

**Author:** ![emyoulation](https://yyz2.discourse-cdn.com/free1/user_avatar/gramps.discourse.group/emyoulation/32/67_2.png) [@emyoulation](https://gramps.discourse.group/u/emyoulation)\
**Post date:** [November 12, 2023, 5:03pm UTC](https://gramps.discourse.group/t/gramps-offline-user-manual-user-guide-instructions/3773/17 "2023-11-12T17:03:42Z")

</div>

> [@ennoborg](#):
>
> The PDF also has an English glossary at the end, which doesn’t show in the on-line version.

Sam added the [Gramps Glossary](https://www.gramps-project.org/wiki/index.php/Gramps_Glossary) as **Appendix G** for the [5.2 wiki](https://gramps-project.org/wiki/index.php/Gramps_5.2_Wiki_Manual).

We didn’t (and won’t) have an Index. The hotlinked glossary provided a _similar_ navigation functionality. So Gary was kind enough to append it in the 5.1 PDFs.

---

<div class="post-metadata">

**Author:** ![ennoborg](https://yyz2.discourse-cdn.com/free1/user_avatar/gramps.discourse.group/ennoborg/32/4659_2.png) [@ennoborg](https://gramps.discourse.group/u/ennoborg)\
**Post date:** [November 12, 2023, 5:36pm UTC](https://gramps.discourse.group/t/gramps-offline-user-manual-user-guide-instructions/3773/18 "2023-11-12T17:36:13Z")

</div>

Note that, like I wrote on FB Messenger, I see no way to change that page title. It says Gebruikersmap in the contents/index, but the page itself says Gebruikersnaam, on-line and off-line.

I have admin rights on the wiki, but the 5.1 page is protected, and I see no way to change the ttile of the 5.2 page, which doesn’t even have that wrong term in its source code.

Does this mean that there is some automated translation, triggered by the macro that defines the page title or something?

---

<div class="post-metadata">

**Author:** ![ennoborg](https://yyz2.discourse-cdn.com/free1/user_avatar/gramps.discourse.group/ennoborg/32/4659_2.png) [@ennoborg](https://gramps.discourse.group/u/ennoborg)\
**Post date:** [November 12, 2023, 5:53pm UTC](https://gramps.discourse.group/t/gramps-offline-user-manual-user-guide-instructions/3773/19 "2023-11-12T17:53:04Z")

</div>

Well, to be honest, as a user, and reader, for which you asked for my help, I don’t care about the English version, at least not when I play the role of a Dutch speaking visitor.

In the Dutch version, available on

[https://gramps-project.org/wiki/index.php/Nl:Gramps\_5.2\_Wiki\_Handleiding](https://gramps-project.org/wiki/index.php/Nl:Gramps_5.2_Wiki_Handleiding)

I see 5 appendices, not 7, so that Appendix G isn’t there, and neither is F. And I still have a problem with Appendix D, which has the proper title in the TOC, but not on the page itself.

P.S. I mixed up index and Tabel Of Contents, and meant the latter.

---

<div class="post-metadata">

**Author:** ![emyoulation](https://yyz2.discourse-cdn.com/free1/user_avatar/gramps.discourse.group/emyoulation/32/67_2.png) [@emyoulation](https://gramps.discourse.group/u/emyoulation)\
**Post date:** [November 12, 2023, 6:11pm UTC](https://gramps.discourse.group/t/gramps-offline-user-manual-user-guide-instructions/3773/20 "2023-11-12T18:11:58Z")

</div>

The offline manual script builds a custom Table of Contents since the online version has too many levels to render cleanly. Since the

So the NL script apparently needs a revision.

If the page itself needs a naming refinement, experiments in that should probably be done in the 5.2 version before the corresponding version of Gramps goes public. Renaming a page can be complex. Lots of re-directs to be rectified to do that cleanly. And the translate page names already have an english version re-direct.

[https://gramps-project.org/wiki/index.php/Nl:Gramps\_5.2\_Wiki\_Handleiding\_-\_Gebruikersnaam](https://gramps-project.org/wiki/index.php/Nl:Gramps_5.2_Wiki_Handleiding_-_Gebruikersnaam)  
redirect from  
[https://gramps-project.org/wiki/index.php?title=Gramps\_5.2\_Wiki\_Manual\_-\_User\_Directory/nl](https://gramps-project.org/wiki/index.php?title=Gramps_5.2_Wiki_Manual_-_User_Directory/nl&redirect=no)

---

<div class="post-metadata">

**Author:** ![ennoborg](https://yyz2.discourse-cdn.com/free1/user_avatar/gramps.discourse.group/ennoborg/32/4659_2.png) [@ennoborg](https://gramps.discourse.group/u/ennoborg)\
**Post date:** [November 12, 2023, 6:32pm UTC](https://gramps.discourse.group/t/gramps-offline-user-manual-user-guide-instructions/3773/21 "2023-11-12T18:32:11Z")

</div>

H’m, interesting. I just changed the direct, so that it reads Gebruikersmap. And by doing that, I broke the link.

And from here, that is intentional, because this is the right title.

---

<div class="post-metadata">

**Author:** ![GaryGriffin](https://yyz2.discourse-cdn.com/free1/user_avatar/gramps.discourse.group/garygriffin/32/6525_2.png) [@GaryGriffin](https://gramps.discourse.group/u/GaryGriffin)\
**Post date:** [November 12, 2023, 6:55pm UTC](https://gramps.discourse.group/t/gramps-offline-user-manual-user-guide-instructions/3773/22 "2023-11-12T18:55:16Z")

</div>

Let me try to address the NL issues you mentioned.

1. Gebruikersmap vs Gebruikersnaam: The online manual ToC lists Gebruikersmap. This is a redirect. When I generate the offline manual, I ignore all ToC content and recreate from the H1 and H2 content of the pages. So to fix. you would have to rename the page and change all references for [Nl:Gramps 5.1 Wiki Handleiding - Gebruikersnaam - Gramps](https://gramps-project.org/wiki/index.php/Nl:Gramps_5.1_Wiki_Handleiding_-_Gebruikersnaam) . You would also need the page H1 to use the new name. Once renamed, it would be reflected in both the regenerated offline ToC and the chapter and footer.
2. Appendices: The offline manual has the same as the online but adds the Glossary to the bottom. The EN manual has an App E: Errors and Warnings. This is not in the NL version (neither online nor offline).

My intention is to reproduce the online version. Any errors that are in the online are also in the offline. Since 5.1 manual is locked at this point, any errors that need to be fixed need to be manually done in the script.

**I could manually fix in the 5.1 offline NL manual and regenerate if you think this is important.**

I can generate a 5.2 manual (the scripts to do yourself are at [Manual Generation 5.1 - Gramps](https://gramps-project.org/wiki/index.php/Manual_Generation_5.1) if you have command-line tools like sed and Make available on your system) if you have made changes there and want to verify they function.

[Next page](https://gramps.discourse.group/t/gramps-offline-user-manual-user-guide-instructions/3773.md?page=2)
