al-folio 项目使用教程

1. 项目目录结构及介绍

al-folio 是一个基于 Jekyll 的主题，适用于学术网站。以下是项目的目录结构及其介绍：

al-folio/
├── _bibliography/       # BibTeX 文件，用于存储出版物信息
├── _data/               # 数据文件，如 CV 信息
├── _includes/           # 包含页面的部分内容
├── _layouts/            # 页面布局模板
├── _news/               # 新闻或公告的 Markdown 文件
├── _pages/              # 网站页面的 Markdown 文件
├── _plugins/            # Jekyll 插件
├── _posts/              # 博客文章的 Markdown 文件
├── _projects/           # 项目页面的 Markdown 文件
├── _sass/               # 样式表文件
├── assets/              # 静态资源文件，如图片、PDF 等
├── bin/                 # 脚本文件，如部署脚本
├── lighthouse_results/  # Lighthouse 测试结果
├── readme_preview/      # README 预览文件
├── .all-contributorsrc  # 贡献者配置文件
├── .dockerignore        # Docker 忽略文件
├── .git-blame-ignore-revs # Git 忽略的提交记录
├── .gitignore           # Git 忽略文件
├── .pre-commit-config.yaml # pre-commit 配置文件
├── .prettierignore      # Prettier 忽略文件
├── .prettierrc          # Prettier 配置文件
├── CONTRIBUTING.md      # 贡献指南
├── CUSTOMIZE.md         # 自定义指南
├── Dockerfile           # Docker 配置文件
├── FAQ.md               # 常见问题解答
├── Gemfile              # Ruby 依赖文件
├── Gemfile.lock         # Ruby 依赖锁定文件
├── INSTALL.md           # 安装指南
├── LICENSE              # 许可证文件
├── README.md            # 项目介绍文件
├── _config.yml          # Jekyll 配置文件
├── docker-compose-slim.yml # Docker Compose 配置文件（精简版）
├── docker-compose.yml   # Docker Compose 配置文件
├── package-lock.json    # npm 依赖锁定文件
├── package.json         # npm 依赖文件
├── purgecss.config.js   # PurgeCSS 配置文件
├── requirements.txt     # 依赖文件
├── robots.txt           # 搜索引擎爬虫配置文件

2. 项目启动文件介绍

al-folio 项目的启动文件主要包括以下几个部分：

• Gemfile 和 Gemfile.lock: 这两个文件用于管理 Ruby 依赖。Gemfile 列出了项目所需的 Ruby 包，Gemfile.lock 则锁定了这些包的版本。

• _config.yml: 这是 Jekyll 的主要配置文件，包含了网站的各种设置，如标题、描述、导航菜单、插件配置等。

• Dockerfile 和 docker-compose.yml: 这两个文件用于配置 Docker 环境，方便在不同平台上运行项目。

• bin/deploy: 这是一个部署脚本，用于将网站部署到 GitHub Pages 或其他服务器。

3. 项目的配置文件介绍

_config.yml

_config.yml 是 Jekyll 的主要配置文件，包含了网站的各种设置。以下是一些关键配置项的介绍：

• title: 网站的标题。
• email: 联系邮箱。
• description: 网站的描述。
• baseurl: 网站的基本 URL，通常用于 GitHub Pages。
• url: 网站的完整 URL。
• twitter_username: Twitter 用户名。
• github_username: GitHub 用户名。
• show_excerpts: 是否在首页显示文章摘要。
• collections: 自定义集合，如新闻、项目等。
• plugins: 使用的 Jekyll 插件。

Gemfile

Gemfile 列出了项目所需的 Ruby 包，以下是一些常见的包：

• jekyll: Jekyll 核心包。
• jekyll-feed: 生成 RSS 订阅。
• jekyll-seo-tag: 添加 SEO 标签。
• jekyll-sitemap: 生成网站地图。

package.json

package.json 列出了项目所需的 npm 包，以下是一些常见的包：

• bootstrap: 前端框架。
• jquery: JavaScript 库。
• popper.js: 用于弹出框和工具提示。

通过以上配置文件，你可以轻松地定制和扩展 al-folio 项目，以满足你的学术网站需求。