Balzac-for-Jekyll 项目使用教程

Balzac-for-Jekyll 项目使用教程

Balzac-for-JekyllYour favorite AnchorCMS theme, now for Jekyll!项目地址:https://gitcode.com/gh_mirrors/ba/Balzac-for-Jekyll

1. 项目的目录结构及介绍

Balzac-for-Jekyll 项目的目录结构如下：

balzac-for-jekyll/
├── _includes
│   ├── footer.html // 网站页脚
│   ├── head.html // 网站头部
│   ├── head-dark.html // 深色网站头部，用于浅色页面
├── _layouts
│   ├── home.html // 首页布局
│   ├── page.html // 页面布局
│   ├── post-index.html // 文章列表布局
│   ├── post.html // 文章布局
│   ├── post-no-feature.html // 无特色图片的文章布局
├── _posts
├── assets
│   ├── css // 预处理的 less 样式，建议压缩
│   ├── img // 用于 css 和 js 的图片和图形
│   ├── js
│   │   ├── main.js // jQuery 插件和设置
│   │   └── vendor // 所有第三方脚本
│   └── sass
├── images // 用于文章和页面的图片
├── about.md // 关于页面
├── articles.md // 列出所有文章，从最新到最旧
└── index.md

目录结构介绍

• _includes：包含网站的公共部分，如页脚和头部。
• _layouts：包含不同页面的布局模板。
• _posts：存放博客文章的目录。
• assets：包含网站的静态资源，如 CSS、图片和 JavaScript 文件。
• images：存放文章和页面使用的图片。
• about.md：关于页面的内容。
• articles.md：列出所有文章的页面。
• index.md：首页的内容。

2. 项目的启动文件介绍

Balzac-for-Jekyll 项目的启动文件主要是 index.md 和 _config.yml。

index.md

index.md 是网站的首页内容文件，通常包含网站的主要内容和布局。

_config.yml

_config.yml 是 Jekyll 项目的配置文件，包含网站的全局配置信息，如网站标题、描述、URL 等。

3. 项目的配置文件介绍

Balzac-for-Jekyll 项目的配置文件是 _config.yml。

_config.yml 配置文件介绍

_config.yml 文件包含以下主要配置项：

• title：网站的标题。
• description：网站的描述。
• url：网站的 URL。
• baseurl：网站的基本 URL（如果网站部署在子目录中）。
• permalink：文章的永久链接格式。
• markdown：使用的 Markdown 渲染引擎。
• theme：使用的主题。

示例配置：

title: "Balzac for Jekyll"
description: "Your favorite AnchorCMS theme now for Jekyll"
url: "https://example.com"
baseurl: ""
permalink: /:year/:month/:day/:title/
markdown: kramdown
theme: balzac

通过修改 _config.yml 文件，可以自定义网站的各种配置。

Balzac-for-JekyllYour favorite AnchorCMS theme, now for Jekyll!项目地址:https://gitcode.com/gh_mirrors/ba/Balzac-for-Jekyll