Tips & tricks for searching the Gramps documentation

It can be hard to find documentation on a feature in Gramps. There are a few methods built into Gramps & the wiki that may not be intuitive. In addition, I have developed a few techniques that have helped me.

Let’s share some of those… one tip per reply please. It encourages refinement suggestions be on point.

1 Like

When searching the wiki, I tend to use my phone.

It lets me set up a predictive text keyboard shortcut that suggest “site:gramps-project.org/wiki” any time I type “gr”.

So I can do the site specific Google search ‘xml tools site:gramps-project.org/wiki’ in very few keystrokes.

If you need to discover the Official Term to use in your Google ‘site’ search, refer to the Visual Guide to the Gramps Interface & the Gramps Glossary.

The Gramps Glossary is slowly (over the last couple years) being enhanced as a way to cut down on obscuring detail in wikipages.

The plethora of pages that explained Core Concepts had become a maintenance nightmare.

Rather than repeat something like how to change the Home Person (and explain the concept & purpose of a Home Person) each time it is mentioned in the manual, we can just link Home Person to the Home Person Glossary term.

People familiar with the concept don’t have to wade through excessive detail. But looking at the glossary term will give a short definition, it also links to the detailed introduction and usage.

Categories (at the bottom of each wiki page) give quick access to indices of subject matters.

Each “How do I…?” tutorial article has a How do I… category link that lists other tutorials. (At least, the ones that have been categorized!)

Note that we are trying to sub-categorize by language. We’re still working on alternatives to globally suppress page suggestions related to outdated Gramps versions. (Those older pages are left active to support users that have found reasons to not upgrade Gramps.)

Most add-on Gramplets have a wikipage dedicated to explaining the Gramplet use & idiosyncracies. And the Help button for the Gramplet opens a browser directly to that page.

But the Help button is ONLY visible when the Gramplet has been torn free (detached or undocked) from the Dashboard, sidebar or bottombar.

Note that a few developers add a ‘help’ icon button in the body of their Gramplet. Also, the Third-party add-on list also links to the documentation and include more than just Gramplet type add-ons.

The built-ins are more difficult to find. There’s no similar collated list.

Use the image management in MediaWiki to find illustrated documentation.

Pages that are illustrated (with the dialog or icon related to what you are doing) tend to be more introductory. When you click on an illustration, MediaWiki generate a page that includes a hotlinked list of pages that are illustrated with the image.

Use the screenshot gallery to find pages that use illustrations related to the feature. Look at the filterable thumbnail table of illustrations.
Individual icons are used less frequently as illustrations for the manual. But you can use the iconset and Icons to find pages illustrated with specific buttons.