V2EX = way to explore
V2EX 是一个关于分享和探索的地方
Sign Up Now
For Existing Member  Sign In
爱意满满的作品展示区。
kancloud

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

  •  
  •   kancloud ·
    liu21st · Oct 24, 2015 · 5058 views
    This topic created in 3841 days ago, the information mentioned may be changed or developed.

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

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

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


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

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