如何自定义CentOS上的Swagger主题

在CentOS上自定义Swagger主题，通常涉及到修改Swagger UI的CSS和JavaScript文件。以下是一个基本的步骤指南：

1. 安装Swagger UI： 如果你还没有安装Swagger UI，可以通过npm来安装它。首先，确保你已经安装了Node.js和npm。

   sudo yum install -y nodejs npm
   

   然后，使用npm安装swagger-ui-express：

   npm install swagger-ui-express
   

2. 下载Swagger UI资源： 你可以从Swagger UI的GitHub仓库下载最新的资源文件，或者直接在项目中引用CDN上的资源。

   wget https://repo1.maven.org/maven2/io/swagger/swagger-ui/3.50.0/swagger-ui-bundle.js
   wget https://repo1.maven.org/maven2/io/swagger/swagger-ui/3.50.0/swagger-ui-standalone-preset.css
   

   请注意，上面的链接是示例，你应该访问Swagger UI GitHub页面来获取最新版本的下载链接。

3. 自定义CSS： 创建一个新的CSS文件来自定义Swagger UI的外观。例如，创建一个名为custom.css的文件，并添加你的自定义样式。

   vi custom.css
   

   在custom.css中添加你的自定义样式规则。

4. 自定义JavaScript： 如果你需要更深入的自定义，比如修改行为或添加新的功能，你可以编辑swagger-ui-bundle.js文件，或者在项目中添加自己的JavaScript文件。

5. 配置Swagger UI： 在你的Express应用中，配置Swagger UI以使用自定义的CSS和JavaScript文件。

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

6. 重启应用： 保存所有更改并重启你的Express应用以使自定义生效。

   node your-app.js
   

7. 访问Swagger UI： 打开浏览器并访问http://your-server-ip:port/api-docs，你应该能看到你的自定义Swagger UI主题。

请记住，自定义Swagger UI可能涉及到前端开发的知识，特别是CSS和JavaScript。如果你不熟悉这些技术，可能需要进一步学习或寻求专业的帮助。