index.html 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <!-- Basic Page Needs
  5. ================================================== -->
  6. <meta charset="utf-8" />
  7. <meta name="viewport" content="width=device-width, initial-scale=1.0">
  8. <meta name="description" content="Font Awesome, the iconic font designed for Bootstrap">
  9. <meta name="author" content="Dave Gandy">
  10. <link rel="shortcut icon" href="../assets/ico/favicon.ico">
  11. <title>Get Started with Font Awesome</title>
  12. <!-- CSS
  13. ================================================== -->
  14. <link rel="stylesheet" href="../assets/css/site.css">
  15. <link rel="stylesheet" href="../assets/css/pygments.css">
  16. <link rel="stylesheet" href="../assets/font-awesome/css/font-awesome.css">
  17. <!--[if lt IE 9]>
  18. <script src="../assets/js/html5shiv.js"></script>
  19. <script src="../assets/js/respond.min.js"></script>
  20. <![endif]-->
  21. <script type="text/javascript" src="//use.typekit.net/wnc7ioh.js"></script>
  22. <script type="text/javascript">try{Typekit.load();}catch(e){}</script>
  23. <script type="text/javascript">
  24. var _gaq = _gaq || [];
  25. _gaq.push(['_setAccount', 'UA-30136587-1']);
  26. _gaq.push(['_trackPageview']);
  27. (function() {
  28. var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
  29. ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
  30. var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
  31. })();
  32. </script>
  33. </head>
  34. <body>
  35. <div id="wrap"> <!-- necessary for sticky footer. wrap all content except footer -->
  36. <div class="navbar navbar-inverse navbar-static-top hidden-print">
  37. <div class="container">
  38. <div class="navbar-header">
  39. <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
  40. <span class="sr-only">Toggle navigation</span>
  41. <i class="fa fa-bars fa-lg"></i>
  42. </button>
  43. <a class="navbar-brand" href="../"><i class="fa fa-flag"></i> Font Awesome</a>
  44. </div>
  45. <div class="navbar-collapse collapse">
  46. <ul class="nav navbar-nav">
  47. <li class="hidden-sm "><a href="../">Home</a></li>
  48. <li class="hidden-sm">
  49. <a href="../whats-new/">What's New</a>
  50. </li>
  51. <li class="hidden-xs hidden-md hidden-lg">
  52. <a href="../whats-new/">New</a>
  53. </li>
  54. <li class="active"><a href="../get-started/">Get Started</a></li>
  55. <li class="dropdown-split-left"><a href="../icons/">Icons</a></li>
  56. <li class="dropdown dropdown-split-right hidden-xs">
  57. <a href="#" class="dropdown-toggle" data-toggle="dropdown">
  58. <i class="fa fa-caret-down"></i>
  59. </a>
  60. <ul class="dropdown-menu pull-right">
  61. <li><a href="../icons/"><i class="fa fa-flag fa-fw"></i>&nbsp; Icons</a></li>
  62. <li class="divider"></li>
  63. <li><a href="../icons/#new"><i class="fa fa-rub fa-fw"></i>&nbsp; New Icons in 4.0</a></li>
  64. <li><a href="../icons/#web-application"><i class="fa fa-camera-retro fa-fw"></i>&nbsp; Web Application Icons</a></li>
  65. <li><a href="../icons/#form-control"><i class="fa fa-check-square fa-fw"></i>&nbsp; Form Control Icons</a></li>
  66. <li><a href="../icons/#currency"><i class="fa fa-won fa-fw"></i>&nbsp; Currency Icons</a></li>
  67. <li><a href="../icons/#text-editor"><i class="fa fa-file-text-o fa-fw"></i>&nbsp; Text Editor Icons</a></li>
  68. <li><a href="../icons/#directional"><i class="fa fa-hand-o-right fa-fw"></i>&nbsp; Directional Icons</a></li>
  69. <li><a href="../icons/#video-player"><i class="fa fa-play-circle fa-fw"></i>&nbsp; Video Player Icons</a></li>
  70. <li><a href="../icons/#brand"><i class="fa fa-github fa-fw"></i>&nbsp; Brand Icons</a></li>
  71. <li><a href="../icons/#medical"><i class="fa fa-medkit fa-fw"></i>&nbsp; Medical Icons</a></li>
  72. </ul>
  73. </li>
  74. <li class="dropdown-split-left"><a href="../examples/">Examples</a></li>
  75. <li class="dropdown dropdown-split-right hidden-xs">
  76. <a href="#" class="dropdown-toggle" data-toggle="dropdown">
  77. <i class="fa fa-caret-down"></i>
  78. </a>
  79. <ul class="dropdown-menu pull-right">
  80. <li><a href="../examples/">Examples</a></li>
  81. <li class="divider"></li>
  82. <li><a href="../examples/#inline">Inline Icons</a></li>
  83. <li><a href="../examples/#larger">Larger Icons</a></li>
  84. <li><a href="../examples/#fixed-width">Fixed Width Icons</a></li>
  85. <li><a href="../examples/#list">List Icons</a></li>
  86. <li><a href="../examples/#bordered-pulled">Bordered & Pulled Icons</a></li>
  87. <li><a href="../examples/#spinning">Spinning Icons</a></li>
  88. <li><a href="../examples/#rotated-flipped">Rotated &amp; Flipped Icons</a></li>
  89. <li><a href="../examples/#stacked">Stacked Icons</a></li>
  90. <li><a href="../examples/#bootstrap">Bootstrap 3 Examples</a></li>
  91. <li><a href="../examples/#custom">Custom CSS</a></li>
  92. </ul>
  93. </li>
  94. <li><a href="../community/">Community</a></li>
  95. <li><a href="../license/">License</a></li>
  96. </ul>
  97. <ul class="nav navbar-nav navbar-right">
  98. <li><a href="http://blog.fontawesome.io">Blog</a></li>
  99. </ul>
  100. </div>
  101. </div>
  102. </div>
  103. <div class="jumbotron jumbotron-ad hidden-print">
  104. <div class="container">
  105. <h1><i class="fa fa-cogs"></i>&nbsp; Get Started</h1>
  106. <p>Easy ways to get Font Awesome 4.0.3 onto your website</p>
  107. </div>
  108. </div>
  109. <div id="social-buttons" class="hidden-print">
  110. <div class="container">
  111. <ul class="list-inline">
  112. <li>
  113. <iframe class="github-btn" src="http://ghbtns.com/github-btn.html?user=FortAwesome&repo=Font-Awesome&type=watch&count=true" allowtransparency="true" frameborder="0" scrolling="0" width="100px" height="20px"></iframe>
  114. </li>
  115. <li>
  116. <iframe class="github-btn" src="http://ghbtns.com/github-btn.html?user=FortAwesome&repo=Font-Awesome&type=fork&count=true" allowtransparency="true" frameborder="0" scrolling="0" width="102px" height="20px"></iframe>
  117. </li>
  118. <li class="follow-btn">
  119. <a href="https://twitter.com/fontawesome" class="twitter-follow-button" data-link-color="#0069D6" data-show-count="true">Follow @fontawesome</a>
  120. </li>
  121. <li class="tweet-btn hidden-phone">
  122. <a href="https://twitter.com/share" class="twitter-share-button" data-url="http://fontawesome.io" data-text="Font Awesome, the iconic font designed for Bootstrap" data-counturl="http://fortawesome.github.com/Font-Awesome/" data-count="horizontal" data-via="fontawesome" data-related="davegandy:Creator of Font Awesome">Tweet</a>
  123. </li>
  124. </ul>
  125. </div>
  126. </div>
  127. <div class="container">
  128. <section class="hidden-print">
  129. <div class="stripe-ad">
  130. <div id="carbonads-container"><div class="carbonad"><div id="azcarbon"></div><script type="text/javascript">var z = document.createElement("script"); z.type = "text/javascript"; z.async = true; z.src = "http://engine.carbonads.com/z/32291/azcarbon_2_1_0_HORIZ"; var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(z, s);</script></div></div>
  131. <p class="lead">
  132. Setting up Font Awesome can be as simple as adding two lines of code to your website, or you can be a pro and
  133. customize the LESS yourself! Font Awesome even plays nicely with
  134. <a href="http://getbootstrap.com">Bootstrap 3</a>!
  135. </p>
  136. </div>
  137. </section>
  138. <div id="bootstrapcdn">
  139. <h2 class="page-header">EASIEST: <a href="http://www.bootstrapcdn.com/#tab_fontawesome">BootstrapCDN</a></h2>
  140. <p>Add Font Awesome into your website with a single line of code. You don't even have to download or install anything!</p>
  141. <ol>
  142. <li>
  143. Paste the following code into the <code>&lt;head&gt;</code> section of your site's HTML.
  144. <div class="highlight"><pre><code class="html"><span class="nt">&lt;link</span> <span class="na">href=</span><span class="s">&quot;//netdna.bootstrapcdn.com/font-awesome/4.0.3/css/font-awesome.css&quot;</span> <span class="na">rel=</span><span class="s">&quot;stylesheet&quot;</span><span class="nt">&gt;</span>
  145. </code></pre></div>
  146. </li>
  147. <li>
  148. Pat yourself on the back for your scalable-vector-icons-on-the-website
  149. <a href="http://37signals.com/svn/posts/312-lingo-judo">judo solution</a> in a single line of code.
  150. </li>
  151. <li>
  152. Check out the <a href="../examples/">examples</a> to start using Font Awesome!
  153. </li>
  154. </ol>
  155. </div>
  156. <section id="default-css">
  157. <h2 class="page-header">EASY: Default CSS</h2>
  158. <p>Use this method to get the default Font Awesome CSS with the default Bootstrap CSS.</p>
  159. <ol>
  160. <li>Copy the entire <code>font-awesome</code> directory into your project.</li>
  161. <li>
  162. In the <code>&lt;head&gt;</code> of your html, reference the location to your font-awesome.min.css.
  163. <div class="highlight"><pre><code class="html"><span class="nt">&lt;link</span> <span class="na">rel=</span><span class="s">&quot;stylesheet&quot;</span> <span class="na">href=</span><span class="s">&quot;path/to/font-awesome/css/font-awesome.min.css&quot;</span><span class="nt">&gt;</span>
  164. </code></pre></div>
  165. </li>
  166. <li>Check out the <a href="../examples/">examples</a> to start using Font Awesome!</li>
  167. </ol>
  168. </section>
  169. <section id="ruby-gem-less">
  170. <h2 class="page-header">EASY: <a href="https://github.com/FortAwesome/font-awesome-less">LESS Ruby Gem</a></h2>
  171. <p>
  172. Use the <a href="https://github.com/FortAwesome/font-awesome-less">Official Font Awesome LESS Ruby Gem</a> to easily get Font
  173. Awesome LESS into a Rails project. Generously maintained by <a href="https://twitter.com/supercodepoet/">@supercodepoet</a>.
  174. </p>
  175. <ol>
  176. <li>
  177. Add this line to your application's Gemfile:
  178. <div class="highlight"><pre><code class="bash">gem <span class="s1">&#39;font-awesome-less&#39;</span>
  179. </code></pre></div>
  180. </li>
  181. <li>
  182. And then execute:
  183. <div class="highlight"><pre><code class="bash"><span class="nv">$ </span>bundle
  184. </code></pre></div>
  185. </li>
  186. <li>Or install it yourself as:
  187. <div class="highlight"><pre><code class="bash"><span class="nv">$ </span>gem install font-awesome-less
  188. </code></pre></div>
  189. </li>
  190. </ol>
  191. </section>
  192. <section id="ruby-gem-sass">
  193. <h2 class="page-header">EASY: <a href="https://github.com/FortAwesome/font-awesome-sass">SASS Ruby Gem</a></h2>
  194. <p>
  195. Use the <a href="https://github.com/FortAwesome/font-awesome-sass">Official Font Awesome SASS Ruby Gem</a> to easily get Font
  196. Awesome SASS into a Rails project. Generously maintained by <a href="https://twitter.com/supercodepoet/">@supercodepoet</a>.
  197. </p>
  198. <ol>
  199. <li>
  200. Add this line to your application's Gemfile:
  201. <div class="highlight"><pre><code class="bash">gem <span class="s1">&#39;font-awesome-sass&#39;</span>
  202. </code></pre></div>
  203. </li>
  204. <li>
  205. And then execute:
  206. <div class="highlight"><pre><code class="bash"><span class="nv">$ </span>bundle
  207. </code></pre></div>
  208. </li>
  209. <li>Or install it yourself as:
  210. <div class="highlight"><pre><code class="bash"><span class="nv">$ </span>gem install font-awesome-sass
  211. </code></pre></div>
  212. </li>
  213. </ol>
  214. </section>
  215. <section id="custom-less">
  216. <h2 class="page-header">PRO: Custom LESS or SASS</h2>
  217. <p>Use this method to customize Font Awesome 4.0.3 using LESS or SASS.</p>
  218. <ol>
  219. <li>Copy the <code>font-awesome/</code> directory into your project.</li>
  220. <li>
  221. 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>
  222. variable to point to your font directory.
  223. <div class="highlight"><pre><code class="scss"><span class="k">@fa-font-path</span><span class="nd">:</span> <span class="s2">&quot;../font&quot;</span><span class="o">;</span>
  224. </code></pre></div>
  225. <p class="alert alert-success"><i class="fa fa-info-circle"></i> The font path is relative from your compiled CSS directory.</p>
  226. </li>
  227. <li>Re-compile your LESS or SASS if using a static compiler. Otherwise, you should be good to go.</li>
  228. <li>Check out the <a href="../examples/">examples</a> to start using Font Awesome!</li>
  229. </ol>
  230. </section>
  231. <section class="need-ie7">
  232. <h2 class="page-header">Need IE7 Support?</h2>
  233. <p>
  234. If you need IE7 support, you have my condolences. Really. Font Awesome 4.0.3
  235. doesn't support IE7, but an older version does. You'll need to check out the
  236. <a href="../3.2.1/get-started/#need-ie7">3.2.1 instructions for using IE7</a>. Then go complain to
  237. whomever decided your project needs IE7 support.
  238. </p>
  239. </section>
  240. <section id="troubleshooting">
  241. <h2 class="page-header">Troubleshooting</h2>
  242. <p>
  243. If you're having trouble with Font Awesome, make sure to check out the
  244. <a href="https://github.com/FortAwesome/Font-Awesome/wiki/Troubleshooting">troubleshooting wiki page</a>.
  245. Generously maintained by <a href="https://twitter.com/gtagliala">@gtagliala</a>.
  246. </p>
  247. </section>
  248. </div>
  249. </div>
  250. <footer id="footer" class="footer hidden-print">
  251. <div class="container text-center">
  252. <div>
  253. <i class="fa fa-flag"></i> Font Awesome 4.0.3
  254. <span class="hide-xs">&middot;</span><br class="hide-sm hide-md hide-lg">
  255. Created by <a href="http://twitter.com/davegandy">Dave Gandy</a>
  256. </div>
  257. <div>
  258. Font Awesome licensed under <a href="http://scripts.sil.org/OFL">SIL OFL 1.1</a>
  259. <span class="hide-xs">&middot;</span><br class="hide-sm hide-md hide-lg">
  260. Code licensed under <a href="http://opensource.org/licenses/mit-license.html">MIT License</a>
  261. <span class="hide-xs hide-sm">&middot;</span><br class="hide-md hide-lg">
  262. Documentation licensed under <a href="http://creativecommons.org/licenses/by/3.0/">CC BY 3.0</a>
  263. </div>
  264. <div>
  265. Thanks to <a href="http://maxcdn.com"><i class="fa fa-maxcdn"></i> MaxCDN</a> for providing the excellent <a href="http://www.bootstrapcdn.com/#fontawesome_tab">BootstrapCDN for Font Awesome</a>
  266. </div>
  267. <div class="project">
  268. <a href="https://github.com/FortAwesome/Font-Awesome">GitHub Project</a> &middot;
  269. <a href="https://github.com/FortAwesome/Font-Awesome/issues">Issues</a> &middot;
  270. <a href="../3.2.1">Old 3.2.1 Docs</a>
  271. </div>
  272. </div>
  273. </footer>
  274. <script src="http://platform.twitter.com/widgets.js"></script>
  275. <script src="../assets/js/jquery-1.10.2.min.js"></script>
  276. <script src="../assets/js/ZeroClipboard-1.1.7.min.js"></script>
  277. <script src="../assets/js/bootstrap-3.0.0.min.js"></script>
  278. <script src="../assets/js/site.js"></script>
  279. </body>
  280. </html>