Projects/Oxygen/namingSpec/apps: Difference between revisions

    From KDE TechBase
    (Add the preferences-desktop-color to the list (copied by myself, yay) and fill in a few more KDE 3 names.)
    (Pinheiro added preferences-desktop-theme (whoo! yeehah!), and unrelated to that, also add a lot of KDE 3 names.)
    Line 7: Line 7:
    <pre>
    <pre>
      accessories-calculator            OK (KDE 3 name: kcalc)
      accessories-calculator            OK (KDE 3 name: kcalc)
      accessories-character-map          OK
      accessories-character-map          OK (KDE 3 name: kcharselect)
      accessories-dictionary            OK
      accessories-dictionary            OK (KDE 3 name: kdict)
      internet-web-browser              OK ***
      internet-web-browser              OK *** (did not exist
                                            in this form in KDE 3)
      help-browser                      OK (KDE 3 name: khelpcenter)
      help-browser                      OK (KDE 3 name: khelpcenter)
      kcall                              -> internet-telephony **
      kcall                              -> internet-telephony **
    Line 15: Line 16:
      ksnapshot                          -> accessories-screen-shot **
      ksnapshot                          -> accessories-screen-shot **
      kuickshow                          -> graphics-viewer-image **
      kuickshow                          -> graphics-viewer-image **
      accessories-text-editor            OK
      accessories-text-editor            OK (KDE 3 name: kwrite)
      multimedia-volume-control          OK
      multimedia-volume-control          OK
      graphics-viewer-document          OK **
      graphics-viewer-document          OK **
    Line 25: Line 26:
      preferences-desktop-accessibility  OK (KDE 3 name: access)
      preferences-desktop-accessibility  OK (KDE 3 name: access)
      preferences-desktop-color          OK ** (KDE 3 name: colors)
      preferences-desktop-color          OK ** (KDE 3 name: colors)
      preferences-desktop-cryptography  OK **
      preferences-desktop-cryptography  OK **  
      preferences-desktop-display        OK **
      preferences-desktop-display        OK **
      preferences-desktop-icons          OK **
      preferences-desktop-icons          OK ** (KDE 3 name: icons)
      preferences-desktop-filetype-association OK **
      preferences-desktop-filetype-association OK **
                                           (KDE 3 name: filetypes)
                                           (KDE 3 name: filetypes)
    Line 36: Line 37:
      preferences-desktop-keyboard      OK (KDE 3 name: keyboard)
      preferences-desktop-keyboard      OK (KDE 3 name: keyboard)
      preferences-desktop-mouse          OK * (KDE 3 name: devices/mouse)
      preferences-desktop-mouse          OK * (KDE 3 name: devices/mouse)
      preferences-desktop-launch-feedback OK **
      preferences-desktop-launch-feedback OK ** (KDE 3 name: actions/launch)
      preferences-desktop-locale        OK
      preferences-desktop-locale        OK (KDE 3 name: locale)
      preferences-desktop-multimedia    Needed
      preferences-desktop-multimedia    Needed
      preferences-desktop-notification  OK **
      preferences-desktop-notification  OK ** (KDE 3 name: knotify)
      preferences-desktop-printer        OK **
      preferences-desktop-printer        OK ** (KDE 3 name: printmgr)
      preferences-desktop-screensaver    OK
      preferences-desktop-screensaver    OK (KDE 3 name: kscreensaver)
      preferences-desktop-sound          OK ***
      preferences-desktop-sound          OK *** (KDE 3 name: kcmsound)
      preferences-desktop-text-to-speech OK ** (KDE 3 name: kttsd)
      preferences-desktop-text-to-speech OK ** (KDE 3 name: kttsd)
      preferences-desktop-theme          Needed
      preferences-desktop-theme          OK (KDE 3 name: looknfeel)
      preferences-desktop-user          OK **
      preferences-desktop-user          OK ** (KDE 3 name: userconfig)
      preferences-desktop-wallpaper      OK
      preferences-desktop-wallpaper      OK (KDE 3 name: background)
      preferences-system-bluetooth      OK **
      preferences-system-bluetooth      OK ** (KDE 3 name: kdebluetooth)
      preferences-system-login          OK **
      preferences-system-login          OK ** (KDE 3 name: kdmconfig)
      preferences-system-performance    OK **
      preferences-system-performance    OK ** (KDE 3 origin: launch)
      preferences-system-power-management OK ** (KDE 3 name: energy)
      preferences-system-power-management OK ** (KDE 3 name: energy)
      preferences-system-session-services OK ** (KDE 3 name: services)
      preferences-system-session-services OK ** (KDE 3 name: services)
      preferences-system-time            OK **
      preferences-system-time            OK ** (KDE 3 name: date)
      preferences-system-windows        OK ***
      preferences-system-windows        OK *** (KDE 3 name: kwin)
      preferences-web-browser-adblock    OK ** (KDE 3 origin: filter)
      preferences-web-browser-adblock    OK ** (KDE 3 origin: filter)
      preferences-web-browser-cache      OK ** (KDE 3 name: cache)
      preferences-web-browser-cache      OK ** (KDE 3 name: cache)
    Line 60: Line 61:
      preferences-web-browser-stylesheets OK ** (KDE 3 name: stylesheet)
      preferences-web-browser-stylesheets OK ** (KDE 3 name: stylesheet)
      preferences-web-browser-shortcuts  OK ** (KDE 3 name: enhanced_browsing)
      preferences-web-browser-shortcuts  OK ** (KDE 3 name: enhanced_browsing)
      system-file-manager                OK
      system-file-manager                OK (KDE 3 name: kfm)
      system-software-update            OK
      system-software-update            OK (KDE 3 name: kpackage)
      utilities-file-archiver            OK ** (KDE 3 name: ark)
      utilities-file-archiver            OK ** (KDE 3 name: ark)
      utilities-log-viewer              OK **
      utilities-log-viewer              OK ** (KDE 3 name: ksystemlog)
      utilities-system-monitor          OK
      utilities-system-monitor          OK (KDE 3 name: ksysguard)
      utilities-terminal                OK (KDE 3 name: konsole)
      utilities-terminal                OK (KDE 3 name: konsole)
    </pre>
    </pre>
    Line 150: Line 151:
      preferences-desktop-multimedia
      preferences-desktop-multimedia
       The icon used for the desktop's multimedia preferences.
       The icon used for the desktop's multimedia preferences.
    preferences-desktop-theme
      The icon used for the desktop's theme preferences.
    </pre>
    </pre>



    Revision as of 20:36, 24 November 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 (KDE 3 name: kcharselect)
     accessories-dictionary             OK (KDE 3 name: kdict)
     internet-web-browser               OK *** (did not exist
                                            in this form in KDE 3)
     help-browser                       OK (KDE 3 name: khelpcenter)
     kcall                              -> internet-telephony **
     kmail                              -> internet-mail ***
     ksnapshot                          -> accessories-screen-shot **
     kuickshow                          -> graphics-viewer-image **
     accessories-text-editor            OK (KDE 3 name: kwrite)
     multimedia-volume-control          OK
     graphics-viewer-document           OK **
     office-addressbook                 OK ** (KDE 3 name: kaddressbook)
                                           (kaddressbook still exists:
                                            rename .desktop file and
                                            delete this icon)
     office-calendar                    OK *** (KDE 3 name: korganizer)
     preferences-desktop-accessibility  OK (KDE 3 name: access)
     preferences-desktop-color          OK ** (KDE 3 name: colors)
     preferences-desktop-cryptography   OK ** 
     preferences-desktop-display        OK **
     preferences-desktop-icons          OK ** (KDE 3 name: icons)
     preferences-desktop-filetype-association OK **
                                           (KDE 3 name: filetypes)
     preferences-desktop-font           OK (KDE 3 name: font)
     preferences-desktop-font-installer OK ** (in workspace/kcontrol/kfontinst)
                                           (KDE 3 name: kcmfontinst)
     preferences-desktop-gaming         OK ** (KDE 3 name: devices/joystick)
     preferences-desktop-keyboard       OK (KDE 3 name: keyboard)
     preferences-desktop-mouse          OK * (KDE 3 name: devices/mouse)
     preferences-desktop-launch-feedback OK ** (KDE 3 name: actions/launch)
     preferences-desktop-locale         OK (KDE 3 name: locale)
     preferences-desktop-multimedia     Needed
     preferences-desktop-notification   OK ** (KDE 3 name: knotify)
     preferences-desktop-printer        OK ** (KDE 3 name: printmgr)
     preferences-desktop-screensaver    OK (KDE 3 name: kscreensaver)
     preferences-desktop-sound          OK *** (KDE 3 name: kcmsound)
     preferences-desktop-text-to-speech OK ** (KDE 3 name: kttsd)
     preferences-desktop-theme          OK (KDE 3 name: looknfeel)
     preferences-desktop-user           OK ** (KDE 3 name: userconfig)
     preferences-desktop-wallpaper      OK (KDE 3 name: background)
     preferences-system-bluetooth       OK ** (KDE 3 name: kdebluetooth)
     preferences-system-login           OK ** (KDE 3 name: kdmconfig)
     preferences-system-performance     OK ** (KDE 3 origin: launch)
     preferences-system-power-management OK ** (KDE 3 name: energy)
     preferences-system-session-services OK ** (KDE 3 name: services)
     preferences-system-time            OK ** (KDE 3 name: date)
     preferences-system-windows         OK *** (KDE 3 name: kwin)
     preferences-web-browser-adblock    OK ** (KDE 3 origin: filter)
     preferences-web-browser-cache      OK ** (KDE 3 name: cache)
     preferences-web-browser-cookies    OK ** (KDE 3 name: cookie)
     preferences-web-browser-identification OK ** (KDE 3 name: agent)
     preferences-web-browser-stylesheets OK ** (KDE 3 name: stylesheet)
     preferences-web-browser-shortcuts  OK ** (KDE 3 name: enhanced_browsing)
     system-file-manager                OK (KDE 3 name: kfm)
     system-software-update             OK (KDE 3 name: kpackage)
     utilities-file-archiver            OK ** (KDE 3 name: ark)
     utilities-log-viewer               OK ** (KDE 3 name: ksystemlog)
     utilities-system-monitor           OK (KDE 3 name: ksysguard)
     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
     fontforge                     OK
     gwenview                      -> move to kdegraphics/gwenview
     java                          OK
     k3b                           -> move to extragear/multimedia/k3b
     kaffeine                      -> move to extragear/kaffeine
     kalzium                       -> move to kdeedu/kalzium
     kanagram                      -> move to kdeedu/kanagram
     kate                          -> move to kdesdk/kate
     kblogger                      -> move to wherever kblogger lives
     kbruch                        -> move to kdeedu/kbruch
     kbugbuster                    -> move to kdesdk/kbugbuster
     kchart                        -> move to koffice/kchart
     kcolorchooser                 -> move to kdegraphics/kcolorchooser
     kexi                          -> move to koffice/kexi
     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.
     klettres                      -> move to kdeedu/klettres
     klipper                       -> move to kdebase/klipper
     kmplayer                      -> move to extragear/multimedia/kmplayer
     kmplot                        -> move to kdeedu/kmplot
     knotes                        -> move to kdepim/knotes
                                      (and to the notes plasmoid?)
     kolf                          -> move to kdegames/kolf
     konqueror                     OK
     kontact                       -> move to kdepim/kontact
     konversation                  -> move to extragear/network/konversation
     konv-message                  -> status/konversation-dock-flashing
     kopete                        -> move to kdenetwork/kopete
     kpercentage                   -> move to kdeedu/kpercentage
     krita                         -> move to koffice/krita
     kruler                        -> move to kdegraphics/kruler
     ksniffer                      -> move to playground/network/ksniffer
     kstars                        -> move to kdeedu/kstars
     kteatime                      -> move to kdetoys/kteatime
     ktorrent                      -> move to extragear/network/ktorrent
     kverbos                       -> parley, and move to
                                      playground/edu/parley
     kwallet                       OK
     kwordquiz                     -> 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
     plasmagik                     -> move to
                                      playground/base/plasma/plasmagik
     strigi                        OK
     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.
    

    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-effect
       The icon for the "Desktop Effects" KCM. (New in KDE 4.)
    
     preferences-desktop-panel
       The icon for the "Panels" 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-keyboard-khotkeys
       The icon for the "KHotKeys" KCM.
    
     preferences-desktop-multiple
       The icon for the "Multiple Desktops"
       (a.k.a. virtual desktops) 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-windows-effect
       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.
    

    Even more optional

    Draw those only if you feel like wasting time for little outcome. I haven't got KDE 4 compiled at the moment, so I don't even know if those are visible at all.

     preferences-system-windows-focus
       The icon for the KWin's "Focus" settings, which
       belong to the "Window Behaviour" KCM.
    
     preferences-system-windows-action
       The icon for the KWin's "Actions" settings, which
       belong to the "Window Behaviour" KCM.
    
     preferences-system-windows-movement
       The icon for the KWin's "Moving" settings, which
       belong to the "Window Behaviour" KCM.
    
     preferences-system-windows-advanced
       The icon for the KWin's "Advanced" settings, which
       belong to the "Window Behaviour" 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. (Done.)
    
     office-calendar
       We already have this from the previous "korganizer" icon.
       (Done.)
    
     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.
       (Evaluate if actions/users can be moved here.)