|
1 | | -:markdown |
2 | | - #Frequently Asked Questions about Hackety Hack |
| 1 | +- content_for :sidebar do |
| 2 | + = render :partial => "shared/ask" |
| 3 | + = render :partial => "shared/support" |
3 | 4 |
|
4 | | - (or FAQ re: HH) |
| 5 | +- content_for :title do |
| 6 | + Frequently Asked Questions |
5 | 7 |
|
6 | | - ##My install of Hackety-Hack crashes? |
| 8 | +#faq |
| 9 | + :markdown |
| 10 | + (or FAQ re: HH) |
7 | 11 |
|
8 | | - Yes, we noticed that. Sorry. Multi-platform weirdness and all that. There are some known problems with HH on Windows Vista and XP, and they are being worked on. |
| 12 | + ##My install of Hackety-Hack crashes? |
9 | 13 |
|
10 | | - Always check you have the latest updates at hackety-hack.com/downloads just in case something has been fixed. |
| 14 | + Yes, we noticed that. Sorry. Multi-platform weirdness and all that. There are some known problems with HH on Windows Vista and XP, and they are being worked on. |
11 | 15 |
|
12 | | - Also, some Windows users have found that moving HH to C:\apps instead of C:\Programs.... makes HH a little happier. |
| 16 | + Always check you have the latest updates at hackety-hack.com/downloads just in case something has been fixed. |
13 | 17 |
|
14 | | - ##What tutorials are available after I finish 'Beyond Shoes'? |
| 18 | + Also, some Windows users have found that moving HH to C:\apps instead of C:\Programs.... makes HH a little happier. |
15 | 19 |
|
16 | | - There will be more Tutorials added in the future. Meanwhile may I direct your curious minds to the following excellent resources on learning more about Shoes, Ruby and programming: |
| 20 | + ##What tutorials are available after I finish 'Beyond Shoes'? |
17 | 21 |
|
18 | | - + [Shoes website](http://shoesrb.com "Shoooooes!") : links to several things Shoes-y, some repeated below. |
19 | | - + [Shoes Manual](http://shoesrb.com/manual/Hello.html "Shoes Manual!") : a light waltz through Shoes. This is available through Hackety Hack's 'Help' menu; |
20 | | - + [Nobody Knows Shoes](http://cloud.github.com/downloads/shoes/shoes/nks.pdf "Nobody Knows Shoes, with Midas") : _why's tutorial on Shoes and all the useful bits in it. Many, many, bits. |
21 | | - + Chris Pine's [Learn to program](http://pine.fm/LearnToProgram "Learn to program 1st Ed") : 1st Edition is online for free. 2nd Edition Book it as [Pragmatic Programmers](pragprog.com/LearnToProgram "Pragprog - Learn to Program 2nd Ed") is bigger, better and has many more examples) |
22 | | - + Poignant Guide to Ruby : the delightful exploration of ruby with some foxes, chunky bacon, and more of _why's stylish examples. [get it here](http://cloud.github.com/downloads/devyn/shoes-web/whys-poignant-guide-to-ruby.pdf "Poignant guide to Ruby") |
23 | | - + [Learn Ruby the Hard Way](http://ruby.learncodethehardway.org/book/) : Don't let the title scare you. This book does not assume any programming skills and yet it's great for novices and experts |
| 22 | + There will be more Tutorials added in the future. Meanwhile may I direct your curious minds to the following excellent resources on learning more about Shoes, Ruby and programming: |
24 | 23 |
|
25 | | - ##Why can't I see the Turtle? |
| 24 | + + [Shoes website](http://shoesrb.com "Shoooooes!") : links to several things Shoes-y, some repeated below. |
| 25 | + + [Shoes Manual](http://shoesrb.com/manual/Hello.html "Shoes Manual!") : a light waltz through Shoes. This is available through Hackety Hack's 'Help' menu; |
| 26 | + + [Nobody Knows Shoes](http://cloud.github.com/downloads/shoes/shoes/nks.pdf "Nobody Knows Shoes, with Midas") : _why's tutorial on Shoes and all the useful bits in it. Many, many, bits. |
| 27 | + + Chris Pine's [Learn to program](http://pine.fm/LearnToProgram "Learn to program 1st Ed") : 1st Edition is online for free. 2nd Edition Book it as [Pragmatic Programmers](pragprog.com/LearnToProgram "Pragprog - Learn to Program 2nd Ed") is bigger, better and has many more examples) |
| 28 | + + Poignant Guide to Ruby : the delightful exploration of ruby with some foxes, chunky bacon, and more of _why's stylish examples. [get it here](http://cloud.github.com/downloads/devyn/shoes-web/whys-poignant-guide-to-ruby.pdf "Poignant guide to Ruby") |
| 29 | + + [Learn Ruby the Hard Way](http://ruby.learncodethehardway.org/book/) : Don't let the title scare you. This book does not assume any programming skills and yet it's great for novices and experts |
26 | 30 |
|
27 | | - The tutorial on Turtle graphics uses `Turtle.draw` which gives the Turtle super-speed: it does the job and hides the turtle before you even see it. Turtles can be surprisingly fast. |
| 31 | + ##Why can't I see the Turtle? |
28 | 32 |
|
29 | | - Change `Turtle.draw` to `Turtle.start` to see the turtle (whom I have nicknamed 'Chell') perform each of your commands. You can also do things like saying 'Chell! I command thee!' before each step, although it will not change the program outcome. But you might enjoy it. |
| 33 | + The tutorial on Turtle graphics uses `Turtle.draw` which gives the Turtle super-speed: it does the job and hides the turtle before you even see it. Turtles can be surprisingly fast. |
30 | 34 |
|
31 | | - ##Where are my programs and samples stored? |
| 35 | + Change `Turtle.draw` to `Turtle.start` to see the turtle (whom I have nicknamed 'Chell') perform each of your commands. You can also do things like saying 'Chell! I command thee!' before each step, although it will not change the program outcome. But you might enjoy it. |
32 | 36 |
|
33 | | - *Linux* |
| 37 | + ##Where are my programs and samples stored? |
34 | 38 |
|
35 | | - + My Programs: your home directory, in the hidden folder '.hacketyhack' (eg: \users\jsmith\\.hacketyhack). |
36 | | - + Samples are in the 'samples' directory in the My Programs directory. |
| 39 | + *Linux* |
37 | 40 |
|
38 | | - *Mac OS X* |
| 41 | + + My Programs: your home directory, in the hidden folder '.hacketyhack' (eg: \users\jsmith\\.hacketyhack). |
| 42 | + + Samples are in the 'samples' directory in the My Programs directory. |
39 | 43 |
|
40 | | - + My Programs: your home directory, in the hidden folder '.hacketyhack' (eg: \Users\jsmith\\.hacketyhack). Quickest way to get there using the Finder menus > Go > Go to Folder > type `~/.hacketyhack/` then click 'Go'. The files are plain text and can be opened in any text editor. |
41 | | - + Samples are in the Hackety Hack Package (/Applications then right-click on Hackety Hack > Show Package Contents > Contents > MacOS > app > samples) |
| 44 | + *Mac OS X* |
42 | 45 |
|
43 | | - *Windows Vista / XP* |
| 46 | + + My Programs: your home directory, in the hidden folder '.hacketyhack' (eg: \Users\jsmith\\.hacketyhack). Quickest way to get there using the Finder menus > Go > Go to Folder > type `~/.hacketyhack/` then click 'Go'. The files are plain text and can be opened in any text editor. |
| 47 | + + Samples are in the Hackety Hack Package (/Applications then right-click on Hackety Hack > Show Package Contents > Contents > MacOS > app > samples) |
44 | 48 |
|
45 | | - + My Programs: In your _username_ 'Documents and Settings' folder (eg: C:\Documents and Settings\jsmith\\.hacketyhack). For the interested, the '.' at the start is left over from Linux and Mac and would otherwise make this folder hidden. But it's not on Windows. |
46 | | - + Samples are under the Shoes folder in 'Program Files' (eg: C:\Program Files\Common Files\Shoes\0.r1514\samples) |
| 49 | + *Windows Vista / XP* |
47 | 50 |
|
48 | | - ##How do I upload my programs to hackety-hack.com |
| 51 | + + My Programs: In your _username_ 'Documents and Settings' folder (eg: C:\Documents and Settings\jsmith\\.hacketyhack). For the interested, the '.' at the start is left over from Linux and Mac and would otherwise make this folder hidden. But it's not on Windows. |
| 52 | + + Samples are under the Shoes folder in 'Program Files' (eg: C:\Program Files\Common Files\Shoes\0.r1514\samples) |
49 | 53 |
|
50 | | - 1. Create an account on hackety-hack.com. Start by clicking #{link_to 'here', new_user_registration_path} |
51 | | - 2. In the HH application look for the 'Preferences' icon on the lower left side of the window |
52 | | - 3. Enter your hackety-hack.com account name and password then click 'Save' |
53 | | - 4. Now, when you create or edit a program, the 'Upload' button will be available to automatically upload the program to your page (hackety-hack.com/hackers/<youraccountname> |
| 54 | + ##How do I upload my programs to hackety-hack.com |
54 | 55 |
|
55 | | - ##What is the 'Preferences' page and the 2 text boxes? |
| 56 | + 1. Create an account on hackety-hack.com. Start by clicking #{link_to 'here', new_user_registration_path} |
| 57 | + 2. In the HH application look for the 'Preferences' icon on the lower left side of the window |
| 58 | + 3. Enter your hackety-hack.com account name and password then click 'Save' |
| 59 | + 4. Now, when you create or edit a program, the 'Upload' button will be available to automatically upload the program to your page (hackety-hack.com/hackers/<youraccountname> |
56 | 60 |
|
57 | | - The 'Preferences' are for you to type your Hackety-hack.com account details, for uploading files to your hackety-hack.com profile page. |
58 | | - This is a way for you to show others what you are doing, and a way of sharing code if you are having problems. |
59 | | - When you enter any programs there will be an 'Upload' button in the editor (next to Run) which you can use to, well, *upload* the program to your Hackety-Hack.com profile page (on the hackety-hack.com site, click 'My Page' at top-right) |
| 61 | + ##What is the 'Preferences' page and the 2 text boxes? |
60 | 62 |
|
61 | | - ##Where is my page on hackety-hack.com |
| 63 | + The 'Preferences' are for you to type your Hackety-hack.com account details, for uploading files to your hackety-hack.com profile page. |
| 64 | + This is a way for you to show others what you are doing, and a way of sharing code if you are having problems. |
| 65 | + When you enter any programs there will be an 'Upload' button in the editor (next to Run) which you can use to, well, *upload* the program to your Hackety-Hack.com profile page (on the hackety-hack.com site, click 'My Page' at top-right) |
62 | 66 |
|
63 | | - When you are logged in to hackety-hack.com, look for the 'My Page' link at top-right of page. Profile page Links look like this: hackety-hack.com/hackers/<youraccountname> |
| 67 | + ##Where is my page on hackety-hack.com |
64 | 68 |
|
65 | | - You can usually click on another user's name to get to their page. |
| 69 | + When you are logged in to hackety-hack.com, look for the 'My Page' link at top-right of page. Profile page Links look like this: hackety-hack.com/hackers/<youraccountname> |
66 | 70 |
|
67 | | - ##If I change a sample, does it change the original? |
| 71 | + You can usually click on another user's name to get to their page. |
68 | 72 |
|
69 | | - No. When you click on a Sample program, it is loaded into the Editor and you can change as much of it as you like. When you exit, the sample is not changed. |
| 73 | + ##If I change a sample, does it change the original? |
70 | 74 |
|
71 | | - You can also click the 'Copy' button in the Editor (next to 'Run') then give it a new name and it will become one of your programs. You can then edit your version as much as you wish. |
| 75 | + No. When you click on a Sample program, it is loaded into the Editor and you can change as much of it as you like. When you exit, the sample is not changed. |
72 | 76 |
|
73 | | - (**NOTE**: _There is a small bug you might experience - after the 'Copy', Hackety Hack temporarily renames the sample program as well. The sample reverts to it's correct name after HH is closed/reopened_) |
| 77 | + You can also click the 'Copy' button in the Editor (next to 'Run') then give it a new name and it will become one of your programs. You can then edit your version as much as you wish. |
74 | 78 |
|
75 | | - # Thanks! |
| 79 | + (**NOTE**: _There is a small bug you might experience - after the 'Copy', Hackety Hack temporarily renames the sample program as well. The sample reverts to it's correct name after HH is closed/reopened_) |
76 | 80 |
|
77 | | - Special thanks goes out to Eric Affleck for writing this FAQ. |
| 81 | + # Thanks! |
| 82 | + |
| 83 | + Special thanks goes out to Eric Affleck for writing this FAQ. |
0 commit comments