decodelabs / idiom
轻量级文本到HTML解析器
v0.2.4
2024-08-22 01:28 UTC
Requires
- php: ^8.1
- decodelabs/coercion: ^0.2
- decodelabs/tagged: ^0.15
Requires (Dev)
README
轻量级文本到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。