我把开源 README 又改成英文了 - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
请不要在回答技术问题时复制粘贴 AI 生成的内容
LonnyWong
V2EX    程序员

我把开源 README 又改成英文了

  •  
  •   LonnyWong 2024-01-03 07:35:41 +08:00 5770 次点击
    这是一个创建于 650 天前的主题,其中的信息可能已经有所发展或是发生改变。
    两年前,当我开源 trzsz ( trz / tsz ) 时,我是用英文写 README 的,虽然我的英文水平不怎么样。

    但我发现 trzsz 的用户基本都是华人,老外都不怎么用 rz sz 的样子,可能是环境和习惯的问题吧。

    去年我开源 trzsz-ssh ( tssh ) 时,我用中文写 README 了,因为我觉得用户主要会是华人,老外用户可能不多。

    昨晚我把 tssh 的 README 改成英文了,因为我在 Reddit 上发现,支持的人好像比反对的人多一些。

    https://github.com/trzsz/trzsz-ssh
    34 条回复    2024-01-03 18:46:44 +08:00
    blankmiss
        1
    blankmiss  
       2024-01-03 08:12:05 +08:00
    你写两份不就行了
    LonnyWong
        2
    LonnyWong  
    OP
       2024-01-03 08:14:05 +08:00
    @blankmiss 有写两份,但 GitHub 不支持根据用户自动展示对应语言的,默认值还是一份。
    bianhui
        3
    bianhui  
       2024-01-03 08:16:53 +08:00   1
    有没有一种情况,一个 README 同时写两种语言。我之前就写过。
    Noicdi
        4
    Noicdi  
       2024-01-03 08:19:35 +08:00 via iPhone   1
    @LonnyWong #2 把中文 readme 的链接放在英文 readme 的最上面,这样进去可以一眼看见
    wangfeng3769
        5
    wangfeng3769  
       2024-01-03 08:46:34 +08:00
    https://www.heroku.com/ 看看这个可行否。
    wangfeng3769
        6
    wangfeng3769  
       2024-01-03 08:47:12 +08:00
    发错了,看了楼主的主题挺好的。
    LonnyWong
        7
    LonnyWong  
    OP
       2024-01-03 08:48:05 +08:00
    @bianhui @Noicdi 扩展了 openssh 的部分,保留了中文与链接。主体是英文,往下翻一下会看到表格内有一点中文。
    SiLenceControL
        8
    SiLenceControL  
       2024-01-03 08:49:14 +08:00
    现在的挺棒的啊
    就算华人用 github 了 基本英语还是能读的一般
    ltkun
        9
    ltkun  
       2024-01-03 08:54:38 +08:00 via Android
    膜拜大佬 顺便问一下安卓的 termux 咋安装 apt 没有 go 安装连不上...
    LonnyWong
        10
    LonnyWong  
    OP
       2024-01-03 08:58:52 +08:00
    @SiLenceControL 是的,一般都能读懂。一些新增的功能保留中文就好,因为我写的英文未必准确,可能会让人费解。
    LonnyWong
        11
    LonnyWong  
    OP
       2024-01-03 08:59:55 +08:00
    @ltkunhttps://github.com/trzsz/trzsz-ssh/releases 下载,解压就能用了。
    giter
        12
    giter  
       2024-01-03 09:04:26 +08:00
    我认为用英文才有那种感觉(并没有抨击中文的不好),潜意识里用英文撰写的 readme 可能项目或者代码的质量更高(再次强调没有抨击中文)
    LonnyWong
        13
    LonnyWong  
    OP
       2024-01-03 09:12:47 +08:00
    @giter 因为常见的优秀开源项目几乎都是英文的有中文也会配个英文,特别是希望老外参与共建时。可能翻墙这种有特色的会不同。
    blinue
        14
    blinue  
       2024-01-03 09:19:07 +08:00
    @Noicdi #4 同意,老外用户多的话 README 最好英语,然后在显眼的方法放上中文版本链接
    sloknyyz
        15
    sloknyyz  
       2024-01-03 09:29:21 +08:00
    开头给个中文链接不就行了
    Shiroka
        16
    Shiroka  
       2024-01-03 09:29:24 +08:00 via iPhone   1
    可以参考下这种 readme ,就是 #14 说的显眼的地方放上中文文档链接

    https://github.com/iyear/tdl/blob/master/README.md
    https://github.com/iyear/tdl/blob/master/README_zh.md
    dji38838c
        17
    dji38838c  
       2024-01-03 09:34:42 +08:00
    英文不好的话,用 chatgpt 给你改下就可以了
    LonnyWong
        18
    LonnyWong  
    OP
       2024-01-03 09:36:54 +08:00
    @Shiroka 这种跳到 source code 去了,如果能在 repo 首页就更好了,最好是根据用户浏览器的语言自动切换,不过 GitHub 不支持。
    LonnyWong
        19
    LonnyWong  
    OP
       2024-01-03 09:38:49 +08:00
    @dji38838c 很多时候 ChatGPT 写的,我自己读起来感觉不满意,好像没有准确地表达我想要的意思。
    dapang1221
        20
    dapang1221  
       2024-01-03 09:41:35 +08:00
    支持,经常上 github 的基本都能读懂英文的 README ,但让老外看方块字可能就要了他们命了。。我有时看到一些小项目的日文韩文俄文 README 头都大了
    LonnyWong
        21
    LonnyWong  
    OP
       2024-01-03 09:43:25 +08:00
    @dapang1221 确实,我看其他语种也是。
    lisxour
        22
    lisxour  
       2024-01-03 10:04:17 +08:00   1
    没必要纠结默认是什么语言,以下两种都是非常好的做法

    1. 项目标题 + 语言切换
    2. 项目标题 + 双语项目描述(简短的) + 右上角语言切换

    ysmood
        23
    ysmood  
       2024-01-03 10:49:26 +08:00 via Android
    还是依赖了 ssh-agent 服务吗?也就是如果没装 ssh 就没法用 agent 吗?
    huajia2005
        24
    huajia2005  
       2024-01-03 10:55:23 +08:00
    trzsz 的作者吗,很感谢,这个项目用着很好用
    LonnyWong
        25
    LonnyWong  
    OP
       2024-01-03 10:56:57 +08:00
    @ysmood #23 openssh 提供了很多个软件,包括:
    - ssh
    - sshd
    - ssh-keygen
    - ssh-agent
    - scp
    - sftp
    - ssh-keyscan
    - sftp-server

    tssh 只实现了 ssh ( 客户端 )的常用功能,支持连接到 ssh-agent ,但要求安装有 openssh 的 ssh-agent 。
    LonnyWong
        26
    LonnyWong  
    OP
       2024-01-03 10:58:16 +08:00
    @huajia2005 #24 You are welcome.
    luwang
        27
    luwang  
       2024-01-03 10:59:56 +08:00
    像这种的就挺好的,默认英文,在顶部写一下 [中文版]
    66beta
        28
    66beta  
       2024-01-03 11:13:51 +08:00
    reddit...反贼大本营啊,没有参考价值吧
    LonnyWong
        29
    LonnyWong  
    OP
       2024-01-03 11:19:45 +08:00
    @66beta 他们很少到技术节点,用英文聊天吧?
    Nriver
        30
    Nriver  
       2024-01-03 14:05:14 +08:00
    @Shiroka 参考上面的项目,我也给我的项目加了中英文的切换链接,感谢你提供的信息
    LieNoWell
        31
    LieNoWell  
       2024-01-03 14:22:08 +08:00
    更喜欢中文一些,IDE 和 github 都装了中文插件,是不是比较奇怪?不过真的降低了心智负担。



    github 汉化插件用的油猴:GitHub 中文化插件
    lstz
        32
    lstz  
       2024-01-03 14:32:14 +08:00 via iPhone
    我的项目也是用英文写的,毕竟从一开始就打算走国际化路线,但后期应该也会同时维护一份中文 README ,方便国内用户阅读

    https://github.com/work7z/LafTools
    huangliu
        33
    huangliu  
       2024-01-03 17:47:51 +08:00
    我也是启动项目的时候,就想着要给全球的人用,所以英文默认(我英文也很烂,只能借助翻译用个 Chinglish...)
    但是还很少去海外的社区宣传,所以基本知道这项目的和提 issue 都是国内的伙伴..
    顺便问下 reddit 还适合做这些开源项目,软件产品的宣传吗

    https://github.com/tiny-craft/tiny-rdm
    LonnyWong
        34
    LonnyWong  
    OP
       2024-01-03 18:46:44 +08:00
    @huangliu 很久以前去 Reddit 和 Hacker News 分享过两三次,直接就沉了,一点水花都没有。这次 Hacker News 也是直接沉了,Reddit 是有人吵起来了,然后一天后也沉了。
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     1524 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 27ms UTC 16:36 PVG 00:36 LAX 09:36 JFK 12:36
    Do have faith in what you're doing.
    ubao snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86