Hi I'm Gioto,
an experienced Gramps user since 2006.
Thank you to the Gramps developers for making this great program.
WIP
Current focus
Update all user manual screenshots; even if the same, to be for 6.0.x
|
WIP later
sandbox
- User:Gioto/sandbox - Textual representation of Gramps interface & Test external images
- User:Gioto/sandbox2 - Report List (based on Gramplet List)
- User:Gioto/sandbox3 - Structure of the User Directory
- User:Gioto/sandbox4 - infobox generic
Stub removal
- Get rid of user manual stub sections
- Discourse: Gramps 6.0 Wiki manual Stub eradication
- https://gramps-project.org/wiki/index.php/Category:Cleanup oldtemplate seems stub replaced it so clean it up and redirect if needed!
Review Sam888's old user manual notes
- found in hidden comment on User manual (English) Statistics page Sam888#Update_for_Gramps_6.0 Notes review those comprehensive notes!(shows "As at 20200729")
Wiki housekeeping
- https://gramps-project.org/wiki/index.php/Special:TrackingCategories automatically populated by the MediaWiki software.
- https://gramps-project.org/wiki/index.php/Special:ListDuplicatedFiles 6 left
- https://gramps-project.org/bugs/view_all_bug_page.php?filter=68e47db41ba53 see the documentation tag on mantisbt ( 50 open issues have the tag out of 112)
Suggestions
- Suggest that a "help" icon & possibly "about" icon be added to the toolbar also? ? see this also
- Suggest that for categories with only one view; that the view should still display an icon on the toolbar (showing the views name) as it would make it easier to explain to users for consistency and screenshots (also some OS's don't display the title bar that shows the views name ) eg [1]
- Suggest adding a both a Help button to the result dialog and a About Quick View(s) button to the context menu https://gramps-project.org/wiki/index.php/Gramps_6.0_Wiki_Manual_-_Reports_-_part_8#Quick_Views also if possible show the name of the quick view in the title bar area of the dialog as it would make it easier to identify which one it is!
- Suggest they be listed in the Report_Selection_dialog as Quick View Reports?
New templates
Translateme
- This article or section needs to be translated if this pages translation is missing? { { Translateme } }
restructure and reorganize user manual
The ?GrampsWikiSupportTeam? is about to restructure and reorganize the user manual documentation for Gramps Desktop. If you are interested in helping, please visit our [? team page?] for information. For using the Gramps wiki, there is a starting place here. There is also a forum discussion about planning the restructure of the user documentation going on.
https://gramps.discourse.group/t/user-manual-translations-page-that-is-outdated-about-status/8232
Privacy button toggle
Make a template for the privacy button toggle, same text all the time! [2] from glossary:
Record is public/ private Padlock icon toggle defaults to public.
- Records are shown with
- a locked padlock when private; and, an unlocked padlock when public. Clicking the padlock icon toggles between Private & Public flags.
tab data present
Make a template for the many many variations of the same message about "bold font" to show presence of data on tabs! call the template: "tab-data-present"? eg: two different messages for the same thing ( this would be frustrating for translators! )
The tab labels reflect the presence of corresponding information: if the tab contains any data, its label appears boldface; if the tab has no data then its label appears regular (not bold). |
- another example the new media tab pages is
If a tab label is in boldface type, this means it contains data. If not, it has no data. |
- same page as new media tab page see new event tab pages where you see
Undo history warning window
Repeated quite often all over the website change to template?
Stuff for later
- Move "GEDCOM import limitations" section to Appendix
- Create new Prerequisites section for Appendix (linked to parts of Gramps that need them)?
- rename to "Quick views development" and free up page to be redirected to Quick_Views usermanual page / https://gramps-project.org/wiki/index.php/Quick_Views
- https://gramps-project.org/wiki/index.php/Gramps_6.0_Wiki_Manual_-_Gramplets list quick view from gramplet page in quick view section if needed?
- https://gramps-project.org/wiki/index.php/Gramps_6.0_Wiki_Manual_-_Navigation#Using_the_Addon_Manager
- the Addon_list_legend & wiki addon table - needs to be updated to match the addon manager https://gramps-project.org/wiki/index.php/Addon_list_legend
- See Patsyblefebre start https://gramps-project.org/wiki/index.php/User:Patsyblefebre/Template:AddonsX.x
- the Addon_list_legend & wiki addon table - needs to be updated to match the addon manager https://gramps-project.org/wiki/index.php/Addon_list_legend
- https://gramps-project.org/wiki/index.php/Gramps_6.0_Wiki_Manual_-_Categories#Relationships_Category redo screenshot without the addon!
- fix this template shows at wrong level! https://www.gramps-project.org/wiki/index.php/Template:View_Configuration_Options
- https://gramps-project.org/wiki/index.php/File:GeographyCategory-GeoPlaces-view-AllKnownPlaces-openstreemap-example-60.png redo screenshot without people category expanded!
- https://gramps-project.org/wiki/index.php/Gramps_6.0_Wiki_Manual_-_Categories#.E2.9A.99_People_category_Configuration_Options need to split this for each view to keep it simple!
- Dashboard de duplication request "Gioto these two section could be combined?"[3]
- https://gramps-project.org/wiki/index.php/Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#LDS combine or at least remove duplication
- https://gramps-project.org/wiki/index.php/Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#LDS_2 combine or at least remove duplication!
- https://gramps-project.org/wiki/index.php/Gramps_6.0_Wiki_Manual_-_Navigation#Using_Undo_History needs more work
- https://gramps-project.org/wiki/index.php/Gramps_6.0_Wiki_Manual_-_Settings#Selector_dialogs Selector_dialogs needs more work
- https://gramps-project.org/wiki/index.php/Gramps_6.0_Wiki_Manual_-_Settings#Place_Format_Editor Revise later.
- https://gramps-project.org/wiki/index.php/Gramps_6.0_Wiki_Manual_-_Settings#Display_Name_Editor need screenshot and cleanup
- https://gramps-project.org/wiki/index.php/Gramps_6.0_Wiki_Manual_-_Settings#Modularity_and_plugins ??? move section
- https://gramps-project.org/wiki/index.php/Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Export_options add two extra screenshots with focus on each unnamed section!
- https://gramps-project.org/wiki/index.php/Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1 Check the "Selectors" on the page! (media selectors especially)
- https://gramps-project.org/wiki/index.php/Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Multiple_Surnames incorporate the blog post!
- https://www.gramps-project.org/wiki/index.php/Gramps_6.0_Wiki_Manual_-_Manage_Family_Trees#Importing_data reorganize section so that people first get the help they want and then go into detail.
- help link https://gramps-project.org/wiki/index.php?title=Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_ID should be https://gramps-project.org/wiki/index.php?title=Gramps_6.0_Wiki_Manual_-_Tools#Reorder_Gramps_IDs
- https://gramps-project.org/wiki/index.php/Gramps_6.0_Wiki_Manual_-_Navigation#Find_a_Record add Dale's observations [4][5][6][7] rework section
- https://gramps-project.org/bugs/view.php?id=13988 Text entries in date fields
- have a look at https://gramps.discourse.group/t/place-name-change-based-on-events-year-not-working-as-expected/8587 when updating https://gramps-project.org/wiki/index.php/Gramps_6.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Editor_dialog
- https://gramps-project.org/wiki/index.php/Talk:Windows_AIO_themes merge article related to themes as requested
- something to be fixed duplication and redirection ?? https://gramps-project.org/wiki/index.php/Sitesupport-url and https://gramps-project.org/wiki/index.php/Gramps:About seem mixed fo different languages see https://gramps-project.org/wiki/index.php/Sitesupport-url/cs
- https://gramps-project.org/wiki/index.php/Internationalization make modern use of this page name and archive/move old page to a new name.
- rename page https://gramps-project.org/wiki/index.php/Animal_pedigree to make it clearer that it is related to translation. and see if you can use weblate to replicate this by assigining a custom ISO code as mentioned in Reserved and user-assigned code elements, ISO 3166-1 - From Wikipedia ( also check if french page "Pedigree animal" is really the translated name of the page? )
- Macedonian has two user manual "Getting Started" pages which one is correct?
- https://gramps-project.org/wiki/index.php/How_to_create_image_reference_regions rabbit hole!
- https://github.com/gramps-project/gramps/pull/1263
- An XMP region name refers to the name given to a specific area or region within an image, such as a person's face, using metadata standards like the Metadata Working Group (MWG) region schema or the IPTC extension schema
- https://gramps-project.org/bugs/view.php?id=12219 / https://gramps-project.org/bugs/view.php?id=7442 /
- Addon:Form_Definitions should screenshots of the forms be added?
Gramps icons for user manual
- https://www.gramps-project.org/wiki/index.php/Template:Icon
- https://gramps-project.org/wiki/index.php/Gramps_icon_set
- unversioned icons keep as is for now and move to individual templates later
collapsible sections example
See https://gramps-project.org/wiki/index.php/Comparison_of_genealogy_software for collapsible sections example
index automation
Create a feature request and upload the finished script. see
Stuff I've created
Language shortcuts GrampsAIO
- 13204 Gramps AIO64 5.2 Language icons Shortcuts Pack table below (Download zip file attached to take screenshots in different languages)
- Use pyshortcuts or psgshortcut to automate the creation of the shortcuts.
How to start Gramps AIO windows in existing user manual languages
User manual Screenshots
Notes for screenshots (when using #Language_shortcuts_GrampsAIO)
- Set a GRAMPSHOME for each Language otherwise you need to delete the gramps home profile ( gramps.ini ) files because Gramps shows the last language used in the gramplets titles! see Gramps_and_Windows#Setting_the_configuration_path
- Complete English screenshots then start on each of the other user manuals that are enabled.
- Using a spreadsheet to track each screenshot per language. and use https://gramps-project.org/wiki/index.php/Screenshots
- spreadsheet created 2025/07/10
- Greenshot for Image Annotation https://acrsupport.acr.org/support/solutions/articles/1000137445-greenshot-for-image-annotation
- See list of screenshots that have been annotated in some fashion! Need to provide instructions to translators for those screenshots that have words! (note that creating annotations is tedious !)
- If screenshot has yellow highlight decide if screenshot can be added without it ( less issues recreating the image!)
- Language selector - add back to other reports and need to link to an example of this on that calendar holidays page highlighted in yellow
- links for non English user manuals don't always work because of translated title and redirection! use
<span ID="Graphs"></span>wrapped around the relevant section title.
automate Gramps to show the what needs to be screenshot-ed
Have outline of a rudimentary script that manipulates and resizes the main Gramps window only via the gramps ini file, but have not quite worked out how to switch between categories and then take screenshot and restart Gramps in other languages and take same screenshot. (on-hold for now)
automate the screenshot process
- See stack-overflow question: Automatically taking screenshots of program window that mentions: "We have a software manual with a number of screenshots. When new version of software is released we need to update most of screenshots and we have to do it manually. Now we started translating manual to several languages and number of screenshots to take have increased ten fold. We'd like to automate this process."
- first answer AutoIt plus captdll.dll for all my Windows GUI automation tasks.
automate the bulk screenshot upload to mediawiki process
Sam888 says ok via email, will help if needed, thank you :)
- Bulk file uploader for MediaWiki sites https://github.com/Aspallar/Wiki-Up
- https://www.mediawiki.org/wiki/Category:Bulk_upload
User manual PDF generation
Once the screenshot automation is done on github, automatically run the following on github also
- Manual_Generation_5.1 by GaryGriffin
To do
- Gramps Performance see GEDFAN to create large test trees?
- Gramps Performance Testing - Doug Blank 2025/08/14 - To that end, I’ve started a new project that will live outside of gramps core that will measure the timing of various database functions. (It should live outside of gramps because the versions of the testing will be independent of the version of gramps).
- Category:Versions - template for Gramps release numbers etc.
Stuff for user manual
See WIP above.
- Mediawiki build a page from other pages content
- Mediawiki Help: Use mediawiki subpages to organise information.
- https://gramps-project.org/wiki/index.php/Devhelp Devhelp is a Gtk+/Gnome browser for API documentation; it works natively with gtk-doc (which is the API reference format for Gtk+/Gnome documentation). (Look at using this for Gramps user manual? ) Devhelp works natively with GTK-Doc, so the GTK and GNOME libraries are well supported. But other development platforms can be supported as well, as long as the API documentation is available in HTML and a *.devhelp2 index file is generated.
Adapt WebSearch's help tab
2025/10/03 Trialed Adapting WebSearch's help tab to show user manual section with a single image.
- https://gramps-project.org/wiki/index.php/Addon:WebSearch has a help tab / [ ] disuss with developer if he could split adapt into separate addon or enhance existing welcome addon?
- https://gramps.discourse.group/t/skip-files-in-weblate-translation/8534/1 use weblates string priority to mark user manual translations as option.
- Have also used code from details gramplet to show images for help.
More info on addons
- Talk:6.0_Addons#Not_listed
- User:Gioto/addons-source
- Other Gramps addons not in addon-source but listed on Github
- New FamilyTreeView Addon [8] A third-party addon for Gramps providing a navigable tree representation of ancestors, descendants and other related persons. Addon:FamilyTreeView
- Dynamic Web Report B check this one out
- Gramps-Web: Talk to your tree! DavidMStraub - I implemented a new AI chat feature in Gramps Web but it took me a while to sort out a few outstanding things and write documentation, now I can finally start advertising it. Gramps Web will soon be the first open source genealogy system with an AI assistant!
- https://gramps-project.org/wiki/index.php/Addon:Lokpurigado does not work on windows AIO / help url goes to wrong page / addon wiki page is called Lokpurigado but is about a different addon in the collection, possibly rename the page to Addon:Jean Michault's collection or make individual pages for each addon in collection ? need to ask ( note french version of page is about the correct addon https://gramps-project.org/wiki/index.php/Addon:Lokpurigado/fr ) following edit pasted the text of the wrong addon !
- https://gramps.discourse.group/t/an-experiment-in-bi-lingual-gramps/8677 An experiment in bi-lingual Gramps (addon) ?