SliTaz Repositories

     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/pkgs/icons/README	Sun Oct 25 06:47:13 2015 +0200
     1.3 @@ -0,0 +1,63 @@
     1.4 +Packages icons
     1.5 +--------------
     1.6 +
     1.7 +In this folder you'll find icons displayed for packages in the TazPkg-web
     1.8 +interface available in http://pkgs.slitaz.org/
     1.9 +
    1.10 +Rules for icon displaying:
    1.11 +
    1.12 +  1. Default icon is 'package-x-generic'. It will displayed if no other icon
    1.13 +     is found.
    1.14 +
    1.15 +  2. Icon for all *-dev packages is 'dev' (alias for 'applications-development').
    1.16 +
    1.17 +  3. Icon for CLI-applications (Command-Line Interface) is 'cli' (alias for
    1.18 +     'utilities-terminal'), special list exists here 'packages-cli.icons' with one
    1.19 +     package name per line.
    1.20 +
    1.21 +  4. Icon for i18n (Internationalization) packages is 'i18n' (alias for
    1.22 +     'preferences-desktop-locale'), special list exists here 'packages-i18n.icons'
    1.23 +     with one package name per line.
    1.24 +
    1.25 +  5. List of icons settings/substitutions 'packages.icons' in format:
    1.26 +     `<package name><tab><icon name (without '.png')>` per line. This list is
    1.27 +     useful when package name and icon name not matched and we need to specify
    1.28 +     icon name for package, as well as many packages used the same icon.
    1.29 +
    1.30 +  6. Icons files in the png format and symlinks to these icons.
    1.31 +
    1.32 +
    1.33 +How to add icons.
    1.34 +
    1.35 +First, if icon exists in the Faenza icon theme, copy it from there.
    1.36 +
    1.37 +Next, if you can't find icon in the Faenza, explore package source ('Cooker' ->
    1.38 +'browse' -> looking 'source', then 'install' folder in FTP-aware web-browser).
    1.39 +Icon name can match the package name or can be appended with '_32' or something
    1.40 +else, or can be named as 'logo' or something else. Please, select the best
    1.41 +matched icon to represent the package.
    1.42 +
    1.43 +And, if you can't find icon here, use the internet search...
    1.44 +
    1.45 +Ah, forget to mention: icon size is strictly 32x32 px in the png format! Please,
    1.46 +convert it to png from xpm or other format, as well as shrink or enlarge to
    1.47 +precise 32x32 px using mtPaint or GIMP.
    1.48 +
    1.49 +Compress icon size using OptiPng (with extreme settings):
    1.50 +
    1.51 +    optipng -strip all -o7 -zm1-9 ./*.png
    1.52 +
    1.53 +
    1.54 +Final words.
    1.55 +
    1.56 +Please, add icons ONLY for packages with GUI (Graphical User Interface)!
    1.57 +
    1.58 +Add other packages names to the matched 'packages-*.icons' lists (for CLI, i18n,
    1.59 +etc.)
    1.60 +
    1.61 +================================================================================
    1.62 +
    1.63 +Thanks,
    1.64 +
    1.65 +Aleksej Bobylev <al.bobylev@gmail.com>
    1.66 +2015