本页由繁体中文版自动转换
Diátaxis 文件四型
Diátaxis 用两条轴拆开：读者在做还是在想、在学还是在用，推出四型：tutorial、how-to、reference、explanation。
核心主张是四型各有其职，写法不要互相渗透；框架不规定实作形式，要不要拆成不同档案是使用者自己的取舍。
一、发生什么事
Procida 在 Divio 任职期间（2014 至 2021）发表过这套想法的早期版本，他后来自认其中部分看错，其后独立为 diataxis.fr 持续打磨[1]Procida, D. Diátaxis. 两轴推导、Divio 时期与 2021 年之说明已对照原站核实。（diataxis.fr）。primary 站三页（主页、foundations、colophon）核对：四型名称与词源逐字对上；早期版本于 Divio 任职期（2014–2021）发表，Procida 后来自认其中部分看错；「2021」指 Software Sustainability Institute fellowship，非首发年；采用广度为站方自述，未经第三方验证。。推导不是任意分类：读者处境沿两条轴分化，实作（knowing-how）对认知（knowing-that），学习时对工作时，二乘二落出四型，每型服务一种需求、各有独立写作准则。tutorial 是学习中的实作引导，how-to 是工作中的达成步骤，reference 是工作中查资讯，explanation 是学习中求理解。混写的失败形态每个人都见过：一份「教学」开头教操作、中段变参数表、结尾写设计哲学，每种读者都要跳读。
二、为什么这对你重要
判断一份文件该不该拆，先问读者此刻在哪个象限，而不是问内容属于哪个主题。放在本站的知识系统设计框架里，这是三个常被混答的问题之一：东西放哪（组织法的事）、怎么找回来（导航的事）、写成什么型（本框架的事）。三问正交，混答互相拖累。延伸到个人笔记是本站的做法，不是框架的规定：我们把写给自己的操作手册与概念解释分成两份档案，因为两者更新节奏不同、失效方式不同。框架本身要的是同一段文字不混用两种需求，不规定拆档[1]Procida, D. Diátaxis. 两轴推导、Divio 时期与 2021 年之说明已对照原站核实。（diataxis.fr）。primary 站三页（主页、foundations、colophon）核对：四型名称与词源逐字对上；早期版本于 Divio 任职期（2014–2021）发表，Procida 后来自认其中部分看错；「2021」指 Software Sustainability Institute fellowship，非首发年；采用广度为站方自述，未经第三方验证。。
Lab 实测 有实证才写
本节点暂无实测。
如何阅读来源注记 「对照原站核实」指主张已与该项目的原始网站比对。 定义版本：2026-09-20。
- [1] Procida, D. Diátaxis. https://diataxis.fr/ 两轴推导、Divio 时期与 2021 年之说明已对照原站核实。（早期版本于 Divio 任职期 2014–2021 发表）. ↩