导语
使用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.html
theme: next
打赏配置
reward_comment: 坚持原创技术分享,您的支持将鼓励我继续创作!
wechatpay: /images/wechatpay.jpg
alipay: /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: categories
date: 2016-11-29 11:49:50
type: "categories"
comments: false
2.添加标签
$ hexo new page tags
- 确认站点配置文件里有tag_dir: tags
- 确认主题配置文件里有tags: /tags
- *
title: tags
date: 2016-11-29 11:49:50
type: "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
- tag2
categories: 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目录部署到GitHub
hexo help #查看帮助
hexo version #查看Hexo的版本
以下是命令的简写:
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy
参考:
配置相关
-
Markdown 语法