Difference between revisions of "Addon:Themes"

From Gramps
Jump to: navigation, search
(Settings: (Also called Dark Mode) search engine words. https://www.reddit.com/r/gramps/comments/iscm98/dark_mode_an_option/)
(6 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
{{Third-party plugin}}
 
{{Third-party plugin}}
 
{{languages|Addon:Themes}}
 
 
 
[[File:Preferences-Themes-addon.png|450px|right|thumb]]
 
[[File:Preferences-Themes-addon.png|450px|right|thumb]]
  
The Themes addon adds a small set of configuration settings to the Preferences dialog.  The original 'Colors' panel is updated and the new settings added at the top of the panel.
+
The Themes addon adds a small set of configuration settings to the Preferences dialog.  A new tab {{man label|Theme}} is added containing a few new settings related to Gramps appearance.
 +
== Settings ==
  
 
There are four new settings;
 
There are four new settings;
Line 14: Line 12:
  
  
* {{checkbox|0}} {{man label|Dark Variant}}  If the selected theme includes a dark version of the theme as a subset, then this will activate the dark version.(unselected by default)
+
* {{checkbox|0}} {{man label|Dark Variant}}  If the selected theme includes a dark version of the theme as a subset, then this will activate the dark version. This is deselected by default. (Also called Dark Mode)
 +
 
 +
 
 +
* {{man button|Font}}  This brings up a selector which allows the user to pick a Font, and/or change the font size.  The fonts presented are those found on the system. After making a font change restart Gramps.
  
  
* {{checkbox|0}} {{man label|Toolbar Text}}  This enables text below the main Gramps toolbar icons.(unselected by default)
+
* {{checkbox|0}} {{man label|Toolbar Text}}  This enables text below the main Gramps toolbar icons. This is deselected by default.
  
  
* {{man button|Default}}  This returns Gramps theme settings to their default values, as if no changes were made with these settings.  Note that the graph colors below are independent, they have their own 'Default' button to return them to the Gramps defaults.
+
* {{checkbox|0}} {{man label|Fixed Scrollbar (Requires Restart)}}  This changes the Gramps scrollbars to be a bit more 'classic' in that they don't disappear, they have the up/down buttons at the ends, and clicking in the empty space above and below the slider acts as page up or page down.  This is deselected by default.  This setting is only visible on Windows machines.  Note that changing this setting requires restarting Gramps, and may require restarting your session (Log off and log back on to Windows), particularly when disabling the setting.
  
  
* {{man button|Font}}  This brings up a selector which allows the user to pick a Font, and/or change the font size.  The fonts presented are those found on the system.
+
* {{man button|Restore to Defaults}}  This returns Gramps theme settings to their default values, as if no changes were made with these settings.
  
The remainder of the dialog is described in [[Gramps_5.0_Wiki_Manual_-_Settings#Colors]].
 
 
== Installing your own theme ==
 
== Installing your own theme ==
 
=== Windows ===
 
=== Windows ===
Line 32: Line 32:
 
The Gramps AIO version 5.0.x uses Gtk 3.18 or higher, so a theme MUST be selected that supports that version (themes that are designed for a later version may not work).  The current Gtk version is reported in the [[Addon:Prerequisites_Checker_Gramplet]].
 
The Gramps AIO version 5.0.x uses Gtk 3.18 or higher, so a theme MUST be selected that supports that version (themes that are designed for a later version may not work).  The current Gtk version is reported in the [[Addon:Prerequisites_Checker_Gramplet]].
  
Suitable themes might be found in [https://www.gnome-look.org/].
+
Suitable alternate themes may be found at the [https://www.gnome-look.org/ gnome-look.org] website.
  
Download the theme file (often a tar.gz) and if necessary decompress it using 7-zip of similar.
+
Download the theme file (often a tar.gz) and, if necessary, decompress it using 7-zip or similar.
  
 
The decompressed files should be stored in "C:\Users\you\.themes" (replacing 'you' with your user name) so that the final directory structure looks like:
 
The decompressed files should be stored in "C:\Users\you\.themes" (replacing 'you' with your user name) so that the final directory structure looks like:

Revision as of 03:09, 14 September 2020

Gramps-notes.png

Please use carefully on data that is backed up, and help make it better by reporting any comments or problems to the author, or issues to the bug tracker
Unless otherwise stated on this page, you can download this addon by following these instructions.
Please note that some Addons have prerequisites that need to be installed before they can be used.
This Addon/Plugin system is controlled by the Plugin Manager.

Preferences-Themes-addon.png

The Themes addon adds a small set of configuration settings to the Preferences dialog. A new tab Theme is added containing a few new settings related to Gramps appearance.

Settings

There are four new settings;

  • Theme:Adwaita setting allows the user to select from the installed themes on their machine. A few of the themes will come standard with the system library Gtk. Others may be part of the Operating System, particularly in Linux based systems.

Note that not all themes are fully compatible with Gtk and Gramps; if the theme selected doesn't look right, with missing elements or other issues, select another theme.


  • Dark Variant If the selected theme includes a dark version of the theme as a subset, then this will activate the dark version. This is deselected by default. (Also called Dark Mode)


  • Font This brings up a selector which allows the user to pick a Font, and/or change the font size. The fonts presented are those found on the system. After making a font change restart Gramps.


  • Toolbar Text This enables text below the main Gramps toolbar icons. This is deselected by default.


  • Fixed Scrollbar (Requires Restart) This changes the Gramps scrollbars to be a bit more 'classic' in that they don't disappear, they have the up/down buttons at the ends, and clicking in the empty space above and below the slider acts as page up or page down. This is deselected by default. This setting is only visible on Windows machines. Note that changing this setting requires restarting Gramps, and may require restarting your session (Log off and log back on to Windows), particularly when disabling the setting.


  • Restore to Defaults This returns Gramps theme settings to their default values, as if no changes were made with these settings.

Installing your own theme

Windows

It is possible to change the Gramps theme on the Windows AIO.

The Gramps AIO version 5.0.x uses Gtk 3.18 or higher, so a theme MUST be selected that supports that version (themes that are designed for a later version may not work). The current Gtk version is reported in the Addon:Prerequisites_Checker_Gramplet.

Suitable alternate themes may be found at the gnome-look.org website.

Download the theme file (often a tar.gz) and, if necessary, decompress it using 7-zip or similar.

The decompressed files should be stored in "C:\Users\you\.themes" (replacing 'you' with your user name) so that the final directory structure looks like:

C:\Users\you\.themes\YourThemeName

Linux

You should follow instructions for your distribution. Some other information that could help is provided GEPS_029:_GTK3-GObject_introspection_Conversion#GTK_3_theme.

See also