Centrarium Jekyll 主题使用教程

71 0 0

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)。