update

2026-04-30 18:54:23 +08:00
parent b78808558b
commit 132b2fc310
14 changed files with 235 additions and 9033 deletions
@@ -0,0 +1,78 @@
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+  title: 'Jiscuss',
+  description: 'Jiscuss，一个简单的、基于 Java 的开源论坛。',
+  lang: 'zh-CN',
+  lastUpdated: true,
+  cleanUrls: true,
+  outDir: '../public',
+  head: [
+    ['link', { rel: 'icon', href: '/favicon.ico' }],
+    ['meta', { name: 'viewport', content: 'width=device-width,initial-scale=1,user-scalable=no' }]
+  ],
+  markdown: {
+    lineNumbers: true
+  },
+  themeConfig: {
+    logo: '/head.png',
+    siteTitle: 'Jiscuss',
+    nav: [
+      { text: '首页', link: '/' },
+      { text: '文档', link: '/views/other/guide' },
+      { text: '时间线', link: '/timeLine/' },
+      { text: 'Jiscuss Demo', link: 'http://demo.jiscuss.com' },
+      {
+        text: '联系作者',
+        items: [
+          { text: 'Yaoyuan.io', link: 'http://www.yaoyuan.io' },
+          { text: 'GitHub', link: 'https://github.com/chuyaoyuan' },
+          { text: 'WeChat', link: 'http://www.chuyaoyuan.com' }
+        ]
+      }
+    ],
+    sidebar: {
+      '/views/': [
+        {
+          text: 'Jiscuss 文档',
+          items: [
+            { text: '快速上手', link: '/views/other/guide' }
+          ]
+        }
+      ],
+      '/timeLine/': [
+        {
+          text: '项目时间线',
+          items: [
+            { text: 'Time Line', link: '/timeLine/' }
+          ]
+        }
+      ]
+    },
+    search: {
+      provider: 'local'
+    },
+    outline: {
+      label: '本页目录',
+      level: [2, 3]
+    },
+    docFooter: {
+      prev: '上一页',
+      next: '下一页'
+    },
+    lastUpdated: {
+      text: '最后更新',
+      formatOptions: {
+        dateStyle: 'short',
+        timeStyle: 'medium'
+      }
+    },
+    footer: {
+      message: 'Released under the MIT License.',
+      copyright: 'Copyright © 2018-present Yaoyuan'
+    },
+    socialLinks: [
+      { icon: 'github', link: 'https://github.com/chuyaoyuan' }
+    ]
+  }
+})
@@ -0,0 +1,4 @@
+import DefaultTheme from 'vitepress/theme'
+import './styles.css'
+
+export default DefaultTheme
@@ -0,0 +1,18 @@
+:root {
+  --vp-c-brand-1: #424242;
+  --vp-c-brand-2: #5f5f5f;
+  --vp-c-brand-3: #232321;
+  --vp-home-hero-name-color: transparent;
+  --vp-home-hero-name-background: linear-gradient(120deg, #232321 30%, #6b7280);
+  --vp-home-hero-image-background-image: linear-gradient(-45deg, #424242 50%, #d1d5db 50%);
+  --vp-home-hero-image-filter: blur(56px);
+}
+
+.VPHomeHero .image-src {
+  max-width: 600px;
+  border-radius: 1rem;
+}
+
+.VPFeature {
+  border-color: rgba(66, 66, 66, 0.12);
+}
@@ -1,31 +1,23 @@
 ---
-home: true
-heroImage: /hero.png
-footer: MIT Licensed | Copyright © 2018-present Evan You
-heroImageStyle: {
-  maxWidth: '600px',
-  width: '100%',
-  display: block,
-  margin: '9rem auto 2rem',
-  background: '#fff',
-  borderRadius: '1rem',
-}
-isShowTitleInHome: false
-actionText: 快速上手 →
-actionLink: /views/other/guide
-features:
- title: 简洁至上
-  details: 开发一款看着开心、写着顺手、使用简单的 开源论坛
- title: JAVA 驱动
-  details: 基于JAVA，使用SpringBoot + H2 Database + Semantic-UI 构建
- title: 持续完善
-  details: 目前的功能还很简陋，日后会一直持续完善
+title: Jiscuss
 ---
+
+# Jiscuss
+
+> 这里保留原 VuePress 首页文章内容。VitePress 2.0 的首页入口已迁移到 `docs/index.md`。
+
 ::: tip 介绍
-1. 这是一个开源JAVA项目；<br>
+1. 这是一个开源 Java 项目；<br>
 2. 项目追求极简；<br>
 3. 你可以打开 [Jiscuss Demo](http://demo.jiscuss.com) 来查看效果。
 :::
+
+## 原首页内容
+
+- **简洁至上**：开发一款看着开心、写着顺手、使用简单的开源论坛。
+- **Java 驱动**：基于 Java，使用 Spring Boot、H2 Database、Semantic UI 构建。
+- **持续完善**：目前功能还很简陋，日后会一直持续完善。
+
 ## 安装

 **Build**
@@ -0,0 +1,48 @@
+---
+layout: home
+
+hero:
+  name: Jiscuss
+  text: 基于 Java 的开源论坛
+  tagline: 简单、轻量、开源，面向发帖、回帖、用户管理与评论等论坛基础场景。
+  image:
+    src: /hero.png
+    alt: Jiscuss
+  actions:
+    - theme: brand
+      text: 快速上手
+      link: /views/other/guide
+    - theme: alt
+      text: 查看 Demo
+      link: http://demo.jiscuss.com
+
+features:
+  - title: 简洁至上
+    details: 开发一款看着开心、写着顺手、使用简单的开源论坛。
+  - title: Java 驱动
+    details: 基于 Java，使用 Spring Boot、Spring JPA、H2 Database 与 Semantic UI 构建。
+  - title: 持续完善
+    details: 目前功能仍在迭代中，后续会持续补充文档、完善功能与优化体验。
+---
+
+::: tip 介绍
+1. 这是一个开源 Java 项目；<br>
+2. 项目追求极简；<br>
+3. 你可以打开 [Jiscuss Demo](http://demo.jiscuss.com) 来查看效果。
+:::
+
+## 安装
+
+**Build**
+
+```bash
+hello world！
+
+# or
+
+hello JAVA！
+```
+
+## 文档站升级说明
+
+当前官方页与文档页已升级到 VitePress 2.0 架构，保留原有文章内容与静态资源，并补充了本地搜索、导航、侧边栏、最后更新时间与预览脚本。
@@ -0,0 +1,8 @@
+---
+title: Time Line
+sidebar: false
+---
+
+## Time Line
+
+> 这里保留原 VuePress 时间线页面内容。后续可以继续追加 Jiscuss 的版本记录、里程碑与发布计划。
@@ -3,9 +3,9 @@ title: jiscuss文档
 date: 2019-09-09
 ---

-![vuepress](https://img.shields.io/badge/vuepress-0.14.8-brightgreen.svg)
-![leancloud-storage](https://img.shields.io/badge/leancloud--storage-3.10.1-orange.svg)
-![valine](https://img.shields.io/badge/valine-1.3.4-blue.svg)
+![vitepress](https://img.shields.io/badge/vitepress-2.0-brightgreen.svg)
+![java](https://img.shields.io/badge/Java-SpringBoot-orange.svg)
+![license](https://img.shields.io/badge/license-MIT-blue.svg)

 ::: tip 介绍
 1. 这是一个JAVA项目，旨在简单易用的前提下添加论坛所需的发帖、回帖、用户管理、评论等功能；<br>
@@ -50,4 +50,15 @@ date: 2019-09-09
 还是衷心地希望能有更多的朋友参与进来，更好地去完善它，就是希望能让Jiscuss，功能越完善，使用越来越简单。

 ## License
-[MIT](https://github.com/chuyaoyuan)
+[MIT](https://github.com/chuyaoyuan)
+
+## 文档站架构
+
+Jiscuss 官方页与文档页已升级为 VitePress 2.0：
+
+- 配置入口：`docs/.vitepress/config.mts`
+- 首页入口：`docs/index.md`
+- 静态资源：`docs/public/`
+- 构建产物：`public/`
+
+本次升级保留了原有文章内容，并补充了本地搜索、导航、侧边栏、最后更新时间与预览命令，便于后续继续完善 Jiscuss 的安装、部署与二次开发文档。