harness-drone/template/amber/swagger.amber

77 lines
1.8 KiB
Text
Raw Normal View History

2015-10-06 17:19:43 +00:00
extends base
block append head
title API · Drone
block header
ol
li Documentation
ul.nav.nav-tabs
li.nav-item
2015-10-08 00:17:15 +00:00
a.nav-link[href="../setup/"] Install
2015-10-06 17:19:43 +00:00
li.nav-item
2015-10-08 00:17:15 +00:00
a.nav-link[href="../build/"] Builds
2015-10-06 17:19:43 +00:00
li.nav-item
2015-10-08 00:17:15 +00:00
a.nav-link[href="../plugin/"] Plugins
2015-10-25 22:18:16 +00:00
li.nav-item
a.nav-link[href="../cli/"] CLI
2015-10-06 17:19:43 +00:00
li.nav-item
a.nav-link.active[href="#"] API Reference
block content
div.container-fluid.docs.docs-api
a[name="top"]
div.row
ul.toc
each $tag in Swagger.Tags
li
2015-10-06 17:19:43 +00:00
h2 #{$tag.Name}
ul
each $op in $tag.Ops
li
2015-10-07 18:35:35 +00:00
a[href="#"+$op.ID][data-method=$op.Method] #{$op.Summary}
2015-10-06 17:19:43 +00:00
div.row
each $tag in Swagger.Tags
each $op in $tag.Ops
a[name=$op.ID]
div.operation
div
h2[data-method=$op.Method] #{$op.Summary}
p #{$op.Desc}
h3 Request Parameters
ul.params
each $param in $op.Params
li
h4
| #{$param.Name}
small Required
p #{$param.Desc}
h3 Response Messages
ul.params
each $result in $op.Results
li
h4
| #{$result.Status}
p #{$result.Desc}
aside
h4 Endpoint
pre #{$op.Method} /api#{$op.Path}
each $param in $op.Params
if $param.Example
h4 Example Request
if $param.IsObject
pre #{$param.Example}
2015-10-06 17:19:43 +00:00
each $res in $op.Results
if $res.Example
h4 Example Response
if $res.IsArray
pre [#{$res.Example}]
else if $res.IsObject
pre #{$res.Example}
block scripts
script[type="text/javascript"][src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js"]
script[type="text/javascript"][src="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/4.0.0-alpha/js/bootstrap.min.js"]