summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/csbulletin/csbulletin.tex
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/csbulletin/csbulletin.tex
Initial commit
Diffstat (limited to 'macros/latex/contrib/csbulletin/csbulletin.tex')
-rw-r--r--macros/latex/contrib/csbulletin/csbulletin.tex144
1 files changed, 144 insertions, 0 deletions
diff --git a/macros/latex/contrib/csbulletin/csbulletin.tex b/macros/latex/contrib/csbulletin/csbulletin.tex
new file mode 100644
index 0000000000..f3a37600bf
--- /dev/null
+++ b/macros/latex/contrib/csbulletin/csbulletin.tex
@@ -0,0 +1,144 @@
+%% $Id$
+\documentclass{csbulletin}
+\DeclareRobustCommand\version{\unskip~v.\,1.2}
+\let\pkg\textsc
+
+\usepackage[utf8]{inputenc}
+\usepackage[pdftitle=LaTeX\ Class\ for\ CSTUG\ Bulletin, pdfauthor={Zdenek\ Wagner, Vit\ Novotny},
+ 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, Vít Novotný}
+\podpis{Zdeněk Wagner, Vít Novotný\\\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}
+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}
+\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{Tabulky a obrázky}
+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{Chyby}
+Třída \pkg{csbulletin} nemá žádné známé zjevné chyby.
+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}