decodelabs/idiom

轻量级文本到HTML解析器

v0.2.4 2024-08-22 01:28 UTC

This package is auto-updated.

Last update: 2024-09-04 21:19:19 UTC


README

PHP from Packagist Latest Version Total Downloads GitHub Workflow Status PHPStan License

轻量级文本到HTML解析器 - 标签可选

Idiom 提供了一个简单易用的文本解析器,可以将带有可选HTML子集的自然语言文本转换为全标记,以便消费。

DecodeLabs 博客 上获取新闻和更新。

安装

通过 composer 安装库

composer require decodelabs/idiom

使用

将带有可选HTML标签的文本块解析为渲染HTML

use DecodeLabs\Idiom\Parser;

$content = <<<CONTENT
Idiom allows you to write naturally, converting paragraphs, lines and spaces to the relevant HTML elements.

You can include <strong>tags</strong> where necessary.

<ul>
    <li>Block elements like this can be used if extended mode is enabled</li>
    <li>Alternatively, content can be rendered as inline HTML with inline mode</li>
</ul>
CONTENT;

$parser = new Parser();
$parser->setExtended(true);
echo $parser->parse($content);

Metamorph

Idiom 还提供了一个 Metamorph 处理器,以便可以通过简化界面使用

use DecodeLabs\Metamorph;

echo Metamorph::{'idiom.extended'}($content);

输出

Idiom 提供的解析HTML被包装在 Tagged 库的 Markup 接口中,这样输出可以在所有渲染上下文中正确处理。

安全性

请注意,Idiom 目前还没有彻底处理恶意实体输入 - 此解析器应仅用于处理为 安全 的内容。

许可

Idiom 采用 MIT 许可证。有关完整的许可文本,请参阅 LICENSE