Go to file
shine de0289499c
add note about linking pull requests to issues
if pull request creators are considerate enough to follow this, it could
save the maintainers a lot of time in triaging issues to be closed after
they have already been merged into the icon set
2021-06-25 23:56:38 +05:30
.github/ISSUE_TEMPLATE Redefining use cases 2018-12-14 13:40:26 -05:00
css Version bump to 1.2 2020-06-24 13:12:24 +02:00
fonts Version bump to 1.2 2020-06-24 13:12:24 +02:00
less Version bump to 1.2 2020-06-24 13:12:24 +02:00
scss Version bump to 1.2 2020-06-24 13:12:24 +02:00
src Version bump to 1.2 2020-06-24 13:12:24 +02:00
.all-contributorsrc docs: update .all-contributorsrc [skip ci] 2020-06-24 11:23:45 +00:00
.gitignore add swap and backup files to .gitignore 2018-03-23 14:55:47 -04:00
.npmignore .npmignore: add .github/ 2018-10-16 00:24:43 -04:00
.travis.yml Should deploy also to NPM on tags 2018-09-25 18:21:02 -04:00
CHANGELOG.md Bumping the version number for release of 1.1.6 2019-02-21 10:24:28 -05:00
CONTRIBUTING.md add note about linking pull requests to issues 2021-06-25 23:56:38 +05:30
CONTRIBUTORS.md docs: update CONTRIBUTORS.md [skip ci] 2020-06-24 11:23:44 +00:00
Dockerfile Add a dockerfile, document its usage in the readme (#260) 2020-10-11 15:51:13 -04:00
Gemfile Revert to a version of Jekyll that works 2018-09-23 16:17:32 -04:00
Gemfile.lock Revert to a version of Jekyll that works 2018-09-23 16:17:32 -04:00
LICENSES Adds the full license text at root of project for all 3 licenses 2018-10-02 18:41:04 -04:00
README.md Readme updates (#261) 2020-10-15 01:07:52 -04:00
_config-deploy.yml Adds the official domain name 2019-02-18 16:04:46 -05:00
_config.yml Version bump to 1.2 2020-06-24 13:12:24 +02:00
bower.json Updating bower 2018-02-08 17:48:17 -05:00
component.json Version bump to 1.2 2020-06-24 13:12:24 +02:00
composer.json Update package version to 1.0.1 2018-02-18 16:30:34 -05:00
package-lock.json Updates less-plugin-clean-css for security reasons 2020-06-11 09:24:49 +02:00
package.json Version bump to 1.2 2020-06-24 13:12:24 +02:00

README.md

Fork Awesome

A fork of the iconic font and CSS toolkit

npm-badge all-contrib jsdeliver-badge cdnjs-badge build-status-badge

Fork Awesome is a full suite of 796 pictographic icons for easy scalable vector graphics on websites, originally created by Dave Gandy and now maintained by a community.

Following concerns regarding the development of Font Awesome, 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 amazing 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, and you are encouraged to support them and buy Font Awesome Pro for your project.

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.

Also, if you care about owning the build process of your icon font, this project will give you that. The whole pipeline is shared and free to use for any purpose. You could be spinning your own icon font with your clever name by just forking this project and changing a few settings.

How to use

There is a full page in our documentation website that explains how to use Fork Awesome in your web project. 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

Contributing

Please read through our contributing guidelines. 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.

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
  • The fork started from FontAwesome 4.7 (last commit by Dave is bdfa9823).
  • The project starts at version 1.0.0. All references to versions before the fork are named 0.4.7

For more information on SemVer, please visit http://semver.org.

Component

To include as a component, just run

$ component install ForkAwesome/Fork-Awesome

Or add

"ForkAwesome/Fork-Awesome": "*"

to the dependencies in your component.json.

Building Fork Awesome

Before you can build the project, you must first have the following installed:

  • Ruby
  • Ruby Development Headers
    • Ubuntu: sudo apt-get install ruby-dev (Only if you're NOT using rbenv or rvm)
    • Windows: DevKit
    • macOS: no extra step required
  • Bundler (Run gem install bundler to install).
  • Node Package Manager (aka. npm)
  • Tools required to build the font:
    • Ubuntu: sudo apt-get install fontforge woff-tools woff2

From the root of the repository, install the tools used to develop.

$ bundle install
$ npm ci

Build the font:

$ make -C src/icons

Build the web documentation:

$ npm run build

Or serve it on a local server on http://localhost:7998:

$ npm run dev

Build the font in a Docker container

Another possibility is to build the font using the Dockerfile provided.

First, build the Docker image:

$ docker build -t fa-builder .

Then, run the Docker container:

$ docker run --rm -it \
    -u $(id -u):$(id -g) \
    -v $(pwd):$(pwd) \
    -w $(pwd) \
    fa-builder

Within the container, build the font:

$ bundle install --path vendor/bundle
$ npm ci
$ make -C src/icons