前端研习社Web前端之路让前端飞

用Hugo快速搭建个人静态博客

2017-04-04  本文已影响1324人  FrankWang0909

最近心血来潮,想要重新折腾一番自己的博客。于是,发现了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,想要了解更多,请点击访问

上一篇下一篇

猜你喜欢

热点阅读