《动手学深度学习》PyTorch版本项目教程

《动手学深度学习》PyTorch版本项目教程

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

本项目将《动手学深度学习》原书中的MXNet代码实现改为PyTorch实现。项目的目录结构如下：

• code/: 包含每章相关的Jupyter Notebook代码，基于PyTorch实现。
• data/: 存放项目所需的数据文件。
• docs/: 包含《动手学深度学习》书中的相关内容，以markdown格式存储，可以使用docsify工具本地预览。
• .gitignore: 定义了Git忽略的文件和目录。
• Dockerfile: 用于构建Docker镜像，以便在容器中运行项目。
• LICENSE: 项目的Apache-2.0许可证文件。
• README.md: 项目的说明文件，介绍了项目的相关信息和使用方法。

2. 项目的启动文件介绍

项目的启动主要依赖于docsify工具，用于将docs/目录中的markdown文件转换成网页格式。以下是在本地启动项目的基本步骤：

1. 安装docsify-cli工具：

   npm i docsify-cli -g
   

2. 克隆项目到本地：

   git clone https://github.com/ShusenTang/Dive-into-DL-PyTorch.git
   cd Dive-into-DL-PyTorch
   

3. 运行本地服务器：

   docsify serve docs
   

执行以上命令后，可以通过浏览器访问http://localhost:3000来查看文档。

3. 项目的配置文件介绍

本项目使用docsify作为文档工具，相关的配置主要通过docsify的配置文件进行，通常位于docs/目录下的.nojekyll文件中。以下是一些基本配置：

• base: 设置网站的根路径。
• name: 设置网站的名字。
• repo: 设置GitHub仓库链接，会在页面右上角显示。
• loadSidebar: 自动从_sidebar.md文件加载侧边栏。
• subMaxLevel: 设置侧边栏目录的最大层级。

这些配置可以根据用户的需求进行修改，以适应不同的展示效果和风格。