Hexo与Github pages 实现静态博客

第一.博客搭建

1.hexo

(1)hexo是什么

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

(2)hexo安装

a.安装前提

安装Hexo前，需要先安装下列应用程序：

• Node.js (Node.js 版本需不低于 10.13，建议使用 Node.js 12.0 及以上版本)

git 和 node 的安装方法 在后面hexo + github pages给出 着急的小伙伴可以直接从那里开始看

b.安装 Hexo

所有必备的应用程序安装完成后，即可使用 npm 安装 Hexo。

$ npm install -g hexo-cli
或者
$ npm install hexo

安装以后，可以使用以下两种方式执行 Hexo：

1. npx hexo

2. 将 Hexo 所在的目录下的 node_modules 添加到环境变量之中即可直接使用 hexo ：

   echo ‘PATH=”$PATH:./node_modules/.bin”‘ >> ~/.profile

2.Github page

(1) github page创建

基本页面的生成

1. 首先你需要注册一个 GitHub 账号，并在个人主界面里选择创建一个新的 Repository 。
2. 进入页面后，在 Repository name 的位置填写域名，格式是 username.GitHub.io。
3. 创建成功之后，点击右上角的 Settings找到 GitHub Pages 选项，选择一个 GitHub 官方提供的主题
4. 选择完毕之后 GitHub Pages 就会自动帮你生成好网站，在他跳转的界面点击 Commit changes 按钮，网站就可以访问了。
5. 在浏览器里输入你的项目名称，比如 brick713.GitHub.io，就可以看到，你刚刚选择的主题的个人网站的页面了。

3.hexo +　Github page

(1).git

a. git安装

• windows下载安装 git
• linux下载安装指令
  sudo apt-get install git-core 或者sudo yum install git-core

b. git和github绑定

1. 安装成功后，将 git 与 GitHub 账号绑定，右键打开 Git Bash

2. 配置用户名和邮箱
   git config --global user.name "github 用户名"
git config --global user.email "github 注册邮箱"

3. 生成 ssh 密钥
   ssh-keygen -t rsa -C "github 注册邮箱"

4. 一般执行上述命令之后，会生成 id_rsa 和 id_rsa.pub 两个文件，前者是我们私有的，而后者则是对外开放的。接着找到生成的 .ssh 的文件夹中id_rsa.pub 密钥，将内容复制,然后打开 GitHub-Settings-Keys 页面，创建一个新的 SSH key，填写 Title 和 Key，Title 可以随意，而 Key 的内容则是我们刚才复制的 id_rsa.pub 中的内容，最后点击 Add SSH key 即可

(2).node.js

a. node.js安装

• 下载node.js下载
• 一直下一步即可
• 验证 在命令行输入 node -v可以查看版本

b. node.js初始化

• 在git bash中安装
  npm i hexo-cli -g
• 选择一个文件夹来放置博客文件,并用如下命令进行初始化并安装必备组件

  //在对应文件夹下git bash here
   hexo init .
   npm install
  

  c.初始化后的文件

• _config.yml # 网站配置信息
• package.json # 应用程序信息
• scaffolds # 模板文件夹
• source # 存放用户资源 _drafts 草稿箱 _posts 文章
• themes # 主题文件夹

(3) 将自己的github网址 替换 _config.yml最后的

deploy:
  type: git
  repo: //此处替换为自己的github的对应仓库网址
    例:https://github.com/xxxxx/xxxxx.github.io.git
  branch: master

第二.博客使用

1.新建博客

在搭建博客的文件夹中git bash here 进入到 Blog/source/_post文件夹中(_post为默认选项 即发表文章)

可以在source文件夹中创建文件夹 new时加参数 例如草稿箱_draft)

hexo new [layout] <title>
例如 hexo new "我的博客" 

hexo new post "我的文章" //就会在/source/_post文件创建名为 我的文章.md的文件
hexo new draft "我的草稿" //就会在/source/_draft文件创建名为 我的草稿.md的文件

其中[layout]为布局

• 创建md文件时可以指定布局
• 包括三种布局 page draft post分别为页面,草稿,文章 默认为post
• 在新建文件时，Hexo 会根据 scaffolds 文件夹内相对应的文件（可以理解为模板）来建立md文件
• 当创建不同的md文件会在不同的存储路径

注意但不想一个文件显示在页面上时,可以移动到_draft文件夹

• 在启动服务器时加上 –draft来查看草稿
• 还可以在站点配置文件中把render_drafts设为true 可以通过publish将草稿发布文章或者页面

hexo server --draft
hexo publish [layout] <title>

2.博客编写

(1)Front-matter

创建一个文件后可以看到这些,成为Front-matter

---
title: hexo博客搭建和使用
tags:
---

此处包括一些预定义参数如下

layout  布局  默认为true，如果你不想你的文章被处理，可以设置为false
title  标题  标题会显示在最上方居中位置 
date  建立日期如果不指定则为默认值-文件创建日期，可以自定义。
update  更新日期  如果不指定则为默认值-文件修改后重新生成静态文件的日期。
comments  是否开启文章的评论功能 默认值为true
tags  标签（不适用于页面page布局）
categoreies  分类（不适用于页面page布局）
permalink  覆盖文章网址
keywords  仅用于 meta 标签和 Open Graph 的关键词（不推荐使用）

---
title: hexo博客搭建和使用
date: 2022-03-22 11:51
tags:
- 博客搭建
categories:
- 个人博客
- 博客搭建使用
---

(2)博客正文编写

使用markdow文法编写博客,保存
markdown语法可以参考这个markdown官方语法

3.博客预览和发布

(1)基本操作

一般发布文章或者修改博客后需要这些操作：

• 生成静态文件
• 启动服务器
• 测试没问题

(2)常用命令

• 清除缓存：hexo clean
• 生成静态文件：hexo generate可简写为 hexo g
• 启动服务器：hexo server或者 hexo s 此处默认的端口号为4000 可以使用-p（–port）重设端口,此处使用浏览器浏览localhost:4000可以预览自己的博客
• 部署：hexo deploy可简写为hexo d，用于将网站部署到服务器上。将博客托管到GitHub Pages或Gitee Pages 注意:此处可以使用-g（–generate），hexo d -g部署前预先生成静态文件，等同于 hexo g -d

 hexo clean  
 hexo g 
 hexo s //此处注意预览完在git bash窗口Ctrl+c关闭,直接关闭浏览器可能会使端口无法释放
 hexo d