šablona/funkce/src/cz/frantovo/xmlWebGenerator/Funkce.java
author František Kučera <franta-hg@frantovo.cz>
Sat, 07 Jan 2012 18:57:39 +0100
changeset 68 2e6d7bfcd84f
parent 67 89b42acb3593
child 69 e7908e307b61
permissions -rw-r--r--
Diagramy #13: diagramy se ukládají do zvláštní složky. Funguje, ale zprasené. TODO: vylepšit.
franta-hg@61
     1
/**
franta-hg@61
     2
 * XML Web generátor – program na generování webových stránek
franta-hg@61
     3
 * Copyright © 2012 František Kučera (frantovo.cz)
franta-hg@61
     4
 * 
franta-hg@61
     5
 * This program is free software: you can redistribute it and/or modify
franta-hg@61
     6
 * it under the terms of the GNU General Public License as published by
franta-hg@61
     7
 * the Free Software Foundation, either version 3 of the License, or
franta-hg@61
     8
 * (at your option) any later version.
franta-hg@61
     9
 * 
franta-hg@61
    10
 * This program is distributed in the hope that it will be useful,
franta-hg@61
    11
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
franta-hg@61
    12
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
franta-hg@61
    13
 * GNU General Public License for more details.
franta-hg@61
    14
 * 
franta-hg@61
    15
 * You should have received a copy of the GNU General Public License
franta-hg@61
    16
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
franta-hg@61
    17
 */
franta-hg@6
    18
package cz.frantovo.xmlWebGenerator;
franta-hg@6
    19
franta-hg@6
    20
import java.io.File;
franta-hg@27
    21
import java.io.IOException;
franta-hg@27
    22
import java.io.PrintStream;
franta-hg@6
    23
import java.util.Date;
franta-hg@6
    24
import java.net.URI;
franta-hg@6
    25
import java.net.URISyntaxException;
franta-hg@67
    26
import java.net.URLDecoder;
franta-hg@67
    27
import java.nio.charset.Charset;
franta-hg@38
    28
import static cz.frantovo.xmlWebGenerator.NástrojeCLI.*;
franta-hg@6
    29
franta-hg@28
    30
/**
franta-hg@28
    31
 * Knihovna funkcí volaných z XSLT.
franta-hg@28
    32
 *  
franta-hg@36
    33
 * TODO:
franta-hg@32
    34
 *	- rozdělit na více modulů (jmenných prostorů).
franta-hg@32
    35
 *	- CLI konektor
franta-hg@28
    36
 * 
franta-hg@28
    37
 * @author fiki
franta-hg@28
    38
 */
franta-hg@6
    39
public class Funkce {
franta-hg@27
    40
franta-hg@30
    41
	private static final String PŘÍKAZ_PYGMENTIZE = "pygmentize";
franta-hg@32
    42
	private static final String PŘÍKAZ_DOT = "dot";
franta-hg@37
    43
	private static final String PŘÍKAZ_MARKDOWN = "markdown";
franta-hg@32
    44
	private static final String ADRESÁŘ_VÝSTUPNÍ = "výstup";
franta-hg@68
    45
	private static final String ADRESÁŘ_DIAGRAMY = "diagramy";
franta-hg@32
    46
	private static int počítadloDiagramů = 0;
franta-hg@67
    47
	private static String počítadloDiagramůKontext = "";
franta-hg@30
    48
franta-hg@28
    49
	/**
franta-hg@28
    50
	 * Zjištuje, kdy byl naposledy daný soubor změněn.
franta-hg@28
    51
	 * @param soubor cesta k souboru
franta-hg@28
    52
	 * @return datum poslední změny
franta-hg@28
    53
	 * @throws URISyntaxException
franta-hg@28
    54
	 */
franta-hg@21
    55
	public static Date posledníZměna(String soubor) throws URISyntaxException {
franta-hg@28
    56
		URI uri = new URI(soubor);
franta-hg@28
    57
		File f = new File(uri);
franta-hg@28
    58
		return new Date(f.lastModified());
franta-hg@21
    59
	}
franta-hg@27
    60
franta-hg@27
    61
	/**
franta-hg@27
    62
	 * Zvýrazňuje syntaxi zdrojového kódu. Používá k tomu externí program/knihovnu pygmentize.
franta-hg@27
    63
	 * @param zdroják zdrojový kód, který předáme příkazu pygmentize na standardním vstupu
franta-hg@27
    64
	 * @param jazyk předáme příkazu pygmentize jako parametr -l &lt;lexer&gt;
franta-hg@28
    65
	 * @return zvýrazněný text nebo null, pokud došlo k chybě.
franta-hg@31
    66
	 * TODO: 
franta-hg@36
    67
	 *	- vracet místo textu instanci com.icl.saxon.om.NodeInfo http://saxon.sourceforge.net/saxon6.5.3/extensibility.html
franta-hg@31
    68
	 *  - nebo kontrolovat validitu vygenerovaného kódu (v současnosti se spoléháme na bezchybnost pygmentize)
franta-hg@27
    69
	 */
franta-hg@27
    70
	public static String zvýrazniSyntaxi(String zdroják, String jazyk) throws IOException, InterruptedException {
franta-hg@28
    71
		if (jazyk == null || jazyk.length() == 0) {
franta-hg@28
    72
			System.err.println("Není vyplněn atribut „jazyk“ → není jasné, jak se má zvýrazňovat.");
franta-hg@28
    73
			return null;
franta-hg@36
    74
		} else if (isPříkazDostupný(PŘÍKAZ_PYGMENTIZE)) {
franta-hg@27
    75
			Runtime r = Runtime.getRuntime();
franta-hg@30
    76
			Process p = r.exec(new String[]{PŘÍKAZ_PYGMENTIZE, "-f", "html", "-l", jazyk});
franta-hg@27
    77
franta-hg@27
    78
			PrintStream vstupProcesu = new PrintStream(p.getOutputStream());
franta-hg@27
    79
			vstupProcesu.print(zdroják);
franta-hg@27
    80
			vstupProcesu.close();
franta-hg@27
    81
franta-hg@27
    82
			String výsledek = načtiProud(p.getInputStream());
franta-hg@27
    83
			String chyby = načtiProud(p.getErrorStream());
franta-hg@27
    84
franta-hg@27
    85
			p.waitFor();
franta-hg@27
    86
franta-hg@27
    87
			if (chyby.length() == 0) {
franta-hg@28
    88
				// Pozor: pygmentize má i při chybě návratový kód 0 → je potřeba kontrolovat chybový výstup.
franta-hg@27
    89
				return výsledek;
franta-hg@27
    90
			} else {
franta-hg@28
    91
				System.err.print("Při zvýrazňování syntaxe došlo k chybě: " + chyby);
franta-hg@28
    92
				return null;
franta-hg@27
    93
			}
franta-hg@27
    94
		} else {
franta-hg@30
    95
			System.err.println("Příkaz " + PŘÍKAZ_PYGMENTIZE + " není na vašem systému dostupný → zvýrazňování syntaxe nebude fungovat.");
franta-hg@28
    96
			System.err.println("Můžete ho nainstalovat pomocí:");
franta-hg@28
    97
			System.err.println("\t$ aptitude install python-pygments   # (Debian/Ubuntu)");
franta-hg@28
    98
			System.err.println("\t$ yum install python-pygments        # (Fedora/RedHat)");
franta-hg@28
    99
			return null;
franta-hg@27
   100
		}
franta-hg@27
   101
	}
franta-hg@27
   102
franta-hg@28
   103
	/**
franta-hg@31
   104
	 * Vygeneruje CSS styl pro zvýrazňování syntaxe.
franta-hg@31
   105
	 * @return obsah CSS souboru nebo null, pokud generování nebylo možné
franta-hg@31
   106
	 */
franta-hg@31
   107
	public static String generujCssSyntaxe() throws IOException, InterruptedException {
franta-hg@36
   108
		if (isPříkazDostupný(PŘÍKAZ_PYGMENTIZE)) {
franta-hg@31
   109
			Runtime r = Runtime.getRuntime();
franta-hg@31
   110
			Process p = r.exec(new String[]{PŘÍKAZ_PYGMENTIZE, "-S", "default", "-f", "html"});
franta-hg@31
   111
			return načtiProud(p.getInputStream());
franta-hg@31
   112
		} else {
franta-hg@31
   113
			return null;
franta-hg@31
   114
		}
franta-hg@31
   115
	}
franta-hg@31
   116
franta-hg@31
   117
	/**
franta-hg@32
   118
	 * Vytvoří obrázek s diagramem.
franta-hg@32
   119
	 * @param zadání definice diagramu ve formátu dot
franta-hg@52
   120
	 * @param vodorovně zda má být graf orientovaný vodorovně (funguje jen při <code>kompletní = false</code>)
franta-hg@52
   121
	 * @param kompletní false, pokud k zadání chceme doplnit <code>digraph d {…}</code>
franta-hg@67
   122
	 * @param kontext kam diagram patří – typicky název stránky, do které je vložen
franta-hg@67
   123
	 * diagramy se pak budou číslovat v rámci tohoto kontextu 
franta-hg@67
   124
	 * → nebude docházet k přepisování diagramů jiných stránek při částečném přegenerování webu.
franta-hg@67
   125
	 * @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ě
franta-hg@32
   126
	 * @return název souboru bez přípony, který byl vytvořen, nebo null, pokud došlo k chybě.
franta-hg@32
   127
	 */
franta-hg@67
   128
	public static String vytvořDiagram(String zadání, boolean vodorovně, boolean kompletní, String kontext, String souborZadání) throws IOException, InterruptedException {
franta-hg@36
   129
		if (isPříkazDostupný(PŘÍKAZ_DOT)) {
franta-hg@67
   130
franta-hg@67
   131
			String soubor;
franta-hg@67
   132
			if (souborZadání == null) {
franta-hg@67
   133
				if (kontext == null) {
franta-hg@67
   134
					počítadloDiagramů++;
franta-hg@67
   135
					soubor = "diagram-" + počítadloDiagramů;
franta-hg@67
   136
				} else {
franta-hg@67
   137
					// TODO: tohle by se mělo udělat v XSLT
franta-hg@67
   138
					kontext = URLDecoder.decode(kontext, Charset.defaultCharset().name());
franta-hg@67
   139
					
franta-hg@67
   140
					// Každá stránka bude mít svoje diagramy číslované od 1
franta-hg@67
   141
					if (!počítadloDiagramůKontext.equals(kontext)) {
franta-hg@67
   142
						počítadloDiagramůKontext = kontext;
franta-hg@67
   143
						počítadloDiagramů = 0;
franta-hg@67
   144
					}
franta-hg@67
   145
					
franta-hg@67
   146
					počítadloDiagramů++;
franta-hg@67
   147
					soubor = "diagram-" + kontext + "-" + počítadloDiagramů;
franta-hg@67
   148
				}
franta-hg@67
   149
			} else {
franta-hg@67
   150
				soubor = souborZadání;
franta-hg@67
   151
			}
franta-hg@68
   152
			File adresářDiagramů = new File(ADRESÁŘ_VÝSTUPNÍ, ADRESÁŘ_DIAGRAMY);
franta-hg@68
   153
			if (!adresářDiagramů.exists()) {
franta-hg@68
   154
				adresářDiagramů.mkdirs();
franta-hg@68
   155
			}
franta-hg@68
   156
			String souborSložka = ADRESÁŘ_VÝSTUPNÍ + File.separator + ADRESÁŘ_DIAGRAMY + File.separator + soubor;
franta-hg@32
   157
franta-hg@52
   158
			String zdroják;
franta-hg@52
   159
			if (kompletní) {
franta-hg@52
   160
				zdroják = zadání;
franta-hg@52
   161
			} else {
franta-hg@52
   162
				StringBuilder b = new StringBuilder(zadání.length() + 200);
franta-hg@52
   163
				b.append("digraph d {\n");
franta-hg@52
   164
				b.append("\tbgcolor=\"transparent\";\n");
franta-hg@52
   165
				if (vodorovně) {
franta-hg@52
   166
					b.append("\trankdir=LR;");
franta-hg@52
   167
				}
franta-hg@52
   168
				b.append(zadání);
franta-hg@52
   169
				b.append("}\n");
franta-hg@52
   170
				zdroják = b.toString();
franta-hg@32
   171
			}
franta-hg@32
   172
franta-hg@32
   173
			Runtime r = Runtime.getRuntime();
franta-hg@32
   174
			Process p = r.exec(new String[]{PŘÍKAZ_DOT, "-T", "svg", "-o", souborSložka + ".svg"});
franta-hg@32
   175
franta-hg@32
   176
			/**
franta-hg@32
   177
			 * TODO: generovat i PNG bitmapu
franta-hg@32
   178
			 */
franta-hg@32
   179
			PrintStream vstupProcesu = new PrintStream(p.getOutputStream());
franta-hg@32
   180
			vstupProcesu.print(zdroják.toString());
franta-hg@32
   181
			vstupProcesu.close();
franta-hg@32
   182
franta-hg@32
   183
			String chyby = načtiProud(p.getErrorStream());
franta-hg@32
   184
franta-hg@32
   185
			p.waitFor();
franta-hg@32
   186
franta-hg@32
   187
			if (chyby.length() == 0) {
franta-hg@68
   188
				return ADRESÁŘ_DIAGRAMY + File.separator + soubor;
franta-hg@32
   189
			} else {
franta-hg@32
   190
				System.err.print("Při vytváření diagramu došlo k chybě: " + chyby);
franta-hg@32
   191
				return null;
franta-hg@32
   192
			}
franta-hg@32
   193
		} else {
franta-hg@32
   194
			System.err.println("Příkaz " + PŘÍKAZ_DOT + " není na vašem systému dostupný → diagramy nelze vygreslit.");
franta-hg@32
   195
			System.err.println("Můžete ho nainstalovat pomocí:");
franta-hg@32
   196
			System.err.println("\t$ aptitude install graphviz   # (Debian/Ubuntu)");
franta-hg@32
   197
			System.err.println("\t$ yum install graphviz        # (Fedora/RedHat)");
franta-hg@32
   198
			return null;
franta-hg@32
   199
		}
franta-hg@32
   200
	}
franta-hg@32
   201
franta-hg@32
   202
	/**
franta-hg@37
   203
	 * Převede text ve wiki syntaxi do XHTML.
franta-hg@37
   204
	 * @param wiki vstupní text v dané wiki syntaxi
franta-hg@37
   205
	 * @param syntaxe null nebo volitelně syntaxe (markdown, texy)
franta-hg@37
   206
	 * @return naformátované XHTML
franta-hg@37
   207
	 */
franta-hg@37
   208
	public static String formátujWiki(String wiki, String syntaxe) throws IOException {
franta-hg@37
   209
		if (isPříkazDostupný(PŘÍKAZ_MARKDOWN)) {
franta-hg@37
   210
			Runtime r = Runtime.getRuntime();
franta-hg@37
   211
			Process p = r.exec(new String[]{PŘÍKAZ_MARKDOWN});
franta-hg@37
   212
franta-hg@37
   213
			/**
franta-hg@37
   214
			 * TODO: oříznout mezery na začátcích řádků, pokud je jich všude stejně?
franta-hg@37
   215
			 * (odsazení v XML)
franta-hg@37
   216
			 */
franta-hg@37
   217
			PrintStream vstupProcesu = new PrintStream(p.getOutputStream());
franta-hg@37
   218
			vstupProcesu.print(wiki);
franta-hg@37
   219
			vstupProcesu.close();
franta-hg@37
   220
franta-hg@37
   221
			String chyby = načtiProud(p.getErrorStream());
franta-hg@37
   222
			String xhtml = načtiProud(p.getInputStream());
franta-hg@37
   223
franta-hg@37
   224
			if (chyby.length() == 0) {
franta-hg@37
   225
				return xhtml;
franta-hg@37
   226
			} else {
franta-hg@37
   227
				System.err.print("Při zpracování wiki syntaxe došlo k chybě: " + chyby);
franta-hg@37
   228
				return null;
franta-hg@37
   229
			}
franta-hg@37
   230
		} else {
franta-hg@37
   231
			System.err.println("Příkaz " + PŘÍKAZ_MARKDOWN + " není na vašem systému dostupný → nelze formátovat texty ve wiki syntaxi.");
franta-hg@37
   232
			System.err.println("Můžete ho nainstalovat pomocí:");
franta-hg@37
   233
			System.err.println("\t$ aptitude install markdown         # (Debian/Ubuntu)");
franta-hg@37
   234
			System.err.println("\t$ yum install perl-Text-Markdown    # (Fedora/RedHat)");
franta-hg@37
   235
			return null;
franta-hg@37
   236
		}
franta-hg@37
   237
	}
franta-hg@6
   238
}