hugo 搭建个人博客最详细的教程

如何用 hugo 搭建个人博客？

2020/4/24

1安装Hugo

首先打开官方教程 Hugo

如果你是mac用户使用以下命令行安装

brew install hugo
hugo version

brew需要按教程先安装

如果你是window用户,个人推荐使用以下步骤

• 点开hugo下载链接 下载 hugo_0.69.1_Windows-64bit.zip

• 如果版本更新了，就下载最新版本就好了

• 下载完成后，解压会发现有一个hugo.exe文件

• 把hugo.exe放在一个安全的目录下,比如我就放在了D:\Software\hugo目录下

• 把D:\Software\hugo\路径放到环境变量的PATH中

• 重启终端后，使用hugo version查看hugo的版本号

• 如果不报错，那恭喜你安装完成

建立博客

首先你应该确保你的终端已经cd进入了一个安全的目录，最好的空的

点开 hugo文档

1.在终端输入

hugo new site xxxx.github.io-creator

xxx是你github账号的用户名，如果有大写字母，请将其全部改成小写的

2.输入这两行命令

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

第一行的意思是建立.git本地仓库

第二行的意思是添加一个默认的主题

echo 'theme = "ananke"' >> config.tom

4.写博客

hugo new posts/第一篇博客.md

用VScode打开第一篇博客.md，在content/post的目录下可以看到有这个文件

---
title: "第一篇博客"
date: 2020-04-23T23:30:25+08:00
draft: false
---

写你的内容

注意：draft:是草稿的意思，默认是true,你要把博客写完的时候记得改成false
完成后保存即可

5.开启服务

hugo server -D

λ hugo server
Building sites … WARN 2020/04/24 10:40:03 Page.URL is deprecated and will be removed in a future release. Use .Permalink or .RelPermalink. If what you want is the front matter URL val
ue, use .Params.url

                   | EN
-------------------+-----
  Pages            | 12
  Paginator pages  |  0
  Non-page files   |  0
  Static files     |  3
  Processed images |  0
  Aliases          |  1
  Sitemaps         |  1
  Cleaned          |  0

Built in 30 ms
Watching for changes in D:\jirengu\hugoblog\xuansining.github.io-creator\{archetypes,content,data,layouts,static,themes}
Watching for config changes in D:\jirengu\hugoblog\xuansining.github.io-creator\config.toml
Environment: "development"
Serving pages from memory
Running in Fast Render Mode. For full rebuilds on change: hugo server --disableFastRender
Web Server is available at http://localhost:1313/ (bind address 127.0.0.1)
Press Ctrl+C to stop

先不要ctrl+c终止它,用http://localhost:1313/在浏览器打开，我个人是这样的

如果看到这样的界面，表示你已经成功了，但还没结束哦，接着看
6.如果你要在原来基础上添加博客,在项目根目录下

hugo new posts/第二篇博客.md

然后运行

hugo -D

更新一下静态页面

上传到github中

• 首先在github中新建一个仓库，名为xxxx.github.io

• 在跟.gitmodule同级目录下新建一个.gitignore文件,在文件里面写上/public/保存

目的是确保，只上传public目录下的文件，而不影响其他的

• cd public
  

  进入public目录

  git add .
  git commit -v
  

  下面两行xxxx.github.io仓库会有，照抄就好了

  git remote .......................
  

  git push -u origin master
  

配置github

首先你在xxxx.github.io仓库中已经有了上传的一系列文件

点击settings

找到github page

点击的链接即可访问你的站点啦