搜索

[25424] 2016-08-27_除了Markdown编辑器，你还需要会用程序来处理它

文档创建者：s7ckTeam
浏览次数：29
最后更新：2025-01-19
2016-08-27_除了Markdown编辑器，你还需要会用程序来处理它 除 了   M a r k d o w n   编 辑 器 ， 你 还 需 要 会 用 程 序 来 处 理 它 作 者 ： i d e r a s   L i n u x 中 国   2 0 1 6 - 0 8 - 2 7 转 载 自 ：   h t t p s : / / i d e r a s . m e / p l a y - w i t h - m a r k d o w n - y o u - n e e d - t h e s e - t o o l s /   作 者 ：   i d e r a s 前 言 前 言 随 着   w o r d p r e s s   和 静 态 网 站 的 流 行 ， m a r k d o w n   被 用 的 越 来 越 多 。 我 们 已 经 介 绍 过 很 多   M a r k d o w n   编 辑 器 ， 但 是 有 时 候 你 也 需 要 用 程 序 来 处 理   M a r k d o w n   文 本 。 m a r k d o w n   是 一 个 面 向 写 作 的 语 法 引 擎 ， m a r k d o w n   的 最 终 目 的 都 是 解 析 成   h t m l   用 于 网 页 浏 览 ， 所 以 它 兼 容   h t m l   语 法 ， 即 你 可 以 在 m a r k d o w n   文 档 中 使 用 原 生 的   h t m l   标 签 。 m a r k d o w n   解 析 器 解 析 器 开 发 静 态 网 站 生 成 器 的 时 候 都 会 采 用 一 种 叫   f r o n t   m a t t e r   的 格 式 进 行 网 站 内 容 写 在 类 似 下 面 的 格 式 6 .   1 .   - - - 2 .   t i t l e :   玩 转 m a r k d o w n ， 你 需 要 用 到 这 几 个 工 具 3 .   d a t e :   2 0 1 6 - 0 8 - 1 4   1 6 : 4 4 : 5 4 4 .   i m a g e :   / i m g / p e n c i l s - 7 6 2 5 5 5 _ 6 4 0 . j p g 5 .   - - - 7 .   # #   前 言
8 .   当 进 行 网 站 生 成 的 时 候 需 要 进 行   m a r k d o w n   解 析 ， 然 后 渲 染 成   h t m l   页 面 ， 那 用 什 么 工 具 进 行 解 析 呢 ？ m a r k e d [ 1 ] m a r k e d   是 最 早 用   n o d e . j s   开 发 的   m a r k d o w n   解 析 器 ， 同 时 提 供   C L I   命 令 调 用 和   n o d e . j s   A P I   调 用 。 C L I   调 用 代 码 示 例 A P I 调 用 示 例 这 些 都 是 一 些 通 用 的 功 能 ， 但 是   m a r k e d   还 支 持 代 码 高 亮 ， 通 过 使 用   h i g h l i g h t . j s [ 2 ] 。 使 用   h i g h l i g h t . j s   进 行 代 码 高 亮 相 信 大 家 都 用 到 过 ， 可 能 大 家 不 知 道 是   h i g h l i g h t . j s   还 支 持   A P I   方 式 调 用 ， 下 面 的 代 码 会 配 置   m a r k e d   使 用 h i g h l i g h t . j s   进 行 代 码 高 亮 ： 7 .   # #   前 言 9 .   随 着 w o r d p r e s s 和 静 态 网 站 的 流 行 ， m a r k d o w n 被 用 的 越 来 越 多 。 . . . 1 .   $   m a r k e d   - o   h e l l o . h t m l 2 .   h e l l o   w o r l d 3 .   ^ D 4 .   $   c a t   h e l l o . h t m l 5 .   < p > h e l l o   w o r l d < / p > 1 .   v a r   m a r k e d   =   r e q u i r e ( ' m a r k e d ' ) ; 2 .   c o n s o l e . l o g ( m a r k e d ( ' I   a m   u s i n g   _ _ m a r k d o w n _ _ . ' ) ) ; 3 .   / /   O u t p u t s :   < p > I   a m   u s i n g   < s t r o n g > m a r k d o w n < / s t r o n g > . < / p > 1 .   m a r k e d . s e t O p t i o n s ( { 2 .       h i g h l i g h t :   f u n c t i o n   ( c o d e ,   l a n g )   { 3 .           v a r   r e s ; 4 .           i f   ( l a n g )   { 5 .               r e s   =   h l j s . h i g h l i g h t ( l a n g ,   c o d e ,   t r u e ) . v a l u e ; 6 .           }   e l s e   { 7 .               r e s   =   h l j s . h i g h l i g h t A u t o ( c o d e ) . v a l u e ;
生 成 的 代 码 已 经 包 含 代 码 高 亮 标 签 ， 最 后 只 需 要 引 入   h i g h l i g h t . j s   的 主 题 就 能 显 示 了 ， h i g h l i g h t . j s   所 有 的 颜 色 主 题 都 在 这 里 [ 3 ] m a r k d o w n - j s [ 4 ] m a r k d o w n - j s   也 是 一 款 使 用   n o d e . j s   开 发 的   m a r k d o w n   解 析 器 ， 基 本 用 法 和   m a r k e d   差 不 多 ， 但 是 文 档 里 面 好 像 没 有 提 到 像   m a r k e d   一 样 进 行 代 码 高 亮 生 成 的 接 口 ， 有 兴 趣 的 同 学 自 己 找 找 吧 。 m a r k d o w n   生 成 器 生 成 器 t o - m a r k d o w n [ 5 ] 什 么 是   m a r k d o w n   生 成 器 ， 就 是 根 据   h t m l   标 签 生 成   m a r k d o w n   文 件 。 g i t h u b   上 面   m a r k d o w n   生 成 器   s t a r   数 最 高 的 是   t o - m a r k d o w n 。 简 单 的 代 码 示 例 t o - m a r k d o w n   最 近 进 行 了 更 新 ， 增 加 了 对   g f m   的 兼 容 ， g f m   就 是   g i t   f l a v o r e d   m a r k d o w n [ 6 ]   的 意 思 ，   是   g i t h u b   对   m a r k d o w n   语 法 进 行 的 扩 展 。 使 用   g f m   的 示 例 那 这 个   t o - m a r k d o w n   有 什 么 用 呢 ？ 举 个 简 单 的 例 子 ， 假 如 我 想 开 发 一 个 简 单 的   R S S   阅 读 器 ， 但 是 我 又 不 想 跳 转 到 目 标 网 站 去 阅 读 ， 因 为 不 同 的 网 站 风 格 不 一 ， 导 致 不 一 致 的 阅 读 体 验 。 怎 么 办 呢 ？ 那 就 把 网 站 内 容 抓 取 下 来 ， 然 后 用   t o - m a r k d o w n   生 成   m a r k d o w n   文 件 ， 然 后 使 用 自 己 的 模 板 样 式 进 行 统 一 渲 染 。 当 然 去 除 广 告 只 是 一 个   s i d e   e f f e c t 。 h e c k y e s m a r k d o w n [ 7 ] 7 .               r e s   =   h l j s . h i g h l i g h t A u t o ( c o d e ) . v a l u e ; 8 .           } 9 .           r e t u r n   r e s ; 1 0 .       } 1 1 .   } ) ; 1 .   v a r   t o M a r k d o w n   =   r e q u i r e ( ' t o - m a r k d o w n ' ) ; 2 .   t o M a r k d o w n ( ' < h 1 > H e l l o   w o r l d ! < / h 1 > ' ) ; 1 .   t o M a r k d o w n ( ' < d e l > H e l l o   w o r l d ! < / d e l > ' ,   {   g f m :   t r u e   } ) ;
除 了   t o - m a r k d o w n   之 外 还 有 一 个 比 较 好 用 的   A P I ：   h e c k y e s m a r k d o w n ， 这 个 项 目 使 用 了   p h p - r e a d a b i l i t y [ 8 ] ， 提 高 文 章 的 可 读 性 。 可 惜   h e c k y e s m a r k d o w n   没 有 开 源 出 来 ， 这 个 项 目 有 点 古 老 ， 估 计 那 个 时 候   g i t h u b   还 没 流 行 起 来 。 h e c k y e s m a r k d o w   对 中 文 的 支 持 不 是 非 常 友 好 ， 如 果 想 抓 取 中 文 站 还 是 使 用   t o - m a r k d o w n   比 较 靠 谱 一 点 。 f r o n t   m a t t e r m a r k d o w n   写 文 章 确 实 很 方 便 ， 简 单 容 易 上 手 ， 但 是   m a r k d o w n   不 能 保 存 元 数 据 ， 例 如 作 者 ， 日 期 ， 类 型 这 样 的 结 构 化 的 数 据 ， 如 果 都 生 成 h t m l   标 签 的 话 提 取 的 时 候 又 稍 微 麻 烦 了 点 ，   还 得 借 助   c h e e r i o [ 9 ]   才 能 完 成 。 所 以 ， 为 了 能 方 便 的 保 存 文 章 的 元 数 据 ， 几 乎 所 有 的 静 态 网 站 生 成 器 都 使 用   f r o n t   m a t t e r   格 式 来 保 存 文 章 。 f r o n t   m a t t e r   文 件 通 常 分 为 头 部 和 正 文 部 分 ， 头 部 一 般 使 用   y a m l [ 1 0 ] 、 t o m l [ 1 1 ]   和   j s o n   三 种 格 式 ， f r o n t   m a t t e r   解 析 工 具 需 要 识 别 这 三 种 格 式 的 文 件 头 。 正 文 部 分 就 是 普 通 的   m a r k d o w n   内 容 。 f r o n t - m a t t e r [ 1 2 ] f r o n t - m a t t e r   也 是 用   n o d e . j s   开 发 的 ， 相 比   m a r k d o w n   解 析 器 来 说 ， f o r n t - m a t t e r   解 析 器 要 简 单 很 多 。 示 例 文 件   e x a m p l e . m d 5 .   解 析 代 码 3 .   6 .   8 .   1 .   - - - 2 .   t i t l e :   J u s t   h a c k ' n 3 .   d e s c r i p t i o n :   N o t h i n g   t o   s e e   h e r e 4 .   - - - 6 .   T h i s   i s   s o m e   t e x t   a b o u t   s o m e   s t u f f   t h a t   h a p p e n e d   s o m e t i m e   a g o 1 .   v a r   f s   =   r e q u i r e ( ' f s ' ) 2 .       ,   f m   =   r e q u i r e ( ' f r o n t - m a t t e r ' ) 4 .   f s . r e a d F i l e ( ' . / e x a m p l e . m d ' ,   ' u t f 8 ' ,   f u n c t i o n ( e r r ,   d a t a ) { 5 .       i f   ( e r r )   t h r o w   e r r 7 .       v a r   c o n t e n t   =   f m ( d a t a ) 9 .       c o n s o l e . l o g ( c o n t e n t )
解 析 结 果 f r o n t   m a t t e r   虽 然 格 式 看 起 来 不 太 统 一 ， 却 是 对   m a r k d o w n   强 有 力 的 补 充 。 转 载 自 ：   h t t p s : / / i d e r a s . m e / p l a y - w i t h - m a r k d o w n - y o u - n e e d - t h e s e - t o o l s /   作 者 ：   i d e r a s [ 1 ] :   h t t p s : / / g i t h u b . c o m / c h j j / m a r k e d [ 2 ] :   h t t p s : / / g i t h u b . c o m / i s a g a l a e v / h i g h l i g h t . j s [ 3 ] :   h t t p s : / / g i t h u b . c o m / i s a g a l a e v / h i g h l i g h t . j s / t r e e / m a s t e r / s r c / s t y l e s [ 4 ] :   h t t p s : / / g i t h u b . c o m / e v i l s t r e a k / m a r k d o w n - j s [ 5 ] :   h t t p s : / / g i t h u b . c o m / d o m c h r i s t i e / t o - m a r k d o w n [ 6 ] :   h t t p s : / / g u i d e s . g i t h u b . c o m / f e a t u r e s / m a s t e r i n g - m a r k d o w n / [ 7 ] :   h t t p : / / h e c k y e s m a r k d o w n . c o m / [ 8 ] :   h t t p s : / / g i t h u b . c o m / f e e l i n g l u c k y / p h p - r e a d a b i l i t y [ 9 ] :   h t t p s : / / g i t h u b . c o m / c h e e r i o j s / c h e e r i o [ 1 0 ] :   h t t p s : / / w w w . y a m l . o r g [ 1 1 ] :   h t t p s : / / g i t h u b . c o m / t o m l - l a n g / t o m l [ 1 2 ] :   h t t p s : / / g i t h u b . c o m / j x s o n / f r o n t - m a t t e r 推 荐 文 章 推 荐 文 章 点 击 标 题 或 输 入 文 章   I D   直 达 该 文 章 9 .       c o n s o l e . l o g ( c o n t e n t ) 1 0 .   } ) 1 .   { 2 .           a t t r i b u t e s :   { 3 .                   t i t l e :   ' J u s t   h a c k ' n ' , 4 .                   d e s c r i p t i o n :   ' N o t h i n g   t o   s e e   h e r e ' 5 .           } , 6 .           b o d y :   ' n T h i s   i s   s o m e   t e x t   a b o u t   s o m e   s t u f f   t h a t   h a p p e n e d   s o m e t i m e   a g o ' , 7 .           f r o n t m a t t e r :   ' t i t l e :   J u s t   h a c k ' n n d e s c r i p t i o n :   N o t h i n g   t o   s e e   h e r e ' 8 .   }
点 击 标 题 或 输 入 文 章   I D   直 达 该 文 章 将 文 章 分 享 给 朋 友 是 对 我 们 最 好 的 赞 赏 ！ 阅 读 原 文
回复

举报

高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

Archiver| 手机版| 小黑屋|
Powered by Discuz! X3.4 Copyright © 2001-2020, Tencent Cloud. 商业源码建议获取授权，如侵犯您的权益，请联系客服处理