Urubu Quickstart is a companion site of Urubu, a tool to develop static websites. You can use it set up a new Urubu project quickly.
Urubu Quickstart is both a starting point and a tutorial. Just follow the steps in the next sections and pages.
Urubu works with modern versions of Python 2 and Python 3 using the same codebase. More specifically, it requires Python 2.7 or Python 3.4. You can install it using pip:
pip install urubu
If pip is not yet available on your system, follow the pip installation instructions.
Install Urubu Quickstart locally
Download the zip archive with the Urubu Quickstart
source and unzip it. The resulting directory is your new project directory.
Rename it appropriately. Go into the project directory and run
build the website locally.
In a separate terminal window, go into the project directory and run
serve. This starts a local web server for the locally built website. You can
view it in a browser on localhost:8000. Note that it
is identical to Urubu Quickstart site.
You are now ready to make changes. Keep the local webserver running while making changes, so that you can verify them in the browser.
Set the brand name
_site.yml contains project configuration variables. As a first
_site.yml and set the
brand variable to the name of your
make and the verify the change in the browser, at the left side
in the top navbar.
Adapt the home page
index.md file corresponds to the home page of the site. It has a
tagline variable that are displayed prominently. Adapt them to your
make and verify the changes.