From bc7103614b9b0cfc4c4a471d46c5581f83cc939d Mon Sep 17 00:00:00 2001 From: Kelsey Breseman Date: Sun, 13 Sep 2015 12:36:06 -0700 Subject: [PATCH] translated prereqs and finished to markdown --- cmd.html | 209 ++------------------------------------------------ cmd.md | 178 ++++++++++++++++++++++++++++++++++++++++++ finished.html | 45 +---------- finished.md | 33 ++++++++ 4 files changed, 220 insertions(+), 245 deletions(-) create mode 100644 cmd.md create mode 100644 finished.md diff --git a/cmd.html b/cmd.html index 1579b88..c2fbc17 100644 --- a/cmd.html +++ b/cmd.html @@ -2,208 +2,9 @@ layout: default --- -

Command Line Basics

-

Using Tessel is just like web development. But if -you're not familiar with web development, you might want -to take a minute or two to get comfortable with some key -tools of the trade: the command line (the "terminal", -where you execute commands) and the text editor, where -you will work on and save your programs.

-

Select the operating system you are working on.

-
-
- OSX -
-
- Linux -
-
- Windows -
-
-
-
-

Open up the application on your computer called - “Terminal” by pressing ⌘ + SPACE and typing - “Terminal”.

-

Its dock icon looks like - , and the terminal will look something like - -

-

You can use the terminal to write commands to your - computer (this is the “command line”). Let’s try it - out!

-

In your terminal, - type

ls -

and hit enter.

-

The ls command, short for “list”, - tells your computer to list all of the file names for - the folder you’re in. Your list of files probably - includes “Desktop” and “Documents”, among others. - Let’s try another command: type

cd - Documents -

and hit enter.

-

You are now in the Documents folder; - cd means “change directory”. If you try - ls again, you should see the contents of - your Documents folder listed out. If you want to - compare, open up Finder and look in Documents to see - the same files.

-

Let’s get back to the folder we were in - before:

cd .. -

You changed directory - again!

ls -

to see what we have here. You’re back where you - started! The .. after cd - tells it to go up one folder in the directory.

-

Ok, now you're a cool hacker who can use the - terminal (or "console") to write in the command line. - (If you want to learn more commands, there are a - whole bunch of them here. I recommend pwd, - open, mkdir, - touch, mv, and - cp.)

-
-
-

Open up the application on your computer called - “Terminal” by tapping the SUPER key (Windows or Apple - key, depending on your hardware) and typing - “Terminal”.

-

Its icon looks like - , and the terminal will look something like - -

-

You can use the terminal to write commands to your - computer (this is the “command line”). Let’s try it - out!

-

In your terminal, - type

ls -

and hit enter.

-

The ls command, short for “list”, - tells your computer to list all of the file names for - the folder you’re in. Your list of files probably - includes “Desktop” and “Documents”, among others. - Let’s try another command: type

cd - Documents -

and hit enter.

-

You are now in the Documents folder; - cd means “change directory”. If you try - ls again, you should see the contents of - your Documents folder listed out. If you want to - compare, open up Finder and look in Documents to see - the same files.

-

Let’s get back to the folder we were in - before:

cd .. -

You changed directory - again!

ls -

to see what we have here. You’re back where you - started! The .. after cd - tells it to go up one folder in the directory.

-

Ok, now you're a cool hacker who can use the - terminal (or "console") to write in the command line. - (If you want to learn more commands, there are a - whole bunch of them here. I recommend pwd, - open, mkdir, - touch, mv, and - cp.)

-
-
-

Open up the application on your computer called - “Command Prompt”.

-

If you’re not on Windows 8, go to the start menu - and type “Command Prompt”.

-

If you are on Windows 8+, swipe right to find - “Windows System”, within which you can find “Command - Prompt”.

-

Its icon looks like - , and the application (the terminal) will look - something like -

-

You can use the terminal to write commands to your - computer (this is the “command line”). Let’s try it - out!

-

In your terminal, - type

dir -

and hit enter.

-

The dir command, short for - “directory”, tells your computer to list all of the - file names for the folder you’re in. Your list of - files probably includes “Desktop” and “Documents”, - among others. Let’s try another command:

-

Now type

cd Documents -

into your command line and press enter.

-

You are now in the Documents folder; - cd means “change directory”. If you try - dir again, you should see the contents - of your Documents folder listed out. If you want to - compare, open up My Comuter and look in Documents to - see the same files.

-

Let’s get back to the folder we were in - before:

cd .. -

You changed directory - again!

dir -

to see what we have here. You’re back where you - started! The .. after cd - tells it to go up one folder in the directory.

-

Now you’re a cool hacker who can use the terminal - to write in the command line. (If you want to learn - more commands, there are a whole bunch of them - here.)

-
-
- - -
-
-

Text Editors

-

You will also need a text editor to save your -JavaScript files. This means a plaintext editor, not a -Word document.

-

Here are some good options:

- + -

Typically, directions that belong in the command line -are one line, whereas longer scripts, such as anything in -JavaScript, should be typed into the text editor and -saved, then run through the command line.

- -

In the context of this tutorial, things that should be -run in the command line look

like -this - -

And scripts that should be saved in the text editor -will look

- -
-  like this
-
- -
- -
-
- Next: Install -
-
+{% capture include_install %} +{% include_relative cmd.md %} +{% endcapture %} +{{ include_install | markdownify | replace: '

|','

' | replace: '|

','
' | replace: '||','
' }} diff --git a/cmd.md b/cmd.md new file mode 100644 index 0000000..a39e914 --- /dev/null +++ b/cmd.md @@ -0,0 +1,178 @@ +{::options parse_block_html="true" /} + +
+
+ +# Command Line Basics + +Using Tessel is just like web development. But if +you're not familiar with web development, you might want +to take a minute or two to get comfortable with some key +tools of the trade: the command line (the "terminal", +where you execute commands) and the text editor, where +you will work on and save your programs. + +Select the operating system you are working on. + +
+| [OSX](#tab-osx) || [Linux](#tab-linux) || [Windows](#tab-windows) | +
+ +
+ +
+ +Open up the application on your computer called “Terminal” by pressing ⌘ + SPACE and typing “Terminal”. + +Its dock icon looks like ![](https://s3.amazonaws.com/technicalmachine-assets/fre+assets/mac-term-icon.png), and the terminal will look something like ![](https://s3.amazonaws.com/technicalmachine-assets/fre+assets/mac-term.png) + +You can use the terminal to write commands to your computer (this is the “command line”). Let’s try it out! + +In your terminal, type + +`ls` + +and hit enter. + +The `ls` command, short for “list”, tells your computer to list all of the file names for the folder you’re in. Your list of files probably includes “Desktop” and “Documents”, among others. + +Let’s try another command: type + +`cd Documents` + +and hit enter. + +You are now in the Documents folder; `cd` means “change directory”. If you try `ls` again, you should see the contents of your Documents folder listed out. If you want to compare, open up Finder and look in Documents to see the same files. + +Let’s get back to the folder we were in before: `cd ..` + +You changed directory again! `ls` +to see what we have here. You’re back where you started! The `..` after `cd` tells it to go up one folder in the directory. + +Ok, now you're a cool hacker who can use the terminal (or "console") to write in the command line. + +(If you want to learn more commands, there are a whole bunch of them here. I recommend `pwd`, `open`, `mkdir`, `touch`, `mv`, and `cp`.) + +
+ +
+ +Open up the application on your computer called “Terminal” by tapping the SUPER key (Windows or Apple key, depending on your hardware) and typing “Terminal”. + +Its icon looks like ![](https://s3.amazonaws.com/technicalmachine-assets/fre+assets/mac-term-icon.png), and the terminal will look something like ![](https://s3.amazonaws.com/technicalmachine-assets/fre+assets/mac-term.png) + +You can use the terminal to write commands to your computer (this is the “command line”). Let’s try it out! + +In your terminal, type + +`ls` + +and hit enter. + +The `ls` command, short for “list”, tells your computer to list all of the file names for the folder you’re in. Your list of files probably includes “Desktop” and “Documents”, among others. + +Let’s try another command: type + +`cd Documents` + +and hit enter. + +You are now in the Documents folder; `cd` means “change directory”. If you try `ls` again, you should see the contents of your Documents folder listed out. If you want to compare, open up Finder and look in Documents to see the same files. + +Let’s get back to the folder we were in before: `cd ..` + +You changed directory again! `ls` +to see what we have here. You’re back where you started! The `..` after `cd` tells it to go up one folder in the directory. + +Ok, now you're a cool hacker who can use the terminal (or "console") to write in the command line. + +(If you want to learn more commands, there are a whole bunch of them here. I recommend `pwd`, `open`, `mkdir`, `touch`, `mv`, and `cp`.) + +
+ +
+ +Open up the application on your computer called “Command Prompt”. + +If you’re not on Windows 8, go to the start menu and type “Command Prompt”. + +If you are on Windows 8+, swipe right to find “Windows System”, within which you can find “Command Prompt”. + +Its icon looks like ![](https://s3.amazonaws.com/technicalmachine-assets/fre+assets/win-term-icon.png), and the application (the terminal) will look something like ![](https://s3.amazonaws.com/technicalmachine-assets/fre+assets/win-term.png) + +You can use the terminal to write commands to your computer (this is the “command line”). Let’s try it out! + +In your terminal, type + +`dir` + +and hit enter. + +The `dir` command, short for “directory”, tells your computer to list all of the file names for the folder you’re in. Your list of files probably includes “Desktop” and “Documents”, among others. Let’s try another command: + +Now type + +`cd Documents` + +into your command line and press enter. + +You are now in the Documents folder; `cd` means “change directory”. If you try `dir` again, you should see the contents of your Documents folder listed out. If you want to compare, open up My Comuter and look in Documents to see the same files. + +Let’s get back to the folder we were in before: + +`cd ..` + +You changed directory again! + +`dir` + +to see what we have here. You’re back where you started! The `..` after `cd` tells it to go up one folder in the directory. + +Now you’re a cool hacker who can use the terminal to write in the command line. (If you want to learn more commands, there are a whole bunch of them here.) + +
+
+
+
+ +
+
+ +
+### Text Editors + +You will also need a text editor to save your JavaScript files. This means a plaintext editor, not a Word document. + +Here are some good options: + +* [Sublime Text](http://www.sublimetext.com/) +* [Atom](https://atom.io/) +* [Notepad++](http://notepad-plus-plus.org/) + +
+ +Typically, directions that belong in the command line +are one line, whereas longer scripts, such as anything in +JavaScript, should be typed into the text editor and +saved, then run through the command line. + +In the context of this tutorial, things that should be +run in the command line look `like this` + +And scripts that should be saved in the text editor +will look + +
+  like this
+
+ +
+
+ +
+ +
+
+Next: Install +
+
diff --git a/finished.html b/finished.html index 1c0f8c5..34e8c5a 100644 --- a/finished.html +++ b/finished.html @@ -2,44 +2,7 @@ layout: default --- -

Congratulations!

- -

You've completed the Tessel Tutorial!

- -

What's next?

- -

Check out Tessel projects →

- -

Learn more in Tessel's docs →

- -

Contribute to Tessel's open source -codebase →

- -

Follow us to stay up-to-date on new -developments:

- -

- - - -

- -
- -
-
- Prev: CLI Usage -
-
+{% capture include_install %} +{% include_relative finished.md %} +{% endcapture %} +{{ include_install | markdownify }} diff --git a/finished.md b/finished.md new file mode 100644 index 0000000..7a33b0a --- /dev/null +++ b/finished.md @@ -0,0 +1,33 @@ +{::options parse_block_html="true" /} + +
+
+ +# Congratulations! + +You've completed the Tessel Tutorial! + +

What's next?

+ +Check out Tessel projects → + +Learn more in Tessel's docs → + +Contribute to Tessel's open source codebase → + +Follow us to stay up-to-date on new developments: + + + + + +
+
+ +
+ +
+
+ Prev: CLI Usage +
+