get-started.html 4.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105
  1. {% capture stripe_ad_content %}
  2. <p class="lead">
  3. Setting up Font Awesome can be as simple as adding two lines of code to your website, or you can be a pro and
  4. customize the LESS yourself! Font Awesome even plays nicely with
  5. <a href="{{ site.bootstrap.url }}">Bootstrap</a>!
  6. </p>
  7. {% endcapture %}
  8. {% include stripe-ad.html %}
  9. <section class="margin-top-large">
  10. <h2 class="page-header">EASIEST: <a href="http://www.bootstrapcdn.com/#tab_fontawesome">BootstrapCDN</a></h2>
  11. <p>Add Font Awesome + Bootstrap into your website with two lines of code. You don't even have to download or install anything!</p>
  12. <ol>
  13. <li>
  14. Paste the following code into the <code>&lt;head&gt;</code> section of your site's HTML.
  15. {% highlight html %}
  16. <link href="//netdna.bootstrapcdn.com/twitter-bootstrap/{{ site.bootstrap.version }}/css/bootstrap-combined.no-icons.min.css" rel="stylesheet">
  17. <link href="//netdna.bootstrapcdn.com/font-awesome/{{ site.font_awesome.version }}/css/font-awesome.css" rel="stylesheet">
  18. {% endhighlight %}
  19. <div class="alert alert-info margin-top">
  20. <i class="icon-info-sign"></i> Want to use Font Awesome by itself without Bootstrap? Just don't include the first line.
  21. </div>
  22. </li>
  23. <li>
  24. Pat yourself on the back for your scalable-vector-icons-on-the-website
  25. <a href="http://37signals.com/svn/posts/312-lingo-judo">judo solution</a> in two lines of code.
  26. </li>
  27. <li>
  28. Check out the <a href="{{ site.baseurl }}examples/">examples</a> to start using Font Awesome!
  29. </li>
  30. </ol>
  31. </section>
  32. <section>
  33. <h2 class="page-header">EASY: Default CSS</h2>
  34. <p>Use this method to get the default Font Awesome CSS with the default Bootstrap CSS.</p>
  35. <ol>
  36. <li>Copy the Font Awesome font directory into your project.</li>
  37. <li>Copy font-awesome.min.css into your project.</li>
  38. <li>
  39. Open your project's font-awesome.min.css and edit the font paths to ensure they point to the right place.
  40. <p class="alert alert-info">
  41. <i class="icon-info-sign"></i> The font path is relative from your CSS directory. If you're having an issue
  42. getting Font Awesome icons to load, this is likely the issue.
  43. </p>
  44. </li>
  45. <li>
  46. In the <code>&lt;head&gt;</code> of your html, reference the location to your font-awesome.min.css.
  47. {% highlight html %}
  48. <link rel="stylesheet" href="../css/bootstrap.min.css">
  49. <link rel="stylesheet" href="../css/font-awesome.min.css">
  50. {% endhighlight %}
  51. </li>
  52. <li>Check out the <a href="{{ site.baseurl }}examples/">examples</a> to start using Font Awesome!</li>
  53. </ol>
  54. </section>
  55. <section>
  56. <h2 class="page-header">PRO: Custom LESS</h2>
  57. <p>Use this method to customize Font Awesome and Bootstrap using LESS.</p>
  58. <ol>
  59. <li>Copy the Font Awesome font directory into your project.</li>
  60. <li>Copy font-awesome.less into your bootstrap/less directory.</li>
  61. <li>Open bootstrap.less and replace <code>@import "sprites.less";</code> with <code>@import "font-awesome.less";</code></li>
  62. <li>
  63. Open your project's font-awesome.less and edit the <code>@FontAwesomePath</code> variable to point to your font directory.
  64. {% highlight html %}
  65. @FontAwesomePath: "../font";
  66. {% endhighlight %}
  67. <p class="alert alert-info"><i class="icon-info-sign"></i> The font path is relative from your compiled CSS directory.</p>
  68. </li>
  69. <li>Re-compile your LESS if using a static compiler. Otherwise, you should be good to go.</li>
  70. <li>Check out the <a href="{{ site.baseurl }}examples/">examples</a> to start using Font Awesome!</li>
  71. </ol>
  72. </section>
  73. <section>
  74. <h2 class="page-header">Not using Bootstrap?</h2>
  75. <p>Font Awesome works just as well without Bootstrap.</p>
  76. <ol>
  77. <li>Copy the Font Awesome font directory into your project.</li>
  78. <li>Copy font-awesome.less or font-awesome.min.css into your project.</li>
  79. <li>Open your project's font-awesome.less or font-awesome.min.css and edit the font location to point it to your font directory (see above examples).</li>
  80. <li>Check out the <a href="{{ site.baseurl }}examples/">examples</a> to start using Font Awesome!</li>
  81. </ol>
  82. </section>
  83. <section>
  84. <h2 class="page-header">Need IE7 Support?</h2>
  85. <p>Font Awesome supports IE7. If you need it, you have my condolences.</p>
  86. <ol>
  87. <li>Get Font Awesome working properly in a modern browser.</li>
  88. <li>Copy font-awesome-ie7.min.css into your project.</li>
  89. <li>
  90. In the <code>&lt;head&gt;</code> of your html, reference the location to your font-awesome-ie7.min.css.
  91. {% highlight html %}
  92. <link rel="stylesheet" href="../css/bootstrap.min.css">
  93. <link rel="stylesheet" href="../css/font-awesome.min.css">
  94. <!--[if IE 7]>
  95. <link rel="stylesheet" href="assets/css/font-awesome-ie7.min.css">
  96. <![endif]-->{% endhighlight %}
  97. </li>
  98. <li>Go complain to whoever decided your project needs IE7 support.</li>
  99. </ol>
  100. </section>