为斯芬克斯整理.rst文件？

Question

我正在用斯芬克斯整理一些用户指南。但是，有很多.rst文件，当它们和index.rst一起都在主文件夹中时，很难跟踪它们。在

我想把它们整理成这样的文件夹。但是，make html命令会导致警告，说它无法找到文件夹中所有的.rst文件。在

如何组织.rst文件？在

index.rst
  Docs
     new_starter.rst
     subject_guides.rst
  New starter
     first_week.rst
     second_week.rst
  Subject guides
     stress.rst
     aerodynamics.rst
     data_science.rst

Answer 1

这在Sphinx文档部分TOC Tree中提到。在

在index.rst中，使用toctree指令：

Project Awesome
===============

Welcome to the Project Awesome docs.

.. toctree::
   :glob:
   :maxdepth: 2

   docs/*
   new_starter/*
   subject_guides/*

上面使用的是“globbing”，但是您可以使用文件名而不是globbing显式地对文件进行排序。在