Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Theme with attributes rendering #299

Open
wants to merge 12 commits into
base: olio-theme
Choose a base branch
from
Open

Theme with attributes rendering #299

Changes from all commits
Commits
Show all changes
12 commits
Select commit Hold shift + click to select a range
35d9027
Full width
bniwredyc Feb 12, 2016
48db836
Fix
bniwredyc Feb 12, 2016
3f1dd6e
No schema, request expanded by default
bniwredyc Feb 14, 2016
cba54a6
Version bump
bniwredyc Feb 14, 2016
6c6147f
npm build in postinstall
bniwredyc Feb 25, 2016
76c9030
coffeelint in dependencies
bniwredyc Feb 25, 2016
11e311b
Attributes rendering
bniwredyc Mar 21, 2016
655991b
Version bump
bniwredyc Mar 21, 2016
a69a5b1
Constraints, v1.6.7
bniwredyc Mar 22, 2016
7d63edf
Merge remote-tracking branch 'danielgtaylor/olio-theme'
bniwredyc Oct 8, 2016
1c20fa3
https://github.com/danielgtaylor/aglio/pull/299 comments
bniwredyc Mar 17, 2017
b106565
Merge branch 'master' of github.com:bniwredyc/aglio-theme-kaiten
bniwredyc Mar 17, 2017
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
177 changes: 102 additions & 75 deletions templates/mixins.jade
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,3 @@

mixin Badge(method)
//- Draw a badge for a given HTTP method
case method
Expand Down Expand Up @@ -26,37 +25,37 @@ mixin Nav()
if self.api.navItems && self.api.navItems.length
.resource-group
.heading
.chevron
i.open.fa.fa-angle-down
a(href='#top') Overview
.chevron
i.open.fa.fa-angle-down
a(href='#top') Overview
.collapse-content
ul: each item in self.api.navItems
li
a(href=item[1])!= item[0]
ul: each item in self.api.navItems
li
a(href=item[1])!= item[0]
each resourceGroup in self.api.resourceGroups || []
.resource-group
.heading
.chevron
i.open.fa.fa-angle-down
a(href=resourceGroup.elementLink)!= resourceGroup.name || 'Resource Group'
.chevron
i.open.fa.fa-angle-down
a(href=resourceGroup.elementLink)!= resourceGroup.name || 'Resource Group'
.collapse-content
ul
each item in resourceGroup.navItems || []
li
a(href=item[1])!= item[0]
each resource in resourceGroup.resources || []
li
if !self.condenseNav || (resource.actions.length != 1)
a(href=resource.elementLink)!= resource.name || 'Resource'
ul: each action in resource.actions || []
li: a(href=action.elementLink)
+Badge(action.method)
!= action.name || action.method + ' ' + (action.attributes && action.attributes.uriTemplate || resource.uriTemplate)
else
- var action = resource.actions[0]
a(href=action.elementLink)
+Badge(action.method)
!= action.name || resource.name || action.method + ' ' + (action.attributes && action.attributes.uriTemplate || resource.uriTemplate)
ul
each item in resourceGroup.navItems || []
li
a(href=item[1])!= item[0]
each resource in resourceGroup.resources || []
li
if !self.condenseNav || (resource.actions.length != 1)
a(href=resource.elementLink)!= resource.name || 'Resource'
ul: each action in resource.actions || []
li: a(href=action.elementLink)
+Badge(action.method)
!= action.name || action.method + ' ' + (action.attributes && action.attributes.uriTemplate || resource.uriTemplate)
else
- var action = resource.actions[0]
a(href=action.elementLink)
+Badge(action.method)
!= action.name || resource.name || action.method + ' ' + (action.attributes && action.attributes.uriTemplate || resource.uriTemplate)
//- Link to the API hostname, e.g. api.yourcompany.com
each meta in self.api.metadata || {}
if meta.name == 'HOST'
Expand Down Expand Up @@ -99,7 +98,13 @@ mixin Parameters(params)
code= self.urldec(value.value)
= ' '

mixin RequestResponse(title, request, collapse)
mixin Constraints(name, schema)
each constraint in ['minLength', 'maxLength', 'pattern']
if schema.properties[name][constraint]
div #{constraint}: #{schema.properties[name][constraint]}


mixin RequestResponse(title, request, collapse, showSchema)
.title
strong
= title
Expand All @@ -110,9 +115,9 @@ mixin RequestResponse(title, request, collapse)
.collapse-button
span.close Hide
span.open Show
+RequestResponseBody(request, collapse)
+RequestResponseBody(request, collapse, false, showSchema)

mixin RequestResponseBody(request, collapse, showBlank)
mixin RequestResponseBody(request, collapse, showBlank, showSchema)
if request.hasContent || showBlank
div(class=collapse ? 'collapse-content' : ''): .inner
if request.description
Expand All @@ -124,26 +129,48 @@ mixin RequestResponseBody(request, collapse, showBlank)
each item, index in request.headers
!= self.highlight(item.name + ': ' + item.value, 'http')
if index < request.headers.length - 1
br
br
div(style="height: 1px;")
if request.body
h5 Body
pre: code
!= self.highlight(request.body, null, ['json', 'yaml', 'xml', 'javascript'])
div(style="height: 1px;")
if request.schema
h5 Schema
pre: code
!= self.highlight(request.schema, null, ['json', 'yaml', 'xml'])
div(style="height: 1px;")
if showSchema && request.schema
- var schema = JSON.parse(request.schema)
table(style="width: 100%;")
thead
tr
th Attribute name
th Type
th Required
th Description
th Constraints
each description, name in schema.properties || []
tr
td #{name}
td #{description.type}
td #{schema.required && schema.required.indexOf(name) >= 0 ? 'true' : ''}
td #{description.description}
td
+Constraints(name, schema)
div.title
.collapse-button
span.close Hide
span.open Show
span Schema
div.collapse-content: .inner
pre: code
!= self.highlight(request.schema, null, ['json', 'yaml', 'xml'])
div(style="height: 1px;")
if !request.hasContent
.description.text-muted This response has no content.
div(style="height: 1px;")

mixin Examples(resourceGroup, resource, action)
each example in action.examples
each request in example.requests
+RequestResponse('Request', request, true)
+RequestResponse('Request', request, false, true)
each response in example.responses
+RequestResponse('Response', response, true)

Expand Down Expand Up @@ -190,8 +217,8 @@ mixin Content()
span.method(class=action.methodLower)= action.method
| &nbsp;
span.uri
span.hostname= self.api.host
!= action.colorizedUriTemplate
span.hostname= self.api.host
!= action.colorizedUriTemplate

//- A list of sub-sections for parameters, requests
//- and responses.
Expand Down Expand Up @@ -238,43 +265,43 @@ mixin ContentTriple()
each action in resource.actions || []
if action.examples
.right
.definition
span.method(class=action.methodLower)= action.method
| &nbsp;
span.uri
span.hostname= self.api.host
!= action.colorizedUriTemplate
.tabs
if action.hasRequest
.example-names
span Requests
- var requestCount = 0
each example in action.examples
each request in example.requests
- requestCount++
span.tab-button= request.name || 'example ' + requestCount
each example in action.examples
each request in example.requests
.tab
+RequestResponseBody(request, false, true)
.tabs
.example-names
span Responses
each response in example.responses
span.tab-button= response.name
each response in example.responses
.tab
+RequestResponseBody(response, false, true)
else
each example in action.examples
.tabs
.example-names
span Responses
each response in example.responses
span.tab-button= response.name
each response in example.responses
.definition
span.method(class=action.methodLower)= action.method
| &nbsp;
span.uri
span.hostname= self.api.host
!= action.colorizedUriTemplate
.tabs
if action.hasRequest
.example-names
span Requests
- var requestCount = 0
each example in action.examples
each request in example.requests
- requestCount++
span.tab-button= request.name || 'example ' + requestCount
each example in action.examples
each request in example.requests
.tab
+RequestResponseBody(response, false, true)
+RequestResponseBody(request, false, true)
.tabs
.example-names
span Responses
each response in example.responses
span.tab-button= response.name
each response in example.responses
.tab
+RequestResponseBody(response, false, true)
else
each example in action.examples
.tabs
.example-names
span Responses
each response in example.responses
span.tab-button= response.name
each response in example.responses
.tab
+RequestResponseBody(response, false, true)
.middle
.action(class=action.methodLower, id=action.elementId)
h4.action-heading
Expand Down