# 文档

> 欢迎阅读 Blockstudio 文档。

此文件列出了 https://blockstudio.dev/zh/docs/ 下的页面。整个网站的索引位于 https://blockstudio.dev/zh/llms.txt。

## 开始
- [简介](https://blockstudio.dev/zh/docs.md): 欢迎阅读 Blockstudio 文档。
- [快速入门](https://blockstudio.dev/zh/docs/general/getting-started.md): 开始搭建你的第一个 Blockstudio 项目。
- [设置](https://blockstudio.dev/zh/docs/general/settings.md): 通过 blockstudio.json 或筛选器配置 Blockstudio。
- [Composer](https://blockstudio.dev/zh/docs/dev/composer.md): 使用Composer安装Blockstudio。
- [翻译](https://blockstudio.dev/zh/docs/general/translations.md): 使用你的语言体验 Blockstudio，并帮助翻译它。

## 区块
- [注册](https://blockstudio.dev/zh/docs/blocks/registration.md): 了解如何使用 Blockstudio 注册自定义区块。
- [模式](https://blockstudio.dev/zh/docs/blocks/schema.md): JSON 为 Blockstudio 区块提供 Schema 支持。
- [覆盖](https://blockstudio.dev/zh/docs/blocks/overrides.md): 以精细的粒度覆盖区块。
- [Twig](https://blockstudio.dev/zh/docs/blocks/templating/twig.md): 为你的 Blockstudio 区块使用 Twig 模板。
- [Blade](https://blockstudio.dev/zh/docs/blocks/templating/blade.md): 为你的 Blockstudio 区块使用 Laravel Blade 模板。
- [常规 (区块 / Assets)](https://blockstudio.dev/zh/docs/blocks/assets.md): 为区块自动加入队列并处理 CSS、SCSS 和 JavaScript 文件。
- [注册资源](https://blockstudio.dev/zh/docs/blocks/assets/registering.md): 自动为区块加入 CSS 和 JavaScript 文件的队列。
- [处理资源](https://blockstudio.dev/zh/docs/blocks/assets/processing.md): 压缩、SCSS 编译及 ES 模块支持。
- [代码字段资源](https://blockstudio.dev/zh/docs/blocks/assets/code-field.md): 通过代码字段生成动态资源区块。
- [注册属性](https://blockstudio.dev/zh/docs/blocks/attributes/registering.md): 了解如何为区块注册自定义属性。
- [字段类型](https://blockstudio.dev/zh/docs/blocks/attributes/field-types.md): Blockstudio 中所有可用字段类型及其属性。
- [自定义字段类型](https://blockstudio.dev/zh/docs/blocks/attributes/custom-field-types.md): 注册自定义编辑器控件和结构化属性值。
- [自定义字段](https://blockstudio.dev/zh/docs/blocks/attributes/custom-fields.md): Blockstudio 区块的可重复使用字段定义。
- [区块字段](https://blockstudio.dev/zh/docs/blocks/attributes/block-field.md): 将另一个区块引用为字段，并以内联方式展开其属性。
- [筛选属性](https://blockstudio.dev/zh/docs/blocks/attributes/filtering.md): 使用 PHP 钩子筛选并修改区块属性。
- [渲染属性](https://blockstudio.dev/zh/docs/blocks/attributes/rendering.md): 在区块模板中访问属性值。
- [区块属性](https://blockstudio.dev/zh/docs/blocks/attributes/block-attributes.md): 访问对齐和排版等标准 WordPress 区块属性。
- [HTML 实用工具](https://blockstudio.dev/zh/docs/blocks/attributes/html-utilities.md): 将属性值渲染为数据属性或 CSS 变量。
- [存储](https://blockstudio.dev/zh/docs/blocks/storage.md): 将字段值存储在不同位置，例如文章元数据或选项中。
- [扩展编辑器](https://blockstudio.dev/zh/docs/blocks/attributes/expanded-editor.md): 当检查器侧边栏太窄时，可在更宽的抽屉面板中编辑 Blockstudio 字段。
- [条件逻辑](https://blockstudio.dev/zh/docs/blocks/attributes/conditional-logic.md): 根据条件显示或隐藏字段。
- [填充选项](https://blockstudio.dev/zh/docs/blocks/attributes/populating-options.md): 通过查询、函数或外部来源动态填充字段选项。
- [禁用属性](https://blockstudio.dev/zh/docs/blocks/attributes/disabling.md): 在保留属性值的同时临时禁用属性。
- [常规 (区块 / React Components)](https://blockstudio.dev/zh/docs/blocks/react-components.md): 在 PHP、Twig 或 Blade 模板中直接使用由 React 驱动的编辑器组件。
- [useBlockProps](https://blockstudio.dev/zh/docs/blocks/react-components/useblockprops.md): 使编辑器与前端的标记保持一致。
- [内部区块](https://blockstudio.dev/zh/docs/blocks/react-components/innerblocks.md): 允许在自定义区块中嵌套其他区块。
- [富文本](https://blockstudio.dev/zh/docs/blocks/react-components/richtext.md): 直接在区块模板中添加可编辑文本字段。
- [媒体占位符](https://blockstudio.dev/zh/docs/blocks/react-components/mediaplaceholder.md): 为区块添加媒体上传占位符。
- [变体](https://blockstudio.dev/zh/docs/blocks/variations.md): 创建具有不同默认属性值的区块变体。
- [转换](https://blockstudio.dev/zh/docs/blocks/transforms.md): 定义将区块转换为其他区块的方式。
- [预览](https://blockstudio.dev/zh/docs/blocks/preview.md): 在区块插入器中启用区块预览。
- [加载](https://blockstudio.dev/zh/docs/blocks/loading.md): 控制区块在编辑器中的加载方式。
- [SEO](https://blockstudio.dev/zh/docs/blocks/seo.md): 了解 Blockstudio 如何与 SEO 插件集成，实现实时内容分析。
- [环境](https://blockstudio.dev/zh/docs/blocks/environment.md): 根据渲染上下文有条件地渲染内容。
- [上下文](https://blockstudio.dev/zh/docs/blocks/context.md): 在区块模板中访问循环和文章上下文数据。
- [文章元数据](https://blockstudio.dev/zh/docs/blocks/post-meta.md): 在区块模板中访问文章元数据。
- [以编程方式渲染](https://blockstudio.dev/zh/docs/blocks/rendering.md): 通过 PHP 函数或 HTML 标签，以编程方式渲染 Blockstudio 区块。
- [组件](https://blockstudio.dev/zh/docs/blocks/components.md): 用于以编程方式渲染的非编辑器区块。
- [UI 组件](https://blockstudio.dev/zh/docs/blocks/ui-components.md): 捆绑提供的 bsui 组件库、其背后的设计系统，以及如何为其设置主题。
- [岛屿](https://blockstudio.dev/zh/docs/blocks/islands.md): 将区块拆分为缓存安全的占位内容和客户端渲染片段。
- [交互性](https://blockstudio.dev/zh/docs/blocks/interactivity.md): 在区块中使用 WordPress 交互性 API，为其添加响应式客户端行为。
- [初始化](https://blockstudio.dev/zh/docs/blocks/block-api/initialization.md): 在 WordPress 初始化期间执行代码。
- [RPC](https://blockstudio.dev/zh/docs/blocks/block-api/rpc.md): 通过轻量级 RPC 系统从前端调用服务器端 PHP 函数，灵感来自 tRPC。
- [数据库](https://blockstudio.dev/zh/docs/blocks/block-api/database.md): 为你的区块定义数据模型，并自动生成 CRUD 端点、验证数据并支持多种存储后端。
- [Cron](https://blockstudio.dev/zh/docs/blocks/block-api/cron.md): 使用 WordPress Cron 为每个区块定义计划后台任务。
- [PHP 钩子](https://blockstudio.dev/zh/docs/blocks/hooks/php.md): PHP 中可用的过滤器和操作：Blockstudio。
- [JavaScript 钩子](https://blockstudio.dev/zh/docs/blocks/hooks/javascript.md): JavaScript 中可用的过滤器和操作：Blockstudio。
- [Tailwind CSS](https://blockstudio.dev/zh/docs/tailwind.md): 服务器端Tailwind CSS编译，自动缓存。
- [扩展](https://blockstudio.dev/zh/docs/extensions.md): 为任何已注册区块扩展自定义属性。

## 页面和样式模式
- [常规 (页面和样式模式 / File Templates)](https://blockstudio.dev/zh/docs/pages-and-patterns.md): 通过文件模板创建 WordPress 页面和区块样板，并自动解析区块。
- [页面](https://blockstudio.dev/zh/docs/pages-and-patterns/pages.md): 通过文件模板创建 WordPress 页面，并以明确且适合部署的方式同步。
- [图案](https://blockstudio.dev/zh/docs/pages-and-patterns/patterns.md): 从文件模板创建 WordPress 区块样式。
- [站点模板](https://blockstudio.dev/zh/docs/pages-and-patterns/site-templates.md): 从 Blockstudio 文件创建 WordPress 站点编辑器模板和模板部件。
- [钩子](https://blockstudio.dev/zh/docs/pages-and-patterns/template-hooks.md): PHP 筛选器和操作适用于页面、样式、站点模板和 HTML 解析器。
- [内容同步](https://blockstudio.dev/zh/docs/content-sync.md): 通过将允许列表中的 WordPress 记录投影到可移植文件中，把数据库内容加入 Blockstudio 的文件优先工作流。

## 生产环境
- [性能](https://blockstudio.dev/zh/docs/production/performance.md): 生产环境前端默认值、内置分析器和底层渲染技术。
- [静态预渲染](https://blockstudio.dev/zh/docs/production/static-prerendering.md): 将匿名页面作为静态HTML提供，并可选择在WordPress启动前提供。
- [缓存](https://blockstudio.dev/zh/docs/production/caching.md): 唯一的文件缓存目录，管理所有生成的运行时资源。
- [媒体](https://blockstudio.dev/zh/docs/production/media.md): 稳定图像尺寸、延迟加载和媒体元数据清单。

## 开发
- [代码片段](https://blockstudio.dev/zh/docs/code-snippets.md): 使用 Blockstudio 以文件优先的方式管理代码片段。
- [管理](https://blockstudio.dev/zh/docs/dev/admin.md): 检查已注册的 Blockstudio 区块、浏览注册表，并在 wp-admin 中查看数据库记录。
- [画布](https://blockstudio.dev/zh/docs/dev/canvas.md): 面向 Blockstudio 内容的可视化工作区和公共清单 API。
- [元素抓取器](https://blockstudio.dev/zh/docs/dev/grab.md): 内置元素检查器，可用于识别前端的区块模板文件。
- [CLI](https://blockstudio.dev/zh/docs/dev/cli.md): 通过WP-CLI命令行管理Blockstudio区块、页面、数据库、RPC和cron。
- [PHPStan](https://blockstudio.dev/zh/docs/dev/phpstan.md): 为 Blockstudio 项目提供静态分析，支持类型安全的模板、架构验证和 hook 检查。
- [AI 集成](https://blockstudio.dev/zh/docs/dev/ai.md): 为编码代理提供可寻址的文档索引，并为你自己的项目生成契约。
- [逻辑发现源](https://blockstudio.dev/zh/docs/dev/discovery-sources.md): 为Blockstudio发现和运行时缓存提供组合后的文件清单。
- [WPML](https://blockstudio.dev/zh/docs/dev/wpml.md): 生成 WPML 语言配置，让 Blockstudio 区块的文本字段可翻译。
- [迁移到 v7](https://blockstudio.dev/zh/docs/dev/migration/v7.md): Blockstudio 7 的重大变更和迁移步骤。

## 可选
- [一个文件中的 文档](https://blockstudio.dev/zh/docs/llms-full.txt): /docs/ 下每个页面的 Markdown 源码，633 KB，约 109,000 个令牌
- [网站索引](https://blockstudio.dev/zh/llms.txt): Blockstudio 的每个页面