docbook-2-pdf - Online w chmurze

PROGRAM:

IMIĘ

sgml2x — łatwo formatuje dokumenty SGML/XML przy użyciu arkuszy stylów DSSSL

STRESZCZENIE

sgml2x [Opcje] [plik sgml | plik xml ]

klasa dokumentów-2-format docelowy [Opcje] [plik sgml | plik xml ]

Opis

sgml2x pozwala łatwo sformatować dokument SGML lub XML przy użyciu arkuszy stylów DSSSL oraz
zapewnia następujące funkcje:

· Wiele możliwych arkuszy stylów na klasę dokumentu

· Łatwa specyfikacja arkuszy stylów przy użyciu aliasów, z obsługą parametrów
dziedzictwo

· Łatwa integracja nowych arkuszy stylów poprzez dodanie prostego nowego pliku definicji w formacie
katalog konfiguracyjny

· Osoba dzwoniąca może określić podobną do PATH listę katalogów konfiguracyjnych, domyślnie do
katalogi konfiguracyjne dla całego systemu, dla użytkownika i dla projektu

· Automatyczny wybór domyślnego arkusza stylów do użycia na podstawie przypisanego
Priorytety

· Przekaż dowolne opcje do jadeit(1)

Klasa dokumentu używana do wyszukiwania arkuszy stylów i format wyjściowy jest na razie
pochodzi tylko od nazwy, pod którą program jest wywoływany, więc będziesz chciał to nazwać
program za pomocą dowiązań symbolicznych, takich jak docbook-2-pdf.

sgml2x jest zaimplementowany jako opakowanie powłoki jadeit(1) (lub najlepiej otwarty jadeit(1),
chociaż używamy nazwy ogólnej jadeit w całej dokumentacji), jadeteks(1) i inne
narzędzia.

Jeżeli nie ma jadetex.cfg plik w pobliżu dokumentu, kopiowany jest domyślny, który umożliwia
produkcja zakładek PDF.

Opcje

-c|--katalog katalog
Użyj podanego katalogu SGML zamiast domyślnego systemu.

-C|--confdirs lista katalogów
Użyj (rozdzielonej spacjami) listy katalogów konfiguracyjnych. Ta opcja jest
kumulatywnie, tzn. można użyć kilku -C opcje i listy będą
połączone.

Elementy listy należy uporządkować według najbardziej ogólnej konfiguracji (np. obejmującej cały system)
do najbardziej szczegółowych (np. obejmujących cały projekt).

Jeśli za pomocą tej opcji udostępniony zostanie jakikolwiek katalog, zostanie domyślna lista katalogów
ignorowane.

-D|--dssslproc procesor dsssl
Zastosowanie procesor dsssl aby zastosować arkusz stylów zamiast domyślnego. Ten
procesor musi obsługiwać jadeit-podobne opcje, takie jak -V.

Gdy ta opcja nie jest dostępna, pierwsza znaleziona w pliku dssslproc pliki z confdirs to
zajęty. Widzieć "Pliki" by uzyskać więcej szczegółów.

-h|--help Wyświetl komunikat pomocy i wyjdź.

-j|--jadeit procesor dsssl
Przestarzały synonim słowa --dssslproc.

--jadetexfilter filtr perla
Przetwórz dane wyjściowe jadetex za pomocą filtra perla.

Może to być przydatne do wymuszenia podziału strony w określonych miejscach w celu pokonania arkusza stylów
problemy, lub wymuszać dzielenie wyrazów tam, gdzie TeX nie ma wystarczającej liczby wzorców, lub robić żadnych
inna sprytna transformacja, o której byś pomyślał.

Zobacz przykłady/wiersze poleceń plik do możliwych zastosowań.

-n|--brak działania
Drukuj polecenia zamiast je uruchamiać. Przydatne do nauki o niższym poziomie
narzędzi i do debugowania wiersza poleceń.

-o|--openjade
To zdjęcie opcja is przestarzały. otwarty jadeit jest teraz wartością domyślną, jeśli jest dostępna. Używać
--dssslproc lub dssslproc plik konfiguracyjny, aby wymusić określony procesor.

Ta opcja była używana otwarty jadeit(1) jako procesor DSSSL zamiast jadeit(1).

-O|--jadeopty jade-opcje
Dodatkowe opcje do przejścia jadeit(1). Ta opcja kumuluje się, możesz
określ kilka z nich, podane opcje zostaną połączone.

-q|--cichy
Ustaw gadatliwość na cichy

-r|--uwagi
Renderuj treść uwag do dokumentu w dokumencie (uwagę elementy w
Dokument 4, komentarz elementy w DocBook 3), dzięki czemu wytworzony wynik jest an
do użytku wewnętrznego dokument, drukując pogrubione ostrzeżenie na okładce.

Jest to funkcja specyficzna dla klasy docclass i arkusza stylów i nie wszystkie arkusze stylów będą z niej korzystać
to.

-s|--styl styl
Wybierz styl wyjściowy, aby zastąpić domyślny (ewentualnie pochodzący z dokumentu).

Dostępne są obecnie style dla określonej klasy dokumentów i dla każdego formatu wyjściowego
zależy od zawartości katalogów konfiguracyjnych i może być wyświetlany z rozszerzeniem
--help opcja.

Zauważ, że dobrą praktyką jest określenie tej opcji w procedurze kompilacji, aby uzyskać
powtarzalne wyniki niezależnie od dostępnych arkuszy stylów.

-v|--gadatliwy
Zwiększ gadatliwość. Tę opcję można określić wielokrotnie.

--gadatliwość N
Ustaw gadatliwość na N. Poziomy gadatliwości są zdefiniowane w następujący sposób:

cichy Tylko błędy w druku

domyślnym Drukuj tylko błędy i ostrzeżenia

gadatliwy Drukuj również ogłoszenia

wyśledzić Drukuj także ważne polecenia podczas ich uruchamiania (np --brak działania czy).

debug Drukuj również komunikaty debugowania

-V|--wersja
Wydrukuj wersję programu i wyjdź.

systemu

sgml2x używa drzewa katalogów konfiguracyjnych zamiast pliku konfiguracyjnego, więc tak jest
łatwe podłączanie innych pakietów przy niskim ryzyku uszkodzenia istniejącej konfiguracji.

Hierarchie stylów znajdują się w katalogach o nazwie style w każdej konfiguracji
informator. Stare wersje tego programu służyły do ​​umieszczania tych hierarchii bezpośrednio w pliku
katalogi konfiguracyjne.

Katalog konfiguracyjny zawiera jeden katalog dla każdej znanej klasy dokumentów o nazwie
pseudonim klasy dokumentu (np dokumentacja). Te katalogi docclass zawierają jeden pod-
katalog dla każdej klasy formatu wyjściowego (obecnie tylko html i są obsługiwane).

Obecnie problemy z implementacją wymuszają ograniczenie pseudonimów dla klas dokumentów
i arkusze stylów: mogą zawierać tylko znaki alfanumeryczne i podkreślenia. Ten
ograniczenie może zostać usunięte w przyszłej wersji, ale nie nastąpi to wcześniej
skrypt zostanie przepisany w innym języku.

Każdy z tych katalogów zawiera jeden plik na dostępny styl. Nazwy tych plików
mogą zawierać tylko znaki alfanumeryczne i są używane jako pseudonimy dla stylów. Ten
plik zawiera linie z a klawisz: wartość wzór, przy czym następujące klucze są obecnie
utrzymany:

Id Publiczny identyfikator arkusza stylów

asc Krótki opis stylów, które mają być wyświetlane w komunikacie pomocy

pdfZastąp, psOverride,
rtfOverride, mifZastąp" 10 Symbol dsssl z arkusza stylów wydruku do ustawienia
do #t (lub a symbol=wartość para, odpowiednia jako argument do jadeit's -V opcja),
do wykorzystania w danym formacie wydruku.

Dozwolony jest tylko jeden symbol na linię nadpisania. Aby zdefiniować wartości dla kilku symboli, użyj
kilka linii.

Dziedziczy Pseudonim arkusza stylów, z którego ten dziedziczy, aby uniknąć niepotrzebnego
powielanie definicji stylu.

Obecnie powoduje to tylko dziedziczenie *Nadpisanie parametry.

Priorytet Dodatnia liczba całkowita ułatwiająca wybór domyślnego stylu, gdy nie można go wybrać
pochodzi z dokumentu. Wyższe wartości mają większe szanse na bycie wziętym za
domyślny. Zadbaj o używanie niskich priorytetów dla hiper-wyspecjalizowanych stylów dla a
ogólny typ dokumentu, aby nie został użyty przez pomyłkę.

Na przykład bieżąca zalecana polityka dotycząca arkuszy stylów DocBook, wywodząca się z
Norman Walsh jest następujący (i może ulec zmianie, jeśli doświadczenie okaże się niewystarczające).

10 Podstawowe arkusze stylów, które zwykle muszą być dostosowane.

0 Każdy arkusz stylów, który został napisany w celu hiperspecjalistycznym (np
marketingowa karta produktu).

1000 Domyślny styl dla wszystkich dokumentów tworzonych przez organizację. zwykle
lekka personalizacja, obejmująca preferencje układu, organizacji
logo lub coś w tym stylu.

10-100 Różne ogólne dostosowania podstawowych arkuszy stylów.

Kiedy piszesz ulepszoną wersję arkusza stylów z priorytetem n, Ty
zwykle chcą wybrać wyższy priorytet.

Akta

/etc/sgml/sgml2x/

~/.sgml2x/

./sgml2x/ Domyślne katalogi konfiguracyjne, w których znajdują się pliki konfiguracyjne
szukałem. Zobacz dokumentację dot --confdirs by uzyskać więcej szczegółów.

poufać/styl/
Hierarchia definiująca użyteczne style. Widzieć "Konfiguracja" więcej
detale.

poufać/dssslproc
Plik zawierający uporządkowaną listę procesorów dsssl do wyszukania, oddzielonych od siebie
nowe linie i/lub spacje. Linie zaczynające się od a # charakter traktuje się jako
uwagi. Wspólne wartości to m.in otwarty jadeit i jadeit.

Określone tutaj procesory DSSSL powinny akceptować -V i -D kompatybilny z jadeitem
opcje wiersza polecenia.

Katalogi konfiguracyjne są przeszukiwane począwszy od najbardziej szczegółowych
jeden, dzięki czemu przy domyślnych confdirs ustawienia projektu mogą zastąpić użytkownika
ustawień, które z kolei mogą zastąpić ustawienia systemowe.

Specjalna wartość fałszywy można użyć do zatrzymania wyszukiwania i uniemożliwienia zaglądania
bardziej ogólne katalogi. Jeśli na przykład projekt musi używać
openjade-1.4devel polecenie i żadne inne, może określić openjade-1.4devel fałszywy
w tym dssslproc plik.

Ostrzeżenia

Podczas używania openjade-1.4devel jako procesor DSSSL, zobaczysz skargę na top-
obiekt przepływu poziomu generowany przez typ_doc.dsloraz automatyczne określanie dokumentu
typu nie powiedzie się. Poza tym ten błąd jest nieszkodliwy. Pomysły, jak sobie z tym poradzić, lub
potwierdzenie tego openjade-1.4devel jest zbyt surowy, zostanie doceniony :)

Połączenia przyszłość

Planowane funkcje dla przyszłych wydań obejmują:

· Integracja generatora indeksów

· Integracja ładnego silnika drukowania dla przykładów kodu

· Specyfikacja przekształceń, które mają być powiązane

· Deklaracja podzbioru docclasses, aby umożliwić użycie z dowolną docclass stylu-
arkusze, które mają zastosowanie do jego docclass nadzbiorów.

· Pracuj w tymczasowej lokalizacji, aby nie zanieczyszczać katalogu roboczego
pliki tymczasowe. To nie jest tak proste, jak się wydaje, ponieważ psuje dokument
odnosi się do plików obrazów przy użyciu ścieżek względnych. To może być postrzegane jako jadeitowy błąd,
jednak.

Przejrzyj pełną listę TODO i prześlij nam więcej pomysłów!

prawo autorskie

Prawa autorskie © 2001-2003 Alcove & Yann Dirson.

sgml2x jest na licencji GNU General Public License, wersja 2.

Niniejsza dokumentacja jest objęta licencją GNU Free Documentation License, wersja 1.

Kontakt us

sgml2x jest częścią AlkowaKsiążka projekt (połączyć do URL http://www.alcove-
labs.org/en/software/alcovebook/) . Proszę użyć AlkowaKsiążka pocztowy wykazy (połączyć do URL
https://savannah.gnu.org/mail/?group_id=533) aby skontaktować się z programistami i użytkownikami.

Lista błędów i propozycji funkcji jest dostępna przez a Sieć Interfejs (połączyć do URL
https://savannah.gnu.org/support/?group_id=533) . Użyj go do zgłaszania problemów i
pomysły.

See również

otwarty jadeit(1), jadeit(1), jadeteks(1), collateindex.pl(1).

sgml2x(1)

Skorzystaj z dokumentu docbook-2-pdf online, korzystając z usług onworks.net