GUIDELINES
==========

NAMING
(Borrowed from http://standards.freedesktop.org/icon-naming-spec/latest/:)
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.

The dash "-" character is used to separate levels of specificity in icon names,
for all contexts other than MIME types. For instance, we use “input-mouse” as
the generic item for all mouse devices, and we use “input-mouse-usb” 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. (TODO: Make this more Drupal
specific.)

(Added by Ximo:)
If a Drupal path or name is used in an icon name that contains the dash "-"
character, this should be replaced with an underscore "_". For instance, the
icon for the path "admin/settings/file-system" becomes
"admin-settings-file_system".

MODULE ICONS
Module developers are encouraged to provide icons for any administration pages
provided by their modules. The icons should be named in accordance with the
standard icon names. For instance, the page "admin/settings/my-module" should
provide the icon "admin-settings-my_module".

REUSE OF ICONS
There should be as much reuse of icons as possible. E.g. the block icon for menu
could be the same icon as for admin-build-menu.

DIRECTORY LAYOUT
TODO: Write instructions for directory layout of icon sets. 16x16, 24x24, etc.


STANDARD CONTEXTS
=================

  * Administration pages
  * Actions
  * Blocks
  * User
  * Status messages
  * Emoticons
  * International
  * MIME types
  * Ungrouped


STANDARD ICON NAMES
===================

ADMINISTRATION PAGES
admin-build (an admin section)
admin-content (an admin section)
admin-reports (an admin section)
admin-settings (an admin section)
admin-user (an admin section)
admin-administer (main administration overview)
admin-build-block
admin-build-contact
admin-build-icons
admin-build-menu
admin-build-modules
admin-build-path
admin-build-themes
admin-build-translate
admin-build-trigger
admin-content-aggregator
admin-content-book
admin-content-comment
admin-content-forum
admin-content-node
admin-content-node_settings
admin-content-rss_publishing
admin-content-taxonomy
admin-content-types
admin-reports-dblog
admin-reports-hits
admin-reports-access_denied
admin-reports-page_not_found
admin-reports-referrers
admin-reports-search
admin-reports-pages
admin-reports-visitors
admin-reports-settings
admin-reports-updates
admin-reports-status
admin-settings-actions
admin-settings-admin
admin-settings-blogapi
admin-settings-clean_urls
admin-settings-date_time
admin-settings-error_reporting
admin-settings-file_system
admin-settings-uploads
admin-settings-image_toolkit
admin-settings-filters
admin-settings-language
admin-settings-logging
admin-settings-performance
admin-settings-search
admin-settings-site_information
admin-settings-site_maintenance
admin-settings-throttle
admin-*-* (modules should specify icons for any admin pages they provide)
node-add (generic "add" icon)
node-add-* ("add" icons for content types - page, story, blog, poll as defaults?)
node-delete (generic "delete" icon)
node-delete-* ("delete" icon for content types)
node-edit (generic "edit" icon)
node-edit-* ("edit" icons for content types)


ACTIONS
action-save
action-reset
action-cancel
action-delete
grip
go-bottom
go-down
go-first
go-home
go-jump
go-last
go-next
go-previous
go-top
go-up
move
sort-asc
sort-desc


BLOCKS
blog
book
comments
forum-active
forum-latest
menu (any custom menu)
menu-navigation
menu-primary_links
node-author
poll-latest
search
syndicate
user-login
user-latest
user-online


USER
user-account
user-login
user-logout
user-register


STATUS MESSAGES
message-status
message-warning
message-error


EMOTICONS
face-angel
face-crying
face-devil-grin
face-devil-sad
face-glasses
face-kiss
face-monkey
face-plain
face-sad
face-smile
face-smile-big
face-smirk
face-surprise
face-wink


INTERNATIONAL
flag-aa (ISO 3166 country code)


MIME TYPES
application-x-executable
audio-x-generic
font-x-generic
image-x-generic
package-x-generic
text-html
text-x-generic
text-x-generic-template
text-x-script
video-x-generic
x-office-address-book
x-office-calendar
x-office-document
x-office-presentation
x-office-spreadsheet


UNGROUPED
Content types:
content (generic icon for custom content types)
content-blog
content-image
content-page
content-poll
content-story

Drupal concepts:
node
page
block
user
comment
filter
module
role
theme
taxonomy

Feeds:
feed-rss
feed-xml

Forum:
forum-closed
forum-hot
forum-new
forum-sticky

Lists:
list-collapsed
list-collapsed-rtl
list-expanded
list-leaf

Other:
help
process-working
search