相关疑难解决方法(0)

如何格式化Swagger 2.0文本描述?

我想格式化我的Swagger API描述,以便它们不是简单的文本段落.最好,我想为它添加一个小桌子.

我没有在Swagger描述中找到有关文本格式的在线参考.如果我启动Swagger编辑器,并打开Instagram示例(File\Open Example\Instagram.yaml),我看到yaml文件中的第一个描述显示了一些格式,包括超链接和边界框:

    [registered your client](http://instagram.com/developer/register/) it's easy
to start requesting data from Instagram.

```
  https://api.instagram.com/v1/media/popular?client_id=CLIENT-ID
```
Run Code Online (Sandbox Code Playgroud)

这看起来像标准的Markdown,但是当我在样本描述中添加表markdown时,编辑器会出现错误:

|Col1|Col2|
|------|------|
|1|2|


YAML Syntax Error
End of the stream or a document separator is expected at line 36, column
Run Code Online (Sandbox Code Playgroud)

Swagger 2.0允许什么格式化?我做错了呈现一张桌子吗?

rest markdown swagger swagger-2.0 swagger-editor

33
推荐指数
1
解决办法
4万
查看次数

如何在Swashbuckle中替换Swagger UI标题徽标

我正在使用Swashbuckle包用于WebAPI,我正在尝试自定义swagger ui默认页面的外观.我想自定义默认的swagger徽标/标题.我在SwaggerConfig中添加了以下内容

.EnableSwaggerUi(c =>
 {
  c.InjectJavaScript(thisAssembly, 
    typeof(SwaggerConfig).Namespace + ".SwaggerExtensions.custom-js.js");
  }
Run Code Online (Sandbox Code Playgroud)

custom-js.js的内容如下:

$("#logo").replaceWith("<span id=\"test\">test</span>");
Run Code Online (Sandbox Code Playgroud)

这在很大程度上起作用,但是视觉有点刺耳,因为默认的招摇标题在页面加载时是可见的,并且在短暂的延迟之后,jquery下面踢,并且#logo元素的内容被更新

有没有办法避免这种情况,以便jquery作为初始加载/渲染的一部分启动,它看起来无缝?

asp.net-web-api swagger-ui swashbuckle

9
推荐指数
5
解决办法
8220
查看次数