Hugo 新体验

2 minute read

最近想着把技术博文和日常分开,找一个干净的主题,方便查看。于是又搭建了一个 Hugo ,这次直接安装在服务器上,本来想通过 Nginx 服务来部署,结果我每次自己写配置文档都不能生效,所以还是上传到 Github 。(我真是太菜了)

虽说部署还是老配方,但是安装方式和写作方式都是新的,全部通过 vscodeSSH Remote 插件连接服务器,并在本地电脑上完成。

我的服务器系统是 Debian 8 ,以下操作均以此为准。

准备工作

  1. 安装 wget

    1apt install -y wget
    
  2. 安装 git

    1apt install -y git
    
  3. 安装 Golang

    1wget https://golang.org/dl/go1.17.7.linux-amd64.tar.gz #下载安装包
    2
    3rm -rf /usr/local/go && tar -C /usr/local -xzf go1.17.7.linux-amd64.tar.gz #解压并安装
    
  4. 配置 Golang 环境变量

     1nano /etc/profile 
     2
     3#写入以下内容
     4export PATH=$PATH:/usr/local/go/bin
     5
     6# 保存退出后,执行以下命令
     7
     8source /etc/profile #使配置生效
     9
    10go version #查看是否安装配置成功
    

安装 Hugo

这一步踩了不少坑,按照官方的安装方式,出现了一些我弄不明白的问题。

官方安装方式

1mkdir $HOME/src
2cd $HOME/src
3git clone https://github.com/gohugoio/hugo.git
4cd hugo
5go install --tags extended

问题

  1. 报错:

    cgo: C compiler "gcc" not found: exec: "gcc": executable file not found in $PATH
    

    安装 gcc 后解决。

  2. 报错: 缺少 g++ ,安装 g++ 后,执行 go install 长时间卡住。

解决方案

  1. apt 库中安装

    1apt install -y hugo
    

    成功安装,但是版本过低导致主题不能适配。

  2. .deb 包上安装

    1wget https://github.com/gohugoio/hugo/releases/download/v0.92.2/hugo_extended_0.92.2_Linux-64bit.deb
    2
    3dpkg -i hugo_extended_0.92.2_Linux-64bit.deb
    

需要注意的点

  1. Golang 版本需要在 1.11 以上

  2. Hugo 版本可从官方 Github releases 查看

  3. 如果主题样式文件是 scss 格式,需要安装 hugo extended 版本