Use hugo to build my website: https://dingdl.github.io.
The webpage is hosted through GitHub Pages. Currently no
personal domain is used. If a domain needs to be used, the baseURL
in config.toml
has to be first modified and the hugo files need to be updated before being pushed to
the remote repo.
Current setting:
baseURL = "https://dingdl.github.io"
To update the deployment, the following step of compiling all the hugo files is needed.
hugo -D -d docs
-d docs
makes all the website files go into the folder docs
.
Then push all the changes straight to the remote master
branch.
git add .
git commit -m "Update content"
git push origin master
hugo server
Then visit http://localhost:1313
to check out the website.
This hugo template uses prism to manage the syntax highlighting, which means we cannot make changes by using the following lines from the config.toml
.
# Enable for syntax highlighting
PygmentsUseClasses = true
PygmentsCodeFences = true
PygmentsStyle = "monokai"
Instead, we need to download the prism.js
and prism.css
files of our selected theme and replace the ones in the current folder.
/themes/hello-friend-ng/assets/js/
/themes/hello-friend-ng/assets/scss/
This is realised by adding the code below in ./themes/hello-friend-ng/layouts/partials/footer.html
.
This means the hugo template used is modified, so that the visitor map is automatically embedded in html files.
The widget is provided by ClustrMaps.
<div style="margin: 0 auto; display: flex; justify-content: center; align-items: center; width: 350px; max-width: 100%;">
<script type='text/javascript' id='clustrmaps' src='//cdn.clustrmaps.com/map_v2.js?cl=e64980&w=a&t=n&d=pRvWlboCTPMHr2BggBYCEbhCYFy-bMIgytf0lIjXrVM&co=ffffff&cmn=45c7b9&cmo=121211&ct=3c4a45'></script>
</div>
Download hugo_xxxxx_Windows-64bit.zip
from hugo releases. Unzip the file and put the hugo.exe
file in the root folder. To check the version of Hugo, enter the folder in terminal (e.g., powershell) and run .\hugo.exe version
. You should be able to see something like Hugo Static Site Generator v0.74.2-48565DE6 windows/amd64 BuildDate: 2020-07-17T17:22:50Z
.