上一篇我们已经初始化了你的博客,
本篇将会教你如何撰写自己的第一篇博文和自己的第一个页面。
由于多方面因素影响,该栏目停止更新,是否恢复待定。
创建博文/页面
首先我们要先切换到我们博客的文件夹,
cd <文件夹名称>
然后我们可以通过下面的指令创建自己的文章
1 | hexo new [模板] <标题> |
在默认情况下,我们只需要hexo new <标题>
即可创建一篇新的文章,这是因为我们已经在_config.yml
中指定了默认的创建模板,如果你需要修改,可以修改default_layout
参数。
布局(Layout)
Hexo 有三种默认布局:post
、page
和 draft
。在创建这三种不同类型的文件时,它们将会被保存到不同的路径;而您自定义的其他布局和 post
相同,都将储存到 source/_posts
文件夹。
布局 | 路径 |
---|---|
post |
source/_posts |
page |
source |
draft |
source/_drafts |
创建完成后,你可以按照上面表格的路径去找到你新创建的文章,享受写作吧!
了解Front-matter
以下内容摘录自Hexo官网文档
Front-matter 是文件最上方以 ---
分隔的区域,用于指定个别文件的变量,举例来说:
1 | --- |
以下是预先定义的参数,您可在模板中使用这些参数值并加以利用。
参数 | 描述 | 默认值 |
---|---|---|
layout |
布局 | config.default_layout |
title |
标题 | 文章的文件名 |
date |
建立日期 | 文件建立日期 |
updated |
更新日期 | 文件更新日期 |
comments |
开启文章的评论功能 | true |
tags |
标签(不适用于分页) | |
categories |
分类(不适用于分页) | |
permalink |
覆盖文章的永久链接,永久链接应该以 / 或 .html 结尾 |
null |
excerpt |
纯文本的页面摘要。使用 该插件 来格式化文本 | |
disableNunjucks |
启用时禁用 Nunjucks 标签 {{ }} /{% %} 和 标签插件 的渲染功能 |
false |
lang |
设置语言以覆盖 自动检测 | 继承自 _config.yml |
提示:部分主题和Hexo插件会有自己的Front-Matter规则,具体新增的项目请参考对应插件和主题的文档使用
进阶教学
创建一个草稿
刚刚我们提到了 Hexo 的一种特殊布局:draft
,
这种布局在建立时会被保存到 source/_drafts
文件夹,
我们可以使用下面的指令来让草稿正式发布
1 | hexo publish [layout] <title> |
草稿默认不会显示在页面中,您可在执行时加上 --draft
参数,或是把 render_drafts
参数设为 true
来预览草稿
分类和标签
以下内容摘录自Hexo官网文档
只有文章支持分类和标签,您可以在 Front-matter 中设置。在其他系统中,分类和标签听起来很接近,但是在 Hexo 中两者有着明显的差别:分类具有顺序性和层次性,也就是说 Foo, Bar
不等于 Bar, Foo
;而标签没有顺序和层次。
1 | categories: |
分类方法的分歧
如果您有过使用 WordPress 的经验,就很容易误解 Hexo 的分类方式。WordPress 支持对一篇文章设置多个分类,而且这些分类可以是同级的,也可以是父子分类。但是 Hexo 不支持指定多个同级分类。下面的指定方法:
1
2
3 categories:
- Diary
- Life会使分类
Life
成为Diary
的子分类,而不是并列分类。因此,有必要为您的文章选择尽可能准确的分类。如果你需要为文章添加多个分类,可以尝试以下 list 中的方法。
1
2
3
4 categories:
- [Diary, PlayStation]
- [Diary, Games]
- [Life]此时这篇文章同时包括三个分类:
PlayStation
和Games
分别都是父分类Diary
的子分类,同时Life
是一个没有子分类的分类。