docs: initialize redoc via JS API

not-my-profile · not-my-profile · commit fa5d6cc103ae · 2025-10-15T05:31:26.000+02:00
Preparation for the next commit in which we'll make the script tag async
(in order to use await to fetch the new versions.json file).

Signed-off-by: Martin Fischer &lt;martin@push-f.com&gt;
diff --git a/docs/source/_static/api.html b/docs/source/_static/api.html
@@ -18,6 +18,8 @@
     </style>
   </head>
   <body>
+    <script src="https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js"> </script>
+    <div id="redoc-container"></div>
     <script>
       // get version from query (default to latest)
       var queryString = window.location.search;
@@ -27,13 +29,10 @@
         version = query.get("version");
       }
 
-      var redoc = document.createElement("redoc");
-      redoc.setAttribute("sort-props-alphabetically","");
-      redoc.setAttribute("sort-operations-alphabetically","");
-      redoc.setAttribute("spec-url","https://storage.googleapis.com/libpod-master-releases/swagger-" + version + ".yaml");
-
-      document.body.appendChild(redoc);
+      Redoc.init("https://storage.googleapis.com/libpod-master-releases/swagger-" + version + ".yaml", {
+        sortPropsAlphabetically: true,
+        sortOperationsAlphabetically: true,
+      }, document.getElementById("redoc-container"));
     </script>
-    <script src="https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js"> </script>
   </body>
 </html>
