Nest是一款制作精良,不断维护的大众款博客主题。好的主题往往拥有[友好的文档](http://theme-next.iissnan.com/theme-settings.html)、[合理的接口](http://theme-next.iissnan.com/third-party-services.html)、[技术讨论和更新支持](https://github.com/iissnan/hexo-theme-next/issues)。这款主题适合新手入手,通过配置可以达到自己想要的定制化效果。
本文详细说明配置文件中的设置选项含义,适合初学者了解配置内容和信息备查。主题的安装过程在挑选和初步配置Hexo主题中已经有所讲解,这里默认大家已经搭建好本地环境,选择了对应的子主题。
文件说明
- 博客配置文件:在博客源代码的文件夹下的“_config.yml”文件,是Hexo博客内置的默认配置文件。
- 主题配置文件:在主题文件夹下的“_config.yml”文件,是主题内置的默认配置文件。
- 主题配置的所有主要说明在官方文档里都有体现。有一些不太明白的地方Google一下,或者直接去仓库发Issue,基本都能找到答案。
博客配置文件
博客配置文件功能清单
名称 | 作用说明 | 配置类型 | 备注 |
---|---|---|---|
网站(Site) | 博客名称、副标题、作者、语言设置 | 基础配置 | |
链接(URL) | 博客的链接、根目录、链接格式等 | 基础配置 | |
目录(Directory) | 基础配置 | ||
书写(Writing) | 基础配置 | ||
分类和标签(Category & Tag) | 优化配置 | ||
日期和时间格式(Date / Time format) | 用于设置日期和时间默认格式 | 基础配置 | |
分页(Pagination) | 优化配置 | ||
扩展设置(Extensions) | 设置主题 | 基础配置 | 从零开始新建Hexo博客已详细说明 |
部署(Deployment) | 部署设置 | 基础配置 | 从零开始新建Hexo博客已详细说明 |
博客配置文件详细解释
#### 网站(Site)# Site
title: 浚宇的博客
subtitle:
description:
author: 浚宇
language: zh-Hans
timezone:
“title”:博客的名称,一般是要填写的,仁者见仁。 “subtitle、description”:根据主题的不同,有的会显示有的不会显示。我的这个主题不会显示,所以自己并没有填写。 “author”:作者,建议填写。 “language”:语言会对应的解析正在应用的主题中的languages文件夹下的不同语言文件。所以这里的名称要和languages文件夹下的语言文件名称一致。 “timezone”:可不填写。
#### 链接(URL) ```` # URL ## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/' url: http://blog.junyu.pro root: / # permalink: :year/:month/:day/:title/ permalink: posts/:category/:title.html permalink_defaults: ```` "url":一般填写自己的站点链接。 "root":设置根目录的位置,如果站点在服务器上的子目录,就需要做设置。 "permalink":生成的链接的格式。带井号的是默认的格式,带有日期感觉怪怪的,改成了自己喜欢的格式。规则也比较简单,标签前面要加英文冒号。 "permalink_defaults" 注意:由于作者的需求比较简单,这里的内容解释相对简单。实际上关于变量和permalink的作用还有很多,甚至可以建立多语言的站点,可以参考:[Hexo的高级进阶](http://www.ituring.com.cn/article/199294) #### 目录(Directory) ```` # Directory source_dir: source public_dir: public tag_dir: tags archive_dir: archives category_dir: categories code_dir: downloads/code i18n_dir: :lang skip_render: ```` 目录结构一般是不动的的,保持默认即可。 #### 书写(Writing) ```` # Writing new_post_name: :title.md # File name of new posts default_layout: post titlecase: false # Transform title into titlecase external_link: true # Open external links in new tab filename_case: 0 render_drafts: false post_asset_folder: false relative_link: false future: true highlight: enable: true line_number: true auto_detect: true tab_replace: ```` 书写相关的事宜 “new_post_name”:新的博文的文件名 “default_layout:“ 默认布局 “titlecase: false“ # Transform title into titlecase “external_link: true“ #Open external links in new tab “filename_case: 0“ #把文件名称转换为 (1) 小写或 (2) 大写 “render_drafts: false“ 是否显示草稿 “post_asset_folder: false“ #是否启动资源文件夹 “relative_link: false“ #把链接改为与根目录的相对位址 “future: true “ “highlight:“ #代码块的设置 “enable: true“ “line_number: true“ “auto_detect: true“ “tab_replace:“ #### 分类和标签(Category & Tag) ```` # Category & Tag default_category: uncategorized category_map: 博客技术: hexo 数据科学: ds 千字文: essay tag_map: 千字文: essay ```` 分类和标签的设置。 “default_category”:如果撰写文章时没有设置分类,默认的分类选择。 “category_map”:用于映射分类的别名,url就可以尽量简洁。 “tag_map”:用法和分类别名是一样的。 #### 日期和时间格式(Date / Time format) ```` # Date / Time format ## Hexo uses Moment.js to parse and display date ## You can customize the date format as defined in ## http://momentjs.com/docs/#/displaying/format/ date_format: YYYY-MM-DD time_format: HH:mm:ss ```` 日期格式,一般都是默认。 #### 分页(Pagination) ```` # Pagination ## Set per_page to 0 to disable pagination per_page: 10 pagination_dir: page ```` 分页,如果“per_page:0”就会关闭分页功能。目前设置的是每页显示十篇文章。且显示的分页目录是page页面。 #### 扩展设置(Extensions) ```` # Extensions ## Plugins: https://hexo.io/plugins/ ## Themes: https://hexo.io/themes/ # theme: landscape theme: next ```` [挑选和初步配置Hexo主题](http://blog.junyu.pro/posts/0003-choose-a-theme-you-like.html)已详细说明,不再赘述。 #### 部署(Deployment) ```` # Deployment ## Docs: https://hexo.io/docs/deployment.html deploy: type: git repo: branch: ```` [从零开始新建Hexo博客](http://blog.junyu.pro/posts/0002-start-blog-with-hexo.html)已详细说明,不再赘述。主题配置文件
主题配置文件功能清单
一级名称 | 二级名称 | 配置类型 | ||
---|---|---|---|---|
站点信息设置(Site Information Settings) | 设置favicon图标 | 优化配置 | ||
设置默认关键字 | 优化配置 | |||
Rss设置 | 优化配置 | |||
建站时间 | 基础配置 | |||
Canonical标签 | 优化配置 | |||
目录设置(Menu Settings) | 目录结构 | |||
目录图标 | ||||
主题设置(Scheme Settings) | 基础配置 | |||
字体设置(Font Settings) | 优化配置 | |||
侧边栏设置(Sidebar Settings) | 社交链接设置(Social Links) | 优化配置 | ||
社交链接图标设置(Social Links Icons) | 优化配置 | |||
侧边栏头像设置(Sidebar Avatar) | 基础配置 | |||
侧边栏内容设置(Table Of Contents in the Sidebar) | 优化配置 | |||
4.0证书(Creative Commons 4.0 International License) | 优化配置 | |||
侧边栏位置相关 | 优化配置 | |||
友情链接设置(Blogrolls) | 优化配置 | |||
Misc主题设置(Misc Theme Settings) | 优化配置 | |||
第三方服务设置(Third Party Services Settings) | 优化配置 | |||
不要碰的设置 | 基础配置 |
主题配置文件的详细解释参见Next主题配置文件说明
[完](http://blog.junyu.pro)
声明: 本文转载需标明出处,禁止用于商业目的。
ChangeLog
20161110 新建 20161110 发布 20161111 更新 20161112 更新