Projects/Oxygen/namingSpec/emblems: Difference between revisions

From KDE TechBase
(A stub for Oxygen's emblems category, for JRT and me to fill in.)
 
(Somehow, emblem-symbolic-link got renamed, magically and unnoticed.)
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
== Specification compliance of icon names ==
== Specification compliance of icon names ==


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. Also, the existing emblem icons need to be blown up to full icon size once emblems are done with automatic resizing and placement.


<pre>
<pre>
  current-icon-name        -> new-icon-name
  emblem-symbolic-link    OK
  another-icon-name        -> another-new-icon-name
emblem-favorite          OK
emblem-mounted          OK *
emblem-default          Needed
emblem-documents        Needed
emblem-downloads        Needed
  emblem-important        Needed
emblem-mail              Needed
emblem-photos            Needed
emblem-readonly          Needed
emblem-shared            Needed
emblem-synchronized      Needed
emblem-system            Needed
emblem-unreadable        Needed


  * suggesting this for inclusion into the icon naming specification
  * suggesting this for inclusion into the icon naming specification
Line 17: Line 29:


<pre>
<pre>
  missing-icon
  emblem-default
   [Here goes the description from the icon naming specification.]
  The icon used as an emblem to specify the default selection
  of a printer for example.
 
emblem-documents
  The icon used as an emblem for the directory where a user's
  documents are stored.
 
emblem-downloads
  The icon used as an emblem for the directory where a user's
  downloads from the internet are stored.
 
emblem-important
  The icon used as an emblem for files and directories that are
  marked as important by the user.
  (Editor's note: Let's extract this from places/folder-important.)
 
emblem-mail
  The icon used as an emblem to specify the directory where the
  user's electronic mail is stored.
 
emblem-photos
   The icon used as an emblem to specify the directory where the
  user stores photographs.
  (Editor's note: Let's extract this from places/folder-image.)
 
emblem-readonly
  The icon used as an emblem for files and directories which can
  not be written to by the user.
  (Editor's note: Let's extract this from places/folder-locked.)
 
emblem-shared
  The icon used as an emblem for files and directories that are
  shared to other users.
 
emblem-synchronized
  The icon used as an emblem for files or directories that are
  configured to be synchronized to another device.
 
emblem-system
  The icon used as an emblem for directories that contain system
  libraries, settings, and data.
 
emblem-unreadable
  The icon used as an emblem for files and directories
  that are inaccessible.
</pre>
</pre>


== To do for Oxygen *and* the spec ==
Icons that are neither in the spec nor in Oxygen's emblems/ (after renaming) but still should be added to both.
<pre>
emblem-audio
  The icon used as an emblem for folders and media containing
  audio content, such as music collection folders or audio CDs.
  (Editor's note: Let's extract this from places/folder-audio.)
emblem-video
  The icon used as an emblem for folders and media containing
  video content, such as video collection folders or video DVDs.
  (Editor's note: Let's extract this from places/folder-video.)
</pre>


== Summary of the suggested changes and additions ==
== Summary of the suggested changes and additions ==


The ones marked with * and should therefore go into the icon naming specification, presented here in a shorter list for a better overview. Including a suggested short description text like needed for inclusion in the spec.
Including a suggested short description text like needed for inclusion in the spec.


<pre>
<pre>
  newly-suggested-icon
  emblem-mounted
   The icon used for [whatever].
  The icon used as an emblem for mounted drives and media.
 
emblem-audio
  The icon used as an emblem for folders and media containing
  audio content, such as music collection folders or audio CDs.
 
emblem-video
   The icon used as an emblem for folders and media containing
  video content, such as video collection folders or video DVDs.
</pre>
</pre>
== Open questions ==
* Can additional (unspecified) emblems be added to the emblems/ directory? What happens if any given theme doesn't provide a requested emblem?

Latest revision as of 00:56, 20 October 2007

Specification compliance of icon names

Icon names without trailing stars already exist in the freedesktop.org icon naming specification. Also, the existing emblem icons need to be blown up to full icon size once emblems are done with automatic resizing and placement.

 emblem-symbolic-link     OK
 emblem-favorite          OK
 emblem-mounted           OK *
 emblem-default           Needed
 emblem-documents         Needed
 emblem-downloads         Needed
 emblem-important         Needed
 emblem-mail              Needed
 emblem-photos            Needed
 emblem-readonly          Needed
 emblem-shared            Needed
 emblem-synchronized      Needed
 emblem-system            Needed
 emblem-unreadable        Needed

 * 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

To do for Oxygen

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

 emblem-default
   The icon used as an emblem to specify the default selection
   of a printer for example.

 emblem-documents
   The icon used as an emblem for the directory where a user's
   documents are stored.

 emblem-downloads
   The icon used as an emblem for the directory where a user's
   downloads from the internet are stored.

 emblem-important
   The icon used as an emblem for files and directories that are
   marked as important by the user.
   (Editor's note: Let's extract this from places/folder-important.)

 emblem-mail
   The icon used as an emblem to specify the directory where the
   user's electronic mail is stored.

 emblem-photos
   The icon used as an emblem to specify the directory where the
   user stores photographs.
   (Editor's note: Let's extract this from places/folder-image.)

 emblem-readonly
   The icon used as an emblem for files and directories which can
   not be written to by the user.
   (Editor's note: Let's extract this from places/folder-locked.)

 emblem-shared
   The icon used as an emblem for files and directories that are
   shared to other users.

 emblem-synchronized
   The icon used as an emblem for files or directories that are
   configured to be synchronized to another device.

 emblem-system
   The icon used as an emblem for directories that contain system
   libraries, settings, and data.

 emblem-unreadable
   The icon used as an emblem for files and directories
   that are inaccessible.

To do for Oxygen *and* the spec

Icons that are neither in the spec nor in Oxygen's emblems/ (after renaming) but still should be added to both.

 emblem-audio
   The icon used as an emblem for folders and media containing
   audio content, such as music collection folders or audio CDs.
   (Editor's note: Let's extract this from places/folder-audio.)

 emblem-video
   The icon used as an emblem for folders and media containing
   video content, such as video collection folders or video DVDs.
   (Editor's note: Let's extract this from places/folder-video.)

Summary of the suggested changes and additions

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

 emblem-mounted
   The icon used as an emblem for mounted drives and media.

 emblem-audio
   The icon used as an emblem for folders and media containing
   audio content, such as music collection folders or audio CDs.

 emblem-video
   The icon used as an emblem for folders and media containing
   video content, such as video collection folders or video DVDs.

Open questions

  • Can additional (unspecified) emblems be added to the emblems/ directory? What happens if any given theme doesn't provide a requested emblem?