Espanso 表单多行文本转HTML列表的高效处理方案

在Espanso文本扩展工具的实际应用中，开发者经常需要处理表单中的多行文本输入，并将其转换为特定格式的HTML内容。本文将介绍一种优雅的解决方案，通过Shell命令和变量复用技术，实现多行文本到HTML列表项的高效转换。

问题背景

当使用Espanso的表单功能收集多行文本输入时，常见的需求是将每行文本自动包裹在HTML的<li>标签中。原始方案使用了复杂的sed命令组合，虽然功能上能够实现需求，但存在以下问题：

1. 命令可读性差，维护困难
2. 对特殊字符（如引号）处理不佳
3. 代码重复率高，三个列表需要重复定义相似的转换逻辑

优化方案

使用awk替代sed

awk命令提供了更简洁的文本处理方式，可以轻松实现每行文本的标签包裹：

global_vars:
  - name: pattern
    type: echo
    params:
      echo: awk '{print "<li>" $0 "</li>"}'

这个全局变量定义了一个文本处理模式，它使用awk将每行输入文本前后添加<li>和</li>标签。

变量复用技术

在具体的表单处理中，可以多次引用这个预定义的模式：

vars:
  - name: flist1
    type: shell
    params:
      cmd: echo "{{form.list1}}" | {{pattern}}
  - name: flist2
    type: shell
    params:
      cmd: echo "{{form.list2}}" | {{pattern}}
  - name: flist3
    type: shell
    params:
      cmd: echo "{{form.list3}}" | {{pattern}}

这种方法显著提高了代码的可维护性，修改转换逻辑只需调整一处定义。

进阶优化

对于仅在当前扩展中使用的模式，可以将其定义为局部变量而非全局变量，避免污染全局命名空间：

vars:
  - name: pattern
    type: echo
    params:
      echo: awk '{print "<li>" $0 "</li>"}'
  - name: flist1
    type: shell
    params:
      cmd: echo "{{form.list1}}" | {{pattern}}

方案优势

1. 更好的可读性：awk命令直观表达了"每行前后添加标签"的意图
2. 更强的健壮性：正确处理包含引号等特殊字符的文本
3. 更高的可维护性：转换逻辑集中定义，一处修改全局生效
4. 更简洁的代码：消除了复杂的sed命令组合

实际应用示例

以下是一个完整的Espanso配置示例，展示了如何在实际表单中使用这种技术：

trigger: ":danger"
replace: |
  <div class='danger {{form.class}}'>
    <h3>{{form.title}} {{form.stars}}</h3>
    <p>{{form.description}}</p>
    <h4>{{form.subtitle}}</h4>
    <ul>
      {{flist1}}
    </ul>
    <hr>
    <ul>
      {{flist2}}
    </ul>
  </div>
vars:
  - name: pattern
    type: echo
    params:
      echo: awk '{print "<li>" $0 "</li>"}'
  - name: form
    type: form
    params:
      fields:
        list1:
          multiline: true
        list2:
          multiline: true
  - name: flist1
    type: shell
    params:
      cmd: echo "{{form.list1}}" | {{pattern}}
  - name: flist2
    type: shell
    params:
      cmd: echo "{{form.list2}}" | {{pattern}}