Hexo躺坑的那些事

Hexo是一个简洁、高效的博客框架，对于有一定编程基础的人来说比较友好，也可以根据个人爱好修改框架。但是第一次搭建hexo总会遇到各种各样的情况。就我个人所遇到的问题，在此归纳总结。

工具：github pages + Node.js + Hexo + 域名
流程：
1.安装gitbash
2.注册github并建立github pages
3.安装node.js
4.安装hexo并初始化
5.连接到github
6.更改hexo配置文件
7.上传到github pages
8.绑定域名（可选）
9.写博文

一. 填坑

1.1 配置文件

deploy: 
  type: git
  repo: https://github.com/LousenJay/LousenJay.github.io.git
  branch: master

注：属性与属性值之间必须有一个” “且为半角

1.2 deploy失效

检查Github Pages类型库的名称为yourname.github.io的主页，页面文件应当在master分支下，无md文件。
库名不是yourname.github.io的主页，页面文件应当在gh-pages分支下，文件结构与个人主页基本一致，无md文件。

1.3 更换主题失效

在修改主题文件之后，页面的文件依然没有更新，使用hexo clean命令并删除.deploy文件，重新部署生成网页文件后上传。

1.4 添加文件

在source文件夹下的所有md文件都会被hexo渲染成html文件,添加文件md文件或html等文件可以利用主题的source目录，也就是themes/themes-name/source，这个文件夹里面的所有文件都会被复制到网站的根目录中去。

1.5 本地成功，部署失效

大部分是浏览器的锅，hexo是纯静态页面，浏览器会缓存该页面。此时可以打开chrome的隐身窗口，隐身状态无缓存。

二. Hexo常用指令

每次部署的步骤，可按以下三步来进行。

hexo clean

hexo generate

hexo deploy

一些常用命令：

hexo new “postName” #新建文章

hexo new page”pageName” #新建页面

hexo generate #生成静态页面至public目录

hexo server #开启预览访问端口（默认端口4000，’ctrl + c’关闭server）

hexo deploy #将.deploy目录部署到GitHub

hexo help # 查看帮助

hexo version #查看Hexo的版本

三. Hexo文件

.deploy #需要部署的文件
node_modules #Hexo插件
public #生成的静态网页文件
scaffolds #模板
source #博客正文和其他源文件, 404 favicon CNAME 等都应该放在这里
_drafts #草稿
_posts #文章
themes #主题
_config.yml #全局配置文件
package.json

四. 修改页面

源文件在themes的layout文件夹
css和js在themes的source文件夹
CNAME存放于themes的source文件夹根目录
插件修改在node_modules/插件文件夹/插件文件

五. 如何写博文

Hexo博文采用的是md语言，md全称Markdown标记语言，但它相比HTML更加简单,一是体现在标记符的数量上，二是体现在标记符的书写上。要制约的只有一些 HTML 区块元素――比如 <div>、<table>、<pre>、<p> 等标签，必须在前后加上空行与其它内容区隔开，还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。Markdown 的生成器有足够智能，不会在 HTML 区块标签外加上不必要的 <p> 标签。在 HTML 区块标签间的 Markdown 格式语法将不会被处理。比如，你在 HTML 区块内使用 Markdown 样式的强调会没有效果。

• 标题
  # 标题

• 引用

  引用内容

> 引用内容

• 分隔符
  ---或***

• 列表
  使用* - +中的任何一个符号加空格就可以创建无序列表
  使用数字+点+空格创建有序列表
  列表可以嵌套，使用时在嵌套列表前空格

• 链接
  主页
  [文字](url)

• 图片
  
  ![名称](url)

• 代码段

  print("hello world");
  println();

使用三个`

• 单行代码
  println()
  使用`

• 字体样式
  倾斜* *
  加粗** **
  倾斜加粗*** ***

最后更新： 2019年02月26日 16:06

原始链接： https://www.lousenjay.top/2017/10/12/hexo躺坑的那些事/

Lousen Jay