docs

docs/contributors/design/README.md

@@ -0,0 +1,61 @@
+# 设计贡献指南
+
+关于如何开始为古腾堡项目贡献设计力量的指南。
+
+## 讨论交流
+
+[WordPress设计博客](https://make.wordpress.org/design/)是获取WordPress设计团队最新资讯的主要平台，包含公告通知、产品目标、会议记录和议程安排等内容。
+
+设计相关的实时讨论在[WordPress官方Slack](https://make.wordpress.org/chat)的`#design`频道进行（需注册）。设计团队每周三UTC时间19:00举行例会。
+
+## 设计师如何参与贡献？
+
+古腾堡项目使用GitHub管理代码和跟踪问题。主代码库位于：[https://github.com/WordPress/gutenberg](https://github.com/WordPress/gutenberg)。
+
+若您希望参与设计或前端开发，欢迎处理标有[需要设计](https://github.com/WordPress/gutenberg/issues?q=is%3Aissue+is%3Aopen+label%3A%22Needs+Design%22)或[需要设计反馈](https://github.com/WordPress/gutenberg/issues?q=is%3Aissue+is%3Aopen+label%3A"Needs+Design+Feedback%22)标签的任务。我们期待您提供深思熟虑的回复、设计稿、动态演示、草图或手绘稿。建议的修改最好基于前期工作成果进行最小化且具体的迭代，以便对比参考。
+
+[WordPress设计团队](https://make.wordpress.org/design/)使用[Figma](https://www.figma.com/)进行协作与成果分享。若您希望参与贡献，请加入[Slack](https://make.wordpress.org/chat/)的[#design频道](https://wordpress.slack.com/messages/design/)，申请获取免费Figma账户。这将使您能够使用WordPress官方提供的实用[组件库](https://www.figma.com/file/ZtN5xslEVYgzU7Dd5CxgGZwq/WordPress-Components?node-id=0%3A1)。
+
+## 设计原则
+
+本章节将阐述编辑器界面的设计原则与模式——旨在说明设计背景、指导未来改进，并帮助人们设计出优秀的区块。
+
+<img width="200" src="https://raw.githubusercontent.com/WordPress/gutenberg/HEAD/docs/contributors/assets/gutenberg-logo-black.svg" alt="古腾堡标识" />
+
+古腾堡标识由[Cristel Rossignol](https://twitter.com/cristelrossi)设计，基于GPL协议发布。[下载SVG格式标识](https://raw.githubusercontent.com/WordPress/gutenberg/HEAD/docs/contributors/assets/gutenberg-logo-black.svg)。
+
+### 古腾堡的核心目标
+
+古腾堡的终极目标是打造直观易用的文章与页面编辑体验，让用户轻松创建丰富布局。区块编辑器是首款基于此内容创作方法论推出的产品。
+
+根据[项目启动宣言](https://make.wordpress.org/core/2017/01/04/focus-tech-and-design-leads/)：
+
+> 该编辑器致力于打造全新的页面与文章构建体验，让富媒体内容创作变得轻松自如，并通过“区块”功能简化当前需要短代码、自定义HTML或复杂嵌入操作才能实现的效果。
+
+我们可从中提炼出若干核心原则：
+
+-   **富媒体内容创作是WordPress的核心优势**
+-   **区块将在统一界面中整合功能与交互模式**：用户无需再使用短代码、自定义HTML或粘贴嵌入链接。只需掌握区块使用方法，即可解锁全部功能
+-   **提升核心功能的可发现性**：消除难以察觉的“隐藏功能”。WordPress支持大量区块和30余种嵌入类型，需增强其可见度
+
+### 设计初衷
+
+WordPress区别于其他系统的特质在于：只要用户掌握HTML和CSS并能构建自定义主题，即可实现无限可能的文章布局。
+
+古腾堡将编辑器重塑为直观工具，让用户无需技术背景即可通过简单点击创作富媒体内容、构建精美布局。WordPress将成为人人可用的强大灵活内容创作平台。
+
+### 愿景规划
+
+古腾堡致力于降低富媒体内容创作门槛。这意味着需要确保默认设置的合理性，将高级布局选项集成至区块中，并使核心操作触手可及。任何人都应能无障碍地使用WordPress创作内容。
+
+**WordPress站点的所有元素都将区块化**：无论是文本、图片、相册、小工具、短代码，还是通过插件添加的自定义HTML片段。用户仅需掌握区块界面这一种交互方式。
+
+**所有区块平等共存**：它们统一位于插入器界面中。通过最近使用记录、搜索功能、标签分类和分组管理，确保常用区块随时可用。
+
+**拖拽操作作为辅助**：为了更好的可访问性和平台兼容性，拖拽交互作为点击、跳转和空格等明确操作的增强功能存在。
+
+**占位符设计至关重要**：支持中性占位状态的区块都应实现该特性。图片占位区块显示媒体库入口按钮，文本占位区块呈现输入提示。通过占位符设计，我们可以预定义可编辑布局，用户只需填充内容即可。
+
+**直接操作符合直觉**：区块界面允许用户在页面上直接操控内容。插件和主题开发者将通过构建自定义区块来支持和扩展这种体验。
+
+**定制化无需代码编辑**：传统定制方式需要复杂标记语言，而复杂标记极易出错。古腾堡让定制过程更直观可靠。开发者可提供直接渲染布局片段的定制区块（例如三栏功能网格），并明确指定用户可直接编辑的部分。这意味着用户能自主更新文本、替换图片、调整栏数，无需寻求开发者帮助，也不必担心破坏布局。

docs/contributors/design/the-block.md

@@ -0,0 +1,30 @@
+# 区块即界面
+
+古腾堡编辑器的核心在于区块概念。从技术角度看，区块既将抽象层级从单一文档提升至有意义元素的集合，又通过明确结构取代了HTML与生俱来的模糊性。
+
+对用户而言，区块允许以更统一、更易用的方式直接向站点添加任意内容、媒体或功能。“添加区块”按钮使用户能在一个界面访问完整的功能库，无需反复翻查菜单或记忆短代码。
+
+但最重要的是，古腾堡基于_直接操作_原则构建——这意味着控制元素显示方式的核心选项都_在区块本身的语境中_完成操作。这相较于传统WordPress模式是重大变革，后者往往将选项深藏在多层导航菜单中，通过间接机制控制页面元素。
+
+例如用户可以在画布的区块界面内完成添加图片、编写图注、调整宽度版式、添加环绕链接等全套操作。这一原则同样适用于“导航菜单”等复杂区块，用户能够直接添加、编辑、移动并最终完成导航栏的完整呈现。
+
+-   用户仅需掌握区块这一种界面，即可编辑站点的所有内容。用户不必编写短代码、自定义HTML或理解隐藏机制来嵌入内容
+-   古腾堡让核心功能更易被发现，减少了难以寻觅的“神秘元素”。WordPress支持大量区块和30多种嵌入内容，现在让我们提升它们的可见度
+
+## 构建区块
+
+这对设计师和开发者意味着什么？区块结构加直接操作原则意味着需要以全新思路设计WordPress组件。让我们再次审视区块的架构：
+
+![古腾堡架构图](https://cldup.com/LQrPNubkJY.png)
+
+### 区块内容区是主要交互界面
+
+区块内容区的占位内容可视为引导用户执行操作指令或“填空”的界面指南（后续将详述占位符概念）。由于内容区直接对应网站实际呈现效果，此处的交互最贴合直接操作原则，也最符合用户直觉。这应被视为添加和操控内容、调整显示效果的主交互界面。
+
+### 区块工具栏承载无法融入占位界面的关键选项
+
+基础区块设置并非总能融入占位符/内容界面。作为次要选项，对区块功能至关重要的配置可置于区块工具栏。虽然区块工具栏与直接操作隔了一层，但仍保持高度情境化且全屏可见，因此是理想的次要选项。
+
+### 设置侧栏仅应用于高级三级控件
+
+设置侧栏在小屏/移动设备上默认隐藏，即使在桌面视图也可能被折叠。因此不应将区块基础运营的必要功能置于此处。选择合理的默认设置，将重要操作置于区块工具栏，把侧栏视作仅高级用户可能发现的拓展区域。