From 51545bd76d20f04e3e2162b7a94b346e03da2781 Mon Sep 17 00:00:00 2001 From: tweenk Date: Sun, 10 May 2009 15:41:23 +0000 Subject: [PATCH] Update READMEs for the icons directory. --- share/icons/README | 62 +++++++++++++++++++++++++++++---- share/icons/README.icon_themes | 29 --------------- share/icons/README.legacy_icons | 3 -- 3 files changed, 55 insertions(+), 39 deletions(-) delete mode 100644 share/icons/README.icon_themes delete mode 100644 share/icons/README.legacy_icons diff --git a/share/icons/README b/share/icons/README index 530dc3bef..9b79b73ea 100644 --- a/share/icons/README +++ b/share/icons/README @@ -1,10 +1,58 @@ -Jan 18, 2008 -ticotico.jpg is (C)2008 Dario Sanches licensed under Creative Commons by-sa 3.0 +======================== += INKSCAPE ICON THEMES = +======================== + +Starting with 0.47, Inkscape supports icon theming using the XDG Icon Theme +Specification [1]. It is implemented according to the Themable App Specific +Icons document [2]. Everything that's needed to replace Inkscape's icons +is to put appropriately named icons in your desktop environment's icon theme. +A list of the names is available at [3]. + +The monolithic icons.svg file is deprecated and should not be used to add new +icons. Support for it will probably be removed in the next release (0.48). + +== User notes == + +To get back the old icons on Linux, do the following: +1. Create the directory ~/.icons/OldInkscape +2. Copy the contents of the hicolor directory there +3. Edit the index.theme file; Replace "Name=hicolor" with "Name=OldInkscape", + and in a new line add "Inherits=YourTheme" where YourTheme is the + icon theme you're currently using, e.g. Human, gnome, etc. +4. Choose the OldInkscape theme from your desktop's appearance preferences. + +To use the Tango icons on Windows, go to INKDIR/share/icons, where INKDIR is +Inkscape's installation directory. Rename "hicolor" to "old", and then rename +"tango" to "hicolor". -Wed Jan 19, 2005 +== Developer notes == -All XPM and PNG icons have been replaced by SVG icons in icons.svg +The enabling bit of theming on Windows, which isn't mentioned in GTK docs, +is the index.theme file. Without it, gtk_icon_theme_load_icon fails with the +GTK_ICON_THEME_ERROR_FAILED error. -The only graphics that will be kept as XPMs will be the cursor -icons. (REJON: I"m actually in favor of trying to convert these to SVGs -as well.) These files are located in src/pixmaps. +Note that what dir the icon is in (actions, status, places) under the size +directory doesn't matter at all when icons are looked up; the lookup function +looks in all directories. + +== How to add an icon == + +To add a new icon, you have to do the following: +1. Draw the icon on a 48x48px canvas; for new icons, try to follow the Tango + guidelines [4]. +2. Name the icon according to the icon naming guidelines outlines in the + theme specification and using existing icons as a reference. +2. Place it in the appropriate directory under scalable in both hicolor + and tango. Choose the best suitable context ("places" for dialogs, + "actions" for actions, and "status" for status indicators and toggles). +3. Run the script render-icons.sh and then update-makefiles.sh in both + directories. + +References: +[1] http://standards.freedesktop.org/icon-theme-spec/icon-theme-spec-latest.html +[2] http://live.gnome.org/ThemableAppSpecificIcons +[3] http://wiki.inkscape.org/wiki/index.php/Themable_icons +[4] http://tango.freedesktop.org/Tango_Icon_Theme_Guidelines + +Jan 18, 2008 +ticotico.jpg is (C) 2008 Dario Sanches, licensed under Creative Commons by-sa 3.0 diff --git a/share/icons/README.icon_themes b/share/icons/README.icon_themes deleted file mode 100644 index c18d4ba6b..000000000 --- a/share/icons/README.icon_themes +++ /dev/null @@ -1,29 +0,0 @@ -CHANGING ICON THEMES --------------------- -The Inkscape icons are read from the file 'icons.svg' that resides in the same -directory as this README. - -If you want to try a new theme, create a folder named 'icons' in your personal -Inkscape folder (under Linux/Unix: $HOME/.inkscape), copy the file containing -the alternative theme in that folder and rename it to icons.svg. The next time -Inkscape is run the alternative icons will be loaded. - - -CREATING A NEW ICON THEME -------------------------- -To create a new theme or simply modify some icons you need to make sure each -icon is assigned the correct ID (its name). Opening 'icons.svg' in Inkscape and -selecting an icon will display its ID in the XML editor (Shift+Ctrl+X). - -The simplest way to proceed is to work on a copy of the icons.svg file and -modify each icon one after the other, using the XML editor to adapt its ID. - -For example, if you've drawn a new pen icon, select it on the canvas, then open -the XML editor. The node corresponding to the pen icon will be highlighted. -Click on its ID in the upper right panel of the XML editor. The bottom right -panel will display something like 'g2570'. Change that value to 'draw_pen' and -click the 'Set' button. - - -For any questions relating to icon themes, please contact: -Jean-François Lemaire (jflemaire@skynet.be). \ No newline at end of file diff --git a/share/icons/README.legacy_icons b/share/icons/README.legacy_icons deleted file mode 100644 index 9e67de9d7..000000000 --- a/share/icons/README.legacy_icons +++ /dev/null @@ -1,3 +0,0 @@ -This was Inkscape's original icon set from the initial release through the 0.43 release. -To use it, copy the file "legacy_icons.svg" into Inkscape's icons folder which resides -in your personal folder and rename it to "icons.svg". \ No newline at end of file -- 2.30.2