开源项目 `blog` 使用教程

开源项目 blog 使用教程

blog个人博客项目地址:https://gitcode.com/gh_mirrors/blog37/blog

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

blog/
├── _config.yml
├── _data
│   └── members.yml
├── _drafts
│   ├── draft-1.md
│   └── draft-2.md
├── _includes
│   ├── footer.html
│   ├── header.html
│   └── sidebar.html
├── _layouts
│   ├── default.html
│   ├── post.html
│   └── page.html
├── _posts
│   ├── 2021-01-01-title1.md
│   └── 2021-02-02-title2.md
├── _sass
│   ├── _base.scss
│   └── _layout.scss
├── assets
│   └── css
│       └── main.scss
├── Gemfile
├── Gemfile.lock
├── index.html
└── README.md

• _config.yml: 项目的配置文件。
• _data/: 存储项目数据文件，如 members.yml。
• _drafts/: 存储草稿文件。
• _includes/: 存储可重用的HTML片段，如页眉、页脚和侧边栏。
• _layouts/: 存储页面布局模板。
• _posts/: 存储博客文章。
• _sass/: 存储SASS样式文件。
• assets/: 存储资源文件，如CSS。
• Gemfile 和 Gemfile.lock: 用于管理项目的依赖。
• index.html: 项目的主页。
• README.md: 项目的说明文档。

2. 项目的启动文件介绍

项目的启动文件是 index.html。这是用户访问博客时的入口文件，它包含了页面的基本结构和内容。通常，这个文件会引用 _includes/ 目录下的组件，如页眉、页脚和侧边栏，以及 assets/ 目录下的CSS和JavaScript文件。

3. 项目的配置文件介绍

项目的配置文件是 _config.yml。这个文件包含了博客的全局配置信息，如站点标题、描述、URL、作者信息等。以下是一个示例配置：

title: 我的博客
email: example@example.com
description: >- # this means to ignore newlines until "baseurl:"
  这是一个示例博客，用于展示如何使用Jekyll构建静态网站。
baseurl: "" # the subpath of your site, e.g. /blog
url: "http://example.com" # the base hostname & protocol for your site, e.g. http://example.com
twitter_username: jekyllrb
github_username:  jekyll

# Build settings
markdown: kramdown
theme: minima
plugins:
  - jekyll-feed

• title: 博客的标题。
• email: 作者的电子邮件地址。
• description: 博客的描述。
• baseurl: 博客的子路径。
• url: 博客的基础URL。
• twitter_username 和 github_username: 作者的社交媒体用户名。
• markdown: 使用的Markdown渲染引擎。
• theme: 使用的主题。
• plugins: 使用的插件列表。

通过修改 _config.yml 文件，可以自定义博客的外观和行为。

blog个人博客项目地址:https://gitcode.com/gh_mirrors/blog37/blog