summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/encxvlna/vlna-inc.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/encxvlna/vlna-inc.tex')
-rw-r--r--Master/texmf-dist/doc/generic/encxvlna/vlna-inc.tex299
1 files changed, 299 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/generic/encxvlna/vlna-inc.tex b/Master/texmf-dist/doc/generic/encxvlna/vlna-inc.tex
new file mode 100644
index 00000000000..e7b00c7c35b
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/encxvlna/vlna-inc.tex
@@ -0,0 +1,299 @@
+%% $Id: vlna-inc.tex 202 2008-06-14 18:55:05Z zw $
+% Included file, encoding UTF-8, see vlna-enctex.sty
+
+\ifeng
+
+\section{English manual}
+This is a manual for ``vlna'' implemented in enc\TeX\ of February 2003. Enc\TeX\ itself and the
+macros for plain \TeX\ were developed by Petr Olšák. \LaTeX\ version was derived from it by Zdeněk
+Wagner.
+
+\else
+
+\section{\texorpdfstring{Český manuál}{Cesky manual}}
+Toto je manuál balíčku "`vlna"' implementovaného pomocí enc\TeX{}u z února~2003. Enc\TeX\ a makra
+pro plain \TeX\ vytvořil Petr Olšák. Verzi pro \LaTeX\ z nich odvodil Zdeněk Wagner.
+
+\fi
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\ifeng
+
+\subsection{Purpose}
+The purpose of the package is to insert nonbreakable spaces (\verb:~:, in Czech \textit{vlna} or
+\textit{vlnka}) after nonsyllabic prepositions and single letter conjuctions directly while \TeX
+ing the document. The macros recognise math and verbatim by \TeX\ means. Inserting nonbreakable
+spaces by a preprocessor may never be fully reliable because user defined macros and environments
+cannot be recognised.
+
+\else
+
+\subsection{\texorpdfstring{Účel}{Ucel}}
+Tento balíček slouží ke vkládání nezlomitelných mezer (vlnek) za neslabičné předložky a
+jednopísmenné spojky přímo při \TeX ování dokumentu. Makra rozeznávají matematiku a verbatim \TeX
+ovými prostředky. Vkládání nezlomitelných mezer preprocesorem nikdy nemůže být naprosto
+spolehlivé, protože uživatelsky definovaná makra a prostředí nelze rozpoznat.
+
+\fi
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\ifeng
+
+\subsection{Requirements}
+This package requires enc\TeX\ of February 2003. It is often available in the distribution but is
+not activated as default. In order to activate it you have to regenerate your formats using the
+\texttt{-enc} switch. In some distributions, such as \TL, you have to edit
+\texttt{fmtutil.cnf}, possibly by running \texttt{texconfig}. The excerpt from my
+\texttt{fmtutil.cnf} in \TL~2007 is shown in Section~\ref{fmtutil}.
+
+In case you do not have enc\TeX\ at all you have to build it yourself from the sources found at
+\url{http://math.feld.cvut.cz/olsak/enctex.html}
+
+\else
+
+\subsection{\texorpdfstring{Požadavky}{Pozadavky}}
+Tento balíček vyžaduje enc\TeX\ z února 2003. Ten je obvykle v distribucích obsažen, avšak není
+aktivován. Pro jeho aktivaci musíte znovu vygenerovat formáty s použitím parametru \texttt{-enc}. V
+některých distribucích, např. v \TL, budete muset upravit soubor \texttt{fmtutil.cnf},
+pravděpodovně pomocí programu \texttt{texconfig}. Část mého \texttt{fmtutil.cnf} z \TL~2007
+je ukázána v kapitole~\ref{fmtutil}.
+
+V případě, že enc\TeX\ nemáte, musíte si jej zkompilovat sami ze zdrojů, které najdete na
+\url{http://math.feld.cvut.cz/olsak/enctex.html}
+
+\fi
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\ifeng
+
+\subsection{Package contents}
+The package contains:
+\begin{description}
+\item[encxvlna.pdf] --- this manual
+\item[encxvlna.tex, vlna-inc.tex] --- manual sources
+\item[encxvlna.tex] --- plain \TeX\ macros
+\item[encxvlna.sty] --- \LaTeX\ package file
+\item[License.txt] --- license
+\end{description}
+
+File \texttt{vlna.tex} is a part of enc\TeX\ but it was previously distributed with \TL\ in a wrong
+directory. Moreover, since enc\TeX\ is not enabled as default, the macros might be used without it.
+This will generate error messages that might not be understood by beginners. The modified file
+\texttt{encxvlna.tex} differs from
+the version included in enc\TeX\ just by a descriptive error message.
+
+\else
+
+\edef\pom{---\space\ignorespaces}
+
+\subsection{\texorpdfstring{Obsah balíčku}{Obsah balicku}}
+Balíček obsahuje:
+\begin{description}
+\item[encxvlna.pdf] \pom tento manuál
+\item[encxvlna.tex, vlna-inc.tex] \pom zdrojový kód manuálu
+\item[encxvlna.tex] \pom makra pro plain \TeX
+\item[encxvlna.sty] \pom balíček pro \LaTeX
+\item[License.txt] \pom licence
+\end{description}
+
+Soubor \texttt{vlna.tex} je součástí enc\TeX{}u, ale původně byl distribuován v \TL\ ve špatném
+adresáři. Protože navíc enc\TeX\ není v \TL\ standardně aktivován, mohou být makra použita bez něj.
+To způsobí chyby, jimž nemusí začátečníci rozumět. Modifikovaná verze \texttt{encxvlna.tex} se liší od verze obsažené v
+enc\TeX{}u pouze více popisnou chybovou zprávou.
+
+\fi
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\ifeng
+
+\subsection{Usage in plain \TeX}
+Usage in plain \TeX\ is simple. Just put the following command before your text:
+
+\else
+
+\subsection{\texorpdfstring{Použití}{Pouziti} v plain \TeX u}
+Použití v plain \TeX{}u je velmi jednoduché. Vložte před svůj text příkaz:
+
+\fi
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\smallskip
+\begin{verbatim}
+\input encxvlna
+\end{verbatim}
+
+\smallskip
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\ifeng
+
+Remember that some macro definitions may confuse this package. The best location for the above
+mentioned command is \textit{after} all definitions but before the text.
+
+\else
+
+Nezapomeňte, že některé definice maker mohou tento balíček zmást. Nejlepší místo pro výše uvedený
+příkaz je tedy \textit{za} všemi definicemi, ale před vlastním textem.
+
+\fi
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\ifeng
+
+\subsection{Usage in \LaTeX}
+Usage in \LaTeX\ is similarly simple. Put the following command to your preamble:
+
+\else
+
+\subsection{\texorpdfstring{Použití}{Pouziti} v \LaTeX u}
+Použití v \LaTeX{}u je stejně jednoduché. Vložte do preambule příkaz:
+
+\fi
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\smallskip
+\begin{verbatim}
+\usepackage{encxvlna}
+\end{verbatim}
+
+\smallskip
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\ifeng
+
+Remember that some packages and macro definitions may contain code which may confuse this package.
+The manual for \textsc{hyperref} says that it should be placed as the last package but it would
+report weird error messages if it is loaded after \textsc{encxvlna}. The best place for the above
+mentioned command is thus just above \verb;\begin{document};.
+
+The \textsc{encxvlna} package itself postpones some commands using \verb;\AtBeginDocument;. If you load
+it by this hook, it will be too late and you will see other weird error messages.
+
+\else
+
+Nezapomeňte, že některé balíčky a definice maker mohou obsahovat kód, který tento balíček zmate.
+Návod k balíčku \textsc{hyperref} říká, že má být načten jako poslední, ale právě to způsobí výpis
+podivných chybových zpráv, pokud bude balíček \textsc{encxvlna} načten dříve. Nejlepší místo pro výše
+zmíněný příkaz je tedy přímo nad \verb;\begin{document};.
+
+Samotný balíček \textsc{encxvlna} využívá \verb;\AtBeginDocument; k odložení některých příkazů. Pokud
+se pokusíte využít téhož mechanismu k načtení tohoto balíčku, bude to příliš pozdě a dočkáte se
+dalších podivných chybových zpráv.
+
+\fi
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\ifeng
+
+\subsection{Modifications in the \LaTeX\ version}
+As already written the \LaTeX\ package was derived from the original plain \TeX\ file. In addition
+to creation of the package signature the following modifications were made:
+
+\begin{enumerate}
+\item Definition of \verb;\uv; was removed because it appears in the Czech and Slovak language
+definition files.
+\item Register \verb;\mubytein; is set to 2 at the beginning of the document.
+\item Czech and Slovak language definition files for \textsc{babel} introduce in version~3.1
+new syntax for writing quotes, namely \verb;"`v lese"';. This is added to the list of recognised
+patterns.
+\item Definition of \verb;\protect; is tested so that the macros do nothing in moving arguments.
+\item Definition of \verb;\rm; is compared to \verb;\@empty; so that outlines are correctly created
+by \textsc{hyperref}.
+\item Tests were added in order to enable work with the \textsc{microtype} package.
+\end{enumerate}
+
+The macros now need 15 \verb;\expandafter;'s!
+
+\else
+
+\subsection{Modifikace ve verzi pro \LaTeX}
+Jak již bylo napsáno, verze pro \LaTeX\ byla odvozena z původních maker pro plain \TeX. Kromě
+vytvoření signatury \LaTeX ového balíčku byly provedeny tyto změny:
+
+\begin{enumerate}
+\item Byla odstraněna definice \verb;\uv;, protože se vyskytuje v jazykových definičních souborech
+pro češtinu a slovenštinu.
+\item Registr \verb;\mubytein; je naplněn hodnotou 2 až na začátku dokumentu.
+\item České a slovenské jazykové definiční soubory pro \textsc{babel} zavádějí od verze~3.1 novou
+syntaxi pro zápis uvozovek: \verb;"`v lese"';. Toto je přidáno do seznamu rozpoznávaných vzorů.
+\item Testuje se definice \verb;\protect; tak, aby makra nedělala nic v pohyblivých (moving)
+argumentech.
+\item Definice \verb;\rm; se porovnává s \verb;\@empty;, aby balíček \textsc{hyperref} správně
+vytvořil záložky.
+\item Byl přidán test, který umožní spolupráci s balíčkem \textsc{microtype}.
+\end{enumerate}
+
+Makra nyní potřebují 15 příkazů \verb;\expandafter;!
+
+\fi
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\ifeng
+
+\subsection{Important note for \LaTeX\ users}
+There is a problem with the \textsc{url} package and hence with \textsc{hyperref} which loads
+\textsc{url}. As a matter of fact it is not a problem of \textsc{encxvlna} but a problem of enc\TeX\
+and \textsc{Unicode}. Lines 39 and 50 of \texttt{url.sty} contain unprintable characters which are
+not legal as UTF-8 character sequences. Everything works fine until you try to typeset a URL while
+converting the input from UTF-8 by enc\TeX. It is sufficient to set \verb;\mubytein; to zero just
+before loading \textsc{url} or \textsc{hyperref}. If you load these packages including
+\textsc{encxvlna} in correct order just
+before \verb;\begin{document};, you need not bother with setting back a nonzero value to
+\verb;\mubytein;. Look into the source code of this manual, into file
+\else
+
+\subsection{\texorpdfstring{Důležitá poznámka pro uživatele}{Dulezita poznamka pro uzivatele}
+\LaTeX u}
+Při použití balíčku \textsc{url}, a tudíž \textsc{hyperref}, jenž \textsc{url} načítá, nastává
+problém. Ve skutečnosti to není problém balíčku \textsc{encxvlna}, ale problém enc\TeX{}u a
+\textsc{Unicode}. Řádky 30 a 50 v souboru \texttt{url.sty} obsahují netisknutelné znaky, jež jsou
+nepovolenými znakovými sekvencemi v UTF-8. Vše funguje správně až do chvíle, kdy chcete vytisknout
+URL a současně konvertovat vstup z UTF-8 enc\TeX em. Postačí, když vynulujete \verb;\mubytein;
+před načtením \textsc{url} či \textsc{hyperref}. Načítáte-li tyto balíčky včetně balíčku
+\textsc{encxvlna} ve správném pořadí bezprostředně před příkazem \verb;\begin{document};, nemusíte se starat o
+návrat nenulové hodnoty do registru \verb;\mubytein;. Podívejte se do zdrojového kódu tohoto
+manuálu, do souboru
+\fi
+\texttt{encxvlna.tex}
+\ifeng
+in directory
+\else
+v adresáři
+\fi
+\texttt{doc/generic/encxvlna}.
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\ifeng
+Similar problems are encountered when using the \textsc{movie15} package. You have to include the
+\cmd{includemovie} command within a group setting
+\else
+Podobné problémy nastávají při použití balíčku \textsc{movie15}. Musíte příkaz \cmd{includemovie} uzavřít do
+skupiny,v níž nastavíte
+\fi
+\verb;\mubytein=0;.
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\ifeng
+\subsection{License}
+The package can be used and distributed according to the LaTeX Project Public License version~1.3 or later the
+text of which can be found at the \texttt{License.txt} file in the \texttt{doc} directory or at
+\else
+
+\subsection{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
+\fi
+\url{http://www.latex-project.org/lppl.txt}