wholetrans/docs-matrix-spec
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Break out non-JSON request/response content types as tables (#1756)

Browse source 
* Break out non-JSON request/response content types as tables

Currently we display this as a table like "image/png|image/jpeg" and description on a single line, but we're using a table. This breaks the join out to individual rows.

* changelog
This commit is contained in:
Travis Ralston 2024-03-21 14:45:07 -06:00 • committed by GitHub
parent 6700f5ddd1
commit eb22fac5dc
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
4 changed files with 18 additions and 14 deletions
Download patch file Download diff file Expand all files Collapse all files

17
layouts/partials/openapi/render-content-type.html
View file

@ -1,27 +1,30 @@
{{/*
Render a table showing content type and description, given:
Render a table showing content types and their descriptions, given
two arrays with equal length:
* `content_type`: the content type as a string
* `content_types`: the content type strings
* `description`: the description as a string
* `descriptions`: the description strings
*/}}
{{ $content_type := .content_type }}
{{ $description := .description}}
{{ $content_types := .content_types }}
{{ $descriptions := .descriptions}}
{{ if $content_type }}
{{ if (gt (len $content_types) 0) }}
<table class="content-type-table">
<thead>
<th class="col-name">Content-Type</th>
<th class="col-description">Description</th>
</thead>
{{ range $idx, $content_type := $content_types }}
<tr>
<td><code>{{ $content_type }}</code></td>
<td>{{ $description | markdownify -}}</td>
<td>{{ index $descriptions $idx | markdownify -}}</td>
</tr>
{{ end }}
</table>
{{ end }}

7
layouts/partials/openapi/render-request.html
View file

@ -53,12 +53,13 @@
{{/*
Show the content types and description.
*/}}
{{ $mimes := slice }}
{{ $mimes := slice }}
{{ $descriptions := slice }}
{{ range $mime, $body := $request_body.content }}
{{ $mimes = $mimes | append $mime }}
{{ $descriptions = $descriptions | append $request_body.description }}
{{ end }}
{{ $content_type := delimit $mimes "|"}}
{{ partial "openapi/render-content-type" (dict "content_type" $content_type "description" $request_body.description) }}
{{ partial "openapi/render-content-type" (dict "content_types" $mimes "descriptions" $descriptions) }}
{{ end }}
<h3>Request body example</h3>

7
layouts/partials/openapi/render-responses.html
View file

@ -109,13 +109,12 @@
Show the content types and description.
*/}}
{{ $mimes := slice }}
{{ $desc := "" }}
{{ $descriptions := slice }}
{{ range $mime, $body := $response.content }}
{{ $mimes = $mimes | append $mime }}
{{ $desc = $body.schema.description }}
{{ $descriptions = $descriptions | append $body.schema.description }}
{{ end }}
{{ $content_type := delimit $mimes "|"}}
{{ partial "openapi/render-content-type" (dict "content_type" $content_type "description" $desc) }}
{{ partial "openapi/render-content-type" (dict "content_types" $mimes "descriptions" $descriptions) }}
{{ end }}
{{ end }}
{{ end }}