Uruchamianie programów pakietu LibreOffice z podaniem parametrów

Programy pakietu LibreOffice można uruchamiać z podaniem różnych parametrów mających wpływ na działanie tych programów. Korzystanie z parametrów wiersza poleceń zaleca się tylko doświadczonym użytkownikom.

Ikona notatki

W zwykłej pracy korzystanie z parametrów wiersza poleceń nie jest konieczne. Niektóre parametry wymagają dokładnej znajomości aspektów technicznych oprogramowania LibreOffice.


Uruchamianie programów pakietu LibreOffice z wiersza poleceń

  1. W systemie Windows, należy wybrać polecenie Uruchom z menu Start lub otworzyć powłokę w systemach LInux, *BSD lub macOS.

  2. W systemie Windows w polu Otwórz wpisz następujący tekst i kliknij przycisk OK.

  3. W systemach uniksowych, należy wpisać następującą linię tekstu i nacisnąć przycisk Return:

    Replace {install} with the path to your installation of LibreOffice software (for example, C:\Program Files\Office in Windows, or ~/office in UNIX)

Obsługiwane parametry wiersza poleceń

Używanie bez specjalnych argumentów

Użycie bez argumentów otwiera planszę startową.

{file}

Próbuje otworzyć pliki w odpowiednich dla nich komponentach.

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

Otwiera plik i stosuje określone makra z pliku.


Uzyskiwanie pomocy i informacji

Parameter

Znaczenie

--help / -h / -?

Wyświetla dostępne parametry linii poleceń do konsoli.

--helpwriter

Otwiera wbudowany lub dostępny online podręcznik pomocy LibreOffice Writer.

--helpcalc

Otwiera wbudowany lub dostępny online podręcznik pomocy LibreOffice Calc.

--helpdraw

Otwiera wbudowany lub dostępny online podręcznik pomocy LibreOffice Draw.

--helpimpress

Otwiera wbudowany lub dostępny online podręcznik pomocy LibreOffice Impress.

--helpbase

Otwiera wbudowany lub dostępny online podręcznik pomocy LibreOffice Base.

--helpbasic

Otwiera wbudowany lub dostępny online podręcznik pomocy języka skryptowego LibreOffice Basic.

--helpmath

Otwiera wbudowany lub dostępny online podręcznik pomocy LibreOffice Math.

--version

Pokazuje wersję LibreOffice i kończy pracę.

--nstemporarydirectory

(Tylko piaskownica w systemie macOS) Zwraca ścieżkę do katalogu tymczasowego dla bieżącego użytkownika i kończy pracę. Zastępuje wszystkie inne argumenty.


Ogólne argumenty

Parameter

Znaczenie

--quickstart[=no]

Aktywuje [Dezaktywuje] usługę Quickstarter. Może pobierać tylko jeden parametr no, który dezaktywuje usługę Quickstarter. Bez parametrów, usługa jest włączana.

--nolockcheck

Wyłącza sprawdzania obecności zdalnych instancji w trakcie instalacji.

--infilter={filter}

Wymusza typ filtra wejściowego, jeśli jest to możliwe. Na przykład:
--infilter="Calc Office Open XML"
--infilter="Text (encoded):UTF8,LF,,,."

--pidfile={file}

Zapisz identyfikator PID procesu soffice.bin do {file}.

--display {display}

Ustawia zmienną środowiskową DISPLAY w systemach uniksowych na wartość {display}. Parametr ten obsługiwany jest tylko przez skrypt startowy oprogramowania LibreOffice w systemach uniksowych.


Kontrola interfejsu programistycznego/użytkownika

Parameter

Znaczenie

--nologo

Wyłącza wyświetlanie ekranu powitalnego.

--minimized

Uruchamia program w postaci zminimalizowanej. Ekran powitalny nie jest wyświetlany.

--nodefault

Rozpoczęcie bez otwarcia okna.

--invisible

Uruchamia program w trybie niewidocznym.

Ekran powitalny i początkowe okno programu nie są wyświetlane. Oprogramowaniem LibreOffice można sterować przez interfejs API.

Jeśli oprogramowanie LibreOffice zostało uruchomione z tym parametrem, można zakończyć jego pracę tylko z poziomu Menadżera Zadań (Windows) lub z użyciem polecenia kill (w systemach uniksowych).

Tego parametru nie można używać w połączeniu z parametrem -quickstart.

Więcej informacji można znaleźć w podręczniku programisty LibreOffice Developer's Guide.

--headless

Uruchamia aplikację w trybie bez ekranu, umożliwia korzystanie z programu bez pośrednictwa interfejsu użytkownika.

Ten specjalny tryb może być wykorzystywany w przypadku, gdy aplikacja jest sterowana z poziomu zewnętrznego klienta przez interfejs API.

--norestore

Wyłącza funkcję ponownego uruchamiania programu i odzyskiwania plików po awarii.

--safe-mode

Uruchamia w trybie awaryjnym tj. uruchamia ze świeżym profilem użytkownika i pomaga przywrócić konfigurację, która uległa uszkodzeniu.

--accept={UNO}

Zawiadamia oprogramowanie LibreOffice, że po utworzeniu wątków "UNO Acceptor Thread" ma zostać zastosowany ciąg "UNO Accept String".

UNO-URL jest ciągiem rodzaju uno:connection-type,params;protocol-name,params;ObjectName.

Więcej informacji można znaleźć w podręczniku programisty LibreOffice Developer's Guide.

--unaccept={UNO-URL}

Zamyka akceptor utworzony przez polecenie --accept={UNO-URL}. Użycie polecenia --unaccept=all zamknie wszystkie akceptory.

--language={lang}

Używa określonego języka, jeśli język nie został jeszcze wybrany dla interfejsu użytkownika. Lang jest znacznikiem języka nadanym zgodnie z wytycznymi organizacji IETF.


Argumenty programistów

Parameter

Znaczenie

--terminate_after_init

Wyjdź po zakończeniu inicjalizacji (bez wczytywania dokumentów).

--eventtesting

Wyjdź po załadowaniu dokumentów.


Argumenty tworzenia nowych dokumentów

Ikona notatki

Argumenty tworzą pusty dokument określonego rodzaju. Tylko jeden z nich może być używany w jednej linii poleceń. Jeśli nazwy plików zostały określone po argumencie, wtedy program próbuje otworzyć te pliki w określonym komponencie.


Parameter

Znaczenie

--writer

Uruchamia program Writer z pustym dokumentem.

--calc

Uruchamia program Calc z pustym dokumentem.

--draw

Uruchamia program Draw z pustym dokumentem.

--impress

Uruchamia program Impress z pustym dokumentem.

--math

Uruchamia program Math z pustym dokumentem.

--global

Uruchamia program z pustym dokumentem globalnym.

--web

Uruchamia program z pustym dokumentem HTML.


Argumenty otwierania pliku

Ikona notatki

Argumenty definiują, jak traktowane są następujące nazwy plików. Nowa operacja rozpoczyna się po argumencie i kończy się przy następnym argumencie. Domyślnym zachowaniem jest otwarcie dokumentów do edycji i tworzenie nowych dokumentów z ich szablonów.


Parameter

Znaczenie

-n

Traktuje następujące pliki jako szablony, z których powstają nowe dokumenty.

-o

Otwiera następujące pliki do edycji, niezależnie od tego, czy są szablonami czy nie.

--pt {Printername}

Drukuje następujące pliki do drukarce {nazwa_drukarki} i kończy pracę. Ekran powitalny nie jest wyświetlany.

Jeśli nazwa pliku zawiera spacje, musi zostać umieszczona w cudzysłowie.

Jeśli użyto wielokrotnie, to tylko ostatni parametr {Printername} jest brany pod uwagę w przypadku wszystkich dokumentów wszystkich uruchomionych argumentów --pt.

Ponadto argument --printer-name parametru --print-to-file przełącza interfejsy wraz z {Printername}.

-p

Drukuje następujące pliki do domyślnej drukarki, po czym pliki te są zamykane. Ekran powitalny nie pojawia się.

Jeśli nazwa pliku zawiera spacje, musi zostać umieszczona w cudzysłowie.

--view

Otwiera następujące pliki w trybie przeglądarki (tylko do odczytu).

--show

Natychmiast otwiera i uruchamia następujące dokumenty prezentacji. Pliki są zamykane po pokazie. Pliki inne niż dokumenty Impress są otwierane w trybie domyślnym, niezależnie od poprzedniego trybu.

--convert-to OutputFileExtension[:OutputFilterName] [--outdir output_dir]

Grupuje konwertowane pliki (implikuje argument --headless). Jeśli nie podano parametru --outdir, jako folder wyjściowy jest używany bieżący katalog roboczy.

Jeśli polecenie --convert-to jest używane więcej niż jeden raz, ostatnia wartość OutputFileExtension[:OutputFilterName] jest brana pod uwagę. Jeśli parametr --outdir jest używany więcej niż jeden raz, tylko jego ostatnia wartość jest brana pod uwagę. Na przykład:

--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

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

Grupuje pliki do wydruku w jeden plik. Jeśli nie podano parametru --outdir, jako folder wyjściowy używany jest bieżący katalog roboczy.

Jeśli --printer-name lub --outdir użyto wielokrotnie, to tylko ostatnia wartość każdego z parametrów jest brana pod uwagę. Ponadto {Printername} parametru --pt przełącza interfejsy wraz z --printer-name. Na przykład:

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

--cat

Zrzuć zawartość tekstową następujących plików do konsoli (implikuje argument --headless). Nie można go używać z -- convert-to.

-env:VAR[=VALUE]

Ustaw zmienną bootstrap. Na przykład: aby ustawić niestandardową ścieżkę profilu użytkownika:

-env:UserInstallation=file:///tmp/test


Ignorowane przełączniki

Parameter

Znaczenie

-psn

Ignorowany (macOS only)

-Embedding

Ignorowany (powiązany z COM+; tylko Windows)

--nofirststartwizard

Nic nie zmienia, zaakceptowany tylko dla zachowania kompatybilności wstecznej.

--protector {arg1} {arg2}

Używane tylko w testach jednostkowych i powinny mieć dwa argumenty.