用hugo搭建个人博客

Step 1：下载 Hugo

Mac用户

brew install hugo
hugo version

windows用户 下载地址

配置环境变量

Step 2：创建一个新的站点

hugo new site xxx.github.io-cretor

Step 3：添加一个主题

cd xxx.github.io-cretor 
git init
git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke

Step 4:添加一片文章

hugo new posts/my-first-post.md

进入该文件就可以开始写自己的博客啦！进入后Markdown有一下文本

---
title: "Test"
date: 2020-06-29T22:46:12-07:00
draft: true
---

title是博客的标题，draft: true是表示当时博客是以草稿的形式，需要将他改为draft: false。

Step 5：开启hugo服务器

hugo server -D

image.png

服务器运行后会看到本机的一个地址，点击进入即可看到博客内容

Step 6：制定主题

打开config.toml对其更改 image.png

注意：需要将baseURL改为自己的github地址,否则进入帖子时的URL将无法正确链接到你的网站。 (本人就踩了这个坑)

Step 7：构建一个静态页面

在更目录下输入一下命令

hugo -D

Step 8：部署

隐藏public文件

在hugo站点根目录下创建.gitignore并写入内容/public/，目的是让Git仓库不要管public文件。

创建对应的GitHub仓库

在GitHub上新建仓库名为xxx.github.io(xxx表示你自己的github名称)。

连接并推送到远程仓库

接着进入public文件初始化git仓库，链接远程仓库也就是对应刚刚创建的仓库，并将所有的文件提交到本地仓库，再push到远程仓库。

设置GitHub Pages

进入刚刚创建的GitHub仓库，点击settings找到GitHub Pages如下图将其改为master branch选项。

cd public
git init
git add .
git commit -v
git remote add origin git@github.com:linkjie/username.github.io.git
git push -u origin master

image.png

如若操作出现错误请以最新官方教程为准。

下一篇博客

新创建一篇

hugo new posts/my-first-post.md

执行构建静态页面

hugo -D

最后进入public提交到远程即可

总结

需要注意的地方

  1. config.toml中的文件是需要配置之后才可以使用的，特别注意baseURL属性是你的GitHub地址。
  2. 注意每篇博客开头draft属性。
  3. 每次修改都需要在站点根目录进行一次静态构建hugo -D，再到public进行提交。

使用到的命令

hugo new site quickstart

cd quickstart
git init
git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke

hugo new posts/my-first-post.md

hugo server -D //用于博客在本地的预览(可省略)

hugo -D

cd public
git init
git add .
git commit -v
git remote add origin git@github.com:linkjie/username.github.io.git
git push -u origin master