Python 我的笔记的斯芬克斯来源的位置-警告:文档isn';不包括在任何目录树中
如何修复底部的狮身人面像警告? 我正在尝试用Sphinx编写Python笔记。 我的笔记与index.rst在同一目录级别的不同文件中 在构建HTML后,我收到以下警告 警告Python 我的笔记的斯芬克斯来源的位置-警告:文档isn';不包括在任何目录树中,python,python-sphinx,glob,toctree,Python,Python Sphinx,Glob,Toctree,如何修复底部的狮身人面像警告? 我正在尝试用Sphinx编写Python笔记。 我的笔记与index.rst在同一目录级别的不同文件中 在构建HTML后,我收到以下警告 警告 /home/heo/S_codes/trig_functions.rst:: WARNING: document isn't included in any toctree sudo sphinx-build -b html ./ _build/html Running Sphinx v0.6.2 loading pic
/home/heo/S_codes/trig_functions.rst:: WARNING: document isn't included in any toctree
sudo sphinx-build -b html ./ _build/html
Running Sphinx v0.6.2
loading pickled environment... done
building [html]: targets for 0 source files that are out of date
updating environment: 1 added, 2 changed, 0 removed
reading sources... [100%] trig_functions
/home/heo/S_codes/databooklet.rst:1: (WARNING/2) malformed hyperlink target.
/home/heo/S_codes/index.rst:11: (ERROR/3) Error in "toctree" directive:
invalid option block.
.. toctree::
:numbered:
:glob:
*
databooklet.rst
trig_functions.rst
/home/heo/S_codes/trig_functions.rst:11: (ERROR/3) Unexpected indentation.
looking for now-outdated files... none found
pickling environment... done
checking consistency... /home/heo/S_codes/databooklet.rst:: WARNING: document isn't included in any toctree
/home/heo/S_codes/trig_functions.rst:: WARNING: document isn't included in any toctree
done
preparing documents... done
writing output... [100%] trig_functions
writing additional files... genindex search
copying static files... done
dumping search index... done
dumping object inventory... done
build succeeded, 6 warnings.
在
构建时的完整消息
/home/heo/S_codes/trig_functions.rst:: WARNING: document isn't included in any toctree
sudo sphinx-build -b html ./ _build/html
Running Sphinx v0.6.2
loading pickled environment... done
building [html]: targets for 0 source files that are out of date
updating environment: 1 added, 2 changed, 0 removed
reading sources... [100%] trig_functions
/home/heo/S_codes/databooklet.rst:1: (WARNING/2) malformed hyperlink target.
/home/heo/S_codes/index.rst:11: (ERROR/3) Error in "toctree" directive:
invalid option block.
.. toctree::
:numbered:
:glob:
*
databooklet.rst
trig_functions.rst
/home/heo/S_codes/trig_functions.rst:11: (ERROR/3) Unexpected indentation.
looking for now-outdated files... none found
pickling environment... done
checking consistency... /home/heo/S_codes/databooklet.rst:: WARNING: document isn't included in any toctree
/home/heo/S_codes/trig_functions.rst:: WARNING: document isn't included in any toctree
done
preparing documents... done
writing output... [100%] trig_functions
writing additional files... genindex search
copying static files... done
dumping search index... done
dumping object inventory... done
build succeeded, 6 warnings.
你知道斯芬克斯的文件吗 具体地说,请阅读
toctree
指令:
您可以拥有任意数量的文件。通过目录树
可以从多个部分创建单个文档
请仔细阅读以下内容: 因为reST源文件可以 不同的扩展(有些人喜欢 .txt,有些类似.rst–扩展名 可以使用源(U后缀)进行配置 不同的操作系统有不同的路径 分隔符,斯芬克斯抽象了它们:全部 “文档名称”是相对于 源目录,扩展名为 剥离,路径分隔符 转换成斜杠。所有价值观, 参数等类似于引用 “文件”是指此类文件 名字 文档名称的示例有
索引
,
库/zipfile
,或
参考/数据模型/类型
。注意
没有前导斜杠
由于您使用*
进行全局搜索,因此不需要列出您的文件
如果您想列出您的文件,请实际阅读并遵循上述规则