使用Hugo搭建个人博客网站

前言

两年前用Hexo搭建博客,但是因为各种配置问题没有继续跟进,之后就一直在简书写的博客。恰逢看到新的博客生成工具Hugo,所以重新搭建了一个个人博客网站,通过Github Pages,域名重定向来实现线上访问。本文介绍的就是如何使用Hugo搭建个人博客网站的过程。实际效果可以访问我的博客

Hugo简介

不同与Hexo是用JavaScript实现的,Hugo是由Go语言实现的静态网站生成器。简单、易用、高效、易扩展、快速部署。从我的个人体验来讲,Hugo比Hexo速度更快,而且不用依赖一大堆东西,一个二进制文件就可以搞定。

The world’s fastest framework for building websites. Hugo is one of the most popular open-source static site generators. With its amazing speed and flexibility, Hugo makes building websites fun again.

这是Hugo的主页对自己的介绍,看这嚣张的简介,“全球最快的网站建设框架”,就不禁想让人来体验一把。

那么就开始吧!

Hugo快速开始

Hugo的首页有一个显眼的按钮【Quick Start】,点击它,按步骤完成即可

Hugo首页

Hugo安装

Mac

brew install hugo
hugo version

Windows

Hugo releases页面下载hugo_xxx_Windows-64bit.zip 将它解压到一个安全的目录,然后把这个目录添加到环境变量PATH中,重启终端,运行hugo version,正确展示了版本号就说明安装成功。

快速搭建博客

可以进入Hugo首页,点击Quick Start快速开始,从Step 2开始抄代码,直到Step 7结束。(Step 1是安装Hugo,我们在上文已经介绍了。)

也可以根据接下来的步骤依次执行:

  1. 创建一个新的项目(quickstart 是项目名称,可以改成你想要的名字)
    hugo new site quickstart
    
  2. 添加一个主题(这里会安装一个默认主题ananke)
    cd quickstart
    git init
    git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke
    
    echo 'theme = "ananke"' >> config.toml
    
  3. 创建一个新的博客
    hugo new posts/my-first-post.md
    
    注意:博客文件开头的 draft: false要改成true,否则改博客不会被生成到public目录中。
  4. 开启 Hugo Serve,用于本地预览
    hugo server -D
    
  5. 定制主题,如果对步骤2安装的默认主题不满意,可以自己选择一个主题进行替换
    • 重复步骤2,把你想要替换的主题GitHub路径替换一下就好,然后在配置文件config.toml里修改下面的配置
    baseURL = "https://example.org/"
    languageCode = "en-us"
    title = "My New Hugo Site"
    theme = "ananke"
    
    • baseURL 改成你的博客主页地址
    • languageCode 如果是中文博客,可以改成zh-CN
    • title 即博客名称
    • theme 这里是重点,把theme的值改成你替换的主题的名称,然后主题就生效啦。
  6. 构建静态页面
    hugo -D
    
    这个命令执行以后会生成一个./public的目录,将这个目录上传到GitHub,创建一个名为dreamqyq.github.io的项目(dreamqyq 这里替换成你的GitHub账号名),然后使用GitHub Pages就可以让别人来看你的博客啦。

Hugo常用命令

  • hugo 构建静态文件
  • hugo server -D 本地预览
  • hugo new blogName.md 生成一个新的博客

主题

我的个人博客网站的主题使用了maupassant (我fork了原项目并做了一点修改,支持了博客目录显示二级目录)主题,在这个主题的Github主页README中有详细的配置方法,这里就不再赘述。如果喜欢的话可以参考教程进行配置。

遇到的问题

在配置教程的时候遇到了一个问题,上文中提到的配置bashURL应该是个人博客网站的地址,由于我做了Gihubub Pages域名转发,使用了我自己的域名 https://enochqin.xyz(域名已弃用,目前的博客直接使用的GitHub Pages)。在最开始配置的时候,写成了https://www.enochqin.xyz,导致博客的很多功能各种出错,后来才意识到,我的域名没有做www的映射,导致其实https://www.enochqin.xyz这个网址是不能访问的。

没有www和带www的域名是被看做两个不同的域名的。一般我们都会将两个域名设置指向相同的一个网站。但是实际上带www的和不带www的域名完全可以设置指向两个不同的服务器。这样你访问带www和不带www的地址,看到的是两个不同的网站了。

(完)

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 161,192评论 4 369
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 68,186评论 1 303
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 110,844评论 0 252
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,471评论 0 217
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,876评论 3 294
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,891评论 1 224
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 32,068评论 2 317
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,791评论 0 205
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,539评论 1 249
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,772评论 2 253
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,250评论 1 265
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,577评论 3 260
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,244评论 3 241
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,146评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,949评论 0 201
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,995评论 2 285
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,812评论 2 276

推荐阅读更多精彩内容