From 763b87745bfd780d16d884eff4f75d6444bb285e Mon Sep 17 00:00:00 2001 From: Thomas Watson Steen Date: Mon, 17 Aug 2015 00:19:02 +0200 Subject: [PATCH 1/2] Add Getting Started page --- index.html | 10 +-- start.html | 231 +++++++++++++++++++++++++++++++++++++++++++++++++++++ style.css | 1 + 3 files changed, 236 insertions(+), 6 deletions(-) create mode 100644 start.html diff --git a/index.html b/index.html index 39c6f2a7a..06cc8ec37 100644 --- a/index.html +++ b/index.html @@ -51,6 +51,7 @@

nodeschool

Open source workshops that teach web software skills. Do them on your own or at a workshop nearby.

-

Get started by installing one of our core workshops or subscribe to our free email newsletter.

+

Get started by reading our intro guide or subscribe to our free email newsletter.

@@ -161,11 +162,7 @@

Workshoppers

Get Going —

-

You’ll need Node.js on your computer to get started - with each of these. Then use npm (it comes with Node) to install each - module with the command below it. Once installed, - simply type the workshopper’s name to launch.

-

You will also need a Text Editor, if you don't have one already, you may want one for editing code. A few options: Atom, Sublime Text, Textmate, Brackets.

+

You’ll need a few essensials before you can run your first Workshopper. Check out the Getting Started guide to get going.

@@ -177,6 +174,7 @@

Get Going —

Core

These workshoppers focus on essential skills for working with Node.js.

+

If you have never used Node.js before, you probably need to install Node.js first - In that case check out the Getting Started guide.

Stuck? Ask a question in the discussion.

diff --git a/start.html b/start.html new file mode 100644 index 000000000..f068e2904 --- /dev/null +++ b/start.html @@ -0,0 +1,231 @@ + + + + + + + + + + NodeSchool - Getting Started + + +
+
+
+ + +
+
+
+
+
+
+

Getting Started

+

Follow these simple steps to get your computer ready for running the NodeSchool chapters. Choose the instructions matching your operating system below.

+ +
+ +
+
+

Windows

+
+
+

Node.js

+

First download and install the latest version of Node.js from nodejs.org.

+

You will use npm to install each Workshopper. Npm will be installed automatically when you install Node, so you don't need to install it yourself.

+

You will be using the Command Prompt application in Windows to install and run the Workshoppers. To start the Command Prompt, open the Start menu, select "Run", type cmd in the field and hit Enter (Windows 8 users should search for and run cmd.exe).

+

The first command you should run in the Command Prompt after installing Node.js is shown below. It's just to check that everything is working as expected before you continue:

+
+
+ + + +
+
+ node --version +
+
+

This should output the version of Node.js that have been installed. It should show version 0.12 or above.

+

Next, let's check that npm is working:

+
+
+ + + +
+
+ npm --version +
+
+

Check that it correctly outputs a version number.

+

Code Editor

+

You will also need a Text Editor, if you don't have one already, you may want one for editing code. A few options: Atom, Sublime Text, Brackets.

+

Start learning

+

If you completed the steps above, you are now ready for your first Workshopper. +

+
+ +
+
+

OS X

+
+
+

Node.js

+

First download and install the latest version of Node.js from nodejs.org. Don't use nvm (Node Version Manager) or similar unless you know what you are doing or are ready to use a lot of time getting things to work properly.

+

You will use npm to install each Workshopper. Npm will be installed automatically when you install Node, so you don't need to install it yourself.

+

You will be using the Terminal application in OS X to install and run the Workshoppers. You will find it in the sub-folder "Utilities" inside your "Applications" folder. The first command you should run in the Terminal after installing Node.js is shown below. It's just to check that everything is working as expected before you continue:

+
+
+ + + +
+
+ node --version +
+
+

This should output the version of Node.js that have been installed. It should show version 0.12 or above.

+

Next, let's check that npm is working:

+
+
+ + + +
+
+ npm --version +
+
+

Check that it correctly outputs a version number.

+

Code Editor

+

You will also need a Text Editor, if you don't have one already, you may want one for editing code. A few options: Atom, Sublime Text, Textmate, Brackets.

+

Start learning

+

If you completed the steps above, you are now ready for your first Workshopper. +

+
+ +
+
+

Linux

+
+
+

Node.js

+

First install the latest version of Node.js. We normally don't recommend using your normal package manager or nvm (Node Version Manager) - instead run the commands related to your Linux distribution below in your terminal.

+

You will use npm to install each Workshopper. Npm will be installed automatically when you install Node, so you don't need to install it yourself.

+
Ubuntu
+
+
+ + + +
+
+ + curl -sL https://deb.nodesource.com/setup_0.12 | sudo -E bash -
+ sudo apt-get install -y nodejs + +
+
+
Debian
+

Run the following commands as root

+
+
+ + + +
+
+ + curl -sL https://deb.nodesource.com/setup_0.12 | bash -
+ apt-get install -y nodejs + +
+
+

After you've installed Node.js, let's just verify that it have been installed correctly:

+
+
+ + + +
+
+ node --version +
+
+

This should output the version of Node.js that have been installed. It should show version 0.12.x.

+

Next, let's check that npm is working:

+
+
+ + + +
+
+ npm --version +
+
+

Check that it correctly outputs a version number.

+
Troubleshooting
+

If you run into issues, you might be able to find a solution in the NodeSource distributions repo. If you still can't get it to work, you can download and install Node.js directly from nodejs.org.

+

Code Editor

+

You will also need a Text Editor, if you don't have one already, you may want one for editing code. A few options: Atom, Sublime Text, Brackets.

+

Start learning

+

If you completed the steps above, you are now ready for your first Workshopper. +

+
+ +
+
+
+ +
+ + + + + + diff --git a/style.css b/style.css index b0fdf0976..df4a5c5b4 100644 --- a/style.css +++ b/style.css @@ -152,6 +152,7 @@ ul.nav-lang li.selected {text-decoration: none; color: #666;} .term .chrome .btn{ border:solid 2px #777;} .term{ display: block; border-radius: 4px; margin-bottom:10px; text-align: left; } .term .shell{ min-height:130px; overflow:hidden; } +.term .shell-narrow{ min-height:auto; } .term .chrome{ height:34px; padding-left:4px; border-top:0 none; border-right:0 none; border-left:0 none; } .term .chrome:before{ content:" "; display:inline-block; height:100%; vertical-align:middle; } .term .chrome .btn{ display:inline-block; vertical-align:middle; width:8px; height:8px; border-radius:100%; } From 4512161d7caea01eabbbb26bba18d3e350761c3c Mon Sep 17 00:00:00 2001 From: Thomas Watson Steen Date: Mon, 17 Aug 2015 00:19:28 +0200 Subject: [PATCH 2/2] Add Native Modules page --- native-modules.html | 142 ++++++++++++++++++++++++++++++++++++++++++++ start.html | 6 ++ 2 files changed, 148 insertions(+) create mode 100644 native-modules.html diff --git a/native-modules.html b/native-modules.html new file mode 100644 index 000000000..a350b2465 --- /dev/null +++ b/native-modules.html @@ -0,0 +1,142 @@ + + + + + + + + + + NodeSchool - Installing Native Modules + + +
+
+
+ + +
+
+
+
+
+
+

Installing Native Modules

+

Some npm modules require native dependencies to be compiled when they are being installed (a.k.a. "native modules"). This guide will help you prepare your system for compiling native modules.

+ +
+ +
+
+

Windows

+
+
+

You need to install Microsoft Visual Studio

+
+
+ +
+
+

OS X

+
+
+

You will need the Command Line Tool package from Apple to be able to compile and install native modules. As of OS X 10.9 (Mavericks, Yosemite, El Capitan and newer) just run the command below which will guide you through installing the Command Line Tool package:

+
+
+ + + +
+
+ xcode-select --install +
+
+

If you have an earlier version of OS X, check out this guide instead.

+
+
+ +
+
+

Linux

+
+
+

You will need the build-essential package to be able to compile native modules. Follow the guide for your Linux distribution below to install it:

+

Ubuntu

+
+
+ + + +
+
+ sudo apt-get install -y build-essential +
+
+

Debian

+

Run the following command as root

+
+
+ + + +
+
+ apt-get install -y build-essential +
+
+
+
+ +
+
+
+ +
+ + + + + + diff --git a/start.html b/start.html index f068e2904..570206925 100644 --- a/start.html +++ b/start.html @@ -72,6 +72,8 @@

Node.js

Check that it correctly outputs a version number.

+

Native Modules

+

Some Workshoppers require your computer to be able to compile native modules. Check out the Installing Native Modules page for details if you run into problems.

Code Editor

You will also need a Text Editor, if you don't have one already, you may want one for editing code. A few options: Atom, Sublime Text, Brackets.

Start learning

@@ -111,6 +113,8 @@

Node.js

Check that it correctly outputs a version number.

+

Native Modules

+

Some Workshoppers require your computer to be able to compile native modules. Check out the Installing Native Modules page for details if you run into problems.

Code Editor

You will also need a Text Editor, if you don't have one already, you may want one for editing code. A few options: Atom, Sublime Text, Textmate, Brackets.

Start learning

@@ -181,6 +185,8 @@
Debian

Check that it correctly outputs a version number.

Troubleshooting

If you run into issues, you might be able to find a solution in the NodeSource distributions repo. If you still can't get it to work, you can download and install Node.js directly from nodejs.org.

+

Native Modules

+

Some Workshoppers require your computer to be able to compile native modules. Check out the Installing Native Modules page for details if you run into problems.

Code Editor

You will also need a Text Editor, if you don't have one already, you may want one for editing code. A few options: Atom, Sublime Text, Brackets.

Start learning