slitaz-forge annotate pkgs/icons/README @ rev 610

Add icons
author Lucas Levrel <llevrel@yahoo.fr>
date Tue Jan 19 22:09:42 2016 +0100 (2016-01-19)
parents d50b1e11ce39
children
rev   line source
al@603 1 Packages icons
al@603 2 --------------
al@603 3
al@603 4 In this folder you'll find icons displayed for packages in the TazPkg-web
al@603 5 interface available in http://pkgs.slitaz.org/
al@603 6
al@603 7 Rules for icon displaying:
al@603 8
al@603 9 1. Default icon is 'package-x-generic'. It will displayed if no other icon
al@603 10 is found.
al@603 11
al@603 12 2. Icon for all *-dev packages is 'dev' (alias for 'applications-development').
al@603 13
al@603 14 3. Icon for CLI-applications (Command-Line Interface) is 'cli' (alias for
al@603 15 'utilities-terminal'), special list exists here 'packages-cli.icons' with one
al@603 16 package name per line.
al@603 17
al@603 18 4. Icon for i18n (Internationalization) packages is 'i18n' (alias for
al@603 19 'preferences-desktop-locale'), special list exists here 'packages-i18n.icons'
al@603 20 with one package name per line.
llevrel@607 21 [note by Lucas Levrel:] See also: packages-font.icons packages-lib.icons
llevrel@607 22 packages-perl.icons packages-py.icons packages-thm.icons (themes)
llevrel@607 23 [edit by LL:] added: packages-doc.icons
al@603 24
al@603 25 5. List of icons settings/substitutions 'packages.icons' in format:
al@603 26 `<package name><tab><icon name (without '.png')>` per line. This list is
al@603 27 useful when package name and icon name not matched and we need to specify
al@603 28 icon name for package, as well as many packages used the same icon.
al@603 29
al@603 30 6. Icons files in the png format and symlinks to these icons.
al@603 31
al@603 32
al@603 33 How to add icons.
al@603 34
al@603 35 First, if icon exists in the Faenza icon theme, copy it from there.
al@603 36
al@603 37 Next, if you can't find icon in the Faenza, explore package source ('Cooker' ->
al@603 38 'browse' -> looking 'source', then 'install' folder in FTP-aware web-browser).
al@603 39 Icon name can match the package name or can be appended with '_32' or something
al@603 40 else, or can be named as 'logo' or something else. Please, select the best
al@603 41 matched icon to represent the package.
al@603 42
al@603 43 And, if you can't find icon here, use the internet search...
al@603 44
al@603 45 Ah, forget to mention: icon size is strictly 32x32 px in the png format! Please,
al@603 46 convert it to png from xpm or other format, as well as shrink or enlarge to
al@603 47 precise 32x32 px using mtPaint or GIMP.
al@603 48
al@603 49 Compress icon size using OptiPng (with extreme settings):
al@603 50
al@603 51 optipng -strip all -o7 -zm1-9 ./*.png
al@603 52
al@603 53
al@603 54 Final words.
al@603 55
al@603 56 Please, add icons ONLY for packages with GUI (Graphical User Interface)!
al@603 57
al@603 58 Add other packages names to the matched 'packages-*.icons' lists (for CLI, i18n,
al@603 59 etc.)
al@603 60
al@603 61 ================================================================================
al@603 62
al@603 63 Thanks,
al@603 64
al@603 65 Aleksej Bobylev <al.bobylev@gmail.com>
al@603 66 2015