Hexo搭建与Markdown

导语

使用Markdown写作的优点：

• 专注你的文字内容而不是排版样式，安心写作。
• 轻松的导出 HTML、PDF 和本身的 .md 文件。
• 纯文本内容，兼容所有的文本编辑器与字处理软件。
• 随时修改你的文章版本，不必像字处理软件生成若干文件版本导致混乱。
• 可读、直观、学习成本低。

一、安装基础环境

没有简介，没有说明hexo是什么，有相关疑问的请自行搜索或者访问hexo官方网站。本次使用的的系统是centos7，其他系统请按照相关命令进行配置。

安装epel源:

 $ yum -y install epel-release

安装npm:

$ yum -y install npm 

如遇到权限问题，请自行解决。

二、安装hexo

1.安装

• 安装hexo，执行命令 npm install -g hexo进行安装。
• 初始化 hexo int /to/path 若不带路径会默认安装到 /var/www 目录。
• cd到/to/path目录执行命令npm install安装相关依赖。

2.Demo生成以及预览

• 执行命令hexo generate生产静态页面。
• 执行命令hexo server启动本地预览服务。

然后在浏览器中访问http://localhost:4000/,此时，已经看到了一个漂亮的博客。

三、站点配置文件说明与修改

站点配置文件是 your-hexo-site 目录下的 _config.yml 文件，配置文件中基本都有配置项的说明或者参考官方配置说明。以下说几个常用的配置：

基本配置

title: Archer           #博客的标题description:            #简介author: Archer peng     #作者language: zh-Hans       #语言，该设置使用的是next主题的简体中文timezone: Asia/Shanghai #时区配置

URL显示以及主题配置

permalink: posts/:year/:month/:day/:title.htmltheme: next

打赏配置

reward_comment: 坚持原创技术分享，您的支持将鼓励我继续创作！wechatpay: /images/wechatpay.jpgalipay: /images/alipay.jpg

所有的配置，冒号：后面都必须有空格。有几个需要特殊说明的项目：

• permalink：默认的文章链接是以：http://localhost/2016/11/29/you-title/的格式，个人喜欢在末尾加.html有动态页面的感觉，于是就修改为以上配置。
• 默认情况下配置文件中没有打赏配置，改内容是手动添加的。

四、主题选择及下载

在官方网站有很多主题预览，选择自己喜欢的进行下载。我选择的是NexT主题，根据官方的开始使用和主题配置进行配置主题。

在终端窗口下，定位到 Hexo 站点目录下。使用 Git checkout 代码：

$ cd your-hexo-site$ git clone https://github.com/iissnan/hexo-theme-next themes/next

启用主题需要在站点配置文件中修改默认配置theme: landscape => theme: next。其他配置请根据NexT的主题设定进行配置。

五、添加分类和标签

1.添加分类

$ hexo new page categories

• 确认站点配置文件里有category_dir: categories
• 确认主题配置文件里有categories: /categories
• 编辑站点的source/categories/index.md，添加:
*

title: categoriesdate: 2016-11-29 11:49:50type: "categories"comments: false

2.添加标签

$ hexo new page tags

• 确认站点配置文件里有tag_dir: tags
• 确认主题配置文件里有tags: /tags
*

title: tagsdate: 2016-11-29 11:49:50type: "tags"comments: false

之后需要在主题中开启对应的配置选项。

六、文章写作

在 your-hexo-site 目录下执行下系列语句，生成一个名为 title 的空文章。

$ hexo new "title"

可以看到提示生成了一个title.md，博客内容是用markdown语法写的。可以使用编辑器的插件，也可以在线编辑，还有专门的编辑器。我的mac使用的是 Mou。

每篇文章都有标头，格式如下：

title: postName           #文章页面上的显示名称，可以任意修改，不会出现在URL中date: 2016-11-29 15:30:16 #文章生成时间，一般不改，当然也可以任意修改categories:               #文章分类目录，可以为空，注意:后面有个空格tags:                     #文章标签，可空，多标签请用格式[tag1,tag2,tag3]，注意 ":" 后面有个空格---这里开始使用markdown格式输入你的正文。

添加分类与标签的另一种形式：

tags:  - tag1  - tag2categories: xxx

文章摘要，在需要显示摘要的地方添加如下代码：

以上是摘要"<!--more-->"以下是全文

more以上的内容既是文章的摘要，在主页显示，more以下的内容点击 “阅读全文” 连接打开。

七、添加站内搜索

添加站内搜索可以参考插件主页和插件说明，根据说明进行安装：

$ npm install hexo-generator-search --save

配置,到主题的根目录打开 _config.yml 文件添加一下内容：

search:  path: /search.xml  field: all

教程要求在站点配置文件中填入，但是填写后就会报错，所以不确定是否应该在主题根目录下配置。

八、最后

网络上有很多部署到git的教程，自行参考。执行命令hexo generate后会在目录下生产public文件夹，该文件夹是hexo生产的静态文件。可以部署发布到自己建的web服务器。以下列一些常用命令：

hexo new "postName"      #新建文章hexo new page "pageName" #新建页面hexo generate            #生成静态页面至public目录hexo server              #开启预览访问端口（默认端口4000，'ctrl + c'关闭server）hexo deploy              #将.deploy目录部署到GitHubhexo help                #查看帮助hexo version             #查看Hexo的版本

以下是命令的简写：

hexo n == hexo newhexo g == hexo generatehexo s == hexo serverhexo d == hexo deploy

参考：

配置相关

Hexo折腾记–基本配置篇

使用hexo框架搭建个人博客

使用Hexo + Next搭建静态博客

-

Markdown 语法

Markdown——入门指南