Starting Collabora Office Software With Parameters

通过从命令行启动 Collabora Office 软件,可以指定各种参数。利用这些参数,可以影响软件的性能。仅建议有经验的用户使用命令行参数。

note

对于一般操作,没有必要使用命令行参数。而某些参数则要求用户具备较多的 Collabora Office 软件技术的背景知识。


从命令行启动 Collabora Office 软件

Collabora Office requires write access to its user profile directory.

有效的命令行参数

不使用特殊参数

不使用任何参数可打开「启动中心」。

{文件}

尝试在相应的组件中打开文件 (一个或多个)。

{file} macro://./[Library.Module.MacroName]

打开文件并应用文件中的指定宏。


获取帮助与信息

参数

含义

--help / -h / -?

列出控制台可用的命令行参数。

--helpwriter

打开 Collabora Office Writer 的内置或在线「帮助」。

--helpcalc

打开 Collabora Office Calc 的内置或在线「帮助」。

--helpdraw

打开 Collabora Office Draw 的内置或在线「帮助」。

--helpimpress

打开 Collabora Office Impress 的内置或在线「帮助」。

--helpbase

打开 Collabora Office Base 的内置或在线「帮助」。

--helpbasic

打开 Collabora Office 关于 Basic 编程语言的内置或在线「帮助」。

--helpmath

打开 Collabora Office 关于 Math 的内置或在线「帮助」。

--version

显示 Collabora Office 版本并退出。

--nstemporarydirectory

(仅 macOS 沙盒) 返回当前用户的临时目录路径并退出。替代所有其他参数。


常规参数

参数

含义

--quickstart[=no]

激活[取消激活]「快速启动器」服务。只接收一个参数「no」,用于关闭「快速启动器」服务。不加参数则激活该服务。

--nolockcheck

禁用使用当前安装版本的远程实例检测。

--infilter=InputFilterName
[:InputFilterParam[,param]]

强制输入筛选器类型 (如果可能)。例如:

--infilter="Calc Office Open XML"

--infilter="Text (encoded):UTF8,LF,Liberation Mono,en-US".

--pidfile={file}

将 soffice.bin 的进程 ID (pid) 存储到「{文件}」。

--display {display}

Sets the DISPLAY environment variable on UNIX-like platforms to the value {display}. This parameter is only supported by the start script for Collabora Office software on UNIX-like platforms.


用户/程序界面控制

参数

含义

--nologo

程序启动时禁用启动屏幕。

--minimized

以最小化方式启动。不显示启动屏幕。

--nodefault

启动时只显示启动屏幕。

--invisible

以隐藏模式启动。

启动徽标和初始程序窗口均将不可见。可以通过 API 控制 Collabora Office 软件,以及控制/打开文档和对话框。

使用该参数,允许 Collabora Office 被「任务管理器」(Windows) 或「kill」命令 (类 UNIX 系统) 终止。

不能与「-quickstart」一同使用。

如需更多信息,请参阅《Collabora Office 开发者指南》。

--headless

以「无界面模式」启动,此模式允许不通过用户界面使用应用程序。

当外部客户端通过 API 控制应用程序时,可以使用此特殊模式。

--norestore

在发生系统崩溃后禁用重新启动和文件恢复。

--safe-mode

以「安全模式」启动,即临时用全新的用户配置文件启动,有助于恢复损坏的配置。

--accept={UNO}

通知 Collabora Office 软件,在创建「UNO 接收器线程」时使用「UNO 接收字符串」。

UNO-URL 是类似这样的字符串「uno:连接类型,参数;协议名称,参数;对象名称」。

如需更多信息,请参阅《Collabora Office 开发者指南》。

--unaccept={UNO-URL}

关闭通过「--accept={UNO-URL} 创建的接收器。使用 --unaccept=all」可关闭所有打开的接收器。

--language={lang}

使用指定的语言,如果该语言尚未选择应用于 UI。语言必须为合法的 IETF 语言标签。


开发者参数

参数

含义

--terminate_after_init

初始化完成后退出 (不加载文档)。

--eventtesting

加载文档后退出。


新建文档参数

note

这些参数可创建指定类型的空文档。一个命令行中只能使用其中一种。如果参数后指定了文件名,则尝试在指定组件中打开这些文件。


参数

含义

--writer

启动空白的 Writer 文档。

--calc

启动空白的 Calc 文档。

--draw

启动空白的 Draw 文档。

--impress

启动空白的 Impress 文档。

--math

启动空白的 Math 文档。

--global

启动空白的 Writer 主控文档。

--web

启动空白的 HTML 文档。


文件打开参数

note

这些参数定义如何对待后续的文件名。一个参数之后、下一个参数之前的部分将单独对待。默认行为是打开用于编辑,以及从文档模版新建文档。


参数

含义

-n

将后续文件视为创建新文档的模版。

-o

将后续文件打开用于编辑,无论是否为模版。

--pt {Printername}

使用打印机「{打印机名称}」打印后续文件并结束。不会出现启动屏幕。

如果文件名含有空格,则必须在名称前后加上引号。

如果多次使用,只有最后一个「{打印机名称}」对所有文档的所有「--pt」命令有效。

此外,「--print-to-file 开关的「--printer-name」参数与 {Printername}」冲突。

-p

使用默认打印机打印后续文件,随后关闭文件。不会出现启动屏幕。

如果文件名含有空格,则必须在名称前后加上引号。

--view

以查看模式 (只读) 打开后续文件。

--show

打开并立即开始后续演示文稿文档的放映。放映结束后将关闭文件。除 Impress 文档外的其他文件将以默认模式打开,无论之前为何模式。

--convert-to OutputFileExtension
[:OutputFilterName
[:OutputFilterParams[,param]]]
[--outdir output_dir]

If --convert-to is used more than once, last value of OutputFileExtension[:OutputFilterName[:OutputFilterParams]] is effective. If --outdir is used more than once, only its last value is effective. In absence of --outdir, current working directory is used for the result. For example:

--convert-to pdf *.doc

--convert-to pdf:writer_pdf_Export --outdir /home/user *.doc

--convert-to "html:XHTML Writer File:UTF8" *.doc

--convert-to "txt:Text (encoded):UTF8" *.doc

请参阅用于文件转换的文档筛选器列表

The list of filter options for Lotus, dBase and Diff files.

The list of filter options for CSV files.

The list of filter options for PDF files.

--print-to-file [--printer-name printer_name] [--outdir output_dir]

批量将文件打印为文件。如果未指定「--outdir」,则当前工作目录将用作「输出目录」。

如果多次使用「--printer-name」或「--outdir」,只有最后一次给出的值有效。另外,「--pt 开关的「{打印机名称}」与 --printer-name」冲突。例如:

--print-to-file *.doc

--print-to-file --printer-name nasty_lowres_printer --outdir /home/user *.doc

--cat

将筛选器「txt:Text」应用于以下文本文档, 并将文本内容转储到控制台 (隐含「--headless」)。不能与「--convert-to」一起使用。

-env:VAR[=VALUE]

Set a bootstrap variable. For example, to set a non-default user profile path:


忽略的开关

参数

含义

-psn

忽略 (仅 macOS)

-Embedding

忽略 (COM+ 相关; 仅 Windows)

--nofirststartwizard

不执行任何操作,仅为向下兼容而接收。

--protector {arg1} {arg2}

仅在单元测试中使用,应有两个参数。


请支持我们!