0

我正在使用 Natural Docs 从我的 Python 代码生成文档，我的 Python 注释是这样的：

Function: get_students



Parameters:
since_data: 

Returns:
res: 

{'count': 

'info': [
'mobile': '15011111111',
'nickname': 'xiaoya',
'gender': 0(unknow) or 1(male) or 2(female),
'level': 0-12,
'register_at': '2013-01-01 08:08:08',
]
}

"""

我的 config.txt 是这样的：

Language: Python

Extension: py
Shebang String: python
Line Comment: #
Block Comment: """ """
Function Prototype Ender: :
Variable Prototype Ender: =
Line Extender: /

当我得到生成的html时，返回值没有换行符，我只能得到这样的换行符：

Returns:
res: 

{'count': \n

'info': [

'mobile': '15011111111',

'nickname': 'xiaoya',

'gender': 0(unknow) or 1(male) or 2(female),
'level': 0-12,
'register_at': '2013-01-01 08:08:08',
]
}

我必须在每行之间添加一个空行以获得换行符。我可以尝试什么来解决这个问题？

4

1 回答 1

0

源代码中的换行符不会转换为输出中的换行符，以便您可以在多行上编写单个文本段落；无需滚动或使用文本编辑器的自动换行功能。Web 浏览器也以这种方式呈现 HTML 中的文本段落。

看来您希望文档中有一个预先格式化的部分，在您编写它们时带有换行符。我在Returns部分中封装了您的示例的行(start code)and将处理它：(end)

Returns:
res: 

(start code)
{'count': 

'info': [
'mobile': '15011111111',
'nickname': 'xiaoya',
'gender': 0(unknow) or 1(male) or 2(female),
'level': 0-12,
'register_at': '2013-01-01 08:08:08',
]
}
(end)

或者，您可以为示例的每一行添加前缀，>但这会更有效。查看Natural Docs 注释格式中的代码和文本图部分以获取更多信息。

于 2013-05-30T07:00:10.540 回答