Fork-Awesome/README.md

104 lines
5.5 KiB
Markdown
Raw Normal View History

# Fork Awesome
### A fork of the iconic font and CSS framework
Fork Awesome is a full suite of 677 pictographic icons for easy scalable vector graphics on websites, originally created by [Dave Gandy](https://twitter.com/davegandy) and now maintained by a community.
2013-05-11 00:43:34 +02:00
Following concerns regarding [the development of Font Awesome](https://github.com/FortAwesome/Font-Awesome/issues/12199#issuecomment-362919956), the PR Freeze since Oct 2016 and the direction Fort Awesome is taking with the version 5.0 of their project, we are forking Font Awesome (4.7), in order to build on this incredible tool Dave Gandy has given us, while at the same time allowing this project to be run by a distributed community of contributors.
A tremendous gratitude is given to the whole team behind [Font Awesome](https://fontawesome.io), and you are encouraged to support them and buy Font Awesome Pro for your project.
This fork is still in its very early stage of development. Though If you wish to be part of the adventure, please start submitting patches.
## License
- The Fork Awesome font is licensed under the SIL OFL 1.1:
2013-05-11 00:29:45 +02:00
- http://scripts.sil.org/OFL
- Fork Awesome CSS, LESS, and Sass files are licensed under the MIT License:
2016-02-15 19:20:22 +01:00
- https://opensource.org/licenses/mit-license.html
- The Fork Awesome documentation is licensed under the CC BY 3.0 License:
2017-12-07 18:07:36 +01:00
- https://creativecommons.org/licenses/by/3.0/
## Changelog
2016-10-24 17:52:54 +02:00
- [v4.7.0 GitHub pull request](https://github.com/FortAwesome/Font-Awesome/pull/10012)
- [v4.6.3 GitHub pull request](https://github.com/FortAwesome/Font-Awesome/pull/9189)
2016-05-04 16:06:59 +02:00
- [v4.6.2 GitHub pull request](https://github.com/FortAwesome/Font-Awesome/pull/9117)
2016-04-12 15:48:47 +02:00
- [v4.6.1 GitHub pull request](https://github.com/FortAwesome/Font-Awesome/pull/8962)
- [v4.6.0 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?q=milestone%3A4.6.0+is%3Aclosed)
2015-11-20 22:24:35 +01:00
- [v4.5.0 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?q=milestone%3A4.5.0+is%3Aclosed)
2015-07-26 16:43:08 +02:00
- [v4.4.0 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?q=milestone%3A4.4.0+is%3Aclosed)
2015-09-14 04:40:28 +02:00
- [v4.3.0 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?q=milestone%3A4.3.0+is%3Aclosed)
- [v4.2.0 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?milestone=12&page=1&state=closed)
- [v4.1.0 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?milestone=6&page=1&state=closed)
- [v4.0.3 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?milestone=9&page=1&state=closed)
- [v4.0.2 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?milestone=8&page=1&state=closed)
- [v4.0.1 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?milestone=7&page=1&state=closed)
- [v4.0.0 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?milestone=2&page=1&state=closed)
- [v3.2.1 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?milestone=5&page=1&state=closed)
- [v3.2.0 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?milestone=3&page=1&state=closed)
- [v3.1.1 GitHub milestones](https://github.com/FortAwesome/Font-Awesome/issues?milestone=4&page=1&state=closed)
- v3.1.0 - Added 54 icons, icon stacking styles, flipping and rotating icons, removed Sass support
- v3.0.2 - much improved rendering and alignment in IE7
- v3.0.1 - much improved rendering in webkit, various bug fixes
- v3.0.0 - all icons redesigned from scratch, optimized for Bootstrap's 14px default
## 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)
2016-05-04 16:06:59 +02:00
* Bug fixes, changes to brand logos, and misc changes bumps the patch
2013-05-11 00:53:39 +02:00
For more information on SemVer, please visit http://semver.org.
2013-05-11 00:43:34 +02:00
## Author
2013-05-11 00:43:34 +02:00
- Email: dave@fontawesome.io
2013-06-26 17:41:16 +02:00
- Twitter: http://twitter.com/davegandy
2013-05-11 00:53:39 +02:00
- GitHub: https://github.com/davegandy
2013-05-11 00:43:34 +02:00
## Component
2016-02-15 19:20:22 +01:00
To include as a [component](https://github.com/componentjs/component), just run
2013-06-22 01:05:06 +02:00
$ component install ForkAwesome/Fork-Awesome
2013-06-22 01:05:06 +02:00
Or add
"ForkAwesome/Fork-Awesome": "*"
2013-06-22 01:05:06 +02:00
to the `dependencies` in your `component.json`.
## Hacking on Font Awesome
**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).
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/Fork-Awesome/:
$ bundle exec jekyll -w serve