【hexo】03config文件配置详解

拼搏现实的明天。 2021-09-30 16:16 252阅读 0赞

YAML 是专门用来写配置文件的语言，非常简洁和强大，我们的配置文件就是这种格式。需要了解的只有：

# 我是文配置件的注释

**重要提示，例如：“theme: landspace”中冒号右边是半角空格，要切换到英文状态哟**

## 网站site ##

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>title</code></td> 
   <td>网站标题</td> 
  </tr> 
  <tr> 
   <td><code>subtitle</code></td> 
   <td>网站副标题</td> 
  </tr> 
  <tr> 
   <td><code>description</code></td> 
   <td>网站描述</td> 
  </tr> 
  <tr> 
   <td><code>author</code></td> 
   <td>您的名字</td> 
  </tr> 
  <tr> 
   <td><code>language</code></td> 
   <td>网站使用的语言</td> 
  </tr> 
  <tr> 
   <td><code>timezone</code></td> 
   <td>网站时区。Hexo 默认使用您电脑的时区。<a href="https://en.wikipedia.org/wiki/List_of_tz_database_time_zones" rel="nofollow">时区列表</a>。比如说：<code>America/New_York</code>, <code>Japan</code>, 和 <code>UTC</code> 。</td> 
  </tr> 
 </tbody> 
</table>

其中，`description`主要用于SEO，告诉搜索引擎一个关于您站点的简单描述，通常建议在其中包含您网站的关键词。`author`参数用于主题显示文章的作者。

## 网址URL ##

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
   <th>默认值</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>url</code></td> 
   <td>网址</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td><code>root</code></td> 
   <td>网站根目录</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td><code>permalink</code></td> 
   <td>文章的 <a href="https://hexo.io/zh-cn/docs/permalinks.html" rel="nofollow">永久链接</a> 格式</td> 
   <td><code>:year/:month/:day/:title/</code></td> 
  </tr> 
  <tr> 
   <td><code>permalink_defaults</code></td> 
   <td>永久链接中各部分的默认值</td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

> 网站存放在子目录
> 
> 如果您的网站存放在子目录中，例如 `http://yoursite.com/blog`，则请将您的 `url` 设为 `http://yoursite.com/blog` 并把 `root` 设为 `/blog/`。

## 目录Directory ##

即：后面的参数都是文件夹的名称

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
   <th>默认值</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>source_dir</code></td> 
   <td>资源文件夹，这个文件夹用来存放内容。</td> 
   <td><code>source</code></td> 
  </tr> 
  <tr> 
   <td><code>public_dir</code></td> 
   <td>公共文件夹，这个文件夹用于存放生成的站点文件。</td> 
   <td><code>public</code></td> 
  </tr> 
  <tr> 
   <td><code>tag_dir</code></td> 
   <td>标签文件夹</td> 
   <td><code>tags</code></td> 
  </tr> 
  <tr> 
   <td><code>archive_dir</code></td> 
   <td>归档文件夹</td> 
   <td><code>archives</code></td> 
  </tr> 
  <tr> 
   <td><code>category_dir</code></td> 
   <td>分类文件夹</td> 
   <td><code>categories</code></td> 
  </tr> 
  <tr> 
   <td><code>code_dir</code></td> 
   <td>Include code 文件夹</td> 
   <td><code>downloads/code</code></td> 
  </tr> 
  <tr> 
   <td><code>i18n_dir</code></td> 
   <td>国际化（i18n）文件夹</td> 
   <td><code>:lang</code></td> 
  </tr> 
  <tr> 
   <td><code>skip_render</code></td> 
   <td>跳过指定文件的渲染，您可使用 <a href="https://github.com/isaacs/node-glob" rel="nofollow">glob 表达式</a>来匹配路径。</td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

> 提示
> 
> 如果您刚刚开始接触Hexo，通常没有必要修改这一部分的值。  
> 没到自己制作theme的水平别修改！！！！！！！！！！！！！！

## 文章Writing ##

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
   <th>默认值</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>new_post_name</code></td> 
   <td>新文章的文件名称</td> 
   <td>:title.md</td> 
  </tr> 
  <tr> 
   <td><code>default_layout</code></td> 
   <td>预设布局</td> 
   <td>post</td> 
  </tr> 
  <tr> 
   <td><code>auto_spacing</code></td> 
   <td>在中文和英文之间加入空格</td> 
   <td>false</td> 
  </tr> 
  <tr> 
   <td><code>titlecase</code></td> 
   <td>把标题转换为 title case</td> 
   <td>false</td> 
  </tr> 
  <tr> 
   <td><code>external_link</code></td> 
   <td>在新标签中打开链接</td> 
   <td>true</td> 
  </tr> 
  <tr> 
   <td><code>filename_case</code></td> 
   <td>把文件名称转换为 (1) 小写或 (2) 大写</td> 
   <td>0</td> 
  </tr> 
  <tr> 
   <td><code>render_drafts</code></td> 
   <td>显示草稿</td> 
   <td>false</td> 
  </tr> 
  <tr> 
   <td><code>post_asset_folder</code></td> 
   <td>启动 <a href="https://hexo.io/zh-cn/docs/asset-folders.html" rel="nofollow">Asset 文件夹</a></td> 
   <td>false</td> 
  </tr> 
  <tr> 
   <td><code>relative_link</code></td> 
   <td>把链接改为与根目录的相对位址</td> 
   <td>false</td> 
  </tr> 
  <tr> 
   <td><code>future</code></td> 
   <td>显示未来的文章</td> 
   <td>true</td> 
  </tr> 
  <tr> 
   <td><code>highlight</code></td> 
   <td>代码块的设置</td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

> 相对地址
> 
> 默认情况下，Hexo生成的超链接都是绝对地址。例如，如果您的网站域名为`example.com`,您有一篇文章名为`hello`，那么绝对链接可能像这样：`http://example.com/hello.html`，它是**绝对**于域名的。相对链接像这样：`/hello.html`，也就是说，无论用什么域名访问该站点，都没有关系，这在进行反向代理时可能用到。通常情况下，建议使用绝对地址。

## 分类 & 标签Category & Tag ##

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
   <th>默认值</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>default_category</code></td> 
   <td>默认分类</td> 
   <td><code>uncategorized</code></td> 
  </tr> 
  <tr> 
   <td><code>category_map</code></td> 
   <td>分类别名</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td><code>tag_map</code></td> 
   <td>标签别名</td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

## 日期 / 时间格式Date / Time format ##

Hexo 使用 [Moment.js][] 来解析和显示时间。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
   <th>默认值</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>date_format</code></td> 
   <td>日期格式</td> 
   <td><code>YYYY-MM-DD</code></td> 
  </tr> 
  <tr> 
   <td><code>time_format</code></td> 
   <td>时间格式</td> 
   <td><code>H:mm:ss</code></td> 
  </tr> 
 </tbody> 
</table>

## 分页Pagination ##

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
   <th>默认值</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>per_page</code></td> 
   <td>每页显示的文章量 (0 = 关闭分页功能)</td> 
   <td><code>10</code></td> 
  </tr> 
  <tr> 
   <td><code>pagination_dir</code></td> 
   <td>分页目录</td> 
   <td><code>page</code></td> 
  </tr> 
 </tbody> 
</table>

## 扩展Extensions ##

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>theme</code></td> 
   <td>当前主题名称。值为<code>false</code>时禁用主题</td> 
  </tr> 
  <tr> 
   <td><code>deploy</code></td> 
   <td>部署部分的设置</td> 
  </tr> 
 </tbody> 
</table>

转载于:https://www.cnblogs.com/hebust/p/9385496.html

[Moment.js]: http://momentjs.com/