Question

所有

我正在尝试创建一个扩展（以扩展AbstractBlockParser，我相信），它将找到一个开始标记，将后面的行移动到一个块中，然后在找到结束标记时停止（在最后一行上自行停止））。

在查看提供的示例时，很难弄清楚它们如何构建由多行组成的块，例如使用代码栏，文档不包括这种情况。

列表解析器代码似乎显示ListItems被添加到ListBlock，但是它如何知道何时停止？

Markdown示例

{{ Object ID
Any markdown goes here.
Some more
  * List 1
  * List 2
}}

输出可能是：

<div class="object">
    <span>Object ID</span>
    <p>Any markdown goes here.
    Some more</p>
    <ul>
        <li>List 1</li>
        <li>List 2</li>
    </ul>
</div>

Answer 1

诀窍在于，您的Block应始终canContain()和matchesNextLine()方法return true; - 这些将确保后续行始终作为子块添加。（查看FencedCode和ListBlock实现。）

以下是一些应该有效的代码：

<强> ObjectBlock.php：

class ObjectBlock extends AbstractBlock
{
    private $objectId;

    public function __construct($objectId)
    {
        $this->objectId = $objectId;
    }

    public function getObjectId()
    {
        return $this->objectId;
    }

    public function canContain(AbstractBlock $block)
    {
        return true;
    }

    public function acceptsLines()
    {
        return false;
    }

    public function isCode()
    {
        return false;
    }

    public function matchesNextLine(Cursor $cursor)
    {
        return true;
    }
}

<强> ObjectParser.php：

class ObjectParser extends AbstractBlockParser
{
    public function parse(ContextInterface $context, Cursor $cursor)
    {
        // Look for the starting syntax
        if ($cursor->match('/^{{ /')) {
            $id = $cursor->getRemainder();
            $cursor->advanceToEnd();

            $context->addBlock(new ObjectBlock($id));

            return true;
        // Look for the ending syntax
        } elseif ($cursor->match('/^}} +$/')) {
            // TODO: I don't know if this is the best approach, but it should work
            // Basically, we're going to locate a parent ObjectBlock in the AST...
            $container = $context->getContainer();
            while ($container) {
                if ($container instanceof ObjectBlock) {
                    $cursor->advanceToEnd();

                    // Found it!  Now we'll close everything up to (and including) it
                    $context->getBlockCloser()->setLastMatchedContainer($container->parent());
                    $context->getBlockCloser()->closeUnmatchedBlocks();
                    $context->setBlocksParsed(true);

                    return true;
                }

                $container = $container->parent();
            }
        }

        return false;
    }
}

<强> ObjectRenderer：

class ObjectRenderer implements BlockRendererInterface
{
    public function render(AbstractBlock $block, ElementRendererInterface $htmlRenderer, $inTightList = false)
    {
        $span = sprintf('<span>%s</span>', $block->getObjectId());
        $contents = $htmlRenderer->renderBlocks($block->children());

        return new HtmlElement('div', ['class' => 'object'],
            $span . $contents
        );
    }
}

免责声明：虽然我是这个库的作者，但是特定的逻辑（容器，提示和块关闭）主要是从JS版本分叉出来的，我只能理解其中的75％ - 只够保持我的分叉工作并找出有效的方法：）

如何创建扩展来解析符号/共同标记的多行

1 个答案: