Projects/Oxygen/namingSpec/categories: Difference between revisions

From KDE TechBase
(Revert to my last version, incorporating JRT's findings on where icons need to be moved from.)
Line 1: Line 1:
== Specification compliance of icon names ==
== Specification compliance of icon names ==


Icon names without notes already exist in the freedesktop.org icon naming specification.
Icon names without trailing stars already exist in the freedesktop.org icon naming specification.


<pre>
<pre>
all category icons      missing


  * suggesting this for inclusion into the icon naming specification
  * suggesting this for inclusion into the icon naming specification
  ** not in the spec, but let's keep it out of there anyways,
  ** not in the spec, but let's keep it out of there anyways,
     it's not really suited to be a standard icon
     it's not really suited to be a standard icon
Line 12: Line 13:
== To do for Oxygen ==
== To do for Oxygen ==


Icons that are in the spec, but not yet in Oxygen's categories/ so they need to be added. Descriptions taken from the specification.  
Icons that are in the spec, but not yet in Oxygen's categories/ so they need to be added. Descriptions taken from the specification. (A lot of those icons already exist as package_* in apps/, they'd only need to be pulled over to here.)


<pre>  
<pre>  
  application-accessories
  application-accessories
   The icon for the "Accessories" sub-menu of the Programs menu.
   The icon for the "Accessories" sub-menu of the Programs menu.
  (Editor's note: move from apps/package-utilities.)
applications-development
  The icon for the "Programming" sub-menu of the Programs menu.
  (Editor's note: move from apps/package-development.)


  applications-engineering
  applications-engineering
Line 23: Line 29:
  applications-games
  applications-games
   The icon for the "Games" sub-menu of the Programs menu.
   The icon for the "Games" sub-menu of the Programs menu.
applications-graphics
  The icon for the "Graphics" sub-menu of the Programs menu.
  (Editor's note: move from apps/package-graphics.)
applications-internet
  The icon for the "Internet" sub-menu of the Programs menu.
  (Editor's note: move from apps/package-network.)
applications-multimedia
  The icon for the "Multimedia" sub-menu of the Programs menu.
  (Editor's note: move from apps/package-multimedia.)


  applications-office
  applications-office
Line 37: Line 55:
  applications-system
  applications-system
   The icon for the "System Tools" sub-menu of the Programs menu.
   The icon for the "System Tools" sub-menu of the Programs menu.
applications-utilities
  The icon for the "Utilities" sub-menu of the Programs menu.


  preferences-desktop
  preferences-desktop
Line 58: Line 79:
   The icon for the "Network" sub-category of the
   The icon for the "Network" sub-category of the
   "System Preferences" category.
   "System Preferences" category.
system-help
  The icon for the "Help" system category.
  (Editor's note: move from apps/khelpcenter.)
</pre>
</pre>


Line 68: Line 93:
   The icon for the "Education" sub-menu of the Programs menu.
   The icon for the "Education" sub-menu of the Programs menu.


  application
  applications-development
    link to applications-other
  [Rename "Programming" to "Development".]
 
applications-other -> applications
  The icon for applications category.


  preferences
  preferences-other -> settings
    link to preferences-other
  The icon for a generic settings category.
 
preferences-desktop -> settings-desktop
  The icon for the "Desktop" settings category.
 
preferences-system -> settings-system
  The icon for the "System Administration" settings category.
 
preferences-desktop-peripherals -> settings-peripherals
  The icon for the "Peripherals" settings category.
 
preferences-desktop-personal -> settings-personal
  The icon for the "Personal" settings category.
 
preferences-system-network -> settings-network
  The icon for the "Network" settings category.
</pre>
</pre>


"other" implies that the icon should be a generic one, and indeed applications-other and preferences-other make for a good fallback if there are categories not covered by a given theme. Also, at least KDE has no "other preferences" category, but rather a separate system settings application and a menu (with icon), both using one general settings icon for the whole set of sub-elements. However, with the "-other" suffix, they won't be used as a fall back so a link is going to be needed.
Rationale for the renames:
 
"preferences" to "settings": not because KDE uses settings, but because the icon naming spec then stays consistent with the fd.o menu spec, see [[http://standards.freedesktop.org/menu-spec/latest/apa.html]].
 
"other" implies that the icon should be a generic one, and indeed applications-other and preferences-other make for a good fallback if there are categories not covered by a given theme. Also, at least KDE has no "other preferences" category, but rather a separate system settings application and a menu (with icon), both using one general settings icon for the whole set of sub-elements.
 
The preferences-desktop-* ones are very implementation specific, as it's not specified anywhere that the "peripherals" and "personal" settings need to be a child element of the desktop settings. Likewise, "network" settings don't necessarily reside in the preferences-system category in certain desktops.

Revision as of 07:45, 9 July 2007

Specification compliance of icon names

Icon names without trailing stars already exist in the freedesktop.org icon naming specification.

 all category icons       missing

 * suggesting this for inclusion into the icon naming specification
 ** not in the spec, but let's keep it out of there anyways,
    it's not really suited to be a standard icon

To do for Oxygen

Icons that are in the spec, but not yet in Oxygen's categories/ so they need to be added. Descriptions taken from the specification. (A lot of those icons already exist as package_* in apps/, they'd only need to be pulled over to here.)

 
 application-accessories
   The icon for the "Accessories" sub-menu of the Programs menu.
   (Editor's note: move from apps/package-utilities.)

 applications-development
   The icon for the "Programming" sub-menu of the Programs menu.
   (Editor's note: move from apps/package-development.)

 applications-engineering
   The icon for the "Engineering" sub-menu of the Programs menu.

 applications-games
   The icon for the "Games" sub-menu of the Programs menu.

 applications-graphics
   The icon for the "Graphics" sub-menu of the Programs menu.
   (Editor's note: move from apps/package-graphics.)

 applications-internet
   The icon for the "Internet" sub-menu of the Programs menu.
   (Editor's note: move from apps/package-network.)

 applications-multimedia
   The icon for the "Multimedia" sub-menu of the Programs menu.
   (Editor's note: move from apps/package-multimedia.)

 applications-office
   The icon for the "Office" sub-menu of the Programs menu.

 applications-other
   The icon for the "Other" sub-menu of the Programs menu.
   (Editor's note: Name needs to be reviewed in collaboration
    with the icon naming specification maintainers, see below.)

 applications-science
   The icon for the "Science" sub-menu of the Programs menu.

 applications-system
   The icon for the "System Tools" sub-menu of the Programs menu.

 applications-utilities
   The icon for the "Utilities" sub-menu of the Programs menu.

 preferences-desktop
   The icon for the "Desktop Preferences" category.

 preferences-desktop-peripherals
   The icon for the "Peripherals" sub-category of the
   "Desktop Preferences" category.

 preferences-desktop-personal
   The icon for the "Personal" sub-category of the
   "Desktop Preferences" category.

 preferences-other
   The icon for the "Other" preferences category.

 preferences-system
   The icon for the "System Preferences" category.

 preferences-system-network
   The icon for the "Network" sub-category of the
   "System Preferences" category.

 system-help
   The icon for the "Help" system category.
   (Editor's note: move from apps/khelpcenter.)

Suggested changes and additions

Including a suggested short description text like needed for inclusion in the spec.

 applications-education
   The icon for the "Education" sub-menu of the Programs menu.

 applications-development
   [Rename "Programming" to "Development".]

 applications-other -> applications
   The icon for applications category.

 preferences-other -> settings
   The icon for a generic settings category.

 preferences-desktop -> settings-desktop
   The icon for the "Desktop" settings category.

 preferences-system -> settings-system
   The icon for the "System Administration" settings category.

 preferences-desktop-peripherals -> settings-peripherals
   The icon for the "Peripherals" settings category.

 preferences-desktop-personal -> settings-personal
   The icon for the "Personal" settings category.

 preferences-system-network -> settings-network
   The icon for the "Network" settings category.

Rationale for the renames:

"preferences" to "settings": not because KDE uses settings, but because the icon naming spec then stays consistent with the fd.o menu spec, see [[1]].

"other" implies that the icon should be a generic one, and indeed applications-other and preferences-other make for a good fallback if there are categories not covered by a given theme. Also, at least KDE has no "other preferences" category, but rather a separate system settings application and a menu (with icon), both using one general settings icon for the whole set of sub-elements.

The preferences-desktop-* ones are very implementation specific, as it's not specified anywhere that the "peripherals" and "personal" settings need to be a child element of the desktop settings. Likewise, "network" settings don't necessarily reside in the preferences-system category in certain desktops.