mirror of https://github.com/GNOME/gimp.git
devel-docs: make the icons docs into markdown.
Better for links. Maybe we'll play with images this way too.
This commit is contained in:
parent
48d6699af3
commit
097e09f60c
|
@ -238,7 +238,7 @@ We also welcome design updates as a whole (anyone willing to work on
|
||||||
this should discuss with us and propose something) and obviously fixes
|
this should discuss with us and propose something) and obviously fixes
|
||||||
on existing icons or adding missing icons.
|
on existing icons or adding missing icons.
|
||||||
|
|
||||||
See the dedicated [icons.txt](icons.txt) document for more technical
|
See the dedicated [icons documentation](icons.md) for more technical
|
||||||
information.
|
information.
|
||||||
|
|
||||||
### Tool presets
|
### Tool presets
|
||||||
|
|
|
@ -8,21 +8,22 @@ Released Themes
|
||||||
|
|
||||||
GIMP 3.0 comes with 3 icon themes:
|
GIMP 3.0 comes with 3 icon themes:
|
||||||
|
|
||||||
(1) Symbolic: the default icon theme which is vector and which will be
|
1. **Symbolic**: the default icon theme which is vector and which will
|
||||||
automatically recolored to your theme colors.
|
be automatically recolored to your theme colors.
|
||||||
|
|
||||||
We follow GNOME guidelines when possible:
|
We follow [GNOME
|
||||||
https://developer.gnome.org/hig/guidelines/ui-icons.html
|
guidelines](https://developer.gnome.org/hig/guidelines/ui-icons.html)
|
||||||
|
when possible.
|
||||||
|
|
||||||
(2) Color: the color icon theme, also designed with vector graphics, yet
|
2. **Color**: the color icon theme, also designed with vector graphics,
|
||||||
it won't be recolored.
|
yet it won't be recolored.
|
||||||
|
|
||||||
(3) Legacy: icon theme which contains the old GIMP 2.8's raster icons.
|
3. **Legacy**: icon theme which contains the old GIMP 2.8's raster
|
||||||
It is not maintained anymore and we are not expecting new icons for
|
icons. It is not maintained anymore and we are not expecting new
|
||||||
Legacy. Yet since we keep them in the source tree for now, we would
|
icons for Legacy. Yet since we keep them in the source tree for now,
|
||||||
accept updates.
|
we would accept updates.
|
||||||
|
|
||||||
The Symbolic icon theme are our main target since they are considered
|
The Symbolic icon theme is our main target since they are considered
|
||||||
better suited for graphics work (less visual distraction). Color icons
|
better suited for graphics work (less visual distraction). Color icons
|
||||||
are kept as fall-back since some users prefer them.
|
are kept as fall-back since some users prefer them.
|
||||||
|
|
||||||
|
@ -31,11 +32,13 @@ Adding new icons
|
||||||
----------------
|
----------------
|
||||||
|
|
||||||
- Add new icons in the single SVG file inside their respective
|
- Add new icons in the single SVG file inside their respective
|
||||||
directories, i.e. `icons/Symbolic/symbolic-scalable.svg` for symbolic
|
directories, i.e.
|
||||||
icons and `icons/Color/color-scalable.svg` for color icons.
|
[symbolic-scalable.svg](/icons/Symbolic/symbolic-scalable.svg) for
|
||||||
|
symbolic icons and
|
||||||
|
[color-scalable.svg](icons/Color/color-scalable.svg) for color icons.
|
||||||
|
|
||||||
A single file allows easier reuse of material, and easy overview of all
|
A single file allows easier reuse of material, and easy overview of
|
||||||
existing icons which simplifies consistent styling…
|
all existing icons which simplifies consistent styling…
|
||||||
|
|
||||||
- The contents of the SVG file should be organized for easy management
|
- The contents of the SVG file should be organized for easy management
|
||||||
and easy contribution. You can visually group similar icons, make use
|
and easy contribution. You can visually group similar icons, make use
|
||||||
|
@ -48,7 +51,7 @@ the Move Tool icon should be id-ed: "gimp-tool-move".
|
||||||
- Make sure the object has the right expected size. A good trick is to
|
- Make sure the object has the right expected size. A good trick is to
|
||||||
group with a square of the right size, made invisible.
|
group with a square of the right size, made invisible.
|
||||||
|
|
||||||
- Export the icon as PNG and SVG into the appropriate size directory.
|
- Export the icon as SVG into the `scalable/` directory.
|
||||||
|
|
||||||
Ideally this step should be done at build time, but we could not find
|
Ideally this step should be done at build time, but we could not find
|
||||||
yet a reliable way to extract icons out of the single SVG file without
|
yet a reliable way to extract icons out of the single SVG file without
|
||||||
|
@ -61,9 +64,11 @@ not mandatory anymore.
|
||||||
|
|
||||||
- Add the icons in relevant listing files in `icons/icon-lists/` then
|
- Add the icons in relevant listing files in `icons/icon-lists/` then
|
||||||
run `tools/generate-icon-makefiles.py` which will regenerate files for
|
run `tools/generate-icon-makefiles.py` which will regenerate files for
|
||||||
the autotools build integrating your new icons. The meson build also
|
the autotools build integrating your new icons and `touch` the
|
||||||
use the same listing files so you only have to add your icon names in
|
`meson.build` files to make sure the next build will trigger a
|
||||||
the right categories and you are done.
|
reconfiguration. The meson build indeed also uses the same listing
|
||||||
|
files so you only have to add your icon names in the right categories,
|
||||||
|
run the script and you are done.
|
||||||
|
|
||||||
|
|
||||||
Pixel perfection
|
Pixel perfection
|
Loading…
Reference in New Issue