This is the source repository for devict.org. It is built using Hugo.
A great way to contribute is to file an issue if you notice a bug or something that could be improved.
To modify the site itself you should fork this repository then clone the repo
locally. Create a new branch off master for your issue such as fix-link.
$ make serve
Then open https://localhost:1313!
To just build the site, use make build.
Download and install Hugo from the Hugo Getting Started page. There are many versions of Hugo to support a wide variety of users. Pick the installation steps that match your operating system. You do not need to have Go installed to use Hugo.
With hugo installed run hugo server. The site will be visible at
http://localhost:1313 with LiveReload enabled so changes will be built
and displayed instantly.
You may also create a GitHub Codespace and run the Hugo Build task from the dev environment. Ports will forward automatically, so you can visit http://localhost:1313 as with other methods.
Merges/commits to the master branch trigger a build on Travis CI.
The build parameters are defined in .travis.yml. That file defines the build
environment, decrypts an SSH key for deployment (.travis.key.enc), installs
Hugo, then runs the script .travis.sh.
That script clones, builds, commits, and pushes the website to a separate repository devict.github.io. That repo is a "GitHub Pages" site which serves the generated HTML content.