用Hugo快速搭建个人静态博客
最近心血来潮,想要重新折腾一番自己的博客。于是,发现了Hugo比之前使用的Jekyll更好用。本文是个人参照Hugo官网 搭建个人博客的记录。
Step 1. Install Hugo 下载、安装Hugo
下载地址:https://github.com/spf13/hugo/releases。
根据自己的操作系统,下载对应的安装包。我的操作系统是Win7 64bit
, 选择了hugo_0.19_Windows-64bit.zip
。
下载完成之后,解压的文件夹包含以下3个文件:
hugo_0.19_windows_amd64.exe
LICENSE.md
README.md
将 hugo_0.19_windows_amd64.exe
重命名为hugo.exe
。在你的软件安装盘新增名为hugo
的文件目录,在里面在新建一个bin
子目录。然后将hugo.exe
放到hugo\bin
目录下。再将这个bin
目录的路径添加到系统环境变量
中。
完成以上步骤后,打开命令行输入
hugo help
如果得到如下信息,说明安装成功。
hugo is the main command, used to build your Hugo site.
Hugo is a Fast and Flexible Static Site Generator
built with love by spf13 and friends in Go.
Complete documentation is available at http://gohugo.io/.
Step 2. 创建一个名为blog的Hugo站点
我希望在E盘下创建站点,所以我先切换目录
cd e:
e:
然后输入命令:
hugo new site blog
得到如下提示创建成功的信息:
Congratulations! Your new Hugo site is created in E:\blog.
Just a few more steps and you're ready to go:
1. Download a theme into the same-named folder.
Choose a theme from https://themes.gohugo.io/, or
create your own with the "hugo new theme <THEMENAME>" command.
2. Perhaps you want to add some content. You can add single files
with "hugo new <SECTIONNAME>\<FILENAME>.<FORMAT>".
3. Start the built-in live server via "hugo server".
Visit https://gohugo.io/ for quickstart guide and full documentation.
进入该目录,可以看到自动生成了5个目录和一个配置文件config.toml
|-- archetypes
|-- content #存放内容的目录
|-- data
|-- layouts
|-- static #存放静态资源(图片,css,js)
|-- themes #存放主题
|-- config.toml #配置文件
Step 3. 添加内容
切换到该目录下,然后输入如下命令,会在content
的目录下创建post
目录,在post
目录下创建名为test.md
的文件。
cd blog
hugo new post/test.md
提示文件创建成功:
E:\blog\content\post\test.md created
用文本编辑器打开文件test.md
文件
可以看到如下内容:
+++
date = "2017-01-02T17:45:06+08:00" #创建文件的时间
title = "test" #文件的标题
draft = true # 是否为草稿
+++
上述内容为自动创建的与文章有关的内容。自己也可以在两个+++
之间添加如下内容:
image = "hugo.png" #指定图片。
category = "test" #文章的类别
tags = ["Hugo", "intro"] #文章的标签分类。
url = "new_start" #该文章访问时的相对的url地址,默认为文件名。
更多的设置,可以参考官方文档。
以后写博客文章就是这样创建markdown
文件, 之后通过Hugo
编译成静态的html文件。
Step 4. 添加主题
官方提供了多种主题可供选择,具体在 https://themes.gohugo.io/ 可以找到。
找到想要的主题后,切换到themes
目录(该目录可以存放多个不同的主题)。
cd themes
由于需要使用到Git下载主题,以及版本管理和代码推送。需要事先下载安装好Git,关于如何安装和使用Git,可以参考我之前的一篇文章:Git学习笔记。
把选定的主题下载到themes
目录下。
git clone https://github.com/dim0627/hugo_theme_robust.git
Step 5. 启动服务,本地预览
先从themes
目录下退回到blog
目录, 然后启动服务。
cd ..
hugo server --theme=hugo_theme_robust --buildDrafts
在浏览器中打开 [http://localhost:1313/](https://themes.gohugo.io/)
Step 6. 修改配置文件config.toml
languageCode = "zh-cn"
title = "Frank Wang's Coding World"
baseurl = "http://www.wangxingfeng.com/"
[Params]
Author ="Frank Wang"
Step 7. 生成网站
1.改变文章draft
(草稿)状态:
hugo undraft content/post/*.md
2. 启动hugo
, 生成发布文件到public
目录下。
hugo --theme=hugo-icarus-theme
Step 8. 托管到GitHub Pages
1. 使用Git
来进行版本管理
git init
echo "/public/" >> .gitignore
echo "/themes/" >> .gitignore
git add --all
git commit -m "Initial commit"
2. 创建Git
远程仓库:
登录你的GitHub
. 创建一个新的仓库,仓库名为Github用户.github.io
比如我的是frankwang0909.github.io
.
3. 添加Git
远程仓库,并提交代码。
cd public
git init
git remote add origin git@github.com:frankwang0909/frankwang0909.github.io.git
git add --all
git commit -m "blog added"
git push -u origin master
4.以后有内容改动,提交代码.
(cd ..; hugo --theme=hugo_theme_robust)
git add --all
git commit -m "<some change message>"
git push -u origin master
本文首发于我的个人博客www.wangxingfeng.com,想要了解更多,请点击访问。