1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
|
---
layout: base
title: Get Started with Fork Awesome
navbar_active: get-started
view_class: v-get-started
relative_path: ../
---
{% capture jumbotron_h1 %}<i class="fa fa-cogs" aria-hidden="true"></i> Get Started{% endcapture %}
{% capture jumbotron_p %}Easy ways to get {{ site.forkawesome.name }} {{ site.forkawesome.version }} onto your website{% endcapture %}
{% include jumbotron.html %}
<div class="container">
<section class="get-started-download" id="get-started-download">
<h2 class="page-header clearfix">
Download & Customize
<span class="label label-default text-base pull-right">Easy</span>
</h2>
<div class="row">
<div class="col-md-9">
<p class="text-lg">
Want to manage and host Font Awesome assets yourself? You can
<a href="#modal-download" data-toggle="modal" onClick="_gaq.push(['_trackEvent', 'Launch Modal', 'Launch Download Modal']);">download</a>,
customize, and use the icons and default styling manually. Both CSS and CSS Preprocessor (Sass and Less) formats are included.</p>
</div>
<div class="col-md-3">
<a class="btn btn-default btn-lg btn-block" href="#modal-download" data-toggle="modal"
onClick="_gaq.push(['_trackEvent', 'Launch Modal', 'Launch Download Modal']);">
<i class="fa fa-download fa-lg margin-right-sm"></i>
Download
</a>
</div>
</div>
<div class="download-css margin-bottom-xl" id="download-css">
<h3>Using CSS</h3>
<ol>
<li>Copy the entire <code>font-awesome</code> directory into your project.</li>
<li>
In the <code><head></code> of your html, reference the location to your font-awesome.min.css.
{% highlight html %}
<link rel="stylesheet" href="path/to/font-awesome/css/font-awesome.min.css">
{% endhighlight %}
</li>
<li>Check out the <a href="{{ page.relative_path }}examples/">examples</a> to start using Font Awesome!</li>
</ol>
</div>
<div class="download-preprocessors" id="download-preprocessors">
<h3>Using Sass or Less</h3>
<p>Use this method to customize Font Awesome {{ site.fontawesome.version }} using Less or Sass.</p>
<ol>
<li>Copy the <code>font-awesome/</code> directory into your project.</li>
<li>
Open your project's <code>font-awesome/less/variables.less</code> or <code>font-awesome/scss/_variables.scss</code> and edit the <code>@fa-font-path</code> or <code>$fa-font-path</code>
variable to point to your font directory.
{% highlight scss %}
@fa-font-path: "../font";
{% endhighlight %}
<p class="alert alert-success"><i class="fa fa-info-circle"></i> The font path is relative from your compiled CSS directory.</p>
</li>
<li>Re-compile your Less or Sass if using a static compiler. Otherwise, you should be good to go.</li>
<li>Check out the <a href="{{ page.relative_path }}examples/">examples</a> to start using Font Awesome!</li>
</ol>
</div>
</section>
<div class="hr margin-top-lg">
<span class="hr-text text-xl text-muted">or</span>
</div>
<section class="get-started-advanced" id="get-started-advanced">
<h2 class="page-header clearfix">
Advanced & Packages
<span class="label label-default text-base pull-right">Pro</span>
</h2>
<div class="ruby-gem-less margin-bottom-xl" id="ruby-gem-less">
<h3><a href="https://github.com/FortAwesome/font-awesome-less">Less Ruby Gem</a></h3>
<p>
Use the <a href="https://github.com/FortAwesome/font-awesome-less">Official Font Awesome Less Ruby Gem</a> to easily get Font
Awesome Less into a Rails project. Generously maintained by <a href="https://twitter.com/supercodepoet/">@supercodepoet</a>.
</p>
<ol>
<li>
Add this line to your application's Gemfile:
{% highlight bash %}
gem 'font-awesome-less'
{% endhighlight %}
</li>
<li>
And then execute:
{% highlight bash %}
$ bundle
{% endhighlight %}
</li>
<li>Or install it yourself as:
{% highlight bash %}
$ gem install font-awesome-less
{% endhighlight %}
</li>
</ol>
<p>
If you use Rails, add this to your e.g. <code>application.less</code>:
</p>
{% highlight css %}
@import "font-awesome-sprockets";
@import "font-awesome";
{% endhighlight %}
</div>
<div class="ruby-gem-sass" id="ruby-gem-sass">
<h3><a href="https://github.com/FortAwesome/font-awesome-sass">Sass Ruby Gem</a></h3>
<p>
Use the <a href="https://github.com/FortAwesome/font-awesome-sass">Official Font Awesome Sass Ruby Gem</a> to easily get Font
Awesome Sass into a Rails or Compass project. Generously maintained by <a href="https://twitter.com/supercodepoet/">@supercodepoet</a>.
</p>
<ol>
<li>
Add this line to your application's Gemfile:
{% highlight bash %}
gem 'font-awesome-sass'
{% endhighlight %}
</li>
<li>
And then execute:
{% highlight bash %}
$ bundle
{% endhighlight %}
</li>
<li>Or install it yourself as:
{% highlight bash %}
$ gem install font-awesome-sass
{% endhighlight %}
</li>
</ol>
<p>
If you use Rails, add this to your e.g. <code>application.scss</code>:
</p>
{% highlight css %}
@import "font-awesome-sprockets";
@import "font-awesome";
{% endhighlight %}
</div>
</section>
<section class="get-started-more margin-top-lg" id="get-started-more">
<h2 class="page-header">More Information</h2>
</section>
<div class="row">
<div class="col-md-6" id="support-validators">
<h4>Validators</h4>
<p>In order to provide the best possible experience to old and buggy browsers, Font Awesome uses <a href="http://browserhacks.com">CSS browser hacks</a> in several places to target special CSS to certain browser versions in order to work around bugs in the browsers themselves. These hacks understandably cause CSS validators to complain that they are invalid. In a couple places, we also use bleeding-edge CSS features that aren't yet fully standardized, but these are used purely for progressive enhancement.</p>
<p>These validation warnings don't matter in practice since the non-hacky portion of our CSS does fully validate and the hacky portions don't interfere with the proper functioning of the non-hacky portion, hence why we deliberately ignore these particular warnings.</p>
<p><a href="http://getbootstrap.com/getting-started/#support-validators">Getting started - Validators</a> by <a href="http://getbootstrap.com/about/#team">Bootstrap Team</a> is licensed under <a href="https://creativecommons.org/licenses/by/3.0/">CC BY 3.0</a></p>
</div>
<div class="col-md-6" id="ie8-font-face">
<h4>Internet Explorer 8 and @font-face</h4>
<p>IE8 has some issues with <code>@font-face</code> when combined with <code>:before</code>.
Font Awesome uses that combination. If a page is cached, and loaded without the mouse over the window
(i.e. hit the refresh button or load something in an iframe) then the page gets rendered before the font loads.
Hovering over the page (body) will show some of the icons and hovering over the remaining icons will show those as well.
<a href="https://github.com/FortAwesome/Font-Awesome/issues/954">See issue #954</a> for details.</p>
<p><a href="http://getbootstrap.com/getting-started/#support-ie8-font-face">Getting started - Internet Explorer 8 and @font-face</a> by <a href="http://getbootstrap.com/about/#team">Bootstrap Team</a> is licensed under <a href="https://creativecommons.org/licenses/by/3.0/">CC BY 3.0</a></p>
</div>
</div>
<div class="row">
<div class="col-md-6" id="need-ie7">
<h4>Need IE7 Support?</h4>
<p>
If you need IE7 support, you have my condolences. Really. Font Awesome {{ site.fontawesome.version }}
doesn't support IE7, but an older version does. You'll need to check out the
<a href="{{ page.relative_path }}3.2.1/get-started/#need-ie7">3.2.1 instructions for using IE7</a>. Then go complain to
whoever decided your project needs IE7 support.
</p>
</div>
<div class="col-md-6" id="troubleshooting">
<h4>Troubleshooting</h4>
<p>If you're having trouble with Font Awesome, make sure to check out the
<a href="{{ site.fontawesome.github.url }}/wiki/Troubleshooting">troubleshooting wiki page</a>.
Generously maintained by <a href="https://twitter.com/gtagliala">@gtagliala</a>.</p>
</div>
</div>
{% include modals/download.html %}
|
