The Baksia site is generated from markdown using the Hugo static site generator. We use YAML as front matter.
- Download and install Git and clone the baksia repository to a local folder:
git clone https://github.com/digdir/baksia --recurse-submodules --remote-submodules
- We recommend downloading and using visual studio code with
- this markdown extension for editing markdown and
- the github extension for helping with pull requests
- Download the latest Hugo (extended) for your platform, and place the executable in the baksia-folder.
- Open the baksia repo-folder in visual studio code
- Run
./hugo server --navigateToChanged
. Now baksia is running locally at http://localhost:1313/ - Edit and save files in the
content
-folder to automatically get a new local build of the site refreshed in your browser, so you can test your changes locally.
We recommend that you create a pull request when you want to share your changes with the rest of the world.
- Create a branch for your changes
- Create a pull request
Whenever changes from your pull request are merged into the baksia main-branch, an automatic deploy is updating https://baksia.digdir.no
PS: If you don't have direct write access to the repo, you need to create a fork and submit a pull request from your fork.