Projects/Oxygen/namingSpec/categories: Difference between revisions

From KDE TechBase
(Davigno added apps/package-settings, note where it is to be found.)
(Starting a new list of optional icons.)
 
(45 intermediate revisions by 4 users not shown)
Line 4: Line 4:


<pre>
<pre>
  all category icons       missing
  applications-accessories              OK
applications-development              OK
applications-development-translation  OK **
applications-development-web          OK **
applications-education                OK *
applications-education-language       OK **
applications-education-mathematics    OK **
applications-engineering              OK
applications-games                    OK
applications-graphics                OK
applications-internet                OK
applications-multimedia              OK
applications-office                  OK
applications-other                    OK
applications-science                  OK
applications-system                  OK
applications-toys                    OK **
applications-utilities                OK
preferences-other                    OK
preferences-desktop                  OK
preferences-desktop-peripherals      OK ***
preferences-desktop-personal          OK ***
preferences-system                    OK
preferences-system-network            OK ***
system-help                          OK


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


== To do for Oxygen ==
== To do for Oxygen - specified icons ==


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.)
None, everything's in place in the "categories" category :D


<pre>
== To do for Oxygen - optional icons ==
application-accessories
  The icon for the "Accessories" sub-menu of the Programs menu.
  (Editor's note: move from apps/package-utilities.)


applications-development
These icons are good to have, but even if we lack those there will be a sensible fallback.
  The icon for the "Programming" sub-menu of the Programs menu.
  (Editor's note: move from apps/package-development.)


applications-engineering
<pre>
  The icon for the "Engineering" sub-menu of the Programs menu.
  applications-games-arcade **
 
   An icon for arcade games, like KTron or Clanbomber.
  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
  applications-games-board **
   The icon for the "Personal" sub-category of the
   An icon for board games, like Mahjongg or Chess.
  "Desktop Preferences" category.


  preferences-other
  applications-games-children **
   The icon for the "Other" preferences category.
   An icon for games for small children,
   (Editor's note: move from apps/package-settings.)
   like the scary Potato Guy.


  preferences-system
  applications-games-strategy **
   The icon for the "System Preferences" category.
   An icon for strategy games, like Minesweeper,
  Sokoban or Battle for Wesnoth.


  preferences-system-network
  applications-games-card **
   The icon for the "Network" sub-category of the
   An icon for card games... but for Oxygen, we already have
   "System Preferences" category.
   a card set icon as fallback, so it doesn't make much sense
 
   to draw a new icon. Just listed for completeness.
system-help
   The icon for the "Help" system category.
  (Editor's note: move from apps/khelpcenter.)
</pre>
</pre>


Line 91: Line 71:


<pre>
<pre>
applications-development
  [In the description, change "Programming" to "Development",
    in accordance to the icon name and the fd.o menu spec.]
  applications-education
  applications-education
   The icon for the "Education" sub-menu of the Programs menu.
   The icon for the "Education" sub-menu of the Programs menu.


applications-development
  preferences-desktop-peripherals -> preferences-peripherals
  [Rename "Programming" to "Development".]
   The icon for the "Peripherals" preferences category.
 
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
  preferences-desktop-personal -> preferences-personal
   The icon for the "Personal" settings category.
   The icon for the "Personal" preferences category.


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

Latest revision as of 21:54, 22 December 2007

Specification compliance of icon names

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

 applications-accessories              OK
 applications-development              OK
 applications-development-translation  OK **
 applications-development-web          OK **
 applications-education                OK *
 applications-education-language       OK **
 applications-education-mathematics    OK **
 applications-engineering              OK
 applications-games                    OK
 applications-graphics                 OK
 applications-internet                 OK
 applications-multimedia               OK
 applications-office                   OK
 applications-other                    OK
 applications-science                  OK
 applications-system                   OK
 applications-toys                     OK **
 applications-utilities                OK
 preferences-other                     OK
 preferences-desktop                   OK
 preferences-desktop-peripherals       OK ***
 preferences-desktop-personal          OK ***
 preferences-system                    OK
 preferences-system-network            OK ***
 system-help                           OK

 * 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 - specified icons

None, everything's in place in the "categories" category :D

To do for Oxygen - optional icons

These icons are good to have, but even if we lack those there will be a sensible fallback.

 applications-games-arcade **
   An icon for arcade games, like KTron or Clanbomber.

 applications-games-board **
   An icon for board games, like Mahjongg or Chess.

 applications-games-children **
   An icon for games for small children,
   like the scary Potato Guy.

 applications-games-strategy **
   An icon for strategy games, like Minesweeper,
   Sokoban or Battle for Wesnoth.

 applications-games-card **
   An icon for card games... but for Oxygen, we already have
   a card set icon as fallback, so it doesn't make much sense
   to draw a new icon. Just listed for completeness.

Suggested changes and additions

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

 applications-development
   [In the description, 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.

 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:

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.