- Install MsysGIT and TortoiseGit
- Install Python 2.7 (NOTE: Do not download Python 3.X even if you're tempted...)
- Install PuttyGen
- Downalod some sore of Git client. I prefer Source Tree.
Let's start by generating SSH keys.
- Run PuttyGen
- Generate key and save both private and public keys to /Users/<your_name>/.ssh. You don't really need to add a paraphrase. A conventional naming scheme would be id_rsa for the private key and id_rsa.pub for the public key.
- Go to your profile page in Assembla and click on the "Manage SSH Keys" link on the left navigation bar.
- Upload the public key you've just generated.
- Open Terminal
- Run "ssh-keygen -t rsa" and follow the instructions. No need to add a paraphrase if you don't feel like. The public and private keys will be generated to /Users/<your_name>/.ssh.
- Go to your profile page in Assembla and click on the "Manage SSH Keys" link on the left navigation bar.
- Upload the public key you've just generated.
Now we can clone the Git repository.
- TortoiseGit is integrated into Windows Explorer, so when you right click somewhere inside a Windows Explorer window you get the TortoiseGit context menu. Navigate to the folder in which you want to repository to reside.
- Right click -> from the context menu select "Git Clone..."
- In the URL box put: [email protected]:hebrew-khan.git
- Check the "Recursive" checkbox.
- Check "Load Putty Key" and click on the "..." button. Browse to /Users/<your_name>/.ssh and select the private key.
- Click on "OK" and wait for Tortoise to finish cloning the repository. This will create a new folder called hebrew-khan.
If you chose to use Source Tree then you can use its very friendly UI to clone the repository. The clone URL can be found at the top of this page. If you're more of a shell guy/lady (which is very appreciated), then you probably know what you're doing and don't need real assistance. But just in case you forgot:
- Go to the location in which the repository should reside.
- run "git clone [email protected]:hebrew-khan.git". This will create a new folder called hebrew-khan.
Finally let's run a simple HTTP server to server our files.
- (WINDOWS ONLY) Add the python installation directory to your PATH variable. Run python from cmd to see if it's working.
- Go to the hebrew-khan folder you've just cloned.
- Run "python -m SimpleHTTPServer". This command will run a very simple HTTP server (surprising...) that will server the files under hebrew-khan. You can use this to see your work in progress. NOTE: by default the HTTP server runs on port 8000. If this port is already taken then you can run "python -m SimpleHTTPServer <choose_a_free_port>".
- Open a browser and go to http://localhost:8000. You should see the hebrew-khan file directory.
- Got to /exercises and open one of the exercises HTML files. See if it's working.