如何在使用SPHINX生成Python文档时保留换行符

2022-04-20 00:00:00 python python-sphinx

问题描述

我正在使用Sphinx为一个python项目生成文档。 输出的html不会保留文档字符串中出现的换行符。 示例:

代码

def testMethod(arg1,arg2):
    """
    This is a test method

    Arguments:
    arg1: arg1 description
    arg2: arg2 description

    Returns:
    None
    """
    print "I am a test method"

Sphinx O/P:

TestModule.testMethod(arg1, arg2)

This is a test method

Arguments: arg1: arg1 description arg2: arg2 description

Returns: None

您知道如何修复它吗?


解决方案

通常在重构文本中使用

| Vertical bars
| like this

保留换行符

相关文章