feat: allow downloading openapi specs (without decorators) (#1414)

Author: B4nan

.gitignore

@@ -21,4 +21,5 @@ tsconfig.tsbuildinfo
 sources/api/*
 !sources/api/sidebars.js
 apify-api.yaml
+static/api
 apify-docs-theme/package-lock.json

apify-docs-theme/src/theme/custom.css

@@ -1833,6 +1833,10 @@ iframe[src*="youtube"] {
     text-transform: none;
 }
 
+.plugin-id-openapi .export-button {
+    --ifm-button-size-multiplier: 1.5;
+}
+
 @media (max-width: 996px) {
     div[class^="navbarSearchContainer"] {
         position: static;

docusaurus.config.js

@@ -194,6 +194,7 @@ module.exports = {
                 config: {
                     /** @type {import('docusaurus-plugin-openapi-docs').Options} */
                     v2: {
+                        downloadUrl: 'apify-api.yaml',
                         specPath: 'apify-api.yaml',
                         outputDir: './sources/api',
                         markdownGenerators: {

package.json

@@ -19,11 +19,12 @@
         "start": "npm run api:rebuild && rimraf .docusaurus && cross-env LOCALHOST=1 CRAWLEE_DOCS_FAST=1 docusaurus start",
         "start:dev": "npm run api:rebuild && rimraf .docusaurus && cross-env DEV=1 CRAWLEE_DOCS_FAST=1 docusaurus start",
         "build": "npm run api:rebuild && rimraf .docusaurus && docusaurus build",
-        "api:generate": "npm run redoc:build && docusaurus gen-api-docs all",
+        "api:generate": "npm run redoc:build && npm run redoc:build:clean && docusaurus gen-api-docs all",
         "api:clean": "docusaurus clean-api-docs all",
         "api:rebuild": "npm run api:clean && npm run api:generate",
         "redoc:start": "redocly preview-docs",
         "redoc:build": "redocly bundle apify-api/openapi/openapi.yaml -o apify-api",
+        "redoc:build:clean": "redocly bundle apify-api/openapi/openapi.yaml --skip-decorator=apify/legacy-doc-url-decorator --skip-decorator=apify/client-references-links-decorator --skip-decorator=apify/code-samples-decorator -o static/api/apify-api.yaml",
         "redoc:test": "redocly lint && npm run redoc:build",
         "redoc:test2": "redocly lint && npm run redoc:build && bin/schemathesis",
         "write-translations": "docusaurus write-translations",