【亲测免费】 TUNA 镜像站主页项目教程

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

TUNA 镜像站主页项目的目录结构如下：

mirror-web/
├── _data/
├── _includes/
├── _layouts/
├── _node_module_patch/
├── _plugins/
├── _src/
├── fancy-index/
├── geninfo/
├── help/
├── news/
├── static/
├── .editorconfig
├── .gitignore
├── .gitmodules
├── 404.html
├── Dockerfile.build
├── Gemfile
├── Gemfile.lock
├── LICENSE
├── README.md
├── _config.yml
├── _vite.config.mjs
├── feed.xml
├── gen_robot.sh
├── help.html
├── index.html
├── legacy_index.html
├── news.html
├── package-lock.json
├── package.json
└── status.html

目录介绍

• _data/: 包含 Jekyll 数据文件，主要包括各个镜像的简要描述和部分特殊镜像的配置。
• _includes/: 包含 Jekyll 的 include 文件，用于在页面中插入公共代码片段。
• _layouts/: 包含 Jekyll 的布局文件，定义了页面的基本结构。
• _node_module_patch/: 包含 Node.js 模块的补丁文件。
• _plugins/: 包含 Jekyll 插件文件。
• _src/: 包含前端代码，使用 Vue、TypeScript、Vite 等前端框架开发。
• fancy-index/: 包含 NGINX fancy-index 模块的配置文件。
• geninfo/: 包含生成直接下载链接的配置文件。
• help/: 包含帮助文档。
• news/: 包含新闻文档。
• static/: 包含静态文件，如 JSON 数据文件。
• .editorconfig: 编辑器配置文件。
• .gitignore: Git 忽略文件配置。
• .gitmodules: Git 子模块配置。
• 404.html: 404 错误页面。
• Dockerfile.build: Docker 构建文件。
• Gemfile: Ruby 依赖管理文件。
• Gemfile.lock: Ruby 依赖锁定文件。
• LICENSE: 项目许可证文件。
• README.md: 项目说明文件。
• _config.yml: Jekyll 配置文件，包括站点名称、描述、链接等。
• _vite.config.mjs: Vite 配置文件。
• feed.xml: RSS 订阅文件。
• gen_robot.sh: 生成 robots.txt 文件的脚本。
• help.html: 帮助页面。
• index.html: 主页。
• legacy_index.html: 旧版主页。
• news.html: 新闻页面。
• package-lock.json: Node.js 依赖锁定文件。
• package.json: Node.js 项目配置文件。
• status.html: 状态页面。

2. 项目的启动文件介绍

项目的启动文件主要包括以下几个：

• index.html: 主页文件，是项目的入口文件。
• Dockerfile.build: Docker 构建文件，用于在生产环境中部署项目。
• gen_robot.sh: 生成 robots.txt 文件的脚本，用于搜索引擎优化。

3. 项目的配置文件介绍

项目的配置文件主要包括以下几个：

• _config.yml: Jekyll 配置文件，包括站点名称、描述、链接等。请不要轻易改动构建配置。
• _data/options.yml: Jekyll 数据文件，主要包括各个镜像的简要描述和部分特殊镜像的配置。请仿照已有的配置进行修改。
• geninfo/genisolist.ini: 生成直接下载链接的配置文件，具体内容修改请提交到 mirrorz-org/genisolist。
• _vite.config.mjs: Vite 配置文件，用于前端代码的编译和构建。

这些配置文件是项目运行的关键，修改时请务必谨慎，并遵循项目文档中的指导。