Pomoc - Skorzystaj z GemDoc

Start

Dokumentacja

Narzędzia

Skorzystaj z GemDoc

GemDoc umożliwia konwersję dokumentów przygotowanych np. w edytorach XML na dokumenty w formacie HTML, RTF, PDF czy PostScript. Program możesz pobrać np. na stronie projektu - www.docbook.org.

GemDoc-01

To jest pierwsze okno dialogowe GemDoc.

Wybierz PDF z listy Format dokumentu [Document Formats].

W grupie opcji Select Source to Publish [Wybierz dokument źródłowy do publikacji], kliknij przycisk Select [Wybierz]. W oknie dialogowym wskaż plik XML, który chcesz opublikować (wcześniej wybierz w oknie dialogowym Plik typu opcję All files [Wszystkie pliki]- program standardowo wybiera pliki typu SGML, SGM. Po dokonaniu wyboru poniżej w polu pojawi się wybrany plik, np.

E:Apachehtdocsprojectsmambo45_manualsenglishdocdoc_manual.xml

Następnie kliknij zakładkę PDF.

GemDoc-02

Wybierz z listy Category [Kategoria] opcję Page Size [Rozmiar strony] i zmień go na A4 lub inny.

Następnie kliknij zakładkę SGML.

GemDoc-03

W opcji UseGemDoc DSSSL Stylesheet [Zastosuj arkusz stylu GemDoc DSSSL] wybierz opcję 3 - No Toc Not Numbered [Nie numeruj nagłówków, tytułów].

Jeśli masz w swoim dokumencie obrazy, skonfiguruj opcję Additional Image Folder [Dodatkowy folder obrazów]. Przyjmijmy, że Twoje ilustracje są w pokatalogu /images, katalogu, w którym znajduje się plik źródłowy XML. W takim przypadku wpis w polu Additional Image Folder powinien wyglądać następująco:

E:Apachehtdocsprojectsmambo45_manualsenglishdocimages

Twoje obrazy winny w dokumencie XML w tym przypadku mieć następujący atrybut parametru fileref: images/publish.png.

Następnie wybierz zakładkę Folders/Settings [Foldery/Ustawienia].

GemDoc-04

Zaznacz opcję Folder Containing Source File [Folder zawierający pliki źródłowe].

Odznacz obie opcje w grupie Subfolders [Podfoldery].

Wróć do zakładki Publish Tab [Publikacja]. Kliknij przycisk Publish [Publikuj] u dołu okna dialogowego. Zwróć uwagę na komunikaty błędów, jakie pojawią się podczas sprawdzania (walidacji). Będą one zwykle spowodowane nieakceptowanymi znakami wprowadzanymi do dokumentu w trakcie kopiowania i wklejania. Po zakończeniu procesu walidacji kliknij przycisk Continue [Kontynuuj]. A po zakończeniu całego procesu przetwarzania dokumentu przycisk View File [Pokaż plik] w opcjach Widok Folder z opublikowanymi dokumentami [Katalog].

Uwagi, źródła

Jeżeli masz sugestie odnośnie treści lub chcesz zgłosić poprawki do tego rozdziału, skomentuj go albo umieść wiadomość na forum: Dokumentacja - Propozycje, zmiany, poprawki

Dziękujemy!

Stefan Wajda, Zespół Dokumentacji PCJ

Na podstawie: www.g1c.com/gemdoc/docs
GNU/FDL

Zmieniony ( 09.10.2005. )