开源项目的英文版 readme 都是怎么写的

2024-03-17 19:26:11 +08:00
 csznet2023

各位大佬的都是直接自己翻译的吗

有没有自动化翻译的工具呢

另外,默认 readme 我看很多都是默认英文,这有什么说法吗,我现在的都是默认中文的

2690 次点击
所在节点    程序员
14 条回复
sunorhc
2024-03-17 19:36:39 +08:00
想写英文的时候直接写,不用翻译。写不来的话现在直接让 gpt 翻译就行了。
给中国人看就写中文,给外国人看就写英文呗。
noahlias
2024-03-17 19:43:02 +08:00
chenliangngng
2024-03-17 19:43:26 +08:00
补个英文版,也不复杂好吗,都是一些专业词汇和套句,抄别家的换掉关键词就好了

问题在于你真有必要整一份英文版吗
foolishcrab
2024-03-17 20:00:06 +08:00
@chenliangngng 正常技术类的项目英文自然流量都远大于中文,所以其实很有必要。当然 md 开源啥的就算了
cnbatch
2024-03-17 20:05:10 +08:00
现在有 chatgpt ,翻译起来容易多了

至于哪个语言用作主要语言,视乎受众而定,主要面对华人就用中文然后附近英文文档链接,要不然就英文文档附加中文版链接

要是懂其他语言,比如日语、韩语,也可以一起写上
yuezk
2024-03-17 21:09:02 +08:00
找一个同类型的英文项目,模仿着写
iGuo
2024-03-17 22:38:39 +08:00
一般一句话或者几句话介绍核心功能,然后是安装方式,基本使用方式,完整文档,贡献者文档,开源协议,贡献者等等。多找朋友帮忙读读给点反馈,再根据需要修改即可。
chaunceywe
2024-03-17 23:27:50 +08:00
https://github.com/othneildrew/Best-README-Template 先用中文照着这个模版写一遍,然后再用 gpt 润色一遍。
hauibojek
2024-03-18 08:45:16 +08:00
默认英文,然后加个中文文档链接。
zhangjiashu2023
2024-03-18 08:53:26 +08:00
翻译首先 chatgpt
zhangjiashu2023
2024-03-18 08:53:41 +08:00
翻译首选 chatgpt
rookie2luochao
2024-03-18 09:17:28 +08:00
找一个热门开源项目,把它的 readme 拷贝过来抄着写🤔
lstz
2024-03-18 11:46:52 +08:00
自动化翻译这个我特意自己造了个轮子,可以参考我的开源项目 LafTools ,翻译模板 devtools/docs-generator/files/*.md

我用英语写,然后 bing translation 为 18 门语言翻译,当然这过程中还是需要微调的,我也写了一个配置文件去转换,基本维护成本很低。

https://github.com/work7z/LafTools
ben666
2024-03-20 08:21:24 +08:00
参考有一些知名的 github readme 模板项目,如 https://github.com/othneildrew/Best-README-Template
也可以参考一下我的项目 https://github.com/baidu/dperf/ ,中英文 readme 都有
尤其注意 license 标识 放在醒目的位置

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/1024495

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX