get-started.html
1 --- 2 layout: base 3 title: Get Started with Fork Awesome 4 navbar_active: get-started 5 view_class: v-get-started 6 relative_path: ../ 7 --- 8 {% capture jumbotron_h1 %}<i class="fa fa-cogs" aria-hidden="true"></i> Get Started{% endcapture %} 9 {% capture jumbotron_p %}Easy ways to get {{ site.forkawesome.name }} {{ site.forkawesome.version }} onto your website{% endcapture %} 10 11 {% include jumbotron.html %} 12 13 <div class="container"> 14 <section class="get-started-CDN margin-top-lg" id="get-started-CDN"> 15 <h2 class="page-header clearfix"> 16 Use a CDN 17 </h2> 18 19 <div class="row"> 20 <div class="col-md-12"> 21 <p>The simplest way to get {{ site.forkawesome.name }} in your project is to copy the line below in between the <code><head></code> tags of your HTML source files. Then check the <a href="{{ page.relative_path }}examples/">examples</a> to start displaying icons. 22 <p> 23 {% highlight html %} 24 <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/fork-awesome@{{ site.forkawesome.version }}/css/fork-awesome.min.css" integrity="{% sri_hash css/fork-awesome.min.css %}" crossorigin="anonymous"> 25 {% endhighlight %} 26 </p> 27 <p>Thanks to <a href="https://www.jsdelivr.com/package/npm/fork-awesome">jsDelivr</a> for providing the CDN for {{ site.forkawesome.name }}</p> 28 </div> 29 </div> 30 </section> 31 32 <div class="hr margin-top-xl"> 33 <span class="hr-text text-xl text-muted">or</span> 34 </div> 35 36 <section class="get-started-download" id="get-started-download"> 37 <h2 class="page-header clearfix"> 38 Download & Customize 39 </h2> 40 41 <div class="row"> 42 <div class="col-md-9"> 43 <p class="text-lg"> 44 Want to manage and host {{ site.forkawesome.name }} assets yourself? You can 45 <a href="#modal-download" data-toggle="modal">download</a>, 46 customize, and use the icons and default styling manually. Both CSS and CSS Preprocessor (Sass and Less) formats are included.</p> 47 </div> 48 49 <div class="col-md-3"> 50 <a class="btn btn-default btn-lg btn-block" href="#modal-download" data-toggle="modal"> 51 <i class="fa fa-download fa-lg margin-right-sm"></i> 52 Download 53 </a> 54 </div> 55 </div> 56 57 <div class="download-css margin-bottom-xl" id="download-css"> 58 <h3>Using CSS</h3> 59 60 <ol> 61 <li>Copy the entire <code>fork-awesome</code> directory into your project.</li> 62 <li> 63 In the <code><head></code> of your html, reference the location to your font-awesome.min.css. 64 {% highlight html %} 65 <link rel="stylesheet" href="path/to/fork-awesome/css/fork-awesome.min.css"> 66 {% endhighlight %} 67 </li> 68 <li>Check out the <a href="{{ page.relative_path }}examples/">examples</a> to start using {{ site.forkawesome.name }}!</li> 69 </ol> 70 </div> 71 72 <div class="download-preprocessors" id="download-preprocessors"> 73 <h3>Using Sass or Less</h3> 74 75 <p>Use this method to customize {{ site.forkawesome.name }} {{ site.forkawesome.version }} using Less or Sass.</p> 76 <ol> 77 <li>Copy the <code>fork-awesome/</code> directory into your project.</li> 78 <li> 79 Open your project's <code>fork-awesome/less/variables.less</code> or <code>fork-awesome/scss/_variables.scss</code> and edit the <code>@fa-font-path</code> or <code>$fa-font-path</code> 80 variable to point to your font directory. 81 {% highlight scss %} 82 @fa-font-path: "../font"; 83 {% endhighlight %} 84 <p class="alert alert-success"><i class="fa fa-info-circle"></i> The font path is relative from your compiled CSS directory.</p> 85 </li> 86 <li>Re-compile your Less or Sass if using a static compiler. Otherwise, you should be good to go.</li> 87 <li>Check out the <a href="{{ page.relative_path }}examples/">examples</a> to start using {{ site.forkawesome.name }}!</li> 88 </ol> 89 </div> 90 </section> 91 92 <div class="hr margin-top-xl"> 93 <span class="hr-text text-xl text-muted">or</span> 94 </div> 95 96 <section class="get-started-Cpp margin-top-lg" id="get-started-Cpp"> 97 <h2 class="page-header clearfix"> 98 Use {{ site.forkawesome.name }} in your C or C++ applications 99 </h2> 100 101 <div class="row"> 102 <div class="col-md-12"> 103 <p>Juliette Foucault has created a little library called <a href="https://github.com/juliettef/IconFontCppHeaders">IconFontCppHeaders</a> to help use a few icon fonts in your C or C++ projects and {{ site.forkawesome.name }} is part of it.</p> 104 {% highlight c %} 105 #include "IconsForkAwesome.h" 106 {% endhighlight %} 107 </div> 108 </div> 109 </section> 110 111 <div class="hr margin-top-xl"> 112 </div> 113 114 <section class="get-started-more margin-top-lg" id="get-started-more"> 115 <h2 class="page-header">More Information</h2> 116 </section> 117 118 <div class="row"> 119 <div class="col-md-6" id="support-validators"> 120 <h4>Validators</h4> 121 <p>In order to provide the best possible experience to old and buggy browsers, {{ site.forkawesome.name }} 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> 122 <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> 123 <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> 124 </div> 125 126 <div class="col-md-6" id="ie8-font-face"> 127 <h4>Internet Explorer 8 and @font-face</h4> 128 <p>IE8 has some issues with <code>@font-face</code> when combined with <code>:before</code>. 129 {{ site.forkawesome.name }} uses that combination. If a page is cached, and loaded without the mouse over the window 130 (i.e. hit the refresh button or load something in an iframe) then the page gets rendered before the font loads. 131 Hovering over the page (body) will show some of the icons and hovering over the remaining icons will show those as well. 132 <a href="https://github.com/FortAwesome/Font-Awesome/issues/954">See issue #954</a> for details.</p> 133 <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> 134 135 <h4>Need IE7 Support?</h4> 136 <p> 137 Sorry, {{ site.forkawesome.name }} {{ site.forkawesome.version }} 138 doesn't support IE7, but an older version of {{ site.fontawesome.name }} does (v3.2.1, if you can still find it). 139 </p> 140 </div> 141 </div> 142 143 {% include modals/download.html %}