博客搭建(四)-开始写我们的第一篇Blog
前言
前几篇文章已经将我们的blog部署至远端,并且设置了主题。现在我们可以开始创作我们的文章了。
正文
创建文件
Hexo的文章或者页面可以在终端执行下面命令来创建:
1 |
|
布局(layout)
Hexo有三种默认布局:post
,page
和draft
。在创建这三种不同类型的文件时,它们将会被保存到不同的路径;而您自定义的其他布局和 post
相同,都将储存到 source/_posts
文件夹。
布局 | 路径 |
---|---|
post | source/_posts |
page | source |
draft | source/_drafts |
如果你不希望一篇文章(post/page)使用主题处理,请在它的 front-matter 中设置 layout: false。详情请参考链接。
文件名称
Hexo 默认以标题做为文件名称,但您可编辑 new_post_name
参数来改变默认的文件名称,举例来说,设为 :year-:month-:day-:title.md
可让您更方便的通过日期来管理文章。你可以使用以下占位符:
变量 | 描述 |
---|---|
:title | 标题(小写,空格将会被替换为短杠) |
:year | 建立的年份,比如, 2023 |
:month | 建立的月份(有前导零),比如, 04 |
:i_month | 建立的月份(无前导零),比如, 4 |
:day | 建立的月份(有前导零),比如, 07 |
:i_day | 建立的月份(无前导零),比如, 7 |
草稿(draft)
Hexo的一种特殊布局:draft
,这种布局会被保存到 source/_drafts
文件夹,你可以通过 publish
命令来将草稿移动到 source/_posts
目录,你也可以在命令中指定layout来制定布局,命令如下:
1 |
|
草稿默认不会显示在页面中,您可在执行时加上 --draft
参数,或是在 _config.yml
中把 render_drafts
参数设为 true
来预览草稿。
模版(Scaffold)
在新建文章时,Hexo 会根据 scaffolds
文件夹内相对应的文件来建立文件,例如:
1 |
|
在执行这行指令时,Hexo 会尝试在 scaffolds
文件夹中寻找 photo.md
,并根据其内容建立文章,以下是您可以在模版中使用的变量:
变量 | 描述 |
---|---|
layout | 布局 |
title | 标题 |
date | 文件建立日期 |
支持的格式
Hexo 支持以任何格式书写文章,只要安装了相应的渲染插件。
例如,Hexo 默认安装了 hexo-renderer-marked 和 hexo-renderer-ejs,因此你不仅可以用 Markdown 写作,你还可以用 EJS 写作。如果你安装了 hexo-renderer-pug,你甚至可以用 Pug 模板语言书写文章。
只需要将文章的扩展名从 md 改成 ejs,Hexo 就会使用 hexo-renderer-ejs 渲染这个文件,其他格式同理。
Markdown
Markdown是一种轻量级标记语言,排版语法简洁,让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档,可与HTML混编,可导出 HTML、PDF 以及本身的 .md 格式的文件。
语法
目前我一般会用Markdown来编辑文字。至于Markdown语法也比较简单易懂。
Markdown语法教程可参考
工具
目前市面上有很多Markdown的编辑工具,这里只列举下我用过的,并且比较不错的工具。