节标题识别

时间:2019-01-01 16:39:59

标签: python-sphinx

我正在使用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接受我的标题结构我需要做什么?

1 个答案:

答案 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++