Version 10 (modified by fiki, 9 years ago)

Ant: napovídání tabulátorem

Často kladené dotazy

Na této stránce najdete nejčastěji kladené dotazy.

Technické dotazy

Změnil jsem záhlaví (nebo zápatí) a vygeneroval web. Ve výstupním adresáři jsou ale pořád staré texty.

Ant pracuje úsporně a generuje jen ty stránky, které se změnily. Dobře to funguje u vlastních stránek (*.xml), Ant se podívá na poslední změnu vstupního a výstupního souboru a pokud je vstupní novější, přegeneruje danou stránku. U vložených stránek (*.inc) to nefunguje, protože Ant neví, co se děje uvnitř XSLT šablony (neví, které soubory se vkládají), takže pokud se změní jen vnitřní stránka, Ant to nepozná. Řešením je nejdříve vyčistit výstupní adresář a až pak generovat – provedete to následujícím příkazem:

ant čisti generuj

Vsuvka: Předpokládám, že máte nějaký slušný operační systém – v takovém případě můžete šetřit klávesnici: stačí napsat ant a použít tabulátor – BASH vám napoví jednotlivé příkazy daného skriptu (agregace, čisti, generuj, kompiluj-funkce, statický-obsah, stránky). K vypsání možností včetně popisu slouží ant -p.

Alternativním řešením je aktualizovat datum poslední změny všech stránek (tím ale budou všechny stránky vypadat jako změněné – projeví se to v RSS/Atom exportech):

touch vstup/*

Stránky se nezobrazují v Microsoft Internet Exploreru. Funguje generátor špatně?

Ne, generátor funguje správně. Vytváří výstup, který je validní podle platných standardů (pokud by nebyl, je to chyba – nahlaste ji prosím – a musí být opravena) a následně jsou stránky poskytovány webovým serverem se správným MIME typem (na základě přípony .xhtml). Na straně generátoru a serveru je tedy vše v pořádku – chyba je na straně daného prohlížeče, který je příliš zaostalý na to, aby zobrazoval moderní webové stránky. Více si můžete přečíst zde:  Microsoft/Windows Internet Explorer and XHTML Error. Doporučujeme vyvarovat se použití tohoto „prohlížeče“ – ušetříte si mnoho práce a nervů. Pokud přeci jen z nějakého důvodu potřebujete, aby v něm bylo možno stránky zobrazit, zapněte si v generátoru podporu zaostalých prohlížečů – v souboru build.xml změňte následující hodnoty:

<property name="výstupníPřípona" value=".html"/>
<param name="podporaZaostalýchProhlížečů" expression="true"/>

Podívejte se také na snímky obrazovek jednotlivých prohlížečů.

Proč jsou proboha názvy ukázkových stránek s diakritikou? Proč to nenapíšeš stylem nejaka-stranka.xml?

Jak říkal Suvorov: Těžko na cvičišti – lehko na bojišti. Systém se vyvíjí a testuje s tím, že názvy souborů můžou obsahovat diakritiku a mezery. Pokud to uživatelé v praxi nevyužijí, tím lépe – ale program s takovými názvy musí počítat.

Licence, copyrighty a copylefty

Generátor je vydaný pod GNU GPL licencí. Znamená to, že i můj web, který pomocí něj vytvořím, musí být šířen pod touto licencí?

Ne. Licence programu se nepřenáší na data (vygenerované stránky). Web si tedy můžete šířit pod jakou licencí chcete (nebo ho nemusíte šířit vůbec). Je to jako když v  Gimpu nakreslíte obrázek – také si s ním můžete dělat, co chcete.

Na každé vygenerované stránce je odkaz na tento program. Musím ho tam nechat?

Ne. Stránky jsou vaše. Pokud vám byl program k užitku, uděláte mi radost, když někam ten odkaz vložíte, nebo o programu řeknete svým kamarádům. Ale není to vaše povinnost.

Organizační záležitosti

Chci nahlásit chybu nebo se přispět k vývoji generátoru.

Napište mi přes zprávu  kontaktní formulář.