Hexo使用总结(1)

一、安装hexo

1.安装

$ npm install hexo-cli -g  制定一个目录  默认会安装在执行命令的对应的文件夹

$ hexo init blog

$ cd blog

$ npm install

2.Demo生成以及预览

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

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

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

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

基本配置

title: Hexo          #博客的标题

description:  Hexo使用总结     #简介

author: matt    #作者

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

生成,部署也可以这样写:

hexo d -g
如果文章对您有用,请随意打赏,谢谢。