Jekyll 目录与文章模板

目录结构

本页保留来源博客的历史模板。目录名按 Jekyll 官方结构核对；gem 主题可能在主题包中提供布局。使用 GitHub Pages 时，.nojekyll 的作用需按其构建方式确认。

• _config.yml 配置文件,配置 jekyll 的一切以及变量
• index.md/html 主页入口示例
• .gitignore 被忽略上传到 github 的文件(夹)列表
• .jekyll-metadata 用来记录追踪文件修改情况,以便更新.
• _layouts 模板文件夹,用来生成相应子页面的模板,在子页面中 layout: page 指定
• _posts 相应子页面(博客)所在位置,文件名规则:2015-07-24-name.md/html
• _includes 用来包含一些常用需要的结构块文件,例如 comment.使用 {% include file.ext %} 来包含(\去掉).非必须.
• _site 如果使用 jekyll 本地版生成页面就会有该文件夹.一般会被判断为不上传到 github.非必须.
• _drafts 草稿文件，默认不发布；预览草稿需显式启用。非必须。
• _data 格式化好的网站数据应放在这里。jekyll 的引擎会自动加载在该目录下所有的 yaml 文件（后缀是 .yml 或者 .yaml).可通过 site.data 在模板中访问。非必须

文章标头

标准字段与自定义变量需分开看：title、date、tags、categories 是常见文章字段；toc、comments、math、mermaid、pin、image 等是否生效取决于主题或插件。来源未注明主题版本，不能保证这些开关可移植。控制文章发布可使用标准字段 published: false，不要把自定义的 draft 当作通用发布开关。

2026-10-31 核对来源博客工作副本：_config.yml 声明 jekyll-theme-chirpy，Gemfile 约束为 ~> 7.6 且 >= 7.6.0。这能确认该副本的主题及依赖范围；仓库未提供 Gemfile.lock，不能据此确定实际安装版本，也不能反推下方 2018 年日期示例使用的主题版本。使用模板时，应以目标博客的主题配置、锁文件和实际渲染结果核对这些字段。

---
title: 标题
date: 2018-08-08 14:10:00 +0800 # 时间
draft: false # 来源主题字段，非通用发布开关
tags: [Cc] # 分类
categories: [Cc , Left] # 类别
toc: false
comments: false # 评论
math: true # 数学
mermaid: true # 图标
pin: false # 顶置
description: 解释
image:
  path: /assets/img/c/c.jpeg
---