[扩展推荐] GitDown —— 支持 GitHub Markdown 语法的 PHP Markdown 解析器
GitDown 是 Caleb Porzio 编写的一个简单的包,用于在PHP中解析(GitHub Flavored)Markdown。它的工作原理就是把 markdown 发送到一个公共的 GitHub API 然后解析成 HTML。
如果你使用的不是 Laravel, 你也可以使用它。以下是在一个 Laravel 项目中使用它的基本方式:
GitDown::parse($markdown);
// 永久缓存。(推荐方式)
GitDown::parseAndCache($markdown);
// 缓存24小时 (Laravel 5.8 以下的单位是分钟,否则就是秒)
GitDown::parseAndCache($markdown, $seconds = 86400);
// 传递自定义的缓存策略
GitDown::parseAndCache($markdown, function ($parse) {
return Cache::rememberForever(sha1($markdown), function () use ($parse) {
return $parse();
});
});
并非一定要在 Laravel 中使用 GitDown---你可以创建一个 GitDown\GitDown
实例,然后使用自己的缓存策略:
$gitDown = new GitDown\GitDown(
$token = 'foo',
$context = 'your/repo',
$allowIframes = false
);
$gitDown->parse($markdown);
// 传递自定义的缓存策略
$gitDown->parseAndCache($markdown, function ($parse) {
return Cache::rememberForever(sha1($markdown), function () use ($parse) {
return $parse();
});
});
一定要注意如果你不缓存结果很快就会遇到 GitHub 接口限速,然后你的页面就会加载的奇慢无比。
在前端页面,你可以在 Laravel 项目的 <head>
布局下利用 @gitdown
指令 ,在 class 为 .markdown-body
的块级元素下嵌套 markdown 内容:
<head>
[...]
@gitdown
</head>
<body>
<div class="markdown-body">
{!! GitDown::parseAndCache($content) !!}
</div>
</body>
如果你使用的不是 Laravel,你可以按照如下方式使用:
<style><?php echo GitDown\GitDown::styles(); ?></style>
查阅项目的 README 文件可以获得更多渲染样式的细节。
本文中的所有译文仅用于学习和交流目的,转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议,如果我们的工作有侵犯到您的权益,请及时联系我们。
推荐文章: