Font-Awesome/README.md

82 lines
3.5 KiB
Markdown
Raw Normal View History

2014-04-26 23:31:52 +08:00
#[Font Awesome v4.1.0](http://fontawesome.io)
2013-12-03 03:40:11 +08:00
###The iconic font and CSS framework
2014-05-15 04:09:18 +08:00
Font Awesome is a full suite of 439 pictographic icons for easy scalable vector graphics on websites, created and
2013-06-26 23:41:16 +08:00
maintained by [Dave Gandy](http://twitter.com/davegandy). Stay up to date [@fontawesome](http://twitter.com/fontawesome).
2013-05-11 06:43:34 +08:00
2013-05-11 06:51:35 +08:00
Get started at http://fontawesome.io!
##License
2013-05-11 06:27:25 +08:00
- The Font Awesome font is licensed under the SIL OFL 1.1:
2013-05-11 06:29:45 +08:00
- http://scripts.sil.org/OFL
2013-05-11 06:27:25 +08:00
- Font Awesome CSS, LESS, and SASS files are licensed under the MIT License:
2013-05-11 06:29:45 +08:00
- http://opensource.org/licenses/mit-license.html
2013-05-11 06:27:25 +08:00
- The Font Awesome documentation is licensed under the CC BY 3.0 License:
2013-05-11 06:29:45 +08:00
- http://creativecommons.org/licenses/by/3.0/
2013-05-11 06:27:25 +08:00
- Attribution is no longer required as of Font Awesome 3.0, but much appreciated:
2013-05-11 06:29:45 +08:00
- `Font Awesome by Dave Gandy - http://fontawesome.io`
2013-05-11 06:27:25 +08:00
- Full details: http://fontawesome.io/license
2013-01-18 01:25:51 +08:00
##Changelog
- v3.0.0 - all icons redesigned from scratch, optimized for Bootstrap's 14px default
2013-06-13 01:34:44 +08:00
- v3.0.1 - much improved rendering in webkit, various bug fixes
2013-01-18 01:25:51 +08:00
- v3.0.2 - much improved rendering and alignment in IE7
2013-05-10 23:50:33 +08:00
- v3.1.0 - Added 54 icons, icon stacking styles, flipping and rotating icons, removed SASS support
- [v3.1.1 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?milestone=4&page=1&state=closed)
2013-05-17 10:15:50 +08:00
- [v3.2.0 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?milestone=3&page=1&state=closed)
- [v3.2.1 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?milestone=5&page=1&state=closed)
- [v4.0.0 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?milestone=2&page=1&state=closed)
2013-10-25 03:03:50 +08:00
- [v4.0.1 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?milestone=7&page=1&state=closed)
2013-11-04 22:25:52 +08:00
- [v4.0.2 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?milestone=8&page=1&state=closed)
2013-11-05 17:08:11 +08:00
- [v4.0.3 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?milestone=9&page=1&state=closed)
2014-04-26 23:31:52 +08:00
- [v4.1.0 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?milestone=6&page=1&state=closed)
## Contributing
Please read through our [contributing guidelines](https://github.com/FortAwesome/Font-Awesome/blob/master/CONTRIBUTING.md). Included are directions for opening issues, coding standards, and notes on development.
##Versioning
Font Awesome will be maintained under the Semantic Versioning guidelines as much as possible. Releases will be numbered with the following format:
`<major>.<minor>.<patch>`
And constructed with the following guidelines:
* Breaking backward compatibility bumps the major (and resets the minor and patch)
* New additions, including new icons, without breaking backward compatibility bumps the minor (and resets the patch)
* Bug fixes and misc changes bumps the patch
2013-05-11 06:53:39 +08:00
For more information on SemVer, please visit http://semver.org.
2013-05-11 06:43:34 +08:00
##Author
- Email: dave@fontawesome.io
2013-06-26 23:41:16 +08:00
- Twitter: http://twitter.com/davegandy
2013-05-11 06:53:39 +08:00
- GitHub: https://github.com/davegandy
2013-05-11 06:43:34 +08:00
2013-06-22 07:05:06 +08:00
##Component
To include as a [component](http://github.com/component/component), just run
$ component install FortAwesome/Font-Awesome
Or add
"FortAwesome/Font-Awesome": "*"
to the `dependencies` in your `component.json`.
## Hacking on Font Awesome
From the root of the repository, install the tools used to develop.
$ bundle install
$ npm install
Build the project and documentation:
$ bundle exec jekyll build
Or serve it on a local server on http://localhost:7998/Font-Awesome/:
$ bundle exec jekyll serve