Projects/Oxygen/namingSpec/categories: Difference between revisions

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.

@@ Line 1: / Line 1: @@
 == Specification compliance of icon names ==
-Icon names without trailing stars already exist in the freedesktop.org icon naming specification or Tango icon set.If there is no Old Name, please help to determine if we need this icon for KDE4.  Note that this is a new directory so all of the renames are going to be in a different directory.
+Icon names without trailing stars already exist in the freedesktop.org icon naming specification.
 <pre>
-KDE3 Name               New Name                         Oxygen status
+ applications-accessories              OK
+ applications-development              OK
-[none]                  applications-accessories         TBD
+ applications-development-translation  OK **
-package_applications
+ applications-development-web          OK **
-package_development     applications-development         rename
+ applications-education                OK *
-package_editors
+ applications-education-language       OK **
-package_edutainment     applications-education *         needed
+ applications-education-mathematics    OK **
-[none]                  applications-engineering         need
+ applications-engineering              OK
-package_favourite
+ applications-games                    OK
-package_games           applications-games
+  applications-graphics                 OK
-package_games_arcade
+ applications-internet                 OK
-package_games_board
+ applications-multimedia               OK
-package_games_card
+  applications-office                   OK
-package_games_strategy
+ applications-other                    OK
-package_graphics        applications-graphics            rename
+ applications-science                  OK
-package_network         applications-internet            rename
+ applications-system                   OK
-package_multimedia      applications-multimedia          rename
+ applications-toys                     OK **
-package_wordprocessing  applications-office
+ applications-utilities                OK
-package                 applications-other               need
+ preferences-other                     OK
-[none]                  applications-science             need
+ preferences-desktop                   OK
-package_system          applications-system
+  preferences-desktop-peripherals       OK ***
-package_toys
+  preferences-desktop-personal          OK ***
-package_utilities       applications-utilities           rename
+ preferences-system                    OK
-desktop                 preferences-desktop
+ preferences-system-network            OK ***
-input_devices_settings  preferences-desktop-peripherals
+ system-help                           OK
-personal                preferences-desktop-personal
-[none]                  preferences-other                TBD
-package_settings        preferences-system
-kcmsystem               preferences-system-network
-khelpcenter             system-help                      rename
   * 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
 </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.
+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.
- applications-engineering
+These icons are good to have, but even if we lack those there will be a sensible fallback.
-   The icon for the "Engineering" sub-menu of the Programs menu.
-  applications-games
+<pre>
-   The icon for the "Games" sub-menu of the Programs menu.
+  applications-games-arcade **
+    An icon for arcade games, like KTron or Clanbomber.
- 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
+  applications-games-board **
-    The icon for the "Science" sub-menu of the Programs menu.
+    An icon for board games, like Mahjongg or Chess.
-  applications-system
+  applications-games-children **
-    The icon for the "System Tools" sub-menu of the Programs menu.
+    An icon for games for small children,
+   like the scary Potato Guy.
-  preferences-desktop
+  applications-games-strategy **
-    The icon for the "Desktop Preferences" category.
+    An icon for strategy games, like Minesweeper,
+   Sokoban or Battle for Wesnoth.
-  preferences-desktop-peripherals
+  applications-games-card **
-    The icon for the "Peripherals" sub-category of the
+    An icon for card games... but for Oxygen, we already have
-   "Desktop Preferences" category.
+    a card set icon as fallback, so it doesn't make much sense
+    to draw a new icon. Just listed for completeness.
- 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.
 </pre>
@@ Line 95: / Line 71: @@
 <pre>
+ 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.
-  application
+  preferences-desktop-peripherals -> preferences-peripherals
-    link to applications-other
+   The icon for the "Peripherals" preferences category.
-  preferences
+  preferences-desktop-personal -> preferences-personal
-    link to preferences-other
+   The icon for the "Personal" preferences category.
+ preferences-system-network -> preferences-network
+   The icon for the "Network" preferences category.
 </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:
+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.