-
Notifications
You must be signed in to change notification settings - Fork 5
/
Copy pathindex.html
82 lines (81 loc) · 6.31 KB
/
index.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
<!doctype html>
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
<meta name="viewport" content="width=device-width,initial-scale=1">
<style type="text/css">
/*<![CDATA[*/
/*]]>*/
</style>
<link rel="stylesheet" href="../styles/tutorial.css">
<title>Cloudfour.com THE SEQUEL: A Tutorial for possible Technical Bliss?</title>
</head>
<body>
<nav id="TOC" class="toc">
<header>
<h1>On This Page</h1>
</header>
<ul>
<li><a href="#cloudfour.com-the-sequel">Cloudfour.com: THE SEQUEL</a><ul>
<li><a href="#introduction-what-are-we-doing-here">Introduction: What are we doing here?</a></li>
<li><a href="#pre-requisites-clicking-buttons-and-typing-commands">Pre-requisites: Clicking buttons and typing commands</a><ul>
<li><a href="#install-and-configure-git">Install and configure git</a></li>
<li><a href="#install-sass-scss">Install SASS (SCSS)</a></li>
<li><a href="#install-pandoc">Install Pandoc</a></li>
<li><a href="#get-the-github-gui-client">Get the GitHub GUI client</a></li>
<li><a href="#fork-the-repository">Fork the repository</a></li>
</ul></li>
<li><a href="#onward">Onward!</a></li>
</ul></li>
</ul>
</nav>
<h1 id="cloudfour.com-the-sequel"><a href="#TOC">Cloudfour.com: THE SEQUEL</a></h1>
<h2 id="introduction-what-are-we-doing-here"><a href="#TOC">Introduction: What are we doing here?</a></h2>
<p>The first thing I'm going to ask you to do is install some stuff. Cart before horse is the way I'm going here. It will be explained as we go!</p>
<h2 id="pre-requisites-clicking-buttons-and-typing-commands"><a href="#TOC">Pre-requisites: Clicking buttons and typing commands</a></h2>
<p>There are several items you'll need to get set up to get through the tutorial. Most of you already have git (except AJ, I think). Aside from configuring git, I think these steps should tak about 10 minutes if you blast right through them. git install and configuration probably doubles that, but it's:</p>
<ol type="1">
<li>Really not that bad,</li>
<li>well documented,</li>
<li>useful</li>
</ol>
<h3 id="install-and-configure-git"><a href="#TOC">Install and configure git</a></h3>
<p>It is likely that this section pertains to AJ only. I think the rest of us have <em>some</em> flavor of git on our machines.</p>
<ol type="1">
<li>Go to <a href="https://github.com/signup/free" title="Free account signup">Github</a> and create an account if you do not already have one. You're aiming for the free, open-source version. This link should do it for yah.</li>
<li>Github hosts git repositories. That is where the <code>origin</code> remote of this repository (you don't actually <em>have</em> this repository yet; panic not) is and the <code>origin</code> remote of your forked version of this repository will be. If that terminology seems baffling, try to ignore it; I'm being pedantically correct. <em>Github hosts the repositories</em> is a simpler, if not quite as accurate, statement. So you have a GitHub account, but now you need to configure <code>git</code>—the version control system—itself on your Mac.</li>
<li>Start on the <a href="http://help.github.com/mac-set-up-git/">GitHub "Set Up Git" page</a>, "Set up Git"). Do not be dismayed by the length of the page, nor that it has a lot to say about SSH keys. SSH keys are confusing and annoying (well, IMHO), but the instructions here are actually spot on and easy to follow.</li>
<li>Again, there are several steps here. But their documentation is good. This is the most involved step you'll have to deal with in this tutorial. Come get me if you get stuck.</li>
</ol>
<h3 id="install-sass-scss"><a href="#TOC">Install SASS (SCSS)</a></h3>
<ol type="1">
<li>Open Terminal window</li>
<li>Type: <code>gem install sass</code></li>
<li>That should be it. If you have a permissions error, try <code>sudo gem install sass</code>. If for some reason this fails, come get me.</li>
</ol>
<p>(Aside: SASS is a ruby gem. If you have any kind of recent OS X, you already have ruby. Curious? Try <code>which ruby</code> in a Terminal window. Assuming you get some sort of answer, you can also try <code>ruby --version</code>. I have</p>
<p><code>ruby 1.8.7 (2010-01-10 patchlevel 249) [universal-darwin11.0]</code></p>
<p>which came with Lion by default).</p>
<h3 id="install-pandoc"><a href="#TOC">Install Pandoc</a></h3>
<ol type="1">
<li>Go to the <a href="http://code.google.com/p/pandoc/downloads/list" title="Pandoc downloads">Pandoc download page</a></li>
<li>Find the link to download the <code>dmg</code> for OS X. It's currently the first link.</li>
<li>Download it and install just like any other application. Should take you, like, one minute.</li>
</ol>
<h3 id="get-the-github-gui-client"><a href="#TOC">Get the GitHub GUI client</a></h3>
<p>GitHub has the nicest GUI client for any version control system that I have ever seen in my entire life. I'm not exaggerating. <a href="http://mac.github.com/" title="GitHub for Mac">Go download it</a>. It takes barely any time to download and install. And it's pretty cute.</p>
<h3 id="fork-the-repository"><a href="#TOC">Fork the repository</a></h3>
<p>You'll want your own version of the repository in which this file normally resides. You probably received this file in another way (e.g. email) to get you started. But the rest of the tutorial is in a git repository.</p>
<ol type="1">
<li>Go to the <a href="https://github.com/lyzadanger/PandocSCSSTutorial">PandocSCSSTutorial home page on GitHub</a>.</li>
<li>Find and click the "Fork" button.</li>
<li>You will see some Hardcore Forking Action.</li>
<li>If you are using the GUI, find the "Clone in Mac" button on the resulting page. Click it. Follow the instructions to add the repository to your GitHub client. It will prompt you for a location to save the folder containing the repository. ALL GOOD.</li>
<li>If you use the command line, I bet you can figure out how to clone the resulting git repo to your local machine.</li>
<li>Go find the <code>tutorial/</code> directory and view it in a web browser. You should see this page (spooky) <em>and</em> you'll be able to get to the rest of the pages of the tutorial!</li>
</ol>
<h2 id="onward"><a href="#TOC">Onward!</a></h2>
<p>Well done, Schmotchkiss. It's time to talk about what we're up to, anyway. Aren't you curious? Let's chat <a href="philosophy.html">philosophy and purpose</a>, shall we?</p>
</nav>
</body>
</html>