Fork-Awesome/README.md

94 lines
4.5 KiB
Markdown
Raw Normal View History

# Fork Awesome
### A fork of the iconic font and CSS toolkit
2018-04-30 06:51:04 +08:00
[![All Contributors](https://img.shields.io/badge/all_contributors-98-orange.svg?style=flat-square)](CONTRIBUTORS.md)
[![JSDeliver](https://data.jsdelivr.com/v1/package/npm/fork-awesome/badge)](https://www.jsdelivr.com/package/npm/fork-awesome)
2018-04-15 02:24:56 +08:00
[![CDNJS](https://img.shields.io/cdnjs/v/fork-awesome.svg?style=flat-square)](https://cdnjs.com/libraries/fork-awesome)
2018-03-15 05:46:31 +08:00
Fork Awesome is a full suite of 718 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 06:43:34 +08: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](https://fortawesome.com/) 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.
2018-02-08 06:55:50 +08:00
A tremendous gratitude is given to the whole team behind [Font Awesome](https://fontawesome.com), and you are encouraged to support them and buy Font Awesome Pro for your project.
2018-02-19 09:00:45 +08:00
Though If you believe in distributed open source design and wish to be part of this new adventure, please start submitting patches and suggestions of improvement.
## How to use
There is a full page in our documentation website that explains [how to use Fork Awesome in your web project](http://forkawesome.github.io/Fork-Awesome/get-started/). It ranges from just pointing to a CSS file on a CDN, hosting it on your own server or even adapting the LESS and SCSS files to your own liking.
## License
2018-02-18 07:57:16 +08:00
- The Fork Awesome font is licensed under the SIL OFL 1.1:
2013-05-11 06:29:45 +08:00
- http://scripts.sil.org/OFL
2018-02-18 07:57:16 +08:00
- Fork Awesome CSS, LESS, and Sass files are licensed under the MIT License:
2016-02-16 02:20:22 +08:00
- https://opensource.org/licenses/mit-license.html
2018-02-18 07:57:16 +08:00
- The Fork Awesome documentation is licensed under the CC BY 3.0 License:
2017-12-08 01:07:36 +08:00
- https://creativecommons.org/licenses/by/3.0/
## Contributing
Please read through our [contributing guidelines](https://github.com/ForkAwesome/Fork-Awesome/blob/master/CONTRIBUTING.md).
Included are directions for opening issues, coding standards, and notes on development.
We also take great pride in recognizing any contributions made to this project. Whether you've written a blogpost about it, fixed a typo in the documentation or submitted new icons or code patches, we will happily list you in our [contributors list](CONTRIBUTORS.md).
2018-03-15 05:46:31 +08:00
## Versioning
Fork 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)
* Big changes, without breaking backward compatibility, bumps the minor (and resets the patch)
* Bug fixes, small adaptations, adding a few icons and misc changes bumps the patch
2018-02-19 09:00:45 +08:00
* The fork started from FontAwesome 4.7 (last commit by Dave is [bdfa9823](https://github.com/ForkAwesome/Fork-Awesome/commits/master?after=b0bc8f6fb74e05c987ef7ce1525cd3ab8390a1c3+69)).
* The project starts at version 1.0.0. All references to versions before the fork are named 0.4.7
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
## Component
2016-02-16 02:20:22 +08:00
To include as a [component](https://github.com/componentjs/component), just run
2013-06-22 07:05:06 +08:00
$ component install ForkAwesome/Fork-Awesome
2013-06-22 07:05:06 +08:00
Or add
"ForkAwesome/Fork-Awesome": "*"
2013-06-22 07:05:06 +08:00
to the `dependencies` in your `component.json`.
2018-04-30 06:51:04 +08:00
## Building Fork 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/)
- **macOS:** no extra step required
- [Bundler](http://bundler.io/) (Run `gem install bundler` to install).
2018-02-23 06:44:24 +08:00
- [Node Package Manager (aka. `npm`)](https://docs.npmjs.com/getting-started/installing-node)
From the root of the repository, install the tools used to develop.
$ bundle install
$ npm install
2018-02-19 09:00:45 +08:00
Build the font:
$:/src/icons make
Build the web documentation:
2018-02-06 07:10:39 +08:00
$ npm run build
2018-04-30 06:51:04 +08:00
Or serve it on a local server on http://localhost:7998:
2018-02-06 07:10:39 +08:00
$ npm run dev
To deploy the project and documentation on GH pages:
$ jgd -n