问题描述
我正在使用swagger/swashbuckle为Web Api 2中实现的api生成文档.
I'm generating documentation for an api implemented in Web Api 2 using swagger/swashbuckle.
识别的唯一xml文档标签是<summary>
,<remarks>
和<param>
.
这意味着我不能使用<para>
标记在新行或段落中设置文本格式,所有内容都将在文档的实施注释"条目中生成为连续的长段落.
The only xml documentation tags recognized are the <summary>
, <remarks>
and <param>
.
This means I cannot use <para>
tag to format my text in new lines or paragraphs, everything is generated as a continuous long paragraph in the Implementation Notes entry of the docs.
有什么办法吗?
推荐答案
另一种实现方法是创建自定义OperationFilter并使用xml文档标签,如
Another way to achieve is creating a custom OperationFilter and use the xml documentation tags as explained in :
https://github.com/domaindrivendev/Swashbuckle/issues/258
希望这会有所帮助
山姆
这篇关于如何在Swashbuckle文档中添加换行符?的文章就介绍到这了,希望我们推荐的答案对大家有所帮助,也希望大家多多支持!