A Hugo implementation of the Calvin Abstraction Website. https://abs.calvin.edu/ is a proxy to https://calvin-abstraction.github.io/.
If you plan to update the website content, it is not required to setup a development environment. Rather, you can directly edit the files ending in .md from within Github and benefit from the continuous deployment. In addition, the GitHub interface allows you to create new files just ensure to suffix .md so Hugo knows it's markdown to parse.
If you are interested in changing the theme or checking under the hood of the website, follow these instructions.
Before working on the website, you will need:
- Hugo Installed and git (to install a Hugo submodule theme).
- Know basic git commands: clone, staging/commiting, managing/pushing to remotes.
A.
- Clone repo and ensure the theme installs
git clone --recurse-submodules [email protected]:Calvin-Abstraction/Calvin-Abstraction.github.io.git
If already cloned,
git submodule update --init --recursive
- Run the Hugo server
hugo server -D
To create a normal "webpage", add the name of the page in the content/ directory. Ex:
cat > content/[insert-new-page-name].md
+++
title = "[insert-new-page-name]"
type = "page"
+++
Use Ctrl-D to stop writing to the file.
To create a blog post with some metadata generated (such as the current timestamp), run:
hugo new posts/my-new-post.md