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í)

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, vkládání diagramů atd. 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.

 Ukázka výstupu