Manuálové stránky online – TFM.cz
V kolonce Tvorba mám již nějakou dobu odkaz na tfm.cz. Na této adrese běží aplikace, která obsahuje databázi všech manuálových stránek z distribuce Debian a umožňuje jejich prohledávání a zobrazování. Stránky jsou převáděny do HTML, prolinkovány a je k nim přidán obsah.
Původně byly použity manuálové stránky ze stabilního Debianu Etch, nyní jsem upravil skripty tak, aby používaly repositáře Debian Unstable, přestože na serveru dále běží Etch. Update trval zhruba 20 hodin a stránek je teď dvojnásobek. Další aktualizace již budou inkrementální.
Opravil jsem i nějaké chyby a kolize, takže by se neměly objevovat stránky useknuté v polovině a podobné větší problémy. Drobné nedostatky způsobené převodem dvou velmi rozdílných formátů se asi budou vyskytovat vždy.
Frontend aplikace je napsán v TurboGears, backend tvoří skripty v Bashi a Perlu. K převádění man stránek do HTML používám hned tři nástroje – vlastní perl skript, Doclifter a rman, v tomto pořadí. Pokud převod selže, zkusí se další nástroj v řetězci.
Převod man stránek probíhá na požádání až při přístupu. U rozsáhlých stránek tak může první načtení trvat relativně dlouho, v extrémním případě až hodinu. Upozorňuji, že refresh to neurychlí, ale klidně si to vyzkoušejte sami :-) Další přístupy jsou pak již normální.
Podobných služeb samozřejmě existuje spousta. Mým původním záměrem bylo nejen zkusit si něco takového naprogramovat, ale také dotáhnout tuto službu trochu dále, co se týče aktuality man stránek, kvality jejich zobrazení a vůbec rozsahu celé databáze. To jsem nyní více či méně splnil. Kromě toho jsem měl řadu nápadů ohledně přidaných funkcí a dalšího obsahu, ale to bude muset zase nějaký čas počkat…