借助LibreOffice CLI与宏在生成的PDF中高亮指定词汇

1. 宏的执行时机与生效性 #

当通过macro:///参数指定宏时，宏会在文档打开后、PDF转换导出前执行，只要宏逻辑正确，修改会被应用到最终PDF中。但你的宏代码存在致命逻辑错误：

// 错误：while( !found ) 条件写反了
while( !found ) {
    // ...高亮逻辑
}

found是findFirst返回的匹配对象，找到内容时found不为空，!found为false，循环根本不会执行。需改成while( found )才能遍历所有匹配项并高亮：

while( found ) {
    let text = found.getText();
    text.CharBackColor = "#FFFF00"; // Yellow Hex
    found = document.findNext( found.getEnd(), descriptor );
}

2. 验证宏是否成功加载 #

可以通过以下方式验证：

• 测试宏执行效果：写一个极简测试宏（比如修改文档内容），替换原宏执行，看生成的PDF是否有对应变化。例如：

  function testMacro() {
      var doc = XSCRIPTCONTEXT.getDocument();
      var text = doc.getText();
      text.setString("Macro executed successfully!");
  }
  

  执行命令：

  libreoffice --headless --norestore --convert-to pdf test.docx macro:///home/macros.testMacro
  

  如果PDF中显示指定文本，说明宏已加载并执行。
• 检查宏路径配置：运行以下命令查看已加载的宏列表，确认你的宏是否在列：

  libreoffice --headless --norestore --show-macros
  

  若未出现，需将宏文件放到LibreOffice默认用户宏目录（容器中通常为/root/.config/libreoffice/4/user/Scripts/javascript/），或通过配置文件指定额外的宏搜索路径。
• 确认JavaScript宏启用：部分版本默认禁用JavaScript宏，需修改容器内/root/.config/libreoffice/4/user/registrymodifications.xcu，添加或修改配置：

  <item oor:path="/org.openoffice.Office.Security/Scripting">
      <prop oor:name="AllowJavaScript" oor:op="fuse">
          <value>true</value>
      </prop>
  </item>
  

3. 转换命令的合理性修正 #

你的命令存在参数顺序和格式问题，修正要点如下：

• 参数顺序：macro:///参数需放在文档路径之前，因为它是指定打开文档时执行的操作；--convert-to参数放在文档路径之后。
• 宏参数传递：${words}需是合法的JavaScript数组格式（比如["word1","word2"]），且要做好Shell转义，避免空格或特殊字符导致解析错误。
• 冗余参数：--invisible在--headless模式下冗余，可去掉。

修正后的命令示例（Node.js生成时注意转义）：

libreoffice --headless --norestore "macro:///home/macros.highlight([\"word1\",\"word2\"])" --convert-to pdf path/to/file

也可使用--execute-macro参数替代macro:///，格式更清晰：

libreoffice --headless --norestore --convert-to pdf path/to/file --execute-macro "home.macros.highlight([\"word1\",\"word2\"])"

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