一、安装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: #简介
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
网友评论