V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
爱意满满的作品展示区。
kancloud
V2EX  ›  分享创造

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

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

    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   ·   实用小工具   ·   5240 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 33ms · UTC 01:19 · PVG 09:19 · LAX 17:19 · JFK 20:19
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.