al-folio项目中的搜索功能优化：处理新闻内容中的换行符问题

在学术个人网站生成器al-folio项目中，搜索功能是用户快速定位内容的重要工具。近期开发者发现了一个影响搜索功能正常工作的技术问题，该问题与新闻内容中的换行符处理有关。

问题背景

当用户在新闻内容中使用多行文本时，会导致搜索功能完全失效。具体表现为按下Ctrl+K快捷键后搜索框为空，浏览器控制台会显示"string literal contains an unescaped line break"的错误提示。这个问题特别容易在以下场景出现：

1. 新闻内容包含多行文本
2. 使用Markdown格式的链接
3. 内容中包含HTML标签

技术分析

问题的根源在于搜索功能生成索引时对内容的处理不够完善。原始代码尝试直接将包含换行符的内容作为字符串字面量处理，而JavaScript中字符串字面量不能包含未转义的换行符。

此外，当新闻内容包含Markdown或HTML格式的链接时，搜索结果显示不够理想。链接会被原样显示为HTML源代码或Markdown语法，而不是用户友好的文本形式。

解决方案

经过开发者讨论，确定了以下优化方案：

1. 对所有搜索内容应用strip_html、strip_newlines和escape过滤器组合

   • strip_html：移除HTML标签
   • strip_newlines：移除换行符
   • escape：转义特殊字符

2. 对较长的内容使用truncatewords过滤器限制显示字数，保持搜索结果的整洁性

3. 优化标题显示逻辑，优先使用显式定义的page.title，其次才考虑内容截取

实现建议

对于技术实现，建议采用以下处理流程：

1. 检查是否存在显式定义的页面标题
2. 如果不存在，从内容中提取文本作为标题
3. 应用统一的文本清理过滤器
4. 对过长的内容进行适当截断

这种处理方式既能解决换行符导致的问题，又能改善搜索结果的显示效果，同时保持对各种内容类型的兼容性。

用户体验考量

从用户体验角度，搜索结果应该：

1. 保持一致性，避免出现原始HTML或Markdown代码
2. 提供足够的信息量，但不过于冗长
3. 确保所有内容都能被正确索引和搜索
4. 保持链接功能的同时提高可读性

这个问题的解决不仅修复了功能缺陷，还提升了al-folio项目搜索功能的整体质量和用户体验。