Changeset 113:18bf0044f5ab

Timestamp:

07/06/12 14:52:05 (12 years ago)

Author:

František Kučera <franta-hg@…>

Branch:

default

Message:

#20 Skriptování: uvnitř zadání skriptu lze používat jiná makra (interpretují se před provedením skriptu).

Files:

• vstup/kontakt.xml (modified) (1 diff)
• vstup/makra/firma.xsl (added)
• vstup/skriptování.xml (modified) (3 diffs)
• šablona/funkce/src/cz/frantovo/xmlWebGenerator/Funkce.java (modified) (3 diffs)
• šablona/funkce/src/cz/frantovo/xmlWebGenerator/makra/Skriptování.java (modified) (2 diffs)
• šablona/makra/skriptování.xsl (modified) (1 diff)

vstup/kontakt.xml

@@ -11 +11 @@
                 <p>
                         <strong>Naše adresa:</strong><br/>
+                        <m:firma/><br/>
                         Polární 128<br/>
                         Tučňákova Lhota<br/>

vstup/skriptování.xml

@@ -146 +146 @@
                 ]]></m:skript></pre>
 
-                <h2 id="makraVeSkriptech">Makra ve skriptech</h2>
+                <h2 id="makraZeSkriptů">Makra ze skriptů</h2>
                 <p>
                         XML generované skriptem může také obsahovat makra, která se následně interptetují.
@@ -215 +215 @@
                 </p>
 
+                <h2>Makra ve skriptech</h2>
+                
+                <p>
+                        Uvnitř zdrojového kódu skriptu můžeme používat jiná makra.
+                        Např. tento kód:
+                </p>
+
+                <m:pre jazyk="xml"><![CDATA[<pre>
+        <m:skript jazyk="bash">
+                echo "Náš podnik se jmenuje <m:firma/>";
+        </m:skript>
+</pre>]]></m:pre>
+
+                <p>
+                        nám vygeneruje:
+                </p>
+
+                <pre><m:skript jazyk="bash">
+                                echo "Náš podnik se jmenuje <m:firma/>";
+                </m:skript></pre>
+
+                <p>
+                        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 <em>escapování</em> 
+                        pro daný kontext (skriptovací jazyk a prostředí v něm – např. apostrofy vs. uvozovky).
+                </p>
+
                 <h2>Skripty v makrech</h2>
                 <p>
-                        Uvnitř maker můžeme volat<m:podČarou>
+                        Uvnitř definic maker můžeme volat<m:podČarou>
                                 Ovšem trochu jiným způsobem, než ve stránkách –
                                 nacházíme se totiž v <em>programu</em> (XSL šablona definující makro)
@@ -282 +311 @@
 
                 <p>
-                        Podobně bychom mohli postupovat i u <a href="#makraVeSkriptech">diagramu</a> –
+                        Podobně bychom mohli postupovat i u <a href="#makraZeSkriptů">diagramu</a> –
                         negenerovat skriptem značky makra, ale pouze jeho obsah – zadání diagramu, nebo jen jeho část.
                         Někdy se ale může hodit ve skriptu nastavovat atributy elementů nebo elementy vytvářet dynamicky.

šablona/funkce/src/cz/frantovo/xmlWebGenerator/Funkce.java

@@ -2 +2 @@
  * XML Web generátor – program na generování webových stránek
  * Copyright © 2012 František Kučera (frantovo.cz)
- * 
+ *
  * This program is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation, either version 3 of the License, or
  * (at your option) any later version.
- * 
+ *
  * This program is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  * GNU General Public License for more details.
- * 
+ *
  * You should have received a copy of the GNU General Public License
- * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
  */
 package cz.frantovo.xmlWebGenerator;
 
 import java.io.File;
-import java.util.Date;
 import java.net.URI;
 import java.net.URISyntaxException;
+import java.util.Date;
 
 /**
  * Společná knihovna funkcí volaných z XSLT
- *  
+ *
  * @author František Kučera (frantovo.cz)
  */
@@ -32 +32 @@
         /**
          * Zjištuje, kdy byl naposledy daný soubor změněn.
+         *
          * @param soubor cesta k souboru
          * @return datum poslední změny
@@ -41 +42 @@
                 return new Date(f.lastModified());
         }
+
+        public static String spojText(String[] kusyTextu) {
+                if (kusyTextu == null || kusyTextu.length < 1) {
+                        return null;
+                } else {
+                        StringBuilder sb = new StringBuilder();
+                        for (int i = 0; i < kusyTextu.length; i++) {
+                                sb.append(kusyTextu[i]);
+                        }
+                        return sb.toString();
+                }
+        }
 }
-

šablona/funkce/src/cz/frantovo/xmlWebGenerator/makra/Skriptování.java

@@ -19 +19 @@
 
 import static cz.frantovo.xmlWebGenerator.NástrojeCLI.načtiProud;
+import static cz.frantovo.xmlWebGenerator.Funkce.spojText;
 import static cz.frantovo.xmlWebGenerator.Xmlns.*;
 import java.io.ByteArrayInputStream;
@@ -75 +76 @@
          * @return výstup příkazu buď jako textový řetězec nebo jako XML (DOMSource)
          */
-        public static Source interpretuj(String skriptText, String skriptSoubor, String jazyk, String výstupníFormát, String uriStránky, String nadpisStránky, String perexStránky) throws Exception {
-                String výstupSkriptu = získejVýstupSkriptu(skriptText, skriptSoubor, jazyk, uriStránky, nadpisStránky, perexStránky);
+        public static Source interpretuj(String[] skriptText, String skriptSoubor, String jazyk, String výstupníFormát, String uriStránky, String nadpisStránky, String perexStránky) throws Exception {
+                String výstupSkriptu = získejVýstupSkriptu(spojText(skriptText), skriptSoubor, jazyk, uriStránky, nadpisStránky, perexStránky);
                 return vyrobXml(výstupSkriptu, zjistiFormát(výstupníFormát));
         }

šablona/makra/skriptování.xsl

@@ -45 +45 @@
                 <xsl:choose>
                         <xsl:when test="$režim = 'povolit'">
+                                <xsl:variable name="zadáníSkriptu">
+                                        <xsl:apply-templates select="*|text()"/>
+                                </xsl:variable>
                                 <xsl:variable name="výstupSkriptu" select="j:interpretuj(
-                                                                                                                                        text(),
+                                                                                                                                        $zadáníSkriptu,
                                                                                                                                         @src,
                                                                                                                                         @jazyk,