docs: add OpenAPI example

Author: davlgd

docs/content/api/_index.md

@@ -0,0 +1,22 @@
+---
+type: openapi
+title: API documentation
+swagger:
+  url: https://raw.githubusercontent.com/OAI/learn.openapis.org/refs/heads/main/examples/v3.1/tictactoe.json
+
+  # Could be multiple URLs (need StandaloneLayout)
+  #layout: StandaloneLayout
+  #urls:
+  #- name: Tic Tac Toe
+  #  url: https://raw.githubusercontent.com/OAI/learn.openapis.org/refs/heads/main/examples/v3.1/tictactoe.json
+  #- name: Webhook
+  #  url: https://raw.githubusercontent.com/OAI/learn.openapis.org/refs/heads/main/examples/v3.1/webhook-example.json
+
+  filter: true
+  operationsSorter: alpha
+  tagsSorter: alpha
+  #tryItOutEnabled: false
+  #supportedSubmitMethods:
+  #  - get
+  # More parameters: https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration/
+---

docs/hugo.yaml

@@ -85,27 +85,31 @@ menu:
     - identifier: versions
       name: Versions
       weight: 2
+    - identifier: api
+      name: API
+      pageRef: /api
+      weight: 3
     - identifier: blog
       name: Blog
       pageRef: /blog
-      weight: 3
+      weight: 4
     - identifier: about
       name: About
       pageRef: /about
-      weight: 4
+      weight: 5
     - identifier: showcase
       name: Showcase
       pageRef: /showcase
-      weight: 5
+      weight: 6
       params:
         type: link
         icon: collection
     - name: Search
-      weight: 6
+      weight: 7
       params:
         type: search
     - name: GitHub
-      weight: 7
+      weight: 8
       url: "https://github.com/imfing/hextra"
       params:
         icon: github