如何在FreeMarker模板中引用预定义的脚注？

在FreeMarker模板中，由于DOCX的XML结构复杂，直接操作脚注可能会变得繁琐。但是，如果使用Apache POI库，可以先在Java代码中处理好脚注的插入，然后再将整个文档输出给模板。以下是一个基本的概念：

1. **在Java代码中创建和管理脚注**：首先，在处理完模板内容后，根据需要创建脚注。使用`Paragraph`和`Note`对象来构造脚注，存储它们的ID以及相关的注释内容。

Paragraph paragraph = ...; // 假设已经有一个包含需要插入脚注的段落
Note note = document.createNote();
note.setId("footnote1"); // 或者从数据库获取脚注ID
note.setText(paragraph.getText());
paragraph.addNote(note);

2. **将处理后的文档传递给模板**：现在文档包含了所有内容和预定义的脚注，这时你可以创建一个模型（Model），将这个处理过的`Document`对象或者其他相关数据放入。

Map<String, Object> data = new HashMap<>();
data.put("document", document);

3. **在模板中使用**：虽然在FreeMarker模板中无法直接访问和修改文档，但你可以显示文档的内容，而不是直接写入脚注。当显示段落时，可以使用条件指令来检查是否有对应的脚注，并显示脚注信息。

<#if document.paragraphs?has_content>
    ${paragraph.text} <!-- 段落内容 -->
    <#if paragraph.hasNotes && paragraph.notes.size() > 0>
        <sup>${paragraph.notes[0].id}</sup> <!-- 显示脚注ID -->
    </#if>
</#if>

在这个例子中，如果段落有脚注，就会显示脚注的标识。但在实际应用中，你可能还需要编写额外的逻辑来处理脚注的呈现细节。

请注意，这只是一个大概的指导，具体实现可能需要根据你的业务需求和技术栈进行调整。