Linux下Swagger如何實現API文檔的國際化

在Linux環境下，要實現Swagger API文檔的國際化，你需要遵循以下步驟：

1. 安裝并配置Swagger：首先，確保你已經在你的Linux系統上安裝了Swagger。你可以使用npm（Node.js包管理器）來安裝Swagger。運行以下命令來全局安裝Swagger：

npm install -g swagger-jsdoc

2. 創建Swagger配置文件：在你的項目中創建一個名為swagger.js的文件。在這個文件中，你需要配置Swagger，包括API信息、基本路徑等。例如：

const swaggerJsDoc = require('swagger-jsdoc');

const swaggerOptions = {
  swaggerDefinition: {
    info: {
      title: 'My API',
      description: 'My API with internationalization support',
      version: '1.0.0',
      contact: {
        name: 'Your Name',
      },
    },
    basePath: '/',
  },
  apis: ['./routes/*.js'], // Your API routes file(s)
};

module.exports = swaggerJsDoc(swaggerOptions);

3. 添加多語言支持：在swagger.js文件中，你可以添加一個名為schemes的屬性，用于指定支持的API版本。例如：

const swaggerOptions = {
  // ...
  schemes: ['http', 'https'],
};

4. 在API路由文件中添加多語言支持：在你的API路由文件（例如./routes/users.js）中，你可以使用swagger-jsdoc庫來定義多語言的API描述。例如：

const swaggerJsDoc = require('swagger-jsdoc');

const swaggerOptions = {
  swaggerDefinition: {
    // ...
  },
  apis: ['./routes/*.js'],
};

const swaggerDocs = swaggerJsDoc(swaggerOptions);

// Define your routes here
router.get('/users', (req, res) => {
  // Your route logic here
});

// Add multi-language support for the route
router.get('/users', swaggerDocs.swagger.operationId, (req, res) => {
  // Your route logic here
});

5. 生成并查看API文檔：運行以下命令來生成API文檔：

swagger-jsdoc -f ./swagger.json -o ./public/swagger.json

這將在./public目錄下生成一個名為swagger.json的文件。你可以使用Swagger UI來查看和測試你的API文檔：

swagger-ui-express -c ./public/swagger.json

現在，你的Swagger API文檔已經支持多語言了。你可以在瀏覽器中訪問http://localhost:3000/swagger-ui.html（假設你的應用程序運行在3000端口上）來查看和測試你的API文檔。