aydin-hassan / cli-md-renderer
league/commonmark 兼容的 AST CLI Markdown 渲染器
3.0.0
2021-12-19 20:17 UTC
Requires
- php: ^7.4 | ^8.0
- kevinlebrun/colors.php: ^1.0
- league/commonmark: ^2.1
- php-school/keylighter: ^0.8.4
Requires (Dev)
- phpstan/phpstan: ^1.2.0
- phpunit/phpunit: ^9.0
- roave/security-advisories: dev-latest
- squizlabs/php_codesniffer: ^3.0
This package is auto-updated.
Last update: 2024-09-20 02:57:47 UTC
README
<img src="https://github.com/AydinHassan/cli-md-renderer/workflows/CliMdRenderer/badge.svg">
使用说明
<?php require_once 'vendor/autoload.php'; use AydinHassan\CliMdRenderer\CliRendererFactory; use League\CommonMark\Environment\Environment; use League\CommonMark\Parser\MarkdownParser; $parser = new MarkdownParser((new Environment())->addExtension(new CommonMarkCoreExtension())); $parser = new DocParser(Environment::createCommonMarkEnvironment()); $cliRenderer = (new CliRendererFactory)->__invoke(); $ast = $parser->parse(file_get_contents('path/to/file.md')); echo $cliRenderer->renderBlock($ast);
语法高亮
FencedCode
可以语法高亮。默认情况下,仅使用:kadet/keylighter 对 PHP 源代码进行语法高亮。如果您想为其他语言添加语法高亮,您应该创建一个实现了 \AydinHassan\CliMdRenderer\SyntaxHighlighterInterface
的类。
它接受代码作为字符串,并应该返回高亮后的代码作为字符串。您可以通过以下方式注册您的语法高亮器
<?php use AydinHassan\CliMdRenderer\Renderer\FencedCodeRenderer; $codeRenderer = new FencedCodeRenderer; $codeRenderer->addSyntaxHighlighter('js', new JsSyntaxHighlighter);
如果您需要这样做,则不能使用工厂,因此构造看起来可能像这样
<?php require_once 'vendor/autoload.php'; use AydinHassan\CliMdRenderer\Highlighter\PhpHighlighter; use AydinHassan\CliMdRenderer\InlineRenderer\LinkRenderer; use AydinHassan\CliMdRenderer\Renderer\DocumentRenderer; use AydinHassan\CliMdRenderer\Renderer\FencedCodeRenderer; use AydinHassan\CliMdRenderer\Renderer\HeaderRenderer; use AydinHassan\CliMdRenderer\Renderer\HorizontalRuleRenderer; use AydinHassan\CliMdRenderer\Renderer\ParagraphRenderer; use Colors\Color; use Kadet\Highlighter\KeyLighter; use League\CommonMark\Block\Element\Document; use League\CommonMark\Block\Element\Header; use League\CommonMark\Block\Element\HorizontalRule; use League\CommonMark\Block\Element\Paragraph; use League\CommonMark\Block\Element\FencedCode; use AydinHassan\CliMdRenderer\InlineRenderer\TextRenderer; use AydinHassan\CliMdRenderer\InlineRenderer\CodeRenderer; use AydinHassan\CliMdRenderer\InlineRenderer\EmphasisRenderer; use AydinHassan\CliMdRenderer\InlineRenderer\StrongRenderer; use AydinHassan\CliMdRenderer\InlineRenderer\NewlineRenderer; use League\CommonMark\Inline\Element\Link; use League\CommonMark\Inline\Element\Text; use League\CommonMark\Inline\Element\Code; use League\CommonMark\Inline\Element\Emphasis; use League\CommonMark\Inline\Element\Strong; use League\CommonMark\Inline\Element\Newline; $codeRender = new FencedCodeRenderer(); $keyLighter = new KeyLighter; $keyLighter->init(); $codeRender->addSyntaxHighlighter('php', new PhpHighlighter($keyLighter)); $codeRender->addSyntaxHighlighter('js', new JsSyntaxHighlighter); $blockRenderers = [ Document::class => new DocumentRenderer, Header::class => new HeaderRenderer, HorizontalRule::class => new HorizontalRuleRenderer, Paragraph::class => new ParagraphRenderer, FencedCode::class => $codeRender, ]; $inlineBlockRenderers = [ Text::class => new TextRenderer, Code::class => new CodeRenderer, Emphasis::class => new EmphasisRenderer, Strong::class => new StrongRenderer, Newline::class => new NewlineRenderer, Link::class => new LinkRenderer, ]; $colors = new Color; $colors->setForceStyle(true); return new CliRenderer($blockRenderers, $inlineBlockRenderers, $colors);
待办事项
- 使配置化(行结束符、颜色、样式)
- 图像渲染器
- 列表渲染器
- 代码语法高亮
- 文档