用途:按 docs.typo3.org 标准创建和维护 TYPO3 扩展文档,使手册能在该站点渲染。
主要能力:提供从零搭建 Documentation/ 的工作流,生成 guides.xml 骨架(命名空间必须为 https://www.phpdoc.org/guides,否则 XML 合法但不渲染);用 scripts/extract-all.sh 与 scripts/analyze-docs.sh 提取并分析文档缺口;用 scripts/validate_docs.sh 校验、scripts/render_docs.sh 渲染 HTML。附带元素选择指南(literalinclude、code-block、confval、php:method、note/tip/warning、card-grid、tabs、figure 等)与多份参考文档(guides.xml、RST 语法、TYPO3 指令、截图、渲染、部署拦截等)。
使用方式:无 Documentation/ 时先创建目录并写入 guides.xml,再替换 TITLE 与版本号;随后运行提取、分析、校验、渲染脚本。查看文档时应渲染 HTML 而非原始 RST。
限制与规则:Settings.cfg 已被 guides.xml 取代,不再被读取;官方文档为准,冲突时以在线手册为准并报告偏差;UTF-8、4 空格缩进、LF、尽量 80 字符换行;CamelCase 文件名、句首大写标题;每个标题前加永久锚点;每个子目录含 Index.rst;图片用 PNG/AVIF 并带 :alt:;PHP 域中不用 ?Type/Type|null,改用 :returntype:;不使用 mailto:,改用 Issues/Discussions;Documentation/ 下放 .editorconfig。具体脚本参数与完整模板见技能目录内参考文件,资料未提供更多细节。