docs: add target attribute documentation for menu item (#191)

添加主题开发 - 导航菜单中关于 `target` 属性的文档

/kind documentation

Fixes #190 

```release-note
None
```

docs/developer-guide/theme/finder-apis/menu.md

@@ -30,7 +30,12 @@ menuFinder.getByName(name)
 <div th:with="menu = ${menuFinder.getByName('menu-foo')}">
   <ul th:with="menuItems = ${menu.menuItems}">
     <li th:each="menuItem : ${menuItems}">
-      <a th:href="@{${menuItem.status.href}}" th:text="${menuItem.spec.displayName}"></a>
+      <a
+        th:href="@{${menuItem.status.href}}"
+        th:text="${menuItem.spec.displayName}"
+        th:target="${menuItem.spec.target?.value}"
+      >
+      </a>
     </li>
   </ul>
 </div>
@@ -60,7 +65,12 @@ menuFinder.getPrimary()
 <div th:with="menu = ${menuFinder.getPrimary()}">
   <ul th:with="menuItems = ${menu.menuItems}">
     <li th:each="menuItem : ${menuItems}">
-      <a th:href="@{${menuItem.status.href}}" th:text="${menuItem.spec.displayName}"></a>
+      <a
+        th:href="@{${menuItem.status.href}}"
+        th:text="${menuItem.spec.displayName}"
+        th:target="${menuItem.spec.target?.value}"
+      >
+      </a>
     </li>
   </ul>
 </div>

docs/developer-guide/theme/vo/MenuItemVo.md

@@ -17,12 +17,13 @@
     "children": [                                       // 下级菜单项，菜单项的 metadata.name 集合
       "string"
     ],
+    "target": "#Target",                                // 菜单页面打开方式，枚举类型
     "targetRef": {                                      // 与其他资源比如文章的关联，一般无需直接使用
       "group": "string",
       "version": "string",
       "kind": "string",
       "name": "string"
-    }
+    },
   },
   "status": {
     "displayName": "string",                            // 显示名称
@@ -32,3 +33,12 @@
   "parentName": "string",
 }
 ```
+
+```java title="Target"
+enum Target {
+    BLANK("_blank"),                                     // 在新窗口打开
+    SELF("_self"),                                       // 在当前窗口打开
+    PARENT("_parent"),                                   // 在父窗口打开
+    TOP("_top");                                         // 在顶级窗口打开
+}
+```

versioned_docs/version-2.1/developer-guide/theme/finder-apis/menu.md

@@ -30,7 +30,12 @@ menuFinder.getByName(name)
 <div th:with="menu = ${menuFinder.getByName('menu-foo')}">
   <ul th:with="menuItems = ${menu.menuItems}">
     <li th:each="menuItem : ${menuItems}">
-      <a th:href="@{${menuItem.status.href}}" th:text="${menuItem.spec.displayName}"></a>
+      <a
+        th:href="@{${menuItem.status.href}}"
+        th:text="${menuItem.spec.displayName}"
+        th:target="${menuItem.spec.target?.value}"
+      >
+      </a>
     </li>
   </ul>
 </div>
@@ -60,7 +65,12 @@ menuFinder.getPrimary()
 <div th:with="menu = ${menuFinder.getPrimary()}">
   <ul th:with="menuItems = ${menu.menuItems}">
     <li th:each="menuItem : ${menuItems}">
-      <a th:href="@{${menuItem.status.href}}" th:text="${menuItem.spec.displayName}"></a>
+      <a
+        th:href="@{${menuItem.status.href}}"
+        th:text="${menuItem.spec.displayName}"
+        th:target="${menuItem.spec.target?.value}"
+      >
+      </a>
     </li>
   </ul>
 </div>

versioned_docs/version-2.1/developer-guide/theme/vo/MenuItemVo.md

@@ -17,6 +17,7 @@
     "children": [                                       // 下级菜单项，菜单项的 metadata.name 集合
       "string"
     ],
+    "target": "#Target",                                // 菜单页面打开方式，枚举类型
     "targetRef": {                                      // 与其他资源比如文章的关联，一般无需直接使用
       "group": "string",
       "version": "string",
@@ -32,3 +33,12 @@
   "parentName": "string",
 }
 ```
+
+```java title="Target"
+enum Target {
+    BLANK("_blank"),                                     // 在新窗口打开
+    SELF("_self"),                                       // 在当前窗口打开
+    PARENT("_parent"),                                   // 在父窗口打开
+    TOP("_top");                                         // 在顶级窗口打开
+}
+```

versioned_docs/version-2.2/developer-guide/theme/finder-apis/menu.md

@@ -30,7 +30,12 @@ menuFinder.getByName(name)
 <div th:with="menu = ${menuFinder.getByName('menu-foo')}">
   <ul th:with="menuItems = ${menu.menuItems}">
     <li th:each="menuItem : ${menuItems}">
-      <a th:href="@{${menuItem.status.href}}" th:text="${menuItem.spec.displayName}"></a>
+      <a
+        th:href="@{${menuItem.status.href}}"
+        th:text="${menuItem.spec.displayName}"
+        th:target="${menuItem.spec.target?.value}"
+      >
+      </a>
     </li>
   </ul>
 </div>
@@ -60,7 +65,12 @@ menuFinder.getPrimary()
 <div th:with="menu = ${menuFinder.getPrimary()}">
   <ul th:with="menuItems = ${menu.menuItems}">
     <li th:each="menuItem : ${menuItems}">
-      <a th:href="@{${menuItem.status.href}}" th:text="${menuItem.spec.displayName}"></a>
+      <a
+        th:href="@{${menuItem.status.href}}"
+        th:text="${menuItem.spec.displayName}"
+        th:target="${menuItem.spec.target?.value}"
+      >
+      </a>
     </li>
   </ul>
 </div>

versioned_docs/version-2.2/developer-guide/theme/vo/MenuItemVo.md

@@ -17,6 +17,7 @@
     "children": [                                       // 下级菜单项，菜单项的 metadata.name 集合
       "string"
     ],
+    "target": "#Target",                                // 菜单页面打开方式，枚举类型
     "targetRef": {                                      // 与其他资源比如文章的关联，一般无需直接使用
       "group": "string",
       "version": "string",
@@ -32,3 +33,12 @@
   "parentName": "string",
 }
 ```
+
+```java title="Target"
+enum Target {
+    BLANK("_blank"),                                     // 在新窗口打开
+    SELF("_self"),                                       // 在当前窗口打开
+    PARENT("_parent"),                                   // 在父窗口打开
+    TOP("_top");                                         // 在顶级窗口打开
+}
+```

versioned_docs/version-2.3/developer-guide/theme/finder-apis/menu.md

@@ -30,7 +30,12 @@ menuFinder.getByName(name)
 <div th:with="menu = ${menuFinder.getByName('menu-foo')}">
   <ul th:with="menuItems = ${menu.menuItems}">
     <li th:each="menuItem : ${menuItems}">
-      <a th:href="@{${menuItem.status.href}}" th:text="${menuItem.spec.displayName}"></a>
+      <a
+        th:href="@{${menuItem.status.href}}"
+        th:text="${menuItem.spec.displayName}"
+        th:target="${menuItem.spec.target?.value}"
+      >
+      </a>
     </li>
   </ul>
 </div>
@@ -60,7 +65,12 @@ menuFinder.getPrimary()
 <div th:with="menu = ${menuFinder.getPrimary()}">
   <ul th:with="menuItems = ${menu.menuItems}">
     <li th:each="menuItem : ${menuItems}">
-      <a th:href="@{${menuItem.status.href}}" th:text="${menuItem.spec.displayName}"></a>
+      <a
+        th:href="@{${menuItem.status.href}}"
+        th:text="${menuItem.spec.displayName}"
+        th:target="${menuItem.spec.target?.value}"
+      >
+      </a>
     </li>
   </ul>
 </div>

versioned_docs/version-2.3/developer-guide/theme/vo/MenuItemVo.md

@@ -17,6 +17,7 @@
     "children": [                                       // 下级菜单项，菜单项的 metadata.name 集合
       "string"
     ],
+    "target": "#Target",                                // 菜单页面打开方式，枚举类型
     "targetRef": {                                      // 与其他资源比如文章的关联，一般无需直接使用
       "group": "string",
       "version": "string",
@@ -32,3 +33,12 @@
   "parentName": "string",
 }
 ```
+
+```java title="Target"
+enum Target {
+    BLANK("_blank"),                                     // 在新窗口打开
+    SELF("_self"),                                       // 在当前窗口打开
+    PARENT("_parent"),                                   // 在父窗口打开
+    TOP("_top");                                         // 在顶级窗口打开
+}
+```