Documentation 是什么导致斯芬克斯输出'；警告：意外缩进'；？

我想知道为什么当我运行

make htmldocs

时，下面的重构文本文件在第2行抛出警告“意外缩进”。有关如何获取有关此警告的详细日志的信息将非常有用

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

What:       /sys/firmware/sgi_uv/
Date:       September 2020
Contact:    Justin Ernst <justin.ernst@hpe.com>
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....

什么：/sys/firmware/sgi\u uv/
日期：2020年9月
联系人：贾斯汀·恩斯特
说明：
/sys/firmware/sgi_uv目录包含信息
关于UV平台。
该目录下有许多只读属性：
拱形
轮毂式
无丈夫
分区id
一致性
紫外线型
archtype条目包含以下UV体系结构类型。。。。

下面的文档不会抛出任何警告，尽管我无法区分这两种格式之间的任何差异：

What:       /sys/firmware/sfi/tables/
Date:       May 2010
Contact:    Len Brown <lenb@kernel.org>
Description:
        SFI defines a number of small static memory tables

What:/sys/firmware/sfi/tables/
日期：2010年5月
联系人：Len Brown
说明：
SFI定义了许多小型静态内存表

干杯，

---

米兰

您的语法不正确。我认为您希望使用字段列表，或者可能使用定义列表，这取决于您是否希望结果在呈现时对读者可见。试穿一下

：什么：/sys/firmware/sgi\u uv/
：日期：2020年9月
：联系人：Justin Ernst
：Description:/sys/firmware/sgi_uv目录包含信息
关于UV平台。
该目录下有许多只读属性：
拱形
轮毂式
无丈夫
分区id
一致性
紫外线型
archtype条目包含以下UV体系结构类型。。。。

什么：
/系统/固件/sgi_uv/
日期：
2020年9月
联系人：
贾斯汀·恩斯特
说明：
/sys/firmware/sgi_uv目录包含信息
关于UV平台。
该目录下有许多只读属性：
拱形
轮毂式
无丈夫
分区id
一致性
紫外线型
archtype条目包含以下UV体系结构类型。。。。

您的语法不正确。我认为您希望使用字段列表，或者可能使用定义列表，这取决于您是否希望结果在呈现时对读者可见。试穿一下

：什么：/sys/firmware/sgi\u uv/
：日期：2020年9月
：联系人：Justin Ernst
：Description:/sys/firmware/sgi_uv目录包含信息
关于UV平台。
该目录下有许多只读属性：
拱形
轮毂式
无丈夫
分区id
一致性
紫外线型
archtype条目包含以下UV体系结构类型。。。。

什么：
/系统/固件/sgi_uv/
日期：
2020年9月
联系人：
贾斯汀·恩斯特
说明：
/sys/firmware/sgi_uv目录包含信息
关于UV平台。
该目录下有许多只读属性：
拱形
轮毂式
无丈夫
分区id
一致性
紫外线型
archtype条目包含以下UV体系结构类型。。。。

我建议在问题中添加一些更具体的标签。只有堆栈上溢出，并且没有

pythonsphinx

标记。但大多数都是关于Sphinx搜索引擎的，而不是关于Sphinx文档生成器的。通常可以通过make调用，但是没有对

htmldocs

builder的引用。“意外缩进”通常意味着缺少一个空行。我得到的是RST代码段第5行的警告，而不是第2行。谢谢这两行，@mzjn我只是觉得奇怪，因为某种原因，两个格式完全相同的文档会抛出不同的警告。@MilanLakhani我不明白这个示例到底应该是什么？它是重构的文本文件吗？如果这只是正常的reST，那么您有一些段落和块引号（在这种情况下没有太多适用的规则），但问题并没有澄清确切的输入格式是什么，我个人没有

htmldoc

来尝试生成输出。如果您编辑问题以添加更多上下文，那将很有趣。@MilanLakhani我认为这是因为您正在使用Sphinx处理内核类型的文档。make文件调用了

sphinx build

，显然

htmldoc

与标准的

html

（我希望看到确切的makefile行）。显然，你的文件丢失的第一件东西是一个。该文件是否包含在reST文档的其他位置（按名称）中（将其放在更大的上下文中）？我建议在该问题中添加一些更具体的标记。只有堆栈上溢出，并且没有

pythonsphinx

标记。但大多数都是关于Sphinx搜索引擎的，而不是关于Sphinx文档生成器的。通常可以通过make调用，但是没有对

htmldocs

builder的引用。“意外缩进”通常意味着缺少一个空行。我得到的是RST代码段第5行的警告，而不是第2行。谢谢这两行，@mzjn我只是觉得奇怪，因为某种原因，两个格式完全相同的文档会抛出不同的警告。@MilanLakhani我不明白这个示例到底应该是什么？它是重构的文本文件吗？如果这只是正常的reST，那么您有一些段落和块引号（在这种情况下没有太多适用的规则），但问题并没有澄清确切的输入格式是什么，我个人没有

htmldoc

来尝试生成输出。如果您编辑问题以添加更多上下文，那将非常有趣。@M

:What:       /sys/firmware/sgi_uv/
:Date:       September 2020
:Contact:    Justin Ernst <justin.ernst@hpe.com>
: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 <justin.ernst@hpe.com>

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....