wml - Online in de cloud

PROGRAMMA:

NAAM

WML - Website META-taal

VERSIE

2.0.12 (16 april 2008)

KORTE INHOUD

wml [-I PATH] [-i PATH] [-D NAAM=STR] [-D NAAM~PATH] [-n] [-r] [-O niveau] [-o
[SLICETERM:]PATH[@CHMODOPT,-P PATH] [-E PATH] [-t] [-p STR] [-W STR] [-s] [-v [NUM]]
[-q] [Invoer bestand]

wml [-V [NUM,-h]

PRODUCTBESCHRIJVING

Dit is het controleprogramma van de Website META Taal (WML), een gratis HTML-generatie
toolkit voor Unix, intern bestaande uit 9 onafhankelijke talen.

Het hoofdidee van WML is een sequentieel filterschema waarbij elke taal er één biedt
9 verwerkingspassen. Dus wml leest Invoer bestand (of van stdin if Invoer bestand is een streepje of
volledig ontbreekt), past passen 1-9 toe (of alleen de passen gespecificeerd door -p) en tenslotte
produceert er één of meer uitvoerbestands.

Voor meer details over dit verwerkingsschema leest u de WML Introductie voor wml_intro(7)
en WML Tutorial voor wml_zelfstudie(7).

OPTIES

-I, --include=PATH
Voegt een toe directory naar de lijst met gebruikerspaden. Gebruik deze optie om de runtime in te stellen
omgeving voor pas 1. Zie wml_p1_ipp(3) voor meer details.

-i, --includebestand=PATH
Laadt een bepaald onderdeel vooraf filet, dwz voegt vrijwel a toe

#include "PAD"

bovenop Invoer bestand. Gebruik dit om automatisch standaardgebruikersbestanden op te nemen.
Als je een systems include-bestand wilt toevoegen, moet je het PATH met hoek
haakjes, gebruik bijvoorbeeld ``"-i" " "'' om het bestand op te nemen foo/bar.wml
van het systeem omvat gebied. Als alternatief kunt u de speciale syntaxis gebruiken
``"wml::foo::bar"'' zoals bij de "#use" richtlijn.

-D, --definiëren=NAAM=STR
Definieert een variabele die kan worden geïnterpoleerd in pass 1 (IPP) via "$(NAME)", in pass 2
(mp4h) via <"get-var NAME">, in pass 3 (ePerl) via "<:=$NAME:>" en in pass 4 (GNU m4)
via "m4_NAME". Een bijzondere variant --definiëren=NAAM=UNDEF doet het tegenovergestelde: het verwijdert
eerdere definities (wat anders kan zijn dan het ongedaan maken van de definitie van deze variabelen, bijv
met door het systeem gedefinieerde variabelen).

-D, --definiëren=NAAM~PATH
Vergelijkbaar met het bovenstaande, maar definieert een variabele met een padnaam die automatisch wordt aangepast
(zie hieronder). Het kan op dezelfde manier worden geïnterpoleerd als de variant "NAME=STR".
bovenstaand.

-n, --noshebang
Dit dwingt WML om een ​​mogelijk ingeperkte shebang-regel te negeren Invoer bestand. Dit is
meestal gebruikt door WMk, omdat WMk deze regel al heeft geparseerd en de opties heeft geleverd
WML.

-r, --norcbestand
Dit dwingt WML om alles te negeren .wmlrc bestanden.

-c, --nocd
Wanneer WML een invoerbestand uit een andere map verwerkt, springt het naar die map
vóór het parseren .wmlrc bestanden en spring daarna terug naar de huidige map. Als deze optie
is ingesteld, wordt er geen mapwijziging uitgevoerd en .wmlrc bestanden worden relatief ten opzichte van de huidige gelezen
werkmap.

-O, --optimaliseren=NUM
Dit is de optimalisatieoptie die rechtstreeks wordt doorgegeven aan pass 8 (htmlfix). Het
bepaalt de hoeveelheid optimalisatie/stripping die wordt toegepast op de gegenereerde HTML
opmaakcode.

-o, --outputbestand=SLICETERM:uitvoerbestand[@CHMODOPT]
Hierdoor wordt de uitvoer omgeleid naar een bestand. Meestal wordt het hele bestand naar verzonden stdout
(hetzelfde als "ALLE:-"). U kunt deze optie meerdere keren gebruiken om naar meer dan één uitvoer uit te voeren
bestand tijdens het gebruik van de SLICETERM als een vaste theorieterm van plakjes om te bepalen welke
de inhoud wordt in elk specifiek uitvoerbestand opgenomen. De optionele CHMODOPT is
bedoeld voor het specificeren van opties voor een uiteindelijk toegepaste chmod commando. Gebruik bijvoorbeeld
``"u+x"'' om een ​​bestand te maken waarvan de uitvoeringsbit is ingesteld (Apache's XBitHack-functie).
Bekijk plak(1) voor meer details.

-P, --proloog=PATH
Voert een prologfilter uit over het invoerbestand. Dit programma ontvangt de gegevens waarop actie moet worden ondernomen
als STDIN en moet de gefilterde gegevens op STDOUT produceren.

-E, --epilog=PATH
Voert een epiloogprogramma uit over de uiteindelijk resulterende uitvoerbestanden. Momenteel de
de volgende WML-specifieke programma's zijn bekend: htmlinfo, linklint, proper en weblint. Maar
u kunt elk programma specificeren dat beschikbaar is in uw "PATH". Dit programma ontvangt
het bestand waarop moet worden gereageerd als het eerste opdrachtregelargument. Merk op dat de uitvoer dat niet is
doorgestuurd naar dit bestand, dus u moet een wrapper of programmaspecifieke vlaggen gebruiken als u
uitvoerbestanden wilt wijzigen.

-t, --tijd instellen
Hiermee wordt de wijzigingstijd van alle uitvoerbestanden ingesteld op de wijzigingstijd van
invoerbestand plus 1 seconde. Dit is handig omdat webservers gegevens genereren
"Last-Modified" headers en daar is de bewerkingstijd belangrijker dan de
generatie tijd. De offset van 1 seconde is voor de afhankelijkheden van Makefiles.

-M, --afhangen[=OPTIES]
Voer een regel uit die geschikt is voor `make' en beschrijft de afhankelijkheden van elk uitvoerbestand, zoals
'gcc' wel. Het heeft alleen zin als de -o optie wordt gebruikt. Er vindt geen verwerking plaats
behalve de eerste passage.

De D flag-optie schrijft de regel naar een afhankelijkheidsbestand. De naam van dit bestand is
verkregen door het achtervoegsel van het uitvoerbestand te vervangen door ".d".

De M flag optie verwijdert de systeembestanden uit de lijst met afhankelijkheden.

-p, --pas=STR
Specificeert welke van de hierboven beschreven passen daadwerkelijk worden toegepast tijdens runtime. De
argument STR is een door komma's gescheiden lijst met pasnummers met één speciaal geval: dat kan
schrijf "XY" voor alle passages "X...Y". Wanneer pass 9 er geen deel van uitmaakt STR het resultaat
uitvoer wordt geschreven STDOUT. Standaard is de tekenreeks ``"1-9"''.

-W, --passoptie=NUM,STR
Stel optie in STR voor de pas NUM.

-s, --veilig
Hierdoor worden enkele Perl-hacks binnen WML uitgeschakeld, die de verwerking versnellen door de
boven je hoofd vorken tijdens het lopen van de verschillende passen.

Zonder deze optie compileert WML de passen 1,5,6,7,8 (die in Perl zijn geschreven!)
naar een andere naamruimte van de momenteel actieve Perl-interpreter in plaats van
extern uitvoeren via "system()". Het effect is dat deze programma's worden uitgevoerd
binnen dezelfde Perl-interpreter, waardoor vijf CPU- en tijdrovende "fork()"'s worden bespaard.
De werkelijke winst ligt tussen de 2 en 4 seconden verwerkingstijd. Hoewel ervaring
bleek dat het prima werkt, is het theoretische probleem nog steeds dat deze aanpak dat ook is
enigszins riskant vanwege interne Perl-variabeleconflicten.

Gebruik deze optie om deze versnellingen uit te schakelen door WML te dwingen de veilige "fork()" te gebruiken
nadering.

-v, --uitgebreid[=NUM]
Hiermee wordt de uitgebreide modus ingesteld (van 1 tot 9), waarbij enige verwerkingsinformatie wordt gegeven
op de console. Handig voor het debuggen. Deze optie wordt ook doorgegeven aan enkele van de
programma's filteren. Standaard is geen breedsprakigheid en rechtvaardig -v middel -v1.

-q, --stil
Hiermee wordt de stille modus ingesteld waarin de verwerkingsprop niet langer wordt weergegeven. Gebruik dit
optie tijdens hardlopen wml als batchtaak. Deze optie wordt automatisch geforceerd wanneer
Invoer bestand ontbreekt. Vervolgens leest WML automatisch uit stdin in stille modus.

-V, --versie[=NUM]
Geeft de versie-identificatiereeks en disclaimer (nr NUM or NUM >= 1), de WML
informatie opbouwen (NUM >= 2) en de Perl-buildinformatie (NUM >= 3). Gebruik dit
optie om een ​​korte beschrijving te krijgen van uw geïnstalleerde WML-systeem, vooral wanneer
het melden van bugs aan de auteur.

-h, --help
Drukt de gebruiksoverzichtspagina af.

MILIEU

BEPAALD VARIABELEN
De volgende variabelen worden altijd gedefinieerd door wml onder runtime en zijn meestal
geïnterpoleerd via <"get-var NAME"> in Pass 2 en via $NAME in Pass 3.

WML_SRC_DIRNAME
De huidige werkmap van waaruit wml was begonnen. Een absoluut Unix-bestandssysteem
pad.

WML_SRC_FILENAME
De naam van de Invoer bestand vanaf de opdrachtregel. Handig tijdens het hardlopen wml op een bulk van
bestanden en includefiles moeten bepalen waarin ze zijn opgenomen.

WML_SRC_BASENAME
De basisnaam van de Invoer bestand, dat wil zeggen de "WML_SRC_FILENAME", maar met de extensie
al gestript.

WML_SRC_TIME
De laatste wijzigingstijd van Invoer bestand in "time()"-formaat. Handige voetteksten
wanneer een aangepast datumformaat nodig is.

WML_SRC_CTIME
De laatste wijzigingstijd van Invoer bestand in "ctime()"-formaat. Handige voetteksten
bestanden opnemen.

WML_SRC_ISOTIME
De laatste wijzigingstijd van Invoer bestand in ISO-formaat "jjjj-mm-dd uu:mm:ss". Bruikbaar
binnenvoetteksten bevatten bestanden.

WML_SRC_USERNAME
De Unix-gebruikersnaam van de gebruiker die eigenaar is Invoer bestand.

WML_SRC_REALNAME
De echte naam van de gebruiker die eigenaar is Invoer bestand.

WML_GEN_TIME
De huidige generatietijd in de notatie 'time()'. Handig in voetteksten wanneer
aangepast datumformaat is nodig.

WML_GEN_CTIME
De huidige generatietijd in 'ctime()'-indeling. Handige binnenvoetteksten zijn onder meer
bestanden.

WML_GEN_ISOTIME
De huidige generatietijd in ISO-indeling "jjjj-mm-dd uu:mm:ss". Handig binnen
voetteksten bevatten bestanden.

WML_GEN_USERNAME
De Unix-gebruikersnaam van de gebruiker die het wml proces.

WML_GEN_REALNAME
De echte naam van de gebruiker die het wml proces.

WML_GEN_HOSTNAME
De naam van de host waarop het wml opdracht loopt.

WML_LOC_PREFIX
Het locatievoorvoegsel waar WML op het moment van bouwen was geïnstalleerd.

WML_LOC_BINDIR
De map waarin de binaire bestanden van WML op het moment van bouwen zijn geïnstalleerd.

WML_LOC_LIBDIR
De map waarin de bibliotheekbestanden van WML op het moment van bouwen zijn geïnstalleerd.

WML_LOC_DATADIR
De map waarin de gegevensbestanden van WML op het moment van bouwen zijn geïnstalleerd.

WML_LOC_MANDIR
De map waarin de handleidingen van WML tijdens het bouwen waren geïnstalleerd.

WML_VERSION
De versie-identificatietekenreeks van WML. Gebruik dit bijvoorbeeld in HTML-opmerkingen
inside header bevat om de versie van de generatietools te identificeren.

GEBRUIKT VARIABELEN
"WMLOPTS"
Deze variabele kan een reeks opties bevatten. Meestal wordt dit gebruikt door Bourne-Shell
gebruikers vinden het leuk

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

en door C-Shell-gebruikers zoals

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

om ervoor te zorgen dat sommige variabelen voor alle uitvoeringen van worden gedefinieerd wml.

"PAGER"
Deze variabele bevat de pager die WML moet gebruiken. WML gebruikt een pager wanneer deze wordt aangeroepen met de
--uitgebreid=NUM or -vNUM optie respectievelijk en NUM is 3 of hoger en daarom
toont de verwerkte gegevens na elke passage. Standaard is 'meer'.

"TMPDIR"
Deze variabele bevat de map waarin WML de tijdelijke bestanden opslaat. De standaardwaarde is
'/ tmp'.

GEBRUIKER FILES

$HOME/.wmlrc en (../)*.wmlrc
Deze bestanden kunnen ook optiereeksen bevatten, één optie per regel. Meestal de
inhoud is één of meer -D opties, vooral automatisch aangepaste opties:

-DROOTREL~.
-DROOTABS=http://thishost/thisarea/
:
-DNAME1=WAARDE1
-DNAME2=WAARDE2
:

STANDAARD BEVATTEN FILES

WML wordt geleverd met een standaardset include-bestanden. Je kunt ze direct toevoegen via

#use wml::categorie::naam

en lees hun eigen documentatie via

$ man wml::categorie::naam

Bekijk wml::allen(3) voor een beschrijving van alle beschikbare include-bestanden.

. KENMERKEN

De WML-besturingsfrontend biedt op zichzelf enkele speciale functies:

Shebang-lijnondersteuning
WML herkent een keet regel (``"#!wml" opties'') in de .wml bestanden
voegt automatisch toe opties naar de opdrachtregel. Deze lijn wordt ook gebruikt door WMk. Twee
speciale functies in tegenstelling tot shebang-regels voor de Unix-lader zijn beschikbaar: WML's
shebang-regel kan worden voortgezet via een backslash-teken en de constructies %DIR en
% worden geïnterpoleerd (waarbij %DIR het pad is naar de map waar de bron while
zich bevindt en %BASE is de bestandsnaam van het bronbestand zonder enige extensie).

Voorbeeld:

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

Containertag voor gegevensbescherming
WML biedt een eigen interne containertag met de naam "
[pas=SPEC]>"..." " die kan worden gebruikt om elk type gegevens te beschermen tegen het bestaan ​​ervan
verwerkt door elke WML-pas. Wanneer er geen "pass" attribuut is opgegeven SPEC standaard ingesteld op "1-9".
Wanneer je "pass" gebruikt dan SPEC kan "#-", "-#", "#-#" zijn of door komma's gescheiden
lijst met passen, terwijl "#" tussen 1 en 9 kan liggen.

Voorbeeld:



...
uitvoer = " " + help_string + " "
...



Waarschuwing:

Sinds WML 2.0.3 bevat pas 1 extra dingen om informatie over de lijn bij te houden
relevante cijfers (a la cpp). Dus bij het schrijven


#include 'foo'


deze extra commando's worden tijdens passage 2 niet geïnterpreteerd en blijven op de uitvoer staan.
Om ze te onderdrukken, compileert u met de vlag "-W1,-N", of schrijft u


#include 'foo' IPP_NOSYNCLINES

AUTEURS

Ralf S. Engelsschall
[e-mail beveiligd]
www.engelschall.com

Dennis Barbier
[e-mail beveiligd]

Gebruik wml online met behulp van onworks.net-services