翻译 GDB 官方文档

翻译 GDB 官方文档项目地址官方文档地址下载源码包编译html运行翻译程序项目地址https://github.com/shootercheng/gdb-translate.git项目结构$ tree-L1.├── cmd ├── go.mod ├── input ├── internal ├── LICENSE ├── output ├── README.md ├── sys_prompt.md └── testsinput 文件夹输入的原始英文html根据 gdb 源码生成的output 文件夹存放调用大模型翻译后生成的中文 HTML 文件。这些文件是机器翻译的初稿可能存在不准确或生硬之处欢迎社区成员审阅、修正并提交合并请求Pull Request来共同完善。项目简介gdb-translate是一个旨在将 GNU 调试器 (GDB) 官方文档英文实现自动化翻译的工具项目。GDB 是 Linux/Unix 系统下强大的源代码级调试器但其官方手册内容庞大对中文开发者存在一定的语言门槛。本项目通过结合大模型 API 与本地处理尝试为中文社区提供一份可读性更强的 GDB 文档。项目目标自动化翻译批量处理 GDB 官方 HTML 文档调用大模型服务生成中文初稿。保持结构确保翻译后的文档保持原有的章节结构、代码示例和超链接。社区共建生成的翻译初稿作为基础鼓励开发者根据专业知识进行校对、润色和术语统一最终产出高质量的本地化文档。如何参与贡献我们非常欢迎任何形式的贡献让这份文档变得更好代码贡献如果您熟悉 Go 语言、HTML 解析或网络请求可以查看项目的 Issues 列表修复 Bug 或实现新功能。文档校对这是最重要的环节即使不懂编程您也可以帮助我们。项目运行后会生成翻译后的.html文件您可以通读翻译内容修正明显的机器翻译错误。统一专业术语例如将 “breakpoint” 统一译为“断点”。优化句子使其更符合中文技术文档的表达习惯。反馈与建议在使用翻译文档或本项目过程中遇到任何问题或有好的想法都欢迎在 GitHub 仓库提交 Issue 进行讨论。贡献流程简述Fork 本仓库到您的 GitHub 账户。克隆您的 Fork 到本地创建新的分支进行修改。完成修改后提交代码并推送到您的仓库。向本仓库发起 Pull Request (PR)并描述您的修改内容。让我们共同努力降低 GDB 的学习门槛助力中文开发者社区官方文档地址https://sourceware.org/gdb/documentation/下载源码包https://ftp.gnu.org/gnu/gdb下载 https://ftp.gnu.org/gnu/gdb/gdb-17.2.tar.xz编译html检查环境,解决依赖,生成Makefile$ ./configure根据错误提示安装依赖$sudoaptupdate $sudoaptinstalllibgmp-dev libmpfr-dev texinfo编译html$makehtmlhtml 文档在 ${workdir}/gdb-17.2/gdb/doc/gdb 中生成~/gdb-17.2/gdb/doc/gdb$ls-lt|grep.html|wc-l866一共有866个html文件运行翻译程序安装环境变量加载工具$ goinstallgithub.com/joho/godotenv/cmd/godotenvlatest $ godotenv Run a process with anenvsetup from a .envfilegodotenv[-o][-f ENV_FILE_PATHS]COMMAND_ARGS ENV_FILE_PATHS: comma separated paths to .env files COMMAND_ARGS:commandand args you want to run example godotenv-f/path/to/something/.env,/another/path/.env fortune运行测试$ godotenv-f.env gotest./tests/... ok github.com/shootercheng/gdb-translate/tests/internal/request26.403s运行主程序$ godotenv-f.env go run ./cmd/main/main.go