wml — online w chmurze

PROGRAM:

IMIĘ

WML — język META strony internetowej

WERSJA

2.0.12 (16-kwi-2008)

STRESZCZENIE

WML [-I PATH] [-i PATH] [-D IMIĘ=STR] [-D IMIĘ~PATH] [-n] [-r] [-O poziom] [-o
[TERMIN.PRZEKROJU":"]PATH[@CHMODOPT]] [-P PATH] [-E PATH] [-t] [-p STR] [-W STR] [-s] [-v [NUM]]
[-q] [plik wejściowy]

WML [-V [NUM]] [-h]

OPIS

To jest program kontrolny Strona internetowa META Wybierz język (WML), darmowe generowanie HTML
zestaw narzędzi dla systemu Unix, składający się wewnętrznie z 9 niezależnych języków.

Główną ideą WML jest schemat filtrowania sekwencyjnego, w którym każdy język udostępnia jeden z nich
9 przejść przetwarzania. Więc WML czyta plik wejściowy (lub z stdin if plik wejściowy jest myślnikiem lub
całkowicie brak), dotyczy przepustek 1-9 (lub tylko przepustek określonych przez -p) i w końcu
produkuje jeden lub więcej plik wyjściowys.

Aby uzyskać więcej informacji na temat tego schematu przetwarzania, przeczytaj WML Wprowadzenie dla wml_intro(7)
oraz WML Poradnik dla wml_tutorial(7).

OPCJE

-I, --włącz=PATH
Dodaje katalog do listy ścieżek użytkownika. Użyj tej opcji, aby ustawić czas pracy
środowisko dla przepustki 1. Zobacz wml_p1_ipp(3) po więcej szczegółów.

-i, --includefil=PATH
Wstępnie ładuje określone uwzględnienie filet, tj. praktycznie dodaje a

#włącz "ŚCIEŻKĘ"

na szczycie plik wejściowy. Użyj tej opcji, aby automatycznie dołączyć domyślne pliki dołączone przez użytkownika.
Jeśli chcesz dołączyć plik systemowy, musisz otoczyć plik PATH z kątem
nawiasy, na przykład użyj ``"-i" " „”, aby dołączyć plik foo/bar.wml
z systemu obejmują obszar. Alternatywnie możesz użyć specjalnej składni
``"wml::foo::bar"'' jak w dyrektywie "#use".

-D, --definiuj=IMIĘ=STR
Definiuje zmienną, która może być interpolowana w przebiegu 1 (IPP) przez „$(NAME)”, w przebiegu 2
(mp4h) przez <"get-var NAME">, w przepustce 3 (ePerl) przez "<:=$NAME:>" iw przepustce 4 (GNU m4)
przez „m4_NAME”. Specjalny wariant --definiuj=IMIĘ=UNDEF robi odwrotnie, usuwa
poprzednie definicje (które mogą być inne niż oddefiniowanie tych zmiennych, np
ze zmiennymi zdefiniowanymi przez system).

-D, --definiuj=IMIĘ~PATH
Podobny do powyższego, ale definiuje zmienną przechowującą nazwę ścieżki, która jest automatycznie dostosowywana
(patrz poniżej). Można go interpolować w taki sam sposób, jak wariant „NAZWA=STR” z
powyżej.

-n, --noshebang
Zmusza to WML do zignorowania prawdopodobnie zawartej linii Shebang plik wejściowy. Jest
zwykle używany przez WMk, ponieważ WMk już przeanalizował tę linię i dostarczył opcje
WML.

-r, --norcplik
Zmusza to WML do ignorowania wszystkich .wmlrc akta.

-c, --noc
Kiedy WML przetwarza plik wejściowy z innego katalogu, przeskakuje do tego katalogu
przed analizowaniem .wmlrc pliki i powróć do bieżącego katalogu. Jeśli ta opcja
jest ustawiona, nie jest dokonywana żadna zmiana katalogu i .wmlrc pliki są odczytywane w stosunku do bieżącego
katalog roboczy.

-O, --optymalizacja=NUM
Jest to opcja optymalizacji przekazywana bezpośrednio do przebiegu 8 (poprawka html). To
kontroluje ilość optymalizacji/usuwania, które są stosowane do wygenerowanego kodu HTML
kod znaczników.

-o, --plik wyjściowy=TERMIN.PRZEKROJU:plik wyjściowy[@CHMODOPT]
Spowoduje to przekierowanie danych wyjściowych do pliku. Zwykle cały plik zostanie wysłany do stdout
(tak samo jak „WSZYSTKIE:-”). Możesz użyć tej opcji więcej niż jeden raz, aby wyprowadzić dane do więcej niż jednego
plik podczas korzystania z TERMIN.PRZEKROJU jako termin teorii mnogości wycinków, aby określić, który
zawartość zostanie dołączona do każdego konkretnego pliku wyjściowego. Opcjonalne CHMODOPT is
przeznaczony do określania opcji dla ostatecznie zastosowanego chmod Komenda. Na przykład użyj
``"u+x"'' do utworzenia pliku z ustawionym bitem wykonania (funkcja XBitHack Apache).
See kawałek(1) po więcej szczegółów.

-P, --prolog=PATH
Uruchamia filtr prologu na pliku wejściowym. Ten program otrzymuje dane do działania
jako STDIN i musi generować przefiltrowane dane na STDOUT.

-E, --epilog=PATH
Uruchamia program epilogu nad ostatecznie powstałymi plikami wyjściowymi. obecnie
znane są następujące programy specyficzne dla WML: htmlinformacje, łącze, schludny i WWW, Ale
możesz określić dowolny program, który jest dostępny w Twojej „PATH”. Ten program odbiera
plik, na którym ma działać, jako pierwszy argument wiersza poleceń. Zauważ, że dane wyjściowe nie są
przekierowany do tego pliku, więc jeśli chcesz, musisz użyć opakowania lub flag specyficznych dla programu
chcesz zmodyfikować pliki wyjściowe.

-t, --ustaw czas
To ustawia czas modyfikacji wszystkich plików wyjściowych na czas modyfikacji
plik wejściowy plus 1 sekunda. Jest to przydatne, ponieważ serwery WWW będą generować
Nagłówki „Ostatnia modyfikacja” i tam czas edycji jest ważniejszy niż czas
Czas tworzenia. Jednosekundowe przesunięcie dotyczy zależności plików Makefile.

-M, --zależeć[=OPCJE]
Wypisz regułę odpowiednią dla `make' opisującą zależności każdego pliku wyjściowego, as
`gcc' robi. Ma to sens tylko wtedy, gdy -o opcja jest używana. Żadne przetwarzanie nie jest wykonywane
z wyjątkiem pierwszego przejścia.

Połączenia D opcja flag zapisuje regułę do pliku zależności. Nazwa tego pliku to
uzyskany przez zastąpienie sufiksu pliku wyjściowego przez „.d”.

Połączenia M opcja flag usuwa pliki systemowe z listy zależności.

-p, --przejść=STR
Określa, które z przebiegów opisanych powyżej są faktycznie stosowane w czasie wykonywania. The
argument STR to oddzielona przecinkami lista numerów przepustek z jednym szczególnym przypadkiem: Możesz
napisz "XY" dla wszystkich przejść "X...Y". Kiedy pass 9 nie jest częścią STR wynikające
wyjście jest zapisywane do STDOUT. Domyślnie jest to łańcuch ``"1-9"''.

-W, --passopcja=NUM,STR
Ustaw opcję STR za przepustkę NUM.

-s, --bezpieczna
To wyłącza niektóre hacki Perla wewnątrz WML, które przyspieszają przetwarzanie poprzez zmniejszenie
rozwidlenie nad głową podczas wykonywania różnych podań.

Bez tej opcji WML prekompiluje przebiegi 1,5,6,7,8 (które są napisane w Perlu!)
do innej przestrzeni nazw aktualnie uruchomionego interpretera Perla zamiast
uruchamiając je zewnętrznie za pomocą „system()”. Efekt jest taki, że programy te są uruchamiane
w ramach tego samego interpretera Perla, oszczędzając w ten sposób pięć czasochłonnych i czasochłonnych „fork()”.
Rzeczywiste wzmocnienie wynosi od 2 do 4 sekund czasu przetwarzania. Chociaż doświadczenie
pokazał, że to działa świetnie, problem teoretyczny nadal jest taki, że to podejście jest
nieco ryzykowne z powodu wewnętrznych konfliktów zmiennych Perla.

Użyj tej opcji, aby wyłączyć te przyspieszenia, zmuszając WML do użycia bezpiecznego „fork()”
podejście.

-v, --gadatliwy[=NUM]
To ustawia tryb pełny (od 1 do 9), w którym zostaną podane niektóre informacje dotyczące przetwarzania
na konsoli. Przydatne do debugowania. Ta opcja jest również przekazywana do niektórych
programy filtrujące. Domyślnie nie ma gadatliwości i jest po prostu -v znaczy -v1.

-q, --cichy
Spowoduje to ustawienie trybu cichego, w którym właściwość przetwarzania nie będzie już wyświetlana. Użyj tego
opcja podczas biegania WML jako zadanie wsadowe. Ta opcja jest automatycznie wymuszana, gdy
plik wejściowy brakuje. Następnie WML automatycznie odczytuje z stdin w trybie cichym.

-V, --wersja[=NUM]
Podaje ciąg identyfikacyjny wersji i zastrzeżenie (nr NUM or NUM >= 1), plik WML
informacje o kompilacji (NUM >= 2) i informacje o kompilacji Perla (NUM >= 3). Użyj tego
możliwość uzyskania krótkiego opisu zainstalowanego systemu WML, zwłaszcza gdy
zgłaszanie błędów autorowi.

-h, --help
Drukuje stronę podsumowania użytkowania.

ŚRODOWISKO

ZDEFINIOWANE ZMIENNE
Następujące zmienne są zawsze definiowane przez WML w czasie wykonywania i zwykle są
interpolowana przez <"get-var NAME"> w Passie 2 i przez $NAME w Passie 3.

NAZWA WML_SRC_DIRNAME
Bieżący katalog roboczy skąd WML zostało rozpoczęte. Absolutny system plików Unix
ścieżka.

NAZWA PLIKU WML_SRC_FILE
Nazwa plik wejściowy z wiersza poleceń. Przydatne podczas biegania WML na większości
pliki i pliki dołączania muszą określać, w których są zawarte.

NAZWA WML_SRC_BASE
Nazwa podstawowa plik wejściowy, czyli "WML_SRC_FILENAME", ale z rozszerzeniem
już rozebrany.

WML_SRC_TIME
Czas ostatniej modyfikacji plik wejściowy w formacie „czas()”. Przydatne wewnętrzne stopki
gdy wymagany jest niestandardowy format daty.

WML_SRC_CTIME
Czas ostatniej modyfikacji plik wejściowy w formacie „ctime()”. Przydatne wewnętrzne stopki
dołączać pliki.

WML_SRC_ISOTIME
Czas ostatniej modyfikacji plik wejściowy w formacie ISO „rrrr-mm-dd hh:mm:ss”. Użyteczne
stopki wewnętrzne zawierają pliki.

WML_SRC_NAZWA_UŻYTKOWNIKA
Unix nazwa użytkownika użytkownika, który jest właścicielem plik wejściowy.

WML_SRC_REALNAME
Prawdziwe imię użytkownika, który jest właścicielem plik wejściowy.

WML_GEN_TIME
Bieżący czas generowania w formacie „time()”. Przydatne wewnętrzne stopki, gdy
potrzebny jest dostosowany format daty.

WML_GEN_CTIME
Bieżący czas generowania w formacie „ctime()”. Przydatne wewnętrzne stopki obejmują
akta.

WML_GEN_ISOTIME
Bieżący czas generowania w formacie ISO „rrrr-mm-dd hh:mm:ss”. Przydatne w środku
stopki zawierają pliki.

NAZWA UŻYTKOWNIKA WML_GEN_USER
Nazwa użytkownika Unix użytkownika, który uruchamia WML proces.

WML_GEN_REALNAME
Prawdziwe imię użytkownika, który uruchamia WML proces.

NAZWA_HOSTA WML_GEN_HOST
Nazwa hosta, na którym WML działa komenda.

WML_LOC_PREFIX
Prefiks lokalizacji, w której WML został zainstalowany w czasie kompilacji.

WML_LOC_BINDIR
Katalog, w którym pliki binarne WML zostały zainstalowane w czasie kompilacji.

WML_LOC_LIBDIR
Katalog, w którym pliki bibliotek WML zostały zainstalowane w czasie kompilacji.

WML_LOC_DATADIR
Katalog, w którym pliki danych WML zostały zainstalowane w czasie kompilacji.

WML_LOC_MANDIR
Katalog, w którym strony podręcznika WML zostały zainstalowane w czasie kompilacji.

WML_WERSJA
Ciąg identyfikacyjny wersji WML. Użyj tego na przykład w komentarzach HTML
wewnątrz nagłówka zawiera informacje o wersji narzędzi do generowania.

UŻYWANE ZMIENNE
„WMLOPTY”
Ta zmienna może zawierać ciąg opcji. Zwykle jest to używane przez Bourne-Shell
użytkownicy lubią

$ WMLOPTS="-DNAME1=WARTOŚĆ2 -DNAME2=WARTOŚĆ2"
$ eksport WMLOPTS

i przez użytkowników C-Shell, takich jak

$ setenv WMLOPTS "-DNAME1=VALUE2 -DNAME2=VALUE2"

aby upewnić się, że niektóre zmienne są zdefiniowane dla wszystkich przebiegów WML.

„PAGER”
Ta zmienna zawiera pager, którego ma używać WML. WML używa pagera, gdy jest wywoływany z
--gadatliwy=NUM or -vNUM odpowiednio opcja i NUM wynosi 3 lub więcej, a zatem
wyświetlanie przetworzonych danych po każdym przejściu. Wartość domyślna to „więcej”.

„TMPDIR”
Ta zmienna zawiera katalog, w którym WML przechowuje swoje pliki tymczasowe. Domyślnie to
'/ Tmp'.

USER AKTA

$HOME/.wmlrc i (../)*.wmlrc
Pliki te mogą również zawierać ciągi opcji, po jednej opcji w wierszu. Zwykle
zawartość to jeden lub więcej -D opcje, zwłaszcza automatycznie dostosowywane:

-DROOTREL~.
-DROOTABS=http://thishost/thisarea/
:
-DNAME1=WARTOŚĆ1
-DNAME2=WARTOŚĆ2
:

STANDARD ZAWIERAJĄ AKTA

WML jest dostarczany ze standardowym zestawem plików dołączanych. Możesz je bezpośrednio dołączyć za pomocą

#use wml::kategoria::nazwa

i czytać własną dokumentację za pośrednictwem

$ człowiek wml::kategoria::nazwa

See wml::cała kolekcja(3) opis wszystkich dostępnych plików dołączanych.

SPECIAL ROZWIĄZANIA

Nakładka kontrolna WML zapewnia kilka specjalnych funkcji:

Wsparcie linii Shebang
WML rozpoznaje a szulernia linia (``"#!wml" Opcje'') w wml plików i
automatycznie dodaje Opcje do jego wiersza poleceń. Linia ta jest również używana przez WMk. Dwa
dostępne są specjalne funkcje w przeciwieństwie do linii shebang dla programu ładującego Unix: WML
linia Shebang może być kontynuowana za pomocą znaku ukośnika odwrotnego i konstrukcji %DIR i
% są interpolowane (gdzie %DIR to ścieżka do katalogu źródłowego while
rezyduje, a %BASE to nazwa pliku źródłowego bez żadnego rozszerzenia).

Przykład:

#!wml -o (ALL-LANG_*)+LANG_EN:%BASE.en.html \
-o (ALL-LANG_*)+LANG_DE:%BASE.de.html

Tag kontenera ochrony danych
WML zapewnia własny wewnętrzny znacznik kontenera o nazwie „
[hasło=SPEC]>"..." ”, którego można użyć do ochrony wszelkiego rodzaju danych przed byciem
przetwarzane przez dowolne przepustki WML. Gdy nie podano atrybutu „pass”. SPEC domyślnie „1-9”.
Kiedy używasz wtedy „pass”. SPEC może być albo „#-”, „-#”, „#-#” albo oddzielone przecinkami
listę przepustek, podczas gdy „#” może zawierać się w przedziale od 1 do 9.

Przykład:



...
wyjście = " " + ciąg_pomocy + " "
...



Ostrzeżenie:

Od wersji WML 2.0.3, pass 1 zawiera dodatkowe rzeczy pomagające zachować informacje o linii
istotne liczby (a la cpp). Więc przy pisaniu


#włącz „foo”


te dodatkowe polecenia nie będą interpretowane podczas przebiegu 2 i pozostaną na wyjściu.
Aby je stłumić, albo skompiluj z flagą „-W1,-N”, albo napisz


#include 'foo' IPP_NOSYNCLINES

AUTORSKI

Ralf S. Engelschall
[email chroniony]
www.engelschall.com

Denisa Barbiera
[email chroniony]

Używaj wml online, korzystając z usług onworks.net