README

本模块为 Yii Framework 2.0 提供Markdown编辑和转换工具。它使用PHP Markdown Extra和PHP Smarty Pants进行Markdown转换。此外，您可以通过包括额外的自定义转换模式来自定义Markdown的版本。该模块还包括一个增强的自定义Markdown编辑器小部件，用于在运行时进行Markdown编辑和预览。这个小部件使用Bootstrap 3.0进行样式设计。查看完整演示。

Markdown

查看演示
这是一个Markdown转换类，它使用PHP Markdown Extra和PHP SmartyPantsTypographer来处理Markdown到HTML的转换。它还支持可配置的自定义转换模式处理，以在一定程度上自定义Markdown的样式。查看示例和详情或查看完整演示。

MarkdownEditor

查看演示
这是一个具有可配置选项的高级Markdown输入小部件。它使用Bootstrap 3.0进行样式设计。此小部件的主要功能包括：

1. 可配置的工具栏和按钮，用于格式化内容
2. Markdown格式化文本的实时HTML预览
3. 最大化编辑器以进行全屏编辑
4. 实现Markdown提供的PHP Markdown Extra和PHP SmartyPantsTypographer功能
5. 尽可能使用Bootstrap 3.0样式
6. 允许将文本编辑器的内容保存/导出为文本或HTML
7. 可配置页眉、页脚和输入选项
8. 支持本地化和自定义消息和内容

查看示例和详情或查看完整演示。

演示

您可以在这里看到这些功能的用法，包括文档和示例。

安装

安装此扩展的首选方式是通过composer。

注意：请检查此扩展的composer.json以获取此扩展的需求和依赖项。阅读有关为应用程序的composer.json设置minimum-stability设置的网络技巧/维基。

运行以下命令之一：

$ php composer.phar require kartik-v/yii2-markdown "dev-master"

或

"kartik-v/yii2-markdown": "dev-master"

将以下内容添加到您的composer.json文件的require部分：

使用方法

设置模块

将markdown添加到您的Yii配置文件的模块部分

'modules' = [
	/* other modules */
	'markdown' => [
		'class' => 'kartik\markdown\Module',
	]
];

您可以为markdown模块设置额外的配置选项

'modules' = [
	'markdown' => [
		// the module class
		'class' => 'kartik\markdown\Module',
		
		// the controller action route used for markdown editor preview
		'previewAction' => '/markdown/parse/preview',
		
		// the list of custom conversion patterns for post processing
		'customConversion' => [
			'<table>' => '<table class="table table-bordered table-striped">'
		],
		
		// whether to use PHP SmartyPantsTypographer to process Markdown output
		'smartyPants' => true
	]
	/* other modules */
];

Markdown

use kartik\markdown\Markdown;

// default call
echo Markdown::convert($content);

// with custom post processing
echo Markdown::convert($content, ['custom' => [
	'<h1>' => '<h1 class="custom-h1>',
	'<h2>' => '<h1 class="custom-h2>',
]]);

MarkdownEditor

// add this in your view
use kartik\markdown\MarkdownEditor;

// usage with model
echo MarkdownEditor::widget([
	'model' => $model, 
	'attribute' => 'markdown',
]);

// usage without model
echo MarkdownEditor::widget([
	'name' => 'markdown', 
	'value' => $value,
]);

许可证

yii2-markdown遵循BSD 3-Clause许可证发布。有关详细信息，请参阅附带的LICENSE.md。