--- a/šablona/funkce/src/cz/frantovo/xmlWebGenerator/Funkce.java Sun Jan 08 11:36:36 2012 +0100
+++ b/šablona/funkce/src/cz/frantovo/xmlWebGenerator/Funkce.java Sun Jan 08 16:52:30 2012 +0100
@@ -18,33 +18,17 @@
package cz.frantovo.xmlWebGenerator;
import java.io.File;
-import java.io.IOException;
-import java.io.PrintStream;
import java.util.Date;
import java.net.URI;
import java.net.URISyntaxException;
-import java.net.URLDecoder;
-import java.nio.charset.Charset;
-import static cz.frantovo.xmlWebGenerator.NástrojeCLI.*;
/**
- * Knihovna funkcí volaných z XSLT.
+ * Společná knihovna funkcí volaných z XSLT
*
- * TODO:
- * - rozdělit na více modulů (jmenných prostorů).
- * - CLI konektor
- *
- * @author fiki
+ * @author František Kučera (frantovo.cz)
*/
public class Funkce {
-
- private static final String PŘÍKAZ_PYGMENTIZE = "pygmentize";
- private static final String PŘÍKAZ_DOT = "dot";
- private static final String PŘÍKAZ_MARKDOWN = "markdown";
- private static final String ADRESÁŘ_VÝSTUPNÍ = "výstup";
- private static int počítadloDiagramů = 0;
- private static String počítadloDiagramůKontext = ""; // aktuálně zpracovávaná stránka, při změně vynulujeme počítadlo
-
+
/**
* Zjištuje, kdy byl naposledy daný soubor změněn.
* @param soubor cesta k souboru
@@ -56,178 +40,4 @@
File f = new File(uri);
return new Date(f.lastModified());
}
-
- /**
- * Zvýrazňuje syntaxi zdrojového kódu. Používá k tomu externí program/knihovnu pygmentize.
- * @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 zvýrazněný text nebo null, pokud došlo k chybě.
- * TODO:
- * - vracet místo textu instanci com.icl.saxon.om.NodeInfo http://saxon.sourceforge.net/saxon6.5.3/extensibility.html
- * - nebo kontrolovat validitu vygenerovaného kódu (v současnosti se spoléháme na bezchybnost pygmentize)
- */
- public static String zvýrazniSyntaxi(String zdroják, String jazyk) throws IOException, InterruptedException {
- 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 (isPříkazDostupný(PŘÍKAZ_PYGMENTIZE)) {
- Runtime r = Runtime.getRuntime();
- Process p = r.exec(new String[]{PŘÍKAZ_PYGMENTIZE, "-f", "html", "-l", jazyk});
-
- PrintStream vstupProcesu = new PrintStream(p.getOutputStream());
- vstupProcesu.print(zdroják);
- vstupProcesu.close();
-
- String výsledek = načtiProud(p.getInputStream());
- String chyby = načtiProud(p.getErrorStream());
-
- p.waitFor();
-
- 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.print("Při zvýrazňování syntaxe došlo k chybě: " + chyby);
- return null;
- }
- } else {
- System.err.println("Příkaz " + PŘÍKAZ_PYGMENTIZE + " není na vašem systému dostupný → zvýrazňování syntaxe nebude fungovat.");
- 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;
- }
- }
-
- /**
- * Vygeneruje CSS styl pro zvýrazňování syntaxe.
- * @return obsah CSS souboru nebo null, pokud generování nebylo možné
- */
- public static String generujCssSyntaxe() throws IOException, InterruptedException {
- if (isPříkazDostupný(PŘÍKAZ_PYGMENTIZE)) {
- Runtime r = Runtime.getRuntime();
- Process p = r.exec(new String[]{PŘÍKAZ_PYGMENTIZE, "-S", "default", "-f", "html"});
- return načtiProud(p.getInputStream());
- } else {
- return null;
- }
- }
-
- /**
- * Vytvoří obrázek s diagramem.
- * @param zadání definice diagramu ve formátu dot
- * @param vodorovně zda má být graf orientovaný vodorovně (funguje jen při <code>kompletní = false</code>)
- * @param kompletní false, pokud k zadání chceme doplnit <code>digraph d {…}</code>
- * @param kontext kam diagram patří – typicky název stránky, do které je vložen
- * diagramy se pak budou číslovat v rámci tohoto kontextu
- * → nebude docházet k přepisování diagramů jiných stránek při částečném přegenerování webu.
- * @param souborZadání null pokud chceme automatické číslování | nebo zadáme název souboru se zadáním diagramu – vygenerovaný diagram se pak bude jmenovat stejně
- * @return název souboru bez přípony, který byl vytvořen, nebo null, pokud došlo k chybě.
- */
- public static String vytvořDiagram(String zadání, boolean vodorovně, boolean kompletní, String kontext, String souborZadání) throws IOException, InterruptedException {
- if (isPříkazDostupný(PŘÍKAZ_DOT)) {
-
- String soubor;
- if (souborZadání == null) {
- if (kontext == null) {
- počítadloDiagramů++;
- soubor = "diagram-" + počítadloDiagramů;
- } else {
- // TODO: tohle by se mělo udělat v XSLT
- kontext = URLDecoder.decode(kontext, Charset.defaultCharset().name());
-
- // Každá stránka bude mít svoje diagramy číslované od 1
- if (!počítadloDiagramůKontext.equals(kontext)) {
- počítadloDiagramůKontext = kontext;
- počítadloDiagramů = 0;
- }
-
- počítadloDiagramů++;
- soubor = "diagram-" + kontext + "-" + počítadloDiagramů;
- }
- } else {
- soubor = souborZadání;
- }
- String souborSložka = ADRESÁŘ_VÝSTUPNÍ + File.separator + soubor;
-
- String zdroják;
- if (kompletní) {
- zdroják = zadání;
- } else {
- StringBuilder b = new StringBuilder(zadání.length() + 200);
- b.append("digraph d {\n");
- b.append("\tbgcolor=\"transparent\";\n");
- if (vodorovně) {
- b.append("\trankdir=LR;");
- }
- b.append(zadání);
- b.append("}\n");
- zdroják = b.toString();
- }
-
- Runtime r = Runtime.getRuntime();
- Process p = r.exec(new String[]{PŘÍKAZ_DOT, "-T", "svg", "-o", souborSložka + ".svg"});
-
- /**
- * TODO: generovat i PNG bitmapu
- */
- PrintStream vstupProcesu = new PrintStream(p.getOutputStream());
- vstupProcesu.print(zdroják.toString());
- vstupProcesu.close();
-
- String chyby = načtiProud(p.getErrorStream());
-
- p.waitFor();
-
- if (chyby.length() == 0) {
- return soubor;
- } else {
- System.err.print("Při vytváření diagramu došlo k chybě: " + chyby);
- return null;
- }
- } else {
- System.err.println("Příkaz " + PŘÍKAZ_DOT + " není na vašem systému dostupný → diagramy nelze vygreslit.");
- System.err.println("Můžete ho nainstalovat pomocí:");
- System.err.println("\t$ aptitude install graphviz # (Debian/Ubuntu)");
- System.err.println("\t$ yum install graphviz # (Fedora/RedHat)");
- return null;
- }
- }
-
- /**
- * Převede text ve wiki syntaxi do XHTML.
- * @param wiki vstupní text v dané wiki syntaxi
- * @param syntaxe null nebo volitelně syntaxe (markdown, texy)
- * @return naformátované XHTML
- */
- public static String formátujWiki(String wiki, String syntaxe) throws IOException {
- if (isPříkazDostupný(PŘÍKAZ_MARKDOWN)) {
- Runtime r = Runtime.getRuntime();
- Process p = r.exec(new String[]{PŘÍKAZ_MARKDOWN});
-
- /**
- * TODO: oříznout mezery na začátcích řádků, pokud je jich všude stejně?
- * (odsazení v XML)
- */
- PrintStream vstupProcesu = new PrintStream(p.getOutputStream());
- vstupProcesu.print(wiki);
- vstupProcesu.close();
-
- String chyby = načtiProud(p.getErrorStream());
- String xhtml = načtiProud(p.getInputStream());
-
- if (chyby.length() == 0) {
- return xhtml;
- } else {
- System.err.print("Při zpracování wiki syntaxe došlo k chybě: " + chyby);
- return null;
- }
- } else {
- System.err.println("Příkaz " + PŘÍKAZ_MARKDOWN + " není na vašem systému dostupný → nelze formátovat texty ve wiki syntaxi.");
- System.err.println("Můžete ho nainstalovat pomocí:");
- System.err.println("\t$ aptitude install markdown # (Debian/Ubuntu)");
- System.err.println("\t$ yum install perl-Text-Markdown # (Fedora/RedHat)");
- return null;
- }
- }
}