Wagtail 2.0 Rich Text Editor内部链接失效问题求助

这个问题其实是Wagtail富文本内部链接的存储和渲染机制导致的，我来给你拆解下原因和解决办法：

问题根源 #

Wagtail的富文本编辑器（Rich Text Editor）里的内部链接，在数据库中并不是直接存储成带href的标准<a>标签，而是用这种特殊格式存储：

<a id="5" linktype="page">sample page</a>

这里的id="5"是你链接的目标页面在Wagtail中的ID，linktype="page"表明这是指向站内页面的链接。浏览器本身不认识这种非标准的<a>标签属性，所以直接渲染的话只会显示文本，不会解析成可点击的链接。

而你手动设置外部链接为/sample-page/能正常工作，是因为这种写法是标准的HTML链接格式，浏览器可以直接识别对应的跳转路径。

解决办法 #

要让内部链接正常渲染，你需要用Wagtail提供的专用工具来处理富文本内容：

1. 在模板中使用|richtext过滤器
   这是最常见的场景，在渲染页面富文本字段时，一定要加上这个过滤器，而不是直接输出字段内容。比如：

{{ page.blog_content|richtext }}

这个过滤器会自动把数据库里的特殊内部链接标签，转换成带有正确href属性的标准<a>标签，最终生成类似这样的代码：

<a href="/sample-page/">sample page</a>

2. 在Python代码中手动转换富文本
   如果是在视图或者自定义脚本中处理富文本内容，可以用Wagtail的expand_db_html方法来转换：

from wagtail.core.rich_text import expand_db_html

# 假设page是你的博客文章实例
rendered_content = expand_db_html(page.blog_content)

转换后的内容就是带有正常链接的HTML，可以直接用于渲染。

3. 检查自定义富文本配置（如果有）
   如果你自定义了Wagtail的富文本允许标签或属性，确保没有意外剥离linktype、id这些特殊属性——不过默认情况下Wagtail的richtext过滤器会处理这些，所以这个情况比较少见。

内容的提问来源于stack exchange，提问作者kbdev