Skip to content

新增 Yac 扩展文档的中文翻译 - #1059

Open
laruence wants to merge 2 commits into
php:masterfrom
laruence:translate-yac
Open

新增 Yac 扩展文档的中文翻译#1059
laruence wants to merge 2 commits into
php:masterfrom
laruence:translate-yac

Conversation

@laruence

Copy link
Copy Markdown
Member

概述

对照 doc-en 的 yac-docs-revision 分支(commit b2bb7d0),新增 Yac 扩展文档的中文翻译,共 15 个 XML 文件:

  • 顶层页:book(扩展简介,含无锁语义与适用边界说明)、setup(需求、安装、资源)、ini(7 个运行时配置项)、constants(预定义常量)
  • 类页:yac.xml(Yac 类)
  • 方法页 ×10:construct、add、set、get、getter、setter、delete、flush、info、dump(签名、参数、返回值、示例、See Also 均已翻译)

未翻译的文件及原因

  • versions.xml:带 <?do-not-translate?> 指令,由脚本自动维护
  • configure.xml:在 doc-en 中未被任何实体引用(孤儿文件,英文手册中不渲染)

说明

  • 每个文件头部已标注 EN-Revision,便于追踪上游变更
  • 翻译源是 doc-en 中修订过的版本:方法签名已对照扩展源码修正(如 Yac::get 移除了不存在的 &$cas 参数、Yac::deletettl 参数实为 delay),并补充了可运行示例

校验

  • doc-base configure.php --with-lang=zh 校验通过
  • phd 本地渲染抽查通过(签名、版本条、See Also 链接、setup 子页面均正常)

对照 doc-en yac-docs-revision 分支(b2bb7d0)翻译了 Yac 扩展的
15 个 XML 文件:book、setup、ini、constants、yac 类页,以及
add/set/get/construct/delete/getter/setter/flush/info/dump
共 10 个方法页。

- versions.xml 带 <?do-not-translate?> 指令,由脚本自动维护,未翻译
- configure.xml 在 doc-en 中未被任何实体引用(孤儿文件),未翻译
- 每个文件头部标注 EN-Revision,便于后续追踪上游变更
- 已通过 doc-base configure.php --with-lang=zh 校验与本地渲染抽查
此前误将英文修订分支的提交写进了文件头,而 CI 要求
指向 doc-en master 上各文件的最新提交:
- 13 个修订文件:1a42637(上游合并提交,PR #5794)
- constants.xml:86e6094e(Use canonical type names)
- yac.xml:4d17b7b4(DocBook 5.2 标记转换)

文件内容无需变动(与上游合并版本逐一 diff 确认一致)。
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant