aboutsummaryrefslogtreecommitdiff
path: root/icon-theme/README.md
diff options
context:
space:
mode:
authorKen Moore <moorekou@gmail.com>2016-03-16 09:43:54 -0400
committerKen Moore <moorekou@gmail.com>2016-03-16 09:43:54 -0400
commit51cf7c76e29677d19c29f0537eba635787168fca (patch)
tree23c198539aa5bdb4cd204e341ab24181bbdea444 /icon-theme/README.md
parentFinish cleaning up the index.theme file for the new lumina icon theme. (diff)
downloadlumina-51cf7c76e29677d19c29f0537eba635787168fca.tar.gz
lumina-51cf7c76e29677d19c29f0537eba635787168fca.tar.bz2
lumina-51cf7c76e29677d19c29f0537eba635787168fca.zip
Update README.md
Update icon theme details/specifications
Diffstat (limited to 'icon-theme/README.md')
-rw-r--r--icon-theme/README.md39
1 files changed, 26 insertions, 13 deletions
diff --git a/icon-theme/README.md b/icon-theme/README.md
index 62e6e2e6..6ff41e10 100644
--- a/icon-theme/README.md
+++ b/icon-theme/README.md
@@ -1,23 +1,36 @@
-Lumina Desktop default icon theme
+# Lumina Desktop Environment Icon Theme #
-Requirements
-1) White foreground (primarily), with black shadow/outline.
+## Requirements ##
+
+1. White foreground (primarily), with black shadow/outline.
The shadow/outline ensures that the icon will still be completely visible on a pure white background (allowing it to be used on any background color/type).
-2) Colors may be used (and are recommended) for additional icon overlays/additions as needed.
+2. Color may be used (and is recommended) to distinguish between similar-looking icons.
Example: the "folder.svg" icon is plain white/black, while the "folder-video.svg" icon will use the same base folder image, but might overlay a small colorized emblem somewhere on it.
-3) All icons need be to be svg formatted, with a base/default size of 128x128 and usable by the stock/generic SVG library .
+3. All icons need be to be svg formatted, with a base/default size of 128x128 and usable by the stock/generic SVG library .
Note: Adobe applications tend to use a customized version of the svg library, so make sure to verify the icon with some other SVG application such as inkscape.
-4) All icons will be licensed under the Creative Commons Attribution 4.0 International Public License.
+4. All icons will be licensed under the Creative Commons Attribution 4.0 International Public License.
https://creativecommons.org/licenses/by/4.0/legalcode
Basically, the icons can be used any anyone, anywhere, in anything, as long as the original author still gets attributed for his work. This license is comparable to the BSD license for source code.
+## Examples ##
+
+Sample icons to give the general idea (to be updated later as the first icons are submitted):
+
+* (shadowing) http://findicons.com/icon/80883/white18?id=81865
+* (General icon style) http://www.gentleface.com/free_icon_set.html
+
+This theme is intended to be high-contrast and function on high-resolution systems (4K+) with a more professional/streamlined appearance. The white foreground with black outline/shadowing will also permit the visibility of these icons on any background the user may utilize.
+
+## Contributing ##
+
+1. Icons which are still needed are listed in the TODO.txt files within each directory.
+2. Submit the icon file via git pull request
+3. Add an entry for your icon/submission to the AUTHORS file (to ensure each contributor gets proper credit for their work)
+4. Remove the icon from the appropriate TODO.txt file/list
-Sample icons to show kind of what I was thinking of:
-(shadowing) http://findicons.com/icon/80883/white18?id=81865
-(General icon style) http://www.gentleface.com/free_icon_set.html
+## Totals ##
-Total count:
-~1249 icons total
-~300 are mimetype icons (extremely low priority)
-Many icons are slight variations of each other (arrows pointing different directions, alternate colors/emblems, etc..) \ No newline at end of file
+* ~1249 icons total
+* ~300 are mimetype icons (low priority initially)
+* Many icons are slight variations of each other (arrows pointing different directions, alternate colors/emblems, etc..), so should be quite simple to submit icons in small groups (all single arrows, all double arrows, etc..)
bgstack15