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

249 天前
 csznet2023

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

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

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

2124 次点击
所在节点    程序员
14 条回复
sunorhc
249 天前
想写英文的时候直接写,不用翻译。写不来的话现在直接让 gpt 翻译就行了。
给中国人看就写中文,给外国人看就写英文呗。
noahlias
249 天前
chenliangngng
249 天前
补个英文版,也不复杂好吗,都是一些专业词汇和套句,抄别家的换掉关键词就好了

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

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

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

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

https://github.com/work7z/LafTools
ben666
246 天前
参考有一些知名的 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