Qiubaiying.github.io 开源项目使用手册-CSDN博客

本文链接：https://blog.csdn.net/gitblog_01162/article/details/141382656

Qiubaiying.github.io 开源项目使用手册

qiubaiying.github.ioBY Blog ->项目地址:https://gitcode.com/gh_mirrors/qi/qiubaiying.github.io

本手册旨在提供一个清晰的指南，帮助用户理解并运行 qiubaiying/qiubaiying.github.io 这一开源项目。我们将逐步解析其目录结构、启动与配置要领，确保您能够顺利地搭建并定制这个基于GitHub Pages的个人博客模板。

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

Qiubaiying 的GitHub.io项目遵循了一个典型的静态网站结构：

 qiubaiying.github.io/
 ├── _includes               # 包含重用的部分，如页脚、头部等。
 ├── _layouts                # 定义页面布局的模板，比如默认的文章布局。
 ├── _posts                  # 存放Markdown格式的文章。
 ├── assets                  # 静态资源文件夹，包括CSS、JavaScript和其他媒体文件。
 ├── about.md                # 关于作者的页面。
 ├── index.html              # 主页的HTML文件。
 ├── .gitignore              # Git忽略文件列表。
 ├── LICENSE                 # 许可证文件。
 ├── README.md               # 项目说明文档。
 └── CNAME                   # 如果自定义域名，则该文件指定域名。

重点说明:

_posts: 您在此添加新的Markdown文件来发布博客文章。
assets: 放置所有前端资源，如定制CSS样式和JS脚本。
_layouts: 控制网页外观和文章展示方式的关键。

2. 项目的启动文件介绍

对于一个基于Jekyll或其他静态站点生成器的GitHub Pages项目而言，启动通常不需要直接执行代码，而是通过提交更改到GitHub仓库并通过GitHub Pages服务自动构建和部署。然而，核心“启动”点是配置文件_config.yml以及您的入口点index.html。

index.html: 这个文件定义了主页的结构，是用户访问时首先看到的内容。
_config.yml: 虽然不是直接“启动”文件，但极为重要，用于设置站点元数据，如标题、描述、作者信息及Jekyll构建选项等，是项目的配置中枢。

3. 项目的配置文件介绍

_config.yml 示例结构简述如下：

title: 卿白云的个人博客
author: 卿白云
email: your@email.com
description: > # this means to ignore newlines until the next tag
  一段关于你的个人介绍或博客宗旨。

# social usernames (if you want them to appear)
twitter_username: qiubaiying_
github_username: qiubaiying

# Build settings
theme: minima
plugins:
  - jekyll-feed
exclude:
  - Gemfile
  - Gemfile.lock

基本信息: 如上所示，您可以编辑title, author, 和description字段以个性化您的博客。
社交链接: 设置您的社交媒体用户名，以便在导航栏中显示链接。
构建设置: 指定使用的主题(theme)、激活插件(plugins)等。例如，jekyll-feed用于生成RSS订阅文件。
排除文件: 指明哪些文件不应被包含在最终发布的站点中，常见的有开发环境中的.git、Gemfile等。