pop-icon-theme/src/scalable
Ian Santopietro d6828ec1ac fix: render icon changes 2023-06-13 15:04:07 -06:00
..
README.md docs(scalable): update docs for symbolic icons 2022-08-08 16:01:08 -06:00
extract-symbolic-icons.rb fix(render): add lots of SVG optimization 2022-04-13 16:40:00 -06:00
generate-symbolic-symlinks.sh fix: ensure system can load 2x icons on HiDPI 2022-03-10 13:02:27 -07:00
source-symbolic.svg fix: render icon changes 2023-06-13 15:04:07 -06:00

README.md

Symbolic Icons Source

  • To add or modify an symbolic icon, edit source SVG file found in this directory
  • For simplified development, has various scripts to extract or render icons from the larger SVG source files.
  • To edit the icons you will need inkscape and you'll need ruby installed to run the render script.

source-symbolic.svg - the source files that contains all of the symbolic icons

  • Each layer in this source file corresponds to a icon context and the icons are sorted accordingly
  • Each icon should be drawn within an 16x16 pixel square and use only 1 colour
  • When complete, group all elements within a 16x16 rectangle (with no stroke and #888888 fill at 1% opacity for later modification) and label that group with the icon-name (less the -symbolic suffix).

extract-symbolic-icons.rb - the render script

  • The recommended way to render modified icons is to delete the output file and re-render using the master-render.py script. Alternatively:
  • Extract any new symbolic icons from the source SVG by passing the icon name to this script: ./extract-symbolic-icons.rb <icon-name>
  • Or, if run generally, this script will look through the entire source file to render any new icons (if a new icon does not have a correct label the script will fail)