summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorJakub Steiner <jimmac@gmail.com>2021-06-29 12:05:15 +0200
committerJakub Steiner <jimmac@gmail.com>2021-06-29 12:05:15 +0200
commitff49f73f220a70afe1a7ab5d5f043ff71dcc2f98 (patch)
treeaf64803fc7c4f2c9b143ee4865dbe4adca9ad08c /README.md
parent1411b705f048bbd5ccfed56795b9392cc24c1036 (diff)
downloadadwaita-icon-theme-ff49f73f220a70afe1a7ab5d5f043ff71dcc2f98.tar.gz
symbolic: use Symbolic Preview workflow
- new sheet in src/symbolic/core.svg to be used by Symbolic Preview - updated instruction in README.md - exports to actions (see #73) - gnome-stecils only kept for easier porting
Diffstat (limited to 'README.md')
-rw-r--r--README.md13
1 files changed, 4 insertions, 9 deletions
diff --git a/README.md b/README.md
index 2dd43700f..d91bb3366 100644
--- a/README.md
+++ b/README.md
@@ -9,24 +9,19 @@ If you're a core GNOME application maintainer and you have an icon need that bri
For an up to date guide on how to use and how to design GNOME style icons, see the [GNOME User Interface Guidelines](https://developer.gnome.org/hig/stable/icons-and-artwork.html.en).
## Building and Contributing to Adwaita
-If you have experience designing symbolic icons for 3rd party GNOME apps and would like to help maintaining `adwaita-icon-theme`, here's a few tips on how to get going and how it differs from the [Devkit](https://gitlab.gnome.org/Teams/Design/icon-development-kit).
+Symbolic icons are no longer maintained using hand rolled ruby script and inkscape to render them out, but instead shares the same workflow as 3rd party symbolics, the icon [Devkit](https://gitlab.gnome.org/Teams/Design/icon-development-kit).
-Just like larger assets in the [Icon Devkit](https://gitlab.gnome.org/Teams/Design/icon-development-kit) or apps relying on [Symbolic Preview](https://gitlab.gnome.org/World/design/symbolic-preview), the set is maintained in a single SVG,
-`src/gnome-stencils.svg`. There are many similarities. The icons are grouped in inkscape layes per icon context (`apps`, `actions`, `mimetypes`…). Any group inside that layer
-is treated as an icon and will be exported into the
-`Adwaita/scalable/<context>/<inkscape:label>-symbolic.svg` of the group. Notice the export *size* is `scalable` rather than `symbolic` for legacy reasons.
+While many legacy symbolics only live as the exported individual SVGS in `Adwaita/scalable/`, the new additions and replacements are maintained in `src/symbolic/core.svg`. The contexts are [no longer used](https://gitlab.gnome.org/GNOME/adwaita-icon-theme/-/issues/73) and all icons go into `actions`. Please refer to the [Devkit guidelines]() on how to structure the metadata.
-The best way to assure your icon will be precisely 16x16px, is to
-include a blank rectangle in the group. This rectangle, as long as it is 16 pixels wide and high, will be removed by the crop script. To name the group, open up the object properties dialog (`Ctrl+Shfit+O`) and use the `label` field. This, again, i different to devkit, where every icon needs a `title` instead. Do not add the `-symbolic` suffix there, that will be done by the script. Also, don't nest groups too much inside the main one. The script will only convert outlines properly down to two subgroups.
### Recoloring
The color of the icon set is defined at runtime by the gtk theme. Every single icon from the set is actually embedded inside an xml container that has a stylesheet overriding the colors.
There is a couple of things the icon author needs to be aware of and a few things s/he can make use of. The stylesheet is setting the color of the fill for all rectangles and paths. **DO NOT** leave any rectangles or paths with no fill/stroke thinking it's invisible.
-While the script is set to convert strokes to paths, you might be safer to do this manually (`Path -> Stroke to Path` in *Inkscape*).
+Symblic Preview doesn't convert strokes to paths yet, so you need to do it manually for now in Inkscape (`Path -> Stroke to Path`).
-gtk doesn't care about the colors you define for the icon. They are recolored at runtime. If you need portions of icons to have a color, you need to include a `class` attribute to the shape or group and set it to one of the three values below.
+Gtk doesn't care about the colors you define for the icon. They are recolored at runtime. If you need portions of icons to have a color, you need to include a `class` attribute to the shape or group and set it to one of the three values below.
- `warning` - this maps to gtk `@warning_color`
- `error` - maps to `@error_color`