Hugo Academic 安装教程

hugo安装

Ubuntu环境下，去 Github下载对应的版本安装包，本文下载的版本是：hugo_extended_0.66.0_Linux-64bit.deb

切换到下载文件目录，安装该.deb文件：

sudo dpkg -i hugo_extended_0.66.0_Linux-64bit.deb
#检查安装的版本
hugo version

(base) jiang@jiang-X299:~$ hugo version
Hugo Static Site Generator v0.66.0-78C3C78F linux/amd64 BuildDate: 2020-03-03T15:21:50Z

hugo卸载

若安装版本出错，卸载重新安装：

sudo apt-get remove --purge hugo
sudo apt autoremove

生成博客根目录

hugo new site homepage #homepage即是个人主页的根目录

其目录结构如下：

├─archetypes 
├─content         #放markdown文章
├─data            #放数据
├─layouts         #放网站模板文件
├─static          #放图片、css、js等静态资源
├─themes          #放下载的主题
└─config.toml     #网站的配置文件，也支持YAML格式的config.yaml或JSON格式的config.json

hugo默认不带主题，但是没有主题网站无法运行，需要将下载的主题放到\themes目录下。本文安装的是academic主题。

academic主题安装

acdemic截止到目前已经更新到V5.2.0，越新的版本，对于环境的要求越高，比如需要配置go语言环境，本文用的是低版本的academic主题，去 官网releases下载对应的版本，本文下载的是wowchemy-hugo-modules-4.8.0.tar.gz

解压后复制到\themes目录新建的\academic文件夹下，然后复制\academic\exampleSite目录下内容到根目录\homepage下：

(base) jiang@jiang-X299:~/homepage$ cp ./themes/academic/exampleSite/* ./ -r

执行hugo server命令：

Web Server is available at //localhost:1313/ (bind address 127.0.0.1)
Press Ctrl+C to stop

hugo搭建部署到github pages

在根目录执行：

(base) jiang@jiang-X299:~/homepage$ hugo --theme=academic --buildDrafts --baseUrl="xxx"

此时所有的静态页面都会生成到public目录下，执行以下命令：

cd .\public
git init
git remote add origin git@github.com:xxxxx
git add -A
git commit -m "first commit"
git push -u origin master

academic主题修改

https://www.bookstack.cn/read/hugo/8.md#%E4%BF%AE%E6%94%B9config.toml%E6%96%87%E4%BB%B6