2015-03-18 16:42:37 +00:00
|
|
|
#[Font Awesome v4.3.1](http://fontawesome.io)
|
2013-12-02 19:40:11 +00:00
|
|
|
###The iconic font and CSS framework
|
2012-03-07 03:36:13 +00:00
|
|
|
|
2015-01-21 21:47:00 +00:00
|
|
|
Font Awesome is a full suite of 519 pictographic icons for easy scalable vector graphics on websites,
|
2014-08-20 15:31:43 +00:00
|
|
|
created and maintained by [Dave Gandy](http://twitter.com/davegandy).
|
2015-01-22 17:19:15 +00:00
|
|
|
Stay up to date with the latest release and announcements on Twitter:
|
|
|
|
[@fontawesome](http://twitter.com/fontawesome).
|
2013-05-10 22:43:34 +00:00
|
|
|
|
2013-05-10 22:51:35 +00:00
|
|
|
Get started at http://fontawesome.io!
|
2012-03-07 03:36:13 +00:00
|
|
|
|
2013-01-02 02:37:41 +00:00
|
|
|
##License
|
2013-05-10 22:27:25 +00:00
|
|
|
- The Font Awesome font is licensed under the SIL OFL 1.1:
|
2013-05-10 22:29:45 +00:00
|
|
|
- http://scripts.sil.org/OFL
|
2014-12-28 14:16:08 +00:00
|
|
|
- Font Awesome CSS, LESS, and Sass files are licensed under the MIT License:
|
2013-05-10 22:29:45 +00:00
|
|
|
- http://opensource.org/licenses/mit-license.html
|
2013-05-10 22:27:25 +00:00
|
|
|
- The Font Awesome documentation is licensed under the CC BY 3.0 License:
|
2013-05-10 22:29:45 +00:00
|
|
|
- http://creativecommons.org/licenses/by/3.0/
|
2013-05-10 22:27:25 +00:00
|
|
|
- Attribution is no longer required as of Font Awesome 3.0, but much appreciated:
|
2013-05-10 22:29:45 +00:00
|
|
|
- `Font Awesome by Dave Gandy - http://fontawesome.io`
|
2013-05-10 22:27:25 +00:00
|
|
|
- Full details: http://fontawesome.io/license
|
2013-01-02 02:37:41 +00:00
|
|
|
|
2013-01-17 17:25:51 +00:00
|
|
|
##Changelog
|
|
|
|
- v3.0.0 - all icons redesigned from scratch, optimized for Bootstrap's 14px default
|
2013-06-12 17:34:44 +00:00
|
|
|
- v3.0.1 - much improved rendering in webkit, various bug fixes
|
2013-01-17 17:25:51 +00:00
|
|
|
- v3.0.2 - much improved rendering and alignment in IE7
|
2014-12-28 14:16:08 +00:00
|
|
|
- v3.1.0 - Added 54 icons, icon stacking styles, flipping and rotating icons, removed Sass support
|
2013-05-10 23:08:01 +00:00
|
|
|
- [v3.1.1 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?milestone=4&page=1&state=closed)
|
2013-05-17 02:15:50 +00:00
|
|
|
- [v3.2.0 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?milestone=3&page=1&state=closed)
|
2013-06-14 20:39:10 +00:00
|
|
|
- [v3.2.1 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?milestone=5&page=1&state=closed)
|
2013-10-23 14:42:27 +00:00
|
|
|
- [v4.0.0 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?milestone=2&page=1&state=closed)
|
2013-10-24 19:03:50 +00:00
|
|
|
- [v4.0.1 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?milestone=7&page=1&state=closed)
|
2013-11-04 14:25:52 +00:00
|
|
|
- [v4.0.2 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?milestone=8&page=1&state=closed)
|
2013-11-05 09:08:11 +00:00
|
|
|
- [v4.0.3 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?milestone=9&page=1&state=closed)
|
2014-04-26 15:31:52 +00:00
|
|
|
- [v4.1.0 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?milestone=6&page=1&state=closed)
|
2014-08-20 15:31:43 +00:00
|
|
|
- [v4.2.0 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?milestone=12&page=1&state=closed)
|
2014-12-28 14:16:08 +00:00
|
|
|
- [v4.3.0 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?q=milestone%3A4.3.0+is%3Aclosed)
|
2015-03-18 16:53:53 +00:00
|
|
|
- [v4.3.1 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?q=milestone%3A4.3.1+is%3Aclosed)
|
2013-11-27 16:02:09 +00:00
|
|
|
|
|
|
|
## Contributing
|
|
|
|
|
2014-08-20 15:31:43 +00:00
|
|
|
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.
|
2013-05-09 03:28:34 +00:00
|
|
|
|
|
|
|
##Versioning
|
|
|
|
|
2014-08-20 15:31:43 +00:00
|
|
|
Font Awesome will be maintained under the Semantic Versioning guidelines as much as possible. Releases will be numbered
|
|
|
|
with the following format:
|
2013-05-09 03:28:34 +00:00
|
|
|
|
|
|
|
`<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-10 22:53:39 +00:00
|
|
|
For more information on SemVer, please visit http://semver.org.
|
2013-05-10 22:43:34 +00:00
|
|
|
|
|
|
|
##Author
|
|
|
|
- Email: dave@fontawesome.io
|
2013-06-26 15:41:16 +00:00
|
|
|
- Twitter: http://twitter.com/davegandy
|
2013-05-10 22:53:39 +00:00
|
|
|
- GitHub: https://github.com/davegandy
|
2013-05-10 22:43:34 +00:00
|
|
|
|
2013-06-21 23:05:06 +00: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`.
|
|
|
|
|
2013-05-23 13:04:02 +00:00
|
|
|
## Hacking on Font Awesome
|
|
|
|
|
2015-06-11 18:32:35 +00:00
|
|
|
**Before you can build the project**, you must first have the following installed:
|
|
|
|
|
|
|
|
- [Ruby](https://www.ruby-lang.org/en/)
|
|
|
|
- Ruby Development Headers
|
|
|
|
- **Ubuntu:** `sudo apt-get install ruby-dev` *(Only if you're __NOT__ using `rbenv` or `rvm`)*
|
|
|
|
- **Windows:** [DevKit](http://rubyinstaller.org/)
|
|
|
|
- [Bundler](http://bundler.io/) (Run `gem install bundler` to install).
|
|
|
|
- [Node Package Manager (AKA NPM)](https://docs.npmjs.com/getting-started/installing-node)
|
|
|
|
- [Less](http://lesscss.org/) (Run `npm install -g less` to install).
|
|
|
|
- [Less Plugin: Clean CSS](https://github.com/less/less-plugin-clean-css) (Run `npm install -g less-plugin-clean-css` to install).
|
|
|
|
|
2013-05-23 13:04:02 +00:00
|
|
|
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/:
|
|
|
|
|
2015-01-22 17:19:15 +00:00
|
|
|
$ bundle exec jekyll -w serve
|