V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
LonnyWong
V2EX  ›  程序员

我把开源 README 又改成英文了

  •  
  •   LonnyWong · 335 天前 · 5184 次点击
    这是一个创建于 335 天前的主题,其中的信息可能已经有所发展或是发生改变。
    两年前,当我开源 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  
       335 天前
    你写两份不就行了
    LonnyWong
        2
    LonnyWong  
    OP
       335 天前
    @blankmiss 有写两份,但 GitHub 不支持根据用户自动展示对应语言的,默认值还是一份。
    bianhui
        3
    bianhui  
       335 天前   ❤️ 1
    有没有一种情况,一个 README 同时写两种语言。我之前就写过。
    Noicdi
        4
    Noicdi  
       335 天前 via iPhone   ❤️ 1
    @LonnyWong #2 把中文 readme 的链接放在英文 readme 的最上面,这样进去可以一眼看见
    wangfeng3769
        5
    wangfeng3769  
       335 天前
    https://www.heroku.com/ 看看这个可行否。
    wangfeng3769
        6
    wangfeng3769  
       335 天前
    发错了,看了楼主的主题挺好的。
    LonnyWong
        7
    LonnyWong  
    OP
       335 天前
    @bianhui @Noicdi 扩展了 openssh 的部分,保留了中文与链接。主体是英文,往下翻一下会看到表格内有一点中文。
    SiLenceControL
        8
    SiLenceControL  
       335 天前
    现在的挺棒的啊
    就算华人用 github 了 基本英语还是能读的一般
    ltkun
        9
    ltkun  
       335 天前 via Android
    膜拜大佬 顺便问一下安卓的 termux 咋安装 apt 没有 go 安装连不上...
    LonnyWong
        10
    LonnyWong  
    OP
       335 天前
    @SiLenceControL 是的,一般都能读懂。一些新增的功能保留中文就好,因为我写的英文未必准确,可能会让人费解。
    LonnyWong
        11
    LonnyWong  
    OP
       335 天前
    @ltkunhttps://github.com/trzsz/trzsz-ssh/releases 下载,解压就能用了。
    giter
        12
    giter  
       335 天前
    我认为用英文才有那种感觉(并没有抨击中文的不好),潜意识里用英文撰写的 readme 可能项目或者代码的质量更高(再次强调没有抨击中文)
    LonnyWong
        13
    LonnyWong  
    OP
       335 天前
    @giter 因为常见的优秀开源项目几乎都是英文的有中文也会配个英文,特别是希望老外参与共建时。可能翻墙这种有特色的会不同。
    blinue
        14
    blinue  
       335 天前
    @Noicdi #4 同意,老外用户多的话 README 最好英语,然后在显眼的方法放上中文版本链接
    sloknyyz
        15
    sloknyyz  
       335 天前
    开头给个中文链接不就行了
    Shiroka
        16
    Shiroka  
       335 天前 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  
       335 天前
    英文不好的话,用 chatgpt 给你改下就可以了
    LonnyWong
        18
    LonnyWong  
    OP
       335 天前
    @Shiroka 这种跳到 source code 去了,如果能在 repo 首页就更好了,最好是根据用户浏览器的语言自动切换,不过 GitHub 不支持。
    LonnyWong
        19
    LonnyWong  
    OP
       335 天前
    @dji38838c 很多时候 ChatGPT 写的,我自己读起来感觉不满意,好像没有准确地表达我想要的意思。
    dapang1221
        20
    dapang1221  
       335 天前
    支持,经常上 github 的基本都能读懂英文的 README ,但让老外看方块字可能就要了他们命了。。我有时看到一些小项目的日文韩文俄文 README 头都大了
    LonnyWong
        21
    LonnyWong  
    OP
       335 天前
    @dapang1221 确实,我看其他语种也是。
    lisxour
        22
    lisxour  
       335 天前   ❤️ 1
    没必要纠结默认是什么语言,以下两种都是非常好的做法

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

    ysmood
        23
    ysmood  
       335 天前 via Android
    还是依赖了 ssh-agent 服务吗?也就是如果没装 ssh 就没法用 agent 吗?
    huajia2005
        24
    huajia2005  
       335 天前
    trzsz 的作者吗,很感谢,这个项目用着很好用
    LonnyWong
        25
    LonnyWong  
    OP
       335 天前
    @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
       335 天前
    @huajia2005 #24 You are welcome.
    luwang
        27
    luwang  
       335 天前
    像这种的就挺好的,默认英文,在顶部写一下 [中文版]
    66beta
        28
    66beta  
       335 天前
    reddit...反贼大本营啊,没有参考价值吧
    LonnyWong
        29
    LonnyWong  
    OP
       335 天前
    @66beta 他们很少到技术节点,用英文聊天吧?
    Nriver
        30
    Nriver  
       335 天前
    @Shiroka 参考上面的项目,我也给我的项目加了中英文的切换链接,感谢你提供的信息
    MrSheng
        31
    MrSheng  
       335 天前
    更喜欢中文一些,IDE 和 github 都装了中文插件,是不是比较奇怪?不过真的降低了心智负担。



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

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

    https://github.com/tiny-craft/tiny-rdm
    LonnyWong
        34
    LonnyWong  
    OP
       335 天前
    @huangliu 很久以前去 Reddit 和 Hacker News 分享过两三次,直接就沉了,一点水花都没有。这次 Hacker News 也是直接沉了,Reddit 是有人吵起来了,然后一天后也沉了。
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   1387 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 26ms · UTC 17:43 · PVG 01:43 · LAX 09:43 · JFK 12:43
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.