Rubber Duck Debugging 项目使用教程

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

Rubber Duck Debugging 项目是一个向 Rubber Duck Debugging 方法致敬的开源项目。以下是项目的目录结构及各部分功能的介绍：

rubberduckdebugging.github.io/
├── _includes/              # 包含页面中复用的内容
├── _layouts/               # 页面布局文件
├── _posts/                 # 博客文章
├── _sass/                  # SCSS 文件，用于生成 CSS
├── images/                 # 存储图片资源
├── .gitignore              # 指定 Git 忽略的文件和目录
├── 404.md                  # 404 错误页面
├── CNAME                   # 自定义域名配置文件
├── LICENSE                 # 开源许可证文件
├── README.md               # 项目描述文件
├── _config.yml             # 配置文件
├── cyberduck.md            # 页面内容文件
├── favicon.ico             # 网站图标
└── index.md                # 网站首页内容文件

• _includes/: 存储可以复用的 HTML 片段，例如页脚、导航栏等。
• _layouts/: 存储页面布局的模板文件，用于生成网站的不同页面。
• _posts/: 存储博客文章的 Markdown 文件。
• _sass/: 存储 SCSS 文件，这些文件会被编译成 CSS，用于网站样式。
• images/: 存储网站所需的各种图片资源。
• .gitignore: 指定 Git 在版本控制时应忽略的文件和目录。
• 404.md: 定义了网站访问不存在页面时显示的 404 错误页面。
• CNAME: 如果要使用自定义域名，可以在这个文件中指定。
• LICENSE: 项目使用的开源许可证文件，本项目使用 MIT 许可证。
• README.md: 项目描述文件，介绍了项目的基本信息和如何使用。
• _config.yml: 配置文件，用于配置网站的基本信息、主题等。
• cyberduck.md: 页面内容文件，包含了页面具体内容。
• favicon.ico: 网站图标，通常显示在浏览器标签页上。

2. 项目的启动文件介绍

项目的启动文件是 index.md。该文件定义了网站首页的内容，使用 Markdown 格式编写。当访问网站根目录时，会显示该文件的内容。

3. 项目的配置文件介绍

项目的配置文件是 _config.yml。该文件包含了网站的基本配置信息，例如：

# 网站基本配置
title: Rubber Duck Debugging
description: 向 Rubber Duck Debugging 方法致敬的网站
url: https://rubberduckdebugging.com
baseurl: ""

# 其他配置
paginate: 5
paginate_path: "page:num"

在 _config.yml 文件中，可以配置网站标题、描述、URL、基本路径、分页设置等。这些配置会影响到整个网站的结构和显示效果。