Sometimes you want to make a larger, more complex change to the site and want to be able to build and run it locally to verify changes manually.
It can be a pain to set up the build infrastructure locally for any project, especially when dealing with a mixture of technologies and versions.
Thankfully Azure Citadel makes use of Visual Studio Code - Remote Containers to make this easier.
On your local computer you will still need the following tools set up, however they are not specific to this one repository and can be re-used for every project that makes use of Remote Containers.
If this is still too much infrastructure to maintain or you are in an environment that restricts what can be installed and run locally, you should look at using a cloud-hosted instance of the container using GitHub Codespaces.
From a terminal run the following.
git clone email@example.com:azurecitadel/azurecitadel.git code azurecitadel
Re-open in container
Use the Remote Container extension to open this project in VS Code, as shown in the following video
Open a new terminal window in VS Code and tell Hugo to start serving the local content on localhost:1313
You can follow links to see exactly what is being run when running inside a remote container.
Help us improve
Azure Citadel is a community site built on GitHub, please contribute and send a pull requestMake a change