Rust语言教程：按照与使用指南

Rust语言教程：按照与使用指南

rusty-bookA curated list of recipes and repos that can be used to build your rusty projects. Rusty Book = Cookbook + Awesome Rust！项目地址:https://gitcode.com/gh_mirrors/ru/rusty-book

本教程将引导您了解rustlang-cn/rusty-book项目的结构和基本使用方法，这是一份中文版的Rust编程语言学习资源。

1. 项目目录结构及介绍

.
├── assets             # 存放辅助资源，如图片和样式文件
├── book                # 主体书籍内容源文件，以.md结尾的Markdown文件
│   ├── basics          # 基础知识部分
│   ├── concurrency     # 并发编程部分
│   └── ...
├── config.toml         # 项目配置文件
├── deploy              # 部署相关脚本和配置
└── src                 # 可能包含一些示例代码或者工具脚本
    └── theme           # 书籍主题样式

• assets: 包含书籍展示所需的各种静态资源。
• book: 教程内容的主要目录，细分章节存放各个主题的Markdown文件。
• config.toml: 项目配置文件，用来设定构建和部署的参数。
• deploy: 部署相关脚本，用于将书籍内容发布至目标平台。
• src: 项目源码，可能包括主题样式或其他辅助脚本。
• src/theme: 书籍的主题样式模板，影响最终呈现效果。

2. 项目的启动文件介绍

该项目没有传统的单一入口启动文件，因为这是一个静态站点生成器。主要通过命令行工具运行构建过程。通常使用mdbook工具来编译Markdown源文件为HTML网页：

$ cargo install mdbook       # 如果未安装mdbook，先进行安装
$ cd rusty-book
$ mdbook build               # 构建书籍

这将在根目录下创建一个book子目录，其中包含编译后的HTML页面。

3. 项目的配置文件介绍

config.toml是项目的核心配置文件，它定义了构建和显示时的多种选项。例如：

[book]
title = "Rust编程语言中文版"
author = "rustlang-cn"

[build]
src = "book/"
dest = "./book"
html_extra_path = ["assets"]

• [book]部分包含了书籍的基本信息，如标题和作者。
• [build]部分指定源文件路径（src）和生成的目标目录（dest），以及额外的HTML资源路径（html_extra_path）。

您可以根据需求修改这个配置文件，比如添加自定义CSS样式或调整其他设置。

要查看完整的配置选项列表和其他高级功能，可以参考mdbook的官方文档：https://mdbook.github.io/config.html。

通过以上步骤，您应该能够成功地搭建并理解rustlang-cn/rusty-book项目。祝您在学习Rust的路上一切顺利！

rusty-bookA curated list of recipes and repos that can be used to build your rusty projects. Rusty Book = Cookbook + Awesome Rust！项目地址:https://gitcode.com/gh_mirrors/ru/rusty-book