Zvýrazňování syntaxe #12: zdrojáky ze souborů budeme načítat už v XSLT ne až v Javě.
1 package cz.frantovo.xmlWebGenerator;
4 import java.io.FileInputStream;
5 import java.io.IOException;
6 import java.io.PrintStream;
9 import java.net.URISyntaxException;
10 import static cz.frantovo.xmlWebGenerator.NástrojeCLI.*;
13 * Knihovna funkcí volaných z XSLT.
16 * - rozdělit na více modulů (jmenných prostorů).
23 private static final String PŘÍKAZ_PYGMENTIZE = "pygmentize";
24 private static final String PŘÍKAZ_DOT = "dot";
25 private static final String PŘÍKAZ_MARKDOWN = "markdown";
26 private static final String ADRESÁŘ_VSTUPNÍ = "vstup";
27 private static final String ADRESÁŘ_VÝSTUPNÍ = "výstup";
28 private static int počítadloDiagramů = 0;
31 * Zjištuje, kdy byl naposledy daný soubor změněn.
32 * @param soubor cesta k souboru
33 * @return datum poslední změny
34 * @throws URISyntaxException
36 public static Date posledníZměna(String soubor) throws URISyntaxException {
37 URI uri = new URI(soubor);
38 File f = new File(uri);
39 return new Date(f.lastModified());
43 * Zvýrazňuje syntaxi zdrojového kódu. Používá k tomu externí program/knihovnu pygmentize.
44 * @param zdroják zdrojový kód, který předáme příkazu pygmentize na standardním vstupu
45 * @param jazyk předáme příkazu pygmentize jako parametr -l <lexer>
46 * @return zvýrazněný text nebo null, pokud došlo k chybě.
48 * - vracet místo textu instanci com.icl.saxon.om.NodeInfo http://saxon.sourceforge.net/saxon6.5.3/extensibility.html
49 * - nebo kontrolovat validitu vygenerovaného kódu (v současnosti se spoléháme na bezchybnost pygmentize)
51 public static String zvýrazniSyntaxi(String zdroják, String jazyk) throws IOException, InterruptedException {
52 if (jazyk == null || jazyk.length() == 0) {
53 System.err.println("Není vyplněn atribut „jazyk“ → není jasné, jak se má zvýrazňovat.");
55 } else if (isPříkazDostupný(PŘÍKAZ_PYGMENTIZE)) {
56 Runtime r = Runtime.getRuntime();
57 Process p = r.exec(new String[]{PŘÍKAZ_PYGMENTIZE, "-f", "html", "-l", jazyk});
59 PrintStream vstupProcesu = new PrintStream(p.getOutputStream());
60 vstupProcesu.print(zdroják);
63 String výsledek = načtiProud(p.getInputStream());
64 String chyby = načtiProud(p.getErrorStream());
68 if (chyby.length() == 0) {
69 // Pozor: pygmentize má i při chybě návratový kód 0 → je potřeba kontrolovat chybový výstup.
72 System.err.print("Při zvýrazňování syntaxe došlo k chybě: " + chyby);
76 System.err.println("Příkaz " + PŘÍKAZ_PYGMENTIZE + " není na vašem systému dostupný → zvýrazňování syntaxe nebude fungovat.");
77 System.err.println("Můžete ho nainstalovat pomocí:");
78 System.err.println("\t$ aptitude install python-pygments # (Debian/Ubuntu)");
79 System.err.println("\t$ yum install python-pygments # (Fedora/RedHat)");
85 * Vygeneruje CSS styl pro zvýrazňování syntaxe.
86 * @return obsah CSS souboru nebo null, pokud generování nebylo možné
88 public static String generujCssSyntaxe() throws IOException, InterruptedException {
89 if (isPříkazDostupný(PŘÍKAZ_PYGMENTIZE)) {
90 Runtime r = Runtime.getRuntime();
91 Process p = r.exec(new String[]{PŘÍKAZ_PYGMENTIZE, "-S", "default", "-f", "html"});
92 return načtiProud(p.getInputStream());
99 * Vytvoří obrázek s diagramem.
100 * @param zadání definice diagramu ve formátu dot
101 * @param vodorovně zda má být graf orientovaný vodorovně
102 * @return název souboru bez přípony, který byl vytvořen, nebo null, pokud došlo k chybě.
104 public static String vytvořDiagram(String zadání, boolean vodorovně) throws IOException, InterruptedException {
105 if (isPříkazDostupný(PŘÍKAZ_DOT)) {
107 String soubor = "diagram-" + počítadloDiagramů;
108 String souborSložka = ADRESÁŘ_VÝSTUPNÍ + File.separator + soubor;
110 StringBuilder zdroják = new StringBuilder(zadání.length() + 200);
112 zdroják.append("digraph d {\n");
113 zdroják.append("\tbgcolor=\"transparent\";\n");
115 zdroják.append("\trankdir=LR;");
117 zdroják.append(zadání);
118 zdroják.append("}\n");
120 Runtime r = Runtime.getRuntime();
121 Process p = r.exec(new String[]{PŘÍKAZ_DOT, "-T", "svg", "-o", souborSložka + ".svg"});
124 * TODO: generovat i PNG bitmapu
126 PrintStream vstupProcesu = new PrintStream(p.getOutputStream());
127 vstupProcesu.print(zdroják.toString());
128 vstupProcesu.close();
130 String chyby = načtiProud(p.getErrorStream());
134 if (chyby.length() == 0) {
137 System.err.print("Při vytváření diagramu došlo k chybě: " + chyby);
141 System.err.println("Příkaz " + PŘÍKAZ_DOT + " není na vašem systému dostupný → diagramy nelze vygreslit.");
142 System.err.println("Můžete ho nainstalovat pomocí:");
143 System.err.println("\t$ aptitude install graphviz # (Debian/Ubuntu)");
144 System.err.println("\t$ yum install graphviz # (Fedora/RedHat)");
150 * Převede text ve wiki syntaxi do XHTML.
151 * @param wiki vstupní text v dané wiki syntaxi
152 * @param syntaxe null nebo volitelně syntaxe (markdown, texy)
153 * @return naformátované XHTML
155 public static String formátujWiki(String wiki, String syntaxe) throws IOException {
156 if (isPříkazDostupný(PŘÍKAZ_MARKDOWN)) {
157 Runtime r = Runtime.getRuntime();
158 Process p = r.exec(new String[]{PŘÍKAZ_MARKDOWN});
161 * TODO: oříznout mezery na začátcích řádků, pokud je jich všude stejně?
164 PrintStream vstupProcesu = new PrintStream(p.getOutputStream());
165 vstupProcesu.print(wiki);
166 vstupProcesu.close();
168 String chyby = načtiProud(p.getErrorStream());
169 String xhtml = načtiProud(p.getInputStream());
171 if (chyby.length() == 0) {
174 System.err.print("Při zpracování wiki syntaxe došlo k chybě: " + chyby);
178 System.err.println("Příkaz " + PŘÍKAZ_MARKDOWN + " není na vašem systému dostupný → nelze formátovat texty ve wiki syntaxi.");
179 System.err.println("Můžete ho nainstalovat pomocí:");
180 System.err.println("\t$ aptitude install markdown # (Debian/Ubuntu)");
181 System.err.println("\t$ yum install perl-Text-Markdown # (Fedora/RedHat)");