# PB029: Elektronická příprava dokumentů (podzim 2023)

Tato stránka slouží ke zveřejňování informací a podpůrných materiálů k předmětu PB029 – Elektronická příprava dokumentů vyučovaného Petrem Sojkou, Michalem Růžičkou, Vítem Starým Novotným, Terezou Vrabcovou a Marií Starou na Fakultě informatiky Masarykovy univerzity v Brně.

Po absolvování tohoto kursu bude student schopen aplikovat základní principy, algoritmy a techniky tvorby dokumentů, využít je při svém studiu a (týmové) publikační činnosti (psaní bakalářské, diplomové, či disertační práce, příprava prezentačních materiálů, webové stránky, dokumentace programu apod.). Student se bude schopen orientovat v moderních publikačních technologiích a formátech a prakticky pracovat se software pro tvorbu elektronických dokumentů.

Popis organizace předmětu a metod hodnocení je rekapitulován v rámci prvního cvičení.

## Aktuality

- Na FI MU byla instalována a je průběžně aktualizována distribuce TeX Live 2023 (jak pod Windows v B311 a jinde, tak jako TeXový modul `texlive-2023` na unixových strojích). Neočekávané chování či požadavky na doinstalování stylů pište na texlive@fi.muni.cz.
- Služba Overleaf provedla aktualizaci distribuce TeX Live na verzi 2023. Zajímavé informace související s aktualizací a vývojem systému naleznete na blogu služby Overleaf.
- Fakulta informatiky zakoupila pro své studenty a zaměstnance dostatek Pro licencí webového editoru LaTeXových dokumentů Overleaf. Pro více informací vizte článek na fakultním webu.
- Do sekce s podpůrnými materiály byl přidán odkaz na první tři kapitoly autorské kuchařky, která popisuje proces tvorby dokumentů a slouží jako doplňující četba k přednášce. Na kuchařku se vztahuje prémiový úkol s nahlašováním chyb v materiálech předmětu.
- Bylo zřízeno diskusní fórum k makrobalíkům fithesis, mubeamer a muletter, kde můžete i mimo PB029 diskutovat formální stránku přípravy závěrečných prací MU a dalších dokumentů. Dobře anglicky dokumentovaná verze fithesis (fithesis4) je v BP Terezy Vrabcové oceněné cenou děkana. Vše je dostupné k užití i v instalovaném fakultním modulu `texlive` nebo na Overleaf.

## Materiály pro cvičení

### Organizační pokyny

Základní organizační pokyny, požadavky na účast a metody hodnocení.

### Seznámení s použitým software

Technické vybavení a základní informace o použitém software.

### Textové soubory

Rozdíly a záludnosti textových souborů na různých platformách v mezinárodním prostředí.

### Správa verzí elektronických dokumentů

Správa verzí elektronických dokumentů pomocí systému Git pro správu verzí a pomocí webové služby GitLab FI.

### Značkování textu v LaTeXu

Příprava dokumentů v LaTeXu pomocí strukturního značkování.

### Sazba závěrečných prací a prezentací

Závěrečné vysokoškolské práce jsou komplexní dokumenty, při jejichž přípravě lze s výhodou využít LaTeX. Při přípravě prezentace k obhajobě pak lze části závěrečné práce znovu použít s pomocí LaTeXové třídy beamer.

### Různé podoby TeXu

Různé podoby TeXu: TeX, e-TeX, pdfTeX, XeTeX, LuaTeX, plain TeX, csplain, LaTeX, ConTeXt … a co si s tím vším počít.

### Česká sazba TeXem

Jak TeXem sázet české/slovenské dokumenty.

### Automatizace sazby dokumentu

Vývoj dokumentů v TeXu se v mnoha ohledech podobá vývoji programů. Proces překladu dokumentu se může skládat z několika kroků, jejichž provádění je vhodné automatizovat.

### Sazba bibliografie

Sazba bibliografie (seznamu použité literatury) TeXem.

### Sazba rejstříku

Tvorba a sazba rejstříků TeXem pro usnadnění orientace v rozsáhlých dokumentech.

### Slučování dokumentů

Při překladu dokumentu pdfTeXem/XeTeXem/LuaTeXem můžete do dokumentu snadno vložit obsah PDF dokumentu.

### Obrázky v TeXu

Vytváření a vkládání obrázků do dokumentů sázených TeXem. Použití externích nástrojů pro tvorbu bitmapových a vektorových obrázků.

### Nástroje pro WYSIWYG DTP

Nejen TeXem živ je člověk. Pro přípravu graficky náročnějších publikací může být pohodlnější a praktičtější využití WYSIWYG nástrojů pro DTP.

### XML

Základní principy XML, tvorba vlastního XML jazyka s formální definicí pomocí XML Schema, transformace XML.

### Oddělení formy od obsahu a jazyk (X)HTML

Základní principy tvorby webových stránek, oddělení formy od obsahu.

### Jazyky CSS a JavaScript

Vytváření formy a interaktivních prvků webových stránek.

### Mikrotypografie

V moderních implementacích kompilátoru TeXu máte možnost používat i mikrotypografická rozšíření známá např. z HZ-programu.

### Korektury textů

Chybovat je lidské, ale nepoučit se z chyb a neopravovat je „cestou do pekel“. Krom znalosti pravidel je ještě třeba získat dovednost chyby rozpoznat a vyznačit (jednoznačným způsobem pro sazeče nebo pro sebe).

## Prémiové úkoly (nepovinné)

Některé z níže uvedených projektů vyžadují detailní domluvu s vyučujícím, proto před jejich realizací vyučujícího kontaktujte. K instalaci modulů na FI je třeba nastudovat instrukce pro práci s moduly na FI MU.

- až 10 bodů: Instalace nejnovějších verzí programu Evince, Okular, InkScape, Scribus, GhostScript (GPL), gv/GSView (za každý balík) na všechny podporované platformy do systému modulů na FI MU.
- až 20 bodů: Evaluace kerningu loga MU dle algoritmu Optical Letter Spacing - for new printing systems by David Kindersley a sepsání zprávy do Zpravodaje CSTUGu.
- až 20 bodů: Evaluace psychologie a věrnosti podání barev loga MU a FI v závislosti na použitých barevných modelech, procesu tisku a použitých médiích.
- až 25 bodů: Aktualizace a dopsání brožury Začínáme s TeXem, Overleaf, Grammarly na FI MU.
- až 25 bodů: Příprava brožury Začínáme s (X)Emacsem na FI MU.
- až 40 bodů: Kompilace programu opatgen moderním kompilátorem C++ (GNU C) z archív práce Davida Antoše pro zařazení na TeX Live 2023.
- až 40 bodů: Nasazení svobodného webového editoru Overleaf na svém stroji a pojednání o záludnostech instalace a rozdílech oproti placené verzi služby.
- až 20 bodů: Reportování chyb v materiálech předmětu autorům, vizte detailní informace v cvičení o správě verzí.

Případně je možné dohodnout se i na zadání závěrečné práce (viz. Rozpis témat závěrečných prací) nebo zformulovat projekt Programu děkana FI.

## Zápočtové úkoly (povinné)

Vypracování zápočtových úloh je nutné pro úspěšné absolvování předmětu. Zápočtové úlohy jsou dvě: první je TeXem vysázený text odevzdávaný na papíře, druhou úlohou je návrh a použití vlastního jednoduchého XML jazyka.

Prostudujte si detailní požadavky a termíny.

## Podpůrné materiály

- Rozpracovaná autorská kuchařka, která popisuje proces tvorby dokumentů
- Internetová jazyková příručka Ústavu pro jazyk český AV ČR
- Kniha Průvodce tvorbou dokumentů od Jiřího Rybičky, Petry Čačkové a Jana Přichystala
- Ukázková kapitola Základy příkazového interpretu z knihy Linux: Příručka českého uživatele od Viléma Vychodila
- Materiály k TeXu a LaTeXu:
  - Články The very short guide to typesetting with LaTeX a A short introduction to LaTeX
  - Knihy LaTeX Wikibook, Ne příliš stručný úvod do systému LaTeX2e, LaTeX pro začátečníky, LaTeX pro pragmatiky a Drsný úvod do LaTeXu
  - Yetiho typografický bestiář, příručka pro sazbu matematiky v češtině
  - Materiály k předmětu M5751 Elektronická sazba a publikování v TeXu vyučovanému na Přírodovědecké fakultě.
- Materiály k HTML, kaskádovým stylům (CSS) a JavaScriptu:
  - Základní tutoriály k (X)HTML, CSS a JavaScriptu v češtině
  - Kniha Ponořme se do HTML5 od Marka Pilgrima
  - Základní a pokročilé tutoriály k (X)HTML, CSS a JavaScriptu
  - W3Schools, školičky k webovým technologiím

Další materiály je možné dohledat přes portál elektronických informačních zdrojů MU a souborný katalog knihoven MU.

## Užitečné odkazy

- Návody pro technické vybavení FI MU.
- Validační služby: W3C (X)HTML Validator | W3C CSS Validator
- Generátor citací.
- Detexify – LaTeX handwritten symbol recognition – vyhledávání LaTeXového zápisu symbolů načrtnutím hledaného znaku myší.
- Návrh, grafika, sazba: 101 věta o knižní úpravě | servery Typo a Grafika | Edward Tufte
- Fonty: LaTeX Font Catalogue | vzorník písem Linotype | vzorník písem Adobe | Helvetica
- Psaní závěrečné práce: Jak psát závěrečnou práci
- Sdružení uživatelů: TeX Users Group (TUG) | Československé sdružení uživatelů TeXu (CSTUG)
- Ostatní: Port různých GNU Utilities pro Windows | domovská stránka DEK