ToB企服应用市场:ToB评测及商务社交产业平台

标题: ASP.NET Core Swagger 汉化 [打印本页]
作者: 曂沅仴駦    时间: 6 天前
标题: ASP.NET Core Swagger 汉化
在wwwroot文件夹添加汉化的JS文件
  1. const translations = {
  2.     "Failed to load API definition": "API定义加载失败",
  3.     "Errors": "错误信息",
  4.     "Hide": "隐藏",
  5.     "Fetch error": "获取错误",
  6.     "Internal Server Error": "服务器内部错误",
  7.     "Operations": "操作",
  8.     "Models": "模型",
  9.     "Authorize": "授权",
  10.     "Try it out": "试一试",
  11.     "Select a definition": "选择分支",
  12.     "No parameters": "无参数",
  13.     "Name": "名称",
  14.     "Request body": "请求体",
  15.     "Details": "详细",
  16.     "Cancel": "取消",
  17.     "Server response": "服务器响应",
  18.     "Response body": "响应体",
  19.     "Response headers": "响应头",
  20.     "Request duration": "请求时间",
  21.     "Links": "链接",
  22.     "No links": "无链接",
  23.     "Execute": "执行",
  24.     "Clear": "清除",
  25.     "Response": "响应",
  26.     "Headers": "请求头",
  27.     "Parameters": "参数",
  28.     "Description": "描述",
  29.     "Responses": "响应",
  30.     "Response Class": "响应类",
  31.     "Response Body": "响应体",
  32.     "Response Headers": "响应头",
  33.     "Status Code": "状态码",
  34.     "Example Value": "示例值",
  35.     "Model": "模型",
  36.     "Schema": "结构",
  37.     "Download": "下载",
  38.     "Copy": "复制",
  39.     "Expand Operations": "展开操作",
  40.     "Collapse Operations": "折叠操作",
  41.     "Show/Hide": "显示/隐藏",
  42.     "List Operations": "列表操作",
  43.     "Full Screen": "全屏",
  44.     "Request URL": "请求 URL",
  45.     "Server Response": "服务器响应",
  46.     "Code": "代码",
  47.     "Response Content Type": "响应内容类型",
  48.     "Produces": "生产",
  49.     "Consumes": "消费",
  50.     "Summary": "摘要",
  51.     "Notes": "备注",
  52.     "Implementation Notes": "实现备注",
  53.     "Response Messages": "响应消息",
  54.     "Response Model": "响应模型",
  55.     "Request Body": "请求体",
  56.     "Request Samples": "请求示例",
  57.     "Response Samples": "响应示例",
  58.     "Security": "安全",
  59.     "OAuth2": "OAuth2",
  60.     "API Key": "API 密钥",
  61.     "Basic Auth": "基本认证",
  62.     "Bearer Token": "Bearer 令牌",
  63.     "No API Key": "没有 API 密钥",
  64.     "No Authorization": "没有授权",
  65.     "No Response": "没有响应",
  66.     "No Content": "没有内容",
  67.     "No Data": "没有数据",
  68.     "No Example": "没有示例",
  69.     "No Model": "没有模型",
  70.     "No Schema": "没有结构",
  71.     "No Description": "没有描述",
  72.     "No Summary": "没有摘要",
  73.     "No Notes": "没有备注",
  74.     "No Implementation Notes": "没有实现备注",
  75.     "No Response Messages": "没有响应消息",
  76.     "No Response Model": "没有响应模型",
  77.     "No Request Body": "没有请求体",
  78.     "No Request Samples": "没有请求示例",
  79.     "No Response Samples": "没有响应示例",
  80.     "No Security": "没有安全",
  81.     "No OAuth2": "没有 OAuth2",
  82.     "No API Key": "没有 API 密钥",
  83.     "No Basic Auth": "没有基本认证",
  84.     "No Bearer Token": "没有 Bearer 令牌",
  85.     "Warning: Deprecated": "警告：已过时",
  86.     "Status": "状态",
  87.     "Parameter": "参数",
  88.     "Value": "值",
  89.     "Parameter Type": "参数类型",
  90.     "Data Type": "数据类型",
  91.     "HTTP Status Code": "HTTP状态码",
  92.     "Reason": "原因",
  93.     "Hide Response": "隐藏响应",
  94.     "Raw": "原始",
  95.     "can't parse JSON.  Raw result": "无法解析JSON. 原始结果",
  96.     "Model Schema": "模型架构",
  97.     "apply": "应用",
  98.     "Username": "用户名",
  99.     "Password": "密码",
  100.     "Terms of service": "服务条款",
  101.     "Created by": "创建者",
  102.     "See more at": "查看更多：",
  103.     "Contact the developer": "联系开发者",
  104.     "api version": "api版本",
  105.     "fetching resource": "正在获取资源",
  106.     "fetching resource list": "正在获取资源列表",
  107.     "Explore": "浏览",
  108.     "Show Swagger Petstore Example Apis": "显示 Swagger Petstore 示例 Apis",
  109.     "Can't read from server.  It may not have the appropriate access-control-origin settings.": "无法从服务器读取。可能没有正确设置access-control-origin。",
  110.     "Please specify the protocol for": "请指定协议：",
  111.     "Can't read swagger JSON from": "无法读取swagger JSON于",
  112.     "Finished Loading Resource Information. Rendering Swagger UI": "已加载资源信息。正在渲染Swagger UI",
  113.     "Unable to read api": "无法读取api",
  114.     "from path": "从路径",
  115.     "server returned": "服务器返回"
  116. };
  117. window.SwaggerTranslator = {
  118.     translate: function() {
  119.         // 翻译标题和按钮文本
  120.         $('h2, h3, h4, .btn, .opblock-summary-description, .opblock-summary-operation-id, .parameter__name, .parameter__type, .response-col_status, .response-col_description').each(function() {
  121.             const text = $(this).text().trim();
  122.             if (translations[text]) {
  123.                 $(this).text(translations[text]);
  124.             }
  125.         });
  127.         // 翻译输入框和下拉框的 placeholder
  128.         $('input[placeholder], select[data-placeholder]').each(function() {
  129.             const placeholder = $(this).attr('placeholder') || $(this).data('placeholder');
  130.             if (translations[placeholder]) {
  131.                 if ($(this).is('input')) {
  132.                     $(this).attr('placeholder', translations[placeholder]);
  133.                 } else {
  134.                     $(this).data('placeholder', translations[placeholder]);
  135.                 }
  136.             }
  137.         });
  139.         // 翻译所有文本节点
  140.         $('*').contents().filter(function() {
  141.             return this.nodeType === Node.TEXT_NODE;
  142.         }).each(function() {
  143.             const text = this.nodeValue.trim();
  144.             if (translations[text]) {
  145.                 this.nodeValue = translations[text];
  146.             }
  147.         });
  148.     }
  149. };
  151. function waitForSwaggerUI() {
  152.     if ($('.swagger-ui').length) {
  153.         // Swagger UI 已加载，执行翻译
  154.         window.SwaggerTranslator.translate();
  155.         
  156.         // 监听动态内容变化
  157.         const observer = new MutationObserver(function(mutations) {
  158.             window.SwaggerTranslator.translate();
  159.         });
  161.         observer.observe(document.querySelector('.swagger-ui'), {
  162.             childList: true,
  163.             subtree: true
  164.         });
  165.     } else {
  166.         // 如果还没加载完，等待100ms后重试
  167.         setTimeout(waitForSwaggerUI, 100);
  168.     }
  169. }
  171. // 等待页面加载完成后开始检查 Swagger UI
  172. document.addEventListener('DOMContentLoaded', function() {
  173.     waitForSwaggerUI();
  174. });
复制代码
然后配置
  1. app.UseSwaggerUI(c =>
  2. {
  3.      // 修改加载顺序和时机
  4.      c.UseRequestInterceptor("(req) => { return req; }");
  5.      c.UseResponseInterceptor("(res) => { return res; }");
  6.      // 确保 jQuery 先加载
  7.      c.InjectJavascript("/swagger/jquery-3.7.1.min.js");
  8.      // 然后加载翻译脚本
  9.      c.InjectJavascript("/swagger/lang/zh-cn.js");
  11.   
  12. });
  13. // 启用静态文件中间件
  14. app.UseStaticFiles();
复制代码
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。



欢迎光临 ToB企服应用市场:ToB评测及商务社交产业平台 (https://dis.qidao123.com/) Powered by Discuz! X3.4