Hexo+GitHub 搭建属于自己的博客 1.0

1,477 阅读3分钟

准备工作:

  • 注册个人 GitHub 账号【 github.com/
  • 安装 node.js、npm,并了解相关基础知识
  • 安装 Git,并了解相关基础知识

一、在 GitHub 建立博客仓库

1、打开 GitHub ,点击右上角的加号,选择 New repository 创建新的仓库。 2、在 Repository name 这里填【 你的用户名.github.io 】,比如我的就是 mykepler.github.io,然后点击 Create repository ,你就建好了一个存放博客的 GitHub 仓库。

二、配置SSH Keys

1、生成 SSH Keys

ssh-keygen -t rsa -C "Github的注册邮箱地址"

然后一路回车。如果你是 Windows 用户,你会在你的 C:\Users\admin.ssh 里找到 id_rsa 和 id_rsa.pub 两个文件,用记事本打开 id_rsa.pub 文件,复制里面的 SSH Keys;如果你是 Mac 用户,直接在终端 使用 pbcopy < ~/.ssh/id_rsa.pub 拷贝 SSH Keys。

2、配置 SSH Keys

进入设置页面,选择 SSH and GPG keys。 点击 New SSH key 按钮,进入下图页面,输入标题(随意取名)和 SSH Keys 👇

三、安装并配置 Hexo

官网: hexo.io/zh-cn/

1、新建一个文件夹,用于存放博客。

2、打开终端,进入此文件夹的目录下,然后开始安装 Hexo。

npm install -g hexo-cli

安装好 Hexo 后,输入:

hexo

如果出现下图,就说明你的 Hexo 安装成功了。

四、博客初始化

// 建立一个博客文件夹,并初始化博客,<folder>为文件夹的名称
hexo init <folder>
// 进入博客文件夹,<folder>为文件夹的名称
cd <folder>
// node.js的命令,根据博客既定的dependencies配置安装所有的依赖包
npm install

安装完成后,你的文件夹会变成下图这样👇

这里的 _config.yml 是你的站点配置文件,你可以打开它修改你的站点信息(每个:后面都有一个空格) repo 中填入你的仓库地址。

url: http://yoursite.com 把这个改成你的github地址(例如:http://myKepler.github.io)

deploy:
  type: git
  repo: git@github.com:myKepler/myKepler.github.io.git
  branch: master

五、第一篇文章

1、新建文章

hexo new "文章标题"

新建的 markdown 文件会在 source/_posts 中,文章写在这个 markdown 文件中。文章标题、文章编辑时间、标签、分类等信息均可以手动修改。

博客里面的标签、分类会根据你的命名自动生成和更新。

2、文章本地预览

//在Hexo 3.0server被单独出来了,需要安装server
npm install hexo-server --save
hexo s

在浏览器中输入 http://localhost:4000 ,你就能看到自己的博客了。

六、博客发布

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

发布成功后,可在你的 GitHub 上看到博客的编译文件。博客地址: xxxxxxx.github.io 🌟

七、主题修改

默认主题 landscape 是比较丑陋的👇

可以在 官网主题模块 选择喜欢的主题。

推荐主题:

  • hexo-theme-jekyll
  • hexo-theme-yilia
  • hexo-theme-next
// 主题下载
git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia

修改 _config.yml 中的 theme: landscape 改为 theme: yilia ,然后重新执行 hexo g 就可以更换主题啦~

如果出现一些莫名其妙的问题,可以先执行 hexo clean 来清理一下public的内容,然后重新生成和发布。

八、绑定域名

如果不想用 xxxxxxx.github.io 作为博客地址,那可以选择绑定域名。

1、添加CNAME 在博客站点的 source 文件夹下新建一个 CNAME 文件 【 注意:CNAME无后缀名 】

CNAME文件中只需写入一行即可,假设域名为 xxxx.com ,那就打开文件写入以下内容,然后保存。

xxxx.com

2、申请域名

  • 在腾讯云/阿里云上买个域名
  • 实名认证
  • 添加域名解析记录

主机记录记录类型线路类型记录值MX优先级TTL(秒)最后操作时间
@CNAME默认xxxxxxx.github.io-3600-

3、耐心等待解析生效 ✌️