Projects/Oxygen/namingSpec/categories: Difference between revisions

From KDE TechBase
(David did applications-education, it only needs to be moved into the right folder.)
(Be more conservative, having "preferences" named "settings" is secondary and will probably not be included.)
Line 80: Line 80:
   The icon for applications category.
   The icon for applications category.


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


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


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


preferences-desktop-peripherals -> settings-peripherals
  preferences-system-network -> preferences-network
  The icon for the "Peripherals" settings category.
   The icon for the "Network" preferences 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>


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

Revision as of 11:59, 25 July 2007

Specification compliance of icon names

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

 apps/package-utilities    -> applications-accessories
 apps/package-development  -> applications-development
 apps/package-graphics     -> applications-graphics
 apps/package-network      -> applications-internet
 apps/package-multimedia   -> applications-multimedia
 apps/package-settings     -> preferences-other ***
 apps/package-system       -> applications-system
 apps/khelpcenter          -> system-help
 apps/applications-education -> applications-education *

 * 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
 *** bad naming in the spec imho, suggesting to rename this icon
     there, but let's use the specified name for now

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.)

 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-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-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-system
   The icon for the "System Preferences" category.

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

Suggested changes and additions

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

 applications-development
   [Change "Programming" to "Development", in accordance to the
    icon name and the fd.o menu spec.]

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

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

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

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

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

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

Rationale for the renames:

"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" preferences need to be a child element of the desktop preferences. Likewise, "network" settings don't necessarily reside in the preferences-system category in certain desktops.