docs: define interpreted runtime and typed resource presentation

This commit is contained in:
2026-10-08 00:55:00 +08:00
parent 941942c7e1
commit 861fef5ec0
19 changed files with 246 additions and 183 deletions
+4 -4
View File
@@ -1,6 +1,6 @@
# Endorphin 语言文档
Endorphin 是一门面向云原生应用的编程语言,使用统一的语言模型描述前端界面、数据结构和后端业务逻辑。开发者编写声明、表达式与调用关系,系统负责组织这些逻辑的执行。
Endorphin 是一门面向云原生应用的编程语言,使用统一的语言模型描述前端界面、数据结构和后端业务逻辑。开发者编写声明、表达式与调用关系,平台解释执行代码,客户端根据资源或调用结果的类型呈现内容。
## 阅读指南
@@ -16,7 +16,7 @@ Endorphin 是一门面向云原生应用的编程语言,使用统一的语言
2. [用户身份](guide/02-user-identity.md) — 唯一用户名、显示名、代码归属与访问身份。
3. [namespace](guide/03-namespaces.md) — key、层级和可见代码视图。
4. [程序结构与导入](guide/04-program-structure.md) — 声明组织、外部上下文和 use。
5. [Preflight 与 inflight](guide/05-preflight-and-inflight.md) — 构建与执行阶段的职责。
5. [Preflight 与 inflight](guide/05-preflight-and-inflight.md) — 执行准备、检查与解释执行的职责。
### 第二部分:基础语法
@@ -28,7 +28,7 @@ Endorphin 是一门面向云原生应用的编程语言,使用统一的语言
### 第三部分:应用用法
10. [数据读取](guide/10-data-access.md) — 通过类型取得数据及结果状态。
11. [场景与渲染树](guide/11-scenes-and-render-trees.md) — scene、render、节点与嵌套。
11. [资源访问与呈现](guide/11-resource-access-and-presentation.md) — 查看函数、参数就绪、调用结果与按类型呈现。
12. [UI 组件](guide/12-ui-components.md) — Column、Row、Spacer 和 Text 的参数与效果。
## 附录
@@ -43,7 +43,7 @@ Endorphin 是一门面向云原生应用的编程语言,使用统一的语言
源码以 `endorphin` 代码块展示,文法以 `ebnf` 代码块展示。源码中的关键字和名称区分大小写;语言阶段名称固定为 `Preflight` 和 `inflight`。
“代码归属”写在代码块之前,用于说明外部上下文,不属于源码。函数体片段和渲染节点片段会注明使用位置。示例中的用户和 namespace 为示意名称。
“代码归属”写在代码块之前,用于说明外部上下文,不属于源码。函数体片段会注明使用位置,资源访问与界面结构示意使用 `text` 代码块,不表示新增源码语法。示例中的用户和 namespace 为示意名称。
正文的函数示例围绕商品定价展开:`alice:shop.pricing` 提供定价逻辑,`bob:shop.checkout` 组合它,`bob:shop.ui` 表达界面;数据读取示例使用 `alice:shop.data`。这些路径表示代码组织,不指定执行位置。