tanuck / cakephp-markdown
CakePHP 3 的 Markdown 插件。
v0.1.0
2015-02-20 22:16 UTC
Requires
- php: >=5.4
- cakephp/plugin-installer: *
- cebe/markdown: 1.0.x
Requires (Dev)
- cakephp/cakephp: 3.0.*-dev
- cakephp/cakephp-codesniffer: dev-master
- phpunit/phpunit: *
This package is not auto-updated.
Last update: 2024-09-14 16:44:59 UTC
README
CakePHP 3 插件,用于在视图模板中解析 Markdown 语法。
安装
在您的 composer.json
文件中包含以下内容
"require": {
"tanuck/cakephp-markdown": "dev-master"
}
然后运行
composer update
配置与使用
将以下代码添加到您的 config/bootstrap.php
文件中:Plugin::load('Tanuck/Markdown');
然后,在需要的地方加载助手。例如,在您的控制器中
class FooController extends AppController { public $helpers = ['Tanuck/Markdown.Markdown']; }
然后在您的模板中,您可以这样输出 Markdown 语法
echo $this->Markdown->transform($myMarkdownSyntax);
高级配置
Markdown 使用 cebe/markdown 库进行渲染,该库提供了 3 个不同的 Markdown 解析器类。
- Markdown - 使用原始语法定义: http://daringfireball.net/projects/markdown/syntax
- GithubMarkdown - GitHub 自有的 Markdown 风味: https://help.github.com/articles/github-flavored-markdown/
- MarkdownExtra - michelf 对原始 Markdown 的扩展: http://michelf.ca/projects/php-markdown/extra/
默认情况下,插件将使用 Markdown,即上面 3 个中的第一个。但是,您可以在加载助手时指定使用哪个。如下所示
class FooController extends AppController { public $helpers = [ 'Tanuck/Markdown.Markdown' => [ 'parser' => 'GithubMarkdown' ] ]; }
许可证
cakephp-markdown 在 MIT 许可证 下提供。