<stránka
	xmlns="https://trac.frantovo.cz/xml-web-generator/wiki/xmlns/strana"
	xmlns:m="https://trac.frantovo.cz/xml-web-generator/wiki/xmlns/makro">
	<nadpis>Skriptování</nadpis>
	<perex>Na stránku můžeme vložit výstup skriptů.</perex>
	<pořadí>50</pořadí>

	<text xmlns="http://www.w3.org/1999/xhtml">
	
		<p>
			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>
		<p>
			Příklad:
			<em>
				Tyto stránky byly vygenerované v systému
				<span title="tento text pochází ze skriptu"><m:skript jazyk="bash">uname -o</m:skript></span>.
			</em>
		</p>

		<p>
			Díky skriptování můžeme stránky obohatit o prakticky libovolný obsah – 
			jak prostý text, tak i XHTML fragmenty.<m:podČarou>zapíná se pomocí atributu 
			<code>výstup="xml"</code> 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.</m:podČarou>
		</p>
		<p>
			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 <code>web.conf</code>.
		</p>

		<h2>Podporované jazyky</h2>
		<p>
			V současnosti jsou podporované tyto jazyky:
		</p>
		
		<table>
			<thead>
				<tr>
					<td>Jazyk</td>
					<td>Interpret</td>
				</tr>
			</thead>
			<tbody>
				<m:skript jazyk="perl" výstup="xml"><![CDATA[
use strict;
use warnings;

open(JAVA, "<", $ENV{"XWG_SKRIPTOVANI_JAVA"}) or die $!;

while (<JAVA>) {
	if (/podporovanýJazyk\.put\("(\w+)",\s*"(.*)"\);/) {
		print "<tr><td><code>$1</code></td><td><code>$2</code></td></tr>\n";
	}
}
				]]></m:skript>
			</tbody>
		</table>

		<h2>Perl</h2>
		<p>Jazyky použité nebo citované na této stránce:</p>
		<!--
			Lepšího výsledku bychom samozřejmě dosáhli pomocí XPath dotazu,
			ale toto je příklad na Perl :-)
		-->
		<pre><m:skript jazyk="perl"><![CDATA[
use strict;
use warnings;

open(XML, "<", $ENV{"XWG_STRANKA_SOUBOR"});
my %skripty;

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

for(keys(%skripty)) {
	print "$skripty{$_}×\t $_\n";
}
			]]></m:skript></pre>

			<h2>BASH</h2>
		<pre><m:skript jazyk="bash"><![CDATA[
echo -n "Právě je: ";
date;
echo -n "Operační systém: ";
uname -o;
echo -n "SHA-1 otisk zdrojáku této stránky: ";
sha1sum "$XWG_STRANKA_SOUBOR" | cut -f 1 -d " ";
			]]></m:skript></pre>

			<!--
			<h2>PHP</h2>
			<pre style="max-height: 200px;"><m:skript jazyk="php"><![CDATA[
<?php
phpinfo();
?>
			]]></m:skript></pre>
			-->

			<h2>Proměnné prostředí</h2>
			<p>
				Ve skriptech máme dostupné následující proměnné prostředí:
			</p>
			
			<table>
				<thead>
					<tr>
						<td>Proměnná</td>
						<td>Význam</td>
					</tr>
				</thead>
				<tbody>
					<!-- Pokud načítáme skript ze souboru, je atribut jazyk nepovinný. -->
					<m:skript jazyk="perl" výstup="xml" src="skriptování-proměnné.pl"/>
				</tbody>
			</table>
			
			<p>
				Kód:
			</p>
			
			<m:pre jazyk="xml"><![CDATA[<m:skript jazyk="bash">
echo "URI:    $XWG_STRANKA_URI";
echo "Soubor: $XWG_STRANKA_SOUBOR";
echo "Nadpis: $XWG_STRANKA_NADPIS";
echo "Perex:  $XWG_STRANKA_PEREX";
</m:skript>]]></m:pre>
			
			<p>nám vypíše:</p>
			
			<pre><m:skript jazyk="bash"><![CDATA[
echo "URI:    $XWG_STRANKA_URI" | sed s/\\/home\\/$USER/\\/home\\/xwg/g;
echo "Soubor: $XWG_STRANKA_SOUBOR" | sed s/\\/home\\/$USER/\\/home\\/xwg/g;
echo "Nadpis: $XWG_STRANKA_NADPIS";
echo "Perex:  $XWG_STRANKA_PEREX";
		]]></m:skript></pre>

	</text>

</stránka>