V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
推荐关注
Meteor
JSLint - a JavaScript code quality tool
jsFiddle
D3.js
WebStorm
推荐书目
JavaScript 权威指南第 5 版
Closure: The Definitive Guide
dou4cc
V2EX  ›  JavaScript

markdown 用得不顺手,自己 diy 了个替代品

  •  1
     
  •   dou4cc · 2016-08-29 14:48:51 +08:00 · 5603 次点击
    这是一个创建于 3012 天前的主题,其中的信息可能已经有所发展或是发生改变。

    https://github.com/dou4cc/drool
    欢迎发 issue 。

    第 1 条附言  ·  2016-08-30 19:49:58 +08:00
    想把 drool 用在自己网站上的找我,我阉一部分功能,做成兼容版给你。
    34 条回复    2016-08-31 19:56:46 +08:00
    latyas
        1
    latyas  
       2016-08-29 14:51:13 +08:00
    markdown 都用的不顺手了啊。
    lzhazha
        2
    lzhazha  
       2016-08-29 14:52:04 +08:00
    openvpn 被墙了怎么办。有解没有。

    日志提示: openvpn tcp recv error:connection reser by peer


    VPN 板块没人看。。。
    ss098
        3
    ss098  
       2016-08-29 15:20:45 +08:00 via Android
    @lzhazha 无解。
    loniper
        4
    loniper  
       2016-08-29 15:29:29 +08:00
    唉,所以啊,谁也别吐槽谁,你们这群程序员不也是闲的蛋疼,重复造这么多轮子
    xy19009188
        5
    xy19009188  
       2016-08-29 15:40:40 +08:00
    你们这群程序员啊,别闲着没事老造轮子,没事多多扯扯淡
    int64ago
        6
    int64ago  
       2016-08-29 15:55:39 +08:00
    然而你的 README
    Seita
        7
    Seita  
       2016-08-29 15:56:59 +08:00   ❤️ 1
    做个 demo 不能先编译一下吗。。
    dou4cc
        8
    dou4cc  
    OP
       2016-08-29 15:59:30 +08:00
    @Seita @int64ago Babel 的编译不严谨,我恰好用到了它不支持的特性。
    zhidian
        9
    zhidian  
       2016-08-29 19:55:03 +08:00
    @loniper 看到一个恶心的工具就写一个更恶心的来恶心原作。这就是开源之滥。

    外, URL 的括号严格我觉得是一个良好的设计,格式不严谨,弄得各种 versatile ,真是很 sb ……

    外,看到你的源码: https://raw.githubusercontent.com/dou4cc/drool/gh-pages/demo.han.drool 我就醉了。

    外,“中文标点不会使用英文字体”这就叫对中文友好?,这明明就是设置一下 CSS 的设置,跟你的 drool 有什么关系。(在你的 CSS 里我啥都没看到)
    dou4cc
        10
    dou4cc  
    OP
       2016-08-29 21:22:56 +08:00
    @zhidian “中文标点不会使用英文字体”是需要 JS 辅助的
    dou4cc
        11
    dou4cc  
    OP
       2016-08-29 21:23:18 +08:00
    @zhidian 关键代码是那个 drool.js
    dou4cc
        12
    dou4cc  
    OP
       2016-08-29 21:30:10 +08:00
    @zhidian 直接看.drool 文件最好把 tab-size 调大,比如 80ch
    dou4cc
        13
    dou4cc  
    OP
       2016-08-29 21:30:56 +08:00
    @zhidian 直接看.drool 文件最好把 tab-size 调大,比如 25ch ……(刚刚手滑)
    HankAviator
        14
    HankAviator  
       2016-08-29 21:39:28 +08:00
    关注者寥寥啊
    zhidian
        15
    zhidian  
       2016-08-29 21:44:26 +08:00
    @dou4cc 80 ch (字符)?……哈哈。我的屏幕宽度要跪。我觉得你高估了用户的折腾愿意度。很多人是不可能专门为了看你的 demo ,去装个一个浏览器;去下载你的 .drool 文件然后调编辑器的 tab 宽度。

    (除了 Makefile 和自己的程序输出反正我是从不用 tab 的。)
    dou4cc
        16
    dou4cc  
    OP
       2016-08-30 10:50:28 +08:00
    @zhidian 是 25ch
    作为一个 JS 爱好者,我电脑上各种 nightly 级别的浏览器,外加启用了所有 flag
    goreliu
        17
    goreliu  
       2016-08-30 11:07:32 +08:00
    简单提个建议吧,主页的 README 还是整理一下格式吧,这个 README 怎么也看不出是一个会用 Markdown 的人写出来的。然后就只能关掉走人了。
    dou4cc
        18
    dou4cc  
    OP
       2016-08-30 11:24:09 +08:00
    @goreliu 你看一下吧
    goreliu
        19
    goreliu  
       2016-08-30 11:28:40 +08:00
    @dou4cc 如果要用一个列表,那么需要让别人清楚这个列表是在说什么事情。比如:

    drool 解决了如下问题:
    - aaa
    - bbb

    如果我对这个主题没兴趣,就直接跳过这一段。

    排版是让文字更容易被别人理解,如果不能达到这个目的,那么排版就没有什么意义了。
    goreliu
        20
    goreliu  
       2016-08-30 11:46:39 +08:00
    一个例子:

    ## drool

    drool 简介

    ### Markdown 存在的问题

    1. aaa
    2. bbb

    ### droop 的优势

    1. aaa
    2. bbb

    ### 效果演示

    ### 使用方法

    ### License

    MIT


    首先要把提纲列好,需要写几项内容,它们之间的递进关系。然后把具体的内容按合理的形式组织好。然后再考虑怎么断句能让内容呈现得更美观。最后考虑加亮某些关键内容等细节。这些不是只看 Markdown 的语法就可以掌握的。可以多看下一些软件主页的介绍、文章等。当你掌握了这些,才会真正发现 Markdown 的痛点,然后才可能提出切实可行的解决办法,需要循序渐进。
    woostundy
        21
    woostundy  
       2016-08-30 11:51:20 +08:00
    你的 demo 挂了吧?
    woostundy
        22
    woostundy  
       2016-08-30 11:55:07 +08:00
    我用的是 Chrome Canary , demo 打不开
    MrYELiex
        23
    MrYELiex  
       2016-08-30 13:23:41 +08:00
    洗洗睡吧
    dalei
        24
    dalei  
       2016-08-30 15:47:07 +08:00 via Android
    你没试过 org mode?
    UnknownR
        25
    UnknownR  
       2016-08-30 16:46:35 +08:00
    你的 README 让我头痛,非常像我刚开始写文档时的样子,各级之间毫无逻辑联系,看上去非常混乱, 19 与 20 楼已经讲的很清楚了,多级标题的使用应该规范,等真的了解之后你会发现 markdown 的便捷之处
    mikicomo
        26
    mikicomo  
       2016-08-30 16:56:27 +08:00
    既然 markdown 自称源码的可读性堪比可视化编辑,为什么我们还要把*something*编译成 something ?于是,我设计了 drool 。它没有加粗、斜体之类的功能(*something*的可读性就很好了,不是吗?),但可用缩进( drool 的缩进可用作表格)和右对齐表达文档结构,图片(音视频)、链接仍可插入。

    = = 根本读不通,,,木有加粗斜之类的功能?.....这个功能不重要?
    cllgeek
        27
    cllgeek  
       2016-08-30 17:33:03 +08:00
    为什么 markdown 都用不顺手呢??好奇怪
    dou4cc
        28
    dou4cc  
    OP
       2016-08-30 19:06:13 +08:00
    @woostundy 还要开两个 flag ,具体见 readme
    dou4cc
        29
    dou4cc  
    OP
       2016-08-30 19:10:14 +08:00
    @goreliu 内容不超过两千字我都不排版,毕竟只有扁平的逻辑才好排版,而且排版很烦……
    @UnknownR drool 有表示文档的层级关系的相关特性
    dou4cc
        30
    dou4cc  
    OP
       2016-08-30 19:11:59 +08:00
    @mikicomo 我的意思是要强调某个内容,不必斜体,直接在两旁加“*”又不会乱
    dou4cc
        31
    dou4cc  
    OP
       2016-08-30 19:16:40 +08:00
    @zhidian 仅当使用 drool 绘制表格时才需设置 tab-size 来使.drool 文件更有可读性
    vvard3n
        32
    vvard3n  
       2016-08-30 23:39:16 +08:00
    不排版我只能说你开心就好咯。。。
    Lycnir
        33
    Lycnir  
       2016-08-31 10:20:09 +08:00
    要理解 markup 的本质,当一个 markup 变得复杂的时候,那就它和 html 有何区别。
    然而,你们这群程序员在用 markdown ,我却在用 creole wiki( http://www.wikicreole.org/wiki/Creole1.0)
    dou4cc
        34
    dou4cc  
    OP
       2016-08-31 19:56:46 +08:00
    @Lycnir 我做的 drool 比 creole wiki 简洁
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   1106 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 24ms · UTC 22:44 · PVG 06:44 · LAX 14:44 · JFK 17:44
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.