如何使用 Hugo 搭建个人博客

弃坑 Hexo,投入 Hugo 的怀抱

Hugo 其实是一个命令行工具,帮助我们生成静态网页。

一、安装

  • masOS

    • 使用命令 brew install hugo
  • Windows

    1. 下载 realse zip 包
    2. 解压,将 hugo.exe 文件放入某盘:\software\Hugo\bin
    3. 配置环境变量 PATH,添加 hugo.exe 存放路径
  • 验证安装:

$ hugo version
Hugo Static Site Generator v0.67.0-7F1DA3EF windows/amd64 BuildDate: 2020-03-09T20:35:55Z

二、使用

参考官方文档

Ⅰ 创建一个全新的 Hugo 网站,存放于指定的文件夹中

$ hugo new site amanda.github.io-creator

Ⅱ 添加一个主题

  1. 下载主题,这里使用官方文档主题 Ananke theme
$ cd amanda.github.io-creator
$ git init
$ git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke
$ rm -rf themes\ananke\.git
  1. 向配置文件(config.toml)中追加主题配置
$ echo 'theme = "ananke"' >> config.toml

注意!请注意!对于Windows用户来说,此处为后续埋下了一个坑,改用下述语句或手动删除单引号对

$ echo theme = "ananke" >> config.toml
  1. 更换主题:“下载主题” -> “修改主题配置”

Ⅲ 开始写博客啦

  1. 创建一篇新的博客,hugo new posts/第一篇.md
  2. 打开 posts/第一篇.md,想写啥写啥

每篇博客,都包含如下开头:

---
title: "My First Post"
date: 2020-03-10T21:02:01+08:00
draft: true
---

其中,draft 意为 “草稿”,默认值为true,代表此篇内容编译时将被忽略;改为 false,该篇博客才能被编译使用。

Ⅳ 启动 Hugo 服务

  1. 启动命令,hugo server -D
  2. 访问博客,默认网址 http://localhost:1313/
    [图片上传失败...(image-e23ed-1583885841226)]

Ⅴ 编译静态页面

  1. 编译命令,hugo -D
  2. 编译结果:默认生成 ./pulic 目录
  3. 手动指定编译生成的目录
    • 编译命令中添加选项 [-d/--destination] 指定发布文件夹
    • 配置文件中通过 publishdir 指定

Ⅵ 编译发布到 GitHub

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

推荐阅读更多精彩内容