The first mistake you might have about Github Pages is about the subtle difference between User & Org Pages and Project Page. It takes me a while to realize that the first page can only point to the static content in master branch, which you don’t have the possiblity of switching to gh-page branch or master/doc (you can do that with project repo though). So you only publish your generated static content in User Page as git submodule.
Hugo deployment section Host GitHub User or Organization Pages deliberates the steps and demonstrates how to set the git submodule.
Few themes also good for technical blogs: After Dark, Hugo Nuo, Future Imperfect, Cactus.
Hack in Header.html
the hucore template has an issue in rendering LaTex math using MathJax
remove the setting in header and footer and put this
<script type="text/x-mathjax-config">
MathJax.Hub.Config({
tex2jax: {
inlineMath: [['$','$'], ['\\(','\\)']],
displayMath: [['$$','$$'], ['\[','\]']],
processEscapes: true,
processEnvironments: true,
skipTags: ['script', 'noscript', 'style', 'textarea', 'pre'],
TeX: { equationNumbers: { autoNumber: "AMS" },
extensions: ["AMSmath.js", "AMSsymbols.js"] }
}
});
</script>
<script type="text/javascript" async src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML"></script>