WordPress 有提供一个便利的函数─wpautop,它能够利用换行字符来对 HTML 内容加上 <p> 或是 <br> 标签,让我们在后台直接用 HTML 语法撰写文章的时候,不必手动加上 <p> 或是 <br> 标签,这也让 HTML 变得比较容易阅读,不过这个函数还是有它的问题(用了一堆正则表达式、会产生大量字符串、可能在错误的位置插入标签)就是了。在 Rust 编程语言中,如果也想要用这样的功能,要怎么做呢?
先看看以下 HTML 吧!
<body>
Line 1
Line 2
</body>
若我们直接在 HTML 中的 body 元素中撰写以上内容,经过浏览器渲染(render)之后,会呈现为:
Line 1 Line 2
也就是说,Line 1 和 Line 2 在实际的画面中并没有被换行。
若要让 Line 1 和 Line 2 能正确换行,HTML 就要写成:
<body>
Line 1<br>
Line 2
</body>
但是若我们在 WordPress 后台使用 HTML 编辑器编辑文章的话,不需要加上 <br> 标签就可以换行,正是因为 WordPress 预设有激活 wpautop 函数的关系。
有了 wpautop 函数,像以下这样的写法:
Paragraph 1 Paragraph 2
就会被自动转成:
<p>Paragraph 1</p>
<p>Paragraph 2</p>
HTML Auto <p>
「HTML Auto <p>」是笔者开发的套件,参考了 WordPress 的 wpautop 函数的作法,提供 auto_p 函数,能够做到和 wpautop 函数类似的事情。
Crates.io
Cargo.toml
html-auto-p = "*"
使用方法
参考以下代码:
use html_auto_p::*;
assert_eq!("<p>Hello world!</p>", auto_p("Hello world!", Options::new()));
assert_eq!("<p>Line 1<br>\nLine 2</p>", auto_p("Line 1\nLine 2", Options::new().br(true)));
assert_eq!("<p>Line 1<br>\nLine 2</p>", auto_p("Line 1<br>\nLine 2", Options::new().br(true)));
assert_eq!("<p>Paragraph 1</p>\n<p>Paragraph 2</p>", auto_p("Paragraph 1\n\nParagraph 2", Options::new()));
assert_eq!("<pre>Line 1<br>\nLine 2</pre>", auto_p("<pre>Line 1<br>\nLine 2</pre>", Options::new().br(true)));
assert_eq!("<pre>Line 1<br>\nLine 2</pre>", auto_p("<pre>Line 1<br>\nLine 2</pre>", Options::new().br(true).esc_pre(true)));
assert_eq!("<pre>Line 1\nLine 2</pre>", auto_p("<pre>\nLine 1\nLine 2\n</pre>", Options::new().remove_useless_newlines_in_pre(true)));
