refactor(openapi): MarkdownProblems 根据 titleLevel 确定是否忽略 detail

locales/zh.yaml

@@ -1,6 +1,7 @@
 languages:
     - zh-Hans
     - cmn-Hans
+    - zh-CN
 messages:
     - key: SSE keep alive cron
       message:

openapi/utils.go

@@ -96,11 +96,31 @@ func getPathParams(path string) []string {
 
 // MarkdownProblems 将 problems 的内容生成为 markdown
 //
-// titleLevlel 标题的级别，1-6；
-func MarkdownProblems(s web.Server, titleLevlel int) web.LocaleStringer {
+// titleLevel 标题的级别，0-6：
+// 如果取值为 0，表示以列表的形式输出，并忽略 detail 字段的内容。
+// 1-6 表示输出 detail 内容，并且将 type 和 title 作为标题；
+func MarkdownProblems(s web.Server, titleLevel int, detail bool) web.LocaleStringer {
+	if detail {
+		return markdownProblemsWithDetail(s, titleLevel)
+	} else {
+		return markdownProblemsWithoutDetail(s)
+	}
+}
+
+func markdownProblemsWithoutDetail(s web.Server) web.LocaleStringer {
+	buf := &errwrap.Buffer{}
+	args := make([]any, 0, 30)
+	s.Problems().Visit(func(status int, lp *web.LocaleProblem) {
+		buf.Printf("- %s", lp.Type()).WString(": %s\n\n")
+		args = append(args, lp.Title)
+	})
+	return web.Phrase(buf.String(), args...)
+}
+
+func markdownProblemsWithDetail(s web.Server, titleLevel int) web.LocaleStringer {
 	buf := &errwrap.Buffer{}
+	ss := strings.Repeat("#", titleLevel)
 
-	ss := strings.Repeat("#", titleLevlel)
 	args := make([]any, 0, 30)
 	s.Problems().Visit(func(status int, lp *web.LocaleProblem) {
 		buf.Printf("%s %s ", ss, lp.Type()).

openapi/utils_test.go

@@ -54,15 +54,14 @@ func TestMarkdownProblems(t *testing.T) {
 	ss := newServer(a)
 	p := ss.Locale().NewPrinter(language.SimplifiedChinese)
 
-	txt := MarkdownProblems(ss, 2)
+	txt := MarkdownProblems(ss, 2, true)
 	lines := strings.Split(txt.LocaleString(p), "\n\n")
 	a.Equal(lines[0], "## 400 Bad Request").
 		Equal(lines[1], "表示客户端错误，比如，错误的请求语法、无效的请求消息帧或欺骗性的请求路由等，服务器无法或不会处理该请求。").
 		Equal(lines[2], "## 401 Unauthorized")
 
-	txt = MarkdownProblems(ss, 3)
+	txt = MarkdownProblems(ss, 3, false)
 	lines = strings.Split(txt.LocaleString(p), "\n\n")
-	a.Equal(lines[0], "### 400 Bad Request").
-		Equal(lines[1], "表示客户端错误，比如，错误的请求语法、无效的请求消息帧或欺骗性的请求路由等，服务器无法或不会处理该请求。").
-		Equal(lines[2], "### 401 Unauthorized")
+	a.Equal(lines[0], "- 400: Bad Request").
+		Equal(lines[1], "- 401: Unauthorized")
 }