%% $Id: csbulletin.tex 30 2008-08-05 20:03:02Z zw $ \input utf8-t1 % text is in UTF8, requires encTeX % for ISO-8859-2: %& --translate-file=il2-t1.tcx % for CP-1250: %& --translate-file=cp1250t1.tcx % for CP-852: %& --translate-file=cp852t1.tcx \documentclass{csbulletin} % No optional packages needed % Macros \DeclareRobustCommand\version{\unskip~v.\,1.0} \let\pkg\textsc % Hack for hyperref \mubytein 0 \usepackage[pdftitle=LaTeX\ Class\ for\ CSTUG\ Bulletin, pdfauthor=Zdenek\ Wagner, pdfkeywords=CSTUG\ Bulletin,bookmarks=false]{hyperref} % section numbering \setcounter{secnumdepth}{2} \begin{document} \title{Styl pro Zpravodaj Československého sdružení uživatelů \TeX{}u,\version} \EnglishTitle{\LaTeX\ Class for \CSTUG\ Bulletin,\version} \author{Zdeněk Wagner} \podpis{Zdeněk Wagner\\\url{http://bulletin.cstug.cz}} \maketitle \begin{abstract} Tento dokument popisuje třídu pro psaní článků do Zpravodaje Československého sdružení uživatelů \TeX{}u. Dokument je určen zejména pro české a slovenské autory, proto je psán česky. Je psán ve stylu pro Zpravodaj, autoři se tedy mohou podívat přímo do zdrojového kódu tohoto manuálu a napsat svůj článek obdobně. \end{abstract} \section{English introduction} \begin{otherlanguage}{english} This manual describes the \LaTeX\ class used for articles for the Bulletin of the Czechoslovak \TeX\ Users Group (\cstug). Since it is asumed that its audience will will be mainly the Czech and Slovak users, the manual is written in Czech. We do publish articles in other languages occasionally. In such a case you can prepare the article just in the standard \pkg{article} class. The \pkg{csbulletin} class is modelled after it with just a few modifications. You can also look into the source text of this manual. It is written intentionally using the \pkg{csbulletin} class. You can therefore write your article according to it. \end{otherlanguage} \section{Úvod} Od roku 2008 je styl pro Zpravodaj Československého sdružení uživatelů \TeX{}u implementován jako třída (class). Makra jsou psána tak, aby hlavní soubor dokázal načíst celý článek včetně příkazů \cmd{documentclass} a případných \cmd{usepackage}. Třída \pkg{csbulletin} je odvozena ze standardní třídy \pkg{article}. Je přidáno pouze několik maker. Tento manuál tedy lze spíše chápat jako instrukce pro autory. \section{Použité balíčky} Prosím, uvědomte si, že celý Zpravodaj se zpracovává pdflatexem jako jeden dokument. Používejte proto pouze balíčky, které skutečně v dokumentu potřebujete. Dávejte přednost vlastnímu jednoduchému makru před komplikovaným balíčkem, který může způsobit kolizi s balíčky potřebnými pro jiné články. Tím nechceme autory odrazovat od používání balíčků v nezbytných případech, jen je vhodné, aby autoři uvážili, zda nelze problém řešit jednoduššími prostředky. Třída \pkg{csbulletin} nějaké balíčky načítá automaticky. Jejich seznam je uveden v následujících podsekcích. \subsection{Povinné balíčky} Balíčky, uvedené v následujícím seznamu, se načítají vždy. Musíte je tedy mít instalovány. \begin{itemize} \item Balíček \pkg{csbulacronym} definuje běžné akronymy robustním způsobem pomocí \cmd{DeclareRobustCommand} a některé speciální akronymy, jako je např. makro \cmd{cstug} pro \cstug. Soubor je dodáván společně s třídou \pkg{csbulletin}. Definice se používají i mimo Zpravodaj, proto jsou v samostatném souboru. \item \pkg{fontenc} s parametrem T1 \item \pkg{lmodern} \item \pkg{ifpdf} \item \pkg{mflogo} \item \pkg{babel}, viz kapitola~\ref{babel}. \end{itemize} \subsection{Nepovinné balíčky} Některé balíčky jsou využívány v redakci při sazbě finální verze Zpravodaje, ale pro pracovní verzi článku nejsou nezbytné. Jejich instalace na počítači autorů tedy není vyžadována. Třída jejich přítomnost detekuje a načte je, pokud jsou v počítači přítomny. \begin{itemize} \item \pkg{microtype} \item \pkg{array} \item \pkg{fancyvrb} \item \pkg{verbatim} \item \pkg{encxvlna} je program \pkg{vlna} implementovaný v enc\TeX u. Jeho účelem je doplnění vlnek za neslabičné předložky přímo při \TeX ování. Balíček bude načten pouze v případě, že máte enc\TeX\ aktivován. \end{itemize} \subsection{Babel}\label{babel} Třída \pkg{csbulletin} vyžaduje \pkg{babel} s moduly pro češtinu a slovenštinu ve verzi~3.2 nebo novější. Tato verze je distribuována na \TeX Live~2008, ale dělení slov funguje pouze v kódování~T1. Pokud máte starší verzi těchto modulů, bude \LaTeX\ hlásit chybu na dvou příkazech \cmd{languageattribute}. Chyby odstraníte použitím parametru \texttt{oldcsbabel} v hranatých závorkách v příkazu \cmd{documentclass}. \section{Začátek souboru} Prvním příkazem souboru, kde lze (viz sekce~\ref{babel}) použít nepovinný parametr, je: \medskip \verb;\documentclass{csbulletin}; \medskip Pak můžete načíst nezbytné balíčky, definovat vlastní makra a prostředí. Všechny definice budou lokální pro váš článek, nemusíte se proto obávat kolizí s články jiných autorů. Implicitním jazykem pro Zpravodaj je čeština. Pokud je článek psán v jiném jazyce, vložte hned za \cmd{begin\{document\}} přepínač \cmd{selectlanguage} se správným jazykem. Název článku zapište do makra \cmd{title}, jména autorů do makra \cmd{author} a anglický název do makra \cmd{EnglishTitle}. Nepovinně můžete použít makro \cmd{podpis}, jehož parametr se objeví kurzívou na konci článku. Poté použijte makro \cmd{maketitle}. Abstrakt článku v jazyce článku zapište v prostředí \texttt{abstract}. Ve výjimečných případech lze abstrakt vynechat. Na konci článku uveďte anglický souhrn v prostředí \texttt{summary}. Anglický název bude vzat z příkazu \cmd{EnglishTitle}, přepnutí jazyka se též provede automaticky. Anglický souhrn nemusí být přesným překladem abstraktu. Redakce se postará o jazykovou korekturu anglického souhrnu. V případě, že jej autor nedodá, postará se o překlad redakce. \section{Číslování kapitol} Implicitně nejsou kapitoly ve Zpravodaji číslovány. Složitější články jsou však bez číslování nepřehledné. Číslování zapnete vložením kladné hodnoty do čítače \texttt{secnumdepth}. V tomto manuálu je před \verb;\begin{document}; použit příkaz \verb;\setcounter{secnumdepth}{2};. \section{Návěští} V třídě \pkg{csbulletin} jsou předefinována makra \cmd{label}, \cmd{ref} a \cmd{pageref} tak, aby jejich názvy byly pro každý článek unikátní. Nemusíte se proto bát kolize s články jiných autorů. \section{Tabulky a obrázky} Článek ve Zpravodaji nezačíná vždy na nové stránce. Nekoncipujte tudíž stránky absolutně. Všechny tabulky a obrázky musí být v plovoucích prostředích. Musí mít název v makru \cmd{caption} a případně symbolický název definovaný v makru \cmd{label}. \section{Reference} Styl pro Zpravodaj zatím není připraven pro použití \BibTeX{}u, ale v budoucích verzích se s tím počítá. Pravděpodobně bude pro potřeby Zpravodaje upraven balíček \pkg{chapterbib}. \section{Chyby} Třída \pkg{csbulletin} nemá žádné známé zjevné chyby. Jisté konflikty i se způsobem řešení jsou zmíněny v dokumentaci balíčku \pkg{encxvlna} a nejsou zcela dořešeny kolize při použití v OS/2. V každém případě je třeba si uvědomit, že třída samotná pracuje na hranicích možností \LaTeX{}u. Použití různých balíčků může vést k dalším problémům. Redakce se bude snažit o vyřešení všech nahlášených potíží. \section{Licence} Balíček může být používán a šířen podle \LaTeX\ Project Public License verze~1.3 nebo novější, jejíž text najdete v souboru \texttt{LICENSE.txt} v adresáři \texttt{doc}, nebo na \url{http://www.latex-project.org/lppl.txt} \begin{summary} The package provides the class for articles for the \cstug\ Bulletin (Zpravodaj Československého sdružení uživatelů \TeX u). You can see the structure of a document by looking to the source file of this manual. The package can be used and distributed according to the \LaTeX\ Project Public License. \end{summary} \end{document}