redoclyのHTMLテンプレートをカスタムしたい
-
build-docs
をして作成されたhtmlファイルをカスタムして、<script src="https://cdn.jsdelivr.net/npm/redoc/bundles/redoc.standalone.js">
などの外部参照してるところを内部のファイル参照にしたい
前提
OpenAPIの形式でAPI仕様書を会社の開発端末で書いています。
yamlファイルは出来上がり、npx @redocly/cli build-docs xxx.yaml -o xxx.html
を実行したら問題なくHTMLファイルが作成されてWEB上でも表示できるところまできました。
開発環境、試験環境では問題ないのですが、本番環境ではセキュリティが厳しく、
WEBに表示する際に外部参照しているCSSファイルなどが参照できないので
内部のcssファイルやjsファイルを参照できないかと調査しています。
(redoc.standalone.jsなど)
直接HTMLファイルを書き換えれば出来ますが、ビルドオプション等でビルドする際に自動的に書き換わるようにしたいです。
色々方法は試してみているのですが実現できず困っています。
試したこと
- build後に直接HTMLファイルを書き換え
- カスタムHTMLテンプレートを作成し、
build-docs
のオプション-template
で実現できるか試してみたが{{title}}以外のプレースホルダーが効かない
<!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title>{{title}}</title> <style> {{redoc-styles}} </style> </head> <body> <div id="redoc-container"></div> <div id="redoc-content" class="redoc-content"> {{redoc-html}} </div> <script srcr="js/redoc.standalone.js"> //WEBからファイルをダウンロードし内部に設置 {{redoc-script}} </script> </body> </html>
- 公式でTemplateを編集できると書いてあるが、会社のPCでredocのアカウント登録をしてはいけないとのことなので使用できず
公式:https://redocly.com/docs/api-registry/settings/template/
補足情報(FW/ツールのバージョンなど)
Windows11
@redocly/cli : v1.9.0
Node.js : v20.11.0
npm : 10.2.4
VScode

回答1件
あなたの回答
tips
プレビュー
バッドをするには、ログインかつ
こちらの条件を満たす必要があります。