Hugo Rewrite edition
- Clone this repository, using something like...
git clone git@github.com:ucfai/ucfai.org
. - Checkout the
hugo-migration
branch, this is what we'll be working from. - Make sure you run
git submodule update --init --recursive
to properly "install"hugo-academic
. - From the repository root, run:
docker-compose up
.
You'll find the site is live at [http://localhost:8234](http://localhost:8234)
.
We're using docker-compose
to simplify and standardize the development/build
process. Because of this, you need to become semi-familiar with the
docker-compose
CLI interface.
To start the container:
docker-compose up
This will start the container and attach the log output to your current terminal window.
To start the container in a detached
state:
docker-compose up -d
This will start the container in a detached
state, which allows it to persist
(continue running) beyond the terminal window. All it requires is that docker
is running on your host machine.
To access the log from this container:
docker-compose logs hugo-ucfai-org
As this container is named, you'll only be able to spawn a single instance of it
(which makes it trivial to access the logs, too). As a build system, hugo
dumps
all errors to this log, so you'll be able to catch a glimpse of what's going on
by running the above command.
Personal recommendation: Run docker-compose up
whenever you're developing,
the latter methods of running are useful, but can make it a bit difficult to
track down errors until you've gotten into the headspace work with docker
,
which takes a bit.