如何用 hugo 搭建个人博客?
2020/4/24
1安装Hugo
首先打开官方教程 Hugo
如果你是mac
用户使用以下命令行安装
brew install hugo
hugo version
brew
需要按教程先安装
如果你是window
用户,个人推荐使用以下步骤
-
如果版本更新了,就下载最新版本就好了
-
下载完成后,解压会发现有一个
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
点击的链接即可访问你的站点啦