valaxy-theme-yun 0.14.5 → 0.14.7

package/components/YunGirls.vue

@@ -22,7 +22,11 @@ const { data } = useRandomData(props.girls, props.random)
   <div class="girls">
     <ul class="girl-items">
       <li v-for="girl, i in data" :key="girl.name" class="girl-item">
-        <a :href="girl.url || `https://zh.moegirl.org/${girl.name}`" :title="girl.reason" alt="portrait" target="_blank" rel="noopener">
+        <a
+          class="girl-item-link"
+          :href="girl.url || `https://zh.moegirl.org/${girl.name}`"
+          :title="girl.reason" alt="portrait" target="_blank" rel="noopener"
+        >
           <figure class="girl-info">
             <img class="girl-avatar" loading="lazy" :src="girl.avatar" :alt="girl.name" :onError="onImgError">
             <figcaption class="girl-name" :title="(i + 1).toString()">{{ girl.name }}</figcaption>

package/docs/zh-CN/README.md

@@ -1,3 +1,13 @@
 # valaxy-theme-yun 文档
 
-- [主题配置](./config.md)
+## 配置
+
+### 主题配置
+
+主题特殊配制请参见 [主题配置](./config.md)。
+
+### 通用配置
+
+如「作者头像」、「站点名称」等属于通用信息，请在 `site.config.ts` 中配置。
+
+可参见 [Site Config | Valaxy Docs](https://valaxy.site/guide/config#site-config)。

package/docs/zh-CN/config.md

@@ -2,6 +2,10 @@
 title: 主题配置
 ---
 
+配置 `valaxy.config.ts` 中的 `themeConfig` 字段，类型可直接参考 [valaxy-theme-yun/types/index.d.ts](https://github.com/YunYouJun/valaxy/blob/main/packages/valaxy-theme-yun/types/index.d.ts)。
+
+如您需要更详细的描述/示例，再阅读下方内容。
+
 ## 首页
 
 ### 标语动画

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "valaxy-theme-yun",
-  "version": "0.14.5",
+  "version": "0.14.7",
   "author": {
     "email": "me@yunyoujun.cn",
     "name": "YunYouJun",
@@ -22,6 +22,6 @@
     "valaxy-addon-waline": "0.0.9"
   },
   "devDependencies": {
-    "valaxy": "0.14.5"
+    "valaxy": "0.14.7"
   }
 }

package/types/index.d.ts

@@ -5,11 +5,15 @@ export namespace YunTheme {
   export type Sidebar = any
 
   export type Banner = {
+    /**
+     * 是否启用
+     */
     enable: boolean
     /**
-     * 标题
+     * @en Banner title
+     * @zh 标题，默认每个字分割，你也可以通过数组的方式来自定义分割，如 ['Hello', 'World']
      */
-    title: string
+    title: string | string[]
 
     /**
      * 首页下方的动态云
@@ -21,6 +25,13 @@ export namespace YunTheme {
   }
 }
 
+export interface Page {
+  name: string
+  url: string
+  icon: string
+  color: string
+}
+
 /**
  * Theme Config
  */
@@ -31,9 +42,14 @@ export interface ThemeConfig {
    */
   outlineTitle: string
 
+  /**
+   * @zh 配色
+   */
   colors: {
     /**
-     * primary color
+     * @en primary color
+     * 
+     * @zh 主题色
      * @default '#0078E7'
      */
     primary: string
@@ -44,16 +60,37 @@ export interface ThemeConfig {
    */
   banner: YunTheme.Banner
 
+  /**
+   * @en Background image
+   * @zh 背景图
+   */
   bg_image: {
+    /**
+     * @en Enable background image
+     */
     enable: boolean
+    /**
+     * @en Image url
+     */
     url: string
+    /**
+     * @en Image url when dark mode
+     */
     dark?: string
+    /**
+     * @en Image opacity
+     */
     opacity?: number
   }
 
   /**
+   * @en 
    * say something
-   * https://say.elpsy.cn
+   * 
+   * @zh 说点什么
+   * - 自定义 API 链接，如 https://el-bot-api.elpsy.cn/api/words/young
+   * 你可以通过在 public 下新建 json 的方式来使用, 如 public/young.json
+   * ["Hello, World!", "Bye, World!"]
    */
   say: {
     enable: boolean
@@ -72,12 +109,11 @@ export interface ThemeConfig {
     content: string
   }
 
-  pages: {
-    name: string
-    url: string
-    icon: string
-    color: string
-  }[]
+  /**
+   * @en - Pages
+   * @zh - 页面，显示在社交导航栏下方
+   */
+  pages: Page[]
 
   sidebar: YunTheme.Sidebar
 
@@ -126,7 +162,8 @@ export interface ThemeConfig {
   }>
 
   /**
-   * post card types
+   * @en Custom Post Card Types
+   * @zh 自定义文章卡片类型
    */
   types: Record<string, {
     color: string
@@ -134,9 +171,13 @@ export interface ThemeConfig {
   }>
 
   /**
-   * 菜单栏
+   * @en Menu Bar
+   * @zh 菜单栏
    */
   menu: {
+    /**
+     * @zh 最右侧的导航图标
+     */
     custom: {
       title: string
       url: string

package/composables/404.vue

@@ -1,25 +0,0 @@
-<script lang="ts" setup>
-import { useRouter } from 'vue-router'
-import { useI18n } from 'vue-i18n'
-
-const router = useRouter()
-const { t } = useI18n()
-</script>
-
-<template>
-  <Layout>
-    <template #content>
-      <div text="center">
-        <div text-4xl>
-          <div i-ri-alarm-warning-line inline-block />
-        </div>
-        <router-view />
-        <div>
-          <button btn text-sm m="3 t8" @click="router.back()">
-            {{ t('button.back') }}
-          </button>
-        </div>
-      </div>
-    </template>
-  </Layout>
-</template>