diff options
Diffstat (limited to 'Master/texmf-dist/doc/generic/hyph-utf8/bg/azbukaExtended.tex')
-rw-r--r-- | Master/texmf-dist/doc/generic/hyph-utf8/bg/azbukaExtended.tex | 649 |
1 files changed, 0 insertions, 649 deletions
diff --git a/Master/texmf-dist/doc/generic/hyph-utf8/bg/azbukaExtended.tex b/Master/texmf-dist/doc/generic/hyph-utf8/bg/azbukaExtended.tex deleted file mode 100644 index 099309a4246..00000000000 --- a/Master/texmf-dist/doc/generic/hyph-utf8/bg/azbukaExtended.tex +++ /dev/null @@ -1,649 +0,0 @@ -\documentclass[12pt,a4paper,twosided]{article} -\usepackage[utf8]{inputenc} -\usepackage[T2A]{fontenc} % temporary to make MakeUppercase work. -%\usepackage[english,bulgarian]{babel} -\usepackage[english,bulgarian]{babel} -\usepackage{mathptm} -\def\№{\Romannumeral} - - -\usepackage[bulgarian]{varioref} % my modified varioref.sty - % waiting for the author of - % varioref.sty to release this officially. - % DO NOT DISTRIBUTE! - -\title{Notes on Bulgarian typesetting in \LaTeX } -\author{Georgi Boshnakov} - - -\begin{document} - -% \selectlanguage{bulgarian} - -% \selectlanguage{english} - -%%% "`abvg"' -%%% -%%% \shorthandoff{"} -%%% -%%% "`abvg"' -%%% -%%% \shorthandon{"} -%%% -%%% "№ -%%% -%%% -%%% -%%% \foreignlanguage{english}{``This is an English phrase.''} - -%\enumBul - -% \makeatletter -% \@Alph3, \@alph3 - -% \enumEng - -% \@Alph3, \@alph3 - -% \enumBul \@Alph3, \@alph3 - -% \makeatother - - -%%% \latintext -%%% -%%% \textcyrillic{АБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯ} -%%% -%%% \cyrillictext -%%% -%%% \textlatin{abcdefghijklmnop} -%%% -%%% \Bulgarian bg: ``adfafdadfafdsaf'' a' b' -%%% -%%% {\English eng1: ``adfafdadfafdsaf'' a' b'} -%%% -%%% {\selectlanguage{english} eng2: ``adfafdadfafdsaf'' a' b'} -%%% -%%% \selectbglanguage -%%% -%%% -%%% % \selectenglanguage - - -\maketitle - -\tableofcontents - -\section{Introduction} \label{sec:intro} - - -This document shows some features specific to the Bulgarian typesetting with babel. -The text is mainly English but the main language of the document, as far as \LaTeX{} is -concerned, is Bulgarian. This is possible because the encoding T2A contains the latin -characters. On the other hand, the effect is that English hyphenation is not turned on and -therefore English words are not hyphenated or, if they are, they may be wrongly hyphenated. -I have done this deliberately to emphasise that it is a good practice to change explicitly -the language. - -This document was written initially for my package \texttt{bulgaria} developed in 1994-1996 to -support Bulgarian language in the then new version of \LaTeX. Since at the time the encoding -systems in general where in transition and because there was no standard for cyrillic ones I -assembled some fonts to support the MIK encoding (the prevalent encoding at the time in -Bulgaria, its origins are in DOS but it was supported in Windows as well, not by Microsoft -though). This allowed me to introduce a fully working implementation only a few months after -\LaTeX2e{} became the official \LaTeX{} version. - -I later modified this to work with the Babel system the most important change being the -switch to the use of standard fonts and encodings. -I handed this to the Babel developer Johannes Braams who is currently maintaining it. - - -Prompted by some enquiries, I released the hyphenation stuff separately in may 2006. It can -be found in the \texttt{language} subdirectory on CTAN or on my web page. - -% Note that currently the MikTeX suite replaces my hyphenation patterns (available as part of -% the babel package) with different ones which seem not to work. So, I release my hyphenation -% files separately as well. - - -Comments and suggestions are welcome. -I do not give my email address here (because of the spamming curse) but you can easily find -me with a search engine. -I will maintain the hyphenation and, if there is -demand, release a new set of patterns to support the more stylish traditional hyphenation -(the current patterns are the simplified ones, born in the computer age). - - -\section{Language and encoding} \label{sec:langenc} - - - -There are still many encoding systems around, you need to tell \LaTeX{} which one you use. -For example, -\begin{verbatim} - \usepackage[cp1251]{inputenc} -\end{verbatim} -specifies the cyrillic encoding typically used in Windows. -This line should be one of the first few lines after the \verb+\documentclass+ declaration. - -The input encoding is completely independent of the internal encoding used by -\LaTeX. You generally do not need to be concerned with it but for completeness here is the -command that specifies the internal (cyrillic) encoding \texttt{T2A}: -\begin{verbatim} - \usepackage[T2A]{fontenc} -\end{verbatim} -This should not be needed but see the section about uppercase/lowercase below. - -To change language you may use the babel assorment of commands, say -\begin{verbatim} - \selectlanguage{english} - \selectlanguage{bulgarian} -\end{verbatim} -see the user guide of Babel for details. -There are useful shorthands like -\verb+\Bul+, -\verb+\Bg+, -\verb+\Eng+, -\verb+\latintext+, -and -\verb+\cyrillictext+. - - - -\section{Alphabet} \label{sec:alphabet} - - - -\subsection{Entering cyrillic letters} - -The best way to enter Bulgarian text is to type it in some of the standard encodings -and leave \LaTeX\ to struggle with the conversion work (it knows most of the cyrillic -encodings). To tell \LaTeX{} the input encoding, put near the beginning of your document a -line like -\begin{center} -\verb+\usepackage[utf8]{inputenc}+ -\end{center} -if you are in the modern age and/or Linux, -or -\begin{center} -\verb+\usepackage[MIK]{inputenc}+ -\end{center} -if you prefer ``classic DOS'' and the MIK encoding, -or -\begin{center} -\verb+\usepackage[cp1251]{inputenc}+ -\end{center} -if you do not know what I am talking about and are on a Windows system. - -This command is usually placed write after the \verb+\documentclass+ command. - -If you need to enter only a couple of words you may also use commands like \verb+\cyra+, -\verb+CYRA+, \verb+\cyryu+, \verb+\CYRYU+. The number sign can be obtained by \verb+\No+ or -\verb+\textnumero+. - -For example, \verb+\CYRA\CYRB\CYRV, \cyra\cyrb\cyrv+ produces -\begin{center} -\CYRA\CYRB\CYRV, \cyra\cyrb\cyrv -\end{center} - -Accents in Bulgarian are used very rarely. This is done only to designate where the stress -falls in certain special circumstances (mainly to avoid confusion). For example, \verb+\`{и}+ -gives \`{и}. This is unambigously a pronoun which if written without the accent may -occasionally be confused with the conjunction и (Bulgarian for ``and''). - -Warning: the shorter \verb+\`и+ works in all encodings except utf8. It is prudent to always -add the braces to avoid irritation if you decide to switch to utf8. - -% \"е - - -\subsection{Changing letter case (Uppercase/Lowercase)} - -Use the \LaTeX{} commands \verb+\MakeLowercase+ and \verb+\MakeUppercase+ to change case of a -piece of text. For example, - -\verb+\MakeLowercase{АБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯ №}+ - -\noindent -gives - -\MakeLowercase{АБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯ №} - -\noindent -(All letters should change to lowercase, if MakeLowercase works properly.) - - -\noindent -Similarly - -\verb+\MakeUppercase{абвгдежзийклмнопрстуфхцчшщъыьэюя №}+ - -\noindent -gives - -\MakeUppercase{абвгдежзийклмнопрстуфхцчшщъыьэюя №} - -\noindent -% (All letters should change to uppercase, if MakeUppercase works properly.) - -Note that the symbol № is unchanged by both commands since it is not a regular letter. - -If the above commands do not change the case properly, then this should be rectified by -including the command \verb+\usepackage[T2A]{fontenc}+ in the preamble of your document -(this command should not be needed as T2A is the default encoding, a bug may have crawled in -somehow). If you have the \verb+.tex+ source of this file you may wish to comment out the -\verb+usepackage+ command for package \verb+fontenc+ and compile the file to see the -difference, if any. - - -\subsection{The symbol №} - -The symbol № is not particularly important but it is used occasionally, e.g., - -№\,1, №\,20, №№\,1--5. - -The Bulgarian keyboard has a key №. The commands -\verb+\textnumero+ and \verb+\No+ produce № as well. - - - \begin{table} \label{table:No} -\centering -\begin{tabular}{cc} -\LaTeX{} source & typeset output \\ \hline -\verb+\textnumero\,3+ & \textnumero\,3 \\ -\verb+\No\,3+ & \No\,3 \\ -\verb+№\,3+ & №\,3 -\end{tabular} - - \end{table} - - - -% \CYRA\CYRB\CYRV, \cyra\cyrb\cyrv - - -\subsection{Roman numbers} - -In Bulgarian texts, uppercase Roman numbers are often used for ordinal -numbers. Most of them can be entered via the Bulgarian keyboard: the letters I and V are -available precisely for that purpose, M and C are the same in the cyrillic alphabet, but L is -missing. This does not matter much in the case of a computer keyboard. Even so, I prefer to -redefine the I and V keys for more important tasks and leave the computer render a number in -Roman form, see also the comments in section~{sec:bugs}. - -The command \verb+\Romannumeral+ (with shorthand \verb+\№+ defined in the preamble of this -file) is provided for capitalised Roman numbers, e.g.: -\verb+\№1+, -\verb+\№8+, -\verb+\№26+, -\verb+\№{26}+, -give -\№1, \№8, \№26, and \№{26}, -respectively. This example shows also that arguments with 2 or more decimal digits have to be -put in braces. - - -\subsection{Quoting styles} - -The quotation marks in texts typeset in Bulgarian traditionally look like "`this"'. -This style and the quotes themselves have been borrowed from the German language. - -To get traditional Bulgarian style quotes enclose the text in \verb+"`+ and \verb+"'+. -To get the French style quotes use \verb+"<+ and \verb+">+ instead. For example, - -\begin{verbatim} - ``English style quotes'' \par - "`текст в традиционните за български текстове кавички"' \par - "<алтернативни кавички, срещани предимно в по-стари текстове"> -\end{verbatim} - -\noindent -gives -% \selectlanguage{bulgarian} - -\bigskip{} - - ``English style quotes'' \par - "`текст в традиционните за български текстове кавички"' \par - "<алтернативни кавички, срещани предимно в по-стари текстове"> - -% \selectlanguage{english} - -\bigskip - -Note that in the pre-babel \verb+bulgarian.sty+ quotes in Bulgarian texts were typeset -automatically in the traditional Bulgarian style. - - -\subsection{Dates} - -The command \verb+\today+ produces the current date, e.g. today is \today. - -In the traditional format for dates in Bulgaria uppercased roman numbers are used for the -months, e.g. today is \todayRoman. - -\begin{center} - \begin{tabular}{cc} -\LaTeX{} source & typeset output \\ \hline -\verb+\today+ & \today \\ -\verb+\todayRoman+ & \todayRoman - \end{tabular} -\end{center} - - - -\section{Hyphenation} \label{sec:hyph} - - -When you choose a language for \emph{babel}, \LaTeX{} hyphenates the text -according to the hyphenation rules of that language. -So, normally you do not need to do anything more to get proper hyphenation. - -If your Bulgarian text does not get hyphenated, then you need to tell -the \TeX{} system to load Bulgarian hyphenation rules. The details are -system dependent but not complicated, see the documentation of your -\TeX{} distribution for details. - -For example, if you are using MikTeX, start its \emph{Settings} -utility (known also as \emph{MikTeX options}, click the -\emph{Language} tab, tick \emph{bulgarian}, and click OK. MikTeX will -tell you that it needs to regenerate the formats, let it do it. That -is it. Process a document to see that hyphenation works. - -If you find words that do not hyphenate properly, then send me an email. - - - - - - - - - - - -\section{Enumeration} \label{sec:enum} - - - -Alphabetic enumeration is usually done with the Bulgarian alphabet but latin enumeration is -used as well. Besides the alphabet, the style of the enumeration is somewhat different from -the English one. - -We provide facilities for both cyrillic and latin enumeration. By default, the cyrillic one -is switched on by commands changing the language to Bulgarian. The declarations -\verb+\alphEng+ and \verb+\alphBul+ may be used to switch to and from latin enumeration, if -desired. - -Note that the cyrillic enumeration here simply uses cyrillic letters wherever the standard -\LaTeX\ enumeration style would produce alphabetic enumeration. This is definitely not -satisfactory and a fuller implementation might change other details but this is better left -to document classes. - - -The letters й, ъ, and ь are not used for enumeration and therefore omitted. Note that the -cyrillic letters э and ы are not part of the Bulgarian alphabet anyway. - -\begin{enumerate} \label{enum:1} - \item a - - \begin{enumerate} - \item aa - \begin{enumerate} - \item aaa - \begin{enumerate} - \item aaaa - - \item bbbb - - \item cccc - - \item dddd - - \end{enumerate} - - \item bbb - - \end{enumerate} - - \item bb - - \item cc - - \item dd - - \end{enumerate} - - \item b - -\end{enumerate} - - -The following enumeration is preceded by the command -\verb+\enumEng+. - -\enumEng - -\begin{enumerate} \label{enum:2} - \item a - \begin{enumerate} - \item aaaaaaa - \begin{enumerate} - \item aaaaaaa - \begin{enumerate} - \item aaaaaaa - - \item bbbbbbb - - \item cccccc - - \end{enumerate} - - \item bbbbbbb - - \item cccccc - - \end{enumerate} - - - \end{enumerate} - - \item b - -\end{enumerate} - -\section{Support for the varioref package} - - -The package \texttt{varioref} allows for producing cross-references which look natural and -generally do not require manual intervention when the context changes. Support for Bulgarian -should be available with the next release of \LaTeX{}. This file has been produced with a -draft version of the package. - -The table below is an illustration. Notice that the page reference command is the same in all cases -but the printed text changes depending on its relative distance from the reference point. -Also, references to the current page and the facing page are automatically varied to some -extent. - -\begin{center} - -\begin{tabular}{l|l} -command & typeset output \\ \hline -\verb+\vpageref{sec:intro}+ & \vpageref{sec:intro} \\ -\verb+\vpageref{enum:1}+ & \vpageref{enum:2} \\ -\verb+\vpageref{enum:2}+ & \vpageref{enum:2} \\ -\verb+\vpageref{table:No}+ & \vpageref{table:No} - -\end{tabular} -\end{center} - -It is instructive to see what output would have produced if the above table turned up on the -following page. The table on the next page is generated by the same \LaTeX{} source as the -table above. There is a \verb+\newpage+ command after this paragraph to ensure that the two -tables are on different pages. - - -\newpage - -\begin{center} - -\begin{tabular}{l|l} -command & typeset output \\ \hline -\verb+\vpageref{sec:intro}+ & \vpageref{sec:intro} \\ -\verb+\vpageref{enum:1}+ & \vpageref{enum:2} \\ -\verb+\vpageref{enum:2}+ & \vpageref{enum:2} \\ -\verb+\vpageref{table:No}+ & \vpageref{table:No} - -\end{tabular} -\end{center} - - - -% Some text follows to illustrate the usage of the commands in the -% \texttt{varioref}. -% This paragraph is repeated at several places in this document, its text -% source is exactly the same but the output depends on the relative position of the referenced -% pages. Some silly page references follow. The introduction begins -% \vpageref{sec:intro}, -% the enumeration \vpageref{enum:1} illustrates the default enumeration labels when -% Bulgarian is active while the enumeration \vpageref{enum:2} -% shows an alternative. -% The table \vpageref{table:No} shows several ways to typeset \No. -% The especially dull introduction starts \vpageref{sec:intro} -% and if this sentence is on the same page as the beginning of this paragraph the wording of -% the reference to it may be slightly different. - - -% Some text follows to illustrate the usage of the commands in the -% \texttt{varioref}. -% This paragraph is repeated at several places in this document, its text -% source is exactly the same but the output depends on the relative position of the referenced -% pages. Some silly page references follow. The introduction begins -% \vpageref{sec:intro}, -% the enumeration \vpageref{enum:1} illustrates the default enumeration labels when -% Bulgarian is active while the enumeration \vpageref{enum:2} -% shows an alternative. -% The table \vpageref{table:No} shows several ways to typeset \No. -% The especially dull introduction starts \vpageref{sec:intro} -% and if this sentence is on the same page as the beginning of this paragraph the wording of -% the reference to it may be slightly different. -% -% Some text follows to illustrate the usage of the commands in the -% \texttt{varioref}. -% This paragraph is repeated at several places in this document, its text -% source is exactly the same but the output depends on the relative position of the referenced -% pages. Some silly page references follow. The introduction begins -% \vpageref{sec:intro}, -% the enumeration \vpageref{enum:1} illustrates the default enumeration labels when -% Bulgarian is active while the enumeration \vpageref{enum:2} -% shows an alternative. -% The table \vpageref{table:No} shows several ways to typeset \No. -% The especially dull introduction starts \vpageref{sec:intro} -% and if this sentence is on the same page as the beginning of this paragraph the wording of -% the reference to it may be slightly different. - -\section{Reporting bugs and requesting features} \label{sec:bugs} - -Please email me bug reports and requests for features, visit my web page at the -University of Manchester for further information. - -I am using Emacs for typesetting documents. Emacs~22 has good support for essentially all -writing systems in the world. AucTeX is an amazing Emacs package which makes an excellent -environment for writing LaTeX (and other ``dialects'' of TeX) documents). -Another Emacs package, ESS (Emacs speaks statistics), integrates Emacs smoothly with some of -the major statistical systems. - -If you are using Emacs but have not considered AucTeX yet, do it! -If you do computations with systems such as R, S-plus or SAS, consider ESS. - -If you are not an Emacs user you may consider becoming one. Together with the above tools it -may become your basic working environment. Be prepared though for a period of familiarisation -with the idiosyncracies of Emacs, it will help if you have a friend with some experience with -it. - - - - -\end{document} - - - - - -% \edef\myNo{\textnumero} - -% \expandafter\meaning\csname T2A\endcsname - -% \expandafter\meaning\csname T2A-cmd\endcsname - -% \meaning\myNo - -% \myNo: \csname \myNo \endcsname - -%\selectlanguage{bulgarian} -% \labelenumii -% \theenumii - -% \meaning\textnumero - -% \meaning\No - -% \csname TeX \endcsname - - -% \Romannumeral 7 - -% \expandafter a\csname Romannumeral \endcsname 7 - -% \csname №\endcsname - -% \def\proba#1{\char#1} - -% \proba 88, \proba{88} - -% a: \expandafter\string\csname\proba157 \endcsname - -% char65:\ \ \expandafter\string\csname \char65 \endcsname - -% char157: \expandafter\string\csname \char157 \endcsname - -% char cyra: \expandafter\string\expandafter\csname \cyra \endcsname - -% \def\aaaa{aaaa} - -% aaaa: \expandafter\string\csname \aaaa \endcsname - -% \meaning\cyrzh - -\makeatletter - -\meaning\roman - -\meaning\alph - -\meaning\verbatim@font - -\meaning\normalfont - -\makeatother - -\meaning\bulgarianhyphenmins - -\meaning\englishhyphenmins - -cyr. enc: \cyrillicencoding - -\meaning\inputencoding - -\meaning\frac - -\expandafter\string\csname \the\CYRYA \endcsname - -\begin{verbatim} - -This is verbatim text. It contains both latin and cyrillic letters. -АБВГД ЕЖЗИЙ КЛМНОП РСТУФХЦ ЧШЩЪЫ ЬЭЮЯ - -\end{verbatim} - - |