[adwaita-icon-theme] README: try to make gitlab show the graphic



commit 96a1afc495818c9a5ce8dcd639f8e7337166ef7c
Author: Jakub Steiner <jimmac gmail com>
Date:   Tue Dec 8 21:23:56 2020 +0100

    README: try to make gitlab show the graphic

 README.md                       | 63 +++++++++++++----------------------------
 src/symbolic/gnome-stencils.svg | 21 ++++++++++++++
 2 files changed, 40 insertions(+), 44 deletions(-)
---
diff --git a/README.md b/README.md
index a5f1298a0..2dd43700f 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,5 @@
 # Adwaita Icon Theme
-
+![Adwaita Icons](src/logo.svg)
 
 ## Bugs and Requests
 If you're a core GNOME application maintainer and you have an icon need that bridges multiple components or 
apps, feel free to file a request in the [issue 
tracker](https://gitlab.gnome.org/GNOME/adwaita-icon-theme/-/issues). If you're an application developer, 
file a request against the [Icon Development 
Kit](https://gitlab.gnome.org/Teams/Design/icon-development-kit/-/issues) instead.
@@ -12,47 +12,22 @@ For an up to date guide on how to use and how to design GNOME style icons, see t
 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).
 
 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`…)
-lives inside an Inkscape layer (group).  Any group inside that layer
+`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
-`gnome/scalable/<context>/<inkscape:label>-symbolic.svg` of the
-group. This export is handled by using Inkscape's verbs, which means
-it will pop up Inkscape GUI at you and will take ages.
-
-The best way to assure your icon will be precisely 16x16, 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. 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.
-
-Note that the export script in `gnome-icon-theme-symbolic` will convert
-strokes to paths, so you will need to do this manually (Path -> Stroke
-to Path in inkscape) if you ship an icon outside of
-`gnome-icon-theme-symbolic`.
-
-If you need colorize specific part of an icon you need to set a class
-of that object. In inkscape 0.47 this is sadly only achievable by
-selecting the object, going into the xml editor and creating a new
-attribute 'class' and setting its value. There are currently 3
-possible values:
-
-- warning - this maps to gtk `@warning_color`
-- error - maps to `@error_color`
-- success - maps to `@success_color`
-
-[1]: https://gitlab.gnome.org/GNOME/adwaita-icon-theme/issues
\ No newline at end of file
+`Adwaita/scalable/<context>/<inkscape:label>-symbolic.svg` of the group. Notice the export *size* is 
`scalable` rather than `symbolic` for legacy reasons. 
+
+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*).
+
+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`
+- `success` - maps to `@success_color`
\ No newline at end of file
diff --git a/src/symbolic/gnome-stencils.svg b/src/symbolic/gnome-stencils.svg
index 06325ec3b..3f9176f00 100644
--- a/src/symbolic/gnome-stencils.svg
+++ b/src/symbolic/gnome-stencils.svg
@@ -8592,6 +8592,27 @@
          d="m 30.99975,287 h 1.375 l 1.125,1.09375 L 34.5935,287 h 1.40625 v 1.46875 l -1.09375,1.0625 
1.09375,1.0625 V 292 h -1.4375 l -1.0625,-1.0625 -1.0625,1.0625 h -1.4375 v -1.40625 l 1.0625,-1.0625 
-1.0625,-1.0625 z"
          
style="color:#bebebe;display:inline;overflow:visible;visibility:visible;fill:#2e3436;fill-opacity:1;stroke:none;stroke-width:2;marker:none;enable-background:new"
 />
     </g>
+    <g
+       transform="translate(260)"
+       id="g3337"
+       inkscape:label="night-light-disabled">
+      <path
+         id="path3331"
+         
style="color:#000000;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:medium;line-height:normal;font-family:sans-serif;font-variant-ligatures:normal;font-variant-position:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-alternates:normal;font-feature-settings:normal;text-indent:0;text-align:start;text-decoration:none;text-decoration-line:none;text-decoration-style:solid;text-decoration-color:#000000;letter-spacing:normal;word-spacing:normal;text-transform:none;writing-mode:lr-tb;direction:ltr;text-orientation:mixed;dominant-baseline:auto;baseline-shift:baseline;text-anchor:start;white-space:normal;shape-padding:0;clip-rule:nonzero;display:inline;overflow:visible;visibility:visible;opacity:1;isolation:auto;mix-blend-mode:normal;color-interpolation:sRGB;color-interpolation-filters:linearRGB;solid-color:#000000;solid-opacity:1;vector-effect:none;fill:#2e3436;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:
 
2;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:56;stroke-opacity:1;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto;enable-background:accumulate"
+         d="M 200 175 C 197.25042 175 195 177.25042 195 180 C 195 182.74958 197.25042 185 200 185 C 
202.74958 185 205 182.74958 205 180 C 205 177.25042 202.74958 175 200 175 z M 197 177 L 199 177 L 199 183 L 
197 183 L 197 177 z M 201 177 L 203 177 L 203 183 L 201 183 L 201 177 z "
+         transform="translate(-260,-64)" />
+      <rect
+         
style="color:#bebebe;display:inline;overflow:visible;visibility:visible;fill:none;stroke:none;stroke-width:2;marker:none"
+         id="rect3333"
+         width="16"
+         height="16"
+         x="-68.000259"
+         y="108" />
+      <path
+         id="path3335"
+         
style="opacity:1;fill:#2e3436;fill-opacity:0.35;stroke:none;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:56;stroke-opacity:1"
+         d="M -60.500259,121.99414 H -59.5 c 0.277,0 0.5,0.223 0.5,0.5 V 123.5 c 0,0.277 -0.223,0.5 -0.5,0.5 
h -1.000259 c -0.277,0 -0.5,-0.223 -0.5,-0.5 v -1.00586 c 0,-0.277 0.223,-0.5 0.5,-0.5 z m 6.502678,-5.50122 
v -0.99414 c 0,-0.277 0.223,-0.5 0.5,-0.5 h 1.000259 c 0.277,0 0.5,0.223 0.5,0.5 v 0.99414 c 0,0.277 
-0.223,0.5 -0.5,0.5 h -1.000259 c -0.277,0 -0.5,-0.223 -0.5,-0.5 z m -13.999741,0.006 v -1.00586 c 0,-0.277 
0.223,-0.5 0.5,-0.5 h 0.999741 c 0.277,0 0.5,0.223 0.5,0.5 v 1.00586 c 0,0.277 -0.223,0.5 -0.5,0.5 h 
-0.999741 c -0.277,0 -0.5,-0.223 -0.5,-0.5 z m 11.890121,4.09309 0.702964,-0.70296 c 0.195868,-0.19587 
0.511238,-0.19587 0.707106,0 l 0.70729,0.70729 c 0.195869,0.19586 0.195869,0.51123 0,0.7071 l 
-0.702963,0.70297 c -0.195868,0.19586 -0.511238,0.19586 -0.707107,0 l -0.70729,-0.70729 c -0.195868,-0.19587 
-0.195868,-0.51124 0,-0.70711 z m -9.903455,-9.89517 0.71125,-0.71125 c 0.195869,-0.19587 0.511239,-0.19587 
0.707107,0 l 0.706924,0.70692 c 0.195868,0.19587 0.1958
 68,0.51124 0,0.70711 l -0.711251,0.71125 c -0.195868,0.19587 -0.511238,0.19587 -0.707106,0 l 
-0.706924,-0.70692 c -0.195869,-0.19587 -0.195869,-0.51124 0,-0.70711 z m 1.416456,9.19135 0.702963,0.70296 c 
0.195868,0.19587 0.195868,0.51124 0,0.70711 l -0.707291,0.70729 c -0.195868,0.19587 -0.511238,0.19587 
-0.707106,0 l -0.702964,-0.70296 c -0.195868,-0.19587 -0.195868,-0.51124 0,-0.70711 l 0.707291,-0.70729 c 
0.195869,-0.19587 0.511238,-0.19587 0.707107,0 z m 9.895167,-9.90345 0.711251,0.71125 c 0.195868,0.19586 
0.195868,0.51123 0,0.7071 l -0.706923,0.70693 c -0.195869,0.19586 -0.511238,0.19586 -0.707107,0 l 
-0.71125,-0.71126 c -0.195869,-0.19586 -0.195869,-0.51123 0,-0.7071 l 0.706922,-0.70692 c 0.195869,-0.19587 
0.511239,-0.19587 0.707107,0 z m -5.801226,-1.99046 H -59.5 c 0.277,0 0.5,0.223 0.5,0.5 V 109.5 c 0,0.277 
-0.223,0.5 -0.5,0.5 h -1.000259 c -0.277,0 -0.5,-0.223 -0.5,-0.5 v -1.00586 c 0,-0.277 0.223,-0.5 0.5,-0.5 z" 
/>
+    </g>
   </g>
   <g
      inkscape:groupmode="layer"


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]