This commit is contained in:
2026-04-30 18:54:23 +08:00
parent b78808558b
commit 132b2fc310
14 changed files with 235 additions and 9033 deletions
+41 -36
View File
@@ -1,47 +1,52 @@
# vuepress-theme-reco-demo
# Jiscuss 官方页 & 文档页
Blog demo1 for vuepress-theme-reco
这是基于 Java 的开源论坛 **Jiscuss** 的官方首页与文档站。项目文档站已从 VuePress 1 + vuepress-theme-reco 升级为 **VitePress 2.0** 架构。
## Experience
## 架构升级规划
**npx**
- 保留原有 Markdown 文章内容与静态资源,不删除历史页面。
- 使用 VitePress 2.0 替代 VuePress 1,减少主题耦合并提升启动、热更新与构建速度。
- 将站点配置迁移到 `docs/.vitepress/config.mts`,统一维护导航、侧边栏、搜索、页脚与最后更新时间。
- 将原 VuePress 首页转换为 VitePress Home Layout,并补充文档站升级说明。
- 保留旧的 `docs/.vuepress` 目录作为历史迁移参考,新架构运行时使用 `docs/.vitepress`
```
npx @vuepress-reco/theme-cli init my-blog
## 目录结构
```text
docs/
index.md # VitePress 首页
README.md # 原首页内容保留
timeLine/
index.md # VitePress 时间线入口
README.md # 原时间线内容保留
views/other/guide.md # Jiscuss 文档正文
public/ # VitePress 静态资源
.vitepress/ # VitePress 2.0 配置与主题扩展
.vuepress/ # VuePress 1 历史配置保留
```
**npm**
## 开发
```bash
# init
npm install @vuepress-reco/theme-cli -g
theme-cli init my-blog
# install
cd my-blog
npm install
# run
npm run dev
# build
npm run build
```
**yarn**
```bash
# init
yarn global add @vuepress-reco/theme-cli
theme-cli init my-blog
# install
cd my-blog
yarn install
# run
yarn dev
# build
yarn build
```
开发服务默认监听 `0.0.0.0`,便于本机或容器环境访问。
## 构建
```bash
yarn build
yarn preview
```
构建产物输出到项目根目录的 `public/`,与原 VuePress 构建产物目录保持一致,便于沿用已有部署方式。
## Jiscuss 简介
Jiscuss 是一个简单、轻量、开源的 Java 论坛项目,目标是在简单易用的前提下提供发帖、回帖、用户管理、评论等论坛基础能力。
## License
[MIT](https://github.com/chuyaoyuan)