UNPKG

2.86 kBMarkdownView Raw
1PatternFlyIcons font is generated using [IcoMoon](http://icomoon.io/app).
2
3Go to [Manage Projects](https://icomoon.io/app/#/projects)
4
5![image](https://cloud.githubusercontent.com/assets/12733153/15152985/71b8c62a-16a5-11e6-9d3c-d01be57f3c54.png)
6
7Import the project `PatternFlyIcons-webfont.json` and Load it:
8
9![image](https://cloud.githubusercontent.com/assets/12733153/15152997/83795582-16a5-11e6-9b64-370884453684.png)
10
11After the Load you should see the “PatternFlyIcons - webfont” set above the “IcoMoon - Free” set. Note that all icons in PatternFlyIcons are selected AND several icons in the IcoMoon set are also selected -keep those selections!
12
13To add new icons to the PatternFlyIcons set, click on the right-hand kabob menu and select “Import To Set”. Import the new icons/svgs/pngs:
14
15![image](https://cloud.githubusercontent.com/assets/12733153/15153017/9411521e-16a5-11e6-9a70-e37e73c16734.png)
16
17Make sure you select the new icons in the set (click on them to give them a yellow selection border).
18
19Generate the fonts by clicking on the “Generate Font” button at the bottom of any IcoMoon webpage:
20
21![image](https://cloud.githubusercontent.com/assets/12733153/15153037/a676306e-16a5-11e6-8759-03845f0793c3.png)
22
23At the bottom of the “Generate Font” page, click on the “Download” button. This will download a zip file which you should expand. Goto where you expanded the downloaded zip file and copy the 4 font files in the “font” directory (PatternFlyIcons-webfont.eot, .svg, .ttf, .woff) to the patternfly repo under “dist/fonts”.
24
25When finished, return to Manage Projects, and download the updated PatternFlyIcons-webfont.json file to the root of patternfly repo.
26
27Next update the PatternFly icon test page.
28
29To start this process update “less/variables.less” add new variables with the “content” values for the new icons.
30
31 Ex: @pficon-var-blueprint: "\e915";)
32
33To see the content values for the PF icons click on the demo.html in the root dir of where you expanded the pf icon zip file.
34
35Next, update "less/icons.less" and add new LESS to denote the new icons.
36
37 Ex:
38 @{icon-prefix}-blueprint:before {
39 content: @pficon-var-blueprint;
40 }
41
42Finally, update "tests-src/icons.html" to include the new icons.
43
44 Ex:
45 <li>
46 <span class="pficon pficon-blueprint"></span>
47 <span class="icon-class">pficon-blueprint</span>
48 </li>
49
50Do a ‘grunt build’ and ‘grunt server’ and review the Icons test page to verify the new icons render correctly.
51
52Create a PR with the updated PatternFlyIcons-webfont.json file, the updated LESS files, the test-src file, and the generated font files under patternfly/dist/css and patternfly/dist/fonts.
53
54An example of a patternfly icon/font update PR is: https://github.com/patternfly/patternfly/pull/278