v0.3.0
* Getting environment variables and passwords from Vault (not tested yet) * Vault configuration to config (not tested yet) * Ability to run scripts from file on local machine on the remote host * Ability to get ouput in the notification of a list for individual commands or all commands * Make SSH connections close after all commands have been run; reuse previous connections if needed
This commit is contained in:
56
docs/themes/hugo-theme-relearn/exampleSite/content/shortcodes/openapi/_index.en.md
vendored
Normal file
56
docs/themes/hugo-theme-relearn/exampleSite/content/shortcodes/openapi/_index.en.md
vendored
Normal file
@ -0,0 +1,56 @@
|
||||
---
|
||||
description: "UI for your OpenAPI / Swagger specifications"
|
||||
title: "OpenAPI"
|
||||
---
|
||||
|
||||
The `openapi` shortcode uses the [Swagger UI](https://github.com/swagger-api/swagger-ui) library to display your OpenAPI / Swagger specifications.
|
||||
|
||||
{{% notice note %}}
|
||||
This only works in modern browsers.
|
||||
{{% /notice %}}
|
||||
|
||||
## Usage
|
||||
|
||||
While the examples are using shortcodes with named parameter you are free to also call this shortcode from your own partials.
|
||||
|
||||
{{< tabs groupId="shortcode-parameter">}}
|
||||
{{% tab title="shortcode" %}}
|
||||
|
||||
````go
|
||||
{{</* openapi src="https://petstore3.openapi.io/api/v3/openapi.json" */>}}
|
||||
````
|
||||
|
||||
{{% /tab %}}
|
||||
{{% tab title="partial" %}}
|
||||
|
||||
````go
|
||||
{{ partial "shortcodes/openapi.html" (dict
|
||||
"context" .
|
||||
"src" "https://petstore3.openapi.io/api/v3/openapi.json"
|
||||
)}}
|
||||
````
|
||||
|
||||
{{% /tab %}}
|
||||
{{< /tabs >}}
|
||||
|
||||
### Parameter
|
||||
|
||||
| Name | Default | Notes |
|
||||
|:---------------------|:-----------------|:------------|
|
||||
| **src** | _<empty>_ | The URL to the OpenAPI specification file. This can be relative to the URL of your page if it is a leaf or branch bundle. |
|
||||
|
||||
{{% notice note %}}
|
||||
If you want to print out (or generate a PDF) from your OpenAPI documentation, don't initiate printing directly from the page because the elements are optimized for interactive usage in a browser.
|
||||
|
||||
Instead, open the [print preview]({{% relref "basics/configuration/#activate-print-support" %}}) in your browser and initiate printing from that page. This page is optimized for reading and expands most of the available sections.
|
||||
{{% /notice %}}
|
||||
|
||||
## Example
|
||||
|
||||
### Using Local File
|
||||
|
||||
````go
|
||||
{{</* openapi src="petstore.json" */>}}
|
||||
````
|
||||
|
||||
{{< openapi src="petstore.json" >}}
|
5
docs/themes/hugo-theme-relearn/exampleSite/content/shortcodes/openapi/_index.pir.md
vendored
Normal file
5
docs/themes/hugo-theme-relearn/exampleSite/content/shortcodes/openapi/_index.pir.md
vendored
Normal file
@ -0,0 +1,5 @@
|
||||
---
|
||||
description: "Adds UI fer yer OpenAPI / Swaggerrr Specificat'ns"
|
||||
title: "OpenAPI"
|
||||
---
|
||||
{{< piratify true >}}
|
1225
docs/themes/hugo-theme-relearn/exampleSite/content/shortcodes/openapi/petstore.json
vendored
Normal file
1225
docs/themes/hugo-theme-relearn/exampleSite/content/shortcodes/openapi/petstore.json
vendored
Normal file
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user