Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion packages/docs/CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -262,7 +262,9 @@ disabled meant every landing section below the fold was invisible permanently.

The site is dressed in ranui's design system. `packages/ranui/docs/DESIGN.md` is the spec;
§11 ("Composition — the page, not the component") is the part that governs pages rather than
widgets, and every rule in it came from a failure on this site.
widgets, and every rule in it came from a failure on this site. §12 ("Information
architecture") sits one level above it: which shape a dense page should take before any of
§11 arranges it.

`pnpm -F docs verify:design` runs ranui's checker over `styles/` against
`design-baseline.json`, which is a **ratchet**: a violation count that rises fails as a new
Expand Down
1 change: 1 addition & 0 deletions packages/docs/build/langs/messages/cn.ts
Original file line number Diff line number Diff line change
Expand Up @@ -173,6 +173,7 @@ const cn: LocaleMessages = {
foundations: '基础能力',
design_system: '设计系统',
design_guidelines: '设计规范',
information_architecture: '信息架构',
coding_guidelines: '编码规范',
theming: 'Theme 主题系统',
themeswitch: '主题切换',
Expand Down
1 change: 1 addition & 0 deletions packages/docs/build/langs/messages/de.ts
Original file line number Diff line number Diff line change
Expand Up @@ -173,6 +173,7 @@ const de: LocaleMessages = {
foundations: 'Grundlagen',
design_system: 'Designsystem',
design_guidelines: 'Designrichtlinien',
information_architecture: 'Informationsarchitektur',
coding_guidelines: 'Coding-Richtlinien',
theming: 'Theming',
themeswitch: 'Theme-Umschalter',
Expand Down
1 change: 1 addition & 0 deletions packages/docs/build/langs/messages/en.ts
Original file line number Diff line number Diff line change
Expand Up @@ -173,6 +173,7 @@ const en: LocaleMessages = {
foundations: 'Foundations',
design_system: '',
design_guidelines: '',
information_architecture: '',
coding_guidelines: '',
theming: 'Theming',
themeswitch: '',
Expand Down
1 change: 1 addition & 0 deletions packages/docs/build/langs/messages/es.ts
Original file line number Diff line number Diff line change
Expand Up @@ -173,6 +173,7 @@ const es: LocaleMessages = {
foundations: 'Fundamentos',
design_system: 'Sistema de diseño',
design_guidelines: 'Guía de diseño',
information_architecture: 'Arquitectura de información',
coding_guidelines: 'Guía de código',
theming: 'Temas',
themeswitch: 'Cambio de tema',
Expand Down
1 change: 1 addition & 0 deletions packages/docs/build/langs/messages/fa.ts
Original file line number Diff line number Diff line change
Expand Up @@ -173,6 +173,7 @@ const fa: LocaleMessages = {
foundations: 'پایه‌ها',
design_system: 'سیستم طراحی',
design_guidelines: 'راهنمای طراحی',
information_architecture: 'معماری اطلاعات',
coding_guidelines: 'راهنمای کدنویسی',
theming: 'پوسته',
themeswitch: 'تعویض پوسته',
Expand Down
1 change: 1 addition & 0 deletions packages/docs/build/langs/messages/ja.ts
Original file line number Diff line number Diff line change
Expand Up @@ -173,6 +173,7 @@ const ja: LocaleMessages = {
foundations: '基盤',
design_system: 'デザインシステム',
design_guidelines: 'デザインガイドライン',
information_architecture: '情報アーキテクチャ',
coding_guidelines: 'コーディング規約',
theming: 'テーマ',
themeswitch: 'テーマ切り替え',
Expand Down
1 change: 1 addition & 0 deletions packages/docs/build/langs/messages/ko.ts
Original file line number Diff line number Diff line change
Expand Up @@ -173,6 +173,7 @@ const ko: LocaleMessages = {
foundations: '기반',
design_system: '디자인 시스템',
design_guidelines: '디자인 가이드',
information_architecture: '정보 구조',
coding_guidelines: '코딩 가이드',
theming: '테마',
themeswitch: '테마 전환',
Expand Down
1 change: 1 addition & 0 deletions packages/docs/build/langs/messages/pt.ts
Original file line number Diff line number Diff line change
Expand Up @@ -173,6 +173,7 @@ const pt: LocaleMessages = {
foundations: 'Fundamentos',
design_system: 'Design system',
design_guidelines: 'Diretrizes de design',
information_architecture: 'Arquitetura da informação',
coding_guidelines: 'Diretrizes de código',
theming: 'Temas',
themeswitch: 'Alternador de tema',
Expand Down
6 changes: 6 additions & 0 deletions packages/docs/build/langs/structure.ts
Original file line number Diff line number Diff line change
Expand Up @@ -540,6 +540,12 @@ export const SIDEBAR: Record<string, SidebarNode[]> = {
items: [
{ kind: 'suffix', key: 'design_system', name: 'Design system', link: '/src/ranui/design-system/' },
{ kind: 'suffix', key: 'design_guidelines', name: 'Design guidelines', link: '/src/ranui/design-guides/' },
{
kind: 'suffix',
key: 'information_architecture',
name: 'Information architecture',
link: '/src/ranui/information-architecture/',
},
{ kind: 'suffix', key: 'coding_guidelines', name: 'Coding guidelines', link: '/src/ranui/coding-guides/' },
{ kind: 'full', key: 'theming', link: '/src/ranui/theme/' },
{ kind: 'suffix', key: 'themeswitch', name: 'ThemeSwitch', link: '/src/ranui/theme-switch/' },
Expand Down
1 change: 1 addition & 0 deletions packages/docs/cn/src/ranui/design-guides/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ description: '用 ranui 做界面的设计规范:先定角色再由令牌给

本页讲的是**取舍**:该用哪个令牌、上线前该检查什么。令牌清单本身在
[设计系统](/cn/src/ranui/design-system/),运行时切换与覆盖在[主题系统](/cn/src/ranui/theme/)。
在这一切之前,页面该是什么形状,在[信息架构](/cn/src/ranui/information-architecture/)。
这些规则的完整、可机器校验版本在仓库里:
[`packages/ranui/docs/DESIGN.md`](https://github.com/chaxus/ran/blob/main/packages/ranui/docs/DESIGN.md)。

Expand Down
15 changes: 8 additions & 7 deletions packages/docs/cn/src/ranui/design-system/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,13 +8,14 @@ ranui 构建于其上的**设计语言**,以及表达这套语言的**完整**
`--ran-*` 自定义属性,都附上它在明暗两套主题下的取值。组件读的是这些令牌而不是写死的数值,所以覆盖
一个令牌就能改变所有用到它的地方。

三个页面回答三个不同的问题,刻意拆开:

| 页面 | 回答 |
| ---------------------------------------- | ------------------------ |
| **设计系统**(本页) | 令牌**是什么**,即词汇表 |
| [设计规范](/cn/src/ranui/design-guides/) | 做界面时**如何取舍** |
| [主题系统](/cn/src/ranui/theme/) | 运行时**如何切换与覆盖** |
四个页面回答四个不同的问题,刻意拆开:

| 页面 | 回答 |
| --------------------------------------------------- | ------------------------ |
| **设计系统**(本页) | 令牌**是什么**,即词汇表 |
| [设计规范](/cn/src/ranui/design-guides/) | 做界面时**如何取舍** |
| [信息架构](/cn/src/ranui/information-architecture/) | 页面本身该是**什么形状** |
| [主题系统](/cn/src/ranui/theme/) | 运行时**如何切换与覆盖** |

> **适用场景**:需要查某个令牌的名字或取值(颜色角色、间距档位、图标尺寸、投影层级、缓动曲线),
> 或想理解这些阶梯为什么长这样。
Expand Down
Loading
Loading