如何在Debian上自定義Swagger主題

在Debian系統上自定義Swagger（現在通常稱為OpenAPI）主題，通常涉及到修改Swagger UI的靜態資源，例如CSS、JavaScript和圖像文件。以下是一些基本步驟來幫助你自定義Swagger UI的主題：

1. 安裝Swagger UI: 如果你還沒有安裝Swagger UI，你可以通過npm來安裝它。首先，確保你已經安裝了Node.js和npm。然后，運行以下命令來全局安裝Swagger UI：

   npm install -g swagger-ui-express
   

2. 下載Swagger UI: 你可以從GitHub上下載Swagger UI的源代碼，或者使用npm來獲取它：

   npm install swagger-ui-dist
   

3. 自定義主題: Swagger UI的源代碼中包含了一些默認的主題文件，你可以在swagger-ui-dist目錄下的ui文件夾中找到它們。你可以復制這些文件到你的項目中，并根據需要進行修改。

   例如，如果你想自定義CSS，你可以復制swagger-ui.css文件并重命名，然后在你的HTML文件中引用新的CSS文件。

4. 使用自定義主題: 在你的HTML文件中，你需要指定使用自定義的主題。例如，如果你修改了CSS文件，你需要在引入Swagger UI的JavaScript文件之前引入你的CSS文件：

   <link rel="stylesheet" type="text/css" href="path/to/your-custom-swagger-ui.css">
   <script src="path/to/swagger-ui-bundle.js"></script>
   <script src="path/to/swagger-ui-standalone-preset.js"></script>
   

5. 啟動Swagger UI: 使用swagger-ui-express啟動Swagger UI，并指向你的OpenAPI規范文件：

   const swaggerUi = require('swagger-ui-express');
   const YAML = require('yamljs');
   const express = require('express');
   const app = express();
   
   // Load Swagger document
   const swaggerDocument = YAML.load('./path/to/swagger.json');
   
   // Serve Swagger docs
   app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument, {
     customCss: '/path/to/your-custom-swagger-ui.css'
   }));
   
   const port = process.env.PORT || 8080;
   app.listen(port, () => console.log(`Server is running on port ${port}`));
   

6. 部署: 當你對自定義的主題滿意后，你可以將你的應用程序部署到Debian服務器上。

請注意，這只是一個基本的指南，具體的步驟可能會根據你使用的Swagger UI版本和你的具體需求有所不同。如果你使用的是Swagger UI的特定版本或者有更高級的自定義需求，你可能需要查閱該版本的官方文檔來獲取更詳細的指導。