13.7. Generowanie dokumentacji do pliku PDF przy użyciu programu OpenOffice.org

Do generowania plików PDF wykorzystany został odpowiednio skonfigurowany program OpenOffice.org. Aby go wstępnie skonfigurować należy:

Zainstalować pakiet (tylko w przypadku OpenOffice.org 2.X):

# apt-get install openoffice.org-headless
		

który umożliwia wykonywanie skryptów StarBasic z linii poleceń.

oraz pakiet (zarówno dla wersji 2.X jak i 3.X):

# apt-get install openoffice.org-l10n-pl
		

który jest niezbędny do wykonywania skryptów StarBasic napisanych przy użyciu spolszczonych parametrów funkcji.

Na koncie użytkownika, na którym będzie dokonywana konwersja zainstalować następujący skrypt:

OpenOffice.org wersja 2.X

$ cp ~/programy/trunk/utils/docgen/Module1.xba ~/.openoffice.org2/user/basic/Standard/
		

OpenOffice.org wersja 3.X

$ cp ~/programy/trunk/utils/docgen/Module1.xba ~/.openoffice.org/3/user/basic/Standard/
		

UWAGA! Przed dalszymi czynnościami należy zapisać i zamknąć wszystkie otwarte dokumenty w OpenOffice.org gdyż istnieje ryzyko utraty danych!

W celu wygenerowania dokumentacji w formacie PDF należy wykonać polecenie:

$ ./docgen.pl weze -f -p
		

W przypadku, gdy chcemy, aby pierwsza strona nie zaczynała się od "1", tylko od dowolnej liczby, należy wydać polecenie:

$ ./docgen.pl weze -f -o <przesunięcie>
		

gdzie: <przesunięcie> - liczba pierwszych stron jakie mają być pominięte. Przykładowo, jeśli istnieje potrzeba numeracji stron począwszy od "10" należy wydać polecenie:

$ ./docgen.pl weze -f -o 9
		

Generowanie dokumentacji w formacie PDF jest procesem bardziej złożonym niż html dlatego też jest procesem dużo dłuższym i trwa przeciętnie od kilku do kilkunastu sekund.