乐趣区

Hugo搭建个人博客

Hugo 搭建个人博客

我使用的为 Windows 操作系统,只演示在 Windows 下的安装搭建流程。

本网页即为搭建成果

1. 下载 Hugo

官方中文文档

2. 下载 Hugo 主题

主题网站

安装前确保已经安装 git 并配置环境变量。下拉网页可以看到使用 git 安装主题的方式,例如:

themes 路径在执行上一步创建站点目录中被自动创建,如果按照官方文档进行安装,你的目录结构应该和我此时一样:

3. 在本地启动博客

- t 指定了安装的主题,-buildDrafts 显示内容。可以看到此时的访问地址为 http://localhost:1313/,在浏览器中访问(使用 m10c 主题)。

注意一定要在博客的 根目录 执行此命令。

不同主题的使用方式可能不同,比如 zzo 的开启方式为:

需要查看下载页的文档,灵活变动。

4. 创建博客文件

hugo new /test/HelloHugo.md

使用如上命令,创建一个 markdown 文件,此路径被保存到博客根目录下的./content 目录中。

于是就可以在 markdown 文件中编写博客了!

特别注意!如果在 markdown 文件中写了如 <img … > 的 HTML 标记,需要在 config.toml 中设置unsave = true,否则将不允许在 md 文件中使用 HTML 语法。由于我希望使用图片的缩放功能,需要用到 HTML 语法,需要进行设置。参考博客

5. 将博客部署到 Github

5.1. 创建一个空仓库

仓库名称为用户名.github.io

5.2. 在 Hugo 中进行部署操作

在根目录执行如下命令,将 hugo 部署到刚才创建的空仓库中。baseUrl 为你的博客配置完成后的访问路径。

执行完毕后,生成了 public 目录:

5.3. 将 public 目录上传至 github 仓库中

cd public
git init
git remote add origin 仓库地址
git add .
git commit -m “first commit”
git push -u origin master

如果你是第一次使用 git,还需要配置自己的用户名和邮箱:

  1. 配置用户名:git config --global user.name "your name";
  2. 配置用户邮箱:git config --global user.email "youremail@github.com";

通过 baseUrl 中填入的路径,即可访问博客。

5.4. 后续博客的更新

还是需要通过 hugo new /test/HelloHugo.md 创建博客文件,编写完成后执行 hugo --theme= 主题文件名(h10c) --baseUrl= 博客访问网址(https://aalchemist.github.io/) --buildDrafts 将静态页面更新到 public 目录,再将 public 里的文件提交到暂存区git add .,提交到版本库git commit -m "..."(https://github.com/AAlchemist/AAlchemist.github.io),push 到远程仓库git push -u origin master

6. Enjoy it

搭建博客也花了不少时间,感觉进一步的配置还是巨大的坑,比如如何添加层级目录,如何添加评论系统,都需要继续学习配置,不过最主要的还是坚持写博客,在记录和总结中巩固知识。

退出移动版