{"id":19978474,"url":"https://github.com/fiercex/freebsd-doc-cn","last_synced_at":"2026-03-03T23:03:08.010Z","repository":{"id":211407158,"uuid":"729050306","full_name":"fierceX/freebsd-doc-cn","owner":"fierceX","description":null,"archived":false,"fork":false,"pushed_at":"2024-09-18T03:12:03.000Z","size":92066,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-27T18:10:17.099Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://free.bsd-doc.org","language":"SCSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fierceX.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-12-08T09:44:29.000Z","updated_at":"2025-08-19T06:45:48.000Z","dependencies_parsed_at":"2023-12-08T10:34:21.768Z","dependency_job_id":"607a99c4-d49e-4125-ac99-052110459c5a","html_url":"https://github.com/fierceX/freebsd-doc-cn","commit_stats":null,"previous_names":["fiercex/atest","fiercex/freebsd-doc-cn"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fierceX/freebsd-doc-cn","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fierceX%2Ffreebsd-doc-cn","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fierceX%2Ffreebsd-doc-cn/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fierceX%2Ffreebsd-doc-cn/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fierceX%2Ffreebsd-doc-cn/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fierceX","download_url":"https://codeload.github.com/fierceX/freebsd-doc-cn/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fierceX%2Ffreebsd-doc-cn/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30064796,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-03T18:21:05.932Z","status":"ssl_error","status_checked_at":"2026-03-03T18:20:59.341Z","response_time":61,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-13T03:33:45.309Z","updated_at":"2026-03-03T23:03:07.988Z","avatar_url":"https://github.com/fierceX.png","language":"SCSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# freebsd 文档翻译计划\n\nfreebsd 官方文档的中文文档年久失修，由于 freebsd 官方文档使用的是 asciidoctor (.adoc) 格式文档，并且已经有 po4a 工具进行辅助翻译，所以目前该项目仍然使用该工具进行翻译，并且使用官方网站模板进行静态部署。  \n当前部署地址：[https://free.bsd-doc.org](https://free.bsd-doc.org)\n\n## 翻译流程\n\npo4a 可以将 asciidoctor 文档中的文本块进行提取，生成 po 文件，该文件只包含一对对需要翻译的文档块，屏蔽了格式细节（仍有少量格式出现在翻译块中），那么只需要对 po 文件进行翻译，然后再使用 po4a 工具对源文档进行还原翻译即可。po 文件可以采用翻译引擎的 api 进行自动机器翻译，加快翻译效率，人工只需要进行校对即可。\n\n1. 定期同步  \n   上游子模块在`Upstream`，定期对上游文档同步，将原始英文文档复制到website目录下，并且生成待翻译的 po 文件。\n2. 自动翻译  \n   对上一步生成的 po 文件，使用翻译存储器对 po 文件进行自动翻译，该步骤会将历史翻译过的译文直接进行翻译，并将处理后的 po 文件写入`zh-cn`目录中。\n3. 机器翻译  \n   使用机器翻译引擎，对待翻译的 po 文件进行翻译，并打上`fuzzy`标签，结果会写入源文件。\n4. 人工校验  \n   人工对`zh-cn`中的 po 文件进行校验，对带有`fuzzy`标记的文档对进行校对，若涉及到一些链接或不需要翻译的术语，可将`msgstr`中的内容置空，当一个文档对校对完毕时，删除其`fuzzy`标记。并进行PR。\n5. 自动构建部署  \n   github action会对文档进行自动部署，在目前部署中，会生成`自动翻译`语言选项的内容，该内容会将无校对带有`fuzzy`标记的文本也进行翻译显示。\n\n## 翻译进度\n\n|章节|自动翻译|第一轮校对|\n|-|-|-|\n|introduction|✅|✅|\n|preface|✅|✅|\n|第一部分|✅|✅|\n|parti|✅|✅|\n|introduction|✅|✅|\n|bsdinstall|✅|✅|\n|basics|✅|✅|\n|ports|✅|✅|\n|x11|✅|✅|\n|wayland|✅|✅|\n|network|✅|✅|\n|第二部分|✅|4/7|\n|partii|✅|✅|\n|desktop|✅|✅|\n|multimedia|✅||\n|kernelconfig|✅|✅|\n|printing|✅||\n|linuxemu|✅|✅|\n|wine|✅||\n|第三部分|✅|12/16|\n|partiii|✅|✅|\n|config|✅|✅|\n|boot|✅|✅|\n|security|✅|✅|\n|jails|✅|✅|\n|mac|✅|✅|\n|audit|✅|✅|\n|disks|✅|✅|\n|geom|✅||\n|zfs|✅|✅|\n|filesystems|✅|✅|\n|virtualization|✅||\n|l10n|✅||\n|cutting|✅|✅|\n|dtrace|✅|✅|\n|usb|✅||\n|第四部分|✅|5/7|\n|partiv|✅|✅|\n|serialcomms|✅|✅|\n|ppp-and-slip|✅||\n|mail|✅||\n|network-servers|✅|✅|\n|firewalls|✅|✅|\n|advanced-networking|✅|✅|\n|第五部分|✅|2/7|\n|partv|✅|✅|\n|mirrors|✅|✅|\n|bibliography|✅||\n|eresources|✅||\n|pgpkeys|✅||\n|glossary|✅||\n|colophon|✅||\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffiercex%2Ffreebsd-doc-cn","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffiercex%2Ffreebsd-doc-cn","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffiercex%2Ffreebsd-doc-cn/lists"}