Fork-Awesome/get-started/index.html
2018-02-27 22:21:23 -05:00

287 lines
16 KiB
HTML

<!DOCTYPE html>
<html lang="en">
<head>
<!-- Basic Page Needs
================================================== -->
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="description" content="Fork Awesome, a fork of the iconic font and CSS framework">
<meta name="author" content="Dave Gandy">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<link rel="shortcut icon" href="../assets/ico/favicon.ico">
<title>Get Started with Fork Awesome</title>
<!-- CSS
================================================== -->
<link rel="stylesheet" href="../assets/css/site.css">
<link rel="stylesheet" href="../assets/css/pygments.css">
<link rel="stylesheet" href="../assets/css/share.min.css">
<link rel="stylesheet" href="../assets/fork-awesome/css/fork-awesome.css">
<!--[if lt IE 9]>
<script src="../assets/js/html5shiv.js"></script>
<script src="../assets/js/respond.min.js"></script>
<![endif]-->
</head>
<body class="font-awesome v-get-started">
<div id="wrap"> <!-- necessary for sticky footer. wrap all content except footer -->
<div class="navbar navbar-inverse navbar-static-top hidden-print">
<div class="container">
<div class="navbar-header">
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
<i class="fa fa-bars fa-lg" aria-hidden="true" title="Toggle navigation"></i>
<span class="sr-only">Toggle navigation</span>
</button>
<a class="navbar-brand" href="../"><i class="fa fa-fork-awesome" aria-hidden="true"></i> Fork Awesome</a>
</div>
<div class="navbar-collapse collapse">
<ul class="nav navbar-nav">
<li class="hidden-sm "><a href="../">Home</a></li>
<li class="hidden-sm">
<a href="../whats-new/">What's New</a>
</li>
<li class="hidden-xs hidden-md hidden-lg">
<a href="../whats-new/">New</a>
</li>
<li class="hidden-sm active"><a href="../get-started/">Get Started</a></li>
<li class="hidden-xs hidden-md hidden-lg active">
<a href="../get-started/">Start</a>
</li>
<li class="dropdown-split-left"><a href="../icons/">Icons</a></li>
<li class="dropdown dropdown-split-right hidden-xs">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">
<i class="fa fa-caret-down" aria-hidden="true" title="Toggle dropdown menu"></i>
<span class="sr-only">Toggle dropdown menu</span>
<span class="toggle drop down"></span>
</a>
<ul class="dropdown-menu pull-right">
<li><a href="../icons/"><i class="fa fa-flag fa-fw" aria-hidden="true"></i>&nbsp; All Icons</a></li>
<li class="divider"></li>
<li><a href="../icons/#new"><i class="fa fa-handshake-o fa-fw" aria-hidden="true"></i>&nbsp; New Icons in 4.7</a></li>
<li><a href="../icons/#web-application"><i class="fa fa-camera-retro fa-fw" aria-hidden="true"></i>&nbsp; Web Application Icons</a></li>
<li><a href="../icons/#accessibility"><i class="fa fa-universal-access fa-fw" aria-hidden="true"></i>&nbsp; Accessibility Icons</a></li>
<li><a href="../icons/#hand"><i class="fa fa-hand-spock-o fa-fw" aria-hidden="true"></i>&nbsp; Hand Icons</a></li>
<li><a href="../icons/#transportation"><i class="fa fa-ship fa-fw" aria-hidden="true"></i>&nbsp; Transportation Icons</a></li>
<li><a href="../icons/#gender"><i class="fa fa-venus fa-fw" aria-hidden="true"></i>&nbsp; Gender Icons</a></li>
<li><a href="../icons/#file-type"><i class="fa fa-file-image-o fa-fw" aria-hidden="true"></i>&nbsp; File Type Icons</a></li>
<li><a href="../icons/#spinner"><i class="fa fa-spinner fa-fw" aria-hidden="true"></i>&nbsp; Spinner Icons</a></li>
<li><a href="../icons/#form-control"><i class="fa fa-check-square fa-fw" aria-hidden="true"></i>&nbsp; Form Control Icons</a></li>
<li><a href="../icons/#payment"><i class="fa fa-credit-card fa-fw" aria-hidden="true"></i>&nbsp; Payment Icons</a></li>
<li><a href="../icons/#chart"><i class="fa fa-pie-chart fa-fw" aria-hidden="true"></i>&nbsp; Chart Icons</a></li>
<li><a href="../icons/#currency"><i class="fa fa-won fa-fw" aria-hidden="true"></i>&nbsp; Currency Icons</a></li>
<li><a href="../icons/#text-editor"><i class="fa fa-file-text-o fa-fw" aria-hidden="true"></i>&nbsp; Text Editor Icons</a></li>
<li><a href="../icons/#directional"><i class="fa fa-arrow-right fa-fw" aria-hidden="true"></i>&nbsp; Directional Icons</a></li>
<li><a href="../icons/#video-player"><i class="fa fa-play-circle fa-fw" aria-hidden="true"></i>&nbsp; Video Player Icons</a></li>
<li><a href="../icons/#brand"><i class="fa fa-facebook-official fa-fw" aria-hidden="true"></i>&nbsp; Brand Icons</a></li>
<li><a href="../icons/#medical"><i class="fa fa-medkit fa-fw" aria-hidden="true"></i>&nbsp; Medical Icons</a></li>
</ul>
</li>
<li class="dropdown-split-left"><a href="../examples/">Examples</a></li>
<li class="dropdown dropdown-split-right hidden-xs">
<a href="#" class="dropdown-toggle" data-toggle="dropdown">
<i class="fa fa-caret-down" aria-hidden="true" title="Toggle dropdown menu"></i>
<span class="sr-only">Toggle dropdown menu</span>
<span class="toggle drop down"></span>
</a>
<ul class="dropdown-menu pull-right">
<li><a href="../examples/">Examples</a></li>
<li class="divider"></li>
<li><a href="../examples/#basic">Basic Icons</a></li>
<li><a href="../examples/#larger">Larger Icons</a></li>
<li><a href="../examples/#fixed-width">Fixed Width Icons</a></li>
<li><a href="../examples/#list">List Icons</a></li>
<li><a href="../examples/#bordered-pulled">Bordered & Pulled Icons</a></li>
<li><a href="../examples/#animated">Animated Icons</a></li>
<li><a href="../examples/#accessible">Accessibility-Minded</a></li>
<li><a href="../examples/#rotated-flipped">Rotated &amp; Flipped Icons</a></li>
<li><a href="../examples/#stacked">Stacked Icons</a></li>
<li><a href="../examples/#bootstrap">Bootstrap 3 Examples</a></li>
<li><a href="../examples/#custom">Custom CSS</a></li>
</ul>
</li>
<li class="hidden-sm"><a href="../accessibility/">Accessibility</a></li>
<li class="hidden-xs hidden-md hidden-lg"><a href="../accessibility/"><i class="fa fa-universal-access"></i></a></li>
<li><a href="../community/">Community</a></li>
<li><a href="../license/">License</a></li>
</ul>
</div>
</div>
</div>
<div class="jumbotron jumbotron-ad hidden-print">
<div class="container">
<h1><i class="fa fa-cogs" aria-hidden="true"></i>&nbsp; Get Started</h1>
<p>Easy ways to get Fork Awesome 1.0.9 onto your website</p>
</div>
</div>
<div class="container">
<section class="get-started-download" id="get-started-download">
<h2 class="page-header clearfix">
Download &amp; 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 Fork Awesome assets yourself? You can
<a href="#modal-download" data-toggle="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">
<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>&lt;head&gt;</code> of your html, reference the location to your font-awesome.min.css.
<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/fork-awesome/css/fork-awesome.min.css&quot;</span><span class="nt">&gt;</span>
</code></pre></div>
</li>
<li>Check out the <a href="../examples/">examples</a> to start using Fork Awesome!</li>
</ol>
</div>
<div class="download-preprocessors" id="download-preprocessors">
<h3>Using Sass or Less</h3>
<p>Use this method to customize Fork Awesome 1.0.9 using Less or Sass.</p>
<ol>
<li>Copy the <code>fork-awesome/</code> directory into your project.</li>
<li>
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>
variable to point to your font directory.
<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>
</code></pre></div>
<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="../examples/">examples</a> to start using Fork Awesome!</li>
</ol>
</div>
</section>
<section class="get-started-CDN margin-top-lg" id="get-started-CDN">
<h2 class="page-header">Using Fork Awesome with a CDN</h2>
</section>
<div class="row">
<div class="col-md-12">
<p>Thanks to <a href="https://www.jsdelivr.com">jsDelivr</a>, Fork Awesome is available via a CDN as well.</p>
<p>
<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;https://cdn.jsdelivr.net/npm/fork-awesome@1.0.9/css/fork-awesome.min.css&quot;</span> <span class="na">integrity=</span><span class="s">&quot;sha256-NlvbkkuyNKWHflmMC9F+eaZ3tN19fxoT2atylbrqwKY=&quot;</span> <span class="na">crossorigin=</span><span class="s">&quot;anonymous&quot;</span><span class="nt">&gt;</span>
</code></pre></div>
</p>
</div>
</div>
<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, Fork 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>.
Fork 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>
<h4>Need IE7 Support?</h4>
<p>
Sorry, Fork Awesome 1.0.9
doesn't support IE7, but an older version of Font Awesome does (v3.2.1, if you can still find it).
</p>
</div>
</div>
<div class="modal fade" id="modal-download" tabindex="-1" role="dialog" aria-labelledby="modal-download-label"
xmlns="http://www.w3.org/1999/html">
<div class="modal-dialog" role="document">
<div class="modal-content">
<div class="modal-header">
<button type="button" class="close" data-dismiss="modal" aria-label="Close"><i class="fa fa-times" aria-hidden="true"></i><span class="close"></span></button>
<h2 class="modal-title" id="modal-download-label">
<i class="fa fa-download fa-lg" aria-hidden="true"></i>&nbsp;
Download
</h2>
</div>
<div class="modal-body">
<a class="btn btn-primary btn-lg btn-block" href="../assets/fork-awesome-1.0.9.zip">
Fork Awesome 1.0.9
</a>
<div class="row margin-bottom-lg margin-top-lg">
<div class="col-md-12 text-center">
More ways to install Fork Awesome coming soon!<br/>
In the meantime, don't forget to read <a href="../get-started">how to get started</a>.
</div>
</div>
</div>
</div>
</div>
</div>
</div>
<footer id="footer" class="footer hidden-print">
<div class="container text-center">
<div>
<i class="fa fa-fork" aria-hidden="true"></i> Fork Awesome 1.0.9
<span class="hide-xs">&middot;</span><br class="hide-sm hide-md hide-lg">
A fork of Font Awesome, originally created by <a href="https://twitter.com/davegandy">Dave Gandy</a>
</div>
<div>
Fork Awesome is licensed under <a href="http://scripts.sil.org/OFL">SIL OFL 1.1</a>
<span class="hide-xs">&middot;</span><br class="hide-sm hide-md hide-lg">
Code is licensed under <a href="http://opensource.org/licenses/mit-license.html">MIT License</a>
<span class="hide-xs hide-sm">&middot;</span><br class="hide-md hide-lg">
Documentation is licensed under <a href="http://creativecommons.org/licenses/by/3.0/">CC BY 3.0</a>
</div>
<div class="project">
<a href="https://github.com/ForkAwesome/Fork-Awesome">GitHub Project</a> &middot;
<a href="https://github.com/ForkAwesome/Fork-Awesome/issues">Issues</a>
</div>
</div>
</footer>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
<script src="https://ajax.aspnetcdn.com/ajax/jquery.validate/1.13.1/jquery.validate.min.js"></script>
<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/js/bootstrap.min.js"></script>
<script src="../assets/js/site.js"></script>
<script src="../assets/js/share.min.js"></script>
</body>
</html>