guidebook 0.1.73

HonKit/GitBook compatible static book generator
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

# OpenAPI / Swagger UI

Generate interactive Swagger UI pages from OpenAPI specifications.

## Single API

```json
{
    "openapi": "swagger.json"
}
```

This generates a Swagger UI page at `api-docs.html`.

## Multiple APIs

```json
{
    "openapi": {
        "api-docs": "swagger/v1.json",
        "admin-api": "swagger/admin.json"
    }
}
```

Each key becomes a separate HTML page (e.g., `api-docs.html`, `admin-api.html`).

## Specification Format

Both JSON and YAML OpenAPI specifications are supported. The spec file path is relative to the book's root directory.