Bamboo China

以墨与纸为语言的 Obsidian 主题 — 白纸为心，黛青为框。

设计理念

• 墨与纸：动效取法「卷轴舒展」—— 轻微的过冲、从容的节奏，绝不仓促（品牌曲线 cubic-bezier(0.34, 1.56, 0.64, 1)）。
• 白纸为心、黛青为框：编辑区始终纯净如纸，侧栏与面板承载意境色调。
• 字体优先 CJK 可读：SF Pro → PingFang SC / Hiragino Sans GB / Microsoft YaHei，在中文与拉丁文之间取得平衡。
• 适度圆角与密度：利落而不冰冷。

核心特性

• 10 套东方意境配色：通过 Style Settings 一键切换，明/暗双基底通用；配色由单一数据源生成，跨平台外观完全一致。
• 默认「宣纸竹青」调色板：明亮清爽的浅色基底，配以竹青点缀；深色模式作为可选基底，而非主题性格本身。
• 平台细节自适应：在 macOS 呈现 Cupertino 细节 —— 红绿灯窗口控件、标签头装饰、无框布局；其他平台回退为中性跨平台外观。形状有细微的 mac ↔ 非 mac 之分，颜色 100% 由意境驱动、与平台无关。
• Style Settings 深度可调：意境配色、侧栏与面板展开、标签页样式、状态栏、图片缩放、链接样式、动画速度、字号与图标大小等 22 项开关与滑块。
• 无障碍：默认调色板与每一套意境配色均通过 WCAG 对比度校验；统一的 :focus-visible 焦点环；尊重 prefers-reduced-motion 与 prefers-contrast。
• 多脚本友好：中文、英文、日文、韩文及其他书写系统同样适用。

意境配色一览

安装

主题已提交至 Obsidian 官方社区主题列表。在 Obsidian 中：

1. 设置 → 外观 → 主题 → 管理 → 社区主题浏览
2. 搜索 Bamboo China
3. 点击「使用」，并在 Style Settings 插件中按需微调

自定义

大部分视觉调整都可通过 Style Settings（需安装社区插件 Style Settings）完成，无需改代码：

• 意境配色：切换 10 套东方意境主题
• 侧栏 / 面板：悬停功能区、侧边栏标签、状态栏
• 标签页与链接：左对齐标签页、简约标签、链接样式
• 字体与密度：界面字号、标准字号、图标大小、行间距
• 无障碍：减少动画、标准字号、高亮链接颜色

仓库结构

src/                  主题源码（Sass）
  app/                全局 token 与基础组件样式
  elements/           Bamboo China 表层细化
  color-schemes/     默认调色板 + 10 套意境配色（生成）
  layouts/            布局 token
  features/          可选特性模块
scripts/             构建与护栏脚本（mood 生成、对比度校验、体积校验）
theme.css            编译产物
manifest.json        主题清单
versions.json        版本映射

构建：npm run build（生成 mood token → 编译压缩 CSS → 校验 mood 一致性）。

基于 / 鸣谢

本主题派生自 Cupertino 主题（作者 aaaaalexis，基于 MIT 许可证）。原主题的版权声明随附于 LICENSE。

许可

MIT © 2025 aaaaalexis, © 2026 羽鳞君

English

Design Philosophy

• Ink & Paper: Motion follows the rhythm of a scroll unfurling — gentle overshoot, unhurried cadence (signature curve cubic-bezier(0.34, 1.56, 0.64, 1)).
• Rice-Paper Heart, Indigo Frame: The editor canvas stays clean as paper; sidebars and panels carry the mood-tinted accent.
• CJK-First Typography: SF Pro → PingFang SC / Hiragino Sans GB / Microsoft YaHei, balanced for both Chinese and Latin scripts.
• Thoughtful Radius & Density: Crisp without feeling cold.

Core Features

• 10 Eastern Mood Palettes: Switch via Style Settings; shared light/dark skeleton, generated from a single data source for cross-platform consistency.
• Default "Rice-Paper Bamboo-Green" Palette: Bright, clean light base with bamboo-green accents. Dark mode is an optional base, not the theme's identity.
• Platform-Adaptive Details: macOS gets Cupertino touches — traffic-light window controls, tab-bar ornament, frameless layout. Other platforms fall back to a neutral cross-platform look. Subtle mac ↔ non-mac shape differences; colors are 100% mood-driven and platform-agnostic.
• Rich Style Settings: 13 class toggles + 9 sliders covering mood palettes, sidebar/panel expansion, tab style, image zoom, link styling, animation speed, font size, and icon size.
• Accessibility First: Every palette passes WCAG contrast validation; unified :focus-visible focus ring; respects prefers-reduced-motion and prefers-contrast.
• Multi-Script Friendly: Works for Chinese, English, Japanese, Korean, and other writing systems.

Installation

Available on the Obsidian Community Theme Store:

1. Settings → Appearance → Themes → Manage → Browse Community Themes
2. Search Bamboo China
3. Click "Use" and fine-tune via the Style Settings plugin

Customization via Style Settings

• Mood Palette: 10 Eastern mood themes
• Sidebar & Panels: Hover ribbon, sidebar tabs, status bar
• Tabs & Links: Left-aligned tabs, unstyled tags, link styles
• Typography & Density: UI font size, standard font size, icon size, line height
• Accessibility: Reduce motion, standard font size, highlight link colors

Credits

Derived from Cupertino by aaaaalexis (MIT). Original copyright notice included in LICENSE.

License

MIT © 2025 aaaaalexis, © 2026 羽鳞君