
本文介绍几种在Linux系统中自定义Swagger UI主题的方法。
方法一:利用Swagger UI内置主题
Swagger UI自带多种主题,可通过修改配置文件轻松切换。步骤如下:
-
使用Docker运行Swagger UI (版本v4.15.5为例):
docker pull swaggerapi/swagger-ui:v4.15.5 docker run -d -p 38081:8080 swaggerapi/swagger-ui:v4.15.5
-
访问
http://:38081/swagger-ui/index.html。 -
在页面找到Swagger UI配置区域,修改
theme属性选择所需主题。
方法二:采用第三方主题库
一些第三方项目提供自定义主题方案,例如think-swagger-ui-vuele (基于Vue.js)。步骤:
-
克隆项目:
点创DOidea网上书店下载一套专业的网上书店程序,可以作为新华书店及大中型书店网上销售的首选,满足在线支付及汇款确认机制。功能简介:图书分类、查询、排行、最新、特价、关注排行、销售排行,新闻系统、汇款确认机制、求购书籍、在线咨询、热门图书定义、全站广告后台管理、后台采用WEBEDIT编辑器、集成"支付宝"在线支付等...v3.5版特殊功能说明(前台):1.自带5种风格主题。2.友好的页面提示(对网站全部
git clone https://github.com/chfree/think-swagger-ui-vuele.git
-
安装依赖并启动:
cd think-swagger-ui-vuele npm install npm run dev
-
修改项目配置文件中的主题相关设置。
方法三:CSS样式覆盖
如果前两种方法无法满足需求,可通过CSS覆盖Swagger UI默认样式。
-
找到Swagger UI生成的CSS文件 (例如
/usr/local/src/swagger-ui/dist/swagger-ui.css)。 -
创建自定义CSS文件,编写样式规则覆盖默认样式。
-
在
index.html中引入自定义CSS文件:
请注意,以上步骤可能因Swagger UI版本和配置而异。 建议参考相关文档或寻求社区支持以获取更详细的指导。









