Use @redocly/cli MTC-29254

download-openapi.sh

@@ -4,4 +4,5 @@ for v in v1 v2 v3 v4 v5 v6; do \
   curl -s http://192.168.58.25/cgi-bin/mt/mt-data-api.cgi/${v}/ \
     | jq '.servers[0].url = "https://example.com/mt/mt-data-api.cgi/v1"' \
     | jq -S . > src/openapi/${v}.json; \
+    perl json2yaml.pl src/openapi/${v}.json > src/openapi/${v}.yaml; \
 done

json2yaml.pl

@@ -0,0 +1,21 @@
+#!/usr/bin/perl
+
+use strict;
+use warnings;
+use feature qw/say/;
+use JSON;
+use YAML;
+use Data::Dumper; $Data::Dumper::Indent = 1;
+
+my $filename = $ARGV[0];
+
+exit 1 unless $filename;
+
+open my $fh, '<', $filename;
+my $file = do { local $/; <$fh> };
+close $fh;
+
+my $json = JSON::decode_json($file);
+local $YAML::Stringify = 1;
+my $yaml = Dump($json);
+say $yaml;

package.json

@@ -23,12 +23,12 @@
   },
   "homepage": "https://github.com/movabletype/mt-docs-data-api-reference#readme",
   "devDependencies": {
+    "@redocly/cli": "^1.5.0",
     "child_process": "^1.0.2",
     "css-loader": "^6.7.1",
     "gulp": "^4.0.2",
     "gulp-connect": "^5.7.0",
     "marked": "^4.1.1",
-    "redoc-cli": "^0.13.20",
     "style-loader": "^3.3.1",
     "webpack": "^5.94.0",
     "webpack-cli": "^4.10.0"

redoc-build.sh

@@ -1,11 +1,11 @@
 #!/bin/sh
 
 for v in v1 v2 v3 v4 v5 v6; do \
-  npx redoc-cli build src/openapi/${v}.json \
+  npx @redocly/cli build-docs src/openapi/${v}.yaml \
     --template src/openapi/data-api-redoc.hbs \
     --disableGoogleFont \
     --title "Movable Type Data API ${v}" \
     --templateOptions.metaDescription "Movable Type Data API ${v}" \
-    --options.sortTagsAlphabetically=true \
+    --config redoc.config.yaml \
     --output docs/${v}.html; \
 done

redoc.config.yaml

@@ -0,0 +1,3 @@
+theme:
+  openapi:
+    sortTagsAlphabetically: true