Na stránkách můžeme používat skripty. Spouští se při generování a jejich standardní výstup se vloží do stránky. Třeba doprostřed textu ostavce nebo do jiného elementu.

Příklad: Tyto stránky byly vygenerované v systému uname -o.

Díky skriptování můžeme stránky obohatit o prakticky libovolný obsah – jak prostý text, tak i XHTML fragmenty. Zapíná se pomocí atributu výstup="xhtml" a generátor pak kontroluje správné formátování – nestane se vám, že byste omylem vygenerovali stránky s překříženými nebo neuzavřenými značkami. Výchozím jmenným prostorem je XHTML a je dostupný i jmenný prostor pro makra (m).

Skriptování ale může být nebezpečné, pokud byste spustili generátor na stránkách, které psal někdo nedůvěryhodný a vložil do nich škodlivý kód. Kromě toho, ukázková sada stránek by měla být přeložitelná kdekoli a mít minimum závislostí (ne každý musí mít nainstalovaný Perl nebo Python či další podporované interprety). Proto je skriptování ve výchozím stavu vypnuté – je potřeba ho povolit v souboru web.conf.

Podporované jazyky

V současnosti jsou podporované tyto jazyky:

Perl – ukázka

Jazyky použité nebo citované na této stránce:

) {
	if (/m:skript\s+jazyk="(\w+)"/) {
		$skripty{$1}++;
	}
}

for(keys(%skripty)) {
	print "$skripty{$_}×\t $_\n";
}
			]]>

BASH – ukázka

Proměnné prostředí

Ve skriptech máme dostupné následující proměnné prostředí:

Kód:

nám vypíše:

Makra ze skriptů

XML generované skriptem může také obsahovat makra, která se následně interptetují. '; # Ty zrůdo! :-) echo 'echo "Takže můžeš skriptovat, když skriptuješ,";'; echo ''; ]]> nebo dělat něco užitečnějšího.

…třeba vygenerovat tento diagram následujícím perlovským skriptem:

Který vložíme zabalený v  … ]]> do stránky.

Známá chyba: ve skriptech zatím nefungují poznámky pod čarou (a není jisté, jestli kdy fungovat budou – pravděpodobně by to vyžadovalo vícefázové zpracování).

Makra ve skriptech

Uvnitř zdrojového kódu skriptu můžeme používat jiná makra. Např. tento kód:

nám vygeneruje:

				print "Náš podnik se jmenuje ";
		

Můžete si tak vytvořit makra pro opakující se části a používat je jak v textu stránek, tak ve skriptech nebo diagramech. Jen pozor na ošetření zvláštních znaků – pokud text takové znaky obsahuje, je dobré ho zabalit ještě do jedné značky, která se postará o escapování pro daný kontext (skriptovací jazyk a prostředí v něm – např. apostrofy vs. uvozovky).

Jen pro připomenutí: nejedná se o nějaké primitivní zástupky a nahrazování textu – makra můžou být parametrizovaná, obsahovat atributy (např. pád a číslo) nebo vnořené elementy a na základě této parametrizace vytvářet odlišný výstup, který je následně předán skriptu.

			echo "S naší  budete jistě spokojeni!";
			echo "Stejně jako my jsme spokojeni s operačním systémem `uname -o`.";
		

Zdrojový kód:

Skripty v těchto příkladech nejsou příliš užitečné, protože pouze vypisují text, který by šlo vložit přímo do XML stránky – předpokládá se, že ve svých skriptech budete dělat něco zajímavějšího :-)

Skripty v makrech

Uvnitř definic maker můžeme volat Ovšem trochu jiným způsobem, než ve stránkách – nacházíme se totiž v programu (XSL šablona definující makro) nikoli v datovém souboru (XML stránka). jiná makra – mj. skripty. Toho jsme využili v makru, které generuje tabulku verzí z mercurialu – ten umí vypsat historii úložiště v XML, které následně snadno zpracujeme v XSLT.