Jekyll 的 markdown 解析真是蛋疼啊 - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
domty
V2EX   Jekyll

Jekyll 的 markdown 解析真是蛋疼啊

  •  
  •   domty 2016-03-31 17:02:22 +08:00 11423 次点击
    这是一个创建于 3482 天前的主题,其中的信息可能已经有所发展或是发生改变。

    同一篇 markdown 文档,用 sublime 的 markdown preview 插件预览效果是正常的 结果发布到 jekyll 本地看效果,文档解析的一塌糊涂

    话说有招儿吗。

    我已经从 hexo 滚回 jekyll 一次了。。。

    17 条回复    2016-04-01 19:42:03 +08:00
    Livid
        1
    Livid  
    MOD
    PRO
       2016-03-31 17:03:11 +08:00
    如果是用于文档网站的话,试试 pip install mkdocs
    ChiangDi
        2
    ChiangDi  
       2016-03-31 17:04:08 +08:00
    Jekyll 可以换 makdown 解析器的。
    sparanoid
        3
    sparanoid  
       2016-03-31 17:10:04 +08:00
    不知道是什么解析器, Jekyll 最近换过默认的 Markdown parser , Rouge 的效果好一些
    domty
        4
    domty  
    OP
       2016-03-31 17:10:41 +08:00
    @Livid
    不是网站啊, jekyll 就是一个生成静态博客的工具。
    domty
        5
    domty  
    OP
       2016-03-31 17:15:02 +08:00
    @ChiangDi
    还有其他的解析器吗,现在配的是 kramdown
    domty
        6
    domty  
    OP
       2016-03-31 17:16:09 +08:00
    @sparanoid
    我现在的 jekyll 是 3.1.2
    本地 new 新项目的配置文件里给出的 markdown parser 还是 kramdown

    rouge 怎么配?
    thcode
        7
    thcode  
       2016-03-31 17:25:18 +08:00
    Markdown 因为没有「标准」,所以各个解释器提供的特性是不一样的,如果 kramdown 不能满足需求,试试 redcarpet 。
    sparanoid
        8
    sparanoid  
       2016-03-31 17:27:20 +08:00
    @domty 啊,记错了, Rouge 是语法高亮的, Kramdown 的确是默认的 Markdown 解析,具体遇到了什么解析问题?
    domty
        9
    domty  
    OP
       2016-03-31 17:40:16 +08:00
    @sparanoid

    比如
    ```Javascript

    ```
    代码区块后面跟着 空行再跟着### 三级标题的话, jekyll 的就解析失败。 后面三级标题的###以及之后的 markdown 代码不解析直接显示出来了。

    markdown preview 预览的效果是正常的
    sparanoid
        10
    sparanoid  
       2016-03-31 17:48:56 +08:00
    我试了下并没有问题,这是我的相关配置:
    https://gist.github.com/sparanoid/7116f89b974299afc4bc49f7fe108921
    domty
        11
    domty  
    OP
       2016-03-31 18:06:43 +08:00
    @sparanoid
    这种问题很诡异,因为文章里相同模式的代码段有三处,但是只有这一处出现了错误。

    gist 的代码段配完之后,我要在本地部署看效果需要安装其他什么 gem 吗
    wittyfox
        12
    wittyfox  
       2016-03-31 22:27:53 +08:00 via Android
    因为 Jekyll 和 Sublime 不一样,所以就是 Jekyll 坑。。。
    Bardon
        13
    Bardon  
       2016-03-31 23:25:56 +08:00
    请用 ruby2.0.0 以上的版本,安装 jekyll 3.0 以上的版本。

    然后,你本地 jekyll 的 style 配好了吗?你的 _config.yml 是啥?
    在 kramdown 下你知道要启用什么才能使用 fenced code blocks 吗?
    遇到问题为什么不去 jekyll 官网逛一遍呢?这是求学的态度?

    好吧,我正好现在有点闲,嗦了几句。不过也把思路给你理顺了。
    jasonliao
        14
    jasonliao  
       2016-04-01 09:17:20 +08:00 via iPhone
    jekyll3.0 之后默认用 kramdown ,之前我升了之后,代码块也有很大的问题,例如在 ol 和 ul 里的代码块,但是现在也可以解决了。如果你也有这样的问题,可以找我
    domty
        15
    domty  
    OP
       2016-04-01 10:28:54 +08:00
    @Bardon

    ruby version: 2.2.4
    jekyll versuib:3.1.2
    gem version:2.4.5.1

    然而这个 markdown 文档放到 sublime 解析正常,传到 github 上看 markdown 解析正常,传到 cmd markdown 解析依然正常,就 jekyll 解析有问题,怪我咯?

    _config.yml 里关于 markdown 的配置默认生成后我就没怎么动过
    Bardon
        16
    Bardon  
       2016-04-01 19:41:04 +08:00
    @domty fenced code block 本地 jekyll 默认不启用
    为什么不查官方文档?那怕过去了 24 小时
    https://jekyllrb.com/docs/configuration/

    你需要
    Bardon
        17
    Bardon  
       2016-04-01 19:42:03 +08:00
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     2392 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 23ms UTC 15:38 PVG 23:38 LAX 08:38 JFK 11:38
    Do have faith in what you're doing.
    ubao 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