Centrarium Jekyll 主题使用教程
centrariumA simple yet classy theme for your Jekyll website or blog.项目地址:https://gitcode.com/gh_mirrors/ce/centrarium
1. 项目的目录结构及介绍
Centrarium 是一个为 Jekyll 网站或博客设计的简单而优雅的主题。以下是其主要目录结构及其功能介绍:
centrarium/
├── _includes/ # 包含页面的各个部分,如头部、底部等
├── _layouts/ # 定义页面布局模板
├── _posts/ # 存放博客文章的目录
├── _sass/ # 存放 SASS 样式文件
├── assets/ # 存放静态资源,如图片、CSS、JavaScript 文件
├── _config.yml # 项目的配置文件
├── about.md # 关于页面
├── index.html # 主页文件
└── README.md # 项目说明文档
主要目录和文件介绍
- _includes/: 包含页面的各个部分,如头部 (
header.html
)、底部 (footer.html
) 等。 - _layouts/: 定义页面布局模板,如默认布局 (
default.html
)、文章布局 (post.html
) 等。 - _posts/: 存放博客文章的目录,文章文件名格式为
YYYY-MM-DD-title.md
。 - _sass/: 存放 SASS 样式文件,用于生成 CSS 文件。
- assets/: 存放静态资源,如图片、CSS、JavaScript 文件。
- _config.yml: 项目的配置文件,包含网站的基本设置和配置选项。
- about.md: 关于页面,用于展示网站或博客的介绍信息。
- index.html: 主页文件,定义网站的主页内容和布局。
- README.md: 项目说明文档,包含项目的安装和使用说明。
2. 项目的启动文件介绍
Centrarium 项目的启动文件是 index.html
,它定义了网站的主页内容和布局。以下是 index.html
的主要内容:
---
layout: default
---
<header class="site-header">
<!-- 头部内容 -->
</header>
<main class="content">
<!-- 主页内容 -->
</main>
<footer class="site-footer">
<!-- 底部内容 -->
</footer>
启动文件主要功能
- 头部 (
<header>
): 包含网站的标题、导航栏等。 - 主页内容 (
<main>
): 展示博客文章列表、特色图片等。 - 底部 (
<footer>
): 包含版权信息、联系方式等。
3. 项目的配置文件介绍
Centrarium 项目的配置文件是 _config.yml
,它包含了网站的基本设置和配置选项。以下是 _config.yml
的主要内容:
title: "Centrarium"
description: "A simple yet classy theme for your Jekyll website or blog."
baseurl: ""
url: "http://localhost:4000"
# 作者信息
author:
name: "Ben Centra"
email: "bencentra@example.com"
twitter: "bencentra"
# 导航栏
navigation:
- title: "Home"
url: "/"
- title: "About"
url: "/about"
# 其他配置
markdown: kramdown
highlighter: rouge
配置文件主要功能
- 网站基本信息: 包括网站标题 (
title
)、描述 (description
)、基础 URL (baseurl
) 和网站 URL (url
)。 - 作者信息: 包含作者的姓名 (
name
)、电子邮件 (email
) 和 Twitter 用户名 (twitter
)。 - 导航栏: 定义网站的导航栏菜单项。
- 其他配置: 包括 Markdown 解析器 (
markdown
) 和代码高亮器 (highlighter
)。
通过修改 _config.yml
文件,可以自定义网站的标题、描述、作者信息、导航栏等,以满足个性化需求。
centrariumA simple yet classy theme for your Jekyll website or blog.项目地址:https://gitcode.com/gh_mirrors/ce/centrarium