1024 程序员节,看云来拯救你写文档的不容易! - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
爱意满满的作品展示区。
kancloud
V2EX    分享创造

1024 程序员节,看云来拯救你写文档的不容易!

  •  
  •   kancloud
    liu21st 2015-10-24 20:24:55 +08:00 4747 次点击
    这是一个创建于 3653 天前的主题,其中的信息可能已经有所发展或是发生改变。

    1024 ,看云来拯救程序员写文档的不容易!

    0x00 引言

    程序猿(程序媛)们除了每天写着改变世界的代码之外,还要不停的查手册、翻技术资料,完了还得写技术文档、 API 手册、用户手册,你们太不容易了, 1024 到了,有文档侠么?看云专门拯救程序员技术文档的不容易!

    0x01 看云是什么鬼

    看云是一个专注技术文档 /书籍的写作、电子出版和阅读的文档托管平台,上线测试半年来,我们得到了很多用户的反馈和建议,目前已经有超过 20000 个用户在看云上写了 6000 多个文档。

    所以首先尼,查手册、翻技术资料的问题就解决了,看云每天都会更新最新的技术文档哦(今天的干货在最后~)。

    至于写文档嘛,当然更是棒棒哒:

    • 采用 Markdown 格式,支持实时预览;
    • 文档版本库管理;
    • 离线写作和远程提交;
    • 团队协作和文档权限;
    • 文档绑定到自己域名;
    • 阅读页面导航和样式自定义;
    • 可选的阅读模板;
    • 快速生成 API 文档,支持在线调试;
    • 文档导出 PDF/EPUB/WORD 格式;
    • 文档评论、关注和分享;
    • 更多的功能正坐着火箭赶来...;

    0x02 如何拯救

    快点说重点,如何拯救吧!不要随便糊弄程序员~

    闲话不多说了,今天是1024 程序员节,且看文档侠打算如何拯救你。

    看云君正式宣布看云文档实施免费服务计划,从现在开始,除了私有文档数量限制外,包括之前需要专业版才能使用的看云文档功能全部免费使用!全部免费使用!全部免费使用(重要的事情说三遍)!尼玛,以后不就可以免费写文档了么?

    我是文档侠,专门拯救程序员写文档的不容易!
    gitbook+readme 程序员秒懂!
    祝可爱的程序员们节日快乐!
    不仅代码写的 NB ,文档也写的棒棒哒!

    为了拯救程序员,为了推进国内技术文档 /书籍的写作业态和做出高逼格的产品,我们也是拼了,相信看云一定会是你值得拥有的技术文档 /书籍的写作、阅读和托管平台。

    还拯救不了?那我找隔壁的产品狗聊天去~

    0x03 干货结尾

    不能就这样结束了,太不道德了,好不容易来一趟不能白来不是,最后看云君给大家补点干货吧:

    数据结构与算法 /leetcode/lintcode 题解
    Go 入门指南
    禅与 Objective-C 编程艺术
    PHP 之道(中文版)
    编程之法:面试和算法心得
    笨办法学 Python
    Node 入门
    GotGitHub
    GitHub 秘籍(中文版)
    Docker 从入门到实践
    The Linux Command Line 中文版
    重拾 CSS 的乐趣
    程序员的奋斗史

    还想要,自己去[ 广场 ] 撸吧~

    26 条回复    2015-11-08 07:44:34 +08:00
    ob
        1
    ob  
       2015-10-24 20:30:01 +08:00
    为什么不 lookcloud.com ?
    username10086
        2
    username10086  
       2015-10-24 20:32:20 +08:00
    @ob 戳中了痛处
    哈哈 其实域名没什么 想法发展的好就 OK ,我觉得 首先 logo 要重新设计一下
    LWXYFER
        3
    LWXYFER  
       2015-10-24 21:27:57 +08:00
    嗯,支持看云。。。。。。。。。挺好的。
    lx19930805
        4
    lx19930805  
       2015-10-24 21:30:00 +08:00
    好书,都收藏了
    lx19930805
        5
    lx19930805  
       2015-10-25 08:52:55 +08:00 via Android
    [笨办法学 Python],我还以为适合新手,没想到第一句话就是“ PowerShell 和 Terminal 的基本用法。学完后再回来看这本书吧。”
    这哪还笨啊
    kancloud
        6
    kancloud  
    OP
       2015-10-25 09:12:38 +08:00
    @username10086 感谢建议

    @ob 现在已经不是拼域名的时代了 并且创业不应该在前期投资在域名上 产品本身最重要

    @lx19930805 the hard way 系列的书 都还算不错其实 这里有个专题 http://www.kancloud.cn/special/the-hard-way
    lx19930805
        7
    lx19930805  
       2015-10-25 20:47:49 +08:00
    @kancloud 但是相比较,感觉"新手入门"专题里 Pytho 的更好吧?
    我还是个新手,算是零基础的。为此还要学“ PowerShell 和 Terminal ”,真是有点……


    还有几个 BUG 希望可以修复,
    1 。比如《 笨办法学 Python 》里的“安装和准备”,第一个链接竟然还连带中文,点击后就无法连接了。
    2 。比较严重的是,使用手机来阅读的话,轻轻划动一下就会往后跳一页或者往前跳一页,无法控制。而且使用返回键也无法返回,会自动跳回去。使用的是小米 2A
    kancloud
        8
    kancloud  
    OP
       2015-10-26 08:06:08 +08:00
    @lx19930805 新手入门也是看云为开发者精选的 第一个问题是 URL 地址自动链接的 BUG 第二个问题 手机端目前只是过渡下(或者导出离线阅读) 很快就会开发 app 了 以后手机阅读就用 app 了 哈哈
    youkochan
        9
    youkochan  
       2015-10-26 09:35:18 +08:00
    赞干货,已收藏
    hqs123
        10
    hqs123  
       2015-10-26 10:11:41 +08:00
    学到好东西,多谢分享。
    Xuanwo
        11
    Xuanwo  
       2015-10-27 09:14:03 +08:00
    中文 PDF 的质量感动, readthedoc 和 gitbook 生成的中文 PDF 简直。。
    kancloud
        12
    kancloud  
    OP
       2015-10-27 11:28:20 +08:00
    @Xuanwo ^_^ 这些都是细节,我们的 word 也比普通的导出要细致 (当然,目前 Word 还有一些兼容性问题 还不算完美) 。看云还在不断努力完善,离完美还有一个梦想的距离~
    lx19930805
        13
    lx19930805  
       2015-10-28 20:17:40 +08:00
    @kancloud 发现倒出来离线的,封面貌似都是马赛克.
    然后手机用 opera 欧朋浏览器,发现无法读取文档.无限加载
    kancloud
        14
    kancloud  
    OP
       2015-10-28 22:18:25 +08:00
    @lx19930805 封面马赛克的是因为作者上传的图片不够高清 opera 浏览器的问题 改天测试下 没有专门适配 目前已经在进行 app 的开发了 阅读还是 app 为主。
    niko
        15
    niko  
       2015-10-29 13:58:47 +08:00
    求提供 mobi 格式。
    recall704
        16
    recall704  
       2015-10-29 14:59:30 +08:00
    原来我想做的,有人已经在做了。
    只是和我想的,还差点。。。啥
    kancloud
        17
    kancloud  
    OP
       2015-10-29 16:17:40 +08:00
    @recall704 欢迎建议!

    @niko 会有的~
    recall704
        18
    recall704  
       2015-10-29 16:52:30 +08:00
    @kancloud
    当前文档的翻译存在一个问题,就是某些段落或语句翻译特别生硬,如果不看原文,你根本不知道在说啥,这就产生一个新的需求,就是文档能够 `中英对照` 一起看。
    kancloud
        19
    kancloud  
    OP
       2015-10-30 17:36:47 +08:00
    @recall704 嗯 文档翻译这块 是有一些细节的用户体验的 我们也在规划~
    flavoury
        20
    flavoury  
       2015-10-31 20:57:28 +08:00 via iPhone
    留个言 真心祝你们越做越好 现在已经在用啦
    kancloud
        21
    kancloud  
    OP
       2015-11-01 08:41:01 +08:00
    @flavoury 只要大家支持和建议 我们会越来越好的~ 细节和用户体验的改进也会慢慢完善的
    希望有更多的作者参与原创创作,付费阅读这块很快也会推出了~
    juo
        22
    juo  
       2015-11-02 13:16:17 +08:00
    @kancloud 你们的首页真独特!够简洁!
    kancloud
        23
    kancloud  
    OP
       2015-11-02 16:00:28 +08:00
    @juo 首页说再多也没用,只有用了才知道 ~
    lx19930805
        24
    lx19930805  
       2015-11-05 16:51:41 +08:00
    @kancloud 我觉得有必要审核一些文档。
    有些文档就挂个名,但是实际内容根本毫无用处,被当作一个保存途径来使用。可以搜索“ JS ”发现,基本上没有封面的,都是这样。
    又比如这个 http://www.kancloud.cn/k12_develop/Javascript/76967 ,空有名字,链接完全失效,点了没反应
    kancloud
        25
    kancloud  
    OP
       2015-11-05 17:20:59 +08:00
    @lx19930805 首先感谢你的建议。我主要说两点: 1 有些文档确实是出于测试行为或者还在写作过程中(因为作者需要熟悉下整个写作到发布的过程),但平台本身也会完善下,我们后面会增加一个文档的完成度标识并且改进下搜索算法~ 2 看云作为文档托管平台 要有一个边界,只要是合法的内容理论上不会禁止,但在广场中的文档都是必须经过推荐和审核的,并且在搜索结果和标签聚合列表中,我们都会标记该文档是否为推荐。
    kancloud
        26
    kancloud  
    OP
       2015-11-08 07:44:34 +08:00
    @lx19930805 你说的那个文档链接失效的原因 我看了下是因为文档是通过 chm 导入的,导入的内链是失效的 但后面翻页阅读是有效的~
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     2773 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 37ms UTC 06:45 PVG 14:45 LAX 23:45 JFK 02:45
    Do have faith in what you're doing.
    ubao msn 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