get-started.html 4.9 KB

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