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.

Neither the start-up logo nor the initial program window will be visible. LibreOffice software can be controlled, and documents and dialogs can be controlled and opened via the 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.

This special mode can be used when the application is controlled by external clients via the 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

Ignored (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.