Logo
RavenSaaS Docs

博客系统

博客概述

RavenSaaS 内置一套 CMS 系统,用于博客内容管理,支持多语言。通过可视化的管理后台,您可以轻松创建和管理博客内容。

配置 CMS

在使用博客功能之前,您需要先完成数据库配置和管理后台配置。

创建数据表

需要在数据库中创建存储博客内容的数据表:

data/install.sql
1CREATE TABLE posts (
2    id SERIAL PRIMARY KEY,
3    uuid VARCHAR(255) UNIQUE NOT NULL,
4    slug VARCHAR(255),
5    title VARCHAR(255),
6    description TEXT,
7    content TEXT,
8    created_at timestamptz,
9    updated_at timestamptz,
10    status VARCHAR(50),
11    cover_url VARCHAR(255),
12    author_name VARCHAR(255),
13    author_avatar_url VARCHAR(255),
14    locale VARCHAR(50)
15);

管理博客内容

1. 进入博客后台

访问博客管理后台查看博客列表(默认为空):

Terminal
1https://{your-domain}/admin/posts
进入博客后台
进入博客后台

2. 添加博客内容

博客的标题和访问路由(slug)必填,默认支持多语言,需要选择对应的语言。

添加博客内容
添加博客内容

同时支持AI生成博客内容(需要配置好AI)

同时支持AI生成博客内容(需要配置好AI)
同时支持AI生成博客内容(需要配置好AI)

3. 查看博客内容

打开博客路由,可以查看博客内容:

Terminal
1https://{your-domain}/{locale}/posts/{slug}
查看博客内容
查看博客内容

4. 查看博客列表

访问博客列表前台路由,可以看到在后台添加的博客内容:

Terminal
1https://{your-domain}/{locale}/posts
查看博客列表
查看博客列表

配置博客路由

默认的博客路由是 /posts,您可以根据需要自定义博客路由。

默认路由

博客列表

访问博客列表页面:

/{locale}/posts

博客详情

访问博客详情页面:

/{locale}/posts/{slug}

自定义路由

如果您想使用其他的博客路由,比如:

  • /blogs /blogs 访问博客列表
  • /blog/:slug /blog/:slug 访问博客详情

您需要添加自定义的文件夹,并参考 app/[locale]/posts 文件夹组织自定义的代码。

Terminal
1app/[locale]/
2├── blogs/
3│   ├── page.tsx          # 博客列表页
4│   └── [slug]/
5│       └── page.tsx      # 博客详情页
6└── blog/
7    └── [slug]/
8        └── page.tsx      # 另一种博客详情页路由

Last updated on 2025年1月5日