---
name: 视角与术语
desc: Sirno 作为工具与此自托管 Lake 之间面向读者的区分。
category:
  - meta-zh
  - concept-zh
belongs:
  - narrative-zh
refines:
  - project-self-application-zh
---

Sirno 的自应用创建了一个视角问题。

`Sirno` 可以命名工具和模型。
它也可以出现在此仓库内，
Sirno 在此用自身模型描述自身。
两种读法都为真，
但混杂的语言会让读者困惑一句话是描述通用工具，
还是这个自托管文档。

此 Lake 通过稳定的视角标签解决歧义。
用 `Sirno` 指代工具和项目模型。
用 `a Sirno-managed project` 指代任何应用 Sirno 的项目。
用 `this repository` 指代 Sirno 的实现工作区。
用 `this lake` 指代 `sirno-docs/`，
即描述 Sirno 的自托管 Sirno Lake。

Sirno 特定术语在作为 Sirno 专有名称一部分出现时大写，
如 Sirno Lake 或 Sirno Frost。
否则，当它们承载 Sirno 特定含义时小写并斜体：
*lake*、*entry*、*witness*、*frost*、*ripple*、*transform*、*monograph*
和 *repository*。
当不承载 Sirno 结构时，通用词保持普通：
项目、文档、读者、历史、变更、评审和工作。

这种区分让普通项目散文保持普通。
当文档说"项目文档"时，
它可能指普通仓库中的文档。
当它说"the *lake*"时，
读者进入了 Sirno 的模型。
当它说"this *lake*"时，
读者正在看 Sirno 在 `sirno-docs/` 中的自应用。

本仓库现在在主要路线中应用该约定。
介绍在要求读者跟随条目之前先命名本仓库和此 Lake。
方法论告诉贡献者在编辑前使用哪种视角。
项目自应用解释了为什么递归形式存在，
以及术语如何使其可读。

[generated-footer-zh]: generated-footer-zh.md "Generated Footer"

---

> **Sirno generated links begin. Do not edit this section.**

- belongs (to):
  - [narrative-zh](narrative-zh.md)
- belongs (from): (none)

> **Sirno generated links end.**
