<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">%% $Id: xevlna-inc.tex 535 2017-03-25 16:38:58Z zw $

\ifeng

\section{English manual}
This is a manual for âvlnaâ implemented in \XeTeX. It can be used in plain \XeTeX\ as well as in
\XeLaTeX.

\else

\section{\texorpdfstring{ÄeskĂ˝ manuĂĄl}{Cesky manual}}
Toto je manuĂĄl balĂ­Äku âvlnaâ implementovanĂŠho pomocĂ­ \XeTeX u. Lze jej pouĹžĂ­t jak pro plain
\XeTeX, tak pro \XeLaTeX.

\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{ĂÄel}
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{Installation}
The package consists of the following files:
\begin{itemize}
\item \texttt{xevlna.sty} â put it to the directory where both \texttt{xetex} and \texttt{xelatex}
expect included files, preferably \verb;texmf-dist/tex/xelatex/xevlna/;
\item \texttt{xevlna.pdf} â compiled manual, put it to a directory where \texttt{texdoc} looks for
documentation, preferably \verb;texmf-dist/doc/xevlna/;
\item \texttt{xevlna.tex}, \texttt{xevlna-inc.tex} â source files of the manual
\end{itemize}

\else

\subsection{Instalace}
BalĂ­Äek se sklĂĄdĂĄ z nĂĄsledujĂ­cĂ­ch souborĹŻ:
\begin{itemize}
\item \texttt{xevlna.sty} â uloĹžte jej do adresĂĄĹe, kde \texttt{xetex} i \texttt{xelatex}
oÄekĂĄvajĂ­ vklĂĄdanĂŠ soubory, nejlĂŠpe \verb;texmf-dist/tex/xelatex/xevlna/;
\item \texttt{xevlna.pdf} â zkompilovanĂ˝ nĂĄvod, vloĹžte jej do adresĂĄĹe, odkud \texttt{texdoc} Äte
dokumentaci, nejlĂŠpe \verb;texmf-dist/doc/xevlna/;
\item \texttt{xevlna.tex}, \texttt{xevlna-inc.tex} â zdrojovĂŠ soubory nĂĄvodu
\end{itemize}

\fi

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\ifeng

\subsection{Usage in \texorpdfstring{\XeLaTeX}{XeLaTeX}}
The package is used in \XeLaTeX\ by:

\else

\subsection{PouĹžitĂ­ v \texorpdfstring{\XeLaTeX u}{XeLaTeXu}}
BalĂ­Äek se pouĹžije v \XeLaTeX u:

\fi

\medskip
\begin{verbatim}
\usepackage{xevlna}
\end{verbatim}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\ifeng

\subsection{Usage in plain \texorpdfstring{\XeTeX}{XeTeX}}
The package is used in plain \XeTeX\ by:

\else

\subsection{PouĹžitĂ­ v plain \texorpdfstring{\XeTeX u}{XeTeXu}}
V plain \XeTeX u se balĂ­Äek pouĹžije takto:

\fi

\medskip
\begin{verbatim}
\input xevlna.sty
\end{verbatim}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\ifeng

\subsection{Enabling and disabling}
Insertion of nonbreakable spaces may be undesirable in some parts of a multilingual document. It
may therefore be disabled by \cmd{xevlnaDisable} and enabled \cmd{xevlnaEnable}. Insertion is
enabled by default.

\else

\subsection{ZapnutĂ­ a vypnutĂ­ vlnek}
VklĂĄdĂĄnĂ­ vlnek mĹŻĹže bĂ˝t neĹžĂĄdoucĂ­ v nÄkterĂ˝ch ÄĂĄstech vĂ­cejazyÄnĂŠho dokumentu. Lze jej vypnout
makrem \cmd{xevlnaDisable} a znovu zapnout makrem \cmd{xevlnaEnable}. Po naÄtenĂ­ balĂ­Äku je
vklĂĄdĂĄnĂ­ vlnek zapnuto.

\fi

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\ifeng

\subsection{Implementation details}
The package makes use of the \cmd{XeTeXinterchartoks} mechanism. New classes for prepositions and
opening punctuation are allocated by \cmd{newXeTeXintercharclass}. The nonbreakable space is
inserted whenever a single character belonging to the preposition class is followed by a space. It
will therefore be inserted in expression \verb;o liĹĄce; but not in expression \verb;po liĹĄce;. The
preposition itself cannot be typeset in a different font because the space is not recognised in
such a case. If \verb;\textit{i} v \textbf{lese}; is
entered, the nonbreakable space will be inserted after \textit{v} but not after italic \textit{i}.
The text following the preposition may be in a different script. The nonbreakable space will be
inserted after Czech preposition \textit{v} in:
\else

\subsection{ImplementaÄnĂ­ detaily}
V balĂ­Äku je vyuĹžĂ­vĂĄn mechanismus \cmd{XeTeXinterchartoks} specifickĂ˝ pro \XeTeX. PomocĂ­ pĹĂ­kazu \cmd{newXeTeXintercharclass}
jsou alokovĂĄny novĂŠ tĹĂ­dy pro pĹedloĹžky a otevĂ­racĂ­ interpunkci. NezlomitelnĂĄ mezera (vlnka) je
vloĹžena, pokud za samostatnĂ˝m znakem z tĹĂ­dy pĹedloĹžek nĂĄsleduje mezera. Bude tedy vloĹžena do
vĂ˝razu \verb;o liĹĄce;, ne vĹĄak do vĂ˝razu \verb;po liĹĄce;. PĹedloĹžka nesmĂ­ bĂ˝t sĂĄzena jinĂ˝m fontem.
Ve vĂ˝razu \verb;\textit{i} v \textbf{lese}; bude vlnka vloĹžena za pĹedloĹžku \textit{v}, ale nebude
vloĹžena za spojku \textit{i} v kurzĂ­vÄ. Text po pĹedloĹžce mĹŻĹže bĂ˝d psĂĄn i jinĂ˝m pĂ­smem. Vlnka bude
vloĹžena za pĹedloĹžkou \textit{v}~i ve vĂ˝raze:
\fi
v ŕ¤Śŕ¤żŕ¤˛ŕĽŕ¤˛ŕĽ.

\ifeng

The package does not use â@â in the macro names\footnote{Usage of â@â is now needed for
recognitnion of \XeTeX\ version and hence setting the correct boundary class.} in order to make it easily usable in plain \XeTeX.
This brings a danger of redefining internal macros by a user. The packages defines and immediatelly
consumes \cmd{next} and makes use of these internal macros:

\else

BalĂ­Äek nepouĹžĂ­vĂĄ â@â ve jmĂŠnech maker\footnote{Znak â@â je nynĂ­ nutnĂ˝ pro rozpoznĂĄnĂ­ verze
\XeTeX{}u a tudĂ­Ĺž sprĂĄvnĂŠmu nastavenĂ­ hodnoty \emph{boundary class}.}, aby bylo usnadnÄno pouĹžitĂ­ v plain \XeTeX u. To vĹĄak
pĹinĂĄĹĄĂ­ nebezpeÄĂ­, Ĺže bude internĂ­ makro pĹedefinovĂĄno uĹživatelem. BalĂ­Äek definuje a okamĹžitÄ
pouĹžije \cmd{next} a pouĹžĂ­vĂĄ tato internĂ­ makra:

\fi

\begin{itemize}
\item \cmd{CSopenpunctuation}
\item \cmd{CSnonsyllabicpreposition}
\item \cmd{CSinterchartoks}
\item \cmd{CSnointerchartoks}
\item \cmd{PreCSpreposition}
\item \cmd{ExamineCSpreposition}
\item \cmd{ProcessCSpreposition}
\item \cmd{xevlnaXeTeXspace}
\end{itemize}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\ifeng
\subsection{Changes}
Version 1.1 reflects increased number of character classes and is backward compatible with older
versions of \XeTeX.
\else

\subsection{ZmÄny}
Verze 1.1 bere ohled na zvĂ˝ĹĄenĂ˝ poÄet znakovĂ˝ch tĹĂ­d a je zpÄtnÄ kompatibilnĂ­ s pĹedchozĂ­mi verzemi
\XeTeX u.
\fi

\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} 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} nebo na
\fi
\url{http://www.latex-project.org/lppl.txt}
</pre></body></html>