Cyklus vývoje dokumentů prakticky

Na cvičeních z PB029 bude převážně využíván volně šiřitelný software (TeX, GhostScript, ...), na němž si prakticky vyzkoušíte teoretické znalosti z přednášek. K dispozici budou dvě možnosti nastavení, buď pouze s využitím prostředků, které nabízejí Windows, nebo lze použít UNIXové platformy na FI (Linux x86/AMD64). Druhá možnost je vzhledem k omezeným praktickým zkušenostem cvičících s OS Windows doporučována.

Pokud jste TeXem na FI ještě nikdy nepracovali, můžete si přečíst brožurku Začínáme s TeXem na fi.muni.cz. V současnosti je brožurka v některých pasážích již zastaralá, její aktualizace bude odměněna bonusovými body. Nová je naopak knížka kolegy Satrapy LaTeX pro pragmatiky.

TeX pod UNIXem

TeXová distribuce, nejčastěji TeXlive, je na většině platforem dostupná nebo předinstalovaná. Na UNIXových platformách na FI funguje systém modulů. Hlavní modul pro práci je instalace TeXu v modulu texlive-2013. Místo modulu texlive-2013 je možno používat ještě moduly texlive-2012, texlive-2011, texlive-2010, texlive-2008, texlive-2005a, texlive2003, texlive-6 nebo tex. Tyto moduly však doporučujeme pouze pro zpětnou kompatibilitu (překlad starších dokumentů).

Nastavení prostředí pro práci s modulem texlive-2013 pod UNIXem

Vsadíte-li na spolehlivost UNIXu (po lepší ovlivnitelnost chování doporučeno):

• Spuštění programu "Start => Programs => Remote Access => Xming => Xming", což je X-Server pro OS Windows.
• Pomocí PuTTY ("Start => Programs => Remote Access => Putty => PuTTY") se přihlásíte na libovolný UNIXový stroj (doporučujeme některý ze strojů v počítačové hale například nymfeXY, nebo aisa). Zaškrtnutím volby Connection -> SSH -> X11 -> Enable X11 forwarding v konfiguraci PuTTY zajistíte, aby programy posílaly X-výstup na váš stroj pro Xming.
• Příkazem module add texlive-2013 provedete nezbytná nastavení TeXového modulu a můžete jej poté začít používat. V průběhu semestru budeme používat rozmanitý software. Potřebné moduly se navíc na různých strojích mohou lišit. Je proto vhodné přidat si potřebné příkazy do souboru ~/.profile resp. ~/.bashrc. Ukázkový kód je možné stáhnout ze stránek pro podporu cvičení Michala Růžičky.

Otestování nástrojů pro práci:

• latex sample2e pro přeložení anglického dokumentu sample2e.tex do DVI.
• pdflatex sample2e pro přeložení sample2e.tex do formátu PDF.
• xdvi sample2e pro prohlížení sample2e.dvi.
• dvips sample2e pro vytvoření PostScriptu sample2e.ps z sample2e.dvi.
• dvipdfmx sample2e pro vytvoření PDF z DVI.
• gv sample2e.ps pro prohlížení PostScriptu (nebo také PDF) pomocí programu ghostview.
• acroread sample2e.pdf pro prohlížení PDF.

První sezení by po přihlášení mohlo v xtermu vypadat takto:

# vytvoření pracovního adresáře
mkdir tex; cd tex
# přidání modulu
module add acrobat texlive-2013
# nalezení a zkopirování příkladu LaTeXového souboru 
# s názvem sample2e.tex do běžného adresáře
cp `kpsewhich sample2e.tex` .
# překlad dokumentu sample2e.tex
latex sample2e
# prohlížení vysázeného dokumentu sample2e.dvi
xdvi sample2e &
# konverze do PostScriptu
dvips sample2e -o sample2e-dvips.ps
# prohlizeni vysledneho sample2e-dvips.ps
gv sample2e-dvips.ps
# konverze ps do pdf
ps2pdf sample2e-dvips.ps
# konverze dvi do pdf
dvipdfmx -o sample2e-dvipdfmx.pdf sample2e
# prohlížení výsledku
acroread sample2e-dvipdfmx.pdf &
# přímé vytvoření pdf pdftexem
pdflatex sample2e
# prohlížení výsledku
gv sample2e.pdf &

Pro editaci zdrojových souborů můžete používat v podstatě jakýkoliv textový editor, např. Emacs (lze ale použít jakýkoliv jiný, třeba (g)Vim, pico, joe apod.).

Pokud ještě nemáte zkušenosti s mocnými editory typu Emacs či (g)Vim, můžete pro začátek použít např. velmi jednoduché textové editory jako pico či joe.

TeX pod Windows

Byť pod Windows je nejrozšířenější distribucí MikTeX, na FI je v B311 instalován také TeXlive 2013 pro stoprocentní portabilitu s nbsp;Unixem. Jsou instalovány TeX-GUI editory TeXnicCenter a TeXworks.

Nastavení prostředí pro práci s TeXem ve Windows na FI

• V "Start => Document Tools" je k dispozici zástupce, který namapuje jako disk T:\ sdílený síťový svazek s TeXovou instalací (fyzicky se používá TeX Live z UNIXového modulu, na všech platformách je tedy zaručena práce s identickou instalací TeXu). Po namapování by nemělo být nutné pro volání TeXových programů na příkazovém řádku nastavovat PATH. (V $PATH zůstane síťová cesta \\home\share\texlive-2013.). Může to být užitečné k jednoduchému prohlédnutí adresářové struktury TeXové instalace.
• Otevřete sample2e.tex svým oblíbeným editorem.
• Jako textový editor pro přípravu zdrojových textů dokumentů je možné použít jakýkoliv textový editor (Emacs, Vim, pico, joe, Notepad, ...). Pro vývoj dokumentů v TeXu pod Windows existují speciální grafická prostředí (např. TeXnicCenter, TeXworks, WinEdt (shareware, zakoupený FI), TeXShell). V učebně dostupné editory jsou k dispozici v Start => Document Tools.
• V konfiguraci TeXnicCenter je pro korektní práci nutné změnit nastavení na texlive-2013
• Pro spouštění TeXworks používejte dávku TeXWorks PATH.cmd.
• Ke spouštění příkazů na příkazovém řádku používejte okno získané Start => Command Prompt => "cmd".
• Překlad z příkazového řádku se provádí pomocí stejných příkazů jako pod UNIXem (latex, pdflatex, dvips, ...).
• Vygenerované *.dvi soubory si můžete prohlížet pomocí programu DVIOut.
• Vygenerované *.ps soubory si můžete prohlížet pomocí programu GSView (GhostScript).
• Vygenerované *.pdf soubory si můžete prohlížet pomocí programu Adobe Reader nebo také GSView (GhostScript).

Praktické úkoly k procvičení

• Vyzkoušejte si on-line prostředí pro práci s TeXem na ScienceSoft.at nebo na mendelu.cz
• Najděte v TeXové instalaci soubor sample2e.tex programem kpsewhich. (man kpsewhich)
• Zkopírujte si ho do svého pracovního adresáře a prostředí.
• Přeložte ho: latex sample2e
• Prohlédněte si výsledný DVI soubor programem xdvi.
• Vytvořte sample2e.ps pomocí dvips a prohlédněte pomocí GhostScript resp. GSView.
• Vytvořte sample2e.pdf pomocí pdflatex a prohlédněte pomocí Adobe Acrobatu/Readeru.
• Vytvořte sample2e.pdf z DVI pomocí dvipdfmx a prohlédněte pomocí GhostScript/GSView.
• Vytvořte sample2e.pdf z PS pomocí ps2pdf a prohlédněte pomocí GhostScript/GSView nebo Adobe Readeru/Acrobatu. Porovnejte výstup obou cest.
• Přečtěte si manové stránky zmíněných programů (pod UNIXem, příkazem man nazev-programu).
• [Případně si zkonfigurujte emacs a prohlédněte si v něm sample2e.tex (syntax highlighting). Zkoušejte opakovaně Ctrl-C Ctrl-C Ret. [A až vás to přestane bavit, můžete zmáčknout Alt-x a napsat gomoku ;-).]]

Různé, poznámky

Pokud úkoly pro dnešní (či další) cvičení nestihnete v hodině (což se dá čekat pokud například s TeXem začínáte), kromě cvičení se předpokládá pravidelná individuální samostatná práce), zůstává automaticky jako domácí úkol do následujícího cvičení.

• Základ systému vývoje dokumentů sdílí (pod UNIXem v /packages) stejné adresáře, proto můžete při vývoji dokumentu (BP, DP) plynule přecházet mezi různými platformami na FI při garanci stejného zlomu dokumentu.
• Aktuální (září 2013) verze instalace TeXu (TeX Live 2013) je vystavena ke stažení. DVD je k zapůjčení v knihovně FI. Případní aktivisté TeX Live (instalace, reporting chyb, testeři, práce na dokumentaci či vývoji) budou hojně odměněni prémiovými body.
• Na začátku každého cvičení PB029 si automaticky otevřete prohlížeč se stránkou věnovanou danému cvičení (bude na ni odkaz z domovské stránky předmětu http://www.fi.muni.cz/~sojka/PB029/).
• Účast na cvičeních PB029 je povinná, jsou povoleny maximálně dvě neomluvené absence. Omluvenky nedávejte vyučujícím, ale na studijní oddělení FI MU. Nadpočetné absence lze kompenzovat řešením prémiových úkolů (1 absence za 5 bodů)
• Institut prémiových bodů: V brožuře Začínáme s TeXem na fi.muni.cz zkuste najít chybu (faktickou či typografickou, špatný či nefunkční popis chování), za prémiový bod.