summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/xelatex/xevlna/xevlna-inc.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/xelatex/xevlna/xevlna-inc.tex')
-rw-r--r--Master/texmf-dist/doc/xelatex/xevlna/xevlna-inc.tex186
1 files changed, 186 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/xelatex/xevlna/xevlna-inc.tex b/Master/texmf-dist/doc/xelatex/xevlna/xevlna-inc.tex
new file mode 100644
index 00000000000..5afe5efd1c0
--- /dev/null
+++ b/Master/texmf-dist/doc/xelatex/xevlna/xevlna-inc.tex
@@ -0,0 +1,186 @@
+%% $Id: xevlna-inc.tex 474 2013-04-20 19:57:02Z 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/xetex/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/xetex/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 \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 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, 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{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}