summaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
Diffstat (limited to 'README')
-rw-r--r--README77
1 files changed, 77 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 00000000..a01e3428
--- /dev/null
+++ b/README
@@ -0,0 +1,77 @@
+==========================================================================
+NOTE: The remainder of this README applies only to the 7 accessibility
+ themes in this module:
+
+- HighContrast[LargePrint][Inverse]
+- LowContrast[LargePrint]
+- LargePrint
+==========================================================================
+
+0. Default Theme
+----------------
+
+All the a11y themes in this module inherit from the 'mate' theme.
+The 'mate' theme is in the mate-icon-theme module, and has to be built and installed separately.
+
+1. Editing the gtkrc files
+--------------------------
+
+The gtkrc.in files for each a11y theme are currently generated by autogen.sh. Each gtkrc.in file is the concatenation of these files:
+
+$theme/gtk-2.0/$theme.rc
+common/gtk-stock-icons.rc
+common/panel-stock-icons.rc
+common/media-stock-icons.rc
+common/capplet-stock-icons.rc
+
+It follows that you should NOT edit gtkrc.in directly. Instead, edit the appropriate .rc file, then re-autogen before building. This obviously kind of sucks, but it was the only way I could get it to work at the time :/
+
+
+2. Adding new icons
+-------------------
+
+The module is currently configured to make it easy to add or remove a stock icon from all themes at once, but not so easy to do so on a per-theme basis. This works well for now but probably won't if we want to make this a more general theme repository.
+
+So, to add a new gtk stock icon to all themes:
+
+- Add the icon's filename to common/all-stock-items.data
+- Add the line you want to appear in the themes' RC files to the appropriate common/*.rc file
+- Add the icon files, each with the same filename, to all the <theme>/pixmaps/ directories.
+
+MATE icons that are themed via the icon theming mechanism (as specified on freedesktop.org) are currently still added individually in each <theme>/icons subdirectory. E.g. to add a new 48x48 application icon to all the themes, you have to modify each <theme>/icons/48x48/apps/Makefile.am individually, and add the appropriate icon file to each <theme>/icons/48x48/apps directory.
+
+
+3. Changing icon sizes
+----------------------
+
+The icon sizes for ALL the LargePrint themes are defined in configure.in. Changing them here will affect all LargePrint themes.
+
+
+4. Changing colours
+--------------------
+
+To change the colours in a particular theme, edit its <themename>/gtk-2.0/<themename>.rc file.
+
+
+5. Switching icon themes
+------------------------
+In 2.2 and later, use mate-theme-manager, and choose the Icon theme from the Details subdialog.
+
+In earlier versions of MATE, unless you're running my patched theme switcher dialog (patch in bugzilla,
+#93486), you'll need to switch icon themes by hand using MateConf:
+
+$ mateconftool-2 -s /desktop/mate/interface/icon_theme "<themename>" --type=string
+
+
+6. To create low contrast icons in GIMP from the original coloured icon
+------------------------------------------------------------------------
+
+Use the low-contrast-preset.scm GIMP script in this directory to create a low
+contrast icon from a regular-coloured icon. (Read the comments in the script
+for instructions on how to install and use it.) Thanks to Guillermo for
+providing this!
+
+Note: In GIMP, Input=0/0.6/255, Output=75/255 seems to give results
+closer to the icons Suzanna converted in Photoshop, but plugging these
+values into this script seems to give different results from doing it
+manually in the Levels dialog :/