Instalace a použití
Ještě než začneme
Pro běh programu potřebujete Ant a Saxon, pro stažení zdrojových kódů Mercurial. V distribucích postavených na Debianu si je snadno nainstalujete pomocí následujícího příkazu:
$ aptitude install ant libsaxonb-java mercurial # (Debian/Ubuntu)
(tento software potřebujete jen na počítači, kde stránky vygenerujete – pak je samozřejmě můžete nahrát na server, kde žádný takový software není)
Pozor na chybu #21 – do jejího vyřešení je doporučeno použít SaxonB 9.0 (např. z Ubuntu Lucid Lynx).
Volitelné balíčky
Součástí generátoru je i sada ukázkových vstupních dokumentů (stránek), které používají volitelné funkce generátoru – např. zvýrazňování syntaxe nebo vkládání diagramů. Pro překlad těchto ukázkových stránek tedy doporučujeme nainstalovat následující balíčky.
Pygments – pro zvýrazňování syntaxe:
$ aptitude install python-pygments # (Debian/Ubuntu) $ yum install python-pygments # (Fedora/RedHat)
Graphviz – pro vkládání diagramů:
$ aptitude install graphviz # (Debian/Ubuntu) $ yum install graphviz # (Fedora/RedHat)
Markdown – pro zpracování wiki syntaxe:
$ aptitude install markdown # (Debian/Ubuntu) $ yum install perl-Text-Markdown # (Fedora/RedHat)
Pokud tyto funkce ve svých stránkách používat nechcete, tyto volitelné balíčky si nemusíte instalovat.
Stažení programu
Aktuální verzi programu si stáhnete tímto příkazem:
hg clone https://hg.frantovo.cz/xml-web-generator
Záložní úložiště: http://hg.vps.frantovo.cz/xml-web-generator/ (synchronizované jednou za hodinu).
První generování
Program se nemusí kompilovat (a pokud některé části ano, ani si toho nevšimnete, postará se o to Ant). Jednoduše vstupte do adresáře a nechte mravence dělat jeho práci:
cd xml-web-generator ant
V adresáři výstup se vám objeví vygenerovaný web – obsahuje ukázková data. Tím jste ověřili, že vše funguje. Můžete teď klidně upravit XML soubory v adresáři vstup a vygenrovat si z nich svůj vlastní web.
