Skip to content
Website and index of materials
Scala CSS
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
project
site/src/main
.gitignore
README.md
build.sbt
site.sbt

README.md

The website and index of materials.

Find lecture notes and details on how to run the sessions.

Building the Site

Configured in site.sbt.

Run 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 0 commits)

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 git@github.com: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.

Domain Names

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 192.30.252.153 don't support HTTPS so you want to be using the 185.199.108.153 alternatives).

Then go enjoy https://xp-dojo.org

You can’t perform that action at this time.