使用 Hexo 在 Github 上建博客

先确认 git 与 npm 已经安装,在终端输入以下命令

git --version
npm --version


安装 hexo,在终端输入

npm install hexo-cli -g

安装过程中报错

解决方法:

sudo npm install hexo-cli -g

确认 hexo 安装成功

hexo version


来到你中意的目录(文件夹):

cd /Users/v1coder/Documents/

然后

hexo init blog
cd blog
npm install
hexo g
hexo server

此时新建了一个 blog 文件夹,并且 blog 里新建所需要的文件。( blog 可以改成你中意的其他文件夹名)

这些完成之,你就可以打开浏览器,在地址栏里输入: http://localhost:4000,在本地先看看网站是什么样子。


配置秘钥

  • 检查 SSH keys 是否已经存在

终端执行如下命令:

ls ~/.ssh

如果显示如下信息(重点是要有id_rsaid_rsa.pub),就说明 SSH keys 已经存在了:

id_rsa     id_rsa.pub     known_hosts

如果存在,则直接跳到 将 SSH key 添加到 GitHub 中


  • 生成新的Key:(引号内的内容替换为你自己的邮箱)

    ssh-keygen -t rsa -C "your_email@youremail.com"

    输出显示:

>Generating public/private rsa key pair. Enter file in which to save the key 
(/Users/your_user_directory/.ssh/id_rsa):<press enter>

直接回车,不要修改默认路劲。

>Enter passphrase (empty for no passphrase):<enter a passphrase>
Enter same passphrase again:<enter passphrase again>

设置一个密码短语,在每次远程操作之前会要求输入密码短语!闲麻烦可以直接回车,不设置。

成功:

Your identification has been saved in /Users/your_user_directory/.ssh/id_rsa.
Your public key has been saved in /Users/your_user_directory/.ssh/id_rsa.pub.
The key fingerprint is:
... ...

默认会在路径~/.ssh下生成id_rsaid_rsa.pub两个文件。


  • 将 SSH key 添加到 GitHub 中

终端输入:

cat ~/.ssh/id_rsa.pub

复制内容

进入GitHub –> Settings –> SSH and GPG keys –> NEW SSH key,如下图所示:

Title 里任意添一个标题,将复制的内容粘贴到 Key 里,点击下方 Add SSH key 绿色按钮即可,如下图所示:


部署到 GitHub 上

打开当前文件夹(blog)下的 _config.yml 文件,在末尾deploy后面添加几行代码:

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repository: git@github.com:yourname/yourname.github.io.git
  branch: master

注意:冒号后面有空格,yourname 替换成你自己的 GitHub 用户名。(repository 可以在 Github 上复制,但记得选Clone with SSH

终端输入:

npm install hexo-deployer-git --save
hexo deploy

显示 INFO Deploy done: git 表示完成。


设置独立域名

博客根目录的 source/ 目录下创建一个名叫 CNAME 的文件,注意没有后缀,里面写你的域名。

部署,添加域名解析,就 OK 了

域名解析请参考“极简”创建 github page 并设置域名


编辑文章

  • 创建文章
    命令行输入:
hexo new "new article"

之后在博客根目录 /source/_posts/ 文件夹下面,多了一个 new-article.md 文件。

打开之后我们会看到:

title: new article
date: 2018-12-10 20:10:33
tags:

title 是当前文档名,也是将来在网页中显示的文章标题。
date 是我们新建文档的时间。
tags 是文档的标签,我们用次来为文章加标签。

我们可以为文档贴标签:

---
title: new article
date: 2018-12-10 20:10:33
tags:
- tag1
- tag2
- tag3
---

上面的文档贴上了 tag1tag2tag3 标签


  • 删除文章

博客根目录 /source/_posts/ 文件夹下,删除对应文章的 .md 文件

_posts/ 文件夹不能为空,否则网页会报错 Cannot GET /

更新博客

  • 本地预览
hexo clean
hexo g
hexo s

打开 http://localhost:4000/ 预览效果

  • 部署到 GitHub
hexo clean
hexo g
hexo d



鸣谢:
Hexo + GitHub (Coding) Pages 搭建博客
使用 Hexo 为自己在 Github 上建一个静态 Blog 站点

2018-12-11

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

推荐阅读更多精彩内容