Debian LibOffice如何使用宏功能

Debian 上 LibreOffice 宏功能使用指南

一 安装与准备

• 在 Debian 上安装 LibreOffice（若尚未安装）：
  • 更新索引并安装：sudo apt update && sudo apt install libreoffice
• 如需使用 Python 宏，建议安装扩展 APSO（Alternative Script Organizer for Python），便于创建、管理与编辑 Python 宏。
• 说明：LibreOffice 默认内置 Basic 宏支持；Python 宏需要安装扩展并放置到指定目录后方可使用。

二 启用宏与信任设置

• 打开 LibreOffice（如 Writer/Calc）→ 菜单 工具 → 选项 → 安全性 → 宏设置，选择启用级别（例如：启用所有宏 或按需设置），以允许运行宏。
• 在 信任中心 中可将特定目录或文件设为受信任，以便在受限策略下仍能运行可信宏。

三 录制与运行宏

• 录制宏：菜单 工具 → 宏 → 录制宏，执行所需操作 → 停止。录制的宏会按位置（当前文档/全局）保存，后续可直接运行。
• 运行宏：菜单 工具 → 宏 → 运行宏，选择目标宏执行；也可将宏分配给工具栏按钮或事件（如文档打开时）以便一键触发。

四 使用 Python 宏

• 安装 APSO 扩展后，可通过 工具 → 宏 → 组织 Python 脚本（Organize Python Scripts） 创建/编辑/删除 Python 宏。
• Python 宏的存放位置（容器）与层级：
  • 用户宏：$HOME/.config/libreoffice/4/user/Scripts/python（Linux）
  • 应用宏：{安装目录}/share/Scripts/python
  • 文档宏：嵌入文档内部，仅当文档打开时可访问
  • 层级：库（文件夹）→ 模块（.py 文件）→ 宏（函数）
• 最小可用示例（保存为模块中的函数，例如 mymodule.py）：
  • 说明：LibreOffice Python 宏通过全局对象 XSCRIPTCONTEXT 获取桌面/文档等 UNO 对象。
  • 示例：
    • def greet():
      • document = XSCRIPTCONTEXT.getDocument()
      • text = document.getText()
      • cursor = text.createTextCursor()
      • text.insertString(cursor, “Hello from LibreOffice Python macro!\n”, 0)
• 运行：在 工具 → 宏 → 运行宏 中选择刚创建的 Python 函数执行。

五 命令行执行与自动化

• 无界面执行宏（适合批处理/服务器场景）：
  • 基本语法：libreoffice --headless --invisible --macro <宏名称> [文件路径]
  • 示例：libreoffice --headless --invisible --macro “mymodule.greet” /path/to/document.odt
• 其他常用命令行能力（便于与宏配合完成批量工作流）：
  • 转换格式：libreoffice --headless --convert-to pdf /path/to/file.odt
  • 打印到文件/打印机：libreoffice --headless -p /path/to/file.odt 或 –print-to-file
  • 指定组件启动：libreoffice --writer /path/to/file.odt
• 如通过 Flatpak 安装，需使用：flatpak run org.libreoffice.LibreOffice --headless --macro “mymodule.greet” /path/to/file.odt
• 安全提示：宏可能带来安全风险，尤其是来源不明的宏。建议仅启用来自可信来源的宏，并在受控环境中测试运行。