aydin-hassan/cli-md-renderer

league/commonmark 兼容的 AST CLI Markdown 渲染器

3.0.0 2021-12-19 20:17 UTC

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">

Build Status Windows Build Status Coverage Status

使用说明

<?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);

待办事项

  • 使配置化(行结束符、颜色、样式)
  • 图像渲染器
  • 列表渲染器
  • 代码语法高亮
  • 文档