记录一下如何用 Hugo 和 Github Page 建立简单的博客 Blog

Hugo

在 Ubuntu 下载 Hugo

不建议在 windows下面使用 Hugo,因为会出问题。(为什么用 Hugo 上传到 Github Page 没办法正常显示)我折腾了好久,还是不知道怎么解决,只能转到 Linux 了。

至于如何使用 Ubuntu,要么用 WSL ,要么用 VM,反正需要用 Linux。这里就不放教程啦,网上一大堆啦。在 Ubuntu 下面直接安装即可,其他 Linux 就自己搜索一下吧。

sudo apt-get install hugo

使用 Hugo 创建新的博客 Blog 并安装主题

先创建一个site

hugo new site my-first-blog

然后进入文件夹初始化(需要先下载 git:sudo apt-get install git。不过一般来说最新版本的 Ubuntu 都会预装 git 了)

git init

然后去 Hugo 的官方主题站寻找你喜欢的主题,像我是用了 anatole,然后把主题添加到 theme 文件夹里面。

git submodule add https://github.com/lxndrblz/anatole.git themes/anatole

然后要在config.toml里面加一句theme = 'anatole'。或者可以像我一样,去 anatolegithub下载作者给出来的example config.toml,直接复制粘贴,然后自己可以改改标题什么的。而且还有不少东西可以修改,例如改头像什么的,但是暂时还没弄。

新建你的第一篇博客

hugo new posts/my-first-post.md

文章必须在 posts下面,又因为是用markdown写的,所以是.md结尾。至于能不能用普通格式,还没研究。写完后要把 draft改成false,避免被当做草稿而没有发表。

在本地预览你的博客页面

hugo server -D

-D就是把草稿也一起预览了,如果不带就不会预览草稿,也就是 draft: true的文章。接着就可以打开浏览器,输入http://localhost:1313/开始浏览你的博客。你的网站不一定是我这个,看终端的输出。

生成静态页面

hugo #同样,带`-D`就是把草稿也生成了。

会生成一个public文件夹,这个文件夹就是最终产物,只需要把它移到我们的 Github Page 就搞定了。

参考:Hugo Quick Start

Github Page

Hugo 部分算是搞定了,接下来搞搞 Github Page。
注册啊、入门啊、生成 ssh key 啊,这些我全部略过了,直接搜索一下就好了。

至于如何简历 Github Page,也是搜索一下就好了,可以看看这个三分钟在GitHub上搭建个人博客。反正很简单。

至于 theme 选不选,README 要不要建立,无所谓,反正用不上,或者要用的时候自己再建一个就可以了。

Hugo 与 Github Page 连接

进入到你的 Hugo blog 文件夹下面的 public 文件夹,然后将它用 git 初始化。并且添加你刚刚创建的 repository(仓库)的网址,然后上传 public 里面的文件即可。

cd public
git init
git remote add origin git@github.com:<name>/<name>.github.io.git # 最好用ssh,不要用https,似乎会比较顺利。
git pull origin main #这一步不是必要的
git add .
git commit -m 'add my first blog'
git branch -M main #修改 branch
git push origin main

git branch -M main是用来把 master 改成 main的。因为之前黑人运动,github 把默认是 master 的主分支,改名成了 main,但是 git 这个工具还没修改好,默认创建是还是 master。这时候去合并就会出现两个支,比较麻烦。或者你也可以手动修改 git 的默认创建——git config --global init.defaultBranch main也可以去 github 修改主分支的默认名字

理论上,现在你的 public 的文件,就被上传到 github 去了,然后直接输入网址,例如我的是 happyjoo.github.io,即可访问自己的博客了。(不行的话得等等,github 的服务器有时候会慢一点,毕竟是免费的。)

后续博客的更新

至于之后的更新,就是在你写好文章后,先用 Hugo 刷新 public 里面的文件,然后在 public 文件夹下面先 pull,再 push,应该就可以了。

你也可以把整个 blog 文件夹上传到 github 的仓库中。这样可以进行版本控制,也可以以防你需要在其他电脑进行更新。

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

推荐阅读更多精彩内容