流程
全局安装 hexo 命令库
npm install hexo-cli -g
创建一个博客项目(一般只在首次创建,后续操作从第三步开始即可)
hexo init blog
进入博客项目
cd blog
新建&编辑文章
命令行中输入以下指令以创建新文章:
hexo new "new article"
执行后在 source/_posts 中生成了一个 new-article.md 文件
文件中的初始内容为:
---
title: new article
date: 2014-11-01 20:10:33
tags:
---
使用三个 “-” 字符包裹着页面的属性,采用 yaml 格式书写
接着是正文,采用 markdown 格式书写
生成静态文件
hexo generate/g
本地服务预览
命令行中输入以下指令启动本地服务器
hexo server/s
然后在浏览器窗口打开 localhost:4000
注意:在新建、删除或修改文章之后,不需要重新启动服务器,只需刷新一下页面就能预览新的改动
发布到服务器上
命令行中输入以下指令
hexo deploy/d
前提:必须在站点配置文件 _config.yml 中做以下配置:
deploy:
type: git
repository: git@github.com:用户名/仓库名.git
branch: master
这里只会把根目录中的 public 整个文件夹发布到服务器,因为这里面才是所有工作的产出物——我们的博客静态文件。我们之前所有操作都是在为这个产出做准备工作。
属性
文章可以拥有如下属性:
Setting | Description | Default |
---|---|---|
layout | Layout | post或page |
title | 文章的标题 | |
date | 文章的创建日期 | 文章的创建日期 |
updated | 文章的更新日期 | 文章的更新日期 |
comments | 是否开启评论 | true |
tags | 标签 | |
categories | 分类 | |
permalink | url中的名字 | 文件名 |
分类和标签的写法
在正文之前的配置项中配置相应的文本即可
categories:
- 日记
tags:
- Hexo
- node.js
# 或者写成数组的形式
categories: 日记
tags: [Hexo, node.js]
首页摘要
同 wordpress 一样,在正文中 之上的内容显示为摘要。
layout
如果你修改了 layout,在 scaffolds 文件夹里一定要有名字对应的模版文件,否则会采用默认模版。
文件名
在配置文件中的 new_post_name
项可以设置文件名,默认为 :title
,也就是你在命令行输入的名字。
文件名可以为下面几个变量和字符串常量的任意组合:
Variable | Description |
---|---|
:title | Escaped title (lower case and replace spaces with dash) |
:year | Created year (4-digit) |
:month | Created month (2-digit) |
:i_month | Created month (Without leading zeros) |
:day | Created day (2-digit) |
:i_day | Created day (Without leading zeros) |
草稿
草稿相当于很多博客都有的 “私密文章” 功能。
hexo new draft "new draft"
会在 source/_drafts 目录下生成一个 new-draft.md 文件。但是这个文件不被显示在页面上,链接也访问不到。也就是说如果你想把某一篇文章移除显示,又不舍得删除,可以把它移动到 _drafts 目录之中。
如果你希望强行预览草稿,更改配置文件:
render_drafts: true
或者,如下方式启动server:
hexo server --drafts
下面这条命令可以把草稿变成文章,或者页面:
hexo publish [layout] <filename>