This page describes a way to deploy the website.
The website is built in the _build
subdirectory. To deploy it, you must
transfer the contents of that subdirectory to the production web server. There
are many ways to do this. An exhaustive overview is beyond the scope of this
site, but we will describe one technique which is particularly elegant. This is
the method used for Urubu Quickstart itself.
Urubu Quickstart is developed using git and hosted on GitHub. GitHub
offers GitHub Pages as a way to host websites from the project repository
itself. Technically, this is accomplished by maintaining the website content
on a specific branch, called gh-pages
.
If you use git and GitHub, you can deploy your website to GitHub pages with the following command:
git subtree push --prefix _build origin gh-pages
When the gh-pages
branch does not exist yet it will be created.
It is a good idea to put the command in the Makefile to make it
easy to use.
The website will be published at http://<username>.github.io/<repository>
.
You can also use a custom url.