使用 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 可以改成你中意的其他文件夹名)
这些完成之,你就可以打开浏览器,在地址栏里输入: http://localhost:4000
,在本地先看看网站是什么样子。
配置秘钥
- 检查 SSH keys 是否已经存在
终端执行如下命令:
ls ~/.ssh
如果显示如下信息(重点是要有id_rsa
和id_rsa.pub
),就说明 SSH keys 已经存在了:
id_rsa id_rsa.pub known_hosts
如果存在,则直接跳到 将 SSH key 添加到 GitHub 中
的部分
如果 SSH Keys 不存在
-
生成新的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_rsa
和id_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
---
上面的文档贴上了 tag1
、tag2
、tag3
标签
- 删除文章
博客根目录 /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
此文章是我原创,最早发布于我在其他平台的博客,现同步在此
我的公号:v1coder
我的博客:v1coder.com
我的GitHub:https://github.com/v1coder