Projects/Oxygen/namingSpec/categories: Difference between revisions

From KDE TechBase
(I think it's more correct with a plural "s".)
(Change more stuff. Pretty daring, but I think it's the right thing to do.)
Line 53: Line 53:
  applications-utilities
  applications-utilities
   The icon for the "Utilities" sub-menu of the Programs menu.
   The icon for the "Utilities" sub-menu of the Programs menu.
preferences-desktop
  The icon for the "Desktop Preferences" category.
preferences-system
  The icon for the "System Preferences" category.


  system-help
  system-help
Line 64: Line 58:
</pre>
</pre>


== Summary of the suggested changes and additions ==
== Suggested changes and additions ==


The ones marked with * and should therefore go into the icon naming specification, presented here in a shorter list for a better overview. Including a suggested short description text like needed for inclusion in the spec.
The ones marked with * and should therefore go into the icon naming specification, presented here in a shorter list for a better overview. Including a suggested short description text like needed for inclusion in the spec.
Line 76: Line 70:


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


  preferences-other -> preferences
  preferences-other -> settings
   The generic icon for preferences categories.
   The icon for a generic settings category.
</pre>


== Problematic category icons ==
preferences-desktop -> settings-desktop
  The icon for the "Desktop Settings" category.


The first three 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 system settings category.
preferences-system -> settings-system
  The icon for the "System Settings" category.


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


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


preferences-system-network
preferences-system-network -> settings-network
  The icon for the "Network" sub-category of the
  The icon for the "Network" settings category.
  "System Preferences" category.
</pre>
</pre>
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 17:42, 4 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.

 
 application-accessories
   The icon for the "Accessories" sub-menu of the Programs menu.

 applications-development
   The icon for the "Programming" sub-menu of the Programs menu.

 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.

 applications-internet
   The icon for the "Internet" sub-menu of the Programs menu.

 applications-multimedia
   The icon for the "Multimedia" sub-menu of the Programs menu.

 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.

 system-help
   The icon for the "Help" system category.

Suggested changes and additions

The ones marked with * and should therefore go into the icon naming specification, presented here in a shorter list for a better overview. 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 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.