hackety_hack-lessons 0.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/.gitignore +18 -0
- data/Gemfile +4 -0
- data/LICENSE +22 -0
- data/README.md +29 -0
- data/Rakefile +2 -0
- data/content/data_types.md +122 -0
- data/content/datastrucs.md +142 -0
- data/content/programming.md +321 -0
- data/content/ruby.md +332 -0
- data/content/shoes.md +208 -0
- data/content/tour.md +189 -0
- data/hackety_hack-lessons.gemspec +17 -0
- data/lib/hackety_hack/lessons.rb +8 -0
- data/lib/hackety_hack/lessons/version.rb +5 -0
- metadata +59 -0
data/content/tour.md
ADDED
@@ -0,0 +1,189 @@
|
|
1
|
+
# A Tour of Hackety Hack
|
2
|
+
|
3
|
+
## Welcome!
|
4
|
+
|
5
|
+
### Why hello there!
|
6
|
+
|
7
|
+
Welcome to the Hackety Hack tour!
|
8
|
+
|
9
|
+
This whole side of the screen is the _Hackety Hack Tutor_. You can move forward
|
10
|
+
through the lessons by clicking the _Next_ button:
|
11
|
+
|
12
|
+

|
13
|
+
|
14
|
+
Give it a shot!
|
15
|
+
|
16
|
+
### Good Job!
|
17
|
+
|
18
|
+
See? Super easy. Let's explore the rest of Hackety Hack.
|
19
|
+
|
20
|
+
You can access the different functions of Hackety through the buttons on the
|
21
|
+
left side of the screen. For example, you got here by clicking on 'Lessons.'
|
22
|
+
There are 8 of those buttons, but since you're already on Lessons, let's talk
|
23
|
+
about them first.
|
24
|
+
|
25
|
+
Before we move on, just take a minute to look at the controls in the bar below.
|
26
|
+
|
27
|
+

|
28
|
+
__back__: goes back one page
|
29
|
+
|
30
|
+

|
31
|
+
__continue__: goes to the next page
|
32
|
+
|
33
|
+

|
34
|
+
__menu__: makes it easy to jump around to any lesson
|
35
|
+
|
36
|
+

|
37
|
+
__close__: closes the tutor
|
38
|
+
|
39
|
+
Don't forget! Press this to move to the next part:
|
40
|
+
|
41
|
+

|
42
|
+
|
43
|
+
Have at it!
|
44
|
+
|
45
|
+
## Lessons
|
46
|
+
|
47
|
+
### A Lesson lesson.
|
48
|
+
|
49
|
+
When you click on the Lesson button, it'll bring you to a list of all of the
|
50
|
+
lessons that come with Hackety. For now, there's just a few. More Lessons will
|
51
|
+
be added, and eventually, you'll be able to write and share your own Lessons
|
52
|
+
with other Hackety Hackers.
|
53
|
+
|
54
|
+
Lessons are just simple
|
55
|
+
[Markdown](http://daringfireball.net/projects/markdown/syntax) files. Markdown
|
56
|
+
looks just like writing normal text, but with some extra characters for text
|
57
|
+
that's __bold__ or _italicized_, adding images, and stuff like that.
|
58
|
+
|
59
|
+
## Home
|
60
|
+
|
61
|
+
### Welcome Home
|
62
|
+
|
63
|
+
This is the home screen, which shows you two very important things: your own
|
64
|
+
programs, and the sample programs. Everyone starts off with one simple program:
|
65
|
+
Hello, world! Check it out:
|
66
|
+
|
67
|
+
alert "Hello, world!"
|
68
|
+
|
69
|
+
This is an actual Ruby program! You'll learn more about Ruby itself in the
|
70
|
+
Beginning Ruby Lesson.
|
71
|
+
|
72
|
+
### Samples
|
73
|
+
|
74
|
+
If you click on the 'Samples' tab, you can see a bunch of sample programs that
|
75
|
+
we've included for some inspiration. There's a few interesting animations, some
|
76
|
+
games, and a few other things.
|
77
|
+
|
78
|
+
That's all there really is to say about the homepage. Try opening the Editor.
|
79
|
+
Here's its icon:
|
80
|
+
|
81
|
+

|
82
|
+
|
83
|
+
## Editor
|
84
|
+
|
85
|
+
### Using the Editor
|
86
|
+
|
87
|
+
This is where the magic happens: all of your programs will be created in the
|
88
|
+
editor. Give it a shot: try typing this program in.
|
89
|
+
|
90
|
+
name = ask "What is your name?"
|
91
|
+
alert "Hello, " + name + "."
|
92
|
+
|
93
|
+
After doing so, you can try running the program by pressing the 'Run' button in
|
94
|
+
the lower right corner.
|
95
|
+
|
96
|
+
### Saving and Uploading Programs
|
97
|
+
|
98
|
+
To save your program, simply click the 'Save' button. It'll prompt you for a
|
99
|
+
title, and then the program will appear on your Home screen.
|
100
|
+
|
101
|
+
Once you've saved your program, two new buttons appear: 'Copy' and 'Upload.'
|
102
|
+
Copy will duplicate your program, and then ask you for a new name. This is
|
103
|
+
really useful if you'd like to modify one of the example programs. Upload will
|
104
|
+
send a copy of your program to the Hackety Hack website, where you can show it
|
105
|
+
off to other Hackety Hackers. :) More about this when we talk about Preferences.
|
106
|
+
|
107
|
+
## Help
|
108
|
+
|
109
|
+
### Getting Help
|
110
|
+
|
111
|
+
The next tab is the Help tab. It looks like this:
|
112
|
+
|
113
|
+

|
114
|
+
|
115
|
+
Click it, and it'll open up a new window. Browse around and come back, I'll be
|
116
|
+
here.
|
117
|
+
|
118
|
+
### Okay, well... Shoes.
|
119
|
+
|
120
|
+
That's a lot of help! Hackety Hack is built with Shoes, which is a toolkit for
|
121
|
+
creating GUI programs in Ruby. All of the programs that you make in Hackety Hack
|
122
|
+
are built with Shoes. That manual contains the entire Shoes reference, and
|
123
|
+
there's a lot! Luckily, there's also a much shorter cheat sheet too...
|
124
|
+
|
125
|
+
## Cheat
|
126
|
+
|
127
|
+
### Short and sweet.
|
128
|
+
|
129
|
+
Peek at the Cheat Sheet by clicking the icon like this:
|
130
|
+
|
131
|
+

|
132
|
+
|
133
|
+
The Cheat Sheet is much simpler. It just contains some helpful bits that you
|
134
|
+
should find useful. A quick reference of often used bits. And a short sheet
|
135
|
+
deserves a short explanation.
|
136
|
+
|
137
|
+
## About
|
138
|
+
|
139
|
+
### About Hackety
|
140
|
+
|
141
|
+
The classic About box. These have been around basically since the beginning of
|
142
|
+
time. It's just a fun little image that tells you what version of Hackety Hack
|
143
|
+
you're using. It'll change with every release.
|
144
|
+
|
145
|
+

|
146
|
+
|
147
|
+
Time for the last one...
|
148
|
+
|
149
|
+
## Preferences
|
150
|
+
|
151
|
+
### I do prefer...
|
152
|
+
|
153
|
+
The Preferences icon is towards the bottom, and looks like this:
|
154
|
+
|
155
|
+

|
156
|
+
|
157
|
+
This lets you adjust your preferences for Hackety Hack. Right now, there's only
|
158
|
+
one preference: linking Hackety with your account on
|
159
|
+
[hackety-hack.com](http://hackety-hack.com). You __do__ have one of those,
|
160
|
+
right?
|
161
|
+
|
162
|
+
If you link your account, you can upload your programs to the website and easily
|
163
|
+
share them with others! More interesting features will be developed along these
|
164
|
+
lines, so sign up, stick your info in, and prepare for all kinds of awesome.
|
165
|
+
|
166
|
+
## Quit
|
167
|
+
|
168
|
+
### Self-explanatory
|
169
|
+
|
170
|
+
If you did click the quit icon, well, you wouldn't be here anymore. And that'd
|
171
|
+
be unfortunate. So, don't click it until you're good and ready. When it's your
|
172
|
+
time to go, it'll be there waiting for you.
|
173
|
+
|
174
|
+

|
175
|
+
|
176
|
+
Come back soon!
|
177
|
+
|
178
|
+
## ... and beyond!
|
179
|
+
|
180
|
+
### What now?
|
181
|
+
|
182
|
+
This concludes the Hackety Hack tour. Good job! Now you know everything that
|
183
|
+
Hackety Hack can do. It's pretty simple!
|
184
|
+
|
185
|
+
This isn't the only lesson that we have for you, though. Give the 'Basic
|
186
|
+
Programming' lesson a shot to actually start learning how to make programs of
|
187
|
+
your own.
|
188
|
+
|
189
|
+
What are you waiting for? Get going!
|
@@ -0,0 +1,17 @@
|
|
1
|
+
# -*- encoding: utf-8 -*-
|
2
|
+
require File.expand_path('../lib/hackety_hack/lessons/version', __FILE__)
|
3
|
+
|
4
|
+
Gem::Specification.new do |gem|
|
5
|
+
gem.authors = ["Steve Klabnik"]
|
6
|
+
gem.email = ["steve@steveklabnik.com"]
|
7
|
+
gem.description = %q{A set of lessons to learn Ruby programming, from the Hackety Hack project.}
|
8
|
+
gem.summary = %q{The lessons from Hackety Hack.}
|
9
|
+
gem.homepage = "http://hackety.com/lessons"
|
10
|
+
|
11
|
+
gem.executables = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
|
12
|
+
gem.files = `git ls-files`.split("\n")
|
13
|
+
gem.test_files = `git ls-files -- {test,spec,features}/*`.split("\n")
|
14
|
+
gem.name = "hackety_hack-lessons"
|
15
|
+
gem.require_paths = ["lib"]
|
16
|
+
gem.version = HacketyHack::Lessons::VERSION
|
17
|
+
end
|
metadata
ADDED
@@ -0,0 +1,59 @@
|
|
1
|
+
--- !ruby/object:Gem::Specification
|
2
|
+
name: hackety_hack-lessons
|
3
|
+
version: !ruby/object:Gem::Version
|
4
|
+
version: 0.0.1
|
5
|
+
prerelease:
|
6
|
+
platform: ruby
|
7
|
+
authors:
|
8
|
+
- Steve Klabnik
|
9
|
+
autorequire:
|
10
|
+
bindir: bin
|
11
|
+
cert_chain: []
|
12
|
+
date: 2012-01-25 00:00:00.000000000 Z
|
13
|
+
dependencies: []
|
14
|
+
description: A set of lessons to learn Ruby programming, from the Hackety Hack project.
|
15
|
+
email:
|
16
|
+
- steve@steveklabnik.com
|
17
|
+
executables: []
|
18
|
+
extensions: []
|
19
|
+
extra_rdoc_files: []
|
20
|
+
files:
|
21
|
+
- .gitignore
|
22
|
+
- Gemfile
|
23
|
+
- LICENSE
|
24
|
+
- README.md
|
25
|
+
- Rakefile
|
26
|
+
- content/data_types.md
|
27
|
+
- content/datastrucs.md
|
28
|
+
- content/programming.md
|
29
|
+
- content/ruby.md
|
30
|
+
- content/shoes.md
|
31
|
+
- content/tour.md
|
32
|
+
- hackety_hack-lessons.gemspec
|
33
|
+
- lib/hackety_hack/lessons.rb
|
34
|
+
- lib/hackety_hack/lessons/version.rb
|
35
|
+
homepage: http://hackety.com/lessons
|
36
|
+
licenses: []
|
37
|
+
post_install_message:
|
38
|
+
rdoc_options: []
|
39
|
+
require_paths:
|
40
|
+
- lib
|
41
|
+
required_ruby_version: !ruby/object:Gem::Requirement
|
42
|
+
none: false
|
43
|
+
requirements:
|
44
|
+
- - ! '>='
|
45
|
+
- !ruby/object:Gem::Version
|
46
|
+
version: '0'
|
47
|
+
required_rubygems_version: !ruby/object:Gem::Requirement
|
48
|
+
none: false
|
49
|
+
requirements:
|
50
|
+
- - ! '>='
|
51
|
+
- !ruby/object:Gem::Version
|
52
|
+
version: '0'
|
53
|
+
requirements: []
|
54
|
+
rubyforge_project:
|
55
|
+
rubygems_version: 1.8.10
|
56
|
+
signing_key:
|
57
|
+
specification_version: 3
|
58
|
+
summary: The lessons from Hackety Hack.
|
59
|
+
test_files: []
|