TiddlyWiki5 函数处理换行符的注意事项

在 TiddlyWiki5 中，函数(function)和过程(procedure)对文本内容的处理方式存在一个容易被忽视的重要差异：函数输出不会自动进行维基化(wikification)处理。这一特性直接影响到了换行符等特殊字符的呈现效果。

问题现象重现

当开发者尝试将包含换行符的数据处理逻辑从变量声明改为函数定义时，会发现换行符失效。例如以下两种实现方式：

变量声明方式（正常显示换行）：

<$let newline= {{{[charcode[10]]}}}
      data="a 10; b 20; c 30"
      ptable={{{ [<data>split[;]] :map:flat[enlist-input[]join[|]addprefix[|]addsuffix[|]] :and[join<newline>]}}} >

函数定义方式（丢失换行）：

\function ptable() [<data>split[;]] :map:flat[enlist-input[]join[|]addprefix[|]addsuffix[|]] :and[join<newline>]

技术原理分析

造成这种差异的核心原因在于 TiddlyWiki5 的处理机制：

1. 变量声明中的内容会经过完整的维基化处理流程，包括换行符在内的所有维基语法都会被解析
2. 函数输出则被视为原始文本，不会自动触发维基化过程
3. 这种设计是为了保持函数处理的纯粹性，避免意外的二次解析

解决方案

对于需要保留换行等格式的场景，推荐以下两种处理方式：

方案一：通过中间变量中转

<$let newline={{{[charcode[10]]}}
      data="a 10; b 20; c 30" 
      result=<<ptable>> >
<$transclude $variable=result $mode=block/>
</$let>

方案二：显式调用维基化

<$wikify name="result" text=<<ptable>> >
{{{result}}}
</$wikify>

最佳实践建议

1. 当处理需要格式化的内容时，优先考虑使用变量而非函数
2. 如果必须使用函数，确保在调用处显式处理输出格式
3. 对于表格等结构化数据，考虑使用专门的表格渲染组件而非手动拼接
4. 在复杂场景下，可以将数据处理与呈现逻辑分离

理解这一特性有助于开发者在 TiddlyWiki5 中更高效地处理文本内容，避免因自动维基化带来的意外行为。