diff options
| author | Marc-Andre Lureau <marcandre.lureau@gmail.com> | 2008-02-11 14:29:54 +0200 |
|---|---|---|
| committer | Marc-Andre Lureau <marcandre.lureau@gmail.com> | 2008-02-11 14:29:54 +0200 |
| commit | 511a50e73f592a92b7d1892a515cbbfa91eace78 (patch) | |
| tree | e8d643f6dff626601e288f31a8cb6917644e0af9 | |
| parent | 16a64eaa03b69d1d81e9274b1c4e9b5b9a893299 (diff) | |
changing fdo theme default system/context/locale
| -rw-r--r-- | Makefile.in | 23 | ||||
| -rw-r--r-- | README | 4 | ||||
| -rw-r--r-- | spec/icon-naming-spec.xml | 2413 | ||||
| -rw-r--r-- | spec/icon-theme-spec.xml | 986 | ||||
| -rw-r--r-- | spec/sound-theme-spec.xml | 6 |
5 files changed, 14 insertions, 3418 deletions
diff --git a/Makefile.in b/Makefile.in index 379845c..1e0a92a 100644 --- a/Makefile.in +++ b/Makefile.in @@ -9,25 +9,20 @@ INSTALL_DATA = @INSTALL_DATA@ distdir = $(PACKAGE)-$(VERSION) FILES = README Makefile.in configure.ac configure install-sh index.theme ChangeLog COPYING -ICON_SIZES = 16x16 22x22 24x24 32x32 36x36 48x48 64x64 72x72 96x96 \ - 128x128 192x192 scalable -ICON_CONTEXTS = actions animations apps categories devices emblems emotes filesystems intl mimetypes places status stock -STOCK_SUBS = chart code data form image io media navigation net object table text +SOUND_SYSTEM = 2 5.1 +SOUND_CONTEXTS = alert notification support +SOUND_LOCALE = en all: @: install: - mkdir -p $(DESTDIR)$(datadir)/icons/hicolor - $(INSTALL_DATA) index.theme $(DESTDIR)$(datadir)/icons/hicolor - for dir in $(ICON_SIZES); do \ - for ctxt in $(ICON_CONTEXTS); do \ - mkdir -p $(DESTDIR)$(datadir)/icons/hicolor/$$dir/$$ctxt; \ - if [ "$$ctxt" = "stock" ]; then \ - for sub in $(STOCK_SUBS); do \ - mkdir -p $(DESTDIR)$(datadir)/icons/hicolor/$$dir/$$ctxt/$$sub; \ - done \ - fi \ + mkdir -p $(DESTDIR)$(datadir)/sounds/freedesktop + $(INSTALL_DATA) index.theme $(DESTDIR)$(datadir)/sounds/freedesktop + for dir in $(SOUND_SYSTEM); do \ + for ctxt in $(SOUND_CONTEXTS); do \ + mkdir -p $(DESTDIR)$(datadir)/sounds/freedesktop/$$dir/$$ctxt/; \ + mkdir -p $(DESTDIR)$(datadir)/sounds/freedesktop/$$dir/$$ctxt/$(SOUND_LOCALE); \ done \ done @@ -1,11 +1,11 @@ This is the default fallback theme used by implementations of the sound theme specification. -The specification is availible at: +The specification is available at: http://www.freedesktop.org/standards/sound-theme-spec/ To install this package in /usr just run: -make PREFIX=/usr +make install PREFIX=/usr The canonical location for this package is in the git repository of freedesktop.org. If you add translations, please send them to diff --git a/spec/icon-naming-spec.xml b/spec/icon-naming-spec.xml deleted file mode 100644 index e653acc..0000000 --- a/spec/icon-naming-spec.xml +++ /dev/null @@ -1,2413 +0,0 @@ -<?xml version="1.0"?> -<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" -"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ -]> -<article id="index"> - <articleinfo> - <title>Icon Naming Specification</title> - <releaseinfo>Version 0.8.90</releaseinfo> - <date>August 9 2007</date> - <authorgroup> - <author> - <firstname>Rodney</firstname> - <surname>Dawes</surname> - <affiliation> - <address> - <email>dobey.pwns@gmail.com</email> - </address> - </affiliation> - </author> - </authorgroup> - </articleinfo> - - <sect1 id="overview"> - <title>Overview</title> - <para> -The Icon Theme Specification has been in use now for a while, in several -desktops, including KDE and Gnome. However, there has never been any -centralized direction on how to name the icons that are available for use -by applications, when creating a theme. This has meant that artists have -historically had to duplicate many icons, in order for their themes to -work across desktop environments. - </para> - <para> -This specification aims to solve this problem, by laying out a standard -naming scheme for icon creation, as well as providing a minimal list of -must have icons, and a larger list with many more examples to help with -the creation of extended icons for third party applications, devices, -and new MIME types. - </para> - </sect1> - - <sect1 id="context"> - <title>Context</title> - - <para> - The list of default Contexts for the icon theme are: - </para> - - <table> - <title>Standard Contexts</title> - - <tgroup cols="3"> - <thead> - <row> - <entry>Name</entry> - <entry>Description</entry> - <entry>Directory</entry> - </row> - </thead> - <tbody> - <row> - <entry>Actions</entry> - <entry> -Icons which are generally used in menus and dialogs for -interacting with the user. - </entry> - <entry>actions</entry> - </row> - <row> - <entry>Animations</entry> - <entry> -Animated images used to represent loading web sites, or other -background processing which may be less suited to more verbose -progress reporting in the user itnerface. - </entry> - <entry>animations</entry> - </row> - <row> - <entry>Applications</entry> - <entry> -Icons that describe what an application is, for use in the -Programs menu, window decorations, and the task list. These may -or may not be generic depending on the application and its -purpose. Applications which are to be considered part of the base desktop, -such as the calculator or terminal, should use the generic icons specified in -this specification, while more advanced applications such as web browsers and -office applications should use branded icons which still give the user an idea -of what function the application provides. - </entry> - <entry>apps</entry> - </row> - <row> - <entry>Categories</entry> - <entry> -Icons that are used for categories in the Programs menu, or -the Control Center, for separating applications, preferences, and -settings for display to the user. - </entry> - <entry>categories</entry> - </row> - <row> - <entry>Devices</entry> - <entry> -Icons for hardware that is contained within or connected to the -computing device. Naming for extended devices in this group, is of the form -<primary function>-<manufacturer>-<model>. This allows ease -of fallback to the primary function device name, or ones more targeted for -a specific series of models from a manufacturer. For example, a theme author -may want to provide icons for different phones. The specific model icons could -be named <quote>phone-samsung-t809</quote>, <quote>phone-motorola-rokr</quote>, -and <quote>phone-motorola-pebl</quote>. However, the theme must provide a phone -icon in the theme's style, so that devices not matching these models, will -still have an appropriate icon. An exception to this rule is that the -<quote>media</quote> icons do not need to include manufacturer names, as they -are generic items, and may be available from many manufacturers. As a result, -for media, the specific icons are to differentiate between different specific -types of media. For exmaple, an artist may wish to provide icons for BluRay, -DVD, HD-DVD, CD-ROM, and variations thereof. The specific media type icons -should be named in the form, <primary function>-<specific format>. -Some examples are <quote>media-optical</quote>, <quote>media-optical-bd</quote> -and <quote>media-optical-dvd</quote>. - </entry> - <entry>devices</entry> - </row> - <row> - <entry>Emblems</entry> - <entry> -Icons for tags and properties of files, that are displayed in the -file manager. This context contains emblems for such things as -<quote>read-only</quote> or <quote>photos</quote>. - </entry> - <entry>emblems</entry> - </row> - <row> - <entry>Emotes</entry> - <entry> -Icons for emotions that are expressed through text chat -applications such as :-) or :-P in IRC or instant messengers. - </entry> - <entry>emotes</entry> - </row> - <row> - <entry>International</entry> - <entry> -Icons for international denominations such as flags. - </entry> - <entry>intl</entry> - </row> - <row> - <entry>MimeTypes</entry> - <entry> -Icons for different types of data, such as audio or image files. - </entry> - <entry>mimetypes</entry> - </row> - <row> - <entry>Places</entry> - <entry> -Icons used to represent locations, either on the local -filesystem, or through remote connections. Folders, trash, and -workgroups are some examples. - </entry> - <entry>places</entry> - </row> - <row> - <entry>Status</entry> - <entry> -Icons for presenting status to the user. This context contains -icons for warning and error dialogs, as well as for the current -weather, appointment alarms, and battery status. - </entry> - <entry>status</entry> - </row> - </tbody> - </tgroup> - </table> - </sect1> - - <sect1 id="guidelines"> - <title>Icon Naming Guidelines</title> - - <para> -Here we define some guidelines for when creating new icons that extend -the standardized list of icon names defined here, in order to provide -icons for more specific MIME types, devices, or international flags. - <itemizedlist> - <listitem> - <para> -Icon names are in the en_US.US_ASCII locale. This means that the -allowable characters in the icon names, must fall withing the -US-ASCII character set. As a further restriction, all icon names -may only contain lowercase letters, numbers, underscore, dash, or -period characters. Spaces, colons, slashes, and backslashes are -not allowed. Also, icon names must be spelled as they are in the -en_US dictionary. - </para> - </listitem> - <listitem> - <para> -The dash <quote>-</quote> character is used to separate levels of -specificity in icon names, for all contexts other than MimeTypes. -For instance, we use <quote>input-mouse</quote> as the generic -item for all mouse devices, and we use <quote>input-mouse-usb</quote> -for a USB mouse device. However, if the more specific item does not exist -in the current theme, and does exist in a parent theme, the generic icon -from the current theme is preferred, in order to keep consistent style. - </para> - </listitem> - <listitem> - <para> -Icons for branded applications should be named the same as the binary -executable for the application. - </para> - </listitem> - </itemizedlist> - </para> - </sect1> - - <sect1 id="names"> - <title>Standard Icon Names</title> - - <para> -This section describes the standard icon names that should be used by -artists when creating themes, and by developers when writing applications -which will use the Icon Theme Specification. - </para> - - <table id="actions"> - <title>Standard Action Icons</title> - <tgroup cols="2"> - <thead> - <row> - <entry>Name</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>address-book-new</entry> - <entry> -The icon used for the action to create a new address book. - </entry> - </row> - <row> - <entry>application-exit</entry> - <entry> -The icon used for exiting an application. Typically this is seen -in the application's menus as File->Quit. - </entry> - </row> - <row> - <entry>appointment-new</entry> - <entry> -The icon used for the action to create a new appointment -in a calendaring application. - </entry> - </row> - <row> - <entry>contact-new</entry> - <entry> -The icon used for the action to create a new contact -in an address book application. - </entry> - </row> - <row> - <entry>document-new</entry> - <entry> -The icon used for the action to create a new document. - </entry> - </row> - <row> - <entry>document-open</entry> - <entry> -The icon used for the action to open a document. - </entry> - </row> - <row> - <entry>document-open-recent</entry> - <entry> -The icon used for the action to open a document that -was recently opened. - </entry> - </row> - <row> - <entry>document-page-setup</entry> - <entry> -The icon for the page setup action of a document editor. - </entry> - </row> - <row> - <entry>document-print</entry> - <entry> -The icon for the print action of an application. - </entry> - </row> - <row> - <entry>document-print-preview</entry> - <entry> -The icon for the print preview action of an application. - </entry> - </row> - <row> - <entry>document-properties</entry> - <entry> -The icon for the action to view the properties of a -document in an application. - </entry> - </row> - <row> - <entry>document-revert</entry> - <entry> -The icon for the action of reverting to a previous -version of a document. - </entry> - </row> - <row> - <entry>document-save</entry> - <entry> -The icon for the save action. - </entry> - </row> - <row> - <entry>document-save-as</entry> - <entry> -The icon for the save as action. - </entry> - </row> - <row> - <entry>edit-clear</entry> - <entry> -The icon for the clear action. - </entry> - </row> - <row> - <entry>edit-copy</entry> - <entry> -The icon for the copy action. - </entry> - </row> - <row> - <entry>edit-cut</entry> - <entry> -The icon for the cut action. - </entry> - </row> - <row> - <entry>edit-delete</entry> - <entry> -The icon for the delete action. - </entry> - </row> - <row> - <entry>edit-find</entry> - <entry> -The icon for the find action. - </entry> - </row> - <row> - <entry>edit-find-replace</entry> - <entry> -The icon for the find and replace action. - </entry> - </row> - <row> - <entry>edit-paste</entry> - <entry> -The icon for the paste action. - </entry> - </row> - <row> - <entry>edit-redo</entry> - <entry> -The icon for the redo action. - </entry> - </row> - <row> - <entry>edit-select-all</entry> - <entry> -The icon for the select all action. - </entry> - </row> - <row> - <entry>edit-undo</entry> - <entry> -The icon for the undo action. - </entry> - </row> - <row> - <entry>folder-new</entry> - <entry> -The icon for creating a new folder. - </entry> - </row> - <row> - <entry>format-indent-less</entry> - <entry> -The icon for the decrease indent formatting action. - </entry> - </row> - <row> - <entry>format-indent-more</entry> - <entry> -The icon for the increase indent formatting action. - </entry> - </row> - <row> - <entry>format-justify-center</entry> - <entry> -The icon for the center justification formatting action. - </entry> - </row> - <row> - <entry>format-justify-fill</entry> - <entry> -The icon for the fill justification formatting action. - </entry> - </row> - <row> - <entry>format-justify-left</entry> - <entry> -The icon for the left justification formatting action. - </entry> - </row> - <row> - <entry>format-justify-right</entry> - <entry> -The icon for the right justification action. - </entry> - </row> - <row> - <entry>format-text-direction-ltr</entry> - <entry> -The icon for the left-to-right text formatting action. - </entry> - </row> - <row> - <entry>format-text-direction-rtl</entry> - <entry> -The icon for the right-to-left formatting action. - </entry> - </row> - <row> - <entry>format-text-bold</entry> - <entry> -The icon for the bold text formatting action. - </entry> - </row> - <row> - <entry>format-text-italic</entry> - <entry> -The icon for the italic text formatting action. - </entry> - </row> - <row> - <entry>format-text-underline</entry> - <entry> -The icon for the underlined text formatting action. - </entry> - </row> - <row> - <entry>format-text-strikethrough</entry> - <entry> -The icon for the strikethrough text formatting action. - </entry> - </row> - <row> - <entry>go-bottom</entry> - <entry> -The icon for the go to bottom of a list action. - </entry> - </row> - <row> - <entry>go-down</entry> - <entry> -The icon for the go down in a list action. - </entry> - </row> - <row> - <entry>go-first</entry> - <entry> -The icon for the go to the first item in a list action. - </entry> - </row> - <row> - <entry>go-home</entry> - <entry> -The icon for the go to home location action. - </entry> - </row> - <row> - <entry>go-jump</entry> - <entry> -The icon for the jump to action. - </entry> - </row> - <row> - <entry>go-last</entry> - <entry> -The icon for the go to the last item in a list action. - </entry> - </row> - <row> - <entry>go-next</entry> - <entry> -The icon for the go to the next item in a list action. - </entry> - </row> - <row> - <entry>go-previous</entry> - <entry> -The icon for the go to the previous item in a list action. - </entry> - </row> - <row> - <entry>go-top</entry> - <entry> -The icon for the go to the top of a list action. - </entry> - </row> - <row> - <entry>go-up</entry> - <entry> -The icon for the go up in a list action. - </entry> - </row> - <row> - <entry>help-about</entry> - <entry> -The icon for the About item in the Help menu. - </entry> - </row> - <row> - <entry>help-contents</entry> - <entry> -The icon for Contents item in the Help menu. - </entry> - </row> - <row> - <entry>help-faq</entry> - <entry> -The icon for the FAQ item in the Help menu. - </entry> - </row> - <row> - <entry>insert-image</entry> - <entry> -The icon for the insert image action of an application. - </entry> - </row> - <row> - <entry>insert-link</entry> - <entry> -The icon for the insert link action of an application. - </entry> - </row> - <row> - <entry>insert-object</entry> - <entry> -The icon for the insert object action of an application. - </entry> - </row> - <row> - <entry>insert-text</entry> - <entry> -The icon for the insert text action of an application. - </entry> - </row> - <row> - <entry>list-add</entry> - <entry> -The icon for the add to list action. - </entry> - </row> - <row> - <entry>list-remove</entry> - <entry> -The icon for the remove from list action. - </entry> - </row> - <row> - <entry>mail-forward</entry> - <entry> -The icon for the forward action of an electronic mail application. - </entry> - </row> - <row> - <entry>mail-mark-important</entry> - <entry> -The icon for the mark as important action of an electronic mail application. - </entry> - </row> - <row> - <entry>mail-mark-junk</entry> - <entry> -The icon for the mark as junk action of an electronic mail application. - </entry> - </row> - <row> - <entry>mail-mark-notjunk</entry> - <entry> -The icon for the mark as not junk action of an electronic mail application. - </entry> - </row> - <row> - <entry>mail-mark-read</entry> - <entry> -The icon for the mark as read action of an electronic mail application. - </entry> - </row> - <row> - <entry>mail-mark-unread</entry> - <entry> -The icon for the mark as unread action of an electronic mail application. - </entry> - </row> - <row> - <entry>mail-message-new</entry> - <entry> -The icon for the compose new mail action of an electronic mail application. - </entry> - </row> - <row> - <entry>mail-reply-all</entry> - <entry> -The icon for the reply to all action of an electronic mail application. - </entry> - </row> - <row> - <entry>mail-reply-sender</entry> - <entry> -The icon for the reply to sender action of an electronic mail application. - </entry> - </row> - <row> - <entry>mail-send</entry> - <entry> -The icon for the send action of an electronic mail application. - </entry> - </row> - <row> - <entry>mail-send-receive</entry> - <entry> -The icon for the send and receive action of an electronic mail application. - </entry> - </row> - <row> - <entry>media-eject</entry> - <entry> -The icon for the eject action of a media player or file manager. - </entry> - </row> - <row> - <entry>media-playback-pause</entry> - <entry> -The icon for the pause action of a media player. - </entry> - </row> - <row> - <entry>media-playback-start</entry> - <entry> -The icon for the start playback action of a media player. - </entry> - </row> - <row> - <entry>media-playback-stop</entry> - <entry> -The icon for the stop action of a media player. - </entry> - </row> - <row> - <entry>media-record</entry> - <entry> -The icon for the record action of a media application. - </entry> - </row> - <row> - <entry>media-seek-backward</entry> - <entry> -The icon for the seek backward action of a media player. - </entry> - </row> - <row> - <entry>media-seek-forward</entry> - <entry> -The icon for the seek forward action of a media player. - </entry> - </row> - <row> - <entry>media-skip-backward</entry> - <entry> -The icon for the skip backward action of a media player. - </entry> - </row> - <row> - <entry>media-skip-forward</entry> - <entry> -The icon for the skip forward action of a media player. - </entry> - </row> - <row> - <entry>object-flip-horizontal</entry> - <entry> -The icon for the action to flip an object horizontally. - </entry> - </row> - <row> - <entry>object-flip-vertical</entry> - <entry> -The icon for the action to flip an object vertically. - </entry> - </row> - <row> - <entry>object-rotate-left</entry> - <entry> -The icon for the rotate left action performed on an object. - </entry> - </row> - <row> - <entry>object-rotate-right</entry> - <entry> -The icon for the rotate rigt action performed on an object. - </entry> - </row> - <row> - <entry>process-stop</entry> - <entry> -The icon used for the <quote>Stop</quote> action in applications with actions -that may take a while to process, such as web page loading in a browser. - </entry> - </row> - <row> - <entry>system-lock-screen</entry> - <entry> -The icon used for the <quote>Lock Screen</quote> item in the desktop's -panel application. - </entry> - </row> - <row> - <entry>system-log-out</entry> - <entry> -The icon used for the <quote>Log Out</quote> item in -the desktop's panel application. - </entry> - </row> - <row> - <entry>system-run</entry> - <entry> -The icon used for the <quote>Run Application...</quote> item in -the desktop's panel application. - </entry> - </row> - <row> - <entry>system-search</entry> - <entry> -The icon used for the <quote>Search</quote> item in -the desktop's panel application. - </entry> - </row> - <row> - <entry>tools-check-spelling</entry> - <entry> -The icon used for the <quote>Check Spelling</quote> item in the -application's <quote>Tools</quote> menu. - </entry> - </row> - <row> - <entry>view-fullscreen</entry> - <entry> -The icon used for the <quote>Fullscreen</quote> item in the -application's <quote>View</quote> menu. - </entry> - </row> - <row> - <entry>view-refresh</entry> - <entry> -The icon used for the <quote>Refresh</quote> item in the -application's <quote>View</quote> menu. - </entry> - </row> - <row> - <entry>view-restore</entry> - <entry> -The icon used by an application for leaving the fullscreen view, and returning -to a normal windowed view. - </entry> - </row> - <row> - <entry>view-sort-ascending</entry> - <entry> -The icon used for the <quote>Sort Ascending</quote> item in the -application's <quote>View</quote> menu, or in a button for -changing the sort method for a list. - </entry> - </row> - <row> - <entry>view-sort-descending</entry> - <entry> -The icon used for the <quote>Sort Descending</quote> item in the -application's <quote>View</quote> menu, or in a button for -changing the sort method for a list. - </entry> - </row> - <row> - <entry>window-close</entry> - <entry> -The icon used for the <quote>Close Window</quote> item in the -application's <quote>Windows</quote> menu. - </entry> - </row> - <row> - <entry>window-new</entry> - <entry> -The icon used for the <quote>New Window</quote> item in the -application's <quote>Windows</quote> menu. - </entry> - </row> - <row> - <entry>zoom-fit-best</entry> - <entry> -The icon used for the <quote>Best Fit</quote> item in the -application's <quote>View</quote> menu. - </entry> - </row> - <row> - <entry>zoom-in</entry> - <entry> -The icon used for the <quote>Zoom in</quote> item in the -application's <quote>View</quote> menu. - </entry> - </row> - <row> - <entry>zoom-original</entry> - <entry> -The icon used for the <quote>Original Size</quote> item in the -application's <quote>View</quote> menu. - </entry> - </row> - <row> - <entry>zoom-out</entry> - <entry> -The icon used for the <quote>Zoom Out</quote> item in the -application's <quote>View</quote> menu. - </entry> - </row> - </tbody> - </tgroup> - </table> - - <table id="animations"> - <title>Standard Animation Icons</title> - <tgroup cols="2"> - <thead> - <row> - <entry>Name</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>process-working</entry> - <entry> -This is the standard spinner animation for web browsers and -file managers to show that the location is loading. This image -should be a multi-frame PNG with the frames as the size that -the directory containing the image, is specified to be in. The -first frame of the animation should be used for the resting -state of the animation. - </entry> - </row> - </tbody> - </tgroup> - </table> - - <table id="apps"> - <title>Standard Application Icons</title> - <tgroup cols="2"> - <thead> - <row> - <entry>Name</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>accessories-calculator</entry> - <entry> -The icon used for the desktop's calculator accessory program. - </entry> - </row> - <row> - <entry>accessories-character-map</entry> - <entry> -The icon used for the desktop's international and extended text -character accessory program. - </entry> - </row> - <row> - <entry>accessories-dictionary</entry> - <entry> -The icon used for the desktop's dictionary accessory program. - </entry> - </row> - <row> - <entry>accessories-text-editor</entry> - <entry> -The icon used for the desktop's text editing accessory program. - </entry> - </row> - <row> - <entry>help-browser</entry> - <entry> -The icon used for the desktop's help browsing application. - </entry> - </row> - <row> - <entry>multimedia-volume-control</entry> - <entry> -The icon used for the desktop's hardware volume control application. - </entry> - </row> - <row> - <entry>preferences-desktop-accessibility</entry> - <entry> -The icon used for the desktop's accessibility preferences. - </entry> - </row> - <row> - <entry>preferences-desktop-font</entry> - <entry> -The icon used for the desktop's font preferences. - </entry> - </row> - <row> - <entry>preferences-desktop-keyboard</entry> - <entry> -The icon used for the desktop's keyboard preferences. - </entry> - </row> - <row> - <entry>preferences-desktop-locale</entry> - <entry> -The icon used for the desktop's locale preferences. - </entry> - </row> - <row> - <entry>preferences-desktop-multimedia</entry> - <entry> -The icon used for the desktop's multimedia preferences. - </entry> - </row> - <row> - <entry>preferences-desktop-screensaver</entry> - <entry> -The icon used for the desktop's screen saving preferences. - </entry> - </row> - <row> - <entry>preferences-desktop-theme</entry> - <entry> -The icon used for the desktop's theme preferences. - </entry> - </row> - <row> - <entry>preferences-desktop-wallpaper</entry> - <entry> -The icon used for the desktop's wallpaper preferences. - </entry> - </row> - <row> - <entry>system-file-manager</entry> - <entry> -The icon used for the desktop's file management application. - </entry> - </row> - <row> - <entry>system-software-update</entry> - <entry> -The icon used for the desktop's software updating application. - </entry> - </row> - <row> - <entry>utilities-system-monitor</entry> - <entry> -The icon used for the desktop's system resource monitor application. - </entry> - </row> - <row> - <entry>utilities-terminal</entry> - <entry> -The icon used for the desktop's terminal emulation application. - </entry> - </row> - </tbody> - </tgroup> - </table> - - <table id="categories"> - <title>Standard Category Icons</title> - <tgroup cols="2"> - <thead> - <row> - <entry>Name</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>applications-accessories</entry> - <entry> -The icon for the <quote>Accessories</quote> sub-menu of the Programs menu. - </entry> - </row> - <row> - <entry>applications-development</entry> - <entry> -The icon for the <quote>Programming</quote> sub-menu of the Programs menu. - </entry> - </row> - <row> - <entry>applications-engineering</entry> - <entry> -The icon for the <quote>Engineering</quote> sub-menu of the Programs menu. - </entry> - </row> - <row> - <entry>applications-games</entry> - <entry> -The icon for the <quote>Games</quote> sub-menu of the Programs menu. - </entry> - </row> - <row> - <entry>applications-graphics</entry> - <entry> -The icon for the <quote>Graphics</quote> sub-menu of the Programs menu. - </entry> - </row> - <row> - <entry>applications-internet</entry> - <entry> -The icon for the <quote>Internet</quote> sub-menu of the Programs menu. - </entry> - </row> - <row> - <entry>applications-multimedia</entry> - <entry> -The icon for the <quote>Multimedia</quote> sub-menu of the Programs menu. - </entry> - </row> - <row> - <entry>applications-office</entry> - <entry> -The icon for the <quote>Office</quote> sub-menu of the Programs menu. - </entry> - </row> - <row> - <entry>applications-other</entry> - <entry> -The icon for the <quote>Other</quote> sub-menu of the Programs menu. - </entry> - </row> - <row> - <entry>applications-science</entry> - <entry> -The icon for the <quote>Science</quote> sub-menu of the Programs menu. - </entry> - </row> - <row> - <entry>applications-system</entry> - <entry> -The icon for the <quote>System Tools</quote> sub-menu of the Programs menu. - </entry> - </row> - <row> - <entry>applications-utilities</entry> - <entry> -The icon for the <quote>Utilities</quote> sub-menu of the Programs menu. - </entry> - </row> - <row> - <entry>preferences-desktop</entry> - <entry> -The icon for the <quote>Desktop Preferences</quote> category. - </entry> - </row> - <row> - <entry>preferences-desktop-peripherals</entry> - <entry> -The icon for the <quote>Peripherals</quote> sub-category of -the <quote>Desktop Preferences</quote> category. - </entry> - </row> - <row> - <entry>preferences-desktop-personal</entry> - <entry> -The icon for the <quote>Personal</quote> sub-category of -the <quote>Desktop Preferences</quote> category. - </entry> - </row> - <row> - <entry>preferences-other</entry> - <entry> -The icon for the <quote>Other</quote> preferences category. - </entry> - </row> - <row> - <entry>preferences-system</entry> - <entry> -The icon for the <quote>System Preferences</quote> category. - </entry> - </row> - <row> - <entry>preferences-system-network</entry> - <entry> -The icon for the <quote>Network</quote> sub-category of -the <quote>System Preferences</quote> category. - </entry> - </row> - <row> - <entry>system-help</entry> - <entry> -The icon for the <quote>Help</quote> system category. - </entry> - </row> - </tbody> - </tgroup> - </table> - - <table id="devices"> - <title>Standard Device Icons</title> - <tgroup cols="2"> - <thead> - <row> - <entry>Name</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>audio-card</entry> - <entry> -The icon used for the audio rendering device. - </entry> - </row> - <row> - <entry>audio-input-microphone</entry> - <entry> -The icon used for the microphone audio input device. - </entry> - </row> - <row> - <entry>battery</entry> - <entry> -The icon used for the system battery device. - </entry> - </row> - <row> - <entry>camera-photo</entry> - <entry> -The icon used for a digital still camera devices. - </entry> - </row> - <row> - <entry>camera-video</entry> - <entry> -The fallback icon for video cameras. - </entry> - </row> - <row> - <entry>camera-web</entry> - <entry> -The fallback icon for web cameras. - </entry> - </row> - <row> - <entry>computer</entry> - <entry> -The icon used for the computing device as a whole. - </entry> - </row> - <row> - <entry>drive-harddisk</entry> - <entry> -The icon used for hard disk drives. - </entry> - </row> - <row> - <entry>drive-optical</entry> - <entry> -The icon used for optical media drives such as CD and DVD. - </entry> - </row> - <row> - <entry>drive-removable-media</entry> - <entry> -The icon used for removable media drives. - </entry> - </row> - <row> - <entry>input-gaming</entry> - <entry> -The icon used for the gaming input device. - </entry> - </row> - <row> - <entry>input-keyboard</entry> - <entry> -The icon used for the keyboard input device. - </entry> - </row> - <row> - <entry>input-mouse</entry> - <entry> -The icon used for the mousing input device. - </entry> - </row> - <row> - <entry>input-tablet</entry> - <entry> -The icon used for graphics tablet input devices. - </entry> - </row> - <row> - <entry>media-flash</entry> - <entry> -The fallback icon used for flash media, such as memory stick and SD. - </entry> - </row> - <row> - <entry>media-floppy</entry> - <entry> -The icon used for physical floppy disk media. - </entry> - </row> - <row> - <entry>media-optical</entry> - <entry> -The icon used for physical optical media such as CD and DVD. - </entry> - </row> - <row> - <entry>media-tape</entry> - <entry> -The icon used for generic physical tape media. - </entry> - </row> - <row> - <entry>modem</entry> - <entry> -The icon used for modem devices. - </entry> - </row> - <row> - <entry>multimedia-player</entry> - <entry> -The icon used for generic multimedia playing devices. - </entry> - </row> - <row> - <entry>network-wired</entry> - <entry> -The icon used for wired network connections. - </entry> - </row> - <row> - <entry>network-wireless</entry> - <entry> -The icon used for wireless network connections. - </entry> - </row> - <row> - <entry>pda</entry> - <entry> -This is the fallback icon for Personal Digial Assistant devices. Primary use -of this icon is for PDA devices connected to the PC. Connection medium is not -an important aspect of the icon. The metaphor for this fallback icon should be -a generic PDA device icon. - </entry> - </row> - <row> - <entry>phone</entry> - <entry> -This is the default fallback for phone devices. Primary use of this icon group -is for phone devices which support connectivity to the PC. These may be VoIP, -cellular, or possibly landline phones. The metaphor for this fallback should be -a generic mobile phone device. - </entry> - </row> - <row> - <entry>printer</entry> - <entry> -The icon used for a printer device. - </entry> - </row> - <row> - <entry>scanner</entry> - <entry> -The icon used for a scanner device. - </entry> - </row> - <row> - <entry>video-display</entry> - <entry> -The icon used for the monitor that video gets displayed to. - </entry> - </row> - </tbody> - </tgroup> - </table> - - <table id="emblems"> - <title>Standard Emblem Icons</title> - <tgroup cols="2"> - <thead> - <row> - <entry>Name</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>emblem-default</entry> - <entry> -The icon used as an emblem to specify the default selection of a printer for -example. - </entry> - </row> - <row> - <entry>emblem-documents</entry> - <entry> -The icon used as an emblem for the directory where a user's documents are stored. - </entry> - </row> - <row> - <entry>emblem-downloads</entry> - <entry> -The icon used as an emblem for the directory where a user's -downloads from the internet are stored. - </entry> - </row> - <row> - <entry>emblem-favorite</entry> - <entry> -The icon used as an emblem for files and directories that the -user marks as favorites. - </entry> - </row> - <row> - <entry>emblem-important</entry> - <entry> -The icon used as an emblem for files and directories that are -marked as important by the user. - </entry> - </row> - <row> - <entry>emblem-mail</entry> - <entry> -The icon used as an emblem to specify the directory where the -user's electronic mail is stored. - </entry> - </row> - <row> - <entry>emblem-photos</entry> - <entry> -The icon used as an emblem to specify the directory where the -user stores photographs. - </entry> - </row> - <row> - <entry>emblem-readonly</entry> - <entry> -The icon used as an emblem for files and directories which can -not be written to by the user. - </entry> - </row> - <row> - <entry>emblem-shared</entry> - <entry> -The icon used as an emblem for files and directories that are -shared to other users. - </entry> - </row> - <row> - <entry>emblem-symbolic-link</entry> - <entry> -The icon used as an emblem for files and direcotires that are -links to other files or directories on the filesystem. - </entry> - </row> - <row> - <entry>emblem-synchronized</entry> - <entry> -The icon used as an emblem for files or directories that are -configured to be synchronized to another device. - </entry> - </row> - <row> - <entry>emblem-system</entry> - <entry> -The icon used as an emblem for directories that contain system -libraries, settings, and data. - </entry> - </row> - <row> - <entry>emblem-unreadable</entry> - <entry> -The icon used as an emblem for files and directories that are inaccessible. - </entry> - </row> - </tbody> - </tgroup> - </table> - - <table id="emotes"> - <title>Standard Emotion Icons</title> - <tgroup cols="2"> - <thead> - <row> - <entry>Name</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>face-angel</entry> - <entry> -The icon used for the 0:-) emote. - </entry> - </row> - <row> - <entry>face-angry</entry> - <entry> -The icon used for the X-( emote. - </entry> - </row> - <row> - <entry>face-cool</entry> - <entry> -The icon used for the B-) emote. - </entry> - </row> - <row> - <entry>face-crying</entry> - <entry> -The icon used for the :'( emote. - </entry> - </row> - <row> - <entry>face-devilish</entry> - <entry> -The icon used for the >:-) emote. - </entry> - </row> - <row> - <entry>face-embarrassed</entry> - <entry> -The icon used for the :-[ emote. - </entry> - </row> - <row> - <entry>face-kiss</entry> - <entry> -The icon used for the :-* emote. - </entry> - </row> - <row> - <entry>face-laugh</entry> - <entry> -The icon used for the :-)) emote. - </entry> - </row> - <row> - <entry>face-monkey</entry> - <entry> -The icon used for the :-(|) emote. - </entry> - </row> - <row> - <entry>face-plain</entry> - <entry> -The icon used for the :-| emote. - </entry> - </row> - <row> - <entry>face-raspberry</entry> - <entry> -The icon used for the :-P emote. - </entry> - </row> - <row> - <entry>face-sad</entry> - <entry> -The icon used for the :-( emote. - </entry> - </row> - <row> - <entry>face-sick</entry> - <entry> -The icon used for the :-& emote. - </entry> - </row> - <row> - <entry>face-smile</entry> - <entry> -The icon used for the :-) emote. - </entry> - </row> - <row> - <entry>face-smile-big</entry> - <entry> -The icon used for the :-D emote. - </entry> - </row> - <row> - <entry>face-smirk</entry> - <entry> -The icon used for the :-! emote. - </entry> - </row> - <row> - <entry>face-surprise</entry> - <entry> -The icon used for the :-0 emote. - </entry> - </row> - <row> - <entry>face-tired</entry> - <entry> -The icon used for the |-) emote. - </entry> - </row> - <row> - <entry>face-uncertain</entry> - <entry> -The icon used for the :-/ emote. - </entry> - </row> - <row> - <entry>face-wink</entry> - <entry> -The icon used for the ;-) emote. - </entry> - </row> - <row> - <entry>face-worried</entry> - <entry> -The icon used for the :-S emote. - </entry> - </row> - </tbody> - </tgroup> - </table> - - <table id="intl"> - <title>Standard International Icons</title> - <tgroup cols="2"> - <thead> - <row> - <entry>Name</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>flag-aa</entry> - <entry> -The flag for the country with the ISO 3166 country code AA. All -flags should use ISO 3166 two-letter country codes, in lowercase -form, as the specifier for the country. - </entry> - </row> - </tbody> - </tgroup> - </table> - - <table id="mimetypes"> - <title>Standard MIME Type Icons</title> - <tgroup cols="2"> - <thead> - <row> - <entry>Name</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>application-x-executable</entry> - <entry> -The icon used for executable file types. - </entry> - </row> - <row> - <entry>audio-x-generic</entry> - <entry> -The icon used for generic audio file types. - </entry> - </row> - <row> - <entry>font-x-generic</entry> - <entry> -The icon used for generic font file types. - </entry> - </row> - <row> - <entry>image-x-generic</entry> - <entry> -The icon used for generic image file types. - </entry> - </row> - <row> - <entry>package-x-generic</entry> - <entry> -The icon used for generic package file types. - </entry> - </row> - <row> - <entry>text-html</entry> - <entry> -The icon used for HTML text file types. - </entry> - </row> - <row> - <entry>text-x-generic</entry> - <entry> -The icon used for generic text file types. - </entry> - </row> - <row> - <entry>text-x-generic-template</entry> - <entry> -The icon used for generic text templates. - </entry> - </row> - <row> - <entry>text-x-script</entry> - <entry> -The icon used for script file types, such as shell scripts. - </entry> - </row> - <row> - <entry>video-x-generic</entry> - <entry> -The icon used for generic video file types. - </entry> - </row> - <row> - <entry>x-office-address-book</entry> - <entry> -The icon used for generic address book file types. - </entry> - </row> - <row> - <entry>x-office-calendar</entry> - <entry> -The icon used for generic calendar file types. - </entry> - </row> - <row> - <entry>x-office-document</entry> - <entry> -The icon used for generic document and letter file types. - </entry> - </row> - <row> - <entry>x-office-presentation</entry> - <entry> -The icon used for generic presentation file types. - </entry> - </row> - <row> - <entry>x-office-spreadsheet</entry> - <entry> -The icon used for generic spreadsheet file types. - </entry> - </row> - </tbody> - </tgroup> - </table> - - <table id="places"> - <title>Standard Place Icons</title> - <tgroup cols="2"> - <thead> - <row> - <entry>Name</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>folder</entry> - <entry> -The standard folder icon used to represent directories on local -filesystems, mail folders, and other hierarchical groups. - </entry> - </row> - <row> - <entry>folder-remote</entry> - <entry> -The icon used for normal directories on a remote filesystem. - </entry> - </row> - <row> - <entry>network-server</entry> - <entry> -The icon used for individual host machines under the -<quote>Network Servers</quote> place in the file manager. - </entry> - </row> - <row> - <entry>network-workgroup</entry> - <entry> -The icon for the <quote>Network Servers</quote> place in the -desktop's file manager, and workgroups within the network. - </entry> - </row> - <row> - <entry>start-here</entry> - <entry> -The icon used by the desktop's main menu for accessing places, -applications, and other features. - </entry> - </row> - <row> - <entry>user-desktop</entry> - <entry> -The icon for the special <quote>Desktop</quote> directory of the user. - </entry> - </row> - <row> - <entry>user-home</entry> - <entry> -The icon for the special <quote>Home</quote> directory of the user. - </entry> - </row> - <row> - <entry>user-trash</entry> - <entry> -The icon for the user's <quote>Trash</quote> place in the -desktop's file manager. - </entry> - </row> - </tbody> - </tgroup> - </table> - - <table id="status"> - <title>Standard Status Icons</title> - <tgroup cols="2"> - <thead> - <row> - <entry>Name</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>appointment-missed</entry> - <entry> -The icon used when an appointment was missed. - </entry> - </row> - <row> - <entry>appointment-soon</entry> - <entry> -The icon used when an appointment will occur soon. - </entry> - </row> - <row> - <entry>audio-volume-high</entry> - <entry> -The icon used to indicate high audio volume. - </entry> - </row> - <row> - <entry>audio-volume-low</entry> - <entry> -The icon used to indicate low audio volume. - </entry> - </row> - <row> - <entry>audio-volume-medium</entry> - <entry> -The icon used to indicate medium audio volume. - </entry> - </row> - <row> - <entry>audio-volume-muted</entry> - <entry> -The icon used to indicate the muted state for audio playback. - </entry> - </row> - <row> - <entry>battery-caution</entry> - <entry> -The icon used when the battery is below 40%. - </entry> - </row> - <row> - <entry>battery-low</entry> - <entry> -The icon used when the battery is below 20%. - </entry> - </row> - <row> - <entry>dialog-error</entry> - <entry> -The icon used when a dialog is opened to explain an error -condition to the user. - </entry> - </row> - <row> - <entry>dialog-information</entry> - <entry> -The icon used when a dialog is opened to give information -to the user that may be pertinent to the requested action. - </entry> - </row> - <row> - <entry>dialog-password</entry> - <entry> -The icon used when a dialog requesting the authentication -credentials for a user is opened. - </entry> - </row> - <row> - <entry>dialog-question</entry> - <entry> -The icon used when a dialog is opened to ask a simple - question of the user. - </entry> - </row> - <row> - <entry>dialog-warning</entry> - <entry> -The icon used when a dialog is opened to warn the user of -impending issues with the requested action. - </entry> - </row> - <row> - <entry>folder-drag-accept</entry> - <entry> -The icon used for a folder while an object is being -dragged onto it, that is of a type that the directory can contain. - </entry> - </row> - <row> - <entry>folder-open</entry> - <entry> -The icon used for folders, while their contents are being -displayed within the same window. This icon would normally be -shown in a tree or list view, next to the main view of a folder's contents. - </entry> - </row> - <row> - <entry>folder-visiting</entry> - <entry> -The icon used for folders, while their contents are being -displayed in another window. This icon would typically be used -when using multiple windows to navigate the hierarchy, such as -in Nautilus's spatial mode. - </entry> - </row> - <row> - <entry>image-loading</entry> - <entry> -The icon used when another image is being loaded, such as -thumnails for larger images in the file manager. - </entry> - </row> - <row> - <entry>image-missing</entry> - <entry> -The icon used when another image could not be loaded. - </entry> - </row> - <row> - <entry>mail-attachment</entry> - <entry> -The icon used for an electronic mail that contains attachments. - </entry> - </row> - <row> - <entry>mail-unread</entry> - <entry> -The icon used for an electronic mail that is unread. - </entry> - </row> - <row> - <entry>mail-read</entry> - <entry> -The icon used for an electronic mail that is read. - </entry> - </row> - <row> - <entry>mail-replied</entry> - <entry> -The icon used for an electronic mail that has been replied to. - </entry> - </row> - <row> - <entry>mail-signed</entry> - <entry> -The icon used for an electronic mail that contains a signature. - </entry> - </row> - <row> - <entry>mail-signed-verified</entry> - <entry> -The icon used for an electronic mail that contains a signature -which has also been verified by the security system. - </entry> - </row> - <row> - <entry>media-playlist-repeat</entry> - <entry> -The icon for the repeat mode of a media player. - </entry> - </row> - <row> - <entry>media-playlist-shuffle</entry> - <entry> -The icon for the shuffle mode of a media player. - </entry> - </row> - <row> - <entry>network-error</entry> - <entry> -The icon used when an error occurs trying to intialize the network connection -of the computing device. This icon should be two computers, one in the -background, with the screens of both computers, colored black, and with the -theme's style element for errors, overlayed on top of the icon. - </entry> - </row> - <row> - <entry>network-idle</entry> - <entry> -The icon used when no data is being transmitted or received, while the -computing device is connected to a network. This icon should be two computers, -one in the background, with the screens of both computers, colored black. - </entry> - </row> - <row> - <entry>network-offline</entry> - <entry> -The icon used when the computing device is disconnected from the network. This -icon should be a computer in the background, with a screen colored black, and -the theme's icon element to show that a device is not accessible, in the -foreground. - </entry> - </row> - <row> - <entry>network-receive</entry> - <entry> -The icon used when data is being received, while the computing device is -connected to a network. This icon should be two computers, one in the -background, with its screen colored green, and the screen of the computer in -the foreground, colored black. - </entry> - </row> - <row> - <entry>network-transmit</entry> - <entry> -The icon used when data is being transmitted, while the computing device is -connected to a network. This icon should be two computers, one in the -background, with its screen colored black, and the screen of the computer in -the foreground, colored green. - - </entry> - </row> - <row> - <entry>network-transmit-receive</entry> - <entry> -The icon used data is being both transmitted and received simultaneously, -while the computing device is connected to a network. This icon should be two -computers, one in the background, with the screens of both computers, colored -green. - </entry> - </row> - <row> - <entry>printer-error</entry> - <entry> -The icon used when an error occurs while attempting to print. This icon should -be the theme's printer device icon, with the theme's style element for errors, -overlayed on top of the icon. - </entry> - </row> - <row> - <entry>printer-printing</entry> - <entry> -The icon used while a print job is successfully being spooled to a printing -device. This icon should be the theme's printer device icon, with a document -emerging from the printing device. - </entry> - </row> - <row> - <entry>security-high</entry> - <entry> -The icon used to indicate that the security level of a connection is known -to be secure, using strong encryption and a valid certificate. - </entry> - </row> - <row> - <entry>security-medium</entry> - <entry> -The icon used to indicate that the security level of a connection is presumed -to be secure, using strong encryption, and a certificate that could not be -automatically verified, but which the user has chosen to trust. - </entry> - </row> - <row> - <entry>security-low</entry> - <entry> -The icon used to indicate that the security level of a connection is presumed -to be insecure, either by using weak encryption, or by using a certificate that -the could not be automatically verified, and which the user has not chosent to -trust. - </entry> - </row> - <row> - <entry>software-update-available</entry> - <entry> -The icon used when an update is available for software installed -on the computing device, through the system software update program. - </entry> - </row> - <row> - <entry>software-update-urgent</entry> - <entry> -The icon used when an urgent update is available through the -system software update program. - </entry> - </row> - <row> - <entry>sync-error</entry> - <entry> -The icon used when an error occurs while attempting to -synchronize data from the computing device, to another device. - </entry> - </row> - <row> - <entry>sync-synchronizing</entry> - <entry> -The icon used while data is successfully synchronizing to another device. - </entry> - </row> - <row> - <entry>task-due</entry> - <entry> -The icon used when a task is due soon. - </entry> - </row> - <row> - <entry>task-past-due</entry> - <entry> -The icon used when a task that was due, has been left incomplete. - </entry> - </row> - <row> - <entry>user-away</entry> - <entry> -The icon used when a user on a chat network is away from their -keyboard and the chat program. - </entry> - </row> - <row> - <entry>user-idle</entry> - <entry> -The icon used when a user on a chat network has not been an -active participant in any chats on the network, for an extended period of time. - </entry> - </row> - <row> - <entry>user-offline</entry> - <entry> -The icon used when a user on a chat network is not available. - </entry> - </row> - <row> - <entry>user-online</entry> - <entry> -The icon used when a user on a chat network is available to -initiate a conversation with. - </entry> - </row> - <row> - <entry>user-trash-full</entry> - <entry> -The icon for the user's <quote>Trash</quote> in the desktop's -file manager, when there are items in the <quote>Trash</quote> -waiting for disposal or recovery. - </entry> - </row> - <row> - <entry>weather-clear</entry> - <entry> -The icon used while the weather for a region is <quote>clear skies</quote>. - </entry> - </row> - <row> - <entry>weather-clear-night</entry> - <entry> -The icon used while the weather for a region is <quote>clear skies</quote> -during the night. - </entry> - </row> - <row> - <entry>weather-few-clouds</entry> - <entry> -The icon used while the weather for a region is <quote>partly cloudy</quote>. - </entry> - </row> - <row> - <entry>weather-few-clouds-night</entry> - <entry> -The icon used while the weather for a region is <quote>partly cloudy</quote> -during the night. - </entry> - </row> - <row> - <entry>weather-fog</entry> - <entry> -The icon used while the weather for a region is <quote>foggy</quote>. - </entry> - </row> - <row> - <entry>weather-overcast</entry> - <entry> -The icon used while the weather for a region is <quote>overcast</quote>. - </entry> - </row> - <row> - <entry>weather-severe-alert</entry> - <entry> -The icon used while a sever weather alert is in effect for a region. - </entry> - </row> - <row> - <entry>weather-showers</entry> - <entry> -The icon used while rain showers are occurring in a region. - </entry> - </row> - <row> - <entry>weather-showers-scattered</entry> - <entry> -The icon used while scattered rain showers are occurring in a region. - </entry> - </row> - <row> - <entry>weather-snow</entry> - <entry> -The icon used while snow showers are occurring in a region. - </entry> - </row> - <row> - <entry>weather-storm</entry> - <entry> -The icon used while storms are occurring in a region. - </entry> - </row> - </tbody> - </tgroup> - </table> - - </sect1> - - <appendix id="changelog"> - <title>Change History</title> - <formalpara> - <title>Version 0.8, 1 August 2006, Rodney Dawes</title> - <para> - <itemizedlist> - <listitem> - <para>Add "view-restore" and "utilities-system-monitor"</para> - </listitem> - <listitem> - <para>Add "folder-new" and "mail-send"</para> - </listitem> - <listitem> - <para>Add "object-flip-horizontal" and "object-flip-vertical"</para> - </listitem> - <listitem> - <para>Add "object-rotate-left" and "object-rotate-right"</para> - </listitem> - <listitem> - <para>Add "applications-engineering" and "applications-science"</para> - </listitem> - <listitem> - <para>Remove duplicate "preferences-desktop-accessibility"</para> - </listitem> - <listitem> - <para>Rename "drive-cdrom" to "drive-optical"</para> - </listitem> - <listitem> - <para>Rename "media-cdrom" to "media-optical"</para> - </listitem> - <listitem> - <para>Add "media-flash", "media-tape", and "modem"</para> - </listitem> - <listitem> - <para>Add "security-high", "security-medium", and "security-low"</para> - </listitem> - </itemizedlist> - </para> - </formalpara> - <formalpara> - <title>Version 0.7, 15 February 2006, Rodney Dawes</title> - <para> - <itemizedlist> - <listitem> - <para>Remove the wallpaper-* icon names</para> - </listitem> - <listitem> - <para>Align text blocks to the left</para> - </listitem> - <listitem> - <para>Add "weather-few-clouds-night" and "weather-clear-night" to -the status context</para> - </listitem> - <listitem> - <para>Remove "network-online" from the status context</para> - </listitem> - <listitem> - <para>Add "network-idle", "network-receive", "network-transmit", -and "network-transmit-receive" to the status context</para> - </listitem> - <listitem> - <para>Update the printer status icon definitions</para> - </listitem> - </itemizedlist> - </para> - </formalpara> - <formalpara> - <title>Version 0.6, 07 December 2005, Rodney Dawes</title> - <para> - <itemizedlist> - <listitem> - <para> - Add the "Animations" and "Places" contexts - </para> - </listitem> - <listitem> - <para> - Add "media-eject" to the actions context - </para> - </listitem> - <listitem> - <para> - Move "media-playlist-shuffle" to the status context - </para> - </listitem> - <listitem> - <para> - Add the "process-working" animation to the animations context - </para> - </listitem> - <listitem> - <para> - Add "battery", "camera-photo", "media-floppy", "multimedia-player", - "network-wired", and "network-wireless" to the devices context - </para> - </listitem> - <listitem> - <para> - Remove the printer-remote and video-card icons from devices - </para> - </listitem> - <listitem> - <para> - Rename "emblem-favorites" to "emblem-favorite" - </para> - </listitem> - <listitem> - <para> - Add "application-x-executable", "package-x-generic", - "text-x-generic-template", and "text-x-script" to the - mimetypes context - </para> - </listitem> - <listitem> - <para> - Rename "x-directory-normal" to "folder" and move it to the - places context - </para> - </listitem> - <listitem> - <para> - Rename "x-directory-remote" to "folder-remote" and move it to the - places context - </para> - </listitem> - <listitem> - <para> - Rename "x-directory-normal-remote-server" to "network-server" - and move it to the places context - </para> - </listitem> - <listitem> - <para> - Rename "x-directory-normal-remote-workgroup" to - "network-workgroup" and move it to the places context - </para> - </listitem> - <listitem> - <para> - Rename "x-directory-trash" to "user-trash" - and move it to the places context - </para> - </listitem> - <listitem> - <para> - Rename "x-directory-trash-full" to "user-trash-full" and move - it to the status context - </para> - </listitem> - <listitem> - <para> - Add "start-here", "user-desktop", and "user-home" to the places - context - </para> - </listitem> - <listitem> - <para> - Add "folder-drag-accept", "folder-open", "folder-visiting", and - "media-playlist-repeat" to the status context - </para> - </listitem> - </itemizedlist> - </para> - </formalpara> - <formalpara> - <title>Version 0.4, 10 October 2005, Rodney Dawes</title> - <para> - <itemizedlist> - <listitem> - <para> - Use "The icon" instead of "This icon" for "contact-new" and - "battery-low" - </para> - </listitem> - <listitem> - <para> - Add icons for "preferences-desktop-accessibility" and - "preferences-desktop-font" in the apps context - </para> - </listitem> - <listitem> - <para> - Fix typo in "drive-cdrom" name - </para> - </listitem> - <listitem> - <para> - Rename "x-font-generic" to "font-x-generic" to match other MIME - type icons such as for audio, images, and video - </para> - </listitem> - <listitem> - <para> - Add icons for "image-loading" and "image-missing" to status - </para> - </listitem> - </itemizedlist> - </para> - </formalpara> - <formalpara> - <title>Version 0.3, 28 June 2005, Rodney Dawes</title> - <para> - <itemizedlist> - <listitem> - <para> - Replace "printer-local" with "printer" to be more generic. - </para> - </listitem> - <listitem> - <para> - Import into freedesktop.org cvs alongside icon-theme-spec.xml - </para> - </listitem> - <listitem> - <para> - Add missing icon descriptions. - </para> - </listitem> - </itemizedlist> - </para> - </formalpara> - <formalpara> - <title>Version 0.2, 01 April 2005, Jakub Steiner</title> - <para> - <itemizedlist> - <listitem> - <para> - Fixed two small typographical errors. - </para> - </listitem> - </itemizedlist> - </para> - </formalpara> - <formalpara> - <title>Version 0.1, 29 March 2005, Rodney Dawes</title> - <para> - <itemizedlist> - <listitem> - <para> - Created initial draft. - </para> - </listitem> - </itemizedlist> - </para> - </formalpara> - </appendix> -</article> diff --git a/spec/icon-theme-spec.xml b/spec/icon-theme-spec.xml deleted file mode 100644 index 7554b0f..0000000 --- a/spec/icon-theme-spec.xml +++ /dev/null @@ -1,986 +0,0 @@ -<?xml version="1.0"?> -<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" -"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ -]> -<article id="index"> - <articleinfo> - <title>Icon Theme Specification</title> - <releaseinfo>Version 0.11</releaseinfo> - <date>February 7 2006</date> - <authorgroup> - <author> - <firstname>Alexander</firstname> - <surname>Larsson</surname> - <affiliation> - <address> - <email>alexl@redhat.com</email> - </address> - </affiliation> - </author> - <author> - <firstname>Frans</firstname> - <surname>Englich</surname> - <affiliation> - <address> - <email>frans.englich@telia.com</email> - </address> - </affiliation> - </author> - </authorgroup> - </articleinfo> - - <sect1 id="overview"> - <title>Overview</title> - <para> - An icon theme is a set of icons that share a common look and - feel. The user can then select the icon theme that they want to - use, and all apps use icons from the theme. The initial user of - icon themes is the icon field of the desktop file specification, - but in the future it can have other uses (such as mimetype - icons). - </para> - <para> - From a programmer perspective an icon theme is just a - mapping. Given a set of directories to look for icons in and a theme - name it maps from icon name and nominal icon size to an icon filename. - </para> - </sect1> - - <sect1 id="definitions"> - <title>Definitions</title> - <variablelist> - <varlistentry> - <term>Icon Theme</term> - <listitem> - <para> - An icon theme is a named set of icons. It is used to map - from an iconname and size to a file. Themes may inherit - from other themes as a way to extend them. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Icon file</term> - <listitem> - <para> - An icon file is an image that can be loaded and used as an - icon. The supported image file formats are PNG, XPM and SVG. - PNG is the recommended bitmap format, and SVG is for - vectorized icons. XPM is supported due to backwards - compability reasons, and it is not recommended that new - themes use XPM files. Support for SVGs is optional. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Base Directory</term> - <listitem> - <para> - Icons and themes are searched for in a set of directories, - called base directories. The themes are stored in - subdirectories of the base directories. - </para> - </listitem> - </varlistentry> - </variablelist> - </sect1> - - <sect1 id="directory_layout"> - <title>Directory Layout</title> - <para> - Icons and themes are looked for in a set of directories. By - default, apps should look in $HOME/.icons (for backwards compatibility), - in $XDG_DATA_DIRS/icons and in /usr/share/pixmaps (in that order). - Applications may further add - their own icon directories to this list, and users may extend or - change the list (in application/desktop specific ways).In each of - these directories themes are stored as subdirectories. A theme can - be spread across several base directories by having subdirectories of - the same name. This way users can extend and override system - themes. - </para> - <para> - In order to have a place for third party applications to install - their icons there should always exist a theme called "hicolor" - <footnote><para>This name is chosen for backwards compatibility with the old - KDE default theme</para></footnote>. - The data for the hicolor theme is available for download at: - http://www.freedesktop.org/software/icon-theme/. - Implementations are required to look in the "hicolor" theme if - an icon was not found in the current theme. - </para> - <para> - Each theme is stored as subdirectories of the base - directories. The internal name of the theme is the name of the - subdirectory, although the user-visible name as specified by the - theme may be different. Hence, theme names are case sensitive, and - are limited to ASCII characters. Theme names may also not contain - comma or space. - </para> - <para> - In at least one of the theme directories there must be a file - called index.theme that describes the theme. The first index.theme - found while searching the base directories in order is used. This - file describes the general attributes of the theme. - </para> - <para> - In the theme directory are also a set of subdirectories containing - image files. Each directory contains icons designed for a certain - nominal icon size, as described by the index.theme file. The - subdirectories are allowed to be several levels deep, e.g. the - subdirectory "48x48/apps" in the theme "hicolor" would end up at - $basedir/hicolor/48x48/apps. - </para> - <para> - The image files must be one of the types: PNG, XPM, or SVG, and - the extension must be ".png", ".xpm", or ".svg" (lower case). The - support for SVG files is optional. Implementations that do not - support SVGs should just ignore any ".svg" files. In - addition to this there may be an additional file with extra - icon-data for each file. It should have the same basename as the - image file, with the extension ".icon". e.g. if the icon file is - called "mime_source_c.png" the corresponding file would be named - "mime_source_c.icon". - </para> - </sect1> - - <sect1 id="file_formats"> - <title>File Formats</title> - <para> - Both the icon theme description file and the icon data files are - ini-style text files, as described in the desktop file - specification. They don't have any encoding field. Instead, they - must always be stored in UTF-8 encoding. - </para> - <para> - The index.theme file must start with a section called <citetitle>Icon - Theme</citetitle>, with contents according to table 1 below. All lists are - comma-separated. - <table> - <title>Standard Keys</title> - <tgroup cols="4"> - <thead> - <row> - <entry>Key</entry> - <entry>Description</entry> - <entry>Value Type</entry> - <entry>Required</entry> - </row> - </thead> - <tbody> - <row> - <entry>Name</entry> - <entry> - short name of the icon theme, used in e.g. lists when - selecting themes. - </entry> - <entry>localestring</entry> - <entry>YES</entry> - </row> - <row> - <entry>Comment</entry> - <entry> - longer string describing the theme - </entry> - <entry>localestring</entry> - <entry>YES</entry> - </row> - <row> - <entry>Inherits</entry> - <entry> - <para> - The name of the theme that this theme inherits from. If an icon - name is not found in the current theme, it is searched for in the - inherited theme (and recursively in all the inherited themes). - </para> - <para> - If no theme is specified implementations are required to add - the "hicolor" theme to the inheritance tree. An implementation - may optionally add other default themes in between the last - specified theme and the hicolor theme. - </para> - </entry> - <entry>strings</entry> - <entry>NO</entry> - </row> - <row> - <entry>Directories</entry> - <entry> - list of subdirectories for this theme. For every - subdirectory there must be a section in the index.theme - file describing that directory. - </entry> - <entry>strings</entry> - <entry>YES</entry> - </row> - <row> - <entry>Hidden</entry> - <entry> - Whether to hide the theme in a theme selection user interface. - This is used for things such as fallback-themes that are not supposed - to be visible to the user. - </entry> - <entry>boolean</entry> - <entry>NO</entry> - </row> - <row> - <entry>Example</entry> - <entry> - The name of an icon that should be used as an example of - how this theme looks. - </entry> - <entry>string</entry> - <entry>NO</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - <para> - Each directory specified in the Directory key has a corresponding section - with the same name as the directory. The contents of this section is - listed in table 2 below. - <table> - <title>Per-Directory Keys</title> - <tgroup cols="4"> - <thead> - <row> - <entry>Key</entry> - <entry>Description</entry> - <entry>Value Type</entry> - <entry>Required</entry> - <entry>Type</entry> - </row> - </thead> - <tbody> - <row> - <entry>Size</entry> - <entry> - Nominal size of the icons in this directory. - </entry> - <entry>integer</entry> - <entry>YES</entry> - </row> - <row> - <entry>Context</entry> - <entry> - The context the icon is normally used in. This - is in detail discussed in <xref linkend="context"/>. - </entry> - <entry>string</entry> - <entry>NO</entry> - </row> - <row> - <entry>Type</entry> - <entry> - The type of icon sizes for the icons in this - directory. Valid types are Fixed, Scalable and - Threshold. The type decides what other keys in the - section are used. If not specified, the default is - Threshold. - </entry> - <entry>string</entry> - <entry>NO</entry> - </row> - <row> - <entry>MaxSize</entry> - <entry> - Specifies the maximum size that the icons in this - directory can be scaled to. Defaults to the value - of Size if not present. - </entry> - <entry>integer</entry> - <entry>NO</entry> - <entry>Scalable</entry> - </row> - <row> - <entry>MinSize</entry> - <entry> - Specifies the minimum size that the icons in this - directory can be scaled to. Defaults to the value - of Size if not present. - </entry> - <entry>integer</entry> - <entry>NO</entry> - <entry>Scalable</entry> - </row> - <row> - <entry>Threshold</entry> - <entry> - The icons in this directory can be used if the size differ - at most this much from the desired size. Defaults to 2 if not - present. - </entry> - <entry>integer</entry> - <entry>NO</entry> - <entry>Threshold</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - <para> - In addition to these groups you may add extra groups to the - index.theme file in order to extend it. These extensions must - begin with "X-", and can be used to add desktop specific - information to the theme file. Example group names would be "X-KDE - Icon Theme" or "X-Gnome Icon Theme". - </para> - <para> - The optional filename.icon file contains a group called "Icon - Data", with the content listed in table 3. - <table> - <title>Icon Data Keys</title> - <tgroup cols="4"> - <thead> - <row> - <entry>Key</entry> - <entry>Description</entry> - <entry>Value Type</entry> - <entry>Required</entry> - </row> - </thead> - <tbody> - <row> - <entry>DisplayName</entry> - <entry> - A translated UTF8 string that can be used instead of the - icon name when the icon is listen in e.g. a user interface. - </entry> - <entry>localestring</entry> - <entry>NO</entry> - </row> - <row> - <entry>EmbeddedTextRectangle</entry> - <entry> - If this exists, it specifies the four corners of a - rectangle where the program displaying the icon can - embed text. This is normally used by e.g. file managers - that want to display a preview of text file contents in - the icon. The corners are specified by a list of four - values: x0,y0,x1,y1. The values are pixel coordinates - from the top left corner of the icon, except for SVG - files, where they are specified in a 1000x1000 - coordinate space that is scaled to the final rendered - size of the icon. - </entry> - <entry>integers</entry> - <entry>NO</entry> - </row> - <row> - <entry>AttachPoints</entry> - <entry> - A list of points, separated by "|" that may be used as - anchor points for emblems/overlays. The points are pixel - coordinates from the top left corner of the icon, except - for SVG files, where they are specified in a 1000x1000 - coordinate space that is scaled to the final rendered - size of the icon. - </entry> - <entry>points</entry> - <entry>NO</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - <para> - Extensions to the filename.icon file are allowed, but the - keys must be begin with "X-" to avoid collisions with future - standardized extensions to this format. - </para> - - <sect2 id="context"> - <title>Context</title> - - <para>The <systemitem>Context</systemitem> allows - the designer to group icons on a conceptual level. - It doesn't act as a namespace in the file system, such - that icons can have identical names, but allows - implementations to categorize and sort by it, for example. - </para> - - <para>These are the available contexts:</para> - <itemizedlist> - - <listitem> - <formalpara> - <title>Actions</title> - <para>Icons representing actions which the user initiates, such as <action>Save As</action>.</para> - </formalpara> - </listitem> - - <listitem> - <formalpara> - <title>Devices</title> - <para>Icons representing real world devices, - such as printers and mice. It's not for - file system nodes such as character or block devices.</para> - </formalpara> - </listitem> - - <listitem> - <formalpara> - <title>FileSystems</title> - <para>Icons for objects which are represented as - part of the file system. This is for example, - the local network, <quote>Home</quote>, - and <quote>Desktop</quote> folders.</para> - </formalpara> - </listitem> - - <listitem> - <formalpara> - <title>MimeTypes</title> - <para>Icons representing MIME types.</para> - </formalpara> - </listitem> - - </itemizedlist> - - </sect2> - </sect1> - - <sect1 id="icon_lookup"> - <title>Icon Lookup</title> - <para> - The icon lookup mechanism has two global settings, the list of - base directories and the internal name of the current theme. Given - these we need to specify how to look up an icon file from the icon - name and the nominal size. - </para> - <para> - The lookup is done first in the current theme, and then - recursively in each of the current theme's parents, and - finally in the default theme called "hicolor" (implementations may - add more default themes before "hicolor", but "hicolor" must be - last). As soon as there is an icon of any size that matches in a - theme, the search is stopped. Even if there may be an icon with a - size closer to the correct one in an inherited theme, we don't want - to use it. Doing so may generate an inconsistant change in an icon - when you change icon sizes (e.g. zoom in). - </para> - <para> - The lookup inside a theme is done in three phases. First all the - directories are scanned for an exact match, e.g. one where the - allowed size of the icon files match what was looked up. Then all - the directories are scanned for any icon that matches the name. If - that fails we finally fall back on unthemed icons. If we fail to - find any icon at all it is up to the application to pick a good - fallback, as the correct choice depends on the context. - </para> - <para> - The exact algorithm (in pseudocode) for looking up an icon in a theme - (if the implementation supports SVG) is: - <programlisting> -FindIcon(icon, size) { - filename = FindIconHelper(icon, size, user selected theme); - if filename != none - return filename - - filename = FindIconHelper(icon, size, "hicolor"); - if filename != none - return filename - - return LookupFallbackIcon (icon) -} -FindIconHelper(icon, size, theme) { - filename = LookupIcon (icon, size, theme) - if filename != none - return filename - - if theme has parents - parents = theme.parents - - for parent in parents { - filename = FindIconHelper (icon, size, parent) - if filename != none - return filename - } - return none -} - </programlisting> - With the following helper functions: - <programlisting> -LookupIcon (iconname, size, theme) { - for each subdir in $(theme subdir list) { - for each directory in $(basename list) { - for extension in ("png", "svg", "xpm") { - if DirectoryMatchesSize(subdir, size) { - filename = directory/$(themename)/subdir/iconname.extension - if exist filename - return filename - } - } - } - } - minimal_size = MAXINT - for each subdir in $(theme subdir list) { - for each directory in $(basename list) { - for extension in ("png", "svg", "xpm") { - filename = directory/$(themename)/subdir/iconname.extension - if exist filename and DirectorySizeDistance(subdir, size) < minimal_size { - closest_filename = filename - minimal_size = DirectorySizeDistance(subdir, size) - } - } - } - } - if closest_filename set - return closest_filename - return none -} - -LookupFallbackIcon (iconname) { - for each directory in $(basename list) { - for extension in ("png", "svg", "xpm") { - if exists directory/iconname.extension - return directory/iconname.extension - } - } - return none -} - -DirectoryMatchesSize(subdir, iconsize) { - read Type and size data from subdir - if Type is Fixed - return Size == iconsize - if Type is Scaled - return MinSize <= iconsize <= MaxSize - if Type is Threshold - return Size - Threshold <= iconsize <= Size + Threshold -} - -DirectorySizeDistance(subdir, size) { - read Type and size data from subdir - if Type is Fixed - return abs(Size - iconsize) - if Type is Scaled - if iconsize < MinSize - return MinSize - iconsize - if iconsize > MaxSize - return iconsize - MaxSize - return 0 - if Type is Threshold - if iconsize < Size - Threshold - return MinSize - iconsize - if iconsize > Size + Threshold - return iconsize - MaxSize - return 0 -} -</programlisting> - </para> - <para> - In some cases you don't always want to fall back to an icon in an - inherited theme. For instance, sometimes you look for a set of - icons, prefering any of them before using an icon from an inherited - theme. To support such operations implementations can contain a - function that finds the first of a list of icon names in the inheritance - hierarchy. I.E. It would look something like this: -<programlisting> -FindBestIcon(iconList, size) { - filename = FindBestIconHelper(iconList, size, user selected theme); - if filename != none - return filename - - filename = FindBestIconHelper(iconList, size, "hicolor"); - if filename != none - return filename - - for icon in iconList { - filename = LookupFallbackIcon (icon) - if filename != none - return filename - } - return none; -} -FindBestIconHelper(iconList, size, theme) { - for icon in iconList { - filename = LookupIcon (icon, size, theme) - if filename != none - return filename - } - - if theme has parents - parents = theme.parents - - for parent in parents { - filename = FindBestIconHelper (iconList, size, parent) - if filename != none - return filename - } - return none -} -</programlisting> - This can be very useful for example when handling mimetype icons, where there - are more and less "specific" versions of icons. - </para> - </sect1> - - <sect1 id="example"> - <title>Example</title> - <para> - Here is an example index.theme file: - <programlisting>[Icon Theme] -Name=Birch -Name[sv]=Björk -Comment=Icon theme with a wooden look -Comment[sv]=Träinspirerat ikontema -Inherits=wood,default -Directories=48x48/apps,48x48/mimetypes,32x32/apps,scalable/apps,scalable/mimetypes - -[scalable/apps] -Size=48 -Type=Scalable -MinSize=1 -MaxSize=256 -Context=Applications - -[scalable/mimetypes] -Size=48 -Type=Scalable -MinSize=1 -MaxSize=256 -Context=MimeTypes - -[32x32/apps] -Size=32 -Type=Fixed -Context=Applications - -[48x48/apps] -Size=48 -Type=Fixed -Context=Applications - -[48x48/mimetypes] -Size=48 -Type=Fixed -Context=MimeTypes</programlisting> - The corresponding directory tree in the /usr/share/icons - directory could look like this: - <programlisting>birch/index.theme -birch/scalable/apps/mozilla.svg -birch/scalable/mimetypes/mime_text_plain.svg -birch/scalable/mimetypes/mime_text_plain.icon -birch/48x48/apps/mozilla.png -birch/32x32/apps/mozilla.png -birch/48x48/mimetypes/mime_text_plain.png -birch/48x48/mimetypes/mime_text_plain.icon</programlisting> -Where birch/scalable/mimetypes/mime_text_plain.icon contains: - <programlisting>[Icon Data] -DisplayName=Mime text/plain -EmbeddedTextRectangle=100,100,900,900 -AttachPoints=200,200|800,200|500,500|200,800|800,800</programlisting> -And birch/48x48/mimetypes/mime_text_plain.icon contains: - <programlisting>[Icon Data] -DisplayName=Mime text/plain -EmbeddedTextRectangle=8,8,40,40 -AttachPoints=20,20|40,40|50,10|10,50</programlisting> - </para> - <para> - In this example a lookup of "mozilla" would get the prerendered - 48x48 and 32x32 icons before the SVG icons due to the order of - Directories. - </para> - - </sect1> - - <sect1 id="install_icons"> - <title>Installing Application Icons</title> - <para> - So, you're an application author, and want to install application icons - so that they work in the KDE and Gnome menus. Minimally you should install - a 48x48 icon in the hicolor theme. This means installing a PNG file in - $prefix/share/icons/hicolor/48x48/apps. Optionally you can install icons in different - sizes. For example, installing a svg icon in $prefix/share/icons/hicolor/scalable/apps - means most desktops will have one icon that works for all sizes. You might even want to - install icons with a look that matches other well known themes so your application - will fit in with some specific desktop environment. - </para> - <para> - It is recommended that the icons installed in the hicolor theme look neutral, - since it is a fallback theme that will be used in combination with some very - different looking themes. But if you don't have any neutral icon, please install - whatever icon you have in the hicolor theme so that all applications get at - least some icon in all themes. - </para> - </sect1> - - <sect1 id="implementation_notes"> - <title>Implementation Notes</title> - <para> - The algorithm as described in this document works by always - looking up filenames in directories (a stat in unix - terminology). A good implementation is expected to read the - directories once, and do all lookups in memory using that - information. - </para> - <para> - This caching can make it impossible for users to add icons without - having to restart applications. In order to handle this, any - implementation that does caching is required to look at the mtime - of the toplevel icon directories when doing a cache lookup, unless - it already did so less than 5 seconds ago. This means that any - icon editor or theme installation program need only to change the - mtime of the the toplevel directory where it changed the theme to - make sure that the new icons will eventually get used. - </para> - </sect1> - - <sect1 id="background"> - <title>Background</title> - <para> - The icon theme specification is based on the original - KDE icon theme system designed by Antonio Larossa, - Geert Janssen and Torsten Rahn. The common specification - mostly adds support for .icon files, renames the icon theme - description files and removes a few references to kde in them. - </para> - </sect1> - - <appendix id="changes"> - <title>Change history</title> - <formalpara> - <title>Version 0.12, 24 December 2006, Octavio Alvarez</title> - <para> - <itemizedlist> - <listitem> - <para> - Fixed "hicolor" lookup in the pseudocode, so it works with multiple - parents. - </para> - </listitem> - </itemizedlist> - </para> - </formalpara> - <formalpara> - <title>Version 0.11, 7 February 2006, Alexander Larsson</title> - <para> - <itemizedlist> - <listitem> - <para> - Fixed icon lookup clarification to work with multiple inheritance. - </para> - </listitem> - </itemizedlist> - </para> - </formalpara> - <formalpara> - <title>Version 0.10, 7 February 2006, Alexander Larsson</title> - <para> - <itemizedlist> - <listitem> - <para> - Clarify that icon lookup looks in all parent themes before - falling back to nonthemed icons. - </para> - </listitem> - <listitem> - <para> - Added lookup function that takes a list of icon names (FindBestIcon) - </para> - </listitem> - </itemizedlist> - </para> - </formalpara> - <formalpara> - <title>Version 0.9, 4 April 2005, Alexander Larsson</title> - <para> - <itemizedlist> - <listitem> - <para> - Cleanups and fixes to language from Rodney Dawes and - Frans Englich. - </para> - </listitem> - <listitem> - <para> - Added section describing Contexts in more details (by - Frans Englich). - </para> - </listitem> - </itemizedlist> - </para> - </formalpara> - <formalpara> - <title>Version 0.8, 5 February 2004, Alexander Larsson</title> - <para> - <itemizedlist> - <listitem> - <para> - Fix language problems as pointed out by Rodney Dawes and - Michael Terry. - </para> - </listitem> - <listitem> - <para> - Added background section. - </para> - </listitem> - </itemizedlist> - </para> - </formalpara> - <formalpara> - <title>Version 0.7, 13 September 2003, Heinrich Wendel</title> - <para> - <itemizedlist> - <listitem> - <para> - Converted to basedir spec. - </para> - </listitem> - <listitem> - <para> - Changed type of MaxSize, MinSize and Threshold to integer. - </para> - </listitem> - <listitem> - <para> - Removed typo in code example. - </para> - </listitem> - <listitem> - <para> - Corrected path to default-icon-theme. - </para> - </listitem> - </itemizedlist> - </para> - </formalpara> - <formalpara> - <title>Version 0.6, 2 December 2002, Alexander Larsson</title> - <para> - <itemizedlist> - <listitem> - <para> - Added Hidden key. - </para> - </listitem> - <listitem> - <para> - Removed multiple inheritance. - </para> - </listitem> - <listitem> - <para> - Renamed the default theme hicolor. - </para> - </listitem> - <listitem> - <para> - Added the application icon install section. - </para> - </listitem> - <listitem> - <para> - Fixed some xml issues. - </para> - </listitem> - </itemizedlist> - </para> - </formalpara> - <formalpara> - <title>Version 0.5, 18 September 2002, Alexander Larsson</title> - <para> - <itemizedlist> - <listitem> - <para> - Added DisplayName to icon data. - </para> - </listitem> - <listitem> - <para> - Fixed up example svg icon data. - </para> - </listitem> - <listitem> - <para> - Fixed some spelling and grammar errors. - </para> - </listitem> - </itemizedlist> - </para> - </formalpara> - <formalpara> - <title>Version 0.4, 16 May 2002, Alexander Larsson</title> - <para> - <itemizedlist> - <listitem> - <para> - Fixed some spelling and grammar errors. - </para> - </listitem> - </itemizedlist> - </para> - </formalpara> - <formalpara> - <title>Version 0.3, 14 May 2002, Alexander Larsson</title> - <para> - <itemizedlist> - <listitem> - <para> - Made support for SVGs optional. - </para> - </listitem> - <listitem> - <para> - Added a default fallback theme. - </para> - </listitem> - <listitem> - <para> - Changed the example directory layout a bit to - match the default theme. - </para> - </listitem> - </itemizedlist> - </para> - </formalpara> - <formalpara> - <title>Version 0.2, 29 April 2002, Alexander Larsson</title> - <para> - <itemizedlist> - <listitem> - <para> - Changed search order to png, svg, xpm. - </para> - </listitem> - <listitem> - <para> - Added comment to say that xpm is supported for backwards - compat and not recommended in new themes. - </para> - </listitem> - <listitem> - <para> - Default Type for a directory is now Threshold - </para> - </listitem> - <listitem> - <para> - Added implementation notes section. - </para> - </listitem> - <listitem> - <para> - Added Example key. - </para> - </listitem> - </itemizedlist> - </para> - </formalpara> - <formalpara> - <title>Version 0.1, 22 April 2002, Alexander Larsson</title> - <para> - <itemizedlist> - <listitem> - <para> - Created initial draft. - </para> - </listitem> - </itemizedlist> - </para> - </formalpara> - </appendix> -</article> diff --git a/spec/sound-theme-spec.xml b/spec/sound-theme-spec.xml index 2a0dc02..d1a845e 100644 --- a/spec/sound-theme-spec.xml +++ b/spec/sound-theme-spec.xml @@ -246,7 +246,7 @@ <row> <entry>Context</entry> <entry> - The context the icon is normally used in. This + The context the sound is normally used in. This is in detail discussed in <xref linkend="context"/>. </entry> <entry>string</entry> @@ -312,7 +312,7 @@ <listitem> <formalpara> - <title>Alerts</title> + <title>Alert</title> <para>Sounds to alert the user of an action or event which may have a major imact on the system or their current use case, such as @@ -322,7 +322,7 @@ <listitem> <formalpara> - <title>Notifications</title> + <title>Notification</title> <para>Sounds to notify the user that the system, or their current use case has changed state in some way, e.g. new email arriving, new non-critical update available...</para> |