我正在使用Python3.7.2在Windows 10中的Eclipse Photon下运行Sphinx 1.8.2。我在让Sphinx接受我的节标题结构时遇到问题。请考虑以下文本源:
***********************
Development Environment
***********************
Computer Support
================
The following tools are used to support the computer environment.
Assessment and Deployment
-------------------------
This is a collection of tools supplied by Microsoft which support unattended installation of Windows.
SIM
^^^
Used to create an unattended.xml file that supplies the answers to questions posed during Windows during install.
HP Support Assistant
--------------------
Personal
========
LibreOffice
-----------
Adobe Creative Cloud - Photography Plan
---------------------------------------
Development Support
===================
Java
-----
Eclipse
-------
Pydev
^^^^^
Regex
"""""
Requests
""""""""
Sphinx
""""""
Sphinx ReadThe Docs Theme
"""""""""""""""""""""""""
Liclipse Text Editor
^^^^^^^^^^^^^^^^^^^^
Notepad++
这会产生以下错误:
Running Sphinx v1.8.2
loading pickled environment... done
building [mo]: targets for 0 po files that are out of date
building [html]: targets for 1 source files that are out of date
updating environment: [] 0 added, 1 changed, 0 removed
reading sources... [100%] DevEnvironment
D:\Shared\WiseOldbird\Projects\Platform IndependentApplicationController\docs\source\DevEnvironment.rst:11: WARNING: Unexpected section title.
Assessment and Deployment
-------------------------
looking for now-outdated files... none found
pickling environment... D:\Shared\WiseOldbird\Projects\Platform IndependentApplicationController\docs\source\DevEnvironment.rst:16: WARNING: Unexpected section title.
SIM
^^^
D:\Shared\WiseOldbird\Projects\Platform IndependentApplicationController\docs\source\DevEnvironment.rst:21: WARNING: Unexpected section title.
HP Support Assistant
--------------------
D:\Shared\WiseOldbird\Projects\Platform IndependentApplicationController\docs\source\DevEnvironment.rst:24: WARNING: Unexpected section title.
Personal
========
D:\Shared\WiseOldbird\Projects\Platform IndependentApplicationController\docs\source\DevEnvironment.rst:27: WARNING: Unexpected section title.
LibreOffice
-----------
D:\Shared\WiseOldbird\Projects\Platform IndependentApplicationController\docs\source\DevEnvironment.rst:30: WARNING: Unexpected section title.
Adobe Creative Cloud - Photography Plan
---------------------------------------
done
checking consistency... done
preparing documents... done
writing output... [ 50%] DevEnvironment
writing output... [100%] index
generating indices... genindex
writing additional pages... search
copying static files... done
copying extra files... done
dumping search index in English (code: en) ... done
dumping object inventory... done
build succeeded, 6 warnings.
The HTML pages are in build.
,并在Google Chrome中将其呈现为HTML,如下所示:
要让Sphinx接受我的标题结构我需要做什么?
答案 0 :(得分:1)
不要缩进行。这应该起作用。
***********************
Development Environment
***********************
Computer Support
================
The following tools are used to support the computer environment.
Assessment and Deployment
-------------------------
This is a collection of tools supplied by Microsoft which support unattended installation of Windows.
SIM
^^^
Used to create an unattended.xml file that supplies the answers to questions posed during Windows during install.
HP Support Assistant
--------------------
Personal
========
LibreOffice
-----------
Adobe Creative Cloud - Photography Plan
---------------------------------------
Development Support
===================
Java
-----
Eclipse
-------
Pydev
^^^^^
Regex
"""""
Requests
""""""""
Sphinx
""""""
Sphinx ReadThe Docs Theme
"""""""""""""""""""""""""
Liclipse Text Editor
^^^^^^^^^^^^^^^^^^^^
Notepad++