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

Update to the current state of "mirror" and "pkgs"
author Aleksej Bobylev <al.bobylev@gmail.com>
date Sun Oct 25 06:47:13 2015 +0200 (2015-10-25)
parents
children 1d250e4f3640
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.
al@603 21
al@603 22 5. List of icons settings/substitutions 'packages.icons' in format:
al@603 23 `<package name><tab><icon name (without '.png')>` per line. This list is
al@603 24 useful when package name and icon name not matched and we need to specify
al@603 25 icon name for package, as well as many packages used the same icon.
al@603 26
al@603 27 6. Icons files in the png format and symlinks to these icons.
al@603 28
al@603 29
al@603 30 How to add icons.
al@603 31
al@603 32 First, if icon exists in the Faenza icon theme, copy it from there.
al@603 33
al@603 34 Next, if you can't find icon in the Faenza, explore package source ('Cooker' ->
al@603 35 'browse' -> looking 'source', then 'install' folder in FTP-aware web-browser).
al@603 36 Icon name can match the package name or can be appended with '_32' or something
al@603 37 else, or can be named as 'logo' or something else. Please, select the best
al@603 38 matched icon to represent the package.
al@603 39
al@603 40 And, if you can't find icon here, use the internet search...
al@603 41
al@603 42 Ah, forget to mention: icon size is strictly 32x32 px in the png format! Please,
al@603 43 convert it to png from xpm or other format, as well as shrink or enlarge to
al@603 44 precise 32x32 px using mtPaint or GIMP.
al@603 45
al@603 46 Compress icon size using OptiPng (with extreme settings):
al@603 47
al@603 48 optipng -strip all -o7 -zm1-9 ./*.png
al@603 49
al@603 50
al@603 51 Final words.
al@603 52
al@603 53 Please, add icons ONLY for packages with GUI (Graphical User Interface)!
al@603 54
al@603 55 Add other packages names to the matched 'packages-*.icons' lists (for CLI, i18n,
al@603 56 etc.)
al@603 57
al@603 58 ================================================================================
al@603 59
al@603 60 Thanks,
al@603 61
al@603 62 Aleksej Bobylev <al.bobylev@gmail.com>
al@603 63 2015