《Rust Book》巴西葡萄牙版项目启动与配置教程

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

《Rust Book》巴西葡萄牙版项目的目录结构如下所示：

rust-book-pt-br/
├── .github/
│   └── workflows/
│       └── ci.yml
├── .gitignore
├── assets/
│   └── images/
├── src/
│   ├── chapters/
│   │   ├── 01-introducao.md
│   │   ├── 02-instalacao.md
│   │   └── ... (其他章节文件)
│   └── index.md
├── resources/
├── book/
│   └── SUMMARY.md
├── Makefile
└── README.md

以下是各个目录和文件的简要介绍：

• .github/: 存放GitHub Actions的工作流文件，用于自动化项目的构建和测试等流程。
• .gitignore: 定义哪些文件和目录应该被Git忽略。
• assets/: 存放项目中的静态资源，如图片等。
• src/: 存放书籍的源文件，每个章节为一个Markdown文件。
• resources/: 存放其他相关资源，例如样式表或脚本文件。
• book/: 包含书籍的概述文件SUMMARY.md，该文件定义了书籍的目录结构。
• Makefile: 用于构建和生成书籍的Makefile文件。
• README.md: 项目的基本介绍和说明。

2. 项目的启动文件介绍

项目的启动文件是位于src/目录下的index.md。这是书籍的入口文件，通常包含书籍的简介、目录和起始阅读的指引。以下是index.md文件的基本内容示例：

# Rust Book (Português)

## 简介

Rust是一种系统编程语言，它专为安全、并发和实用性而设计。本书旨在提供Rust语言的全面介绍和指南。

## 目录

1. [Introdução](chapters/01-introducao.md)
2. [Instalação](chapters/02-instalacao.md)
3. ... (其他章节链接)

开始你的Rust学习之旅吧！

3. 项目的配置文件介绍

项目的配置文件主要是book/SUMMARY.md，它定义了书籍的目录结构，决定了书籍在生成时的章节顺序。以下是SUMMARY.md文件的基本内容示例：

# Table of Contents

* [Introdução](src/chapters/01-introducao.md)
* [Instalação](src/chapters/02-instalacao.md)
* ... (其他章节标题和链接)

在Makefile或其他构建脚本中，会引用SUMMARY.md来生成书籍的HTML或其他格式文档。通过编辑这个文件，可以调整书籍的章节结构和内容顺序。