1 | <stránka |
---|
2 | xmlns="https://trac.frantovo.cz/xml-web-generator/wiki/xmlns/strana" |
---|
3 | xmlns:m="https://trac.frantovo.cz/xml-web-generator/wiki/xmlns/makro"> |
---|
4 | <nadpis>Skriptování</nadpis> |
---|
5 | <perex>Na stránku můžeme vložit výstup skriptů.</perex> |
---|
6 | <pořadí>50</pořadí> |
---|
7 | |
---|
8 | <text xmlns="http://www.w3.org/1999/xhtml"> |
---|
9 | |
---|
10 | <p> |
---|
11 | Na stránkách můžeme používat skripty. |
---|
12 | Spouští se při generování a jejich standardní výstup se vloží do stránky. |
---|
13 | Třeba doprostřed textu ostavce nebo do jiného elementu. |
---|
14 | </p> |
---|
15 | <p> |
---|
16 | Příklad: |
---|
17 | <em> |
---|
18 | Tyto stránky byly vygenerované v systému |
---|
19 | <span title="tento text pochází ze skriptu"><m:skript jazyk="bash">uname -o</m:skript></span>. |
---|
20 | </em> |
---|
21 | </p> |
---|
22 | |
---|
23 | <p> |
---|
24 | Díky skriptování můžeme stránky obohatit o prakticky libovolný obsah – |
---|
25 | jak prostý text, tak i XHTML fragmenty.<m:podČarou> |
---|
26 | Zapíná se pomocí atributu <code>výstup="xml"</code> a generátor pak kontroluje správné formátování – |
---|
27 | nestane se vám, že byste omylem vygenerovali stránky s překříženými nebo neuzavřenými značkami. |
---|
28 | Výchozím jmenným prostorem je XHTML a je dostupný i jmenný prostor pro makra (<code>m</code>). |
---|
29 | </m:podČarou> |
---|
30 | </p> |
---|
31 | <p> |
---|
32 | Skriptování ale může být nebezpečné, pokud byste spustili generátor na stránkách, |
---|
33 | které psal někdo nedůvěryhodný a vložil do nich škodlivý kód. |
---|
34 | Kromě toho, ukázková sada stránek by měla být přeložitelná kdekoli a mít minimum závislostí |
---|
35 | (ne každý musí mít nainstalovaný Perl nebo Python či další podporované interprety). |
---|
36 | Proto je skriptování ve výchozím stavu vypnuté – je potřeba ho povolit v souboru <code>web.conf</code>. |
---|
37 | </p> |
---|
38 | |
---|
39 | <h2>Podporované jazyky</h2> |
---|
40 | <p> |
---|
41 | V současnosti jsou podporované tyto jazyky: |
---|
42 | </p> |
---|
43 | |
---|
44 | <table> |
---|
45 | <thead> |
---|
46 | <tr> |
---|
47 | <td>Jazyk</td> |
---|
48 | <td>Interpret</td> |
---|
49 | </tr> |
---|
50 | </thead> |
---|
51 | <tbody> |
---|
52 | <m:skript jazyk="perl" výstup="xhtml"><![CDATA[ |
---|
53 | use strict; |
---|
54 | use warnings; |
---|
55 | |
---|
56 | open(JAVA, "<", $ENV{"XWG_SKRIPTOVANI_JAVA"}) or die $!; |
---|
57 | |
---|
58 | while (<JAVA>) { |
---|
59 | if (/podporovanýJazyk\.put\("(\w+)",\s*"(.*)"\);/) { |
---|
60 | print "<tr><td><code>$1</code></td><td><code>$2</code></td></tr>\n"; |
---|
61 | } |
---|
62 | } |
---|
63 | ]]></m:skript> |
---|
64 | </tbody> |
---|
65 | </table> |
---|
66 | |
---|
67 | <h2>Perl – ukázka</h2> |
---|
68 | <p>Jazyky použité nebo citované na této stránce:</p> |
---|
69 | <!-- |
---|
70 | Lepšího výsledku bychom samozřejmě dosáhli pomocí XPath dotazu, |
---|
71 | ale toto je příklad na Perl :-) |
---|
72 | --> |
---|
73 | <pre><m:skript jazyk="perl"><![CDATA[ |
---|
74 | use strict; |
---|
75 | use warnings; |
---|
76 | |
---|
77 | open(XML, "<", $ENV{"XWG_STRANKA_SOUBOR"}); |
---|
78 | my %skripty; |
---|
79 | |
---|
80 | while (<XML>) { |
---|
81 | if (/m:skript\s+jazyk="(\w+)"/) { |
---|
82 | $skripty{$1}++; |
---|
83 | } |
---|
84 | } |
---|
85 | |
---|
86 | for(keys(%skripty)) { |
---|
87 | print "$skripty{$_}×\t $_\n"; |
---|
88 | } |
---|
89 | ]]></m:skript></pre> |
---|
90 | |
---|
91 | <h2>BASH – ukázka</h2> |
---|
92 | <pre><m:skript jazyk="bash"><![CDATA[ |
---|
93 | echo -n "Právě je: "; |
---|
94 | date; |
---|
95 | echo -n "Operační systém: "; |
---|
96 | uname -o; |
---|
97 | echo -n "SHA-1 otisk zdrojáku této stránky: "; |
---|
98 | sha1sum "$XWG_STRANKA_SOUBOR" | cut -f 1 -d " "; |
---|
99 | ]]></m:skript></pre> |
---|
100 | |
---|
101 | <!-- |
---|
102 | <h2>PHP</h2> |
---|
103 | <pre style="max-height: 200px;"><m:skript jazyk="php"><![CDATA[ |
---|
104 | <?php |
---|
105 | phpinfo(); |
---|
106 | ?> |
---|
107 | ]]></m:skript></pre> |
---|
108 | --> |
---|
109 | |
---|
110 | <h2>Proměnné prostředí</h2> |
---|
111 | <p> |
---|
112 | Ve skriptech máme dostupné následující proměnné prostředí: |
---|
113 | </p> |
---|
114 | |
---|
115 | <table> |
---|
116 | <thead> |
---|
117 | <tr> |
---|
118 | <td>Proměnná</td> |
---|
119 | <td>Význam</td> |
---|
120 | </tr> |
---|
121 | </thead> |
---|
122 | <tbody> |
---|
123 | <!-- Pokud načítáme skript ze souboru, je atribut jazyk nepovinný. --> |
---|
124 | <m:skript jazyk="perl" výstup="xhtml" src="skriptování-proměnné.pl"/> |
---|
125 | </tbody> |
---|
126 | </table> |
---|
127 | |
---|
128 | <p> |
---|
129 | Kód: |
---|
130 | </p> |
---|
131 | |
---|
132 | <m:pre jazyk="xml"><![CDATA[<m:skript jazyk="bash"> |
---|
133 | echo "URI: $XWG_STRANKA_URI"; |
---|
134 | echo "Soubor: $XWG_STRANKA_SOUBOR"; |
---|
135 | echo "Nadpis: $XWG_STRANKA_NADPIS"; |
---|
136 | echo "Perex: $XWG_STRANKA_PEREX"; |
---|
137 | </m:skript>]]></m:pre> |
---|
138 | |
---|
139 | <p>nám vypíše:</p> |
---|
140 | |
---|
141 | <pre><m:skript jazyk="bash"><![CDATA[ |
---|
142 | echo "URI: $XWG_STRANKA_URI" | sed s/\\/home\\/$USER/\\/home\\/xwg/g; |
---|
143 | echo "Soubor: $XWG_STRANKA_SOUBOR" | sed s/\\/home\\/$USER/\\/home\\/xwg/g; |
---|
144 | echo "Nadpis: $XWG_STRANKA_NADPIS"; |
---|
145 | echo "Perex: $XWG_STRANKA_PEREX"; |
---|
146 | ]]></m:skript></pre> |
---|
147 | |
---|
148 | <h2>Makra ve skriptech</h2> |
---|
149 | <p> |
---|
150 | XML generované skriptem může také obsahovat makra, která se následně interptetují. |
---|
151 | <m:skript jazyk="bash" výstup="xhtml"><![CDATA[ |
---|
152 | echo '<m:skript jazyk="bash">'; # Ty zrůdo! :-) |
---|
153 | echo 'echo "Takže můžeš skriptovat, když skriptuješ,";'; |
---|
154 | echo '</m:skript>'; |
---|
155 | ]]></m:skript> |
---|
156 | nebo dělat něco užitečnějšího. |
---|
157 | </p> |
---|
158 | |
---|
159 | <m:skript jazyk="perl" výstup="xhtml"><![CDATA[ |
---|
160 | use strict; |
---|
161 | use warnings; |
---|
162 | |
---|
163 | my $adresar = "vstup/makra"; |
---|
164 | |
---|
165 | print "<m:diagram nadpis='Uživatelská makra v adresáři $adresar'>\n"; |
---|
166 | print " node [shape=\"box\"];\n"; |
---|
167 | print " koren [label=\"Uživatelská makra\"];\n"; |
---|
168 | |
---|
169 | opendir(DIR, $adresar) or die $!; |
---|
170 | my $i = 0; |
---|
171 | while (readdir(DIR)) { |
---|
172 | next if (/^\./); |
---|
173 | # Měli bychom ošetřit zvláštní znaky v názvech souborů, |
---|
174 | # abychom nezpůsobili chybu GraphVizu. |
---|
175 | print "n$i [label=\"$_\"];\n"; |
---|
176 | print "koren -> n$i;\n"; |
---|
177 | $i++; |
---|
178 | } |
---|
179 | print "</m:diagram>"; |
---|
180 | closedir(DIR); |
---|
181 | ]]></m:skript> |
---|
182 | |
---|
183 | <p>…třeba vygenerovat tento diagram následujícím perlovským skriptem:</p> |
---|
184 | |
---|
185 | <m:pre jazyk="perl"><![CDATA[ |
---|
186 | use strict; |
---|
187 | use warnings; |
---|
188 | |
---|
189 | my $adresar = "vstup/makra"; |
---|
190 | |
---|
191 | print "<m:diagram nadpis='Uživatelská makra v adresáři $adresar'>\n"; |
---|
192 | print " node [shape=\"box\"];\n"; |
---|
193 | print " koren [label=\"Uživatelská makra\"];\n"; |
---|
194 | |
---|
195 | opendir(DIR, $adresar) or die $!; |
---|
196 | my $i = 0; |
---|
197 | while (readdir(DIR)) { |
---|
198 | next if (/^\./); |
---|
199 | # Měli bychom ošetřit zvláštní znaky v názvech souborů, |
---|
200 | # abychom nezpůsobili chybu GraphVizu. |
---|
201 | print "n$i [label=\"$_\"];\n"; |
---|
202 | print "koren -> n$i;\n"; |
---|
203 | $i++; |
---|
204 | } |
---|
205 | print "</m:diagram>"; |
---|
206 | closedir(DIR);]]></m:pre> |
---|
207 | |
---|
208 | <p> |
---|
209 | Který vložíme zabalený v <code><![CDATA[<m:skript jazyk="perl" výstup="xhtml"> … </m:skript>]]></code> do stránky. |
---|
210 | </p> |
---|
211 | <p> |
---|
212 | 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í). |
---|
213 | </p> |
---|
214 | |
---|
215 | <h2>Skripty v makrech</h2> |
---|
216 | <p> |
---|
217 | Uvnitř maker můžeme volat<m:podČarou> |
---|
218 | Ovšem trochu jiným způsobem, než ve stránkách – |
---|
219 | nacházíme se totiž v <em>programu</em> (XSL šablona definující makro) |
---|
220 | nikoli v <em>datovém souboru</em> (XML stránka). |
---|
221 | </m:podČarou> |
---|
222 | jiná makra – mj. skripty. |
---|
223 | Toho jsme využili v makru, které generuje tabulku verzí z mercurialu: |
---|
224 | </p> |
---|
225 | |
---|
226 | <m:hg-verze/> |
---|
227 | |
---|
228 | <p> |
---|
229 | Toto makro naleznete v souboru <code>vstup/makra/hg-verze.xsl</code>. |
---|
230 | </p> |
---|
231 | |
---|
232 | </text> |
---|
233 | |
---|
234 | </stránka> |
---|
235 | |
---|