个人博客搭建(二)
基本使用与自定义配置
环境搭建好了之后,就可以开始写文章了。文章内容以 markdown 形式保存,而后由 Hexo 自动生成网页文件。 markdown 的语法不再赘述,网上相应教程、简易 wiki极多。 重要的是怎么使用 hexo。 前置文章: 个人博客搭建(一)
写作
新建文章
CLI 命令
通常新建文件的命令为:
|
|
layout
代表文章的布局,已经预先定义在文章内容之外,只需选择对应布局进行调用即可title
代表文件名,有特殊字符时可以使用引号包裹
注意:要在 hexo 工作目录下使用此命令
Hexo 有三种默认布局:post
、page
和 draft
,它们分别对应不同的存储路径,而自定义的其他布局和 post
相同,都将储存到 source/_posts
文件夹。
一般的使用方式为 hexo new post "我的新 blog 文章"
,而后在 source/_posts
目录找到相应文件进行编辑即可。
常用 metadata
文章需要指定标题、副标题、类别、标签等,应该在 md 文件的开头使用一对分割线包裹相应设置项目,如本文的设置为:
|
|
一般
date
项会自动生成,不用自己填写
草稿
Hexo 有一种特殊布局:draft,这种布局在建立时会被保存到 source/_drafts
文件夹,可通过 publish
命令将草稿移动到 source/_posts
文件夹(发布为正式文章),该命令的使用方式与 new
十分类似,也可在命令中指定 layout
来指定布局。
|
|
草稿默认不会显示在页面中,可在执行时加上 --draft
参数,或是把 render_drafts
参数设为 true
来预览草稿。
其他
这里列出最基本、最常用的命令,其他详细的内容,应该参考 Hexo 官方文档。
记得撰写文章保存后使用
hexo g
生成页面
主题
可从官方主题库选择自己喜欢的主题,或者在 GitHub 上搜索。
安装
主题的安装方法非常简单:
- 下载主题文件夹到 hexo 工作目录的子目录
themes
- 将 hexo 工作目录的
_config.yml
文件的theme
选项修改为对应主题文件夹名称,如:
|
|
- 参考对应主题的说明文档进行个性化设置
推荐
Hexo 的主题功能与组织方式大同小异,只要弄明白一个,其他的也就很容易通晓了。入门之选自然应该选择说明最详实的,因此,推荐使用 next 主题,使用人数多,并且文档极为详细,功能齐全。 GitHub 地址为:https://github.com/iissnan/hexo-theme-next 主题文档地址为:http://theme-next.iissnan.com/
如果出现显示效果不完整,或者文章内容不完整,可以尝试清理 hexo 的内容缓存再重新生成页面,即
|
|
其他
RSS
Hexo 默认关闭 RSS 功能,需要下载插件并手动开启服务 插件下载:
|
|
打开服务需要编辑博客的 _config.yml
文件,加入如下条目:
|
|
RSS 功能还可选择 rss2 类型,即:
|
|
插入图片
- 打开对每篇文章分别保存图片的功能,修改博客
_config.yml
文件设置为:
|
|
将图片移动到
source/_posts
目录中的和当前文档名称完全相同的目录中而后通过如下格式插入图片
|
|
其中文件名项 file name
必须包含扩展名,而且包括大小写都必须完全匹配,图片名 title
可选。