Changeset 28:3298cafa8686

Timestamp:

08/22/11 01:10:55 (13 years ago)

Author:

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

Branch:

default

Message:

#12 Lepší ošetření chyb – vypíšeme varování a na výstup vložíme původní text bez zvýraznění syntaxe.

Files:

• vstup/produkty.xml (modified) (2 diffs)
• šablona/funkce/src/cz/frantovo/xmlWebGenerator/Funkce.java (modified) (4 diffs)
• šablona/stránka.xsl (modified) (1 diff)

vstup/produkty.xml

@@ -21 +21 @@
                 <p>Aliquam erat volutpat. Quisque vitae libero est. Aliquam erat volutpat. Integer elementum, nisl nec lacinia facilisis, dolor tellus varius eros, sit amet facilisis sem sapien vitae nulla. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Integer rutrum sodales venenatis. Donec mollis aliquet enim, id venenatis urna faucibus sed. Suspendisse pharetra neque et nibh tincidunt suscipit. Morbi ut justo sit amet lectus faucibus tempor quis non libero. Aenean in dolor sem, in lacinia sem.</p>
                 
-                <m:pre>#!/bin/bash
-# tento kód nebude zvýrazněn
-# &lt;blee/&gt;</m:pre>
+                
 
                 <m:pre jazyk="java">public class Pokus {
@@ -30 +28 @@
 }</m:pre>
 
-        <m:pre jazyk="grrrrrrr">public class Pokus {
-                // komentář
-                // &lt;blee/&gt;
-}</m:pre>
+                <m:pre jazyk="xml"><![CDATA[<xmlDokument>
+        <element1>toto je <strong>pěkné</strong> XML!!!</element1>
+</xmlDokument>]]></m:pre>
+
+                <m:pre jazyk="xxxxxxxx">chybný jazyk → syntaxe nebude zvýrazněna</m:pre>
+                
+                <m:pre>#!/bin/bash
+# tento kód nebude zvýrazněn, protože atribut „jazyk“ chybý
+# &lt;blee/&gt;</m:pre>
                 
                 <p>Vhodnost zvířete do domácnosti:</p>

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

@@ -11 +11 @@
 import java.net.URISyntaxException;
 
+/**
+ * Knihovna funkcí volaných z XSLT.
+ *  
+ * TODO: časem rozdělit na více modulů (jmenných prostorů).
+ * 
+ * @author fiki
+ */
 public class Funkce {
 
+        /**
+         * Zjištuje, kdy byl naposledy daný soubor změněn.
+         * @param soubor cesta k souboru
+         * @return datum poslední změny
+         * @throws URISyntaxException
+         */
         public static Date posledníZměna(String soubor) throws URISyntaxException {
-                return new Date(new File(new URI(soubor)).lastModified());
+                URI uri = new URI(soubor);
+                File f = new File(uri);
+                return new Date(f.lastModified());
         }
 
@@ -21 +36 @@
          * @param zdroják zdrojový kód, který předáme příkazu pygmentize na standardním vstupu
          * @param jazyk předáme příkazu pygmentize jako parametr -l <lexer>
-         * @return TODO: použít (?) místo textu instanci com.icl.saxon.om.NodeInfo http://saxon.sourceforge.net/saxon6.5.3/extensibility.html
+         * @return zvýrazněný text nebo null, pokud došlo k chybě.
+         * TODO: použít (?) místo textu instanci com.icl.saxon.om.NodeInfo http://saxon.sourceforge.net/saxon6.5.3/extensibility.html
          */
         public static String zvýrazniSyntaxi(String zdroják, String jazyk) throws IOException, InterruptedException {
-                String příkaz = "pygmentizexxx";
+                String příkaz = "pygmentize";
 
-                if (isPrikazDostupny(příkaz)) {
+                if (jazyk == null || jazyk.length() == 0) {
+                        System.err.println("Není vyplněn atribut „jazyk“ → není jasné, jak se má zvýrazňovat.");
+                        return null;
+                } else if (isPrikazDostupny(příkaz)) {
                         Runtime r = Runtime.getRuntime();
                         Process p = r.exec(new String[]{příkaz, "-f", "html", "-l", jazyk});
@@ -40 +59 @@
 
                         if (chyby.length() == 0) {
+                                // Pozor: pygmentize má i při chybě návratový kód 0 → je potřeba kontrolovat chybový výstup.
                                 return výsledek;
                         } else {
-                                System.err.println("Při zvýrazňování syntaxe došlo k chybě: " + chyby);
-                                return "______chyba_____";
+                                System.err.print("Při zvýrazňování syntaxe došlo k chybě: " + chyby);
+                                return null;
                         }
                 } else {
                         System.err.println("Příkaz " + příkaz + " není na vašem systému dostupný → zvýrazňování syntaxe nebude fungovat.");
-                        System.err.println("Můžete ho nainstalovat pomocí: aptitude install python-pygments");
-                        // TODO: příkaz pro Fedoru/RedHat
-                        // TODO: vracet escapovaný zdroják v <pre/>
-                        return "__xxx____chyba_____";
+                        System.err.println("Můžete ho nainstalovat pomocí:");
+                        System.err.println("\t$ aptitude install python-pygments   # (Debian/Ubuntu)");
+                        System.err.println("\t$ yum install python-pygments        # (Fedora/RedHat)");
+                        return null;
                 }
         }
 
+        /**
+         * Čte proud dat dokud to jde a výsledek pak vrátí jako text.
+         * @param proud vstupní proud
+         * @return obsah proudu jako text
+         * @throws IOException 
+         */
         private static String načtiProud(InputStream proud) throws IOException {
                 StringBuilder výsledek = new StringBuilder();
@@ -69 +95 @@
         }
 
+        /**
+         * Pomocí programu which zjistí, jestli je daný příkaz v systému přítomný.
+         * @param příkaz jehož přítomnost zjišťujeme
+         * @return true pokud příkaz v systému existuje
+         */
         private static boolean isPrikazDostupny(String příkaz) {
                 try {

šablona/stránka.xsl

@@ -118 +118 @@
         Makro pro zvýraznění syntaxe:
     -->    
-    <xsl:template match="m:pre[@jazyk]">
-        <xsl:value-of disable-output-escaping="yes" select="j:zvýrazniSyntaxi(text(), @jazyk)"/>
-    </xsl:template>
     <xsl:template match="m:pre">
-        <!-- Pokud jazyk uveden není, nic nezvýrazňujeme. -->
-        <pre><xsl:apply-templates/></pre>       
-    </xsl:template>
-    
+        <xsl:variable name="zvýrazněnýText" select="j:zvýrazniSyntaxi(text(), @jazyk)"/>
+        <xsl:choose>
+                <xsl:when test="$zvýrazněnýText">
+                        <xsl:value-of disable-output-escaping="yes" select="$zvýrazněnýText"/>          
+                </xsl:when>
+                <xsl:otherwise>
+                        <xsl:message>Zvýraznění syntaxe se nezdařilo → bude vložen původní nezvýrazněný kód.</xsl:message>
+                        <pre><xsl:apply-templates/></pre>
+                </xsl:otherwise>
+        </xsl:choose>
+    </xsl:template>   
 
 </xsl:stylesheet>