The Beauty and Joy of Computing labs resource repository.
We use a project called "llab" to be able to display the lab content nicely. It's contained in the "submodule" llab
which somewhat changes the way you need to work with git
.
(As an aside, if you're interested, you should definitely check out llab.)
git clone --recursive
OR
git submodule init
git submodule update
To update the repo you should do this:
git pull
git submodule update
The main "production" server for labs is hosted at Berkeley, here, it lags behind this repo in content.
We also sometimes use CS10 students as lab rats, and you can view beta labs on the CS10 site.
However, the repository is setup so that any fork can be run using GitHub pages.
The main BJC repo can be viewed in a live state, here, or you can use your own fork by visiting the following url: http://[username].github.io/bjc-r/
, where you replace [username]
with your GitHub account name.
While GitHub pages are convenient, you'll likely want to run your own web server to make debugging changes much more quick and easy. In order to view the labs, you'll need to have an Apache server running on your machine. Here are some simple instructions for a couple different platforms.
No matter the platform, you should serve files from /bjc-r/
at the root of your server.
This might not be convenient in all cases. So, you have a few options:
/bjc-r/...
), with relative ones. You could also use a simple script to do this.The easiest way to setup a server is to use a simple, built-in Python server.
cd
into one level above the bjc-r
directory.python -m SimpleHTTPServer
(for Python 2) or
python3 -m http.server
for Python 3.~/
or your could expose your SSH keys!If you have python, the above method for Mac OS X will also work for you!
A basic guide on writing labs is, here. However, for the most part, all you need to do is write some HTML. To contribute:
bjc-r
.Of course, submitting issues is always welcome and encouraged! These issues can be bugs, questions, improvements or anything you'd like to share.