# ---------------------------------------------------------------------
# Clearlooks Gimp 2.10.1x Hinted Themes v1.1
# Variant: Small (Blue Hints)
# Author: migf1 (2020)
#
# The file contain lots of comments, hopefully making it a little easier
# to mess around with it. That said, I'm not a gtkrc guru (quite the
# contrary). Chances are that things could have # been done much 
# better, and/or that some of those comments may be wrong. 
#
# If you are using Gimp 2.8, try the following themes instead:
# https://www.deviantart.com/migf1/art/Clearlooks-Flat-Icons-Gimp-2-8-Themes-v-1-0-1-484289796
#
# ---------------------------------------------------------------------
# LICENSE:
#
# This theme is Licensed under GNU GPL 2 or later,
# with an additional # Attribution term!
#
# Meaning that additionally to all GNU GPL terms, any derivative
# work must be explicitly # indentified as such, followed by an easily
# accessible link to my DeviantArt account:
# https://www.deviantart.com/migf1
# ---------------------------------------------------------------------
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 2 of the License, or
# any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this product. If not, see <http://www.gnu.org/licenses/>.
#

==========================================
GENERAL INFO
==========================================

This is an upgrade from my "Clearlooks Flat Icons Gimp 2.8 Themes v.1.0.1",
released back in 2014. If you are interested in them, they are available
on my DeviantArt account:
https://www.deviantart.com/migf1/art/Clearlooks-Flat-Icons-Gimp-2-8-Themes-v-1-0-1-484289796

The new "Clearlooks Gimp 2.10.1x Hinted Themes" are a complete
re-write, but they look and feel like the old ones. I started them
in Gimp 2.10.18 and finished them in Gimp 2.10.20 (I had so many
requests to update them, so I guess better late than never :)

Gimp 2.10.1x ships with its own flat, monochromatic icons, called
SYMBOLIC, and they look great. Aesthetically, my themes are meant
to be used with those icons, but your mileage may vary (they work
fine with all icon themes).

However, you still need the CLEARLOOKS theming engine, which
is NOT shipped with Gimp. See the THEMES INSTALLATION section,
further below.

There are DARK and LIGHT themes in the collection (MEDIUM ones
may be added in the future). For each one of them there is an
additional SMALL variant, using  smaller font, scrollbars, panel
gaps, etc.
	Dark
	Dark Small
	Light
	Light Small

Moreover, each variant comes in five (5) COLOR HINT versions:
	Blue
	Orange
	Pink
	Red
	Teal

This makes a total of 20 variations.

So for example, there are 2 dark themes with a blue color-hint:
	Clearlooks Dark (Blue Hints) 
	Clearlooks Dark Small (Blue Hints)

Similarly for the rest of the themes.

If you are using a 4K monitor, you probably do not want the "Small"
variants, unless you manually tweak the font-size, in their gtkrc
file. See the "USAGE TIPS: EDITING THE gtkrc FILE" dection, below.

These themes are meant to let you focus on your work instead of
distracting you. The color hints are meant to help you quickly spot
enabled settings inside Gimp's massive User Interface.


==========================================
THEMES INSTALLATION
==========================================

Please note that I am only using Windows now, so I don't really
know if the themes even work on other operating systems.

Also note that the themes NEED the GTK2 CLEARLOOKS theming
engine (see the separate section, below).

The themes come packed in a zip-file. Copy all the folders it contains
into one of the Gimp 2.10.1x "themes/" folders.

Gimp shows the full path of the folder(s) of all installed themes.
To see them, take these simple steps:
	1. Run Gimp
	2. Open the "Preferences" dialog (menu Edit -> Preferences)
	3. From the tree structure on the left, select "Interface | Theme"
	5. All installed themes should appear on the right pane of the dialog
	6. Keep a note of their folder path(s), and exit Gimp

On MS Windows (64-bit) Gimp looks for themes in 2 folders, namely:
	C:\Users\your-username-here\AppData\Roaming\GIMP\2.10\themes
	C:\Program Files\GIMP 2\share\gimp\2.0\themes\

On GNU/Linux, it should be something like this:
	home/.gimp-2.10/themes

On Mac, it should be something like this:
	/Users/your-username/Library/GIMP/2.10/themes

Anyway, do NOT guess! Just follow the 5 steps mentioned above,
and copy the themes in ONE of those folders!

*** WE ARE ALMOST THERE ***

We need to install the Clearlooks engine too!

==========================================
Clearlooks GTK2 Theming Engine Installation
==========================================

These themes need the GTK2 Clearlooks theming engine, which is
NOT shipped with Gimp.

On Windows
----------------------
A Windows version of the Clkearlooks engine (for both 32-bit & 64-bit
architectures) is included as a separate zip-file inside the main zip
file of the themes.

Unpack it and read its separate Readme.txt for instructions.

In short, and assuming Gimp is installed in its default folder, you
only need to copy the APPROPRIATE (x64 or x86) libclearlooks.dll
file into the following folder:
	On Windows (x64): C:\Program Files\GIMP 2\lib\gtk-2.0\2.10.0\engines
	On Windows (x86): C:\Program Files (x86)\GIMP 2\lib\gtk-2.0\2.10.0\engines

On GNU/Linux
----------------------
If you are still using a Gnome 2 (GTK2) theme on your system, then
chances are that the Clearlooks engine is already installed.

But many GTK2 based distros do NOT include it. Also, modern Linux
distros now come with GTK3, which does not include the engine.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
If you are BOTH brave & knowledgeable, try this first:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
	1. Google for the "gtk2-engines-clearlooks" or the "gtk2-engines"
		package FOR YOUR DISTRO (including 32/64-bit architecture).
		Try here: https://pkgs.org/download/gtk2-engines
	2. Download it (do NOT install it)
	3. Unpack it into a temporary directory
	4. Dig into the temporary directory and find the libclearlooks.so file
	5. Copy the libclearlooks.so into the following folder:
		(wherever Gimp is installed on your system)/lib/gtk-2.0/2.10.0/engines/
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Finding the right package for your exact distro can prove challenging.
But if you make this work, it will save you a system-wide GTK2 installation,
because Gimp ships with its own GTK2 runtime.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

If the above sounds way too scary, you can first install GTK2 on your
machine (if it isn't already). For example, on Ubuntu type the following
2 commands in the terminal:
	sudo apt-get update
	sudo apt-get install gtk2.0

As far as I know, GTK2 and GTK3 can co-exist on the same system,
but with the gazillion of distros out there you never know.
DO IT AT YOUR OWN RISK.

Then, depending on your distro, look for and install one of the
following packages:
	gtk2-engines
	gtk2-engine-clearlooks
	gtk2-engines-clearlooks

On Ubuntu, it's done by the following 2 commands in the terminal:
	sudo apt-get update
	sudo apt-get install gtk2-engines

Note that the "gtk2-engines" package contains many GTK2 engines,
not just Clearlooks. It is probably a good idea to go for it, just
in case other Gimp themes need one of those. Gimp currently ships
with only 2 engines: pixmap and wimp.

On MacOS / OS X
----------------------
I am sorry, but I really have no idea how Macs work. I found a couple
of links that might be helpful, but I doubt it since they look rather
old:

	1. GTK2: http://www.nongnu.org/bibledit/gtk2_mac_osx.html
	2. Clearlooks:  http://hints.macworld.com/article.php?story=20080309171359879

Maybe, just maybe, these links along with the GNU/Linux section
above can help you make the themes work.


==========================================
CHANGING THEMES FROM WITHIN GIMP 2.10.1X
==========================================

1. Run Gimp 2.10.1x

2. Select the menu command: Edit -> Preferences

3. In the dialog that pops up, select: "Theme" from the tree
   on the left, then select the desired theme from the list
   on the right.

4. Close the dialog by clicking on its "OK" button.

5. The new theme may be partially displayed on-the-fly,
   but you really need to quit Gimp and re-launch it.


==========================================
USAGE TIPS: EDITING THE gtkrc FILE
==========================================

Each of these themes is just a folder, named after the theme. The
folder contains a gtkrc file, which you can edit with any text-editor.

NOTE:
	You should use a plain text editor, not a word-processor, else
	you will screw the file up on Save! In any case, keep a backup
	copy of the original.

This section will show you a few lines you can edit in the gtkrc file,
to further improve your experience with the themes.

1.	If you are using a 4K monitor, you will probably need to set a
	much larger font-size (this will also increase most of the other
	elements too).

	Find and edit these 2 lines, in the gtkrc file:

		gtk-font-name = "Sans 7"
		font_name = "Sans 8.1"

	You only need to change the numeric values, but feel free to
	also specify a font family different than Sans (provided that
	the new font exists on your system already).

2.	These themes do not use icons inside menus and buttons.
	If you want them, replace 0 with 1 in the following lines:

		gtk-menu-images = 0
		gtk-button-images = 0

3. 	If you do not like any of the hint-colors provided by the themes,
	you can set your own by replacing the hex code in the following
	line:

		gtk_color_scheme = "hl_color:#3380B3"	# Current Highlight Color

	For example, to set a Golden Rod hint-color, replace #3380B3
	with #DAA520 in that line.

	Even better, you can use plain color names, as defined by the
	X11 standard: https://en.wikipedia.org/wiki/X11_color_names

	Try this:
		gtk_color_scheme = "hl_color:Golden Rod"	# Current Highlight Color

	NOTE that plain color name are NOT prefixed by the sharp sign (#).
	"hl_color:Golden Rod" VS "hl_color:#DAA520"
