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