The website and index of materials.
Find lecture notes and details on how to run the sessions.
Building the Site
sbt site/makeMicrosite to create the site you're reading now. Find it in
site/target/jekyll once built.
You should be able to preview the site using Jekyll to serve it.
$ cd site/target/jekyll $ jekyll serve
If you're going to publish it (
sbt site/publishMicrosite), make sure you
site/makeMicrosite first (otherwise you'll see a commit on the
gh-pages branch with
Initially Publishing the Site
This only needs to be done once.
We publish the site to Githubs
gh-pages, setup the branch (one time) with the following:
# Using a fresh, temporary clone is safest for this procedure $ mkdir temp $ git clone firstname.lastname@example.org:youruser/yourproject.git $ cd yourproject # Create branch with no history or content $ git checkout --orphan gh-pages $ git rm -rf . # Establish the branch $ git commit --allow-empty -m "initialize gh-pages branch" $ git push origin gh-pages
Then delete the
temp folder, you have a new empty branch. When that branch has HTML in it (say, a jekyll site), when you push, Github will "deploy" the HTML to it's web servers. Visit the published site with https://xp-dojo.github.io/xp-dojo.
If you have a domain name (like we do), add it to a file called
CNAME and the above will redirect to it. Setup that domain name server to point back to Github (just a
A records is enough). This article goes into a little more depth around HTTPS (notably, the older
184.108.40.206 don't support HTTPS so you want to be using the
Then go enjoy https://xp-dojo.org