漂亮的 API 文档生成工具：scalar #67

adoyle-h · 2024-09-02T13:12:00Z

adoyle-h
Sep 2, 2024
Maintainer

只需要写一个 html 文件，然后引用你的 OpenAPI/Swagger 文档，就可以生成漂亮的 API 文档。

DEMO

<!doctype html>
<html>
  <head>
    <title>Scalar API Reference</title>
    <meta charset="utf-8" />
    <meta
      name="viewport"
      content="width=device-width, initial-scale=1" />
  </head>
  <body>
    <!-- Need a Custom Header? Check out this example https://codepen.io/scalarorg/pen/VwOXqam -->
    <script
      id="api-reference"
      data-url="https://cdn.jsdelivr.net/npm/@scalar/galaxy/dist/latest.yaml"></script>
    <script src="https://cdn.jsdelivr.net/npm/@scalar/api-reference"></script>
  </body>
</html>

kalxd · 2024-09-07T12:45:35Z

kalxd
Sep 7, 2024

我更想要生成open-api工具，当然不是那种注释里写满spec再生成的工具，而是能根据框架类型定义生成出来。

1 reply

adoyle-h Sep 7, 2024
Maintainer Author

一般都是根据 openapi spec 生成代码的。https://openapi-generator.tech/

反过来的需求不常见。

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

漂亮的 API 文档生成工具：scalar #67

Uh oh!

{{title}}

Uh oh!

Replies: 1 comment 1 reply

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Select a reply

Uh oh!

漂亮的 API 文档生成工具：scalar #67

Uh oh!

adoyle-h Sep 2, 2024 Maintainer

DEMO

Replies: 1 comment · 1 reply

Uh oh!

kalxd Sep 7, 2024

Uh oh!

adoyle-h Sep 7, 2024 Maintainer Author

adoyle-h
Sep 2, 2024
Maintainer

Replies: 1 comment 1 reply

kalxd
Sep 7, 2024

adoyle-h Sep 7, 2024
Maintainer Author