db2x_xsltproc — online w chmurze

PROGRAM:

IMIĘ

db2x_xsltproc — opakowanie wywołania procesora XSLT

STRESZCZENIE

db2x_xsltproc [Opcje] dokument xml

OPIS

db2x_xsltproc wywołuje procesor XSLT 1.0 dla docbook2X.

To polecenie stosuje arkusz stylów XSLT (zwykle podawany przez --arkusz stylów opcja) do
Dokument XML w pliku dokument xml. Wynik jest zapisywany na standardowe wyjście (chyba że
zmieniono z --wyjście).

Aby odczytać źródłowy dokument XML ze standardowego wejścia, określ - jako dokument wejściowy.

OPCJE

--wersja
Wyświetl wersję docbook2X.

TRANSFORMACJA WYDAJNOŚĆ OPCJE
--wyjście filet, -o filet
Zapisz dane wyjściowe do podanego pliku (lub identyfikatora URI) zamiast na standardowe wyjście.

ŹRÓDŁO DOKUMENT OPCJE
--xuwzględnij, -I
Przetwarzaj dyrektywy XInclude w dokumencie źródłowym.

--sgml, -S
Wskaż, że dokumentem wejściowym jest SGML, a nie XML. Potrzebujesz tego zestawu to
opcja, jeśli dokument xml jest w rzeczywistości plikiem SGML.

Parsowanie SGML jest realizowane poprzez konwersję do XML za pomocą sgml2xml(1) z SP
pakiet (lub osx(1) z pakietu OpenSP). Wszystkie nazwy tagów w pliku SGML będą
znormalizowane do małych liter (tj -xniższy opcja sgml2xml(1) jest używany). NS
atrybuty są dostępne dla arkusza stylów (np. opcja -xid). Ponadto wszelkie
Jednostki ISO SDATA użyte w dokumencie SGML są automatycznie konwertowane na ich
Odpowiedniki XML Unicode. (Odbywa się to przez a sed filtr.)

Kodowanie dokumentu SGML, jeśli nie jest to us-ascii, musi być określone za pomocą
standardowe zmienne środowiskowe SP: SP_CHARSET_FIXED=1 SP_KODOWANIE=kodowanie.
(Zauważ, że pliki XML określają swoje kodowanie za pomocą deklaracji XML <?xml
wersja="1.0" kodowanie = "kodowanie" ?> u góry pliku.)

Powyższe opcje konwersji nie mogą zostać zmienione. Jeśli pragniesz innego nawrócenia
opcje, które powinieneś wywołać sgml2xml(1) ręcznie, a następnie przekaż wyniki tego
konwersja do tego programu.

WYSZUKIWANIE OPCJE
--katalogi katalog-pliki, -C katalog-pliki
Określ dodatkowe katalogi XML, które będą używane do rozwiązywania formalnych identyfikatorów publicznych lub
URI. Katalogi SGML nie są obsługiwane.

Te katalogi są nie używany do parsowania dokumentu SGML w ramach --sgml opcja.
Użyj zmiennej środowiskowej SGML_CATALOG_FILES zamiast tego określić katalogi dla
parsowanie dokumentu SGML.

--sieć, -N
db2x_xsltproc normalnie odmówi załadowania zasobów zewnętrznych z sieci, ponieważ
względy bezpieczeństwa. Jeśli chcesz ładować z sieci, ustaw tę opcję.

Zwykle chcesz zainstalować lokalnie odpowiednie DTD i inne pliki, i
skonfigurować dla nich katalogi, zamiast ładować je automatycznie z sieci.

ARKUSZ STYLÓW OPCJE
--arkusz stylów filet, -s filet
Określ nazwę pliku (lub identyfikator URI) arkusza stylów do użycia. Szczególne wartości człowiek i
texi są akceptowane jako skróty, aby określić, że dokument xml jest w DocBooku i
należy przekonwertować na strony man lub Texinfo (odpowiednio).

--parametr Nazwa=expr, -p Nazwa=expr
Dodaj lub zmodyfikuj parametr do arkusza stylów. Nazwa jest nazwą parametru XSLT, a
expr to wyrażenie XPath, którego wynikiem jest żądana wartość parametru.
(Oznacza to, że ciągi znaków muszą być ujęte w cudzysłów, in dodatek do zwykłego cytowania powłoki
argumenty; posługiwać się --parametr ciągu uniknąć tego.)

--parametr ciągu Nazwa=ciąg, -g Nazwa=ciąg
Dodaj lub zmodyfikuj parametr o wartości ciągu do arkusza stylów.

Ciąg musi być zakodowany w UTF-8 (niezależnie od kodowania znaków regionalnych).

DEBUGOWANIE ROLNICZE PROFILOWY
--odpluskwić, -d
Wyświetlaj, do standardowego błędu, logi tego, co dzieje się podczas XSL
transformacja.

--limit-zagnieżdżania n, -D n
Zmień maksymalną liczbę zagnieżdżonych wywołań na szablony XSL, używane do wykrywania
potencjalne nieskończone pętle. Jeśli nie jest określony, limit wynosi 500 (wartość domyślna libxslt).

--profil, -P
Wyświetl informacje o profilu: łączna liczba połączeń do każdego szablonu w
arkusz stylów i czas poświęcony na każdy z nich. Ta informacja jest wyprowadzana do standardu
Błąd.

--xslt-procesor edytor, -X edytor
Wybierz bazowy używany procesor XSLT. Możliwe wybory dla edytor należą:
libxslt, saksoński, xalan-j.

Domyślnym procesorem jest to, co zostało ustawione podczas kompilowania docbook2X. libxslt to
zalecany (bo jest szczupły i szybki), ale SAXON jest znacznie solidniejszy i nie
być bardziej pomocnym podczas debugowania arkuszy stylów.

Wszystkie procesory mają włączoną obsługę katalogów XML. (docbook2X tego wymaga.)
Pamiętaj jednak, że nie wszystkie powyższe opcje działają z procesorami innymi niż libxslt
jeden.

ŚRODOWISKO

PLIKI_XML_CATALOG_
Określ katalogi XML. Jeśli nie określono, katalog standardowy (/etc/xml/katalog) jest
załadowany, jeśli jest dostępny.

DB2X_XSLT_PROCESOR
Określ procesor XSLT, który ma być używany. Efekt jest taki sam jak --xslt-procesor
opcja. Podstawowym zastosowaniem tej zmiennej jest umożliwienie szybkiego testowania różnych
Procesory XSLT bez konieczności dodawania --xslt-procesor do każdego skryptu lub tworzenia pliku
w twoim systemie budowania dokumentacji.

ZGODNE DO

XML Stylesheet Language – Transformations (XSLT), wersja 1.0 ⟨http://www.w3.org/TR/xslt⟩
, zalecenie W3C.

UWAGI

We wcześniejszych wersjach (< 0.8.4) docbook2X wymagał rozszerzeń XSLT do uruchomienia i
db2x_xsltproc był specjalnym procesorem opartym na libxslt, który miał wkompilowane te rozszerzenia.
Kiedy zrezygnowano z wymagań dotyczących rozszerzeń XSLT, db2x_xsltproc stał się skryptem Perla
co tłumaczy opcje na db2x_xsltproc zgodne z formatem akceptowanym przez
stany magazynowe xsltproc(1) który jest dostarczany z libxslt.

Głównym powodem istnienia tego skryptu jest wsteczna kompatybilność z dowolnym
skryptów lub tworzyć pliki, które wywołują docbook2X. Jednak łatwo było również dodać
obsługa wywoływania innych procesorów XSLT z ujednoliconym interfejsem wiersza poleceń. W rzeczy samej,
w tym skrypcie nie ma nic specjalnego do docbook2X, a nawet do DocBook, a może to być
służy do uruchamiania innych rodzajów arkuszy stylów, jeśli chcesz. Z pewnością autor woli
za pomocą tego polecenia, ponieważ jego format wywołania jest rozsądny i łatwy w użyciu. (np. nie
wpisywanie długich nazw klas dla procesorów opartych na Javie!)

Użyj db2x_xsltproc online za pomocą usług onworks.net