Projects/Oxygen/namingSpec/apps: Difference between revisions

From KDE TechBase
(Renamed okular to graphics-viewer-document.)
(A lot of updates for completed and planned KCM icons.)
Line 3: Line 3:
Icon names without trailing stars already exist in the freedesktop.org icon naming specification.  
Icon names without trailing stars already exist in the freedesktop.org icon naming specification.  


'''Generic Application Names (in the spec):'''
'''Generic Application Names:'''


<pre>
<pre>
Line 13: Line 13:
  kcall                              -> internet-telephony
  kcall                              -> internet-telephony
  kmail                              -> internet-mail **
  kmail                              -> internet-mail **
  korganizer                        -> office-calendar **
  korganizer                        -> office-calendar ***
  ksnapshot                          -> accessories-screen-shot **
  ksnapshot                          -> accessories-screen-shot **
  kuickshow                          -> graphics-viewer-image **
  kuickshow                          -> graphics-viewer-image **
Line 20: Line 20:
  graphics-viewer-document          OK **
  graphics-viewer-document          OK **
  preferences-desktop-accessibility  OK  
  preferences-desktop-accessibility  OK  
preferences-desktop-cryptography  OK **
  preferences-desktop-font          OK
  preferences-desktop-font          OK
preferences-desktop-gaming        OK **
  preferences-desktop-keyboard      OK
  preferences-desktop-keyboard      OK
preferences-desktop-mouse          OK *
  preferences-desktop-locale        OK
  preferences-desktop-locale        OK
  preferences-desktop-multimedia    Needed
  preferences-desktop-multimedia    Needed
preferences-desktop-notification  OK **
preferences-desktop-printer        OK **
  preferences-desktop-screensaver    OK
  preferences-desktop-screensaver    OK
  preferences-desktop-sound          OK **
  preferences-desktop-sound          OK ***
  preferences-desktop-theme          Needed
  preferences-desktop-theme          Needed
preferences-desktop-user          OK **
  preferences-desktop-wallpaper      OK
  preferences-desktop-wallpaper      OK
  preferences-system-windows        OK **
preferences-system-bluetooth      OK **
preferences-system-power-management OK **
preferences-system-time            OK **
  preferences-system-windows        OK ***
  system-file-manager                OK
  system-file-manager                OK
  system-software-update            OK
  system-software-update            OK
Line 39: Line 48:
  ** 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
 
*** exists in the Tango icon set, but not in the spec
'''Generic Application Names (not in the spec):'''
<pre>
preferences-desktop-cryptography  OK
preferences-desktop-notifications  OK
preferences-system-bluetooth      OK
preferences-system-time            OK
</pre>


'''Generic Tango icons in Oxygen:'''
'''Generic Tango icons in Oxygen:'''
Line 78: Line 80:
  kcmkwm                        -> svn rm
  kcmkwm                        -> svn rm
  kcolorchooser                -> move to kdegraphics/kcolorchooser
  kcolorchooser                -> move to kdegraphics/kcolorchooser
kdeprint-printer              -> svn rm,
                                  we already have devices/printer
  KEduca                        -> keduca (right?), and move to
  KEduca                        -> keduca (right?), and move to
                                   wherever keduca lives
                                   wherever keduca lives
Line 100: Line 100:
  knotes                        -> move to kdepim/knotes
  knotes                        -> move to kdepim/knotes
                                   (and to the notes plasmoid?)
                                   (and to the notes plasmoid?)
knotify                      ?? does it still exist? if no, svn rm.
                                  if yes, move to wherever it lives.
  kolf                          -> move to kdegames/kolf
  kolf                          -> move to kdegames/kolf
  konqueror                    -> move to kdebase/konqueror as
  konqueror                    -> move to kdebase/konqueror as
Line 162: Line 160:
   The icon for the "Desktop Effects; KCM. (New in KDE 4.)
   The icon for the "Desktop Effects; KCM. (New in KDE 4.)


  preferences-desktop-gaming
  preferences-desktop-icons
   The icon for the "Joystick" KCM.
   The icon for the "Icons" KCM.


  preferences-desktop-launch-feedback
  preferences-desktop-launch-feedback
   You can guess. Really, it's easy.
   You can guess. Really, it's easy.
preferences-desktop-mouse
  The icon for the "Mouse" KCM.


  preferences-desktop-panel
  preferences-desktop-panel
   The icon for the "Panels" KCM.
   The icon for the "Panels" KCM.
preferences-desktop-user
  The icon for the "About me" KCM in KDE 4's System Settings
  (which was named "Password & User Account in KDE 3).


  preferences-system-login
  preferences-system-login
   The icon for the "Login Manager" KCM.
   The icon for the "Login Manager" KCM.


  preferences-system-power-management
  preferences-system-network-discovery
   The icon for the "Power Control" KCM. (Although I'm not sure if
   The icon for the "Service Discovery"
   this will still exist for KDE 4, at least in its current form.)
  (= DNSSD / Zeroconf / Bonjour / Rendezvous) KCM.
 
preferences-system-network-proxy
   The icon for the "Proxy" KCM. (Also exists in the Tango set.)


  preferences-system-network-share
  preferences-system-network-share
   The icon for the "File Sharing" KCM.
   The icon for the "File Sharing" and "Local Network Browsing" KCMs.


  preferences-system-session
  preferences-system-session
Line 201: Line 195:


<pre>
<pre>
preferences-desktop-display-multiple
  The icon for the "Multiple Monitors" (aka Xinerama) KCM.
  preferences-desktop-display-randr
  preferences-desktop-display-randr
   The icon for the "Size & Orientation" KCM.
   The icon for the "Size & Orientation" KCM.
preferences-desktop-font-installer
  The icon for the "Font Installer" KCM.


  preferences-desktop-keyboard-khotkeys
  preferences-desktop-keyboard-khotkeys
Line 209: Line 209:
  preferences-desktop-panel-taskbar
  preferences-desktop-panel-taskbar
   The icon for the "Taskbar" KCM.
   The icon for the "Taskbar" KCM.
preferences-desktop-user-account
  The icon for the "Password & User Account" KCM.


  preferences-desktop-user-smartcard
  preferences-desktop-user-smartcard
Line 216: Line 219:
  preferences-system-solid
  preferences-system-solid
   The icon for the "Solid" KCM. (New in KDE 4.)
   The icon for the "Solid" KCM. (New in KDE 4.)
preferences-system-network-connection
  The icon for the "Connection Preferences" KCM.
preferences-system-network-share-windows
  The icon for the "Windows Shares" KCM.
preferences-system-network-share-windows-status
  The icon for the "Samba Status" KCM (in KInfoCenter).
preferences-system-session-services
  The icon for the "Service Manager" KCM.


  preferences-system-windows-effects
  preferences-system-windows-effects
Line 265: Line 280:


  preferences-system-windows
  preferences-system-windows
   Done.
   KWin settings. (Done.)


  system-installer
  system-installer

Revision as of 10:57, 5 October 2007

Specification compliance of icon names

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

Generic Application Names:

 accessories-calculator             OK (KDE 3 name: kcalc)
 accessories-character-map          OK
 accessories-dictionary             OK
 help-browser                       OK (KDE 3 name: khelpcenter)
 kaddressbook                       -> office-addressbook **
 kcall                              -> internet-telephony
 kmail                              -> internet-mail **
 korganizer                         -> office-calendar ***
 ksnapshot                          -> accessories-screen-shot **
 kuickshow                          -> graphics-viewer-image **
 kwrite                             -> accessories-text-editor
 multimedia-volume-control          OK
 graphics-viewer-document           OK **
 preferences-desktop-accessibility  OK 
 preferences-desktop-cryptography   OK **
 preferences-desktop-font           OK
 preferences-desktop-gaming         OK **
 preferences-desktop-keyboard       OK
 preferences-desktop-mouse          OK *
 preferences-desktop-locale         OK
 preferences-desktop-multimedia     Needed
 preferences-desktop-notification   OK **
 preferences-desktop-printer        OK **
 preferences-desktop-screensaver    OK
 preferences-desktop-sound          OK ***
 preferences-desktop-theme          Needed
 preferences-desktop-user           OK **
 preferences-desktop-wallpaper      OK
 preferences-system-bluetooth       OK **
 preferences-system-power-management OK **
 preferences-system-time            OK **
 preferences-system-windows         OK ***
 system-file-manager                OK
 system-software-update             OK
 utilities-file-archiver            OK ** (KDE 3 name: ark)
 utilities-system-monitor           OK
 utilities-terminal                 OK (KDE 3 name: konsole)
* 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
*** exists in the Tango icon set, but not in the spec

Generic Tango icons in Oxygen:

 krfb        -> preferences-desktop-remote-desktop

Other application icons:

Most other application icons should go to their home modules instead of residing in kdelibs - this not only makes for a better overview but also reduces disk space in case not all modules are installed. And, of course, prevents icons being misused for wrong usages.

 acroread                      ?? needs a spec type name for fallback
                                  RFC: "viewer-document-acroread"
 basket                        -> move to wherever basket lives
 digikam                       -> move to extragear/graphics/digikam
 gwenview                      -> move to kdegraphics/gwenview
 k3b                           -> move to extragear/multimedia/k3b
                                  as multimedia-disc-creator-k3b
 kaffeine                      -> move to extragear/kaffeine
                                  as multimedia-player-kaffeine
 kalzium                       -> move to kdeedu/kalzium
 kanagram                      -> move to kdeedu/kanagram
 kate                          -> move to kdesdk/kate as
                                  accessories-text-editor-kate
 kblogger                      -> move to wherever kblogger lives
 kbruch                        -> move to kdeedu/kbruch
 kbugbuster                    -> move to kdesdk/kbugbuster
 kchart                        -> move to koffice/kchart
 kcmkwm                        -> svn rm
 kcolorchooser                 -> move to kdegraphics/kcolorchooser
 KEduca                        -> keduca (right?), and move to
                                  wherever keduca lives
 kexi                          -> move to koffice/kexi
 kfind                         ?? svn rm,
                                  replaced by actions/system-search
 kgeography                    -> move to kdeedu/kgeography
 kget                          -> move to kdenetwork/kget
 khangman                      -> move to kdeedu/khangman
 kiten                         -> move to kdeedu/kiten
 kjournal                      ?? does it still exist? if no, svn rm.
                                  if yes, move to wherever it lives.
 KLatin                        -> klatin (right?), and move to
                                  wherever klatin lives
 klettres                      -> move to kdeedu/klettres
 klipper                       -> move to kdebase/klipper
 kmplayer                      -> move to extragear/multimedia/kmplayer
                                  as multimedia-player-kmplayer
 KmPlot                        -> kmplot, and move to kdeedu/kmplot
 knotes                        -> move to kdepim/knotes
                                  (and to the notes plasmoid?)
 kolf                          -> move to kdegames/kolf
 konqueror                     -> move to kdebase/konqueror as
                                  internet-web-browser-konqueror
 kontact                       -> move to kdepim/kontact
 konversation                  -> move to extragear/network/konversation
 konv-message                  -> move to extragear/network/konversation,
                                  and rename it to konversation-message
 kopete                        -> move to kdenetwork/kopete
 KPercentage                   -> kpercentage, and move to
                                  kdeedu/kpercentage
 krita                         -> move to koffice/krita
 kruler                        -> move to kdegraphics/kruler
 ksim-cpu                      ?? find out which apps use this icon
                                  (or devices/cpu), and make it private
 KSniffer                      -> ksniffer, and move to
                                  playground/network/ksniffer
 kstars                        -> move to kdeedu/kstars
 kteatime                      -> move to kdetoys/kteatime
 ktorrent                      -> move to extragear/network/ktorrent
                                  once the KDE 4 port is finished
 KVerbos                       -> kverbos, and move to
                                  playground/edu/kverbos
 kwallet                       OK
 KWordQuiz                     -> kwordquiz, and move to
                                  kdeedu/kwordquiz
 kword                         -> move to koffice/kword
 laptop-battery                ?? another battery icon? svn rm,
                                  or replace devices/battery
                                  with this one
 marble                        -> move to kdeedu/marble
 none                          -> svn rm
 plasmagik                     -> move to
                                  playground/base/plasma/plasmagik
 wine                          OK
 x                             OK [see Discussion]

To do for Oxygen

Icons that are in the spec, but not yet in Oxygen's apps/ (after renaming) so they need to be added. Descriptions taken from the specification.

 preferences-desktop-multimedia
   The icon used for the desktop's multimedia preferences.

 preferences-desktop-theme
   The icon used for the desktop's theme preferences.

To do for Oxygen - not in the spec

Icons that are not specified and do not currently exist as well, but are needed for KDE applications (and not blatantly obvious). Yes, I am aware that some of those are bad (if not outright evil) names. That comes from preferences-desktop-peripherals being classified in the "desktop" preferences subgroup, which is very wrong imho. We need to fix this in the spec (see the suggestions of the categories page), but until then, I stay with specification conform names.

 preferences-desktop-display
   The icon for the "Display" KCM.

 preferences-desktop-effects
   The icon for the "Desktop Effects; KCM. (New in KDE 4.)

 preferences-desktop-icons
   The icon for the "Icons" KCM.

 preferences-desktop-launch-feedback
   You can guess. Really, it's easy.

 preferences-desktop-panel
   The icon for the "Panels" KCM.

 preferences-system-login
   The icon for the "Login Manager" KCM.

 preferences-system-network-discovery
   The icon for the "Service Discovery"
   (= DNSSD / Zeroconf / Bonjour / Rendezvous) KCM.

 preferences-system-network-proxy
   The icon for the "Proxy" KCM. (Also exists in the Tango set.)

 preferences-system-network-share
   The icon for the "File Sharing" and "Local Network Browsing" KCMs.

 preferences-system-session
   The icon for the "Session Manager" KCM.
   (This icon also exists in the Tango set.)

 preferences-system-splash
   The icon for the "Splash Screen" KCM.

Optional icons

We don't absolutely need those because they are covered by fallbacks: if these icons don't exist, they've got a sensible fallback.

 preferences-desktop-display-multiple
   The icon for the "Multiple Monitors" (aka Xinerama) KCM.

 preferences-desktop-display-randr
   The icon for the "Size & Orientation" KCM.

 preferences-desktop-font-installer
   The icon for the "Font Installer" KCM.

 preferences-desktop-keyboard-khotkeys
   The icon for the "KHotKeys" KCM.

 preferences-desktop-panel-taskbar
   The icon for the "Taskbar" KCM.

 preferences-desktop-user-account
   The icon for the "Password & User Account" KCM.

 preferences-desktop-user-smartcard
   The icon for the "Smartcards" KCM.
   (Was "identity" in KDE 3, and is really not necessary.)

 preferences-system-solid
   The icon for the "Solid" KCM. (New in KDE 4.)

 preferences-system-network-connection
   The icon for the "Connection Preferences" KCM.

 preferences-system-network-share-windows
   The icon for the "Windows Shares" KCM.

 preferences-system-network-share-windows-status
   The icon for the "Samba Status" KCM (in KInfoCenter).

 preferences-system-session-services
   The icon for the "Service Manager" KCM.

 preferences-system-windows-effects
   The icon for the "Window Effects" KCM. (New in KDE 4.)

 preferences-system-windows-decoration
   The icon for the "Window Decorations" KCM.

 preferences-system-windows-specific
   The icon for the "Window-Specific Settings" KCM.

Icons in Tango, but not in the spec

We don't need to have those, but if we do they should be named this way:

 internet-group-chat
   For a possible generic instant messager icon.
   *Very* optional though, as we already have branded
   Kopete and Konversation icons.

 internet-mail
   We already have this from the previous "kmail" icon.

 internet-news-reader
   Instead of "knode".

 internet-web-browser
   For a possible generic browser icon. *Very* optional though,
   as we already have a branded Konqueror icon.

 office-calendar
   We already have this from the previous "korganizer" icon.

 preferences-desktop-assistive-technology
   Tango does this as preferences-desktop-accessibility
   plus an emblem-style gear icon at the lower right.
   Hardly necessary to have.

 preferences-desktop-sound
   Go Phonon go. (Done.)

 preferences-system-network-proxy
   We do have proxy settings in KDE 3, this might make sense.

 preferences-system-session
   The icon for the session management settings.

 preferences-system-windows
   KWin settings. (Done.)

 system-installer
   Adept, Yast, Pirut, Smart, or whatever else is out there.

 system-users
   Seems to fit KUser or Guidance's "User Management" module.