Hexo的详细搭建过程——小白的血泪经历QAQ (3)

以下是预先定义的参数,你可在模板中使用这些参数值并加以利用。

参数 描述 默认值
layout   布局   config.default_layout  
title   标题   文章的文件名  
date   建立日期   文件建立日期  
updated   更新日期   文件更新日期  
comments   开启文章的评论功能   true  
tags   标签(不适用于分页)    
categories   分类(不适用于分页)    
permalink   覆盖文章网址    
excerpt   Page excerpt in plain text. Use to format the text    
disableNunjucks   Disable rendering of Nunjucks tag {{ }}/{% %} and tag plugins when enabled    
分类和标签

只有文章支持分类和标签,您可以在 Front-matter 中设置。在其他系统中,分类和标签听起来很接近,但是在 Hexo 中两者有着明显的差别:分类具有顺序性和层次性,也就是说 Foo, Bar 不等于 Bar, Foo;而标签没有顺序和层次。

categories: - Diary tags: - PS3 - Games

分类方法的分歧

如果您有过使用 WordPress 的经验,就很容易误解 Hexo 的分类方式。WordPress 支持对一篇文章设置多个分类,而且这些分类可以是同级的,也可以是父子分类。但是 Hexo 不支持指定多个同级分类。下面的指定方法:

categories: - Diary - Life

会使分类Life成为Diary的子分类,而不是并列分类。因此,有必要为您的文章选择尽可能准确的分类。

如果你需要为文章添加多个分类,可以尝试以下 list 中的方法。

categories: - [Diary, PlayStation] - [Diary, Games] - [Life]

此时这篇文章同时包括三个分类: PlayStation 和 Games 分别都是父分类 Diary 的子分类,同时 Life 是一个没有子分类的分类。

永久链接(Permalinks)

您可以在 _config.yml 配置中调整网站的永久链接或者在每篇文章的 Front-matter 中指定。

变量

除了下列变量外,您还可使用 Front-matter 中的所有属性。

变量 描述
:year   文章的发表年份(4 位数)  
:month   文章的发表月份(2 位数)  
:i_month   文章的发表月份(去掉开头的零)  
:day   文章的发表日期 (2 位数)  
:i_day   文章的发表日期(去掉开头的零)  
:hour   文章发表时的小时 (2 位数)  
:minute   文章发表时的分钟 (2 位数)  
:second   文章发表时的秒钟 (2 位数)  
:title   文件名称 (relative to “source/_posts/“ folder)  
:name   文件名称  
:post_title   文章标题  
:id   文章 ID (not persistent across )  
:category   分类。如果文章没有分类,则是 default_category 配置信息。  
:hash   SHA1 hash of filename (same as :title) and date (12-hexadecimal)  

您可在 permalink_defaults 参数下调整永久链接中各变量的默认值:

permalink_defaults: lang: en 示例 source/_posts/hello-world.mdtitle: Hello World date: 2013-07-14 17:01:34 categories: - foo - bar 参数 结果
:year/:month/:day/:title/   2013/07/14/hello-world/  
:year-:month-:day-:title.html   2013-07-14-hello-world.html  
:category/:title/   foo/bar/hello-world/  
:title-:hash/   hello-world-a2c8ac003b43/  
source/_posts/lorem/hello-world.mdtitle: Hello World date: 2013-07-14 17:01:34 categories: - foo - bar 参数 结果
:year/:month/:day/:title/   2013/07/14/lorem/hello-world/  
:year/:month/:day/:name/   2013/07/14/hello-world/  
多语种支持

若要建立一个多语种的网站,您可修改 new_post_name 和 permalink 参数,如下:

new_post_name: :lang/:title.md permalink: :lang/:title/

当您建立新文章时,文章会被储存到:

$ hexo new "Hello World" --lang tw # => source/_posts/tw/Hello-World.md

而网址会是:

:4000/tw/hello-world/ 常见问题 将SSH密钥添加到SSH代理提示No such file or directory

生成密钥时请按默认名称试试,如果自定义名字需要输入绝对路径

Hexo部署成功后GitHub无更新文章

Hexo只负责调用Git命令,不会侦测线程错误,就算看到INFO Deploy done: git也不一定意味着Git是运行正确的。

如果是Windows端,请在Git Bash中运行命令。

也可能是未成功添加SSH密钥,请重新按照上面流程再配置一遍。

Hexo部署成功后新内容在Github仓库上有而网页上没有

涉及:HTTP缓存 - Google 搜索

解决办法:Ctrl + F5强制刷新,或者尝试其他清除缓存或禁用缓存(不建议)的方法。

解决克隆Github仓库过慢的问题

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://www.heiqu.com/zyswwx.html