From aefdb9e1fc93dcdb0dd05e9fa297b8b92484de1e Mon Sep 17 00:00:00 2001 From: Aaron Shekey Date: Mon, 6 Jun 2016 13:26:26 -0500 Subject: [PATCH 1/2] Add some documentation --- README.md | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index d98ea0735..ef4b4b9c7 100644 --- a/README.md +++ b/README.md @@ -24,9 +24,22 @@ The source files included are written in [Sass][sass] (`scss`) You can simply po @import "octicons/index.scss"; ``` -## Documentation +## Changing, adding, or deleting icons +1. Open the [Sketch document][sketch-document] in `/lib/`. Each icon exists as an artboard within our master Sketch document. If you’re adding an icon, duplicate one of the artboards and add your shapes to it. Be sure to give your artboard a name that makes sense. +2. Once you’re happy with your icon set, choose File > Export… +3. Choose all the artboards you'd like to export and then press “Export” +4. Export to `/lib/svg/` +You’ll next need to build your Octicons. + +## Building Octicons + +All the files you need will be in the `/build/` directory already, but if you’ve made changes to the `/lib/` directory and need to regenerate, follow these steps: + +1. Open the Octicons directory in Terminal +2. Run the command `script/bootstrap`. This will install any necessary dependencies for generating the Octicons font and SVGs. +3. Run the command `grunt`. Running the grunt task will generate the font and SVGs, placing them in the `/build/` directory. ## License @@ -39,3 +52,4 @@ _Font License:_ [SIL OFL 1.1](./LICENSE) © [GitHub](https://github.com/) [npm]: https://www.npmjs.com/ [install-npm]: https://docs.npmjs.com/getting-started/installing-node [sass]: http://sass-lang.com/ +[sketch-document]: https://github.com/primer/octicons/blob/master/lib/octicons-master.sketch From 751cccb4ce47389004ebc361026240595993fc4a Mon Sep 17 00:00:00 2001 From: Jon Rohan Date: Mon, 6 Jun 2016 14:34:42 -0400 Subject: [PATCH 2/2] Adding changes to changelog --- CHANGELOG.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 8278bcece..c011fe51a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,12 @@ Adds: +- Installation docs https://github.com/primer/octicons/pull/94 + +### 4.0.0 (June 6, 2016) + +Adds: + - Whole new grunt build system including svg sprite sheet. - adding css min https://github.com/primer/octicons/pull/60 - adding woff2 format https://github.com/primer/octicons/issues/3