Skip to content

Conversation

@SoonIter
Copy link
Member

@SoonIter SoonIter commented Jan 12, 2026

Summary

Related Issue

Checklist

  • Tests updated (or not required).
  • Documentation updated (or not required).

AI Summary

Add documentation for the Callout component in both English and Chinese.

Changes Made

  • Created website/docs/en/ui/components/callout.mdx
  • Created website/docs/zh/ui/components/callout.mdx

Documentation Contents

  1. Container Syntax - The recommended way to use callouts, supporting all types (note/tip/info/warning/danger/details) with custom titles
  2. Component Usage - Direct import via import { Callout } from '@rspress/core/theme-original' for MDX files
  3. Customization - How to eject and customize the component via npx rspress eject Callout
  4. Props - TypeScript interface definition for CalloutProps

Why

The Callout component is an eject-only component that powers the container syntax (:::tip, :::warning, etc.). Users who want to customize its appearance need documentation on:

  • How to use it (both via container syntax and direct import)
  • How to eject and customize it
  • The available props and types

This PR was written using Vibe Kanban


Copilot AI review requested due to automatic review settings January 12, 2026 13:14
@netlify
Copy link

netlify bot commented Jan 12, 2026

Deploy Preview for rspress-v2 ready!

Name Link
🔨 Latest commit 0dfa10d
🔍 Latest deploy log https://app.netlify.com/projects/rspress-v2/deploys/6965c3a4a9e9f70008db966d
😎 Deploy Preview https://deploy-preview-2998--rspress-v2.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@SoonIter SoonIter changed the title 增加 Callout 组件的文档 (vibe-kanban) docs: add Callout component documentation Jan 12, 2026
@github-actions
Copy link
Contributor

github-actions bot commented Jan 12, 2026

Rsdoctor Bundle Diff Analysis

Found 3 projects in monorepo, 3 projects with changes.

📊 Quick Summary
Project Total Size Change
node 9.9 MB 📈 +131.7 KB (+1.3%)
web 15.7 MB +31.0 KB (0.2%)
node_md 1.3 MB +9.9 KB (0.8%)
📋 Detailed Reports (Click to expand)

📁 node

Path: website/doc_build/diff-rsdoctor/node/rsdoctor-data.json

📌 Baseline Commit: 86250fc1d1 | PR: #2995

Metric Current Baseline Change
📊 Total Size 9.9 MB 9.8 MB +131.7 KB (+1.3%)
📄 JavaScript 0 B 0 B 0
🎨 CSS 0 B 0 B 0
🌐 HTML 9.9 MB 9.8 MB +131.7 KB (+1.3%)
📁 Other Assets 0 B 0 B 0

📦 Download Diff Report: node Bundle Diff

📁 web

Path: website/doc_build/diff-rsdoctor/web/rsdoctor-data.json

📌 Baseline Commit: 86250fc1d1 | PR: #2995

Metric Current Baseline Change
📊 Total Size 15.7 MB 15.6 MB +31.0 KB (0.2%)
📄 JavaScript 15.0 MB 14.9 MB +27.7 KB (0.2%)
🎨 CSS 126.3 KB 126.3 KB 0
🌐 HTML 0 B 0 B 0
📁 Other Assets 584.1 KB 580.9 KB +3.3 KB (0.6%)

📦 Download Diff Report: web Bundle Diff

📁 node_md

Path: website/doc_build/diff-rsdoctor/node_md/rsdoctor-data.json

📌 Baseline Commit: 86250fc1d1 | PR: #2995

Metric Current Baseline Change
📊 Total Size 1.3 MB 1.3 MB +9.9 KB (0.8%)
📄 JavaScript 0 B 0 B 0
🎨 CSS 0 B 0 B 0
🌐 HTML 0 B 0 B 0
📁 Other Assets 1.3 MB 1.3 MB +9.9 KB (0.8%)

📦 Download Diff Report: node_md Bundle Diff

Generated by Rsdoctor GitHub Action

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This pull request adds comprehensive documentation for the Callout component in both English and Chinese. The Callout component is used to display highlighted information blocks such as tips, warnings, and notes.

Changes:

  • Added English documentation for the Callout component (website/docs/en/ui/components/callout.mdx)
  • Added Chinese documentation for the Callout component (website/docs/zh/ui/components/callout.mdx)
  • Documents both container syntax usage (recommended) and direct component usage in MDX files
  • Includes customization instructions via component ejection

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
website/docs/en/ui/components/callout.mdx English documentation for the Callout component, including usage examples, customization guide, and Props interface
website/docs/zh/ui/components/callout.mdx Chinese documentation for the Callout component, providing the same content as the English version in Chinese

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@SoonIter SoonIter requested a review from Timeless0911 January 13, 2026 03:38
@SoonIter SoonIter force-pushed the syt_vk/acda-callout branch from 2beb671 to 02c0b52 Compare January 13, 2026 03:38
@SoonIter SoonIter enabled auto-merge (squash) January 13, 2026 03:38
Timeless0911
Timeless0911 previously approved these changes Jan 13, 2026
@SoonIter
Copy link
Member Author

@copilot 执行 npx heading-case --write 然后提交

Copy link
Contributor

Copilot AI commented Jan 13, 2026

@SoonIter I've opened a new pull request, #2999, to work on those changes. Once the pull request is ready, I'll request review from you.

SoonIter and others added 5 commits January 13, 2026 12:01
- `website/docs/en/ui/components/callout.mdx`
- `website/docs/zh/ui/components/callout.mdx`

文档内容包括:
1. **容器语法** - 推荐方式,展示所有类型(note/tip/info/warning/danger/details)和自定义标题
2. **组件用法** - 通过 `import { Callout } from '@rspress/core/theme-original'` 直接使用
3. **自定义** - 通过 `npx rspress eject Callout` 导出并自定义
4. **Props** - 组件的类型定义
**新增文件:**
- `website/docs/en/fragments/container-syntax.mdx` - 英文容器语法示例
- `website/docs/zh/fragments/container-syntax.mdx` - 中文容器语法示例

**修改文件:**
- `website/docs/en/guide/use-mdx/container.mdx` - 使用 `<ContainerSyntax />` fragment
- `website/docs/zh/guide/use-mdx/container.mdx` - 使用 `<ContainerSyntax />` fragment
- `website/docs/en/ui/components/callout.mdx` - 使用 `<ContainerSyntax />` fragment
- `website/docs/zh/ui/components/callout.mdx` - 使用 `<ContainerSyntax />` fragment

现在 container.mdx 和 callout.mdx 共享同一个 fragment,避免了重复内容。
Co-authored-by: copilot-swe-agent[bot] <[email protected]>
Co-authored-by: SoonIter <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants