是什么导致狮身人面像输出"警告：意外缩进"？

Question

我想知道为什么，当我运行make htmldocs时，下面的reStructuredText文件在第2行抛出警告'意外缩进'。关于如何在此警告中获得更详细的日志的信息将对我有所帮助。

我试过从第1行末尾删除斜杠，在第2行上下添加空白行，并确保第1行和第2行之间的间距类型相同，但没有骰子。

What:       /sys/firmware/sgi_uv/
Date:       September 2020
Contact:    Justin Ernst <[e-mail]>
Description:
The /sys/firmware/sgi_uv directory contains information
about the UV platform.
Under that directory are a number of read-only attributes::
archtype
hub_type
hubless
partition_id
coherence_id
uv_type
The archtype entry contains the UV architecture type that....

下面的文档没有抛出任何警告，尽管我看不出两者的格式有什么不同:

What:       /sys/firmware/sfi/tables/
Date:       May 2010
Contact:    Len Brown <[e-mail]>
Description:
SFI defines a number of small static memory tables

欢呼,米兰

Answer 1

语法错误。我认为你想要使用字段列表，或者可能是定义列表，这取决于你是否希望结果在呈现时对读者可见。在https://livesphinx.herokuapp.com/上试试吧。

字段列表

:What:       /sys/firmware/sgi_uv/
:Date:       September 2020
:Contact:    Justin Ernst <[e-mail]>
:Description: The /sys/firmware/sgi_uv directory contains information
about the UV platform.
Under that directory are a number of read-only attributes:
archtype
hub_type
hubless
partition_id
coherence_id
uv_type
The archtype entry contains the UV architecture type that....

定义列表

What:
/sys/firmware/sgi_uv/
Date:
September 2020
Contact:
Justin Ernst <[e-mail]>
Description:
The /sys/firmware/sgi_uv directory contains information
about the UV platform.
Under that directory are a number of read-only attributes::
archtype
hub_type
hubless
partition_id
coherence_id
uv_type
The archtype entry contains the UV architecture type that....