summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2008-04-09 18:18:02 +0000
committerKarl Berry <karl@freefriends.org>2008-04-09 18:18:02 +0000
commit0b904a95f3f8050fe64fda5a4762fee1871e6e62 (patch)
treec237c76f5a54685144ca9d1843dd6df6ef66e083 /Master/texmf-dist/doc
parentd6b24ec6d2d2f96af3eb2b1a575df6b1168ce9c1 (diff)
caption 3.1h (7apr08)
git-svn-id: svn://tug.org/texlive/trunk@7360 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/latex/caption/README2
-rw-r--r--Master/texmf-dist/doc/latex/caption/caption-rus.pdfbin429149 -> 675898 bytes
-rw-r--r--Master/texmf-dist/doc/latex/caption/caption-rus.tex8586
3 files changed, 6141 insertions, 2447 deletions
diff --git a/Master/texmf-dist/doc/latex/caption/README b/Master/texmf-dist/doc/latex/caption/README
index 96aceb06fad..25b8750151b 100644
--- a/Master/texmf-dist/doc/latex/caption/README
+++ b/Master/texmf-dist/doc/latex/caption/README
@@ -24,7 +24,7 @@ Furthermore the `floatrow', the `subcaption', and the `subfig' package
supports the `caption' package and uses its \captionsetup interface.
User Manual: caption-eng.pdf (English)
- caption-rus.pdf (Russian, outdated)
+ caption-rus.pdf (Russian)
caption-deu.pdf (German)
--------------------------------------------------------------------------
diff --git a/Master/texmf-dist/doc/latex/caption/caption-rus.pdf b/Master/texmf-dist/doc/latex/caption/caption-rus.pdf
index 80802bf0584..7f48b7ebab8 100644
--- a/Master/texmf-dist/doc/latex/caption/caption-rus.pdf
+++ b/Master/texmf-dist/doc/latex/caption/caption-rus.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/caption/caption-rus.tex b/Master/texmf-dist/doc/latex/caption/caption-rus.tex
index 8a47c6521c8..2cd238509b2 100644
--- a/Master/texmf-dist/doc/latex/caption/caption-rus.tex
+++ b/Master/texmf-dist/doc/latex/caption/caption-rus.tex
@@ -1,10 +1,8 @@
-% \iffalse meta-comment
%
% This is file `caption-rus.tex'.
-% Russian translation of documented part of `caption.dtx'
+% Russian translation of `caption-eng.tex'
%
% Copyright (C) 1994-2007 Axel Sommerfeldt (caption@sommerfee.de)
-% and Olga Lapko (Lapko.O@g23.relcom.ru)
%
% --------------------------------------------------------------------------
%
@@ -25,2530 +23,6226 @@
% caption2.sty, caption3.sty, ltcaption.sty, and subcaption.sty, and the
% user manuals caption-deu.tex, caption-eng.tex, and caption-rus.tex.
%
-% \fi
-% \CheckSum{0}
-%
-% \iffalse
-%<*driver>
-\documentclass[russian]{ltxdoc}
+\NeedsTeXFormat{LaTeX2e}[1994/12/01]
+\ProvidesFile{caption-rus.tex}[2008/04/06 v3.1h The caption package in Russian]
+\hbadness=9999 \newcount\hbadness \hfuzz=20pt % Make TeX shut up.
+%\errorcontextlines=3
+\documentclass[USenglish,russian,a4paper]{ltxdoc}
+\usepackage{fixltx2e}
\usepackage{mathtext}
\usepackage[T2A]{fontenc}
\usepackage[cp1251]{inputenc}
\usepackage{babel}
-\usepackage{listpen}
+\usepackage{listpen,afterpage}
+
\setlength\parindent{0pt}
\setlength\parskip{\smallskipamount}
-%
-\newcommand\NEWfeature{\NEW{Новая возможность}}
-\newcommand\NEWdescription{\NEW{Новое описание}}
-%
-\font\manual=manfnt
-\newcommand\DANGER{\hskip 1sp \marginpar{\raggedleft\textcolor{blue}{{\manual\char127}}}}
-%
-\ifx\pdfoutput\undefined\else
- \ifcase\pdfoutput\else
-% \usepackage{mathptmx,courier}
-% \usepackage[scaled=0.90]{helvet}
-% \def\rmdefault{ftm}
-% \def\sfdefault{ftx}
-% \def\ttdefault{cmtt}
- \addtolength\marginparwidth{15pt}
+\setlength\leftmargini{1.5em}% default = 2.5em
+\makeatletter
+\g@addto@macro\MacroFont{\normalcolor}
+\@flushglue = 1em plus 1fil
+\parfillskip = 1em plus 1fil
+\makeatother
+
+\newcommand\LineBreak{\linebreak[3]}
+\newcommand\PageBreak{\pagebreak[3]}
+\usepackage{ifpdf}
+\ifpdf
+ \usepackage{mathptmx}
+ \addtolength\marginparwidth{15pt}
+ \IfFileExists{literat.sty}{\usepackage{literat}}{}
+% \IfFileExists{t2aftx.fd}{\def\sfdefault{ftx}}{}
+% \IfFileExists{t2apxtt.fd}{\def\ttdefault{pxtt}}{}
+ \ifdim\paperheight=297mm % a4paper
+ \advance\textheight.5in
+ \advance\topmargin-.35in
+ \emergencystretch1em
+ \tolerance7000
+ \renewcommand\LineBreak{\\}
+ \renewcommand\PageBreak{\clearpage}
\fi
\fi
-%
-%\usepackage[french,USenglish]{babel}
-\usepackage{color,setspace}
-%
-%\usepackage{float}
-\usepackage{longtable}
-%\usepackage[raggedright]{sidecap}
-%
-\usepackage{caption}[2005/08/24]
-\DeclareCaptionLabelSeparator{endash}{\space\textendash\space}
-\usepackage[unicode]{hyperref}
-%
-\DeclareCaptionFont{singlespacing}{\setstretch{1}}
-\DeclareCaptionFont{onehalfspacing}{\onehalfspacing}
-\DeclareCaptionFont{doublespacing}{\doublespacing}
-\DeclareCaptionFont{red}{\color{red}}
-\DeclareCaptionFont{green}{\color{green}}
-\DeclareCaptionFont{blue}{\color{blue}}
-%
-\DeclareCaptionLabelSeparator{period-newline}{. \\}
-\DeclareCaptionStyle{period-newline}[labelsep=period]{labelsep=period-newline}
-\DeclareCaptionStyle{period-newline2}[labelsep=period,justification=centering]{labelsep=period-newline}
-\DeclareCaptionStyle{period-newline3}[labelsep=period]{labelsep=period-newline,justification=centering}
+
+\usepackage[bottom]{footmisc}
+\usepackage{graphicx,longtable,setspace}
+\IfFileExists{test/tlc2/cat.eps}{\graphicspath{{test/tlc2/}}}{}%
+
+\usepackage{hypdoc}
+\hypersetup{unicode}
+\ifpdf\usepackage{hypdestopt}\fi
+\hypersetup{pdfkeywords={LaTeX, package, caption},pdfstartpage={},pdfstartview={}}
+\hypersetup{breaklinks=true}
+
+\usepackage[listof=0,hypcap=false]{caption}[2008/04/01]
+
+\def\itemautorefname {\cyr\cyrp.}%
+\def\figureautorefname {\cyr\cyrr\cyri\cyrs.}%
+\def\tableautorefname {\cyr\cyrt\cyra\cyrb\cyrl.}%
+\def\partautorefname {\cyr\cyrch.}%
+\def\appendixautorefname {\cyr\cyrp\cyrr\cyri\cyrl.}%
+\def\chapterautorefname {\cyr\cyrg\cyrl.}%
+\def\sectionautorefname {\cyr\cyrr\cyra\cyrz\cyrd.}%
+\def\subsectionautorefname {\cyr\cyrr\cyra\cyrz\cyrd.}%
+\def\subsubsectionautorefname {\cyr\cyrr\cyra\cyrz\cyrd.}%
+\def\paragraphautorefname {\cyr\cyrp.}%
+\def\subparagraphautorefname {\cyr\cyrp.}%
+\def\pageautorefname {\cyr\cyrs.}%
+
+\DeclareRobustCommand*\eTeX{\texorpdfstring
+ {\leavevmode\hbox{$\varepsilon$}-\TeX}%
+ {e-TeX}}
+\DeclareRobustCommand*\AmS{\texorpdfstring
+ {{\protect\usefont{OMS}{cmsy}{m}{n}A\kern-.1667em\lower.5ex\hbox{M}\kern-.125emS}}%
+ {AMS}}
+\DeclareRobustCommand*\KOMAScript{\texorpdfstring
+ {\textsf{K\kern.05em O\kern.05em M\kern.05em A\kern.1em-\kern.1em Script}}%
+ {KOMA-Script}}
+\DeclareRobustCommand*\NTG{NTG}
+\DeclareRobustCommand*\SmF{SMF}
+
+\usepackage{marvosym}
+\makeatletter
+\newcommand*\INFO{\@ifstar{\@INFO{}}{\@INFO{\vbox to \ht\strutbox}}}
+\newcommand*\@INFO[1]{\MARGINSYM{#1{\hspace*{-1em}\LARGE\Info\hspace*{1em}}}}
+\makeatother
+
+\newcommand*\MARGINSYM[1]{\hskip 1sp \marginpar{\raggedleft\textcolor{blue}{{#1}}}}
+\newcommand*\NEW[2]{}%\hskip 1sp \marginpar{\footnotesize\sffamily\raggedleft#1\\#2}}
+
+% \ContinuedFloat
+\DeclareCaptionLabelFormat{continued1e}{Continued #1~#2}
+\DeclareCaptionLabelFormat{continued1r}{#1~#2 (\textit{продолжение})}
+\DeclareCaptionLabelFormat{continued2}{#1~#2\asbuk{ContinuedFloat}}
+% \DeclareCaptionLabelFormat
+\DeclareCaptionLabelFormat{bf-parens}{(\textbf{#2})}
+% \DeclareCaptionStyle
+\DeclareCaptionStyle{mystyle}[margin=5mm,justification=centering]%
+ {font=footnotesize,labelfont=sc,margin={10mm,0mm}}
+% Example 1
+\DeclareCaptionFormat{myformat1}{#1#2\\#3}
+\newlength\myindention
+\DeclareCaptionFormat{myformat2}{#1#2\\\hspace*\myindention#3}
+\DeclareCaptionOption{myindention}{\setlength\myindention{#1}}
+% Example 2
\DeclareCaptionFormat{reverse}{#3#2#1}
-\DeclareCaptionFormat{llap}{\llap{#1#2}#3\par}
-\DeclareCaptionLabelFormat{fullparens}{(\bothIfFirst{#1}{ }#2)}
+\DeclareCaptionLabelFormat{fullparens}{(\bothIfFirst{#1}{~}#2)}
\DeclareCaptionLabelSeparator{fill}{\hfill}
-%
-\DeclareRobustCommand{\KOMAScript}{\textsf{K\kern.05em O\kern.05em%
- M\kern.05em A\kern.1em-\kern.1em Script}}
-\clubpenalty10000
+% Example 3
+\DeclareCaptionFormat{llap}{\llap{#1#2}#3\par}
+\DeclareCaptionFormat{llapx}{\llap{\makebox[5em][l]{#1}}#3\par}
+% Example 4
+\DeclareCaptionLabelFormat{andtable}{#1~#2 \& \tablename~\thetable}
-\let\oriquote\quote
-\def\quote{\allowprelistbreaks[-4]\oriquote}
+\newcommand*\purerm[1]{{\upshape\mdseries\rmfamily #1}}
+\newcommand*\puresf[1]{{\upshape\mdseries\sffamily #1}}
+\newcommand*\purett[1]{{\upshape\mdseries\ttfamily #1}}
+\let\class\puresf \let\package\puresf
+
+\newcommand*\csmarg[1]{\texttt{\char`\{#1\char`\}}}
+\newcommand*\csoarg[1]{\texttt{\char`\[#1\char`\]}}
+\newcommand*\version[2][]{$v#2$}
+\newcommand*\x{\discretionary{}{}{}}
+
+\newenvironment{Annotation}%
+ {\ifvmode\else\unskip\par\fi\pagebreak[2]%
+ \smallskip
+ \small(\ignorespaces}{\unskip)\par}
+\newenvironment{Annotation*}%
+ {\ifvmode\else\unskip\par\fi\pagebreak[2]%
+ \small(\ignorespaces}{\unskip)\par}
+
+\newenvironment{Example}%
+ {\ifvmode\else\unskip\par\fi\pagebreak[2]%
+ \minipage{\linewidth}\smallskip}%
+ {\smallskip\endminipage\par}
\makeatletter
-\let\NoBreak\@nobreaktrue
-\newcommand\NEW[2]{\hskip 1sp\@nobreaktrue
- \marginpar
- {\footnotesize\sffamily\raggedleft#1\\#2}}
+\newcommand\example{\@ifstar
+ {\@example{belowskip=\abovecaptionskip}}%
+ {\@example{}}}
+\def\@example#1{%
+ \@testopt{\@@example{#1}}{figure}}
+\long\def\@@example#1[#2]#3#4{%
+ \begingroup
+ \captionsetup{#1,size=small,margin={\leftmargini,10pt},#3}%
+ \captionof{#2}[]{#4}%
+ \endgroup}
\makeatother
-\setcounter{IndexColumns}2
-\def\IndexParms{\raggedright\advance\rightskip1em}
-%
-%<+driver>\OnlyDescription
-%
+
+\newenvironment{Expert}%
+ {\ifvmode\else\unskip\par\fi\pagebreak[3]%
+ \smallskip
+ \footnotesize\ignorespaces}{\par}
+\newenvironment{Expert*}%
+ {\ifvmode\else\unskip\par\fi\pagebreak[3]%
+ \footnotesize\ignorespaces}{\par}
+
+\newenvironment{Note}[1][\DefaultNoteText]%
+ {\ifvmode\else\unskip\par\fi
+ \smallskip
+ \small\emph{#1}:~\ignorespaces}{\par}
+\newenvironment{Note*}[1][\DefaultNoteText]%
+ {\ifvmode\else\unskip\par\fi
+ \small\emph{#1}:~\ignorespaces}{\par}
+
+\newenvironment{Options}[1]%
+ {\list{}{\renewcommand\makelabel[1]{\texttt{##1}\hfil}%
+ \settowidth\labelwidth{\texttt{#1\space}}%
+ \setlength\leftmargin{10pt}%
+ \addtolength\leftmargin{\labelwidth}%
+ \addtolength\leftmargin{\labelsep}}}%
+ {\endlist}
+
+\makeatletter
+\newcommand*\Ref{\@ifstar{\@Ref\ref}{\@Ref\autoref}}
+\newcommand*\@Ref[2]{#1{#2}: \textit{\nameref{#2}}}
+\newcommand*\SEE[3][]{\nopagebreak{#1(#2 #3)}}
+\newcommand*\SeeUserDefined[1][]{\See{\Ref{declare}#1}}
+\makeatother
+
\begin{document}
- \DocInput{caption-rus.tex}
-\end{document}
-%</driver>
-% \fi
-%
-%
-%
-% \iffalse
+\let\subsectionautorefname\sectionautorefname
+\let\subsubsectionautorefname\sectionautorefname
+
+\def\thispackage{пакет \package{caption}}
+\def\Thispackage{Пакет \package{caption}}
+
+\newcommand*\DefaultNoteText{Замечание}
+% \newcommand\NEWfeature{\NEW{New feature}}
+% \newcommand\NEWdescription{\NEW{New description}}
+\newcommand\NEWfeature{\NEW{Новая возможность}}
+\newcommand\NEWdescription{\NEW{Новое описание}}
+\makeatletter
+\newcommand*\See{\@ifstar{\SEE{См.}}{\SEE[\small]{См.}}}
+\newcommand*\see{\@ifstar{\SEE{см.}}{\SEE[\small]{см.}}}
+
% --------------------------------------------------------------------------- %
-% \fi
-% \newcommand*\purerm[1]{{\upshape\mdseries\rmfamily #1}}
-% \newcommand*\puresf[1]{{\upshape\mdseries\sffamily #1}}
-% \newcommand*\purett[1]{{\upshape\mdseries\ttfamily #1}}
-% \let\package\puresf\def\thispackage{\package{caption}}
-% \let\env\purett \let\opt\purett
-%
-% \newcommand*\version[2][]{$v#2$}
-%
-% \newenvironment{Options}[1]%
-% {\list{}{\renewcommand{\makelabel}[1]{\texttt{##1}\hfil}%
-% \settowidth{\labelwidth}{\texttt{#1\space}}%
-% \setlength{\leftmargin}{\labelwidth}%
-% \addtolength{\leftmargin}{\labelsep}}}%
-% {\endlist}
-%
-% \newenvironment{Example}%
-% {\ifvmode\else\unskip\par\fi
-% \minipage{\linewidth}\smallskip}%
-% {\smallskip\endminipage}
-% \newcommand\example[3][figure]{%
-% \begingroup
-% \captionsetup{#2}%
-% \captionof{#1}[]{#3}%
-% \endgroup}
-%
-% \GetFileInfo{caption.sty}
-% \title{Печать подписей плавающих объектов (флотов) с~помощью пакета
-% \thispackage\thanks{Данный пакет версии
-% \fileversion, последний раз модифицирован \filedate.
-%^^A% Translated by O. Lapko 2007/05/24. The questions and notes
-%^^A% about translation please
+
+\GetFileInfo{caption-rus.tex}
+\let\docdate\filedate
+\GetFileInfo{caption.sty}
+
+% \title{Customizing captions of floating environments
+% using the caption package\texorpdfstring{\thanks{%
+% This package has version number \fileversion,
+% last revised \filedate.
+\title{Настройка подписей плавающих объектов (флотов) с~помощью пакета
+ \package{caption}\thanks{Данный пакет версии
+ \fileversion, последний раз модифицирован \filedate.
+%^^A% Translattion of the version v3.1h, dated 2008/04/03.
+%^^A% The questions and notes about translation please
%^^A% send to \texttt{Lapko.O@g23.relcom.ru} (Olga Lapko).
%^^A% The version of translation could be obsolete. Please
%^^A% look English or German documentation for the new information
%^^A% (see margin labels).}}
-% Перевод О.\,Лапко, 2007/05/24. Вопросы и~замечания по переводу
-% направляйте по адресу \texttt{Lapko.O@g23.relcom.ru}.
-% \emph{Версия перевода относится к~одной из предыдущих версий пакета и~может
-% содержать устаревшие данные.
-% Обращайтесь к~английской или немецкой документации за более свежей информацией
-% (см.~пометки на полях)}.}}
-% \author{Аксель Зоммерфельдт (Axel Sommerfeldt)\\
-% \href{mailto:caption@sommerfee.de}{\texttt{caption@sommerfee.de}}}
-% \date{2007/04/09}
-% \maketitle
-%
-%^^A \begin{abstract}
-%^^A The \thispackage\ package offers customization of captions
-%^^A in floating environments such |figure| and |table| and cooperates with
-%^^A many other packages.\footnote{A complete re-work of the user interface
-%^^A done with Steven D. Cochran and Frank Mittelbach has lead to
-%^^A this new enhanced version 3.0.}
-%^^A \end{abstract}
-% \begin{abstract}
-% Пакет \thispackage\ предлагает множество путей настройки печати
-% подписей для плавающих объектов (флотов)
-% |figure| и~|table| и~совместим (кооперируется)
-% со~многими пакетами.\footnote{Полная переработка пользовательского
-% интерфейса сделана совместно со~Стивеном Кокрейном (Steven~D.~Cochran)
-% и~Франком Миттельбахом (Frank Mittelbach)
-% и~создана для новой расширенной версии~3.0.}
-% \end{abstract}
-%
-% \begingroup\small
+ Перевод документации v3.1h, датированной 2008/04/03.
+ Вопросы и~замечания по переводу направляйте по адресу \texttt{Lapko.O@g23.relcom.ru}.
+ \emph{Версия перевода может относиться к~одной из предыдущих версий пакета и~может
+ содержать устаревшие данные.
+ Обращайтесь к~английской или немецкой документации за более свежей информацией
+ (обращайте внимание на пометки на полях).
+ }}{}}
+% \author{Axel Sommerfeldt\\
+\author{Аксель Зоммерфельдт (Axel Sommerfeldt)\\
+ \href{mailto:caption@sommerfee.de}{\texttt{caption@sommerfee.de}}}
+\date{\docdate}
+\maketitle
+
+% --------------------------------------------------------------------------- %
+
+\begin{abstract}
+% \Thispackage\ offers customization of captions
+% in floating environments such |figure| and |table| and cooperates with
+% many other packages.
+% \par\smallskip
+ \Thispackage\ предлагает настройки печати
+ подписей для плавающих объектов (флотов)
+ |figure| и~|table| и~совместим (кооперируется)
+ со~многими пакетами.
+% \textit{Please note:} Many document classes already have build-in options and
+% commands for customizing captions.
+% If these possibilities are sufficient for you, there is usually no need for
+% you to use the \package{caption} package at all.
+% And if you are just interested in using the command \cs{captionof}, loading of
+% the very small \package{capt-of} package is usually sufficient.
+\par\smallskip
+\textit{Обратите внимание}: множество классов документов уже имеют встроенные опции
+и~команды для настройки подписей.
+Если эти настройки вас удовлетворяют, то вовсе нет необходимости в~использовании пакета
+\package{caption}.
+Если вам нужна только команда \cs{captionof} \cdash--- загрузка небольшого пакета
+\package{capt-of} будет достаточна.
+\end{abstract}
+
+\newcommand\exampletext{%
+% White sand beaches. The pink smoothness of the conch shell. A sea abundant
+% with possibilities. Duty-free shops filled with Europe's finest gifts and
+% perfumes. Play your favorite game of golf amidst the tropical greens on one
+% of the many championship courses.}
+ Тибетская мандала представляет собой своеобразную карту особого храма
+ и~Шамбалы. Видны ворота по четырём сторонам света, постройка идёт
+ уступами вверх. (Мозаика пола рыцарского храма на о.\,Родос воспроизводит
+ узор мандалы.)}
+
+% --------------------------------------------------------------------------- %
+
+% \section*{Introduction}
+\section*{Введение}
+
+% Within the standard \LaTeX\ document classes captions haven't received the
+% attention they deserve. Simply typeset as an ordinary paragraph there is no
+% remarkable visual difference from the rest of the text, like here:
+Внутри стандартных классов \LaTeX'а~подписи не получили заслуженного
+внимания. Они набираются как обычный абзац и~внешне не отличаются от основного
+текста, как здесь:
+
+\example*{size=normalsize,margin=0pt}{\exampletext}
+
+% There should be possibilities to change this; for example, it would be nice
+% to make the text of the caption a little bit smaller as the normal
+% text, add an extra margin, typeset the caption label with the same font
+% family and shape as your headings etc. Just like this one:
+Должна быть возможность изменить это; например, текст лучше задать
+меньшим кеглем, добавить втяжку (с~обеих сторон),
+у~нумерационных заголовков подписей задать такие же
+начертание или насыщенность, как у~заголовков разделов. Например, как следующую подпись:
+
+\example*{size=small,margin=10pt,labelfont=bf,labelsep=endash}{\exampletext}
+
+% You can do this easily with this package as there are many ready-to-use
+% caption formatting options, but you are free to define your very own stuff, too.
+С~данным пакетом это сделать просто, поскольку в~нём уже есть множество готовых
+опций ключей настройки, и~вы свободны и~выбрать своё сочетание опций для
+оформления, и~создать свои опции.
+
+\bigskip
+
+\INFO\begin{minipage}[t]{\textwidth}
+\small
+% Please note that \thispackage\ is only controlling the look \& feel of the
+% captions. It does \emph{not} control the placement of the captions.
+% (But you could do so by using other packages like the \package{floatrow}
+% package\cite{floatrow}.)
+Обратите внимание, что \thispackage\ контролирует только оформление
+подписей. Он \emph{не} контролирует размещение подписей.
+(Но это возможно, если использовать дополнительно другие пакеты,
+например \package{floatrow}\cite{floatrow}.)
+\end{minipage}
+
+\begingroup\small
%^^A% \vspace{2ex}\centerline{\textbf{Frequently Appeared Design\footnote
%^^A% {Added in translated text.}}\nopagebreak}
-% \vspace{2ex}\centerline{\textbf{\TeX ническое редактирование\footnote
-% {Добавлено при переводе.}}\nopagebreak}
-% \begin{multicols}{2}\raggedright\advance\rightskip1em
-% \makeatletter\let\item\@idxitem\ignorespaces\makeatother
+\vspace{2ex}\centerline{\textbf{\TeX ническое редактирование\footnote
+ {Добавлено при переводе.}}\nopagebreak}
+\begin{multicols}{2}\raggedright\advance\rightskip1em
+ \makeatletter\let\item\@idxitem\ignorespaces\makeatother
%^^A% \item Last line of caption centered
-% \item Выключка последней строки по центру
-% \pageref{TeXr:centerlast}
+\item Выключка последней строки по центру
+ \pageref{TeXr:centerlast}
%^^A% \item Hanged caption label
-% \item Нумерационный заголовок на весу
-% \pageref{TeXr:hang:label}
+\item Нумерационный заголовок на весу
+ \pageref{TeXr:hang:label}
%
-% %^^A \indexspace
+%^^A \indexspace
%
%^^A% \item Spaces above and below captions
-% \item Отбивки у~подписей над и~под флотами
-% \pageref{TeXr:captionskips:a}%^^A--\pageref{TeXr:captionskips:z}
+\item Отбивки у~подписей над и~под флотами
+ \pageref{TeXr:captionskips:a}%^^A--\pageref{TeXr:captionskips:z}
%^^A% \item Settings, for caption label
-% \item Оформление
+\item Оформление
%^^A% \subitem for caption label
-% \subitem нумерационных заголовков
-% \pageref{TeXr:caplabel:a}%^^A--\pageref{TeXr:caplabel:z}
+\subitem нумерационных заголовков
+ \pageref{TeXr:caplabel:a}%^^A--\pageref{TeXr:caplabel:z}
%^^A% \subitem for one-line captions
-% \subitem однострочных подписей
-% \pageref{TeXr:singleline:a}%^^A--\pageref{TeXr:singleline:z}
+\subitem однострочных подписей
+ \pageref{TeXr:singleline:a}%^^A--\pageref{TeXr:singleline:z}
%^^A% \subitem for multi-paragraph captions
-% \subitem подписей из нескольких абзацев
-% \pageref{TeXr:multipar:a}%^^A--\pageref{TeXr:multipar:z}
+\subitem подписей из нескольких абзацев
+ \pageref{TeXr:multipar:a}%^^A--\pageref{TeXr:multipar:z}
%
-% %^^A \indexspace
+%^^A \indexspace
%
%^^A% \item Captions
-% \item Подписи\nopagebreak
+\item Подписи\nopagebreak
%^^A% \subitem for continued floats
-% \subitem к~флотам с~продолжением
-% \pageref{TeXr:continued:a}\nopagebreak %^^A--\pageref{TeXr:continued:z}
+\subitem к~флотам с~продолжением
+ \pageref{TeXr:continued:a}\nopagebreak %^^A--\pageref{TeXr:continued:z}
%^^A% \subitem above tables
-% \subitem над таблицами
-% \pageref{TeXr:captop:a}%^^A--\pageref{TeXr:captop:z}
+\subitem над таблицами
+ \pageref{TeXr:captop:a}%^^A--\pageref{TeXr:captop:z}
%^^A% \subitem skipped entry in list
-% \subitem без записи в~списке рисунков,
+\subitem без записи в~списке рисунков,
%^^A% \subsubitem trick with empty option
-% \subsubitem трюк с~дополнительным аргументом команды
-% |\caption| \pageref{TeXr:nolistentry:I}
+ \subsubitem трюк с~дополнительным аргументом команды
+ |\caption| \pageref{TeXr:nolistentry:I}
%^^A% \subsubitem key |listof=|
-% \subsubitem ключ пакета |listof=|
-% \pageref{TeXr:nolistentry:II}
+ \subsubitem ключ пакета |list=|
+ \pageref{TeXr:nolistentry:II}
%^^A% \subitem unlabeled
-% \subitem без нумерационного заголовка
-% \pageref{TeXr:starcaption:a}%^^A--\pageref{TeXr:starcaption:z}
+\subitem без нумерационного заголовка
+ \pageref{TeXr:starcaption:a}%^^A--\pageref{TeXr:starcaption:z}
%^^A% \subitem outside float
-% \subitem вне окружения флота
-% \pageref{TeXr:captiononof:a}%^^A--\pageref{TeXr:captiononof:z}
+\subitem вне окружения флота
+ \pageref{TeXr:captionof:a}%^^A--\pageref{TeXr:captiononof:z}
%
-% \end{multicols}%
-% \endgroup
-% \newpage
+\end{multicols}%
+\endgroup
+\clearpage
%
-% \tableofcontents
-%^^A \newcommand\figuretext{^^A
-%^^A White sand beaches. The pink smoothness of the conch shell. A sea abundant
-%^^A with possibilities. Duty-free shops filled with Europe's finest gifts and
-%^^A perfumes. Play your favorite game of golf amidst the tropical greens on one
-%^^A of the many championship courses.}
-%^^A^^A Here is not translation!
-% \newcommand\figuretext{^^A
-% Тибетская мандала (1800\,г.) представляет собой своеобразную карту как
-% особого храма, так и Шамбалы~(?). Хорошо видны ворота по четырём сторонам
-% света, сама постройка идёт уступами вверх. (Мозаика пола рыцарского храма
-% на о.~Родос точным образом воспроизводит узор тибетской мандалы.)}
-%
-% \iffalse
% --------------------------------------------------------------------------- %
-% \fi
-%
-%^^A \section{Introduction}
-% \section{Введение}
-%
-%^^A Within the standard \LaTeX\ classes captions haven't received the attention
-%^^A they deserve. Simply typeset as an ordinary paragraph there is no
-%^^A remarkable visual difference from the rest of the text, like here:
-% Внутри стандартных классов \LaTeX'а~подписи не получили заслуженного
-% внимания. Они набираются как обычный абзац без всяких отличий от основного
-% текста, как здесь:
-%
-% \example{belowskip=\abovecaptionskip}{\figuretext}
-%
-%^^A There should be possibilities to change this; for example, it would be nice
-%^^A if you could make the text of the caption a little bit smaller as the normal
-%^^A text, add an extra margin, typeset the caption label with the same font
-%^^A family and shape as your headings etc. Just like this one:
-% Должна быть возможность изменить это; например будет лучше, если текст
-% задать меньшим кеглем, добавить втяжку (с~обеих сторон), набрать
-% нумерационный заголовок подписи шрифтом основного текста, но задать
-% начертание или насыщенность как у~заголовков и~т.\,д. Например, как следующую подпись:
-%
-% \example{belowskip=\abovecaptionskip,size=small,margin=10pt,labelfont=bf,labelsep=endash}{\figuretext}
-%
-%^^A You can do this easily with this package as there are many ready-to-use
-%^^A caption formatting options, but you are free to define your very own stuff, too.
-% С~данным пакетом это просто сделать, поскольку в~нём уже есть множество готовых
-% опций ключей настройки, и~вы свободны и~выбрать своё сочетание опций для
-% оформления, и~создать свои опции.
-%
-% \iffalse
+
+\clearpage
+\tableofcontents
+
% --------------------------------------------------------------------------- %
-% \fi
-%
-%
-%^^A \section{Using the package}
-% \section{Использование пакета}
-% \label{usage}
-%
-% \DescribeMacro{\usepackage}
-%^^A Insert
-% Добавьте
-% \begin{quote}
-% |\usepackage|\oarg{options}|{caption}[|\texttt{\filedate}|]|
-% \end{quote}
-%^^A into the preamble of your document, i.e.~the part of your document
-%^^A between |\documentclass| and |\begin{document}|.
-%^^A The options control how your captions will look like; e.g.,
-% в~преамбулу вашего документа, т.\,е. в~часть файла между командами
-% |\documentclass| и~|\begin{document}|.
-% Опции задают настройки оформления подписей в~книге; например, опции
-% \begin{quote}
-% |\usepackage[margin=10pt,font=small,labelfont=bf]{caption}|
-% \end{quote}
-%^^A would result in captions looking like the second one in the introduction.
-% зададут подписи, похожие на второй пример во введении.
-%
-% \DescribeMacro{\captionsetup}
-%^^A For a later change of options the \thispackage\ package provides the command
-% Для последующих изменений пакет \thispackage\ предлагает команду
-% \begin{quote}
-% |\captionsetup|\oarg{float type}\marg{options}
-% \end{quote}
-%^^A So
-% Следовательно, определения
-% \begin{quote}
-% |\usepackage[margin=10pt,font=small,labelfont=bf]{caption}|
-% \end{quote}
-%^^A and
-% и
-% \begin{quote}
-% |\usepackage{caption}|\\
-% |\captionsetup{margin=10pt,font=small,labelfont=bf}|
-% \end{quote}
-%^^A are equal in their results.
-% эквивалентны.
-%
-%^^A It's good to know that |\captionsetup| has an effect on the current
-%^^A environment only. So if you want to change some settings for the
-%^^A current |figure| or |table| only, just place the |\captionsetup| command
-%^^A inside the |figure| or |table| right before the |\caption| command.
-%^^A For example
-% Нужно обратить внимание, что установки |\captionsetup| могут действовать и~на одно
-% окружение. Так что, если вы хотите изменить установки только
-% текущего окружения |figure| или |table|, поместите команду |\captionsetup|
-% внутри |figure| или |table| прямо перед командой |\caption|.
-% Например
-% \begin{quote}
-% |\begin{figure}|\\
-% | |\ldots\\
-% | \captionsetup{singlelinecheck=off}|\\
-% | \caption{|\ldots|}|\\
-% |\end{figure}|
-% \end{quote}
-%^^A switches the single-line-check off, but only for this |figure| so all
-%^^A the other captions remain untouched.
-% отключает контроль однострочной подписи (см.~об этом ниже), но только для данного
-% окружения |figure|, другие подписи не изменятся.
-%
-%^^A (For a description of the optional parameter \meta{float type} see
-%^^A section \ref{misc}: \textit{``Useful stuff''}.)
-% (Для описания дополнительного параметра \meta{float type}
-% см.~разд.~\ref{misc}: \textit{«Полезные утилиты»}.)
-%
-% \iffalse
+
+\clearpage
+% \section{Using this package}
+\section{Использование пакета}
+\label{usage}
+
+\DescribeMacro{\usepackage}
+% Insert
+Добавьте
+\begin{quote}
+ |\usepackage|\oarg{options}|{caption}[|\texttt{\filedate}|]|
+\end{quote}
+% into the preamble of your document, i.e.~the part of your document
+% between |\document|\-|class| and |\begin{doc|\-|u|\-|ment}|.
+% The options control how your captions will look like; e.g.,
+в~преамбулу вашего документа, т.\,е. в~часть файла между командами
+|\document|\-|class| и~|\begin{document}|.
+Опции задают настройки оформления подписей в~книге; например, опции
+\begin{quote}
+ |\usepackage[margin=10pt,font=small,labelfont=bf,|\\
+ | labelsep=endash]{caption}|%
+ %|[|\texttt{\filedate}|]|
+\end{quote}
+% would result in captions looking like the second one in the introduction.
+зададут подписи, похожие на второй пример во введении.
+
+\DescribeMacro{\captionsetup}
+% For a later change of options \thispackage\ provides the command
+Для последующих изменений \thispackage\ предлагает команду
+\begin{quote}
+ |\captionsetup|\oarg{float type}\marg{options}\quad.
+\end{quote}
+% So
+Следовательно, определения
+\begin{quote}
+ |\usepackage[margin=10pt,font=small,labelfont=bf]{caption}|
+\end{quote}
+% and
+\begin{quote}
+ |\usepackage{caption}|\\
+ |\captionsetup{margin=10pt,font=small,labelfont=bf}|
+\end{quote}
+% are equal in their results.
+эквивалентны.
+
+% It's good to know that |\caption|\-|setup| has an effect on the current
+% environment only. So if you want to change settings for the
+% current |figure| or |table| only, just place the |\caption|\-|setup| command
+% inside the |figure| or |table| right before the |\caption| command.
+% For example
+Нужно обратить внимание, что установки |\captionsetup| могут действовать и~на одно
+окружение. Так что, если вы хотите изменить установки только
+одного окружения |figure| или |table|, поместите команду |\captionsetup|
+внутри |figure| или |table| прямо перед командой |\caption|.
+Например
+\begin{quote}
+ |\begin{figure}|\\
+ | |\ldots\\
+ | \captionsetup{singlelinecheck=off}|\\
+ | \caption{|\ldots|}|\\
+ |\end{figure}|
+\end{quote}
+% switches the single-line-check off, but only for this |figure|,
+% so all the other captions remain untouched.
+отключает контроль однострочной подписи (см.~об этом ниже), но только для этого
+окружения |figure|, другие подписи не изменятся.
+
+\smallskip
+
+\begin{Annotation}
+% For a detailed description of |\caption|\-|setup| see \Ref{captionsetup}.
+Подробное описание команды |\captionsetup| см.~в~\Ref{captionsetup}.
+\end{Annotation}
+
% --------------------------------------------------------------------------- %
-% \fi
-%
-%
-%^^A \section{Options}
-% \section{Опции}
-%
-% \def\OptionLabel{RaggedRight}
-% \def\UserDefined{\ldots}
-% \makeatletter
-% \newcommand*\Section{\@ifstar{\@Section\relax}{\@Section{разд.}}}
-% \newcommand*\@Section[3]{#1 \ref{#2}: \textit{«#3»}}
-% \makeatother
-% \newcommand*\See[1]{{\small (См.~#1)}}
-% \newcommand*\SeeUserDefined[1][]{%
-% \See{\Section{declare}{Делаем сами}#1}}
-%
-% \iffalse
+
+\clearpage
+% \section{Options}
+\section{Опции}
+\label{options}
+
+\def\OptionLabel{RaggedRight}
+\def\UserDefined{\ldots}
+
% --------------------------------------------------------------------------- %
-% \fi
-%
-%^^A \subsection{Formatting}
-% \subsection{Оформление}
-%
-% \DescribeMacro{format=}
-%^^A A figure or table caption mainly consists of three parts: the caption label,
-%^^A which says if this object is a `Figure' or `Table' and what number is
-%^^A associated with it, the caption text itself, which is normally a short
-%^^A description of contents, and the caption separator which separates the text
-%^^A from the label.
-% Подпись рисунка или таблицы обычно имеет три части\nopagebreak: нумерационный
-% заголовок, который объявляет, что этот объект `Рис'унок или `Таблица' и~какой
-% номер он имеет, собственно текст подписи, который обычно даёт краткое описание
-% содержания, и~разделитель между нумерационной частью подписи и~текстом.
-%
-%^^A The \textit{caption format} determines how this information will be presented;
-%^^A it is specified with the option
-% \textit{Формат подписи} определяет, как данная информация будет представлена;
-% это определяется ключом
-% \begin{quote}
-% |format=|\meta{format name}\quad ,
-% \end{quote}
-%^^A having the name of the caption format as its argument.
-% с~опцией, определяющей оформление (формат) подписи.
-%
-%^^A There are two standard caption formats:
-% Далее два стандартных оформления подписи:
-% \iffalse
-%^^A \footnote{You have the option to
-%^^A define your own ones, too. See section \ref{declare}:
-%^^A \textit{``Do it yourself!''} for details.}
-% \footnote{Вы можете задавать опции
-% для создания своего оформления. См. подробнее в~разд.~\ref{declare}:
-% \textit{«Делаем сами!»}.}
-% \fi
-%
-% \begin{Options}{\OptionLabel}
-% \item[plain]\NEWdescription{v3.0h}
-%^^A Typesets the captions as a normal paragraph.
-%^^A (This is the default behaviour, it
-%^^A is adapted from the standard \LaTeX\ document classes.)
-% Печатает подписи как обычный абзац.
-% (Это оформление задано по умолчанию,
-% и~аналогично стандартному оформлению классов \LaTeX'а.)
-%
-% \item[hang]
-%^^A Indents the caption text, so it will `hang' under the first line of the text.
-% Делает втяжку так, что первая строка (нумерационный заголовок) выступает влево.%^^A
-% \label{TeXr:hang:label}
-%
-% \item[\UserDefined]
-%^^A Own formats can be defined using |\DeclareCaptionFormat|.
-% Собственное оформление может быть определено, с~помощью команды
-% |\DeclareCaptionFormat|. \SeeUserDefined
-% \end{Options}
-%
-% \begin{Example}
-%^^A An example: Specifying the option
-% Пример: задание опции
-% \begin{quote}
-% |format=hang|
-% \end{quote}
-%^^A yields captions like this:
-% создаёт подписи как эта:
-% \example{format=hang}{\figuretext}
-% \end{Example}
-%
-% \DescribeMacro{indention=}
-%^^A For both formats (\texttt{plain} and \texttt{hang}) you can setup an extra
-%^^A indention starting at the second line of the caption. You do this with the
-%^^A option
-% Для обоих оформлений (\texttt{plain} и~\texttt{hang}) можно установить
-% дополнительную втяжку второй строки подписи. Это можно сделать с~ключом
-% \begin{quote}
-% |indention=|\meta{amount}.
-% \end{quote}
+
+% \subsection{Formatting}
+\subsection{Оформление}
+\label{formats}
+
+\DescribeMacro{format=}
+% A figure or table caption mainly consists of three parts: the caption label,
+% which says if this object is a `Figure' or `Table' and what number is
+% associated with it, the caption text itself, which is normally a short
+% description of contents, and the caption separator which separates the text
+% from the label.
+Подпись рисунка или таблицы обычно имеет три части\nopagebreak: нумерационный
+заголовок, который объявляет, что этот объект называется `Рис'унок или `Таблица' и~имеет
+свой номер; собственно текст, который обычно даёт краткое описание
+содержания; разделитель между нумерационным заголовком и~текстом.
+
+% The \textit{caption format} determines how this information will be presented;
+% it is specified with the option
+\textit{Формат подписи} определяет, как данная информация будет представлена;
+это задаётся ключом
+\begin{quote}
+ |format=|\meta{format name}\quad
+\end{quote}
+% having the name of the caption format as its argument.
+с~опцией, определяющей оформление (формат) подписи.
+
+% There are two standard caption formats:
+Далее два стандартных оформления подписи:
+%\footnote{You have the option to
+%define your own ones, too. See section \ref{declare}:
+%\textit{``Do it yourself!''} for details.}
+
+\begin{Options}{\OptionLabel}
+ \item[plain]%\NEWdescription{v3.0h}
+% Typesets the captions as a normal paragraph.
+ Печатает подписи как обычный абзац.
+
+ \item[hang]
+% Indents the caption text, so it will `hang' under the first line of the text.
+ Делает втяжку так, что первая строка [нумерационный заголовок] выступает влево.%
+ \label{TeXr:hang:label}
+
+ \item[\UserDefined]
+% Own formats can be defined using |\Declare|\-|Caption|\-|Format|.\LineBreak
+% \SeeUserDefined
+ Собственное оформление может быть определено, с~помощью команды
+ |\Declare|\-|Caption|\-|Format|. \SeeUserDefined
+\end{Options}
+
+\begin{Example}
+% An example: Specifying the option
+ Пример: задание опции
+ \begin{quote}
+ |format=hang|
+ \end{quote}
+% yields captions like this:
+ создаёт подписи как эта:
+ \example{format=hang}{\exampletext}
+\end{Example}
+
+\pagebreak[3]
+\DescribeMacro{indention=}
+% For both formats (\texttt{plain} and \texttt{hang}) you can setup an extra
+% indention starting at the second line of the caption. You do this with the
+% option
+Для обоих оформлений (\texttt{plain} и~\texttt{hang}) можно установить
+дополнительную втяжку вторых строк подписи. Это можно сделать с~ключом
+\begin{quote}
+ |indention=|\meta{amount}\quad.
+\end{quote}
%^^A% [Please note, that indention of the keys \verb|format=hang| and
%^^A% |indention=|\meta{amount} are summarized.---\emph{Trans.}]
-% [Обратите внимание, что втяжка из ключей \verb|format=hang| и~|indention=|\meta{amount}
-% суммируются. \cdash--- \emph{Прим.\,перев.}]
-%
-%^^A Two examples:
-% Пара примеров:
-%
-% \begin{Example}
-% \begin{quote}
-% |format=plain,indention=.5cm|
-% \end{quote}
-% \captionsetup{aboveskip=0pt}
-% \example{format=plain,indention=.5cm}{\figuretext}
-% \end{Example}
-%
-% \begin{Example}
-% \begin{quote}
-% |format=hang,indention=-0.5cm|
-% \end{quote}
-% \captionsetup{aboveskip=0pt}
-% \example{format=hang,indention=-0.5cm}{\figuretext}
-% \end{Example}
-%
-%
-% \DescribeMacro{labelformat=}
-%^^A With the option
-% С~ключом\label{TeXr:caplabel:a}
-% \nopagebreak[3]
-% \begin{quote}
-% |labelformat=|\meta{label format name}
-% \end{quote}
-% \NEWdescription{v3.0e}
-%^^A you specify how the caption label will be typeset.
-%^^A There are four standard caption label formats:
-% вы задаёте, как печатается нумерационная часть.
-% Существуют четыре стандартных оформления нумерационного заголовка:
-%
-% \begin{Options}{\OptionLabel}
-% \item[default]
-%^^A the caption label will be typeset as specified by the document class,
-%^^A usually this means the name and the number (like \texttt{simple}).
-%^^A (this is the default behaviour.)
-% нумерационный заголовок печатается так же как в~стандартных классах,
-% это обычно название флота и~номер (как \texttt{simple}).
-% (Задаётся по умолчанию.)
-%
-% \item[empty]
-%^^A The caption label will be empty. (This option makes sense when used
-%^^A together with other options like \texttt{labelsep=none}.)
-% Нумерационный заголовок отсутствует. (Эта опция имеет смысл вместе
-% с~опциями типа \texttt{labelsep=none}.)
-%
-% \item[simple]
-%^^A The caption label will be typeset as a name and a number.
-% Нумерационный заголовок печатается как название флота и~его номер.
-%
-% \item[parens]
-%^^A The number of the caption label will be typeset in parentheses.
-% Номер в~нумерационной части заголовка печатается в~скобках.
-%
-% \item[\UserDefined]
-%^^A Own label formats can be defined using |\DeclareCaptionLabelFormat|.
-% Собственное оформление может быть определено с~помощью
-% команды |\DeclareCaptionLabelFormat|.
+[Обратите внимание, что втяжка из ключей \verb|format=hang| и~|indention=|\meta{amount}
+суммируются. \cdash--- \emph{Прим.\,перев.}]
+
+% Two examples:
+Пара примеров:
+
+\begin{Example}
+ \begin{quote}
+ |format=plain,indention=.5cm|
+ \end{quote}
+ \captionsetup{skip=0pt}
+ \example{format=plain,indention=.5cm}{\exampletext}
+\end{Example}
+
+\begin{Example}
+ \begin{quote}
+ |format=hang,indention=-0.5cm|
+ \end{quote}
+ \captionsetup{skip=0pt}
+ \example{format=hang,indention=-0.5cm}{\exampletext}
+\end{Example}
+
+\bigskip
+
+\pagebreak[3]
+\DescribeMacro{labelformat=}
+% With the option
+С~ключом\label{TeXr:caplabel:a}%
+\nopagebreak[3]
+\begin{quote}
+ |labelformat=|\meta{label format name}
+\end{quote}
+\nopagebreak[3]
+%\NEWdescription{v3.0e}
+% you specify how the caption label will be typeset.
+% There are five standard caption label formats:
+вы задаёте, как печатается нумерационная часть.
+Существуют четыре стандартных оформления нумерационного заголовка:
+
+\begin{Options}{\OptionLabel}
+ \item[default]
+% The caption label will be typeset as specified by the document class,
+% usually this means the name and the number (like \texttt{simple}).
+% (This is the default behaviour.)
+ нумерационный заголовок печатается так же как в~стандартных классах,
+ это обычно название флота и~номер (как \texttt{simple}).
+ (Задаётся по умолчанию.)
+
+ \item[empty]
+% The caption label will be empty.
+ Нумерационный заголовок отсутствует.
+\iffalse
+% (This option makes sense when used together with other options like
+% \texttt{labelsep=none}.)
+ (Эта опция имеет смысл вместе с~опциями типа \texttt{labelsep=none}.)
+\fi
+
+ \item[simple]
+% The caption label will be typeset as a name and a number.
+ Нумерационный заголовок печатается как название флота и~его номер.
+
+ \item[brace]\NEWfeature{v3.1f}
+% The caption label will be closed with a single (right) brace.
+ Нумерационный заголовок (номер подфлота) отделён справа круглой скобкой.
+
+ \item[parens]
+% The number of the caption label will be typeset in parentheses.
+ Номер в~нумерационной части заголовка печатается в~скобках.
+
+ \item[\UserDefined]
+% Own label formats can be defined using |\Declare|\-|Caption|\-|Label|\-|Format|.
% \SeeUserDefined
-% \end{Options}
-%
-% \begin{Example}
-%^^A An example: Using the options
-% Пример: с~опциями ключей
-% \begin{quote}
-% |labelformat=parens,labelsep=quad|
-% \end{quote}
-%^^A gives captions like this one:
-% создаётся такая подпись:
-% \example{labelformat=parens,labelsep=quad}{\figuretext}
-% \end{Example}
-%
-% \DescribeMacro{labelsep=}
-%^^A With the option
-% С~ключом
-% \begin{quote}
-% |labelsep=|\meta{label separator name}
-% \end{quote}
-%^^A you specify what caption separator will be used.
-%^^A You can choose one of the following:
-% вы определяете какой разделитель [между нумерационным заголовком и~текстом]
-% будет использоваться.
-% Вы можете задать следующие опции:
-%
-% \begin{Options}{\OptionLabel}
-% \item[none]
-%^^A There is no caption separator. (This option makes sense when used
-%^^A together with other options like \texttt{labelformat=empty}.)
-% Отсутствует разделитель нумерационной части и~текста подписи. (Применение этой опции
-% имеет смысл вместе с~опциями типа \texttt{labelformat=empty}.)
-%
-% \item[colon]
-%^^A The caption label and text will be separated by a colon and a space.
-%^^A (This is the default one.)
-% Нумерационный заголовок и~текст разделены двоеточием и~пробелом.
-% (Задаётся по умолчанию.)
-%
-% \item[period]
-%^^A The caption label and text will be separated by a period and a space.
-% Нумерационная часть и~текст разделены точкой и~пробелом.
-%
-% \item[space]
-%^^A The caption label and text will be separated by a single space.
-% Нумерационная часть и~текст разделяется пробелом.
-%
-% \item[quad]
-%^^A The caption label and text will be separated by a |\quad|.
-% Нумерационная часть и~текст разделяется кегельной (|\quad|).
-%
-% \item[newline]
-%^^A The caption label and text will be separated by a line break (|\\|).
-% Нумерационный заголовок и~текст разделены новой строкой~(|\\|).
-%
-%
-% \item[endash]\NEWfeature{v3.0h}
-%^^A The caption label and text will be separated by an en-dash,
-%^^A surrounded by spaces (| -- |).
-% Нумерационный заголовок и~текст разделяется кратким тире,
-% окружённым пробелами (| -- |).
-%
-% \item[\UserDefined]
-%^^A Own separators can be defined using |\DeclareCaptionLabelSeparator|.
-% Собственные разделители можно определить, используя команду
-% |\DeclareCaptionLabelSeparator|.
+ Собственное оформление может быть определено с~помощью
+ команды |\Declare|\-|Caption|\-|Label|\-|Format|.
+\end{Options}
+
+\begin{Example}
+% An example: Using the options
+ Пример: с~опциями ключей
+ \begin{quote}
+ |format=plain,labelformat=parens,labelsep=quad,|\\
+ | figurename=\CYRR\cyri\cyrs\cyru\cyrn\cyro\cyrk|
+ \end{quote}
+% gives captions like this one:
+ создаётся такая подпись:
+ \example{format=plain,labelformat=parens,labelsep=quad,
+ figurename=\CYRR\cyri\cyrs\cyru\cyrn\cyro\cyrk}{\exampletext}
+\end{Example}
+[Название в~нумерационном заголовке для данного примера изменено с~помощью
+опции |figurename|. \See{\Ref{names}}]
+
+\medskip
+
+\begin{Note*}
+% Some environments, e.g.~the |algorithm| environment offered by the
+% \package{algorithm2e} package, might react allergic to a change of the
+% caption label format.
+У~некоторых окружений, например у~окружения |algorithm|, предлагаемого
+пакетом \package{algorithm2e}, изменение формата нумерационного заголовка
+может вызвать аллергию.
+\end{Note*}
+
+\bigskip
+
+\pagebreak[3]
+\DescribeMacro{labelsep=}
+% With the option
+С~ключом
+\begin{quote}
+ |labelsep=|\meta{label separator name}
+\end{quote}
+% you specify what caption separator will be used.\footnote{%
+% If the caption label or the caption text is empty,
+% no separator will be used.}
+% You can choose one of the following:
+вы определяете какой разделитель [между нумерационным заголовком и~текстом]
+будет использоваться\footnote{%
+ Если нумерационный заголовок или текст подписи пустые,
+ разделитель не используется.}.
+Вы можете задать следующие опции:
+
+\begin{Options}{newline}
+ \item[none]
+% There is no caption separator.
+ Отсутствует разделитель нумерационной части и~текста подписи.
+\iffalse
+% (This option makes sense when used together with other options like
+% \texttt{labelformat=empty}.)
+ (Применение этой опции
+ имеет смысл вместе с~опциями типа \texttt{labelformat=empty}.)
+\fi
+
+ \item[colon]
+% The caption label and text will be separated by a colon and a space.
+ Нумерационный заголовок и~текст разделены двоеточием и~пробелом.
+
+ \item[period]
+% The caption label and text will be separated by a period and a space.
+ Нумерационный заголовок и~текст разделены точкой и~пробелом.
+
+ \item[space]
+% The caption label and text will be separated by a single space.
+ Нумерационный заголовок и~текст разделены пробелом.
+
+ \item[quad]
+% The caption label and text will be separated by a |\quad|.
+ Нумерационный заголовок и~текст разделены кегельной (|\quad|).
+
+ \item[newline]
+% The caption label and text will be separated by a line break (|\\|).
+% Please note that this separator does not work with all caption
+% formats (e.g.~|format=|\x|hang|), and you'll get an error message
+% trying such combination of options.
+ Нумерационный заголовок и~текст разделены новой строкой~(|\\|).
+ Обратите внимание, что этот разделитель не работает с~некоторыми
+ форматами (например, |format=|\x|hang|), и~вы получите сообщение
+ об ошибке при попытке использовать эту комбинацию.
+
+ \item[endash]\NEWfeature{v3.0h}
+% The caption label and text will be separated by an en-dash,
+% surrounded by spaces (\verb*| -- |).
+ Нумерационный заголовок и~текст разделяется кратким тире,
+ окружённым пробелами (\verb*| -- |).
+
+ \item[\UserDefined]
+% Own separators can be defined using |\Declare|\-|Caption|\-|Label|\-|Sep|\-|a|\-|ra|\-|tor|.
% \SeeUserDefined
-% \end{Options}
-%
-%^^A Three examples:
-% Три примера:
-% \begin{Example}
-% \begin{quote}
-% |labelsep=period|
-% \end{quote}
-% \captionsetup{aboveskip=0pt}
-% \example{labelsep=period}{\figuretext}
-% \end{Example}
-%
-% \begin{Example}
-% \begin{quote}
-% |labelsep=newline,singlelinecheck=false|
-% \end{quote}
-% \captionsetup{aboveskip=0pt}
-% \example{labelsep=newline,singlelinecheck=false}{\figuretext}
-% \end{Example}
-%
-% \begin{Example}
-% \begin{quote}
-% |labelsep=endash|
-% \end{quote}
-% \captionsetup{aboveskip=0pt}
-% \example{labelsep=endash}{\figuretext}%^^A
-% \label{TeXr:caplabel:z}
-% \end{Example}
-%
-% \iffalse
+ Собственные разделители можно определить, используя команду
+ |\Declare|\-|Caption|\-|Label|\-|Sep|\-|a|\-|ra|\-|tor|.
+ \SeeUserDefined
+\end{Options}
+
+% Three examples:
+Три примера:
+\begin{Example}
+ \begin{quote}
+ |format=plain,labelsep=period|
+ \end{quote}
+ \captionsetup{skip=0pt}
+ \example{format=plain,labelsep=period}{\exampletext}
+\end{Example}
+
+\begin{Example}
+ \begin{quote}
+ |format=plain,labelsep=newline,singlelinecheck=false|
+ \end{quote}
+ \captionsetup{skip=0pt}
+ \example{format=plain,labelsep=newline,singlelinecheck=false}{\exampletext}
+\end{Example}
+
+\begin{Example}
+ \begin{quote}
+ |format=plain,labelsep=endash|
+ \end{quote}
+ \captionsetup{skip=0pt}
+ \example{format=plain,labelsep=endash}{\exampletext}
+\end{Example}
+
+\bigskip
+
+\pagebreak[3]
+\DescribeMacro{textformat=}\NEWfeature{v3.0l}%
+% With the option
+С~опцией
+\nopagebreak[3]
+\begin{quote}
+ |textformat=|\meta{text format name}
+\end{quote}
+\nopagebreak[3]
+% you specify how the caption text will be typeset.
+% There are two standard caption text formats:
+вы определяете как текст подписи будет напечатан.
+Существует два стандартных формата подписи:
+
+\begin{Options}{\OptionLabel}
+ \item[simple]
+% The caption text will be typeset as it is.
+ Текст подписи будет напечатан как есть.
+
+ \item[period]
+% The caption text will be followed by a period.
+ В~конце подписи ставится точка.
+
+ \item[\UserDefined]
+% Own label formats can be defined using |\Declare|\-|Caption|\-|Text|\-|Format|.
+% \SeeUserDefined
+ Собственные форматы текста могут быть определены с~использованием команды |\Declare|\-|Caption|\-|Text|\-|Format|.
+ \SeeUserDefined
+\end{Options}
+
% --------------------------------------------------------------------------- %
-% \fi
-%
-%^^A \subsection{Justification}
-% \subsection{Выключка}
-% \label{justification}
-%
-% \DescribeMacro{justification=}
-%^^A As addition to the caption format you could also specify a
-%^^A \emph{caption justification}; it is specified with the option
-% При оформлении подписи вы можете определить
-% \emph{выключку подписи}; она задаётся ключом
-% \begin{quote}
-% |justification=|\meta{justification name}\quad.
-% \end{quote}
-%
-%^^A You can choose one of the following:
-% Вы можете выбрать следующие опции:
-%
-% \begin{Options}{\OptionLabel}
-% \item[justified]
-%^^A Typesets the caption as a normal paragraph. (This is the default.)
-% Печатает подпись в~виде обычного абзаца. (По умолчанию.)
-%
-% \item[centering]
-%^^A Each line of the caption will be centered.
-% Все строки выключены по центру.
-%
-% \iffalse
-% \item[Centering]
-%^^A Each line of the caption will be centered, too.
-%^^A But this time the command |\Centering| of the \package{ragged2e} package
-%^^A will be used to achieve this. This difference is that this time the word
-%^^A breaking algorithm of \TeX\ will work inside the caption.
-% Каждая строка также выключена по центру.
-% Но в~данном случае используется команда |\Centering| из пакета \package{ragged2e}.
-% Это означает что включается алгоритм разрыва [слов] на строки Plain \TeX'а.
-% \fi
-%
-% \item[centerlast]
-%^^A The last line of each paragraph of the caption text will be centered.
-% Абзац набирается на полный формат, последняя строка выключена по центру.
-%
-% \item[centerfirst]
-%^^A Only the first line of the caption will be centered.
-% Центрируется только первая строка [остальные, в~том числе и~концевая,
-% выключаются на полный формат].
-%
-% \item[raggedright]
-%^^A Each line of the caption will be moved to the left margin.
-% Строки подписи выключены влево.
-%
-% \iffalse
-% \item[RaggedRight]
-%^^A Each line of the caption will be moved to the left margin using
-%^^A the command |\RaggedRight| from the \package{ragged2e} package.
-% Строки подписи выключены влево с~использованием команды
-% |\RaggedRight| из пакета \package{ragged2e}.
-% \fi
-% \item[RaggedRight]
-%^^A Each line of the caption will be moved to the left margin, too.
-%^^A But this time the command |\RaggedRight| of the \package{ragged2e} package
-%^^A will be used to achieve this. The main difference is that the word
-%^^A breaking algorithm of \TeX\ will work inside captions.
-% Строки подписи также выключены влево,
-% но в~данном случае используется |\RaggedRight| пакета \package{ragged2e}.
-% Отличие состоит в~том, что используется
-% алгоритм разрыва [слов] на строки Plain \TeX'а.
-%
-% \item[raggedleft]
-%^^A Each line of the caption will be moved to the right margin.
-% Строки подписи выключены вправо.
-%
-% \iffalse
-% \item[RaggedLeft]
-%^^A Each line of the caption will be moved to the right margin using
-%^^A the command |\RaggedLeft| from the \package{ragged2e} package.
+
+\PageBreak
+% \subsection{Justification}
+\subsection{Выключка}
+\label{justification}
+
+\DescribeMacro{justification=}
+% As addition to the caption format you could also specify a
+% \emph{caption justification}; it is specified with the option
+При оформлении подписи вы можете определить
+\emph{выключку подписи}; она задаётся ключом
+\begin{quote}
+ |justification=|\meta{justification name}\quad.
+\end{quote}
+
+% You can choose one of the following:
+Вы можете выбрать следующие опции:
+
+\begin{Options}{\OptionLabel}
+ \item[justified]
+% Typesets the caption as a normal paragraph.
+ Печатает подпись в~виде обычного абзаца. (По умолчанию.)
+
+ \item[centering]
+% Each line of the caption will be centered.
+ Все строки выключены по центру.
+
+% \item[Centering]
+
+ \item[centerlast]
+% The last line of each paragraph of the caption text will be centered.
+ Абзац набирается на полный формат, последняя строка выключена по центру.
+
+ \item[centerfirst]
+% Only the first line of the caption will be centered.
+ Центрируется только первая строка [остальные, в~том числе и~концевая,
+ выключаются на полный формат].
+
+ \item[raggedright]
+% Each line of the caption will be moved to the left margin.
+ Строки подписи выключены влево.
+
+\iffalse
+ \item[RaggedRight]
+% Each line of the caption will be moved to the left margin using
+% the command |\RaggedRight| from the \package{ragged2e} package.
+ Строки подписи выключены влево с~использованием команды
+ |\RaggedRight| из пакета \package{ragged2e}.
+\else
+ \item[RaggedRight]
+% Each line of the caption will be moved to the left margin, too.
+% But this time the command |\RaggedRight| of the \package{ragged2e}
+% package will be used to achieve this.
+% The main difference to |raggedright| is that the word breaking
+% algorithm of \TeX\ will work inside captions.\footnote{%
+% The need for the \package{ragged2e} package will be detected at
+% run-time, therefore you maybe need a second \LaTeX\ run if this
+% option is used for the first time.}
+ Строки подписи также выключены влево.
+ Но в~данном случае используется команда |\RaggedRight| пакета
+ \package{ragged2e}. Основное отличие от опции |raggedright|
+ заключается в~использовании алгоритма Plain \TeX'а для разрыва
+ слов внутри подписи.\footnote{
+ Необходимость в~этом пакете определяется «на лету»,
+ поэтому при использовании этой опции документ нужно дважды обработать \LaTeX'ом.}.
+\fi
+
+ \item[raggedleft]
+% Each line of the caption will be moved to the right margin.
+ Строки подписи выключены вправо.
+
+% \item[RaggedLeft]
+% % Each line of the caption will be moved to the right margin using
+% % the command |\RaggedLeft| from the \package{ragged2e} package.
% Строки подписи выключены вправо с~использованием команды
% |\RaggedRight| из пакета \package{ragged2e}.
-% \fi
-%
-% \item[\UserDefined]
-%^^A Own justifications can be defined using |\DeclareCaptionJustification|.
-% Собственные определения выключки можно задать с~помощью команды
-% |\DeclareCaptionJustification|.
+
+%\showhyphens{justification}
+ \item[\UserDefined]
+% Own justifications can be defined using
+% |\Declare|\-|Caption|\-|Jus|\-|ti|\-|fi|\-|ca|\-|tion|.
% \SeeUserDefined
-% \end{Options}
-%
-%^^A Three examples:
-% Три примера:\label{TeXr:centerlast}
-% \begin{Example}
-% \begin{quote}
-% |justification=centerlast|
-% \end{quote}
-% \captionsetup{aboveskip=0pt}
-% \example{justification=centerlast}{\figuretext}
-% \end{Example}
-%
-% \begin{Example}
-% \begin{quote}
-% |format=hang,justification=raggedright|
-% \end{quote}
-% \captionsetup{aboveskip=0pt}
-% \example{format=hang,justification=raggedright}{\figuretext}
-% \end{Example}
-%
-% \begin{Example}
-% \begin{quote}
-% |labelsep=newline,justification=centering|
-% \end{quote}
-% \captionsetup{aboveskip=0pt}
-% \example{belowskip=\abovecaptionskip,labelsep=newline,justification=centering}{\figuretext}
-% \end{Example}
-%
-% \DescribeMacro{singlelinecheck=}\label{TeXr:singleline:a}
-%^^A The standard \LaTeX\ document classes (|article|, |report|, and |book|)
-%^^A automatically center a caption if it fits in one single line:
-% Стандартные классы \LaTeX'а (|article|, |report|, и~|book|)
-% автоматически центрируют подпись если она однострочная:
-%
-% \example{belowskip=\abovecaptionskip}{Коротенькая подпись.}
-%
-% \DANGER
-%^^A The \thispackage\ package adapts this behaviour and therefore usually
-%^^A ignores the justification you have set with |justification=| in such case.
-%^^A But you can switch this special treatment of such short captions off
-%^^A with the option
-% Пакет \thispackage\ следует за этим алгоритмом и~поэтому
-% в~таких случаях игнорирует выключку, заданную ключом |justification=|.
-% Определить, следовать этому алгоритму или нет можно,
-% задав ключ
-% \begin{quote}
-% |singlelinecheck=|\meta{bool}\quad.
-% \end{quote}
-%^^A Using |false|, |no|, |off| or |0| for \meta{bool} switches the
-%^^A extra centering off:
-% Используя |false|, |no|, |off| или |0| вместо \meta{bool} вы отключите
-% центрирование однострочной подписи:
-% \begin{quote}
-% |singlelinecheck=false|
-% \end{quote}
-%^^A Doing so the above short caption would look like
-% После этого определения короткие подписи
-% [при задании выключки по умолчанию в~виде обычного абзаца]
-% будут выглядеть так
-%
-% \begingroup
-% \captionsetup{type=figure}
-% \ContinuedFloat
-% \endgroup
-% \example{belowskip=\abovecaptionskip,singlelinecheck=false}{Коротенькая подпись.}
-%
-%^^A You switch the extra centering on again by using |true|, |yes|, |on| or |1|
-%^^A for \meta{bool}. (The default is on.)
-% Используя |true|, |yes|, |on| или |1| вместо \meta{bool} вы включите механизм
-% центрирования коротких подписей. (Задано по умолчанию.)%^^A
-% \label{TeXr:singleline:z}
-%
-% \iffalse
+ Собственные определения выключки можно задать с~помощью команды
+ |\Declare|\-|Caption|\-|Jus|\-|ti|\-|fi|\-|ca|\-|tion|.
+ \SeeUserDefined
+\end{Options}
+
+% Three examples:
+Три примера:\label{TeXr:centerlast}%
+\begin{Example}
+ \begin{quote}
+ |format=plain,justification=centerlast|
+ \end{quote}
+ \captionsetup{skip=0pt}
+ \example{format=plain,justification=centerlast}{\exampletext}
+\end{Example}
+
+\begin{Example}
+ \begin{quote}
+ |format=hang,justification=raggedright|
+ \end{quote}
+ \captionsetup{skip=0pt}
+ \example{format=hang,justification=raggedright}{\exampletext}
+\end{Example}
+
+\begin{Example}
+ \begin{quote}
+ |format=plain,labelsep=newline,justification=centering|
+ \end{quote}
+ \captionsetup{skip=0pt}
+ \example*{format=plain,labelsep=newline,justification=centering}{\exampletext}
+\end{Example}
+
+\smallskip
+
+\PageBreak
+\DescribeMacro{singlelinecheck=}\label{TeXr:singleline:a}%
+% The standard \LaTeX\ document classes (\class{article}, \class{report}, and
+% \class{book}) automatically center a caption if it fits in one single line:
+Стандартные классы \LaTeX'а (\class{article}, \class{report}, и~\class{book})
+автоматически центрируют подпись если она однострочная:
+
+\example*{}{A short caption.}
+
+\INFO
+% \Thispackage\ adapts this behavior and therefore usually ignores the
+% justification \& indention you have set with |justification=| \&
+% |indention=| in such case.
+% But you can switch this special treatment of such short captions off
+% with the option
+\Thispackage\ следует за этим алгоритмом и~поэтому
+в~таких случаях игнорирует выключку, заданную ключами |justification=| и~|indention=|.
+Определить, следовать этому алгоритму или нет можно,
+задав ключ
+\begin{quote}
+ |singlelinecheck=|\meta{bool}\quad.
+\end{quote}
+% Using |false|, |no|, |off| or |0| for \meta{bool} switches the
+% extra centering off:
+Используя |false|, |no|, |off| или |0| вместо \meta{bool} вы отключите
+центрирование однострочной подписи:
+\begin{quote}
+ |singlelinecheck=false|
+\end{quote}
+% Doing so the above short caption would look like
+После этого определения короткие подписи
+[при задании выключки по умолчанию, в~виде обычного абзаца]
+будут выглядеть так
+
+\begingroup
+ \captionsetup{type=figure}
+ \ContinuedFloat
+ \example*{singlelinecheck=false}{A short caption.}
+\endgroup
+
+% You switch the extra centering on again by using |true|, |yes|, |on| or |1|
+% for \meta{bool}. (The default is on.)
+Используя |true|, |yes|, |on| или |1| вместо \meta{bool} вы включите механизм
+центрирования коротких подписей. (Задано по умолчанию.)%^^A
+\label{TeXr:singleline:z}
+
% --------------------------------------------------------------------------- %
-% \fi
-%
-%^^A \subsection{Fonts}
-% \subsection{Шрифты}
-% \label{fonts}
-%
-% \DescribeMacro{font=}
-% \DescribeMacro{labelfont=}
-% \DescribeMacro{textfont=}
-%^^A There are three font options which affects different parts of the caption:
-%^^A One affecting the whole caption (|font|), one which only affects the caption
-%^^A label and separator (|labelfont|) and at least one which only affects the
-%^^A caption text (|textfont|).
-%^^A You set them up using the options
-% Заданы три ключа которые определяют шрифт разных элементов подписи:
-% Один задаёт шрифт для всей подписи (|font|), другой задаёт шрифт только
-% для нумерационного заголовка и~разделителя (|labelfont|), и~ещё один
-% \cdash--- шрифт для текста (|testfont|).
-% Вы задаёте их, используя ключи
-% \begin{quote}\begin{tabular}{@{}r@{}ll}
-% |font=| & \marg{font options} & ,\\
-% |labelfont=| & \marg{font options} & и\\
-% |textfont=| & \marg{font options} & .\\
-% \end{tabular}\end{quote}
-%
-%^^A And these are the available font options:
-% Теперь существующие опции данных ключей:
-%
-% \begin{Options}{\OptionLabel}
-% \item[scriptsize] {\scriptsize Very small size}
-% \item[footnotesize] {\footnotesize The size usually used for footnotes}
-% \item[small] {\small Small size}
-% \item[normalsize] {\normalsize Normal size}
-% \item[large] {\large Large size}
-% \item[Large] {\Large Even larger size}
-%
-% \item[up] {\upshape Upright shape}
-% \item[it] {\itshape Italic shape}
-% \item[sl] {\slshape Slanted shape}
-% \item[sc] {\scshape Small Caps shape}
-%
-% \item[md] {\mdseries Medium series}
-% \item[bf] {\bfseries Bold series}
-%
-% \item[rm] {\rmfamily Roman family}
-% \item[sf] {\sffamily Sans Serif family}
-% \item[tt] {\ttfamily Typewriter family}
-%
-% \item[\UserDefined]
-%^^A Own font options can be defined using |\DeclareCaptionFont|.
-% Собственные опции могут быть определены с~помощью команды
-% |\DeclareCaptionFont|.
+
+% \subsection{Fonts}
+\subsection{Шрифты}
+\label{fonts}
+
+\DescribeMacro{font=}
+\DescribeMacro{labelfont=}
+\DescribeMacro{textfont=}
+% There are three font options which affects different parts of the caption:
+% One affecting the whole caption (|font|), one which only affects the caption
+% label and separator (|label|\-|font|) and at least one which only affects the
+% caption text (|text|\-|font|).
+% You set them up using the options
+Заданы три ключа которые определяют шрифт разных элементов подписи:
+Первый задаёт шрифт для всей подписи (|font|), второй задаёт шрифт только
+для нумерационного заголовка и~разделителя (|label|\-|font|), и~третий
+\cdash--- шрифт для текста (|text|\-|font|).
+Вы задаёте их, используя ключи
+\begin{quote}\begin{tabular}{@{}r@{}ll}
+ |font=| & \marg{font options} & ,\\
+ |labelfont=| & \marg{font options} & , и\\
+ |textfont=| & \marg{font options} & .\\
+\end{tabular}\end{quote}
+% where \meta{font options} is a list of comma separated font options.
+где аргументом \meta{font options} являются перечисленные через запятую опции.
+
+% And these are the available font options:
+Далее уже созданные опции данных ключей:
+
+\begin{Options}{stretch=\meta{amount}}
+ \item[scriptsize] {\scriptsize Очень маленький}
+ \item[footnotesize] {\footnotesize Обычно используется в~сносках}
+ \item[small] {\small Маленький}
+ \item[normalsize] {\normalsize Нормальный}
+ \item[large] {\large Большой}
+ \item[Large] {\Large Ещё больше}
+\end{Options}
+\vspace{0pt}\pagebreak[3]
+\begin{Options}{stretch=\meta{amount}}
+% \item[normalfont] {\normalfont Normal shape \& series \& family}
+ \item[normalfont] {\normalfont Исходные семейство, насыщенность и~начертание}
+
+ \item[up] {\upshape Прямой}
+ \item[it] {\itshape Курсив}
+ \item[sl] {\slshape Наклонный}
+ \item[sc] {\scshape Капитель}
+
+ \item[md] {\mdseries Нормальная насыщенность (светлый)}
+ \item[bf] {\bfseries Полужирный}
+
+ \item[rm] {\rmfamily Шрифт с~засечками}
+ \item[sf] {\sffamily Рубленый}
+ \item[tt] {\fontfamily{cmtt}\selectfont Шрифт пишущей машинки (равноширинный)}
+\end{Options}
+\vspace{0pt}\pagebreak[3]
+\begin{Options}{stretch=\meta{amount}}
+% \item[singlespacing] Single spacing \See{\Ref{setspace}}
+% \item[onehalfspacing] One-and-a-half spacing \See{\Ref{setspace}}
+% \item[doublespacing] Double spacing \See{\Ref{setspace}}
+% \item[stretch=\meta{amount}] |\setstretch|\marg{amount} \See{\Ref{setspace}}
+ \item[singlespacing] Одинарный интерлиньяж \See{\Ref{setspace}}
+ \item[onehalfspacing] Полуторный интерлиньяж \See{\Ref{setspace}}
+ \item[doublespacing] Двойной интерлиньяж \See{\Ref{setspace}}
+ \item[stretch=\meta{amount}] ${} \equiv {}$|\setstretch|\marg{amount} \See{\Ref{setspace}}
+\end{Options}
+\vspace{0pt}\pagebreak[3]
+\begin{Options}{stretch=\meta{amount}}
+% \item[normalcolor] |\normalcolor|
+% \item[color=\meta{colour}] |\color|\marg{colour}
+% {\small(If the \package{color} or \package{xcolor} package is loaded,
+% see \Ref{declare} for an example)}
+ \item[normalcolor] соответствует команде |\normalcolor|
+ \item[color=\meta{colour}] опция ключа эквивалентна аргументу команды |\color|\marg{colour}
+ {\small(Если загружен пакет \package{color} или \package{xcolor},
+ см., например~\Ref{declare})}
+\end{Options}
+\vspace{0pt}\pagebreak[3]
+\begin{Options}{stretch=\meta{amount}}
+% \item[normal] The combination of the options |normal|\-|color|,
+% |normal|\-|font|, |normal|\-|size|, and |single|\-|spacing|
+ \item[normal] Комбинация опций |normal|\-|color|,
+ |normal|\-|font|, |normal|\-|size| и~|single|\-|spacing|
+
+ \item[\UserDefined]
+% Own font options can be defined using |\Declare|\-|Caption|\-|Font|.
% \SeeUserDefined
-% \end{Options}
-%
-%^^A If you use only one of these options you can omit the braces;
-%^^A e.g., the options
-% Если используется одна опция ключа, фигурные скобки можно опустить;
-% например, опции
-% \iffalse
-% \begin{quote}
-% \fi
-% |font={small}|
-% \iffalse
-% \end{quote}
-% \fi
-% и
-% \iffalse
-% \begin{quote}
-% \fi
-% |font=small|
-% \iffalse
-% \end{quote}
-% \fi
-%^^A will give the same result.
-% дадут одинаковый результат.
-%
-%^^A Two examples:
-% Пара примеров:
-% \begin{Example}
-% \begin{quote}
-% |font={small,it},labelfont=bf|
-% \end{quote}
-% \captionsetup{aboveskip=0pt}
-% \example{font={small,it},labelfont=bf}{\figuretext}
-% \end{Example}
-%
-% \begin{Example}
-% \begin{quote}
-% |font=small,labelfont=bf,textfont=it|
-% \end{quote}
-% \captionsetup{aboveskip=0pt}
-% \example{font=small,labelfont=bf,textfont=it}{\figuretext}
-% \end{Example}
-%
-% \iffalse
+ Собственные опции могут быть определены с~помощью команды
+ |\Declare|\-|Caption|\-|Font|.
+ \SeeUserDefined
+\end{Options}
+
+% If you use only one of these options you can omit the braces;
+% e.g., the options
+Если используется одна опция ключа, фигурные скобки можно опустить;
+например, опции
+%\begin{quote}
+ |font={small}|
+%\end{quote}
+% and
+%\begin{quote}
+ |font=small|
+%\end{quote}
+% will give the same result.
+дадут одинаковый результат.
+
+% Three examples:
+Три примера
+\begin{Example}
+ \begin{quote}
+ |font=it,labelfont=bf|
+ \end{quote}
+ \captionsetup{skip=0pt}
+ \example{font=it,labelfont=bf}{\exampletext}
+\end{Example}
+
+\begin{Example}
+ \begin{quote}
+ |labelfont=bf,textfont=it|
+ \end{quote}
+ \captionsetup{skip=0pt}
+ \example{labelfont=bf,textfont=it}{\exampletext}
+\end{Example}
+
+\begin{Example}
+ \begin{quote}
+ |font={small,stretch=0.80}|
+ \end{quote}
+ \captionsetup{skip=0pt}
+ \example{font={small,stretch=0.80}}{\exampletext}
+\end{Example}
+
+\medskip
+
+\pagebreak[3]
+\DescribeMacro{font+=}
+\DescribeMacro{labelfont+=}
+\DescribeMacro{textfont+=}
+\NEWfeature{v3.1f}%
+% You can also add font options to the current ones, so for example
+Вы также можете добавить опции шрифта к~текущим, так например запись
+\begin{quote}
+ |\captionsetup{font=small}|\\
+ |\captionsetup{font+=it}|
+\end{quote}
+% is identical to
+будет идентична
+\begin{quote}
+ |\captionsetup{font={small,it}}|
+\end{quote}
+
% --------------------------------------------------------------------------- %
-% \fi
-%
-%^^A \subsection{Margins and further paragraph options}
-% \subsection{Поля и~другие опции формирования абзаца}
-% \label{margins}
-%
-% \DescribeMacro{margin=}
-% \DescribeMacro{width=}
-%^^A For all captions you can specify \emph{either} an extra margin \emph{or}
-%^^A a fixed width. You do this by using the options
-% Для всех подписей можно определить \emph{либо} дополнительную втяжку
-% \emph{либо} фиксированную ширину. Это задаётся ключами
-% \begin{quote}
-% \begin{tabular}{@{}r@{}ll}
-% |margin=| & \meta{amount} & \emph{или}\\
-% |width=| & \meta{amount} & \\
-% \end{tabular}\end{quote}
-%^^A Nevertheless what option you use, the left and right margin will be the
-%^^A same.
-% Независимо от того, какой ключ используется, левое и~правое поле
-% будут симметричны.
-%
-%^^A Two examples will illustrating this:
-% Два иллюстрирующих примера:
-% \begin{Example}
-% \begin{quote}
-% |margin=10pt|
-% \end{quote}
-% \captionsetup{aboveskip=0pt}
-% \example{margin=10pt}{\figuretext}
-% \end{Example}
-%
-% \begin{Example}
-% \begin{quote}
-% |width=.75\textwidth|
-% \end{quote}
-% \captionsetup{aboveskip=0pt}
-% \example{width=.75\textwidth}{\figuretext}
-% \end{Example}
-%
-% \DescribeMacro{parskip=}\label{TeXr:multipar:a}
-%^^A This option is useful for captions containing more than one paragraph.
-%^^A It specifies the extra vertical space inserted between them:
-% Данный ключ понадобится, если подписи содержат более одного абзаца.
-% Он задаёт дополнительную вертикальную отбивку между абзацами:
-% \begin{quote}
-% |parskip=|\meta{amount}
-% \end{quote}
-%^^A One example:
-% Пример:
-% \begin{Example}
-% \begin{quote}
-% |margin=10pt,parskip=5pt|
-% \end{quote}
-% \captionsetup{aboveskip=0pt}
-% \example{margin=10pt,parskip=5pt}{
-%^^A First paragraph of the caption. This one contains some test, just to
-%^^A show how these options affect the layout of the caption.
-%^^A
-%^^A Second paragraph of the caption. This one contains some text, too, to
-%^^A show how these options affect the layout of the caption.}
-% Первый абзац подписи. Он содержит немного текста, чтобы показать
-% как заданные настройки создают оформление подписи.
-%
-% Второй абзац подписи. Он тоже содержит немного текста, чтобы показать
-% как заданные настройки создают оформление подписи.}
-% \end{Example}
-%
-% \DescribeMacro{hangindent=}
-%^^A The option
-% Ключ
-% \begin{quote}
-% |hangindent=|\meta{amount}
-% \end{quote}
-%^^A is for setting up a hanging indention starting from the second line of each
-%^^A paragraph. If the caption contains just a single paragraph, using this option
-%^^A leads to the same result as the option |indention=| you already know about.
-%^^A But if the caption contains multiple paragraphs you will notice the difference:
-% задаёт втяжку для вторых строк каждого абзаца подписи.
-% Если подпись состоит из одного абзаца, этот ключ даёт тот же результат
-% что и~известный вам ключ |indention=|.
-% Но в~подписи из нескольких абзацев вы увидите разницу:
-%
-% \begin{Example}
-% \begin{quote}
-% |format=hang,indention=-.5cm|
-% \end{quote}
-% \captionsetup{aboveskip=0pt}
-% \example{format=hang,indention=-.5cm}{
-% Первый абзац подписи. Он содержит немного текста, чтобы показать
-% как заданные настройки создают оформление подписи.
-%
-% Второй абзац подписи. Он тоже содержит немного текста, чтобы показать
-% как заданные настройки создают оформление подписи.}
-% \end{Example}
-%
-% \begin{Example}
-% \begin{quote}
-% |format=hang,hangindent=-.5cm|
-% \end{quote}
-% \captionsetup{aboveskip=0pt}
-% \example{format=hang,hangindent=-.5cm}{
-% Первый абзац подписи. Он содержит немного текста, чтобы показать
-% как заданные настройки создают оформление подписи.
-%
-% Второй абзац подписи. Он тоже содержит немного текста, чтобы показать
-% как заданные настройки создают оформление подписи.}
-% \label{TeXr:multipar:z}
-% \end{Example}
-%
-% \iffalse
+
+% \subsection{Margins and further paragraph options}
+\subsection{Поля и~другие опции формирования абзаца}
+\label{margins}
+
+\DescribeMacro{margin=}
+\DescribeMacro{width=}
+% For all captions you can specify \emph{either} an extra margin \emph{or}
+% a fixed width:~\footnote{Only fixed widths are supported here; if you are
+% looking for a way to limit the width of the caption to the width of the
+% figure or table, please take a look at the \package{floatrow}\cite{floatrow}
+% or \package{threeparttable}\cite{threeparttable} package.}
+Для всех подписей можно определить \emph{либо} дополнительную втяжку
+\emph{либо} фиксированную ширину. Это задаётся ключами\footnote{Здесь поддерживаются
+ только фиксированные ширины; если вам нужно задать ширину подписи по ширине
+ графики или табличного материала, обратитесь к~пакетам \package{floatrow}\cite{floatrow}
+ или \package{threeparttable}\cite{threeparttable}.}
+\begin{quote}\begin{tabular}{@{}r@{}ll}
+ |margin=| & \meta{amount} & \emph{--или--}\\
+ |margin=| & |{|\meta{left amount}|,|\meta{right amount}|}| & \emph{--или--}\\
+ |width=| & \meta{amount} & \\
+\end{tabular}\end{quote}
+\NEWfeature{v3.1}
+% If you specify just one \meta{amount} for the margin, it will be used for
+% both, the left and right margin, e.g.~|margin=|\x|10pt| is equivalent to
+% |margin=|\x|{10pt,10pt}|.
+% In two-side documents the left and right margin will be swapped on even pages.
+Если вы определите только одно значение \meta{amount} для поля, оно будет использовано для обоих полей,
+левого и~правого, например,~|margin=|\x|10pt| эквивалентно |margin=|\x|{10pt,10pt}|.
+Для двусторонних документов левое и~правое поля на чётных полосах зеркально отобразятся.
+\DescribeMacro{oneside}
+\DescribeMacro{twoside}
+% To prevent this you can specify the option |oneside| additionally,
+% e.g.~|\caption|\-|setup{margin=|\x|{0pt,10pt},|\x|oneside}|.\par
+% But if you are specifying a width, then both, the left and the right margin,
+% will have the same amount.
+Если вам это не нужно вы можете задать дополнительно опцию |oneside|,
+например,~|\caption|\-|setup|\x|{margin=|\x|{0pt,10pt},|\x|oneside}|.\par
+Но если вы определяете ширину подписи, то оба поля будут одинаковыми.
+
+% Three examples will illustrating this:
+Три примера для иллюстрации:
+\begin{Example}
+ \begin{quote}
+ |margin=10pt|
+ \end{quote}
+ \captionsetup{skip=0pt}
+ \example{margin=10pt}{\exampletext}
+\end{Example}
+
+\begin{Example}
+ \begin{quote}
+ |margin={1cm,0cm}|
+ \end{quote}
+ \captionsetup{skip=0pt}
+ \example{margin={1cm,0cm}}{\exampletext}
+\end{Example}
+
+\begin{Example}
+ \begin{quote}
+ |width=.75\textwidth|
+ \end{quote}
+ \captionsetup{skip=0pt}
+ \example{width=.75\textwidth}{\exampletext}
+\end{Example}
+
+\begin{Note}
+% When the caption is placed beside the contents (for example in a |SC|\-|figure|
+% environment offered by the \package{sidecap} package\cite{sidecap}) or the
+% figure is an in-text figure (for example in a |wrap|\-|figure| environment
+% offered by the \package{wrapfig} package\cite{wrapfig}), the margin setting
+% will be automatically reset to |0pt| at the very beginning of the environment.
+% But if you really want to setup an extra margin for these environments, you can
+% do so by setting this margin either inside the environment itself, of by
+% specifying a margin for this particular environment,
+% e.g.~|\caption|\-|setup[SC|\-|figure]{margin=|\x|10pt}|.
+Когда подпись помещена рядом с~содержимым (например внутри
+окружения |SCfigure|, предлагаемого пакетом \package{sidecap} package\cite{sidecap})
+или окружение флота обтекается текстом (флот помещён в~оборку, например в~окружении |wrap|\-|figure|
+предлагаемом пакетом \package{wrapfig}\cite{wrapfig}), установки полей
+обнуляются в~начале окружения. Но если вам действительно нужно задать
+втяжку для этих окружений, вы можете задать нужные поля внутри окружения, задав
+установки полей специально для этих окружений, например,
+|\caption|\-|setup[SC|\-|figure]|\x|{margin=10pt}|.
+ \end{Note}
+
+\begin{Expert}
+\DescribeMacro{margin*=}\NEWfeature{v3.1}%
+% There is also a starred variant of the |margin=| option, |margin*=|, which only
+% changes the margin if no width was set.
+Существует также «звёздный» вариант ключа |margin=|, ключ |margin*=|, который
+изменяет поля только когда не задана ширина.
+\end{Expert}
+
+\begin{Expert}
+\DescribeMacro{minmargin=}
+\DescribeMacro{maxmargin=}\NEWfeature{v3.1}%
+% You can also set a minimum or maximum margin amount. This can be useful for
+% limiting the margin amount in smaller environments, e.g.~|minipage|s.
+% For example the \SmF\ document classes limit the margin amount to
+% |maxmargin=|\x|0.1\linewidth|. (See \Ref{SMF})
+Вы можете также задать минимальный или максимальный размер полей. Это может быть полезно
+для ограничения размера полей в~уменьшенных форматах, например внутри окружения~|minipage|.
+Например классы документов \SmF\ ограничивают поля
+|maxmargin=|\x|0.1\linewidth|. (См.~\Ref{SMF})
+\end{Expert}
+
+\medskip
+
+\pagebreak[3]
+\DescribeMacro{parskip=}\label{TeXr:multipar:a}%
+% This option is useful for captions containing more than one paragraph.
+% It specifies the extra vertical space inserted between them:
+Данный ключ понадобится, если подписи содержат более одного абзаца.
+Он задаёт дополнительную вертикальную отбивку между абзацами:
+\begin{quote}
+ |parskip=|\meta{amount}
+\end{quote}
+% One example:
+Пример:
+\begin{Example}
+ \begin{quote}
+ |margin=10pt,parskip=5pt|
+ \end{quote}
+ \captionsetup{skip=0pt}
+ \example{margin=10pt,parskip=5pt}{%
+% First paragraph of the caption. This one contains some test, just to
+% show how these options affect the layout of the caption.\par
+% Second paragraph of the caption. This one contains some text, too, to
+% show how these options affect the layout of the caption.}
+ Первый абзац подписи. Он содержит немного текста, чтобы показать
+ как заданные настройки создают оформление подписи.\par
+ Второй абзац подписи. Он тоже содержит немного текста, чтобы показать
+ как заданные настройки создают оформление подписи.}
+\end{Example}
+
+\pagebreak[3]
+\DescribeMacro{hangindent=}
+% The option
+Ключ
+\begin{quote}
+ |hangindent=|\meta{amount}
+\end{quote}
+% is for setting up a hanging indention starting from the second line of each
+% paragraph. If the caption contains just a single paragraph, using this option
+% leads to the same result as the option |indention=|\meta{amount} you already
+% know about.
+% But if the caption contains multiple paragraphs you will notice the difference:
+задаёт втяжку для вторых строк каждого абзаца подписи.
+Если подпись состоит из одного абзаца, этот ключ даёт тот же результат
+что и~известный вам ключ |indention=|\meta{amount}.
+Но в~подписи из нескольких абзацев вы увидите разницу:
+
+\begin{Example}
+ \begin{quote}
+ |format=hang,indention=-.5cm|
+ \end{quote}
+ \captionsetup{skip=0pt}
+ \example{format=hang,indention=-.5cm}{%
+% First paragraph of the caption. This one contains some test, just to
+% show how these options affect the layout of the caption.\par
+% Second paragraph of the caption. This one contains some text, too, to
+% show how these options affect the layout of the caption.}
+ Первый абзац подписи. Он содержит немного текста, чтобы показать
+ как заданные настройки создают оформление подписи.\par
+ Второй абзац подписи. Он тоже содержит немного текста, чтобы показать
+ как заданные настройки создают оформление подписи.}
+\end{Example}
+
+\begin{Example}
+ \begin{quote}
+ |format=hang,hangindent=-.5cm|
+ \end{quote}
+ \captionsetup{skip=0pt}
+ \example{format=hang,hangindent=-.5cm}{%
+% First paragraph of the caption. This one contains some test, just to
+% show how these options affect the layout of the caption.\par
+% Second paragraph of the caption. This one contains some text, too, to
+% show how these options affect the layout of the caption.}
+ Первый абзац подписи. Он содержит немного текста, чтобы показать
+ как заданные настройки создают оформление подписи.\par
+ Второй абзац подписи. Он тоже содержит немного текста, чтобы показать
+ как заданные настройки создают оформление подписи.}
+\end{Example}
+
+\begin{Note}
+% If your caption contains more than one paragraph, you have
+% to specify an alternative caption for the list-of-figures using the
+% optional argument of |\caption| or |\caption|\-|of|, otherwise you will
+% get an error message.
+Если подпись содержит более одного абзаца, вам нужно
+задать сокращённый вариант подписи для списков рисунков или таблиц, используя
+дополнительный аргумент команд |\caption| или |\captionof|, иначе вы получите
+сообщение об ошибке.
+\end{Note}
+
% --------------------------------------------------------------------------- %
-% \fi
-%
-%
-%^^A \subsection{Styles}
-% \subsection{Стили}
-% \label{style}
-%
-% \NoBreak\DescribeMacro{style=}
-%^^A A suitable combination of caption options is called \emph{caption style}.
-%^^A You can compare them more or less to page styles which you set up with
-%^^A |\pagestyle|: The caption style provides all settings for a whole caption layout.
-% Определённая\nopagebreak[4] комбинация нескольких ключей создаёт \emph{стиль подписи}.
-% Это можно сравнить со стилями колонтитула, задаваемого командой
-% |\pagestyle|: стиль подписи задаёт все настройки для оформления подписи.
-%
-%^^A You switch to an already defined caption style with the option
-% Предварительно созданный стиль можно вызвать ключом
-% \begin{quote}
-% |style=|\meta{style name}\quad.
-% \end{quote}
-%^^A The \thispackage\ package usually defines only the style |default| which
-%^^A puts all options you already know about to the default ones.
-%^^A This means that specifying the option
-% Пакет \thispackage\ задаёт стиль |default|, который
-% устанавливает известным вам ключам значения по умолчанию.
-% Это означает, что определение этого ключа как
-% \begin{quote}
-% |style=default|
-% \end{quote}
-%^^A has the same effect as specifying all these options:
-% даст тот же эффект, что и~задание всех ключей, приведённых ниже:
-% \begin{quote}
-% |format=default,labelformat=default,labelsep=default,|\\
-% |justification=default,font=default,labelfont=default,|\\
-% |textfont=default,margin=0pt,indention=0pt,parindent=0pt|\\
-% |hangindent=0pt,singlelinecheck=true|
-% \end{quote}
-%
-%^^A Own caption styles can be defined using |\DeclareCaptionStyle|.
-% Собственный стиль подписи можно определить, используя |\DeclareCaptionStyle|.
+
+\PageBreak
+% \subsection{Styles}
+\subsection{Стили}
+\label{style}
+
+\DescribeMacro{style=}
+% A suitable combination of caption options is called \emph{caption style}.
+% You can compare them more or less to page styles which you set up with
+% |\page|\-|style|;
+% the caption style provides all settings for a whole caption layout.
+Определённая комбинация нескольких ключей создаёт \emph{стиль подписи}.
+Это можно сравнить со стилями колонтитула, задаваемого командой
+|\pagestyle|: стиль подписи задаёт все настройки для оформления подписи.
+
+% You switch to an already defined caption style with the option
+Предварительно созданный стиль можно вызвать ключом
+\begin{quote}
+ |style=|\meta{style name}\quad.
+\end{quote}
+% \Thispackage\ pre-defines two styles: |base| and |default|.
+\Thispackage\ определяет два стиля: |base| и~|default|.
+
+\NEWfeature{v3.1}
+% The |base| style puts all options you already know about to values reflecting
+% the look of the captions when using one of the base \LaTeX\ document classes
+% \class{article}, \class{report}, and \class{book}.
+% This means that specifying the option
+Стиль |base| задаёт все известные вам ключи со значениями,
+соответствующими заданным в~базовых классах \LaTeX'а
+\class{article}, \class{report} и~\class{book}.
+Это означает, что задание опции
+\begin{quote}
+ |style=base|
+\end{quote}
+% has the same effect as specifying all these options:
+даст тот же эффект, что и задание всех перечисленных опций:
+\begin{quote}
+ |format=plain,labelformat=default,labelsep=colon,|\\
+ |justification=justified,font={},labelfont={},|\\
+ |textfont={},margin=0pt,indention=0pt|\\
+ |parindent=0pt,hangindent=0pt,singlelinecheck=true|
+\end{quote}
+\begin{Annotation*}
+% But |justification=centering,indention=0pt| will be set if
+% the caption fits into a single line.
+А~для однострочной подписи будут заданы настройки |justification=|\x|centering,|\x|indention=0pt|.
+\end{Annotation*}
+
+% In contrast the |default| style follows the default values, reflecting
+% the look of the captions given by the document class you actually use.
+% This style is selected by default and represents these options:
+В~отличие от предыдущего стиль |default| задаёт значения, отвечающие
+виду подписей, создаваемых данным классом документа.
+Этот стиль определяет следующие опции:
+\begin{quote}
+ |format=default,labelformat=default,labelsep=default,|\\
+ |justification=default,font=default,labelfont=default,|\\
+ |textfont=default,margin=0pt,indention=0pt|\\
+ |parindent=0pt,hangindent=0pt,singlelinecheck=true|
+\end{quote}
+\begin{Annotation*}
+% But again |justification=centering,indention=0pt| will be set if
+% the caption fits into a single line.
+Но при этом снова действуют настройки
+|justification=|\x|centering,|\x|indention=0pt| для однострочных подписей.
+\end{Annotation*}
+
+% So if you use one of the base \LaTeX\ document classes \class{article},
+% \class{report}, or \class{book}, both caption styles, |base| and |default|,
+% point to (nearly) the same settings.
+Поэтому, если вы используете один из классов \LaTeX'а \class{article},
+\class{report} или \class{book}, обе опции, |base| и~|default|, зададут фактически
+одинаковые настройки.
+
+\begin{Note}
+% Own caption styles can be defined using |\Declare|\-|Caption|\-|Style|.\LineBreak
% \SeeUserDefined
-%
-% \iffalse
+Собственные стили подписи могут быть определены с~помощью
+команды |\Declare|\-|Caption|\-|Style|.\LineBreak\SeeUserDefined
+\end{Note}
+
% --------------------------------------------------------------------------- %
-% \fi
-%
-%^^A \subsection{Skips}
-% \subsection{Отбивки}
-%
-% \DescribeMacro{aboveskip=}
-% \DescribeMacro{belowskip=}
-%^^A The spaces above and below the caption are controlled by the skips
-%^^A |\abovecaptionskip| and |\belowcaptionskip|. The standard \LaTeX\ document
-%^^A classes |article|, |report| and |book| set |\abovecaptionskip| to |10pt|
-%^^A and |\belowcaptionskip| to |0pt|.
-% Отбивки сверху и~снизу подписи определяются командами
-% |\abovecaptionskip| и~|\belowcaptionskip|. Стандартные классы \LaTeX'а
-% |article|, |report| и~|book| задают |\abovecaptionskip| равным |10pt|,
-% а~|\belowcaptionskip|\hbox{ \cdash--- |0pt|}.
-%
-%
-%^^A Both skips can be changed with the command |\setlength|, but you can
-%^^A use these options, too:
-% Обе отбивки могут быть изменены командой |\setlength|, но также можно
-% использовать и~ключи:
-% \nopagebreak[3]
-% \begin{quote}\begin{tabular}{@{}r@{}ll}
-% |aboveskip=| & \meta{amount} & и\\
-% |belowskip=| & \meta{amount} & .\\
-% \end{tabular}\end{quote}
-%
-% \DescribeMacro{position=}\label{TeXr:captionskips:a}
-%^^A Using |\abovecaptionskip| and |\belowcaptionskip| has a major design flaw:
-%^^A If the caption is typeset \emph{above} (and not \emph{below}) the figure
-%^^A or table they are not set up very useful at default, because there will be
-%^^A some extra space above the caption but no space between the caption and the
-%^^A figure or table itself. (Remember: |\belowcaptionskip| is usually set to |0pt|.)
-% Использование команд |\abovecaptionskip| и~|\belowcaptionskip| имеет один
-% недостаток: если подпись должна быть помещена \emph{над}, а~не \emph{под}
-% плавающим объектом, то, в~результате, мы можем получить ненужную отбивку сверху
-% и~никакой отбивки между подписью и~объектом.
-% (Напомним: |\belowcaptionskip| обычно определена как~|0pt|.)
-%
-%^^A Please compare the spacing in these small tables:
-% Пожалуйста, сравните отбивки у~двух небольших таблиц:
-% \begin{Example}
-% \begin{minipage}[c]{.5\linewidth}
-% \iffalse
-% \captionsetup{aboveskip=0pt}%
-% \fi
-% \captionof{table}{Табличка}
-% \centering\begin{tabular}{ll}
-% A & B \\
-% C & D \\
-% \end{tabular}
-% \end{minipage}
-% \begin{minipage}[c]{.5\linewidth}
-% \centering\begin{tabular}{ll}
-% A & B \\
-% C & D \\
-% \end{tabular}
-% \captionof{table}{Табличка}
-% \end{minipage}
-% \end{Example}
-%
-%^^A But you can fix this by using the option |position=|: It specifies how the
-%^^A spacing above and below the caption will be used:
-% Но это можно исправить используя ключ |position=|: он определяет, как
-% отбивки сверху и~снизу будут использованы; опция
-% \begin{quote}
-% |position=top|\quad(или |position=above|)
-% \end{quote}
-%^^A tells the \thispackage\ package to use the spacing useful for caption
-%^^A \emph{above} the figure or table and
-% говорит пакету \thispackage, что нужно задать соответствующие отбивки для подписи
-% \emph{сверху} рисунка или таблицы и~опция
-% \begin{quote}
-% |position=bottom|\quad(или |position=below|)
-% \end{quote}
-%^^A tells the \thispackage\ package to use the spacing useful for captions
-%^^A \emph{below} the figure or table. (The last one is the default setting
-%^^A except for |longtable|s.)
-% велит пакету \thispackage\ расставить соответствующие отбивки для подписи
-% \emph{снизу} рисунка или таблицы. (Данная опция задаётся по умолчанию
-% кроме окружения многостраничной таблицы |longtable|.)
-%
-%^^A So adding an extra |\captionsetup{position=top}| to the left example
-%^^A table gives you proper spacing around both captions:
-% Итак задание |\captionsetup{position=top}| для левой таблицы,
-% в~примере выше даст нужные отбивки для обеих подписей:
-% \begin{Example}
-% \begin{minipage}[c]{.5\linewidth}
-% \captionsetup{position=top}
-% \captionof{table}{Табличка}
-% \centering\begin{tabular}{ll}
-% A & B \\
-% C & D \\
-% \end{tabular}
-% \end{minipage}
-% \begin{minipage}[c]{.5\linewidth}
-% \centering\begin{tabular}{ll}
-% A & B \\
-% C & D \\
-% \end{tabular}
-% \captionof{table}{Табличка}
-% \end{minipage}
-% \end{Example}
-%
-%^^A (Technically speaking |\abovecaptionskip| and |\belowcaptionskip| will
-%^^A be swapped if you specify the option |position=top|, so in both cases
-%^^A |\abovecaptionskip| will be used between the caption and the figure or
-%^^A table itself.)
-% («Техника» работы ключа такова: |\abovecaptionskip| и~|\belowcaptionskip|
-% меняются местами если задана опция |position=top|, поэтому в~обоих случаях
-% |\abovecaptionskip| задаётся между подписью и~рисунком или таблицей.)
-%
-%^^A This option is especially useful when used together with the optional
-%^^A argument of the |\captionsetup| command.
-%^^A \See{\Section{misc}{Useful stuff} for details}\par
-%^^A For example
-% Этот ключ нужен когда используется вместе с~дополнительным аргументом
-% команды |\captionsetup|.
-% \See{\Section{misc}{Полезные утилиты}, чтобы узнать
-% подробности.}\par Например, опция ключа
-% \begin{quote}
-% |\captionsetup[table]{position=top}|
-% \end{quote}
-%^^A causes all captions within tables to be treated as captions \emph{above}
-%^^A the table (regarding spacing around it).
-% говорит, что подписи в~плавающих таблицах помещаются \emph{сверху}
-% (с~соответствующим отбивками).
-% \DescribeMacro{tableposition=}\label{TeXr:captop:a}%^^A
-% \NEWfeature{v3.0a}
-%^^A Because this is a very common setting the \thispackage\ package offers
-%^^A an abbreviating option for the use with |\usepackage|:
-% Поскольку такая установка очень популярна, пакет \thispackage\ предлагает
-% ключ"=аббревиатуру, для использования его в~строке |\usepackage|:
-% \begin{quote}
-%^^A% |\usepackage[|\ldots|,tableposition=top]{caption}|\footnote{Please
-%^^A% note that this is \emph{not} sufficient when using a
-%^^A% \KOMAScript\ document class, you need to use the \emph{global}
-%^^A% option |tablecaptionabove|, too.}
-% |\usepackage[|\ldots|,tableposition=top]{caption}|\footnote{Обратите внимание,
-% что этот ключ \emph{не} достаточен, если используется класс
-% \KOMAScript, вам понадобится также \emph{глобальная}
-% опция |tablecaptionabove|.}
-% \end{quote}
-%^^A is equivalent to
-% что эквивалентно
-% \begin{quote}
-% |\usepackage[|\ldots|]{caption}|\\
-% |\captionsetup[table]{position=top}|
-% \end{quote}\label{TeXr:captionskip:z}%^^A
-% \label{TeXr:captop:z}
-%
-% \iffalse
+
+% \subsection{Skips}
+\subsection{Отбивки}
+\label{skips}
+
+\DescribeMacro{skip=}\NEWfeature{v3.0d}%
+% The vertical space between the caption and the figure or table contents is
+% controlled by the option
+Вертикальная отбивка между подписью и~содержимым рисунка или таблицы
+определяется ключом
+\begin{quote}
+ |skip=|\meta{amount}\quad.
+\end{quote}
+% The standard \LaTeX\ document classes \class{article}, \class{report} and
+% \class{book} preset it to |skip=|\x|10pt|, but other document classes may
+% use a different amount.
+Стандартные классы \LaTeX'а |article|, |report| и~|book| определяют ключ как
+|skip=|\x|10pt|,
+но другие классы могут задать другое значение.
+
+\bigskip
+
+\pagebreak[3]
+\DescribeMacro{position=}\label{TeXr:captionskips:a}%
+% The |\caption| command offered by \LaTeX{} has a design flaw:
+% The command does not know if it stands on the beginning of the figure or
+% table, or at the end. Therefore it does not know where to put the space
+% separating the caption from the content of the figure or table.
+% While the standard implementation always puts the space above the caption
+% in floating environments (and inconsistently below the caption in
+% |long|\-|table|s), the implementation offered by this package is more
+% flexible:
+% By giving the option
+Команда |\caption|, предлагаемая \LaTeX'ом имеет недостаток в~оформлении:
+команда не знает, стоит ли она в~начале окружения рисунка или таблицы, или в~конце.
+Поэтому она не знает, как расставить отбивки, отделяющие подпись от содержимого
+рисунка или таблицы. Пока что стандартные определения задают отбивку всегда сверху
+подписи (и~снизу табличного заголовка в~окружении |long|\-|table|, что противоречит стандартному),
+решение, предлагаемое данным пакетом более гибкое.
+Задание опции
+\begin{quote}
+ |position=top|\quad или\quad |position=above|
+\end{quote}
+% it's assumed that the caption is standing at the \emph{top} of the
+% environment and therefore the space setup with |skip=|\x\meta{amount}
+% is placed below the caption.
+% (Please note that |position=|\x|top| does \emph{NOT} mean that the
+% caption is actually placed at the top of the figure or table.
+% Instead the caption is usually placed where you place the |\caption|
+% command.)
+% But with
+будет означать, что подпись размещается \emph{сверху} содержимого
+окружения, и~следовательно отбивка |skip=|\meta{amount} будет
+задана снизу подписи.
+(Обратите внимание, что |position=|\x|top| \emph{НЕ} означает,
+что подпись действительно напечатается сверху рисунка или таблицы.
+Подпись будет печататься там, где вы задали команду |\caption|.)
+Но задание
+\begin{quote}
+ |position=bottom|\quad или\quad |position=below|
+\end{quote}
+% it's assumed that the caption is standing at the \emph{bottom} of the
+% environment and therefore the space is placed above the caption.
+% And finally with
+означает, что подпись стоит \emph{снизу} содержимого
+окружения и~следовательно отбивка ставится сверху подписи.
+И~наконец, задав
+\begin{quote}
+% |position=auto|\quad {\small(which is the default setting)}
+ |position=auto|\quad {\small(что является значением по умолчанию)}
+\end{quote}
+% \thispackage\ tries its best to determine the actual position of
+% the caption on its own. Please note that while this is successfully in
+% most cases, it could give wrong results under rare circumstances.
+\thispackage\ постарается самостоятельно определить реальное положение
+подписи. Обратите внимание, что, хотя это и~даст верный результат в~большинстве случаев,
+в~некоторых редких ситуациях это может дать неверный результат.
+
+\medskip
+
+\pagebreak[3]
+\DescribeMacro{figureposition=}%\NEWfeature{v3.0a}
+\DescribeMacro{tableposition=}%\NEWfeature{v3.0a}
+% The |position| option is especially useful when used together with the
+% optional argument of the |\caption|\-|setup| command.
+% \See{also \Ref{captionsetup}}\par
+% For example
+Опция |position| особенно полезна, когда используется в~настройках
+с~опцией в~команде |\captionsetup|.
+\See{\Ref{captionsetup}}\par
+Например\label{TeXr:captop:a}
+\begin{quote}
+ |\captionsetup[table]{position=above}|
+\end{quote}
+% causes all captions within tables to be treated as captions \emph{above}
+% the table (regarding spacing around it).
+% Because this is a very common setting, \thispackage\ offers
+% the abbreviating options |figure|\-|position=|\x\meta{pos} and
+% |table|\-|position=|\x\meta{pos}, e.g.
+определяет, что все табличные заголовки помещены \emph{над} содержимым
+таблицы (с~соответствующими отбивками).
+Поскольку это достаточно часто используемые настройки, \thispackage\ предлагает
+ключи-аббревиатуры |figure|\-|position=|\allowbreak\meta{pos}
+и~|table|\-|position=|\allowbreak\meta{pos},
+например
+\begin{quote}
+ |\usepackage[|\ldots|,tableposition=top]{caption}|
+\end{quote}
+% is equivalent to
+эквивалентно следующему
+\begin{quote}
+ |\usepackage[|\ldots|]{caption}|\\
+ |\captionsetup[table]{position=top}|
+\end{quote}
+
+\medskip
+
+\INFO
+% Please note that the options |skip=|, |position=|, |figure|\-|position=|,
+% and |table|\-|position=| do not always have an effect.
+% Since it's a matter of the document class to supply the environments
+% |figure| and |table|, it could use its very own spacing, and could
+% decide for itself if the caption will be typeset as ``top'' or ``bottom''
+% caption.
+ Обратите внимание, что ключи |skip=|, |position=|,
+ |figure|\-|position=| и~|table|\-|position=| не всегда дадут эффект.
+ Поскольку определение окружений |figure| и~|table| дают классы документа,
+ то они и~определяют, будет ли подпись помещена сверху или снизу.
+% For example the \KOMAScript\ document classes support the |skip=|
+% setting, but will always typeset |figure| captions as ``bottom'' captions,
+% and |table| captions are dependent on the global option
+% |table|\-|captions|\-|above| resp.\ |table|\-|captions|\-|below|.
+% \See{\Ref{KOMA}}
+ Например, классы документов \KOMAScript\ поддерживают настройку |skip=|,
+ но она всегда печатает подписи к~рисункам (|figure|) снизу,
+ а~размещение табличных заголовков (|table|) зависит от глобальной опции
+ |table|\-|captions|\-|above| и, соответственно, |table|\-|captions|\-|below|.
+ \See{\Ref{KOMA}}
+
+% Furthermore some packages control the behavior of the spacing above and
+% below the caption for themself, e.g.~the \package{float}, the
+% \package{floatrow}, and the \package{supertabular} package.
+ Более того некоторые пакеты сами контролируют отбивки сверху и~снизу подписи,
+ например, пакеты \package{float},
+ \package{floatrow}, и~\package{supertabular}.
+
+\bigskip
+
+\begin{Expert*}
+% Internally the skip between caption and contents is represented by
+% |\above|\-|caption|\-|skip| (which is always set above the caption in
+% \LaTeX{}s implementation).
+% But there is a second value |\below|\-|caption|\-|skip| (usually set to
+% |0pt| by default) which is set below the caption in \LaTeX{}s implementation,
+% but on the other side than |\above|\-|caption|\-|skip| by this package.
+% So technically speaking, this package swaps the meaning of these two skips
+% when |position=|\x|top| is set.
+% Please note that there are several packages around which do the same trick
+% (like the \package{ftcap}, the \package{nonfloat}, and the \package{topcap}
+% package), so the usage of the \package{caption} option |position=| is not
+% supported if one of these packages will be used, too.
+Собственно говоря, отбивка между подписью и~содержимым флота определяется значением
+|\above|\-|caption|\-|skip| (которая в~стандартном
+\LaTeX'е всегда задаётся сверху подписи).
+Но существует и~вторая команда отбивки |\below|\-|caption|\-|skip| (обычно
+равная |0pt|) которая в~стандартном \LaTeX'е помещается снизу подписи,
+или с~противоположной стороны от |\above|\-|caption|\-|skip|, в~данном пакете.
+Иначе говоря, данный пакет переключает значения этих отбивок при задании опции
+ |position=|\x|top|.
+Обратите внимание, что существует несколько пакетов, которые делают тот же трюк
+(это пакеты \package{ftcap}, \package{nonfloat} и~\package{topcap});
+поэтому, в~случае использования одного из этих пакетов, использование ключа
+|position=| пакета \package{caption} не поддерживается.
+\end{Expert*}
+
% --------------------------------------------------------------------------- %
-% \fi
-%
-%
-%^^A \section{Useful stuff}
-% \section{Полезные утилиты}
-% \label{misc}
-%
-% \DescribeMacro{\caption}
-%^^A The command
-% Команда
-% \nopagebreak[3]
-% \begin{quote}
-% |\caption|\oarg{lst\_entry}\marg{heading}
-% \end{quote}
-% \nopagebreak[3]
-%^^A typesets the caption inside a floating environment like |figure| or |table|.
-%^^A Well, you already know this, but the \thispackage\ package offers an extension:
-%^^A If you leave the argument \meta{lst\_entry} empty, no entry in the list of
-%^^A figures or tables will be made. For example:
-% печатает подпись внутри окружения флота, типа |figure| или |table|.
-% Так, это нам известно, но новость состоит в~том, что если
-% задать аргумент \meta{lst\_entry} пустым, подпись в~списке рисунков или
-% таблиц не появится; например,
-% \begin{quote}
-%^^A |\caption[]{A figure without entry in the list of figures.}|
-% |\caption[]{Подпись без записи в списке рисунков.}|
-% \label{TeXr:nolistentry:I}
-% \end{quote}
-%
-% \DescribeMacro{\caption*}\label{TeXr:starcaption:a}%^^A
-%^^A The \package{longtable} package defines the command |\caption*| which
-%^^A typesets the caption without label and without entry in the list of tables.
-%^^A An example:
-% Пакет \package{longtable} определяет команду |\caption*| которая
-% печатает подпись без метки и~занесения её в~список таблиц.
-% Пример:
-% \begin{quote}
-% |\begin{longtable}{cc}|\\
-% | \caption*{Табличка}\\|\\
-% | A & B \\|\\
-% | C & D \\|\\
-% |\end{longtable}|
-% \end{quote}
-% выглядит следующим образом:\nopagebreak
-% \begin{longtable}{cc}
-% \caption*{Табличка}\\
-% A & B \\
-% C & D \\
-% \end{longtable}
-%
-%^^A This package offers this feature, too, so you can use this command now within
-%^^A every floating environment like |figure| or |table|, like:
-% Данный пакет тоже предлагает такую возможность. И~теперь вы можете использовать эту команду
-% с~любым окружением плавающего объекта, например |figure| или |table|, как здесь:
-% \begin{quote}
-% |\begin{table}|\\
-% | \caption*{Табличка}|\\
-% | \begin{tabular}{cc}|\\
-% | A & B \\|\\
-% | C & D \\|\\
-% | \end{tabular}|\\
-% |\end{table}|
-% \end{quote}
-%
-% \DescribeMacro{\captionof}%^^A
-% \DescribeMacro{\captionof*}\label{TeXr:captiononof:a}%^^A
-%^^A Sometimes you want to typeset a caption \emph{outside} a floating environment,
-%^^A putting a figure within a |minipage| for instance. For this purpose the
-%^^A \thispackage\ package offers the command
-% Иногда вам нужно создать подпись \emph{вне} окружения флота,
-% поместив, к~примеру, подпись внутри окружения |minipage|. Для этой цели пакет
-% \thispackage\ предлагает команду
-% \begin{quote}
-% |\captionof|\marg{float type}\oarg{lst\_entry}\marg{heading}\quad.
-% \end{quote}
-%^^A Note that the first argument, the \meta{float type}, is mandatory here, because
-%^^A the |\captionof| command needs to know which name to put into the caption label
-%^^A (e.g. ``Figure'' or ``Table'') and in which list to put the contents entry.
-%^^A An example:
-% Обратите внимание, что первый аргумент, \meta{float type}, в~данном случае является
-% обязательным, поскольку команда |\captionof| должна знать, к~какому плавающему
-% объекту создать подпись (например. «Рис.» или «Таблица») и~в~какой список поместить
-% подпись. Пример
-% \begin{quote}
-% |\captionof{figure}{Картинка}|\\
-% |\captionof{table}{Табличка}|
-% \end{quote}
-%^^A typesets captions like this:
-% создаёт подписи как здесь:
-% \begin{Example}
-% \captionof{figure}{Картинка}
-% \captionsetup{belowskip=\abovecaptionskip}
-% \captionof{table}{Табличка}
-% \end{Example}
-%
-%^^A The star variant |\captionof*| has the same behaviour as the |\caption*| command:
-%^^A it typesets the caption without label and without entry to the list of figures
-%^^A or tables.
-% «Звёздный» вариант |\captionof*| даёт тот же результат, что и~|\caption*|:
-% печатает подпись без нумерационного заголовка и~вывода в~список рисунков или
-% таблиц.
-%
-%^^A Please use both |\captionof| and |\captionof*| only \emph{inside} environments
-%^^A (like |minipage| or |\parbox|), otherwise a page break can appear between content
-%^^A and caption. Furthermore some strange effects could occur (e.g., wrong spacing
-%^^A around captions).
-% Используйте обе команды, |\captionof| и~|\captionof*|, только в~окружениях
-% (типа |minipage| или |\parbox|), иначе подпись может разорваться между страницами.
-% Кроме этого могут возникнуть побочные эффекты (например, неверные отбивки
-% вокруг подписи).\label{TeXr:captiononof:z}\label{TeXr:starcaption:z}
-%
-% \DescribeMacro{\ContinuedFloat}\label{TeXr:continued:a}
-%^^A Sometimes you want to split figures or tables without giving them
-%^^A their own reference number. This is what the command
-% Иногда возникает необходимость разбить рисунки или таблицы на несколько
-% частей, задав им общий номер. Для этого предназначена команда
-% \begin{quote}
-% |\ContinuedFloat|\quad.
-% \end{quote}
-%^^A is for; it should be used as first command inside the floating environment.
-%^^A It prevents the increment of the relevant counter (usually done by |\caption|)
-%^^A so a figure or table with a |\ContinuedFloat| in it gets the same reference
-%^^A number as the figure or table before.
-% Лучше её поставить первой внутри окружения флота.
-% Команда |\ContinuedFloat| отменяет увеличение соответствующего счётчика флота
-% (используемого командой |\caption|)
-% и~задаёт тот же номер как и~у~рисунка или таблицы выше.
-%
-%^^A An example:
-% Пример:
-% \begin{quote}
-% |\begin{table}|\\
-% |\caption{Табличка}|\\
-% \ldots\\
-% |\end{table}|\\
-% \ldots\\
-% |\begin{table}\ContinuedFloat|\\
-% |\caption{Табличка (продолжение)}|\\
-% \ldots\\
-% |\end{table}|
-% \end{quote}
-%^^A gives the following result:
-% даст следующий результат:
-% \begin{Example}
-% \makeatletter\def\@captype{table}\makeatother
-% \caption[]{Табличка}
-% \centerline{\ldots}
-% \ContinuedFloat
-% \captionsetup{aboveskip=0pt}
-% \caption[]{Табличка (продолжение)}
-% \label{TeXr:continued:z}
-% \end{Example}
-%
-% \DescribeMacro{\captionsetup}
-%^^A We already know the |\captionsetup| command (see \Section{usage}
-%^^A {Using the package}), but this time we get enlighten about
-%^^A its optional argument \meta{float type}.
-% Нам уже известна команда |\captionsetup| (см.~\Section{usage}
-% {Использование пакета}), Но сейчас мы разберём значение
-% дополнительного аргумента, \meta{float type}.
-%
-%^^A Remember, the syntax of this command is
-% Напомним синтаксис этой команды
-% \begin{quote}
-% |\captionsetup|\oarg{float type}\marg{options}\quad.
-% \end{quote}
-%
-%^^A If a \meta{float type} gets specified, all the \meta{options} don't
-%^^A change anything at this time. Instead they only get marked for a later use,
-%^^A when a caption inside of a floating environment of the particular type
-%^^A \meta{float type} gets typeset.
-%^^A For example
-% Если \meta{float type} задан, все ключи и~опции, \meta{options} ничего
-% не изменят в~месте задания. Они только определены для будущего использования,
-% в~момент, когда подпись внутри окружения флота данного типа,
-% \meta{float type}, будет напечатана.
-% Например
-% \begin{quote}
-% |\captionsetup[figure]|\marg{options}
-% \end{quote}
-%^^A forces captions within a |figure| environment to use the given \meta{options}.
-% определяет оформление \meta{options} для подписи внутри окружения |figure|.
-%
-%^^A Here comes an example to illustrate this:
-% Далее идёт пример иллюстрирующий сказанное:
-% \begin{quote}
-% |\captionsetup{font=small}|\\
-% |\captionsetup[figure]{labelfont=bf}|
-% \end{quote}
-%^^A gives captions like this:
-% создаст подписи вида:
-% \begin{Example}
-% \captionsetup{font=small}
-% \captionsetup[figure]{labelfont=bf}
-% \captionof{figure}[]{Картинка}
-% \captionsetup{belowskip=\abovecaptionskip}
-% \captionof{table}[]{Табличка}
-% \end{Example}
-%
-%^^A As you see the command |\captionsetup[figure]{labelfont=bf}| only changed
-%^^A the font of the figure caption labels, not touching all other ones.
-% Как вы видите установка |\captionsetup[figure]{labelfont=bf}| изменяет
-% только шрифт нумерационной части подписи, всё остальное остаётся.
-%
-% \DescribeMacro{\clearcaptionsetup}
-%^^A If you want to get rid of these parameters marked for an automatic use within
-%^^A a particular environment you can use the command
-% Если вам внутри данного окружения нужно отменить параметры, заданные для
-% текущего типа флота, используйте команду
-% \begin{quote}
-% |\clearcaptionsetup|\marg{float type}\quad.
-% \end{quote}
-%
-%^^A For example |\clearcaptionsetup{figure}| would clear the extra handling in the
-%^^A example above:
-% Например |\clearcaptionsetup{figure}| отменит дополнительные настройки
-% из примера выше:
-% \begin{Example}
-% \captionsetup{font=small}
-% \captionof{figure}[]{Картика}
-% \captionsetup{belowskip=\abovecaptionskip}
-% \captionof{table}[]{Табличка}
-% \end{Example}
-%
-%^^A As \meta{float type} you can usually give one of these two only:
-%^^A |figure| or |table|.
-%^^A But as we will see later some \LaTeX\ packages (like the
-%^^A \package{float}, \package{longtable}, and \package{sidecap} package
-%^^A for example) offer additional floating environments and these two
-%^^A commands can also be used with them.
-% В~качестве опции в~\meta{float type} вы можете обычно указывать два из них:
-% |figure| или |table|.
-% Но, как увидите позже, некоторые пакеты \LaTeX'а (как, например,
-% \package{float}, \package{longtable}, и~\package{sidecap})
-% определяют дополнительные окружения и~эти две команды могут быть
-% в~них использованы.
-%
-% \iffalse
+
+% \subsection{Lists}
+\subsection{Списки флотов}
+\label{lists}
+
+\DescribeMacro{list=}\label{TeXr:nolistentry:II}\NEWfeature{v3.1}%
+% The |\caption| command usually places an entry in the List of Figures
+% resp.~List of Tables. You can either suppress that individually by giving an
+% empty optional argument to |\caption| {\small(see \Ref{caption})}, or
+% programmatically by saying
+Команда |\caption| обычно помещает текст в~Список рисунков или Список таблиц.
+Вы можете запретить это, задав пустой дополнительный аргумент в~команде
+|\caption| {\small(см.~\Ref{caption})}, или задать общую установку, записав
+\begin{quote}
+% |list=no|\quad(or any other boolean value instead of |no|)\quad.~\footnote{%
+% Please note that the \package{subfig} package\cite{subfig} is not supporting
+% this option, it uses the counters \texttt{lofdepth} \& \texttt{lotdepth} for
+% this purpose instead.}
+ |list=no|\quad(или другое значение булева параметра вместо |no|)\quad.~\footnote{%
+ Обратите внимание, что пакет \package{subfig} package\cite{subfig} не поддерживает эту опцию,
+ он использует для этой цели счётчики \texttt{lofdepth} \& \texttt{lotdepth}.}
+\end{quote}
+
+\pagebreak[3]
+\DescribeMacro{listformat=}\NEWfeature{v3.1}%
+% With the option
+С~помощью ключа
+\nopagebreak[3]
+\begin{quote}
+ |listformat=|\meta{list format name}
+\end{quote}
+\nopagebreak[3]
+% you can specify how the |figure| or |table| number will be typeset within
+% the List of Figures resp.~List of Tables.
+% There are five standard caption list formats:
+вы можете определить как номер рисунка (|figure|) или таблицы (|table|) будут напечатаны
+в~Списке рисунков или Списке таблиц.
+Существуют пять стандартных форматов вывода подписей в~Списках:
+
+\begin{Options}{\OptionLabel}
+ \item[empty]
+% No number will be typeset.
+ Номер не печатается.
+
+ \item[simple]
+% The number will be typeset with label prefix.
+ Номер печатается с~префиксом метки.
+
+ \item[parens]
+% The number will be typeset in parentheses, with label prefix.
+ Номер печатается в~скобках с~префиксом метки.
+
+ \item[subsimple]
+% Same as |simple|, but without label prefix. (default)
+ То же, что |simple|, но без префикса. (задано по умолчанию)
+
+ \item[subparens]
+% Same as |parens|, but without label prefix.
+ То же, что |parens|, но без префикса.
+
+ \item[\UserDefined]
+% Own list formats can be defined using |\Declare|\-|Caption|\-|List|\-|Format|.
+% \SeeUserDefined
+ Собственные форматы метки в~Списках могут быть определены с~использованием команды |\Declare|\-|Caption|\-|List|\-|Format|.
+ \SeeUserDefined
+\end{Options}
+
+% The prefix ($=$|\p@figure| resp.~|\p@table|), which runs ahead of the
+% number ($=$|\the|\-|figure| resp.~|\the|\-|table|) in lists (e.g.~List of
+% Figure/Table) and references, is usually empty,
+% so the list formats |simple| and |subsimple| gives equal results;
+% same with |parens| and |subparens|.
+% But this can be different for sub-figures or sub-tables listed in the List of
+% Figures resp.~List of Tables, or when the label prefix is redefined for a
+% different purpose.\footnote{%
+% Sub-figures and sub-tables can be typeset using the \package{subcaption}
+% or \package{subfig} package.}
+Префиксы метки ($=$|\p@figure| или~|\p@table|), которые помещаются обычно
+перед номерами ($=$|\the|\-|figure| или~|\the|\-|table| соответственно)
+в~Списках (рисунков или таблиц) обычно пусты,
+поэтому форматы |simple| и~|subsimple| дадут одинаковый результат,
+то же самое произойдёт с~|parens|
+и~|subparens|.
+Но это может давать отличные результаты для подрисунков или подтаблиц
+помещённых в~Списке рисунков или Списке таблиц, или когда префикс метки переопределён
+для других целей.\footnote{%
+ Подписи для частей рисунков и~таблиц могут быть созданы
+ с~помощью пакетов \package{subcaption}
+ или \package{subfig}.}
+
% --------------------------------------------------------------------------- %
-% \fi
-%
-%
-%^^A \section{Do it yourself!}
-% \section{Делаем сами!}
-% \label{declare}
-%
-%^^A A family of commands is provided to allow users to define their own formats.
-%^^A This enables information on separators, justification, fonts, and styles to
-%^^A be associated with a name and kept in one place
-%^^A (these commands need to appear in the document preamble,
-%^^A this is the part between |\documentclass| and |\begin{document}|).
-% Имеется семейство команд, позволяющих пользователю самостоятельно
-% создать собственное оформление.
-% Это позволяет информацию о~разделителях, выключке, шрифтах, и~стилях
-% привязать к~определённому ключу, и~поместить всё это в~одном месте
-% (такие команды должны находиться в~преамбуле документа \cdash---
-% это часть между строками команд |\documentclass| и~|\begin{document}|).
-%
-%
-% \DescribeMacro{\DeclareCaptionFormat}
-%^^A You can define your own caption formats using the command
-% Вы можете определить своё оформление подписи, используя команду
-% \begin{quote}
-% |\DeclareCaptionFormat|\marg{name}\marg{code using \#1, \#2 and \#3}\quad.
-% \end{quote}
-%^^A At usage the system replaces \#1 with the caption label, \#2 with the
-%^^A separator and \#3 with the text. So the standard format |plain| is
-%^^A pre-defined by the \thispackage\ package as
-% При использовании пакет заменяет \#1 на нумерационный заголовок, \#2 на
-% разделитель и~\#3 на текст подписи. Итак, стандартный формат |plain| определён
-% внутри пакета \thispackage\ как
-% \begin{quote}
-% |\DeclareCaptionFormat{plain}{#1#2#3\par}|
-% \end{quote}
-%
-% \DescribeMacro{\DeclareCaptionLabelFormat}
-%^^A Likewise you can define your own caption label formats:
-% Аналогично вы можете определить формат нумерационного заголовка:
-% \begin{quote}
-% |\DeclareCaptionLabelFormat|\marg{name}\marg{code using \#1 and \#2}
-% \end{quote}
-%^^A At usage \#1 gets replaced with the name (e.g. ``figure'') and \#2
-%^^A gets replaced with the reference number (e.g. ``12'').
-% При использовании \#1 заменяется на имя флота (например. «Рис.») и~\#2
-% заменяется на порядковый номер (например «12»).
-%
-% \DescribeMacro{\bothIfFirst}
-% \DescribeMacro{\bothIfSecond}
-%^^A If you define your own caption label formats and use the \package{subfig}
-%^^A package\cite{subfig}, you should take care of empty caption label names.
-%^^A For this purpose the commands
-% Когда вы определяете своё оформление нумерационного заголовка и~используете
-% также пакет \package{subfig}, вы должны помнить что в~подфлотах элемент
-% «имя флота» будет пустым. Для этой цели следующие команды
-% \begin{quote}
-% |\bothIfFirst|\marg{first arg}\marg{second arg}\quad и\\
-% |\bothIfSecond|\marg{first arg}\marg{second arg}
-% \end{quote}
-%^^A are offered. |\bothIfFirst| tests if the first argument exists (means: is
-%^^A not empty), |\bothIfSecond| tests if the second argument exists. If yes,
-%^^A both arguments get typeset, otherwise none of them.
-% и~предложены. Команда |\bothIfFirst| тестирует наличие первого аргумента (что он
-% непустой), команда |\bothIfSecond| тестирует наличие второго. Если тестируемый
-% аргумент есть, то печатаются оба аргумента, в~противном случае ни одного.
-%
-%^^A For example the standard label format |simple| is \emph{not} defined as
-% Например, стандартное оформление нумерации |simple| определено не так:
-% \begin{quote}
-% |\DeclareCaptionLabelFormat{simple}{#1 #2}|\quad,
-% \end{quote}
-%^^A because this could cause an extra space if \#1 is empty. Instead |simple|
-%^^A is defined as
-% поскольку аргумент \#1 может быть пустым. Вместо этого |simple|
-% определён следующим образом
-% \begin{quote}
-% |\DeclareCaptionLabelFormat{simple}{\bothIfFirst{#1}{ }#2}|\quad,
-% \end{quote}
-%^^A causing the space to appear only if the label name is present.
-% в~результате пробел появится только тогда, когда есть имя нумерационного
-% заголовка.
-%
-%
-% \DescribeMacro{\DeclareCaptionLabelSeparator}
-%^^A You can define your own caption label separators with
-% Можно определить свой разделитель номера и~текста подписи с~помощью
-% команды
-% \begin{quote}
-% |\DeclareCaptionLabelSeparator|\marg{name}\marg{code}\quad.
-% \end{quote}
-% \nopagebreak[3]
-%^^A Again an easy example taken from the \thispackage\ package itself:
-% И~опять простой пример из самого пакета \thispackage:
-% \nopagebreak[3]
-% \begin{quote}
-% |\DeclareCaptionLabelSeparator{colon}{: }|
-% \end{quote}
-%
-%
-% \DescribeMacro{\DeclareCaptionJustification}
-%^^A You can define your own caption justifications with
-% Вы можете определить собственную выключку с~помощью команды
-% \begin{quote}
-% |\DeclareCaptionJustification|\marg{name}\marg{code}\quad.
-% \end{quote}
-%^^A The \meta{code} simply gets typeset just before the caption.
-%^^A E.g.~using the justification |raggedright|, which is defined as
-% Аргумент \meta{code} задаёт выключку до начала подписи.
-% Например использование выключки |raggedright|, которая определена как
-% \begin{quote}
-% |\DeclareCaptionJustification{raggedright}{\raggedright}|\quad,
-% \end{quote}
-%^^A lets captions with all lines moved to the left margin.
-% выключает все строки подписи к~левому полю.
-%
-% \DescribeMacro{\DeclareCaptionFont}
-%^^A You can define your own caption fonts with
-% Вы можете задать свой шрифт для подписи с~помощью
-% \begin{quote}
-% |\DeclareCaptionFont|\marg{name}\marg{code}\quad.
-% \end{quote}
-%^^A For example this package defines the options |small| and |bf| as
-% Например данный пакет определяет опции |small| и~|bf| как
-% \begin{quote}
-% |\DeclareCaptionFont{small}{\small}|\quad и\\
-% |\DeclareCaptionFont{bf}{\bfseries}|\quad.
-% \end{quote}
-%^^A The line spacing could be customized using the \package{setspace} package,
-%^^A for example:\NEWdescription{v3.0h}
-% Интерлиньяж может быть настроен с~помощью пакета \package{setspace},
-% например:\NEWdescription{v3.0h}
-% \begin{quote}
-% |\usepackage{setspace}|\\
-% \iffalse
-%^^A |\DeclareCaptionFont{singlespacing}{\setstretch{1}}|\quad\footnote{%
-%^^A \emph{Note:} Using \cs{singlespacing} does not work here since it contains
-%^^A a \cs{vskip} command.}\\
-% |\DeclareCaptionFont{singlespacing}{\setstretch{1}}|\quad\footnote{%
-% \emph{Примечание:} Использование \cs{singlespacing} в данном случае
-% не работает поскольку содержит команду \cs{vskip}.}\\
-% |\DeclareCaptionFont{onehalfspacing}{\onehalfspacing}|\\
-% |\DeclareCaptionFont{doublespacing}{\doublespacing}|\\
-% \fi
-% |\captionsetup{font={onehalfspacing,small},labelfont=bf}|
-% \end{quote}
-% \example{font={onehalfspacing,small},labelfont=bf,singlelinecheck=off}\figuretext
-%^^A An example which brings color into life:
-% Пример использования цвета:
-% \begin{quote}
-% |\usepackage{color}|\\
-% |\DeclareCaptionFont{red}{\color{red}}|\\
-% |\DeclareCaptionFont{green}{\color{green}}|\\
-% |\DeclareCaptionFont{blue}{\color{blue}}|\\
-% |\captionsetup{labelfont=blue,textfont=green}|
-% \end{quote}
-% \example{labelfont=blue,textfont=green,singlelinecheck=off}\figuretext
-%
-% \DescribeMacro{\DeclareCaptionStyle}
-%^^A You can define your own caption styles with
-% Вы можете определить свои собственные стили с~помощью
-% \begin{quote}
-% |\DeclareCaptionStyle|\marg{name}\oarg{additional options}\marg{options}
-% \end{quote}
-%^^A Remember, caption styles are just a collection of suitable options, saved
-%^^A under a given name. You can wake up these options at any time with the
-%^^A option |style=|\meta{style name}.
-% Вспомним, что стили подписи это коллекция ключей, сохранённых
-% под данным именем. Вы можете привести их в~действие с~помощью ключа
-% |style=|\meta{style name}.
-%
-%^^A All caption styles are based on the default set of options. (See \Section
-%^^A {style}{Styles} for a complete list.) So you only need
-%^^A to specify options which are different to them.
-% Все стили подписей базируются на установках по умолчанию. (См. полный список
-% в~\Section {style}{Стили}.) Поэтому достаточно определить опции, отличные
-% от уже заданных.
-%
-%^^A If you specify \meta{additional options} they get used in addition when
-%^^A the caption fits into a single line and this check was not disabled with
-%^^A the option |singlelinecheck=off|.
-% Если вы определите \meta{additional options} они будут использоваться когда
-% подпись будет однострочной, и~контроль коротких подписей не отключен
-% заданием опции |singlelinecheck=off|.
-%
-%^^A Again a very easy example taken from the core of this package: The
-%^^A caption style |default| is pre-defined as
-% Опять же очень простой пример из самого |caption.sty|:
-% \begin{quote}
-% |\DeclareCaptionStyle{default}[justification=centering]{}|
-% \end{quote}
-%
-% \iffalse
+
+% \subsection{Names \& Numbering}
+\subsection{Наименования и~нумерация}
+\label{names}\label{numbering}
+
+\DescribeMacro{figurename=}
+\DescribeMacro{tablename=}\NEWfeature{v3.0l}%
+% You can change the name of the figures and tables with the options
+Вы можете изменить название рисунка и~таблицы с~помощью ключей
+\begin{quote}\begin{tabular}{@{}r@{}l@{\quad}l@{}}
+ |figurename=| & \meta{name} & и\\
+ |tablename=| & \meta{name} & .\\
+\end{tabular}\end{quote}
+% The document class usually sets them to ``Figure'' and ``Table'', but for
+% example with
+Класс документа определяет их обычно как «Figure» и~«Table», но если
+вы зададите, например
+\begin{quote}
+ |figurename=Fig.|
+\end{quote}
+% you can change the figure name to ``Fig''.
+вы измените имя рисунка на «Fig».
+
+\smallskip\INFO
+% If you use the \package{babel} package, please load \thispackage\ \emph{after}
+% the \package{babel} package.
+Если вы пользуетесь пакетом \package{babel}, загружайте \thispackage\ \emph{после}
+пакета \package{babel}.
+
+\medskip
+
+\pagebreak[3]
+\DescribeMacro{name=}\NEWfeature{v3.1f}%
+% In contrast to the options |figure|\-|name| and |table|\-|name| the option
+В~отличие от опций |figure|\-|name=| и~|table|\-|name=| опция
+\emph{данного} окружения с~помощью ключа
+\begin{quote}
+ |name=|\meta{name}\quad.
+\end{quote}
+% changes the name of the \emph{current} environment.
+% This could be useful in conjunction with the optional argument of
+% |\caption|\-|setup|, e.g.
+изменяет имя текущей метки текущего окружения.
+Это может быть полезным при использовании дополнительного аргумента в~команде
+|\caption|\-|setup|, например задание
+\begin{quote}
+ |\captionsetup[wrapfigure]{name=Fig.}|
+\end{quote}
+% changes the name to ``Fig.'' for all |wrap|\-|figure|s (while all the other
+% figure captions will still have ``Figure'' as name).
+изменяет имя рисунка на «Fig.» для всех окружений |wrap|\-|figure| (в~то время как подписи
+у~других окружений рисунков остаются «Figure»).
+
+\medskip
+
+\pagebreak[3]%
+\DescribeMacro{listfigurename=}
+\DescribeMacro{listtablename=}\NEWfeature{v3.1g}%
+% Analogous to the options |figure|\-|name| and |table|\-|name| you can change
+% the title of the lists here. So for example
+Аналогично опциям |figure|\-|name| и~|table|\-|name| вы можете изменить
+заголовок для списков флотов. Так например
+\begin{quote}
+ |listfigurename=List of Images|
+\end{quote}
+% changes the title ``List of Figures'' to ``List of images''.
+Изменит заголовок «List of Figures» на «List of Images».
+
+[Или, если для русской литературы вы зададите:
+\begin{quote}
+ |listfigurename=\CYRS\cyrp\cyri\cyrs\cyro\cyrk\ |\\ |\cyri\cyrl\cyrl\cyryu\cyrs\cyrt\cyrr\cyra\cyrc\cyri\cyrishrt|
+\end{quote}
+или
+\begin{quote}\def\ttdefault{cmtt}
+ |listfigurename=Список иллюстраций|
+\end{quote}
+превратит заголовок в~«Список иллюстраций».]
+
+\bigskip
+
+\pagebreak[3]
+\DescribeMacro{figurewithin=}
+\DescribeMacro{tablewithin=}\NEWfeature{v3.1f}%
+% If a document class providing |\chapter| is used (e.g.~\class{report} or
+% \class{book}), usually the |figure| and |table| caption counters
+% are dependent on the |chapter| counter. Otherwise usually the |figure| and
+% |table| counters are continuous throughout the document.
+Если класс документа задаёт главы, и~используется команда |\chapter|
+(например \package{report} или
+\package{book}), то нумерация счётчиков подписей |figure| и~|table|
+подчинена счётчику главы |chapter|. В~противном случае нумерация |figure|
+и~|table| продолжается по всему документу.
+
+% This can be changed with the options
+Это может быть изменено с~помощью опции
+\begin{quote}\begin{tabular}{r@{}l}
+ |figurewithin=| & \texttt{chapter} \emph{или} \texttt{section} \emph{или} \texttt{none}\quad и\\
+ |tablewithin=| & \texttt{chapter} \emph{или} \texttt{section} \emph{или} \texttt{none}\quad .\\
+\end{tabular}\end{quote}
+% If ``|none|'' is given as value, the numbering of figures resp. tables will
+% be continuous throughout the document.
+% Otherwise the numbering will be dependent on the given counter,
+% e.g.~|figure|\-|within=|\x|section| gives figures a section-dependent
+% numbering scheme.
+Если задана опция «|none|», нумерация рисунков и~таблиц будет сквозной во
+всём документе.
+В~противном случае нумерация будет подчинена заданному счётчику,
+например, |figurewithin=|\x|section| создаст нумерацию рисунков,
+подчинённую заголовкам разделов
+первого уровня.
+
+\bigskip
+
+\begin{Expert*}
+% The name and numbering is internally done by the commands
+% |\|\meta{type}|name| \& |\the|\meta{type}, e.g.~|\figure|\-|name| \&
+% |\the|\-|figure| for figures.
+% While usually using the above options are sufficient, sometimes a direct
+% re-definition of these two macros is necessary. For example:
+Название и~нумерация определяются командами |\|\meta{type}|name|
+и~|\the|\meta{type}, например |\figurename| и~|\thefigure| для рисунков.
+Хотя задание ключей, описываемых выше достаточно, иногда необходимо
+прямое переопределение этих двух команд. Например:
+\begin{quote}
+ |\captionsetup{figurewithin=section}|\\
+ |\renewcommand\thefigure{\arabic{section}\alph{figure}}|
+\end{quote}
+% gives you a section-dependent numbering scheme \meta{section}\meta{figure}
+% with a numerical section counter and a alphanumerical figure counter,
+% e.g.~``|Figure 2b|''.
+даст вам подчинённую разделу схему нумерации \meta{section}\meta{figure}
+где номер раздела задан в~виде арабской цифры, а~номер рисунка \cdash--- в~виде нумерации буквами,
+например, «|Figure 2b|».
+\end{Expert*}
+
% --------------------------------------------------------------------------- %
-% \fi
-%
-%^^A \subsection{Further Examples}
-% \subsection{Ещё несколько примеров}
-%
-%^^A If you would like to have a colon \emph{and} a line break as caption
-%^^A separator you could define it this way:
-% Если вам нужно точка и новая строка как разделитель между номером и~текстом
-% определите это так:
-% \begin{quote}
-% |\DeclareCaptionLabelSeparator{period-newline}{. \\}|
-% \end{quote}
-%^^A Selecting this separator with |\captionsetup{labelsep=period-newline}| you
-%^^A get captions like this:
-% Задав этот разделитель как |\captionsetup{labelsep=period-newline}| вы
-% получите следующую подпись:
-% \begin{Example}
-% \captionsetup{labelsep=period-newline,labelfont=bf,margin=10pt}
-% \captionsetup{aboveskip=0pt,type=figure}
-% \caption[]{\figuretext}
-% \end{Example}
-%
-%^^A For short captions---which fit into one single line---this separator
-%^^A may not be satisfying, even when the automatically centering process
-%^^A is switched off (with |singlelinecheck=off|):
-% Для кратких подписей \cdash--- которые помещаются на одной строке \cdash--- такой
-% разделитель не годится, даже если отменено автоматическое центрирование
-% (с~помощью |singlelinecheck=off|):
-% \begin{Example}
-% \captionsetup{labelsep=period-newline,labelfont=bf,margin=10pt,singlelinecheck=0}
-% \captionsetup{aboveskip=0pt,type=figure}
-% \caption[]{Картинка.}
-% \end{Example}
-%
-%^^A An own caption style which selects another caption separator automatically
-%^^A puts this right:
-% Специальный стиль, который определяет другой разделитель автоматически
-% возвращает всё на места:
-% \begin{quote}
-% |\DeclareCaptionStyle{period-newline}%|\\
-% | [labelsep=period]{labelsep=period-newline}|
-% \end{quote}
-% \begin{Example}
-% \captionsetup{style=period-newline,labelfont=bf,margin=10pt}
-% \captionsetup{aboveskip=0pt,type=figure}
-% \ContinuedFloat
-% \caption[]{Картинка.}
-% \end{Example}
-%^^A If you would like to keep the centering of these captions instead, an
-%^^A appropriate definition would be something like
-% Если вы предпочтёте оставить центрирование короткой строки
-% нужно определить
-% \begin{quote}
-% |\DeclareCaptionStyle{period-newline}%|\\
-% | [labelsep=period,justification=centering]%|\\
-% | {labelsep=period-newline}|\quad.
-% \end{quote}
-%^^A Using this definition short captions look like
-% При этом определении короткие подписи будут выглядеть так
-% \begin{Example}
-% \captionsetup{style=period-newline2,labelfont=bf,margin=10pt}
-% \captionsetup{aboveskip=0pt,type=figure}
-% \ContinuedFloat
-% \caption[]{Картинка.}
-% \end{Example}
-%^^A while long ones still have a line break after the caption label.
-% в~то же время длинные подписи сохранят разрыв после номера флота.
-%
-%^^A Slightly changed, you also get centered captions if they are longer than
-%^^A one line:
-% Чуть изменив стиль, вы получите и~длинные подписи центрированными:
-% \begin{quote}
-% |\DeclareCaptionStyle{period-newline}%|\\
-% | [labelsep=period]%|\\
-% | {labelsep=period-newline,justification=centering}|
-% \end{quote}
-% \begin{Example}
-% \captionsetup{style=period-newline3,labelfont=bf,margin=10pt}
-% \captionsetup{aboveskip=0pt,type=figure}
-% \caption[]{\figuretext}
-% \end{Example}
-%
-% \bigskip
-%^^A Another example: You want captions to look like this:
-% Другой пример: вы хотите получить такие подписи:
-% \begin{Example}
-% \captionsetup{format=reverse,labelformat=fullparens,labelsep=fill,font=small,labelfont=it}
-% \captionsetup{aboveskip=0pt}
-% \captionof{figure}[]{\figuretext}
-% \end{Example}
-% \pagebreak[2]
-%^^A You could do it this way:
-% Вы должны задать их следующим образом:
-% \nopagebreak[3]
-% {\leftmargini=10pt
-% \begin{quote}
-% |\DeclareCaptionFormat{reverse}{#3#2#1}|\\
-% |\DeclareCaptionLabelFormat{fullparens}{(\bothIfFirst{#1}{ }#2)}|\\
-% |\DeclareCaptionLabelSeparator{fill}{\hfill}|\\
-% |\captionsetup{format=reverse,labelformat=fullparens,|\\
-% | labelsep=fill,font=small,labelfont=it}|
-% \end{quote}}
-%
-% \bigskip\pagebreak[3]
-%^^A Another example: The caption text should go into the left margin; a possible
-%^^A solution would be:
-% Ещё пример: поместить нумерационный заголовок подписи на левом поле; возможное решение:
-% {\leftmargini=10pt
-% \begin{quote}
-% |\DeclareCaptionFormat{llap}{\llap{#1#2}#3\par}|\\
-% |\captionsetup{format=llap,labelsep=quad,singlelinecheck=no}|
-% \end{quote}}
-%^^A As a result you would get captions like this:
-% В~результате вы получите такую подпись:
-% \begin{Example}
-% \captionsetup{format=llap,singlelinecheck=no,labelsep=quad}
-% \captionsetup{aboveskip=0pt}
-% \captionof{figure}[]{\figuretext}
-% \end{Example}
-%
-% \iffalse
+
+% \subsection{Types}
+\subsection{Типы (флотов)}
+\label{types}
+
+\DescribeMacro{type=}\NEWfeature{v3.0d}%
+% The |\caption| command can typeset captions for different types,
+% e.g.~|figure| and |table|. If you try to use the |\caption| command outside
+% these environments you will get an error message, because it does not know what
+% kind of caption do you want to have here. But in such situations you can set
+% the caption type manually with
+Команда |\caption| может создать подписи различных типов,
+например, |figure| и~|table|. Если вы попробуете задать команду |\caption| за пределами
+этих окружений, то получите сообщение об ошибке, поскольку эта команда не знает
+какой тип подписи вы хотите здесь создать. Но в~подобных ситуациях
+вы можете задать тип подписи вручную, используя
+\begin{quote}
+ |type=|\meta{float type}
+\end{quote}
+% prior to the usage of the |\caption| command (and other commands like
+% |\Continued|\-|Float|, or |\sub|\-|caption|\-|box| offered by the
+% \package{subcaption} package, or |\sub|\-|float| offered by the
+% \package{subfig} package\cite{subfig}),
+% for example within an non-floating environment like |minipage|:
+перед использованием команды |\caption| (и~других команд типа
+|\Continued|\-|Float|, или |\sub|\-|caption|\-|box| предлагаемой пакетом
+ \package{subcaption} или |\subfloat| предлагаемой пакетом \package{subfig}\cite{subfig}),
+например внутри неплавающего окружения вроде |minipage|:
+\begin{quote}
+ |\noindent\begin{minipage}{\textwidth}|\\
+ | \captionsetup{type=figure}|\\
+ | \subfloat{|\ldots|}|\\
+ | |\ldots\\
+ | \caption{|\ldots|}|\\
+ |\end{minipage}|
+\end{quote}
+
+\begin{Expert}
+% There is also a starred variant of this option, |type*=|\meta{float type},
+% which behaves different than |type=|\meta{float type} if the
+% \package{hyperref} package\cite{hyperref} is loaded: While |type=| sets an
+% hyperlink anchor (if |hypcap=|\x|true| is set), |type*=| does not.
+% (See also \Ref{hyperref}\,)
+Существует звёздный вариант этого ключа, |type*=|\x\meta{float type},
+который отличается от |type=|\x\meta{float type} если загружен пакет
+\package{hyperref}\cite{hyperref}: в~то время как ключ |type=| задаёт
+метку гиперссылки (hyperlink anchor, если задан ключ |hypcap=|\x|true|), ключ |type*=| этого не делает.
+(См.~также \Ref{hyperref})
+\end{Expert}
+\begin{Expert}
+% \emph{\DefaultNoteText:} Please don't re-define the internal macro |\@captype|
+% for yourself, like suggested by some documentations, always use
+% |\caption|\-|setup{type=|\x\ldots|}| instead.
+\emph{\DefaultNoteText}: не переопределяйте, пожалуйста, внутреннюю макрокоманду |\@captype|,
+как предлагается некоторыми руководствами или документами пакетов, для
+этого используйте всегда
+|\caption|\-|setup{type=|\x\ldots|}|.
+\end{Expert}
+
+\medskip
+
+% Own float types can be defined with |\Declare|\-|Caption|\-|Type| offered by
+% this package, |\new|\-|float| offered by the \package{float}
+% package\cite{float}, or |\Declare|\-|New|\-|Float|\-|Type| offered by the
+% \package{floatrow} package\cite{float}.
+Собственные типы флотов могут быть определены с~помощью команды |\Declare|\-|Caption|\-|Type|
+предлагаемой этим пакетом, командой |\new|\-|float|, предлагаемой пакетом \package{float}\cite{float},
+или |\Declare|\-|New|\-|Float|\-|Type| предлагаемой пакетом
+\package{floatrow}\cite{floatrow}.
+
+\medskip
+
+\INFO % \NEWdescription{v3.1}
+% Please note that you should use the option |type=| only
+% \emph{inside} boxes or environments (like |\par|\-|box| or |mini|\-|page|),
+% at best one where no page break could happen between contents and caption.
+% Furthermore some visual side-effects (e.g.~mixed-up figure and table settings
+% regarding captions) could occur without using a box or environment,
+% therefore a warning message will be issued if you try to do so.\footnote{%
+% You only get this warning message if you use \eTeX\ as underlying \TeX\ engine.}
+Обратите внимание, что лучше использовать ключ |type=| только
+\emph{внутри} боксов или таких окружений (типа |\parbox| или |minipage|), т.\,е.
+где не может произойти перехода на следующую страницу между подписью и~содержимым флота.
+Помимо этого возможны некоторые побочные эффекты (например, смешение настроек для подписей
+рисунков и~таблиц) если не используется бокс или окружение, кроме этого
+вы получите предупреждение, если попробуете это сделать.\footnote{%
+Вы получите это предупреждение только в~случае, когда в~качестве компилятора \TeX'а используется
+\eTeX.}
+
+
% --------------------------------------------------------------------------- %
-% \fi
-%
-% \pagebreak[1]
-%^^A \section{Using non-standard document classes}
-% \section{Использование нестандартных классов документа}
-%
-% \NEWdescription{v3.0p}
-%^^A% The \thispackage\ package was developed using the standard document classes
-%^^A% |article|, |report| and |book|, it also works with the Dutch document classes
-%^^A% |artikel|, |rapport| and |boek|. It is \emph{incompatible} with all other
-%^^A% document classes, except the ones based on one of the above.
-% Пакет \thispackage\nopagebreak\ настроен на использование со стандартными классами
-% |article|, |report| и~|book|, он также работает с~классами для немецких публикаций
-% |artikel|, |rapport| и~|boek|.
-%
-%^^A% If you are unsure if your document class is supported or not, it's better
-%^^A% \emph{not} to use this package. You could try if your document will compile
-%^^A% fine with the \thispackage\ package anyway, but you should watch carefully
-%^^A% if side-effects occur, i.e. the look and feel of your captions should
-%^^A% \emph{not} change if you just include the caption package without options.
-%^^A% (If it does, you can carry on, but you should be warned that the output
-%^^A% could change with upcoming versions of the \thispackage\ package.)
-%^^A% If this is fine, you can start setting options with
-%^^A% |\usepackage[|\ldots|]{caption}| or |\captionsetup| and keep your fingers
-%^^A% crossed.
-% Если вы не уверены поддерживается ли ваш класс документа или нет,
-% лучше данный пакет не использовать. Вы в~любом случае можете попробовать
-% обработать свой документ с~пакетом \thispackage, но в~этом случае внимательно
-% проверьте, есть ли побочные эффекты, т.\,е. при подключённом без опций пакете
-% и~без него вид подрисуночных подписей \emph{не} должен меняться.
-% (Если это происходит, можете продолжить, но знайте, что следующие версии
-% пакета \thispackage\ могут изменить вывод вашего документа.)
-% Если всё прекрасно, можно теперь задать опции, используя
-% |\usepackage[|\ldots|]{caption}| или |\captionsetup| и~надеяться на лучшее.
-%
-%^^A% The upcoming version \version{3.1} of the \thispackage\ package will be
-%^^A% adapted to several document classes, e.g. the \package{beamer} class and
-%^^A% the \KOMAScript\ ones. It's planned for release during Summer 2007.
-% Следующая версия \version{3.1} пакета \thispackage\ будет работать с~такими классами,
-% как \package{beamer} и~классы \KOMAScript. Выход версии планируется на лето 2007\,г.
-%
+
+\clearpage
+% \section{Commands}
+\section{Команды}
+
+% \subsection{Typesetting captions}
+\subsection{Печать подрисуночных подписей}
+\label{caption}
+\label{captionlistentry}
+
+\DescribeMacro{\caption}
+% The command
+Команда
+\begin{quote}
+ |\caption|\oarg{list entry}\marg{heading}
+\end{quote}
+% typesets the caption inside a floating environment like |figure| or |table|.
+% Well, you already know this, but \thispackage\ offers an extension:
+% If you leave the argument \meta{list entry} empty, no entry in the list of
+% figures or tables will be made. For example:
+печатает подпись внутри окружения флота, типа |figure| или |table|.
+Так, это нам известно, но новость состоит в~том, что если
+задать аргумент \meta{list entry} пустым, подпись в~списке рисунков или
+таблиц не появится; например,
+\begin{quote}
+% |\caption[]{A figure without list entry.}|
+ |\caption[]{Подпись без записи в~списке рисунков.}|
+ \label{TeXr:nolistentry:I}%
+\end{quote}
+
+\begin{Expert}
+% Please remember that the \meta{heading} is a so-called \emph{moving} argument,
+% if no \meta{list entry} has been given. But if a \meta{list entry} is given,
+% this argument is moving instead.
+% ``\emph{Moving} argument'' means that the argument will be written to the
+% list-of file, make it appearing in the ``List of Figures'' resp.
+% ``List of Tables'', too.
+% \emph{Moving} arguments are not allowed to contain \emph{fragile} commands,
+% everything must be \emph{robust}, otherwise the argument could get
+% \emph{broken}, resulting in strange errors at the next \LaTeX\ run.
+% Some \emph{fragile} commands could be \emph{protected} by a leading |\protect|,
+% own definitions could get defined with |\Declare|\-|Robust|\-|Command| instead of
+% |\new|\-|command| to make them \emph{robust}.
+Напомним, что аргумент \meta{heading} будет \emph{подвижным},
+если не задан дополнительный аргумент \meta{list entry}. Если же задан \meta{list entry},
+то становится подвижным этот дополнительный аргумент. Термин «\emph{подвижный} аргумент»
+в~данном случае означает, что он записывается в~файле Списка, чтобы
+затем его вывести в~разделах «Список рисунков» или «Список таблиц».
+В~\emph{подвижные} аргументы нельзя помещать \emph{хрупкие} команды,
+все элементы должны быть \emph{неразбиваемыми} (нехрупкими), иначе аргумент будет
+«\emph{разбит}» (раскрыт), создавая странные ошибки в~следующих
+обработках \LaTeX'ом. Некоторые \emph{хрупкие}
+команды могут быть \emph{защищены} заданием перед ними команды |\protect|.
+Чтобы собственные
+определения были \emph{неразбиваемыми}, их нужно определять через |\DeclareRobustCommand|, а~не
+через |\newcommand|.
+
+% An example: |\caption{${}^{137}_{\phantom{1}55}$Cs}| will cause errors since
+% |\phantom| is \emph{fragile}.
+% So we have either have to use the optional argument \meta{list entry}
+% (e.g.~|\caption[${}^|\x|{137}_|\x|{55}$|\x|Cs]|\x|{${}^|\x|{137}_|\x|{\phantom{1}55}$|\x|Cs}|)
+% or add |\protect| to prevent the |\phantom| command from getting \emph{broken}:
+% |\caption{${}^|\x|{137}_|\x|{|\textcolor{blue}{\cs{protect}}|\phantom{1}55}$|\x|Cs}|.
+Пример: запись |\caption{${}^{137}_{\phantom{1}55}$Cs}| выдаст сообщения об ошибках,
+поскольку команда |\phantom| \emph{хрупкая}. Поэтому нужно либо задать дополнительный аргумент
+\meta{list entry}
+(например,
+|\caption[${}^|\x|{137}_|\x|{55}$|\x|Cs]|\x|{${}^|\x|{137}_|\x|{\phantom{1}55}$|\x|Cs}|)
+или добавить команду |\protect|, для защиты команды |\phantom| от того, чтобы она
+\emph{разбилась}:
+|\caption{${}^|\x|{137}_|\x|{|\textcolor{blue}{\cs{protect}}|\phantom{1}55}$|\x|Cs}|.
+
+% But sometimes even this is not sufficient. The reason behind is the so-called
+% single-line-check: It puts the \meta{heading} into a horizontal box to determine
+% the width of the caption, and this could cause error messages, too.
+% An example:
+% |\caption{A| |scheme.| |\[V_{C}| |\sim| |\left| |\{| |\begin{array}{cc}|
+% |E_{g}| |&| |\textrm{p-n}| |\\| |e\phi_{B}| |&| |\textrm{M-S}| |\end{array}|
+% |\right.| |\]}|.
+% Using |\caption[A| |scheme]{|\ldots|}| is not sufficient here, it's still
+% leading to errors. (``\texttt{Missing \$ inserted.}'')
+% So we have to put a |\caption|\-|setup{single|\-|line|\-|check=|\x|off}|
+% just in front of the |\caption| command additionally.
+Но иногда и~это не помогает. Причина кроется в~так называемой проверке
+на однострочную подпись
+(single-line-check): макрокоманда помещает содержимое аргумента \meta{heading}
+в~горизонтальный бокс,
+чтобы определить ширину подписи, и~это также может создать сообщения об ошибках.
+Пример:
+|\caption{A| |scheme.| |\[V_{C}| |\sim| |\left| |\{| |\begin{array}{cc}|
+|E_{g}| |&| |\textrm{p-n}| |\\| |e\phi_{B}| |&| |\textrm{M-S}| |\end{array}|
+|\right.| |\]}|.
+Использование |\caption[A| |scheme]{|\ldots|}| здесь не годится,
+это тоже приведёт к~ошибкам.
+(«\texttt{Missing \$ inserted.}») Поэтому мы вынуждены дополнительно задать
+|\captionsetup{singlelinecheck=off}| перед командой |\caption|.
+
+% For more information about \emph{moving} arguments and \emph{fragile} \&
+% \emph{robust} commands, take a closer look at your \LaTeX\ manual or visit
+% \url{http://www-h.eng.cam.ac.uk/help/tpl/textprocessing/teTeX/latex/latex2e-html/fragile.html}.
+Более полную информацию о~\emph{подвижных} аргументах и~\emph{хрупких}
+и~\emph{неразбиваемых} командах, смотрите в~вашем руководстве по \LaTeX'у или обратитесь к~%
+\url{http://www-h.eng.cam.ac.uk/help/tpl/textprocessing/teTeX/latex/latex2e-html/fragile.html}.
+\end{Expert}
+
+\medskip
+
+\pagebreak[3]
+\DescribeMacro{\caption*}\label{TeXr:starcaption:a}%
+% The \package{longtable} package defines the command |\caption*| which
+% typesets the caption without label and without entry in the list of tables.
+% An example:
+Пакет \package{longtable} определяет команду |\caption*| которая
+печатает подпись без метки и~занесения её в~список таблиц.
+Пример:
+\begin{quote}
+ |\begin{longtable}{|\ldots|}|\\
+ | \caption*{A table}\\|\\
+ | |\ldots\\
+ |\end{longtable}|
+\end{quote}
+% looks like
+выглядит следующим образом:\nopagebreak
+\DeleteShortVerb{\|}
+\vskip\intextsep
+\begin{minipage}{\linewidth}
+ \captionsetup{type=table,position=t}
+ \caption*{A table}
+ \centering
+ \begin{tabular}{r|rr}
+ & x & y \\\hline
+ a & 1 & 2 \\
+ b & 3 & 4 \\
+ \end{tabular}
+\end{minipage}
+\vskip\intextsep
+\MakeShortVerb{\|}
+% \Thispackage\ offers this feature, too, so you can use this command now within
+% every floating environment like |figure| or |table|, like:
+\Thispackage\ тоже предлагает такую возможность. И~теперь вы можете использовать эту команду
+с~любым окружением плавающего объекта, например |figure| или |table|, как здесь:
+\begin{quote}
+ |\begin{table}|\\
+ | \caption*{A table}|\\
+% | \begin{tabular}{|\ldots|}|\\
+% | |\ldots\\
+% | \end{tabular}|\\
+ | |\ldots\\
+ |\end{table}|
+\end{quote}
+
+\pagebreak[3]
+\DescribeMacro{\captionof}\label{TeXr:captionof:a}%
+\DescribeMacro{\captionof*}
+% Sometimes you want to typeset a caption \emph{outside} a floating environment,
+% putting a figure within a non-floating |mini|\-|page| for instance.
+% For this purpose \thispackage\ offers the command
+Иногда вам нужно создать подпись \emph{вне} окружения флота,
+поместив, к~примеру, подпись внутри окружения |minipage|. Для этой цели пакет
+\thispackage\ предлагает команду
+\begin{quote}
+ |\captionof|\marg{float type}\oarg{list entry}\marg{heading}\quad.
+\end{quote}
+% Note that the first argument, the \meta{float type}, is mandatory here, because
+% the |\captionof| command needs to know which name to put into the caption label
+% (e.g. ``Figure'' or ``Table'') and in which list to put the contents entry.
+% An example:
+Обратите внимание, что первый аргумент, \meta{float type}, в~данном случае является
+обязательным, поскольку команда |\captionof| должна знать, к~какому плавающему
+объекту создать подпись (например. «Рис.» или «Таблица») и~в~какой список флотов поместить
+подпись. Пример
+\begin{quote}
+% |\captionof{figure}{A figure}|\\
+ |\captionof{table}{A table}|
+\end{quote}
+% typesets captions like this:
+создаёт подписи как здесь:
+\begin{Example}
+% \begingroup
+% \captionof{figure}{A figure}
+% \endgroup
+ \captionsetup{position=top}
+% \begingroup
+ \captionof{table}{A table}
+% \endgroup
+\end{Example}
+
+% The star variant |\caption|\-|of*| has the same behavior as the |\caption*|
+% command:
+% It typesets the caption without label and without entry to the list of figures
+% or tables.
+«Звёздный» вариант |\captionof*| даёт тот же результат, что и~|\caption*|:
+печатает подпись без нумерационного заголовка и~вывода в~Список рисунков или
+таблиц.
+
+\INFO % \NEWdescription{v3.1}
+% Since |\caption|\-|of| uses the option |type| internally, the same
+% restrictions as for the |type| option apply here, so you should use both
+% |\caption|\-|of| and |\caption|\-|of*| only \emph{inside} boxes or
+% environments, too.
+Поскольку команда |\captionof| использует внутри себя ключ |type|, те же ограничения, что и~для
+ключа |type=| действуют здесь, поэтому вы можете использовать и~|\captionof|
+и~|\captionof*| только \emph{внутри} боксов или окружений.
+\See{\Ref{types}}
+
+\bigskip
+
+\pagebreak[3]
+\DescribeMacro{\captionlistentry}\NEWfeature{v3.1}%
+% Under certain circumstances it could be useful to make a list-of-figure
+% (or table) entry on its own.
+% This could be achieved with
+В~некоторых случаях может быть полезным создание текста для Списка рисунков (или таблиц) отдельно.
+Это можно сделать с~помощью
+\begin{quote}
+ |\captionlistentry|\oarg{float type}\marg{list entry}\quad.
+\end{quote}
+
+% One example: It's quite easy to have a |long|\-|table| with captions above the
+% contents and a single list entry which points to the first page of the table:
+Один пример: очень легко получить таблицу в~окружении |long|\-|table|
+с~подписями сверху таблицы
+и~одним вхождением в~Списке которое отмечает первую страницу таблицы:
+\begin{quote}
+ |\begin{longtable}{|\ldots|}|\\
+ | \caption{|\ldots|}\\|\\
+ |\endfirsthead|\\
+ | \caption[]{|\ldots|}\\|\\
+ |\endhead|\\
+ | |\ldots
+\end{quote}
+% But since the \package{longtable} package does not offer an
+% |\end|\-|first|\-|foot| command, you cannot easily have captions \emph{below}
+% the table contents and a single list entry which points to the first page of
+% the table.
+% Here is were the |\caption|\-|list|\-|entry| command could be used:
+Но, поскольку пакет \package{longtable} не предлагает команды |\endfirstfoot|,
+вы не можете использовать подписи \emph{снизу} таблицы, для создания единственного
+вхождения в~Список, который отмечает первую страницу таблицы.
+Это ситуация, где команда |\captionlistentry| может быть полезна:
+\begin{quote}
+ |\begin{longtable}{|\ldots|}|\\
+ | \caption[]{|\ldots|}\\|\\
+ |\endfoot|\\
+ | \captionlistentry{|\ldots|}|\\
+ | |\ldots
+\end{quote}
+\begin{Annotation*}
+% Another example can be found in \Ref{examples}.
+Другой пример можно найти в~\Ref{examples}.
+\end{Annotation*}
+
+\smallskip
+
+\begin{Expert}
+% There is also a starred variant, |\caption|\-|list|\-|entry*|, which does not
+% increment the \meta{float type} counter.
+% (Note that inside |long|\-|table| environments |\caption|\-|list|\-|entry|
+% never increments the |table| counter. See also \Ref{longtable}.)
+Также существует «звёздный» вариант |\caption|\-|list|\-|entry*|, который
+не увеличивает значение счётчика флота.
+(Обратите внимание, что внутри окружения |long|\-|table| команда |\caption|\-|list|\-|entry|
+никогда не увеличивает значения счётчика таблицы. См.~также описание \Ref{longtable}.)
+\end{Expert}
+
+\begin{Expert}
+% Please note that \meta{list entry} is a \emph{moving} argument, so everything
+% it contains must be \emph{robust}. (See also explanation of |\caption|)
+Обратите также внимание, что \meta{list entry} является \emph{подвижным}
+аргументом, поэтому всё его
+содержимое должно быть \emph{неразбиваемым}. (См.~также описание команды |\caption|)
+\end{Expert}
+
+
+% \subsection{Setting options}
+\subsection{Задание ключей и~опций}
+\label{captionsetup}
+
+\DescribeMacro{\captionsetup}
+% We already know the |\caption|\-|setup| command (see \Ref{usage}),
+% but this time we get enlighten about its optional argument
+% \meta{float type}.
+Нам уже известна команда |\captionsetup| (см.~\Ref{usage}),
+но сейчас мы разберём значение дополнительного аргумента, \meta{float type}.
+
+% Remember, the syntax of this command is
+Напомним синтаксис этой команды
+\begin{quote}
+ |\captionsetup|\oarg{float type}\marg{options}\quad.
+\end{quote}
+
+% If a \meta{float type} gets specified, all the \meta{options} don't
+% change anything at this time. Instead they only get marked for a later use,
+% when a caption inside of a floating environment of the particular type
+% \meta{float type} gets typeset.
+% For example
+Если \meta{float type} задан, все ключи и~опции, \meta{options} ничего
+не изменят в~месте задания. Они только определены для будущего использования
+в~момент, когда подпись окажется внутри окружения флота
+\meta{float type}.
+Например
+\begin{quote}
+ |\captionsetup[figure]|\marg{options}
+\end{quote}
+% forces captions within a |figure| environment to use the given \meta{options}.
+определяет оформление \meta{options} для подписи внутри окружения |figure|.
+
+% Here comes an example to illustrate this:
+Далее идёт пример иллюстрирующий сказанное:
+\begin{quote}
+ |\captionsetup{font=small}|\\
+ |\captionsetup[figure]{labelfont=bf,textfont=it}|
+\end{quote}
+% gives captions like this:
+создаст подписи вида:
+\begin{Example}
+ \captionsetup{font=small}
+ \captionsetup[figure]{labelfont=bf,textfont=it}
+ \begingroup
+ \captionof{figure}{A figure}
+ \endgroup
+ \captionsetup{position=top}
+ \begingroup
+ \captionof{table}{A table}
+ \endgroup
+\end{Example}
+% As you see the command |\caption|\-|setup[figure]{|\ldots|}| only changes
+% the look of the |figure| caption labels, not touching the other ones.
+Как вы видите установка |\caption|\-|setup[figure]{labelfont=bf}| изменяет
+только шрифт нумерационной части подписи, всё остальное остаётся.
+
+% As \meta{float type} you can usually give one of these two only:
+% |figure| or |table|.
+% But as we will see later some \LaTeX\ packages (like the \package{floatrow},
+% \package{longtable}, and \package{sidecap} package for example) and also
+% this package offer additional environments with captions and these two
+% commands can also be used with them.
+% \See{\Ref{declare} and \Ref{packages}}
+В~качестве \meta{float type} вы обычно задаёте только две опции:
+|figure| или |table|.
+Но как будет видно позднее некоторые пакеты \LaTeX'а (например \package{floatrow},
+\package{longtable} и~\package{sidecap}) а~также данный пакет
+предлагают дополнительные окружения с~подписями и~эти две команды
+могут быть с~ними использованы.
+\See{\Ref{declare} и~\Ref{packages}}
+
+\smallskip
+
+\pagebreak[3]
+\NEWfeature{v3.1}
+\begin{Expert}
+% There is also a starred variant of |\caption|\-|setup|:
+Существует и~звёздный вариант команды |\captionsetup|:
+\begin{quote}
+ |\captionsetup*|\oarg{float type}\marg{options}
+\end{quote}
+% While the non-starred variant can give you warnings---for example if the
+% \meta{options} are actually not used throughout the document
+% (e.g.~a |\caption|\-|setup[table]{font=|\x|sf}| without a |table|)---the
+% starred variant will not.
% \iffalse
-% --------------------------------------------------------------------------- %
+% This can get quite useful when setting generic options which are independent
+% of a specific document.
% \fi
-%
-%^^A \section{Compatibility to other packages}
-% \section{Совместимость с другими пакетами}
-% \label{packages}
-%
-%^^A The \thispackage\ package contains special adaptations to other packages,
-%^^A so the captions should always look like you have specified them to look like.
-% Пакет \thispackage\ содержит специальные адаптации с~другими пакетами,
-% также работающими с~подписями, поэтому подписи \emph{всегда} выглядят так,
-% как вы определили им настройки.
-%
-%^^A These are the packages the \thispackage\ package is adapted to:
-% Здесь приведены пакеты, которые адаптированы на совместное использование
-% с~\thispackage:
-%
-%^^A \begin{tabular}{ll}
-%^^A |float| & Gives you the possibility to define new floating environments\\
-%^^A |listings| & Typesets source code listings\\
-%^^A |longtable| & Typesets tables spanned over multiple pages\\
-%^^A |rotating| & Supports rotated figures and tables\\
-%^^A |sidecap| & Offers captions \emph{beside} figures or tables\\
-%^^A |supertabular| & Typesets tables spanned over multiple pages\\
-%^^A \end{tabular}
-% \begin{tabular}{ll}
-% |float| & Даёт возможность определить новое окружение флота \\
-% |listings| & Печатает исходные тексты программ\\
-% |longtable| & Печатает многостраничные таблицы\\
-% |rotating| & Поддерживает поворот рисунков и таблиц\\
-% |sidecap| & Предлагает окружения с подписями сбоку\\
-% |supertabular| & Печатает многостраничные таблицы [альтернатива |longtable|]\\
-% \end{tabular}
-%
-% \NEWfeature{v3.0b}
-%^^A If you use one of the above packages together with the {\thispackage} package
-%^^A you get the additional possibility to set up captions with
-% Если вы используете один из этих пакетов вместе с~пакетом {\thispackage}
-% вы получаете дополнительные возможности для настроек оформления с~помощью
-% \begin{quote}|\captionsetup|\oarg{environment}\marg{options}\quad,\end{quote}
-%^^A where \meta{environment} stands for any environment the above packages offer.
-%^^A (Please note that this do not work with the |sideways| environments offered by
-%^^A the \package{rotating} package.)
-%^^A For example
-% где \meta{environment} определяет окружения, заданные упомянутыми выше пакетами.
-% (Обратите внимание, что это не работает с~окружениями |sideways...| пакета
-% \package{rotating}.)
-% Например
-% \begin{quote}|\captionsetup[lstlisting]{labelfont=bf}|\end{quote}
-%^^A forces captions inside the |lstlisting| environment to have bold labels.
-% Задаёт подписям внутри окружения |lstlisting| полужирные нумерационные части.
-%
-%^^A If a certain support is not desired you can switch it off using the
-%^^A \thispackage\ package option
-% Если такая поддержка нежелательна вы можете задать соответствующую опцию
-% пакета \thispackage
-% \begin{quote}
-% |\usepackage[|\ldots|,|\meta{package}|=no]{caption}|\quad.
-% \end{quote}
-%^^A For example specifying the option |float=no| means you don't like the
-%^^A \thispackage\ package to support the \package{float} package.
-%^^A (Note: You can specify these options only within the |\usepackage| command,
-%^^A especially \emph{not} at a later time with |\captionsetup|.)
-% Например, задание опции |float=no| означает, что вы не хотите, чтобы пакет
-% \thispackage\ поддерживал пакет \package{float}. (Примечание:
-% вы можете определить эти опции только в~строке команды |\usepackage|,
-% тем более \emph{не} в~командах |\captionsetup|.)
-%
-%^^A For further information about the packages mentioned above please take a look
-%^^A at the documentation belonging to them or buy yourself
-%^^A The \LaTeX\ Companion\cite{companion}.
-% Для подробной информации о~пакетах, которые поддерживаются см. документацию
-% этих пакетов или в~книге The \LaTeX\ Companion\cite{companion}.
-%
-% \iffalse
+В~то время как незвёздный вариант даст вам предупреждение, если \meta{options} не
+использовались в~документе (например настройки |\captionsetup[table]{font=sf}| \cdash---
+и~ни одного окружения |table|), звёздный вариант этого не делает.
+\iffalse
+Это может быть очень полезно для создания настроек, независимых от конкретного документа.
+\fi
+\end{Expert}
+
+\medskip
+
+\pagebreak[3]
+\DescribeMacro{\clearcaptionsetup}
+% If you want to get rid of these parameters marked for an automatic use within
+% a particular environment you can use the command
+Если вам внутри данного окружения нужно отменить параметры, заданные для
+текущего типа флота, используйте команду
+\begin{quote}
+ |\clearcaptionsetup|\oarg{option}\marg{float type}\quad.
+\end{quote}
+
+% For example |\clearcaptionsetup{figure}| would clear all the extra handling
+% for figures in the example above:
+Например |\clearcaptionsetup{figure}| отменит дополнительные настройки
+из примера выше:
+\begin{quote}
+ |\captionsetup{font=small}|\\
+ |\captionsetup[figure]{labelfont=bf,textfont=it}|\\
+ \ldots\\
+ | \caption{A figure}|\\
+ \ldots\\
+ |\clearcaptionsetup{figure}|\\
+ \ldots\\
+ | \caption{A figure}|\\
+ \ldots\\
+\end{quote}
+\pagebreak[3]
+\begin{Example}
+ \captionsetup{font=small}
+ \captionsetup[figure]{labelfont=bf,textfont=it}
+ \begingroup
+ \captionof{figure}{A figure}
+ \endgroup
+ \captionsetup{position=top}
+ \clearcaptionsetup{figure}
+ \begingroup
+ \captionof{figure}{A figure}
+ \endgroup
+\end{Example}
+
+\pagebreak[3]
+\NEWfeature{v3.1}
+% If an optional argument \meta{option} is given, only the settings regarding
+% this particular \meta{option} are cleared.\footnote{You can only specify
+% \emph{one} option here, not a list of options.
+% If you want to clean more than one option, you need to use more than one
+% \cs{clear}\-\texttt{caption}\-\texttt{setup}.}
+% While the example above not only clears the options
+% |labelfont=bf,|\x|textfont=it|
+% for figures (but all options for figures instead),
+% this one would only clear the |labelfont=bf| setting, leaving all other
+% settings for figures intact:
+Если задан дополнительный аргумент \meta{option}, отменяются только настройки
+данной опции \meta{option}.\footnote{Вы можете задать только
+\emph{одну} опцию, а~не список опций.
+Если вам нужно отменить настройки для ряда опций, вам придётся использовать несколько команд
+\cs{clearcaptionsetup}.}
+В~то время как пример выше не только отменил опции ключей |labelfont=bf,|\allowbreak
+|textfont=it|
+для рисунков (но и~все опции для рисунков),
+следующий пример отменит только настройку |labelfont=bf|, оставив все остальные
+настройки нетронутыми:
+\begin{quote}
+ |\captionsetup{font=small}|\\
+ |\captionsetup[figure]{labelfont=bf,textfont=it}|\\
+ \ldots\\
+ | \caption{A figure}|\\
+ \ldots\\
+ |\clearcaptionsetup[labelfont]{figure}|\\
+ \ldots\\
+ | \caption{A figure}|\\
+ \ldots
+\end{quote}
+\begin{Example}
+ \captionsetup{font=small}
+ \captionsetup[figure]{labelfont=bf,textfont=it}
+ \begingroup
+ \captionof{figure}{A figure}
+ \endgroup
+ \captionsetup{position=top}
+ \clearcaptionsetup[labelfont]{figure}
+ \begingroup
+ \captionof{figure}{A figure}
+ \endgroup
+\end{Example}
+\begin{Expert}
+% Analogous to |\caption|\-|setup*| there is also a starred form
+% |\clear|\-|caption|\-|setup*| which suppresses warnings if the given
+% \meta{option} was not setup for the specified \meta{float type}.
+Аналогично команде |\captionsetup*| существует также звёздная форма
+|\clearcaptionsetup*| которая отменяет предупреждения, если \meta{option}
+не является настройкой для данного \meta{float type}.
+\end{Expert}
+
+\medskip
+
+\DescribeMacro{\showcaptionsetup}
+% For debugging purposes the command\nopagebreak
+Для возможностей настройки настроек, предложена команда\nopagebreak
+\begin{quote}
+ |\showcaptionsetup|\marg{float type}\quad.\nopagebreak[3]
+\end{quote}
+% is offered. It generates a log file entry, showing the given options
+% for the specified \meta{float type}. For example
+Она создаёт сообщение в~log-файле, показывая заданные опции
+для выбранного \meta{float type}. Например
+\begin{quote}
+ |\captionsetup[figure]{labelfont=bf,textfont=it}|\\
+ |\showcaptionsetup{figure}|
+\end{quote}
+% gives the info:
+даст сообщение:
+\begin{quote}\small
+ |Caption Info: Option list on `figure'|\\
+ |Caption Data: {labelfont=bf,textfont=it} on input line 5.|
+\end{quote}
+
+\pagebreak[3]
+% \subsection{Continued floats}
+\subsection{Продолжающиеся флоты}
+\label{ContinuedFloat}
+
+\DescribeMacro{\ContinuedFloat}\label{TeXr:continued:a}%
+% Sometimes you want to split figures or tables without giving them
+% their own reference number. This is what the command
+Иногда возникает необходимость разбить рисунки или таблицы на несколько
+частей, задав им общий номер. Для этого предназначена команда
+\begin{quote}
+ |\ContinuedFloat|\quad.
+\end{quote}
+% is for; it should be used as first command inside the floating environment.
+% It prevents the incrementation of the relevant counter (usually done by
+% |\caption|), so a figure or table containing a |\Continued|\-|Float| inside
+% gets the same reference number as the figure or table before.
+% An example:
+Лучше её поставить первой внутри окружения флота.
+Команда |\ContinuedFloat| отменяет увеличение соответствующего счётчика флота
+(используемого командой |\caption|)
+и~задаёт тот же номер как и~у~рисунка или таблицы выше. Пример
+\begin{quote}
+ |\begin{table}|\\
+ | \caption{A table}|\\
+ | |\ldots\\
+ |\end{table}|\\
+ \ldots\\
+ |\begin{table}\ContinuedFloat|\\
+ | \caption{A table (cont.)}|\\
+ | |\ldots\\
+ |\end{table}|
+\end{quote}
+% gives the following result:
+даст следующий результат:
+\begin{Example}
+ \captionsetup{type=table,position=b,skip=0pt}
+ \caption{A table}
+ \centerline{\ldots}
+ \ContinuedFloat
+ \caption{A table (cont.)}
+ \centerline{\ldots}
+\end{Example}
+
+\bigskip
+
+\NEWfeature{v3.1}
+% Furthermore the |\Continued|\-|Float| command executes options associated with
+% the type name ``|Continued|\-|Float|''. For example this can be used to switch
+% to a different label format for continued figures or tables, as shown here:
+Помимо этого команда |\Continued|\-|Float| включает опции, связанные
+с~соответствующей опцией"=типом «|Continued|\-|Float|». Например, это может быть использовано для
+создания альтернативных форматов меток для таблиц и~рисунков, как показано здесь:
+\begin{quote}
+ |\DeclareCaptionLabelFormat{continued}{Continued #1~#2}|\\
+ |\captionsetup[ContinuedFloat]{labelformat=continued}|\\
+ \ldots\\
+ |\begin{table}\ContinuedFloat|\\
+ | \caption{A table}|\\
+ | |\ldots\\
+ |\end{table}|
+\end{quote}
+\begin{Example}\selectlanguage{USenglish}
+ \captionsetup{type=table,position=b,skip=0pt}
+ \captionsetup[ContinuedFloat]{labelformat=continued1e}
+ \ContinuedFloat
+ \caption{A table}\label{continued1e}
+ \centerline{\ldots}
+\end{Example}
+В~русской документации это может выглядеть так:
+\begin{quote}
+ |\DeclareCaptionLabelFormat{continued}{#1~#2 (\textit{продолжение})}|\\
+ |\captionsetup[ContinuedFloat]{labelformat=continued}|\\
+ \ldots\\
+ |\begin{table}\ContinuedFloat|\\
+ | \caption{A table}|\\
+ | |\ldots\\
+ |\end{table}|
+\end{quote}
+\begin{Example}
+ \captionsetup{type=table,position=b,skip=0pt}
+ \captionsetup[ContinuedFloat]{labelformat=continued1r}
+ \ContinuedFloat
+ \caption{A table}\label{continued1r}
+ \centerline{\ldots}
+\end{Example}
+\smallskip
+% \See{\Ref{declare} for an explanation of
+% \cs{Declare}\-\texttt{Caption}\-\texttt{Label}\-\texttt{Format}.}
+\See{\Ref{declare} описывающий
+ \cs{Declare}\-\texttt{Caption}\-\texttt{Label}\-\texttt{Format}.}
+
+\medskip
+
+% There is also a \LaTeX\ counter called |Continued|\-|Float| which could be
+% used for own purposes.
+% For ordinary (floating) environments it's set to zero, to one for the first
+% continued float, to two inside the second one, and so on.
+% So every |\Continued|\-|Float| increments this counter and a floating
+% environment without |\Continued|\-|Float| command resets this counter to zero.
+% An example:
+Создан также счётчик \LaTeX'а, названный |Continued|\-|Float|, который может быть
+использован при необходимости.
+В~обычных окружениях плавающих объектов он равен нулю, в~первом продолжающемся
+флоте он равен единице, в~следующем для второго окружения и~т.\,д.
+Так, каждая команда |\Continued|\-|Float| увеличивает этот счётчик и~плавающий объект
+без команды |\Continued|\-|Float| вновь обнуляет этот счётчик.
+Пример:
+\begin{quote}
+ |\DeclareCaptionLabelFormat{cont}{#1~#2\asbuk{ContinuedFloat}}|\\
+ |\captionsetup[ContinuedFloat]{labelformat=cont}|\\
+ \ldots\\
+ |\begin{table}\ContinuedFloat|\\
+ | \caption{A table}|\\
+ | |\ldots\\
+ |\end{table}|
+\end{quote}
+\begin{Example}
+ \captionsetup{type=table,position=b,skip=0pt}
+ \captionsetup[ContinuedFloat]{labelformat=continued2}
+ \ContinuedFloat
+ \caption{A table}\label{continued2}
+ \centerline{\ldots}
+\end{Example}
+\medskip
+% A reference to this table would still result in the output
+% ``\autoref{continued2}'' since only the caption label format was changed.
+% If you would like to use the |Continued|\-|Float| counter for the references,
+% too, you could redefine the command |\the|\-|Continued|\-|Float| instead,
+% which will be appended to the figure or table counter automatically in
+% continued floats and is preset to be empty.
+Ссылка на эту таблицу останется в~виде
+«\autoref{continued2}», поскольку изменялся только формат метки.
+Если вам нужно использовать также счётчик |Continued|\-|Float| в~ссылках,
+вы должны переопределить команду |\the|\-|Continued|\-|Float|,
+которая, подключается автоматически в~продолжающихся флотах,
+тогда как по умолчанию эта команда пуста.
+\begin{quote}
+ |\renewcommand\theContinuedFloat{\asbuk{ContinuedFloat}}|\\
+ \ldots\\
+ |\begin{table}\ContinuedFloat|\\
+ | \caption{A table}|\\
+ | |\ldots\\
+ |\end{table}|
+\end{quote}
+\begin{Example}
+ \captionsetup{type=table,position=b,skip=0pt}
+ \renewcommand\theContinuedFloat{\asbuk{ContinuedFloat}}
+ \ContinuedFloat
+ \caption{A table}\label{continued3}
+ \centerline{\ldots}
+\end{Example}
+\medskip
+% A reference to that table would result in the output ``\autoref{continued3}''.
+Ссылка на эту таблицу даст следующий результат «\autoref{continued3}».
+
+\pagebreak[3]
+\DescribeMacro{\ContinuedFloat*}
+% Suppose you want to start the first figure or table of such a series with a
+% kind of ``Figure 7a'' and not with ``Figure 7'' (and the second one with
+% ``Figure 7b'' instead of ``Figure 7a'').
+% This is possible, too, by using the starred variant |\Continued|\-|Float*|
+% which---just like |\Continued|\-|Float|---executes options associated with the
+% type name ``|Continued|\-|Float|'' and increments the \LaTeX\ counter
+% |Continued|\-|Float|, \emph{but} marks the first figure or table of a series
+% instead:
+Предположим вам нужно создать продолжающиеся рисунок или таблицу с~нумерационным
+заголовком вида «Figure 7a», а~не «Figure 7» (а~затем, как
+«Figure 7b», вместо «Figure 7a»).
+Это также возможно, если использовать звёздный вариант команды |\Continued|\-|Float*|
+которая \cdash--- как и~|\Continued|\-|Float| \cdash--- подключает опции
+с~помощью команды «|Continued|\-|Float|» и~увеличивает счётчик \LaTeX'а
+|Continued|\-|Float|, \emph{но} отмечает и~первый флот из серии
+продолжающихся флотов:
+\begin{quote}
+ |\renewcommand\theContinuedFloat{\asbuk{ContinuedFloat}}|\\
+ \ldots\\
+ |\begin{figure}\ContinuedFloat*|\\
+ | |\ldots\\
+ | \caption{First figure of a series}|\\
+ |\end{figure}|\\
+ \ldots\\
+ |\begin{figure}\ContinuedFloat|\\
+ | |\ldots\\
+ | \caption{Second figure of a series}|\\
+ |\end{figure}|\\
+ \ldots\\
+ |\begin{figure}\ContinuedFloat|\\
+ | |\ldots\\
+ | \caption{Third figure of a series}|\\
+ |\end{figure}|
+\end{quote}
+\begin{Example}
+ \captionsetup{type=figure,position=b,skip=0pt}
+ \renewcommand\theContinuedFloat{\asbuk{ContinuedFloat}}
+ \begingroup
+ \ContinuedFloat*
+ \centerline{\ldots}
+ \caption{First figure of a series}
+ \endgroup
+ \begingroup
+ \ContinuedFloat
+ \centerline{\ldots}
+ \caption{Second figure of a series}
+ \endgroup
+ \begingroup
+ \ContinuedFloat
+ \centerline{\ldots}
+ \caption{Third figure of a series}
+ \endgroup
+\end{Example}
+\smallskip
+% \Note{Unfortunately \cs{ContinuedFloat*} is not available if the
+% \package{subfig} package\cite{subfig} is loaded.}
+\Note{К~сожалению команду \cs{ContinuedFloat*} нельзя использовать при загруженном пакете
+ \package{subfig}\cite{subfig}.}
+
+\pagebreak[3]
+% \subsubsection*{A note about longtables}
+\subsubsection*{A note about longtables}
+% If you want to have a different caption label in |long|\-|table|s (offered
+% by the \package{longtable} package\cite{longtable}) after a page break,
+% this can \emph{not} be archived by using |\Continued|\-|Float|,
+% but instead you could write something like:
+Если вам нужно создать отличающийся формат метки для продолжения
+окружения |long|\-|table|
+(предлагаемого пакетом \package{longtable}\cite{longtable})
+на следующей странице,
+использование |\Continued|\-|Float| \emph{не} даст результатов,
+но вы можете задать что-то вроде:
+\begin{quote}
+ |\DeclareCaptionLabelFormat{continued}{Continued #1~#2}|\\
+ \ldots\\
+ |\begin{longtable}{|\ldots|}|\\
+ | \caption{A longtable}\\|\\
+ |\endfirsthead|\\
+ | \captionsetup{labelformat=continued}|\\
+ | \caption[]{A longtable}\\|\\
+ |\endhead|\\
+ | |\ldots\\
+ |\end{longtable}|
+\end{quote}
+
% --------------------------------------------------------------------------- %
-% \fi
-%
-%^^A \subsection{The \package{float} package}
-% \subsection{Пакет \package{float}}
-% \label{float}
-%
-%^^A A very useful feature is provided by the \package{float} package\cite{float}:
-%^^A It offers the float placement specifier |H| which is much more restrictive
-%^^A than the specifier |h| offered by \LaTeX. While the latter one is only a
-%^^A recommendation to \LaTeX\ to set the float ``here'', the |H| forces the
-%^^A float to appear exactly at the spot where it occurs in your input file
-%^^A and nowhere else.
-% Очень полезные настройки предлагаются пакетом \package{float}\cite{float}.
-% Пакет предлагает специальную опцию размещения флота |H| которая жёстче, по
-% сравнению с~опцией |h| стандартного \LaTeX'а. Если стандартная опция только
-% «рекомендует» \LaTeX'у~поместить флот «здесь», опция |H| помещает
-% флот точно в~том месте где он записан и~нигде больше [При этой
-% опции флот реально встаёт на якорь! \cdash--- \emph{Прим. перев}].
-%
-%^^A Furthermore it offers different styles for floating environments, these
-%^^A styles are |plain|, |plaintop|, |ruled|, and |boxed|.
-%^^A You can link one of these styles to either new floating environments or
-%^^A to one of the existing environments |figure| and |table|.
-% Помимо этого пакет предлагает различные стили для окружений флотов, это стили
-% |plain|, |plaintop|, |ruled|, и~|boxed|.
-% Вы можете задать один из этих стилей как для новых окружений флотов, так
-% и~для уже существующих |figure| и~|table|.
-%
-%^^A If you are using the \thispackage\ package together with the \package{float}
-%^^A package a caption style called |ruled| gets defined automatically:
-% Если вы используете пакет \thispackage\ вместе с~пакетом \package{float}
-% стиль подписи |ruled| будет определён автоматически:
-% \begin{quote}
-% |\DeclareCaptionStyle{ruled}{labelfont=bf,labelsep=space}|
-% \end{quote}
-%^^A This style represents the caption layout in |ruled| styled floats.
-%^^A For you as an end user this means that captions within |ruled| floats will
-%^^A always look like this, nevertheless what generic caption options do you
-%^^A specify:
-% Этот стиль предлагает стиль подписей в~стиле флотов |ruled|.
-% Для вас как пользователя это значит, что подписи внутри |ruled| флотов будут
-% всегда выглядеть так, если только не переопределены заданные опции пакета:
-%
-% \ifx\floatstyle\undefined
-%
-% \begin{Example}
-% \hrule height.8pt depth0pt \kern2pt
-% \vbox{\strut{\bfseries Program 7.1}
-% The first program. This hasn't got anything to do with the package
-% but is included as an example. Note the \texttt{ruled} float style.}
-% \kern2pt\hrule\kern2pt
-% \begin{verbatim}
-% #include <stdio.h>
-%
-% int main(int argc, char **argv)
-% {
-% for (int i = 0; i < argc; ++i)
-% printf("argv[%d] = %s\n", i, argv[i]);
-% return 0;
-% }
-% \end{verbatim}
-% \kern2pt\hrule\relax
-% \end{Example}
-%
-% \else
-%
-% \floatstyle{ruled}
-% \newfloat{Program}{tbp}{lop}[section]
-% \floatname{Program}{Program}
-%
-% \begin{Program}[H]
-% \begin{verbatim}
-% #include <stdio.h>
-%
-% int main(int argc, char **argv)
-% {
-% for (int i = 0; i < argc; ++i)
-% printf("argv[%d] = %s\n", i, argv[i]);
-% return 0;
-% }
-% \end{verbatim}
-% \caption{The first program. This hasn't got anything to do with the package
-% but is included as an example. Note the \texttt{ruled} float style.}
-% \end{Program}
-%
-% \fi
-%
-%^^A If you want a different layout for |ruled| captions you have to define
-%^^A your own one using the command
-% Если вы желаете другое оформление для |ruled| подписей нужно
-% задать свои установки, используя команду
+
+\clearpage
+% \section{Own enhancements}
+\section{Собственные настройки}
+\label{declare}
+
+% A family of commands is provided to allow users to define their own formats
+% etc.
+% This enables information on separators, justification, fonts, and styles to
+% be associated with a name and kept in one place.
+% (These commands need to appear in the document preamble,
+% this is the part between |\document|\-|class| and |\begin{document}|.)
+Имеется семейство команд, позволяющих пользователю самостоятельно
+создать собственное оформление.
+Это позволяет информацию о~разделителях, выключке, шрифтах, и~стилях
+привязать к~определённому ключу, и~поместить всё это в~одном месте
+(такие команды должны находиться в~преамбуле документа \cdash---
+это часть между строками команд |\document|\-|class| и~|\begin{document}|).
+
+\pagebreak[3]
+\DescribeMacro{\DeclareCaption-\\Format}
+% You can define your own caption formats using the command
+Вы можете определить своё оформление подписи, используя команду
+\begin{quote}
+% |\DeclareCaptionFormat|\marg{name}\marg{code using \#1, \#2 and \#3}\mbox{\quad.}
+ |\DeclareCaptionFormat|\marg{name}\marg{код, использующий \#1, \#2 и~\#3}\mbox{\ .}
+\end{quote}
+% At usage the system replaces \#1 with the caption label, \#2 with the
+% separator and \#3 with the text. So the standard format |plain| is
+% pre-defined by \thispackage\ as
+При использовании программа заменяет \#1 на нумерационный заголовок, \#2 на
+разделитель и~\#3 на текст подписи. Итак, стандартный формат |plain| определён
+внутри пакета \thispackage\ как
+\begin{quote}
+ |\DeclareCaptionFormat{plain}{#1#2#3\par}|\quad.
+\end{quote}
+\begin{Expert}
+% There is also a starred variant, |\Declare|\-|Caption|\-|Format*|,
+% which causes the code being typeset in \TeX s vertical (instead of
+% horizontal) mode, but does not support the |indention=| option.
+Существует также звёздный вариант |\Declare|\-|Caption|\-|Format*|, который
+создаёт код, печатающийся в~вертикальном режиме (моде) \TeX'а (вместо
+обычного горизонтального),
+но в~этом случае не поддерживается ключ |indention=|.
+\end{Expert}
+
+\pagebreak[3]
+\DescribeMacro{\DeclareCaption-\\LabelFormat}
+% Likewise you can define your own caption label formats:
+Аналогично вы можете определить формат нумерационного заголовка:
+\begin{quote}
+ |\DeclareCaptionLabelFormat|\marg{name}\marg{код использующий \#1 и~\#2}
+\end{quote}
+% At usage \#1 gets replaced with the name (e.g. ``figure'') and \#2
+% gets replaced with the reference number (e.g. ``12'').
+% An example:
+При использовании \#1 заменяется на имя флота (например. «Рис.») и~\#2
+заменяется на порядковый номер (например «12»). Пример:
+\begin{quote}
+ |\DeclareCaptionLabelFormat{bf-parens}{(\textbf{#2})}|\\
+ |\captionsetup{labelformat=bf-parens,labelsep=quad}|
+\end{quote}
+\example*{labelformat=bf-parens,labelsep=quad}{\exampletext}
+
+\pagebreak[3]
+\DescribeMacro{\bothIfFirst}
+\DescribeMacro{\bothIfSecond}
+% If you define your own caption label formats and use the
+% \package{subcaption} or \package{subfig}\cite{subfig} package,
+% you should take care of empty caption label names.
+% For this purpose the commands
+Когда вы определяете своё оформление нумерационного заголовка и~используете
+также пакеты \package{subcaption} или \package{subfig},
+вы должны помнить что в~подфлотах элемент
+«имя флота» будет пустым. Для этой цели следующие команды
+\begin{quote}
+ |\bothIfFirst|\marg{first arg}\marg{second arg}\quad и\\
+ |\bothIfSecond|\marg{first arg}\marg{second arg}
+\end{quote}
+% are offered. |\bothIfFirst| tests if the first argument exists (means: is
+% not empty), |\bothIfSecond| tests if the second argument exists. If yes,
+% both arguments get typeset, otherwise none of them.
+предложены. Команда |\bothIfFirst| тестирует наличие первого аргумента (что он
+непустой), команда |\bothIfSecond| тестирует наличие второго. Если тестируемый
+аргумент есть, то печатаются оба аргумента, в~противном случае ни одного.
+
+\smallskip
+
+\pagebreak[3]
+% For example the standard label format |simple| is \emph{not} defined as
+Например, стандартное оформление нумерации |simple| определено не так:
+\begin{quote}
+ |\DeclareCaptionLabelFormat{simple}{#1~#2}|\mbox{\quad,}
+\end{quote}
+% because this could cause an extra space if \#1 is empty. Instead |simple|
+% is defined as
+поскольку аргумент \#1 может быть пустым. Вместо этого |simple|
+определён следующим образом
+\begin{quote}
+ |\DeclareCaptionLabelFormat{simple}%|\\
+ | {\bothIfFirst{#1}{~}#2}|\mbox{\quad,}
+\end{quote}
+% causing the space to appear only if the label name is present.
+в~результате пробел появится только тогда, когда есть имя нумерационного
+заголовка.
+
+\smallskip
+
+\pagebreak[3]
+\DescribeMacro{\DeclareCaption-\\TextFormat}\NEWfeature{v3.0l}%
+% Likewise you can define your own caption text formats:
+Аналогично можно определить формат текста подписи:
+\begin{quote}
+% |\DeclareCaptionTextFormat|\marg{name}\marg{code using \#1}
+ |\DeclareCaptionTextFormat|\marg{name}\marg{код, использующий аргумент \#1}
+\end{quote}
+% At usage \#1 gets replaced with the caption text.
+При использовании \#1 заменяется текстом подписи.
+
+\bigskip
+
+\pagebreak[3]
+\DescribeMacro{\DeclareCaption-\\LabelSeparator}
+% You can define your own caption label separators with
+Можно определить свой разделитель номера и~текста подписи с~помощью
+ команды
+\begin{quote}
+ |\DeclareCaptionLabelSeparator|\marg{name}\marg{code}\mbox{\quad.}
+\end{quote}
+% Again an easy example taken from \thispackage\ itself:
+И~опять простой пример из того, что предлагает \thispackage:
+\begin{quote}
+ |\DeclareCaptionLabelSeparator{colon}{: }|
+ \end{quote}
+ \begin{Expert}
+% There is also a starred variant, |\Declare|\-|Caption|\-|Label|\-|Separator*|,
+% which causes the code being typeset without using the |label|\-|font=| setting.
+% So for example the label separators |quad|, |new|\-|line|, and |en|\-|dash|
+% are defined in this way.
+Существует также звёздный вариант, |\Declare|\-|Caption|\-|Label|\-|Separator*|,
+который определяет код, без использования настроек из ключа |label|\-|font=|.
+Так, например, разделители |quad|, |newline| и |endash|
+определены этой командой.
+\end{Expert}
+
+\bigskip
+
+\pagebreak[3]
+\DescribeMacro{\DeclareCaption-\\Justification}
+% You can define your own caption justifications with
+Вы можете определить собственную выключку с~помощью команды
+\begin{quote}
+ |\DeclareCaptionJustification|\marg{name}\marg{code}\mbox{\quad.}
+\end{quote}
+% The \meta{code} simply gets typeset just before the caption.
+% E.g.~using the justification |raggedright|, which is defined as
+Аргумент \meta{code} задаёт выключку до начала подписи.
+Например использование выключки |raggedright|, которая определена как
+\begin{quote}
+ |\DeclareCaptionJustification{raggedright}{\raggedright}|\mbox{\quad,}
+\end{quote}
+% typesets captions with all lines moved to the left margin.
+выключает все строки подписи в~левый край.
+
+\bigskip
+
+\pagebreak[3]
+\DescribeMacro{\DeclareCaption-\\Font}
+% You can define your own caption fonts with
+Вы можете задать свой шрифт для подписи с~помощью
+\begin{quote}
+ |\DeclareCaptionFont|\marg{name}\marg{code}\quad.
+\end{quote}
+% For example this package defines the options |small| and |bf| as
+Например данный пакет определяет опции |small| и~|bf| как
+\begin{quote}
+ |\DeclareCaptionFont{small}{\small}|\quad и\\
+ |\DeclareCaptionFont{bf}{\bfseries}|\quad.
+\end{quote}
+\iffalse
+% The line spacing could be customized using the \package{setspace} package,
+% for example:%\NEWdescription{v3.0h}
+Интерлиньяж может быть настроен с~помощью пакета \package{setspace},
+например:%\NEWdescription{v3.0h}
+\begin{quote}
+ |\usepackage{setspace}|\\
+% |\DeclareCaptionFont{singlespacing}{\setstretch{1}}|~\footnote{%
+% \emph{\DefaultNoteText:} Using \cs{singlespacing} does not work here since
+% it contains a \cs{vskip} command.}\\
+ |\DeclareCaptionFont{singlespacing}{\setstretch{1}}|\quad\footnote{%
+ \emph{\DefaultNoteText}: Использование \cs{singlespacing} в данном случае
+ не работает поскольку содержит команду \cs{vskip}.}\\
+ |\DeclareCaptionFont{onehalfspacing}{\onehalfspacing}|\\
+ |\DeclareCaptionFont{doublespacing}{\doublespacing}|\\
+ |\captionsetup{font={onehalfspacing,small},labelfont=bf}|
+\end{quote}
+\example{font={onehalfspacing,small},labelfont=bf,singlelinecheck=off}{\exampletext}
+\fi
+% An example which brings color into life:
+Пример использования цвета:
+\begin{quote}
+ |\usepackage{color}|\\
+ |\DeclareCaptionFont{red}{\color{red}}|\\
+ |\DeclareCaptionFont{green}{\color{green}}|\\
+ |\DeclareCaptionFont{blue}{\color{blue}}|\\
+ |\captionsetup{labelfont={blue,bf},textfont=green}|
+\end{quote}
+\example*{labelfont={color=blue,bf},textfont={color=green},singlelinecheck=off}{\exampletext}
+% But since \thispackage\ already includes the tricky definition
+Но поскольку \thispackage\ уже использует хитроумное определение
+\begin{quote}
+ |\DeclareCaptionFont{color}{\color{#1}}|
+\end{quote}
+% you can get the same result simply with
+вы можете получить тот же результат задав просто
+\begin{quote}
+ |\usepackage{color}|\\
+ |\captionsetup{labelfont={color=blue,bf},|\\
+ | textfont={color=green}}|\quad.
+\end{quote}
+
+\medskip
+
+\pagebreak[3]
+\DescribeMacro{\DeclareCaption-\\Style}
+% You can define your own caption styles with
+Вы можете определить свои собственные стили с~помощью
+\begin{quote}
+ |\DeclareCaptionStyle|\marg{name}\oarg{additional options}\marg{options}\mbox{\quad.}
+\end{quote}
+% Remember, caption styles are just a collection of suitable options, saved
+% under a given name. You can wake up these options at any time with the
+% option |style=|\meta{style name}.
+Напомним, что стили подписи это коллекция ключей, сохранённых
+под данным именем. Вы можете привести их в~действие с~помощью ключа
+|style=|\meta{style name}.
+
+% All caption styles are based on the |base| set of options. (See \Ref{style}
+% for a complete list.) So you only need to specify options which are different
+% to them.
+Все стили подписей базируются на установках по умолчанию. (См. полный список
+в~\Ref{style}.) Поэтому достаточно определить опции, отличные
+от уже заданных.
+
+% If you specify \meta{additional options} they get used in addition when
+% the caption fits into a single line and this check was not disabled with
+% the option |single|\-|line|\-|check=off|.
+Если вы определите \meta{additional options} они будут использоваться когда
+подпись будет однострочной, и~контроль коротких подписей не отключен
+заданием опции |single|\-|line|\-|check=off|.
+
+% Again a very easy example taken from the core of this package: The
+% caption style |base| is pre-defined as
+Опять же очень простой пример из самого пакета. Стиль подписей |base|
+определён как:
+\begin{quote}
+ |\DeclareCaptionStyle{base}%|\\
+ | [justification=centering,indention=0pt]{}|\quad.
+\end{quote}
+
+% Something more exciting:
+Что-то поинтереснее:
+\begin{quote}
+ |\DeclareCaptionStyle{mystyle}%|\\
+ | [margin=5mm,justification=centering]%|\\
+ | {font=footnotesize,labelfont=sc,margin={10mm,0mm}}|\\
+ |\captionsetup{style=mystyle}|
+\end{quote}
+% gives you caption like these ones:
+даст вам подписи как в~следующем примере:
+\begin{Example}
+ \captionsetup{type=figure,style=mystyle,position=b}
+ \caption{Короткая подпись.}
+ \caption{Длинная, длинная, длинная, длинная, длинная, длинная,
+ длинная, длинная, длинная, длинная, длинная,
+ длинная, длинная, длинная, длинная, длинная, подпись.}
+\end{Example}
+
+\bigskip
+
+\pagebreak[3]
+\DescribeMacro{\DeclareCaption-\\ListFormat}\NEWfeature{v3.1}%
+% You can define your own caption list formats with
+Вы можете определить свой формат для Списков, используя
+\begin{quote}
+ |\DeclareCaptionListFormat|\marg{name}\marg{код использующий \#1 и~\#2}\mbox{\quad.}
+\end{quote}
+% At usage \#1 gets replaced with the label prefix (e.g.~|\p@figure|),
+% and \#2 gets replaced with the reference number (e.g.~|\thefigure|).
+При использовании \#1 заменяется на префикс метки (например |\p@figure|)
+и~\#2 \cdash--- на номер (например, |\thefigure|).
+
+\bigskip
+
+\pagebreak[3]
+\DescribeMacro{\DeclareCaptionType}\NEWfeature{v3.1f}%
+% You can define your own floating environments and caption types with
+Вы можете определить собственные окружения и~типы подписей, используя
+\begin{quote}
+ |\DeclareCaptionType|\oarg{options}\marg{type}\oarg{name}\oarg{list name}
+\end{quote}
+% where \meta{options} are one or more of
+где \meta{options} одна из
+\begin{quote}\begin{tabular}{r@{}l@{\qquad}l}
+ |fileext=| & \meta{file extension}
+ & {\small(например~|fileext=lod|)}\\
+% |listname=|\meta{list name}\\
+% |name=|\meta{prosa name}\\
+ |placement=| & \meta{combination of \,\purett{htbp}}
+ & {\small(например~|placement=tbp|)}\\
+ |within=| & \meta{``within'' counter} \emph{or} \texttt{none}\quad.
+ & {\small(например~|within=section|)}
+\end{tabular}\end{quote}
+% If no \meta{options} are given, ``lo\meta{type}'' will be used as \meta{file
+% extension} for the list, ``|tbp|'' as \meta{placement} specifier,
+% and ``|chapter|'' resp. ``|none|'' as \meta{``within'' counter},
+% i.e., the counter which resets the numbering.
+% (If ``|none|'' was specified as value, the numbering of the new
+% type will be continuous throughout the document.)
+Если \meta{options} не заданы, «lo\meta{type}» будет использован как \meta{file
+extension} для Списка, «|tbp|» как опция размещения \meta{placement}
+и~«|chapter|» или «|none|» как счётчик \meta{``within'' counter},
+т.\,е. счётчик, контролирующий перенумерацию.
+(Если задан «|none|», нумерация нового типа флота
+будет сквозная.)
+
+% If no \meta{name} is given, the name of the newly created type will be set
+% to \meta{type}, but with an uppercase first letter.
+% If no \meta{list name} is given, the list name will be set to ``List of
+% \meta{name}s''.
+Если не задан ключ \meta{name}, имя вновь созданного типа флотов будет взято
+из аргумента \meta{type}, но с~первой прописной буквой.
+Если нет аргумента \meta{list name}, название Списка будет задано как «List of
+\meta{name}s». [Для опции \meta{name} нет поддержки на русском языке.]
+% caption-deu.tex:
+% (Diese Vorbelegungen sind also nur fur
+% englischsprachige Dokumente geeignet,
+% bei anderssprachigen Dokumenten sollte man also immer \meta{Name} und
+% \meta{Listenname} mit angeben.) which means:
+%
+% (This presets are only appropriate for English documents, so for
+% other languages you should use the optional arguments "name" and "list name".)
+(Эти автоматические установки возможны только для
+английских документов, поэтому для
+других языков опции \meta{name} и~\meta{list name}
+обязательны.)
+
+% The list will be typeset using the command |\list|\-|of|\meta{type}|s|,
+% analogous to |\list|\-|of|\-|figures| and |\list|\-|of|\-|tables|.
+% If the \package{fltpage} package is loaded, an environment called
+% |FP|\meta{type} will be defined, same for |sideways|\meta{type}
+% (\package{rotating} package), |SC|\meta{type} (\package{sidecap} package),
+% and |wrap|\meta{type} (\package{wrapfig} package).
+Список флотов может быть создан с~помощью команды |\listof|\meta{type}|s|,
+аналогичный |\list|\-|of|\-|figures| и~|\list|\-|of|\-|tables|.
+Если используется пакет \package{fltpage}, окружение
+|FP|\meta{type} будет определено, то же для |sideways|\meta{type}
+(пакет \package{rotating}), |SC|\meta{type} (пакет \package{sidecap}),
+и~|wrap|\meta{type} (пакет \package{wrapfig}).
+
+\smallskip
+
+\pagebreak[3]
+% So for example
+Так, например
+\begin{quote}
+ |\DeclareCaptionType{diagram}|
+\end{quote}
+% will define a new caption type and floating environment called |diagram|,
+% the list will be stored in a file with the extension |lodiagram|, the name
+% (used for the caption) will be ``Diagram'' and the list name
+% ``List of Diagrams''.
+% The list could be typeset with |\listofdiagrams|.
+% Dependent on which packages are loaded, the environments |FPdiagram|,
+% |sidewaysdiagram|, |SCdiagram|, and |wrapdiagram| will be defined additionally.
+определяет новый тип подписи и~окружение флота, названный |diagram|,
+Список будет записываться в~файл с~расширением |lodiagram|, имя
+(используемое в~нумерационном заголовке подписи) будет «|Diagram|» и~заголовок Списка
+«|List of Diagrams|». Список может быть распечатан командой |\listofdiagrams|.
+В~зависимости от того, какие пакеты загружены, определятся дополнительно окружения
+|FPdiagram|,
+|sideways|\-|diagram|, |SCdiagram| и~|wrap|\-|diagram|.
+
+%caption-deu.tex
+% So definiert zum Beispiel
% \begin{quote}
-% |\DeclareCaptionStyle{ruled}|\marg{options}\quad.
+% |\DeclareCaptionType{diagram}[Diagramm][Diagrammverzeichnis]|
% \end{quote}
%
-%^^A This mechanism also works with all other float styles. If you want a special
-%^^A caption layout---for |plain| or |boxed| floats for example---you can simply define
-%^^A a suitable caption style with the same name as the float style.
-% Этот механизм действует и~на другие стили флотов. Если вам нужно специальное
-% оформление подписи для стиля |plain| или |boxed|, вы просто
-% определяете соответствующий стиль с~тем же названием.
-%
-%^^A \textbf{Note:} For successful cooperation you need the float package
-%^^A version 1.3 or newer.
-% \textbf{Примечание:} Для успешной кооперации вам нужна версия пакета
-% под номером 1.3 или выше.
-%
-% \iffalse
-% --------------------------------------------------------------------------- %
-% \fi
-%
-% \pagebreak[3]
-%^^A \subsection{The \package{listings} package}
-% \subsection{Пакет \package{listings}}
-% \label{listings}
-%
-% \NEWdescription{v3.0b}
-%^^A The \package{listings} package\cite{listings} is a source code printer for \LaTeX.
-%^^A You can typeset stand alone files as well as listings with an environment
-%^^A similar to \texttt{verbatim} as well as you can print code snippets using
-%^^A a command similar to |\verb|.
-%^^A Many parameters control the output and if your preferred programming
-%^^A language isn't already supported, you can make your own definition.
-% Пакет \package{listings} \cite{listings} предназначен для печати исходного
-% кода в~\LaTeX'е. Вы можете печатать отдельные файлы в~окружении, аналогичном
-% окружению \texttt{verbatim} или фрагменты кода так же как при использовании
-% команды |\verb|.
-% Множество параметров контролируют вывод кода и~если вам нужно оформить
-% язык, который ещё не имеет поддержки, вы можете задать свои определения.
-%
-%^^A \textbf{Note:} For successful cooperation you need the listings package
-%^^A version 1.2 or higher. You'll get an error message when using an
-%^^A older version!
-% \textbf{Примечание:} для успешной кооперации вам нужен пакет
-% версии не ниже 1.2. Иначе вы получите сообщение об ошибке!
-%
-% \iffalse
+Подобное же определение для русской документации должно выглядеть так:
+\begin{quote}
+ |\DeclareCaptionType{diagram}[Диаграмма][Список диаграмм]|
+\end{quote}
+
% --------------------------------------------------------------------------- %
-% \fi
-%
-%^^A \subsection{The \package{longtable} package}
-% \subsection{Пакет \package{longtable}}
-% \label{longtable}
-%
-%^^A The \package{longtable} package\cite{longtable} offers the environment
-%^^A |longtable| which behaves similar to the |tabular| environment, but
-%^^A the table itself can span multiple pages.
-% Пакет \package{longtable} \cite{longtable} предлагает окружение
-% |longtable| которое, аналогично окружение |tabular|, создаёт табличный
-% материал, но он может разместиться на нескольких полосах.
-%
-%^^A \textbf{Note:} For successful cooperation you need the longtable package
-%^^A version 3.15 or newer.
-% \textbf{Примечание:} Для успешной кооперации используйте версию
-% 3.15 или выше.
-%
-% \iffalse
+
+% \subsection{Further examples}
+\subsection{Ещё несколько примеров}
+\label{examples}
+
+\subsubsection*{Example 1}
+
+%\NEWdescription{v3.1}
+% If you would like to have a line break between caption label and text
+% you could define it this way:
+Если вам нужно задать новую строку между нумерационным заголовком и~текстом,
+вы можете задать это следующим образом:
+\begin{quote}
+ |\DeclareCaptionFormat{myformat}{#1#2\\#3}|
+\end{quote}
+% If you select this format with |\caption|\-|setup{format=|\x|myformat}|
+% you get captions like this:
+Если вы выберете этот формат, задав |\caption|\-|setup{format=|\x|myformat}|
+вы получите такой вид подписей:
+%\begin{Example}
+% \captionsetup{skip=0pt}
+ \example{format=myformat1,labelfont=bf}{\exampletext}
+%\end{Example}
+% You could even use an indention with this caption format:
+Вы можете использовать втяжку с~этим форматом:
+\begin{quote}
+ |\captionsetup{format=myformat,indention=1cm}|
+\end{quote}
+% This would look like this:
+Это будет выглядеть так:
+%\begin{Example}
+% \captionsetup{skip=0pt}
+ \example{format=myformat1,indention=1cm,labelfont=bf}{\exampletext}
+%\end{Example}
+% Instead, you would like to have an indention only of the first line of
+% the caption text? No problem, e.g.
+А~что если, вместо этого, задать втяжку только для первой строки подписи?
+Нет проблем, например
+\begin{quote}
+ |\newlength\myindention|\\
+ |\DeclareCaptionFormat{myformat}%|\\
+ | {#1#2\\\hspace*{\myindention}#3}|\\
+ \ldots\\
+ |\setlength\myindention{1cm}|\\
+ |\captionsetup{format=myformat}|
+\end{quote}
+% would give you captions like
+даст подпись вида
+%\begin{Example}
+% \captionsetup{skip=0pt}
+ \example{format=myformat2,myindention=1cm,labelfont=bf}{\exampletext}
+%\end{Example}
+% But you want to have an caption option for this indention, so you can use
+% it for example with
+% |\caption|\-|setup|\x|[figure]|\x|{my|\-|indention=|\x\ldots|}|?
+% This could be done, too:
+Но вы хотите создать опцию для этой втяжки, для того, чтобы
+использовать её как |\captionsetup|\x|[figure]|\x|{myindention=|\ldots|}|?
+Это тоже можно сделать:
+\begin{quote}
+ |\newlength\myindention|\\
+ |\DeclareCaptionOption{myindention}%|\\
+ | {\setlength\myindention{#1}}|\\
+ |\DeclareCaptionFormat{myformat}%|\\
+ | {#1#2\\\hspace\myindention #3}|\\
+ \ldots\\
+ |\captionsetup{format=myformat,myindention=1cm}|
+\end{quote}
+% would give the same result as the example above.
+что даст результат аналогичный приведённому выше.
+
+% \subsubsection*{Example 2}
+\subsubsection*{Пример 2}
+
+% You want captions to look like this:
+Вы хотите получить подписи такого вида:
+%\begin{Example}
+% \captionsetup{skip=0pt}
+ \example{format=reverse,labelformat=fullparens,labelsep=fill,labelfont=it}{\exampletext}
+%\end{Example}
+\pagebreak[2]
+% You could do it this way:
+Это можно сделать следующим образом:
+\nopagebreak[3]
+\begin{quote}
+ |\DeclareCaptionFormat{reverse}{#3#2#1}|\\
+ |\DeclareCaptionLabelFormat{fullparens}%|\\
+ | {(\bothIfFirst{#1}{~}#2)}|\\
+ |\DeclareCaptionLabelSeparator{fill}{\hfill}|\\
+ |\captionsetup{format=reverse,labelformat=fullparens,|\\
+ | labelsep=fill,font=small,labelfont=it}|
+\end{quote}
+
+% \subsubsection*{Example 3}
+\subsubsection*{Пример 3}
+
+% The caption text should go into the left margin? A possible solution would be:
+Текст нумерационного заголовка подписи должен быть выведен в~левое поле? Возможное решение:
+\begin{quote}
+ |\DeclareCaptionFormat{llap}{\llap{#1#2}#3\par}|\\
+ |\captionsetup{format=llap,labelsep=quad,singlelinecheck=no}|
+\end{quote}
+% As a result you would get captions like this:
+В~результате вы получите такие подписи:
+\example{format=llap,labelsep=quad,singlelinecheck=no,margin=0pt}{\exampletext}
+
+\medskip
+
+% If the indention into the margin shall be fixed, you could use a combination
+% of |\llap| and |\makebox|, for example:
+Если левый край подписи при выходе подписи на поля должен быть на фиксированном расстоянии,
+можно использовать комбинацию команд
+|\llap| и~|\makebox|, например:
+\begin{quote}
+ |\DeclareCaptionFormat{llapx}%|\\
+ | {\llap{\makebox[5em][l]{#1}}#3\par}|\\
+ |\captionsetup{format=llapx,singlelinecheck=off}|
+\end{quote}
+\example{format=llapx,singlelinecheck=off,skip=0pt,margin=0pt}{\exampletext}
+
+% \subsubsection*{Example 4}
+\subsubsection*{Пример 4}
+
+% This example puts a figure aside a table, but uses only one common caption for both.
+% This will be achieved by a combination of
+% |\Declare|\-|Caption|\-|Label|\-|Format| and |\caption|\-|list|\-|entry|:
+Следующий пример помещает рисунок рядом с~таблицей, но использует общую для них подпись.
+Это можно сделать комбинацией команд
+|\Declare|\-|Caption|\-|Label|\-|Format| и~|\caption|\-|list|\-|entry|:
+\begin{quote}
+ |\DeclareCaptionLabelFormat{andtable}%|\\
+ | {#1~#2 \& \tablename~\thetable}|\\
+ \ldots\\
+ |\begin{figure}|\\
+ | \centering|\\
+ | \includegraphics{|\ldots|}%|\\
+ | \qquad|\\
+ | \begin{tabular}[b]{\ldots}|\\
+ | |\ldots\\
+ | \end{tabular}|\\
+ | \captionlistentry[table]{|\ldots|}|\\
+ | \captionsetup{labelformat=andtable}|\\
+ | \caption{|\ldots|}|\\
+ |\end{figure}|
+\end{quote}
+\DeleteShortVerb{\|}%
+\noindent\begin{minipage}{\linewidth}
+ \captionsetup{type=figure}
+ \centering
+ \includegraphics[width=30pt]{cat}%
+ \qquad
+ \begin{tabular}[b]{r|rr}
+ & x & y \\\hline
+ a & 1 & 2 \\
+ b & 3 & 4 \\
+ \end{tabular}
+% \captionlistentry[table]{A figure and a table with a common caption}
+% \captionsetup{labelformat=andtable}
+% \caption{A figure and a table with a common caption~\footnotemark}
+ \captionlistentry[table]{Рисунок и~таблица с~общей подписью}
+ \captionsetup{labelformat=andtable}
+ \caption{Рисунок и~таблица с~общей подписью\footnotemark}
+\end{minipage}
+% \footnotetext{The picture was taken with permission from the
+% \LaTeX\ Companion\cite{TLC2} examples.}
+\IfFileExists{cat.eps}%
+{\footnotetext{Рисунок любезно предоставлен из примеров книги
+ \LaTeX\ Companion\cite{TLC2}.}}{}
+\MakeShortVerb{\|}
+% (Please remember that |\caption|\-|list|\-|entry| increments the figure
+% resp.~table counter.)
+(Напомним, что команда |\caption|\-|list|\-|entry|, как и~|\caption|, увеличивает счётчик флота.)
+
+
% --------------------------------------------------------------------------- %
-% \fi
-%
-%^^A \subsection{The \package{rotating} package}
-% \subsection{Пакет \package{rotating}}
-% \label{rotating}
-%
-%^^A The \package{rotating} package\cite{rotating} offers the floating
-%^^A environments \texttt{sideways\-figure} and \texttt{sideways\-table}
-%^^A which are just like normal figures and tables but rotated by 90 degree.
-%^^A Furthermore they always use a full page on their own.
-% Пакет \package{rotating} \cite{rotating} предлагает окружения
-% \texttt{sideways\-figure} и~\texttt{sideways\-table}
-% которые, аналогичны обычным рисункам и~таблицам, но повёрнуты на 90 градусов.
-% Эти окружения всегда занимают полную полосу.
-%
-% \iffalse
+
+\clearpage
+% \section{Document classes \& Babel support}
+\section{Классы документов и~поддержка пакета \package{babel}}
+\label{classes}
+
+% This section will give you an overview of the document classes the
+% \package{caption} supports, what do they already offer regarding captions,
+% what side effects will occur when using the \package{caption} package with
+% them, and what are the `default' settings for them.
+Этот раздел даст обзор классов документов, которые поддерживаются пакетом
+\package{caption}, что они уже предлагают для работы с~подписями,
+какие побочные эффекты возникают при использовании с~ними пакета \package{caption}
+и~каковы установки по умолчанию для этих классов.
+
+\NEWfeature{v3.1}
+% The `default' settings depend on the document class you use; they represent
+% how the class author wanted the captions to look like. So for example
+% setting |format=|\x|default| can give you different visual designs when used
+% with different document classes.
+Установки по умолчанию зависят от класса документа, используемого вами; они представляют
+оформление подписей, соответствующее замыслам автора данного класса документа. Например, настройки
+|format=|\x|default| дадут различный результат при использовании с~разными классами.
+
+\begingroup\setlength\leftmargini{0.3em}% default = 2.5em
+\INFO
+% If you don't find the document class you use in this section, you usually
+% don't have to worry: Many document classes (e.g.~the \class{octavo} class)
+% are derived from one of the standard document classes \class{article},
+% \class{report}, or \class{book}, and behave the same regarding captions.
+% \Thispackage\ automatically does a compatibility check against the document
+% class used and will give you the clear warning
+Если вы не нашли класс документа в~этом разделе, то, обычно, это не повод для волнения:
+множество классов документов (например, класс \class{octavo})
+получены из стандартных классов документов
+\class{article}, \class{report} или \class{book}, и~имеют
+аналогичные настройки для подписей.
+\Thispackage\ автоматически делает проверку совместимости класса документа
+и~даёт недвусмысленное предупреждение
+\begin{quote}\footnotesize
+ |Package caption Warning: Unsupported document class (or package) detected,|\\
+ |(caption) usage of the caption package is not recommended.|\\
+ |See the caption package documentation for explanation.|
+\end{quote}
+% if such an incompatibility was detected.
+% If you don't get such warning everything is fine, but if you get it the
+% usage of \thispackage\ is not recommended and especially not supported.
+если была определена несовместимость.
+Если вы такого предупреждения не получили, то всё в~порядке, но если вы это предупреждение
+всё же получили, \thispackage\ не рекомендуется и~тем более не поддерживается.
+
+\begin{Expert}
+% If you get such a compatibility warning but decide to use \thispackage{}
+% anyway, you should watch carefully what side-effects occur, usually the
+% look and feel of your captions will change by just including \thispackage{}
+% without options, meaning they do not look like as intended by the author
+% of the document class.
+% If this is fine for you, you should first specify the option |style=|\x|base|
+% via |\use|\-|package[style=|\x|base]{caption}| or
+% |\caption|\-|setup{style=|\x|base}| to set \thispackage\ into a well-defined
+% state.
+% Afterwards you can start setting your own options additionally and
+% keep your fingers crossed.
+Если вы, несмотря на предупреждение, решили всё равно использовать \thispackage{},
+вы должны проверить, какой побочный эффект возникает. Обычно подключенный \thispackage{}
+безо всяких опций в~таких случаях изменяет вывод подписей, и~они выглядят не так, как
+предусмотрено автором класса документа.
+Если это вас удовлетворяет, вы можете для начала задать ключ |style=|\x|base|,
+задав его в~строке |\use|\-|package[style=|\x|base]{caption}| или в~команде
+|\caption|\-|setup{style=|\x|base}|, что вернёт хорошо настроенные пакетом установки.
+После этого вы можете задавать свои опции и~надеяться на лучшее.
+\end{Expert}
+\endgroup
+
+\newcommand*\Option{Опция}
+\newcommand*\defaultvalue{значение \texttt{по умолчанию}}
+\newcommand*\uses{\textit{использует}}
+\newcommand*\settings{\textit{настройки}}
+\newcommand*\nofont{\textit{отсутствует}}
+
+% \subsection{Standard \LaTeX: article, report, and book}
+\subsection{Стандартный \LaTeX: article, report, и~book}
+
+\begin{tabular}{ll}
+\Option & \defaultvalue \\\hline
+|format=| & |plain| \\
+|labelformat=| & |simple| \\
+|labelsep=| & |colon| \\
+|justification=| & |justified| \\
+|font=| & \nofont \\
+|labelfont=| & \nofont \\
+|textfont=| & \nofont \\
+\end{tabular}
+
+\begin{Annotation}
+% This also applies to document classes derived from them.
+Это относится и~к~производным от них классам.
+\end{Annotation}
+
+% \subsection{\AmS: amsart, amsproc, and amsbook}
+\subsection{Классы \AmS: amsart, amsproc, и~amsbook}
+\label{AMS}
+
+\begin{tabular}{ll}
+\Option & \defaultvalue \\\hline
+|format=| & |plain| \\
+|labelformat=| & |simple| \\
+|labelsep=| & |.\enspace| \\
+|justification=| & |justified| \\
+|font=| & |\@captionfont| \\
+|labelfont=| & |\@captionheadfont| \\
+|textfont=| & |\@captionfont\upshape| \\
+\end{tabular}
+
+\begin{Annotation*}
+% |\@caption|\-|font| will be set to |\normal|\-|font|, and
+% |\@caption|\-|head|\-|font| to |\sc|\-|shape| by the \AmS\ document classes.
+Классы \AmS\ определяют команду |\@caption|\-|font|, которая задаётся как
+|\normal|\-|font|, а~|\@caption|\-|head|\-|font| \cdash--- как |\scshape|.
+\end{Annotation*}
+
+% Furthermore the margin will be set to |\caption|\-|indent| for
+% more-than-one-line captions (which will be set to |3pc| by the \AmS\ classes),
+% the margin for single-line captions will be set to the half of it instead.
+% If you want to use a common margin for both, insert
+% |\clear|\-|caption|\-|setup[margin*]{single|\-|line}|
+% into the preamble of your document, after loading \thispackage.
+Кроме этого поле принимает значение |\captionindent| в~многострочных подписях
+(которое равно в~этих классах~|3pc|),
+поле для однострочной подписи уменьшается в~два раза.
+Если вы хотите задать общее поле для обоих вариантов, добавьте в~преамбуле документа
+|\clear|\-|caption|\-|setup[margin*]{single|\-|line}|
+после загрузки пакета.
+
+% Additionally the options |figure|\-|position=b,|\x|table|\-|position=t|
+% will be set. You can override these settings by specifying other values for
+% |figure|\-|position=| or |table|\-|position=| in the option list while
+% loading \thispackage.
+Дополнительно задаются опции |figure|\-|position=b,|\x|table|\-|position=t|.
+Вы можете изменить эти установки, задав другие значения для ключей
+|figure|\-|position=| или |table|\-|position=| при загрузке пакета.
+
+\subsection{Класс beamer}
+\label{beamer}
+
+\begin{tabular}{ll}
+\Option & \defaultvalue \\\hline
+|format=| & |plain| \\
+|labelformat=| & \textit{не нумеруется} \\
+|labelsep=| & |colon| \\
+|justification=| & |raggedright| \\
+|font=| & \class{beamer} «|caption|» \settings \\
+|labelfont=| & \class{beamer} «|caption name|» \settings \\
+|textfont=| & \nofont \\
+\end{tabular}
+
+% \subsubsection*{Build-in features, and side-effects}
+% You can setup font and color settings with
+% |\set|\-|beamer|\-|font{caption}|\marg{options} and
+% |\set|\-|beamer|\-|font{caption name}|\marg{options}.
+% This will still work, unless you set a different font with
+% |\caption|\-|setup{font=|\x\meta{options}|}| or
+% |\caption|\-|setup{label|\-|font=|\x\meta{options}|}|.\par
+% Furthermore the \class{beamer} classes offer different caption templates
+% which can be chosen with
+% |\set|\-|beamer|\-|template|\x|{caption}|\x|[|\meta{template}|]|.
+% Since \thispackage\ replaces this caption template mechanism,
+% |\def|\-|beamer|\-|template*|\x|{caption}|\x\marg{template code}
+% and
+% |\set|\-|beamer|\-|template|\x|{caption}|\x|[|\meta{template}|]|
+% will have no effect when \thispackage\ is used.
+\subsubsection*{Встроенные особенности и~побочные эффекты}
+Вы можете задать шрифт и~цвет с~помощью
+|\set|\-|beamer|\-|font{caption}|\marg{options} и~%
+|\set|\-|beamer|\-|font{caption name}|\marg{options}.
+Это будет работать, если только вы не зададите другой шрифт через
+|\caption|\-|setup{font=|\x\meta{options}|}| или
+|\caption|\-|setup{label|\-|font=|\x\meta{options}|}|.\par
+Кроме этого класс \class{beamer} предлагает различные шаблоны
+оформления подписей, задаваемые через
+|\set|\-|beamer|\-|template|\x|{caption}|\x|[|\meta{template}|]|.
+Поскольку \thispackage\ заменяет этот механизм, команды
+|\def|\-|beamer|\-|template*|\x|{caption}|\x\marg{template code}
+и~|\set|\-|beamer|\-|template|\x|{caption}|\x|[|\meta{template}|]|
+не имеют силы при его использовании.
+
+% \subsection{\KOMAScript: scrartcl, scrreprt, and scrbook}
+\subsection{Классы \KOMAScript: scrartcl, scrreprt, и~scrbook}
+\label{KOMA}
+
+\begin{tabular}{ll}
+\Option & \defaultvalue \\\hline
+% |format=| & \uses\ |\setcapindent| \textit{\&} |\setcaphanging| \settings \\
+|format=| & \uses\ |\setcapindent| и~|\setcaphanging| \settings \\
+% |labelformat=| & \textit{like \purett{simple}, but with support of ``autodot''}\\
+|labelformat=| & \textit{то же, что \purett{simple}, но с~поддержкой ``autodot''}\\
+|labelsep=| & |\captionformat| \\
+|justification=| & |justified| \\
+|font=| & \settings\ |\setkomafont{caption}| \\
+|labelfont=| & \settings\ |\setkomafont{captionlabel}| \\
+|textfont=| & \nofont \\
+\end{tabular}
+
+% \subsubsection*{Build-in features}
+% The \KOMAScript\ document classes offer many ways to customize the look and
+% feel of the captions. For an overview and a full description please take a
+% look at the \KOMAScript\ documentation, section `Tables and Figures'.
+\subsubsection*{Встроенные возможности}
+Классы \KOMAScript\ предлагают много вариантов для настройки вывода
+подписей. Полный обзор вы можете найти в~[английской] документации
+\KOMAScript, раздел `Tables and Figures'.
+
+% \subsubsection*{Side effects}
+% The optional argument of |\set|\-|cap|\-|width| is not supported and
+% will be ignored if used in conjunction with the \package{caption} package.
+% Furthermore the \KOMAScript\ options |table|\-|caption|\-|above| \&
+% |table|\-|caption|\-|below| and the commands |\caption|\-|above| \&
+% |\caption|\-|below| are stronger than the |position=| setting offered by
+% the \package{caption} package.
+\subsubsection*{Побочные эффекты}
+Дополнительный аргумент команды |\setcapwidth| не поддерживается (пока)
+и~будет игнорироваться при совместном использовании с~пакетом \package{caption}.
+Помимо этого, опции \KOMAScript\ |tablecaptionabove| и~%
+|table|\-|caption|\-|below| и~команды |\caption|\-|above| и~|\caption|\-|below|
+будут сильнее чем настройки ключа |position=| предлагаемого пакетом \package{caption}.
+
+% \subsection{\NTG: artikel, rapport, and boek}
+\subsection{Классы \NTG: artikel, rapport, и~boek}
+\label{NTG}
+
+\begin{tabular}{ll}
+\Option & \defaultvalue \\\hline
+|format=| & |plain| \\
+|labelformat=| & |simple| \\
+|labelsep=| & |colon| \\
+|justification=| & |justified| \\
+|font=| & \nofont \\
+|labelfont=| & |\CaptionLabelFont| \\
+|textfont=| & |\CaptionTextFont| \\
+\end{tabular}
+
+% \subsubsection*{Build-in features, and side-effects}
+% |\Caption|\-|Label|\-|Font| and |\Caption|\-|Text|\-|Font| can be set either
+% directly or by using |\Caption|\-|Fonts|.
+% Both is still supported unless you use one of the two options
+% |label|\-|font=| or |text|\-|font=| offered by \thispackage.
+\subsubsection*{Встроенные особенности и~побочные эффекты}
+|\CaptionLabelFont| и~|\Caption|\-|Text|\-|Font| могут быть
+заданы либо непосредственно, либо
+с~использованием команды |\Caption|\-|Fonts|. Оба варианта
+поддерживаются, только если не был
+задан один из ключей |labelfont=| или |textfont=| данного пакета.
+
+% \subsection{\SmF{}: smfart and smfbook}
+\subsection{Классы \SmF{}: smfart и~smfbook}
+\label{SMF}
+
+% Since the \SmF\ document classes are derived from the \AmS\ document classes
+% the same default values are valid here.
+Поскольку классы \SmF\ являются производными классов \AmS, то те же ограничения
+действуют и~здесь.
+
+% Additionally the margin is limited up to the tenth of the |\line|\-|width|.
+% If you don't like this limitation, you can switch it off with the option
+% |max|\-|margin=|\x|off| or |max|\-|margin=|\x|false|
+% (which both means the same).
+Кроме того размер поля ограничен одной десятой от значения |\linewidth|.
+Если вас не устраивают эти ограничения, их можно отключить с~помощью
+|maxmargin=|\x|off| или |maxmargin=|\x|false| (оба варианта дают одно и~то же).
+
+\subsection{Класс thesis}
+\label{thesis}
+
+\begin{tabular}{ll}
+\Option & \defaultvalue \\\hline
+|format=| & |hang| \\
+% |labelformat=| & \textit{like \purett{simple}, but with short name}\\
+|labelformat=| & \textit{то же, что \purett{simple}, но с~кратким именем}\\
+|labelsep=| & |colon| \\
+|justification=| & |justified| \\
+|font=| & \nofont \\
+|labelfont=| & |\captionheaderfont| \\
+|textfont=| & |\captionbodyfont| \\
+\end{tabular}
+
+% \subsubsection*{Build-in features, and side-effects}
+\subsubsection*{Встроенные особенности и~побочные эффекты}
+% The caption label font can be set with |\caption|\-|header|\-|font|,
+% the caption text font with |\caption|\-|body|\-|font|.
+% Both is still supported unless you use one of the two options
+% |label|\-|font=| or |text|\-|font=| offered by \thispackage.
+Шрифт нумерационного заголовка может быть задан через команду |\caption|\-|header|\-|font|,
+шрифт для текста подписи \cdash--- через |\caption|\-|body|\-|font|.
+Обе команды поддерживаются, только если вы не использовали опции
+|label|\-|font=| или |text|\-|font=|, которые предлагает \thispackage.
+
+% \subsection{frenchb Babel option}
+\subsection{Опция frenchb пакета Babel}
+\label{frenchb}
+
+% If you use the \package{frenchb} option of the \package{babel} package
+% with one of the three standard \LaTeX{} classes (or a one derived from them)
+% the default |label|\-|sep=| will be set to |\Caption|\-|Sep|\-|a|\-|ra|\-|tor|
+% (offered by \package{frenchb}), overriding the default value set by the
+% document class.
+% So redefining |\Caption|\-|Sep|\-|a|\-|ra|\-|tor| will still work, unless you
+% don't select a different |label|\-|sep=| than the default one.
+Если вы используете опцию \package{frenchb} пакета \package{babel}
+с~одним из трёх стандартных классов \LaTeX'а (или их производными)
+значение по умолчанию ключа |labelsep=| [опция |labelsep=default|] будет использовать
+значение команды |\Caption|\-|Sep|\-|a|\-|ra|\-|tor| (предлагаемой
+пакетом \package{frenchb}), заменив значение по умолчанию, заданное классом.
+А~переопределённая команда |\Caption|\-|Sep|\-|a|\-|ra|\-|tor|
+будет работать до тех пор, пока вы
+не определите другое значение |labelsep=|, отличающееся от значения по умолчанию.
+
+\INFO*
+% Please load \thispackage\ \emph{after} the \package{babel} package.
+Пожалуйста загружайте \thispackage\ \emph{после} пакета \package{babel}.
+
+% \subsection{frenchle and frenchpro packages}
+\subsection{Пакеты frenchle и~frenchpro}
+\label{frenchpro}
+
+% If you use the \package{frenchle} or \package{frenchpro} package,
+% the default |label|\-|sep=| will be set to |\caption|\-|sep|\-|a|\-|ra|\-|tor|
+% (offered by \package{frenchle/pro}) plus \cs{space}, overriding the default
+% value set by the document class.
+% So redefining |\caption|\-|sep|\-|a|\-|ra|\-|tor| will still work, unless you
+% don't select a different |label|\-|sep=| than the default one.
+Если вы используете пакеты \package{frenchle} или \package{frenchpro},
+значение по умолчанию |label|\-|sep=| определит значение команды
+|\caption|\-|sep|\-|a|\-|ra|\-|tor| (предлагаемой
+пакетами \package{frenchle/pro}) плюс \cs{space}, заменив значение, заданное классом
+по умолчанию.
+Поэтому переопределение |\caption|\-|sep|\-|a|\-|ra|\-|tor|
+работает до тех пор, пока вы
+не определите другое значение |labelsep=|, отличающееся от значения по умолчанию.
+
+% Furthermore the default |text|\-|font=| will be set to |text|\-|font=|\x|it|,
+% since this emulates the default setting of |\caption|\-|font| defined by the
+% \package{frenchle} or \package{frenchpro} package.
+% %If you redefine |\captionfont| after loading the \package{frenchle} or
+% %\package{frenchpro} package, this redefinition gets lost.
+Помимо этого ключ по умолчанию |text|\-|font=| будет задан как |text|\-|font=|\x|it|,
+поскольку это эмулирует настройки команды |\caption|\-|font| определённой пакетами
+\package{frenchle} или \package{frenchpro}.
+% %Если вы переопределите команду |\captionfont| после загрузки \package{frenchle} или
+% %\package{frenchpro}, это переопределение пропадёт.
+% Please note that the command |\caption|\-|font| is used by the
+% \package{caption} package internally for a different purpose,
+% so you should not change it (anymore).
+Обратите внимание, что команда |\caption|\-|font| используется пакетом
+\package{caption} для других целей, поэтому лучше ею больше не пользоваться.
+
+% The command |\un|\-|numbered|\-|captions|\marg{figure \emph{or} table} will
+% still work, but only unless you don't select a different |label|\-|format=|
+% than the default one.
+Команда |\un|\-|numbered|\-|captions|\marg{figure \emph{или} table} будет работать,
+но только, если вы не определили ключ |label|\-|format=|, отличающийся
+от значения по умолчанию.
+
+\INFO*
+% Please load \thispackage\ \emph{after} the \package{frenchle}
+% or \package{frenchpro} package.
+Пожалуйста, загружайте \thispackage\ \emph{после} пакетов \package{frenchle}
+или \package{frenchpro}.
+
% --------------------------------------------------------------------------- %
-% \fi
-%
-%^^A \subsection{The \package{sidecap} package}
-% \subsection{Пакет \package{sidecap}}
-% \label{sidecap}
-%
-% \NEWdescription{v3.0b}
-%^^A The \package{sidecap} package\cite{sidecap} offers the floating
-%^^A environments |SCfigure| and |SCtable| which are like normal figures
-%^^A and tables but the caption will be put \emph{beside} the contents.
-% Пакет \package{sidecap}\cite{sidecap} предлагает окружения флотов
-% |SCfigure| и~|SCtable|, которые аналогичны обычным рисункам и~таблицам
-% но подпись помещается \emph{сбоку}.
-%
-%^^A The \package{sidecap} package offers it's own options for justification.
-%^^A If set, they will override the one specified with the caption option
-%^^A |justification=| for captions beside their contents.
-% Пакет \package{sidecap} предлагает свои опции выключки.
-% Если они заданы, они перекрывают заданные опции в~ключе
-% |justification=|.
-%
-% \DescribeMacro{listof=}\label{TeXr:nolistentry:II}
-%^^A Using the \package{sidecap} package you will probably notice that
-%^^A suppressing the entry in the list of figures or tables with
-%^^A |\caption[]{|\ldots|}| won't work inside these environments.
-%^^A This is caused by the implementation design of the \package{sidecap}
-%^^A package, but you can use |\captionsetup{listof=false}| inside the
-%^^A figure or table as an alternative here.
-% Используя пакет the \package{sidecap} вы возможно заметите, что
-% отмена вывода в~список подписи с~помощью кода
-% |\caption[]{|\ldots|}| не работает в~этих окружениях.
-% Это связано с~настройками пакета \package{sidecap},
-% но можно использовать для этого ключ |\captionsetup{listof=false}| внутри
-% нужной фигуры или таблицы.
-%
-% \ifx\SCfigure\undefined
-%
-% \begin{Example}
-% \newsavebox\scbox
-% \begin{lrbox}{\scbox}
-% \setlength{\unitlength}{.75cm}
-% \setlength{\fboxsep}{0pt}
-% \fbox{\begin{picture}(4,4)
-% \put(1,3){\circle{1}}
-% \put(3,3){\circle{1}}
-% \put(2,2){\circle{1}}
-% \put(1,1){\circle{1}}
-% \put(3,1){\circle{1}}
-% \end{picture}}
-% \end{lrbox}
-% \newlength\scboxwidth
-% \setlength\scboxwidth{\wd\scbox}
-% \makebox[\linewidth][c]{
-% \parbox[b]{\scboxwidth}{\unhbox\scbox}
-% \hspace\marginparsep
-% \parbox[b]{1.5\scboxwidth}{
-% \captionsetup{justification=raggedright,labelfont=bf}
-% \captionof{figure}[]{Небольшой пример с~подписью сбоку.}
-% }
-% }
-% \end{Example}
-%
-% \else
-%
-% \captionsetup{labelfont=bf}
-% \begin{SCfigure}[1.5][!ht]
-% \setlength{\unitlength}{.75cm}
-% \setlength{\fboxsep}{0pt}
-% \fbox{\begin{picture}(4,4)
-% \put(1,3){\circle{1}}
-% \put(3,3){\circle{1}}
-% \put(2,2){\circle{1}}
-% \put(1,1){\circle{1}}
-% \put(3,1){\circle{1}}
-% \end{picture}}
+
+\pagebreak[4]
+% \section{Package support}
+\section{Поддержка пакетов}
+\label{packages}
+\label{compatibility}
+
+%\NEWdescription{v3.1}
+% \Thispackage\ was adapted to the following packages which deals with
+% captions, too:
+\Thispackage\ адаптирован с~пакетами, которые также работают с~подрисуночными подписями:
+\begin{quote}
+ \package{float}, \package{floatflt}, \package{fltpage},
+ \package{hyperref}, \package{hypcap}, \package{listings},
+ \package{longtable}, \package{picinpar}, \package{picins},
+ \package{rotating}, \package{setspace}, \package{sidecap},
+ \package{subfigure}, \package{supertabular}, \package{threeparttable},
+ \package{wrapfig}, and \package{xtab}
+\end{quote}
+
+% Furthermore the \package{floatrow} package\cite{floatrow}, the
+% \package{subcaption} package (which is part of the \package{caption} package
+% bundle), and the \package{subfig} package\cite{subfig} support \thispackage{}
+% and use its |\caption|\-|setup| interface.
+Помимо этого пакеты \package{floatrow}\cite{floatrow},
+пакет \package{subcaption} (является частью группы пакетов \package{caption}),
+и~пакет \package{subfig}\cite{subfig}
+поддерживают \thispackage\ и~используют интерфейс |\caption|\-|setup|.
+
+\begingroup\setlength\leftmargini{0.3em}% default = 2.5em
+\INFO
+% If a package (or document class) unknown to \thispackage\ redefines
+% the |\caption| command as well, this redefinition will be preferred
+% over the one this package offers, providing maximum compatibility and
+% avoiding conflicts.
+% If such a potential incompatibility is detected, you will see this
+% warning message:~\footnote{%
+% You can suppress this warning by specifying the option
+% \texttt{compatibility=true} when loading \thispackage.}
+Если пакет (или класс документа), неизвестный данному пакету, переопределяет
+команду |\caption|, это переопределение будет более предпочтительно по
+сравнению с~тем что предлагает \thispackage, что создаст максимум совместимости
+и~даст возможность избежать последствий конфликтов.
+Если потенциальная несовместимость будет обнаружена, вы увидите следующее
+предупреждение:\footnote{%
+ Вы можете запретить это предупреждение, задав опцию \texttt{compatibility=true}
+ при загрузке данного пакета.}
+\begin{quote}\footnotesize
+ |Package caption Warning: \caption will not be redefined since it's already|\\
+ |(caption) redefined by a document class or package which is|\\
+ |(caption) unknown to the caption package.|\\
+ |See the caption package documentation for explanation.|
+\end{quote}
+\endgroup
+
+% As a result, the following features offered by \thispackage\ will not be available:
+В~результате, следующие настройки, которые предлагает \thispackage,
+не будут работать:
+\begin{itemize}
+% \item the options |labelformat=|, |position=auto|, |list=|, and |listformat=|
+% \item |\caption*| (to produce a caption without label)
+% \item |\caption[]{|\ldots|}| (to produce no entry in the List of Figures or Tables)
+% \item |\caption{}| (to produce an empty caption without label separator)
+% \item |\ContinuedFloat|
+% \item correctly justified captions in environments like \texttt{wide} and
+% \texttt{addmargin} which add extra margins
+% \item the \textsf{hypcap} feature \See{\Ref{hyperref}\,}
+% \item the sub-caption feature \See{\package{subcaption} package documentation}
+ \item опции |labelformat=|, |position=auto|, |list=| и~|listformat=|
+ \item |\caption*| (создание подписи без нумерационного заголовка)
+ \item |\caption[]{|\ldots|}| (отключение вывода в~Список флотов)
+ \item |\caption{}| (создание подписи без разделителя между нумерационным заголовком и~текстом)
+ \item |\ContinuedFloat|
+ \item правильная выключка подписей в~окружениях типа \texttt{wide} и~\texttt{addmargin},
+ которые добавляют дополнительные поля
+ \item опция \textsf{hypcap} \See{\Ref{hyperref}\,}
+ \item возможность создания подподписи \See{документацию к~пакету \package{subcaption}}
+\end{itemize}
+
+\DescribeMacro{compatibility=}
+% You can override this compatibility mode by specifying the option
+Вы можете отключить такой режим совместимости, задав
+\begin{quote}
+ |compatibility=false|
+\end{quote}
+% when loading \thispackage.
+% But please note that using this option is neither recommended nor supported
+% since unwanted side-effects or even errors could occur afterwards.
+% (For that reason you will get a warning about this.)
+при загрузке пакета.
+Но обратите внимание, что использование этой опции и~не рекомендуется, и~не поддерживается
+поскольку могут возникнуть побочные эффекты и~даже ошибки.
+(По этому поводу вы как раз уже получили предупреждение.)
+
+\newcommand\packagedescription[1]{%
+ \ifvmode\else\par\fi
+ \nopagebreak
+ \parbox[b]{\linewidth}{\footnotesize\leftskip=10pt\rightskip=10pt\relax#1}\par
+ \nopagebreak\smallskip\nopagebreak}
+
+\pagebreak[3]
+\subsection{Пакет algorithms}
+\label{algorithms}
+\packagedescription{%
+% The \package{algorithms} package bundle\cite{algorithms} provides two
+% environments: The \texttt{algorithmic} environment provides a possibility
+% for describing algorithms, and the \texttt{algorithm} environment provides
+% a ``float'' wrapper for algorithms.}
+Группа пакетов \package{algorithms}\cite{algorithms} предлагает два окружения:
+Окружение \texttt{algorithmic} предлагает возможность для записи алгоритмов,
+а~\texttt{algorithm} \cdash--- «плавающий» вариант алгоритмов.}
+
+% Since the \texttt{algorithm} environment is implemented via |\new|\-|float|
+% provided by the \package{float} package\cite{float}, please see \Ref{float}.
+Поскольку окружение \texttt{algorithm} задаётся через команду |\new|\-|float|,
+предлагаемую пакетом \package{float}\cite{float}, ознакомьтесь с~\Ref{float}.
+
+\iffalse
+\pagebreak[3]
+\subsection{Пакет algorithm2e}
+\label{algorithm2e}
+\packagedescription{%
+% The \package{algorithm2e} package\cite{algorithm2e} offers an environment for
+% writing algorithms in LaTeX2e.}
+Пакет \package{algorithm2e}\cite{algorithm2e} предлагает окружение для
+записи алгоритмов в~LaTeX2e.}
+
+% Since the \package{algorithm2e} package does not use some kind of standard
+% interface for defining its floating environment (e.g.~|\newfloat| of the
+% \package{float} package) and typesetting its caption,
+% the \package{algorithm2e} package is \emph{not} supported by \thispackage.
+Поскольку пакет \package{algorithm2e} не использует стандартный интерфейс для
+определения собственного окружения флота (например, команду~|\newfloat| из пакета
+\package{float}) и~создания подписи,
+пакет \package{algorithm2e} \emph{не} поддерживается данным пакетом.
+%
+% So if you want to customize the captions using \thispackage,
+% you have to build a new environment which uses a supported interface regarding
+% floats (e.g. using the \package{float} or \package{floatrow} package),
+% and combine this environment with the internal \package{algorithm2e} code.
+Поэтому, если вам нужно настроить подписи используя \thispackage,
+вы должны сами создать новое окружение, используя поддерживаемый интерфейс работы с~флотами
+(например, используя пакеты \package{float} или \package{floatrow}),
+и~скомбинировать это окружение с~кодом пакета \package{algorithm2e}.
+%
+% As first step you could define a non-floating environment \texttt{algorithmic},
+% for example:
+Сначала вы должны определить неплавающее окружение \texttt{algorithmic},
+например:
+\begin{quote}
+ |\usepackage{algorithm2e}|\\
+ |% save the "algorithm" environment from the algorithm2e package|\\
+ |\let\ORIGalgorithm\algorithm|\\
+ |\let\ORIGendalgorithm\endalgorithm|\\
+ |% define the algorithmic environment|\\ % , based on the saved environment
+ |\newenvironment{algorithmic}%|\\
+ | {\renewenvironment{algocf}[1][h]{}{}% pass over floating stuff|\\
+ | \ORIGalgorithm}%|\\
+ | {\ORIGendalgorithm}|\\
+ \ldots
+\end{quote}
+% Having defined this non-floating environment, you could define your own new
+% floating environment with |\newfloat| of the \package{float} package
+% (or |\DeclareNewFloatType| of the \package{floatrow} package),
+% and use the combination of this floating environment and \texttt{algorithmic}
+% in its body, just like you would do when you use the
+% \package{algorithm}/\package{algorithmic} package tandem.
+Определив такое неплавающее окружение,
+вы можете определить своё собственное окружение флота с~помощью команды |\newfloat| пакета
+\package{float}, (или |\DeclareNewFloatType| пакета \package{floatrow}),
+и~использовать комбинацию этого окружения флота и~окружения
+\texttt{algorithmic} внутри него, аналогично тому, как это используется
+при тандеме пакетов
+\package{algorithm}/\package{algorithmic}.
+
+% You could even use the \package{algorithm} package for this purpose, for example:
+Вы можете использовать для этих целей пакет \package{algorithm}, например:
+\begin{quote}
+ \ldots\\
+ |% load the algorithm package to re-define the|\\
+ |% floating environment "algorithm" and \listofalgorithms|\\
+ |\let\listofalgorithms\undefined|\\
+ |\usepackage{algorithm}|\\
+ \ldots\\
+ |% Example usage:|\\
+ |\begin{algorithm}|\\
+ |\caption{An algorithm}|\\
+ |\begin{algorithmic}|\\
+ | \SetVline|\\
+ | \eIf{cond1}{|\\
+ | a line\;|\\
+ | }{|\\
+ | another line\;|\\
+ | }|\\
+ |\end{algorithmic}|
+\end{quote}
+% Now you are finally able to customize the float and caption layout like every
+% other floating environment defined with the \package{float} package\cite{float},
+% please see \Ref{float}.
+Теперь вы можете создать настройки для содержимого флота и~его подписи, аналогично любому другому
+окружению флота, определённому пакетом \package{float} package\cite{float},
+см.~\Ref{float}.
+
+% \begin{Annotation}
+% An alternative would be using the \package{algorithmicx} package.
+В~качестве альтернативы можно использовать пакет \package{algorithmicx}.
+% \end{Annotation}
+\fi
+
+\pagebreak[3]
+\subsection{Пакет float}
+\label{float}
+\packagedescription{%
+% The \package{float} package\cite{float} introduces the commands
+% \cs{restylefloat} to give existing floating environments a new look \& feel
+% and \cs{newfloat} to define new floating environments.
+% It also provides the ``\texttt{H}'' float placement option which places
+% the environments ``here'' instead of letting them floating around.}
+Пакет \package{float}\cite{float} предлагает команды
+\cs{restylefloat} для переопределения уже существующего макета флота
+и~\cs{newfloat} для определения новых окружений флотов.
+Также он предлагает специальную опцию размещения флота \texttt{H}, которая помещает
+флот «здесь», отключив плавание флота.}
+
+% For floating environments defined with \cs{newfloat} or \cs{restylefloat} the
+% |po|\-|si|\-|tion| option has no effect on the main caption anymore, since its
+% placement and spacing will be controlled by the selected float style instead.
+Для окружений флотов, определённых с~помощью команд \cs{newfloat} или
+\cs{restylefloat} опция
+|po|\-|si|\-|tion| не имеет эффекта, так как механизм размещения и~расстановок
+отбивок контролируется стилем флота пакета \package{float}.
+
+% A caption style and options defined with the name of the float style will be
+% executed additionally to the regular ones.
+% Using this mechanism \thispackage\ emulates the default look \& feel of the
+% |ruled| captions: It defines the caption style
+Стили подписи и~ключи ассоциированные с~названием данного стиля флота
+включаются при запуске данного окружения.
+Используя этот механизм \thispackage\ эмулирует вывод подписей в~стиле
+|ruled|: он определяет стиль подписи
+\begin{quote}
+ |\DeclareCaptionStyle{ruled}%|\\
+ | {labelfont=bf,labelsep=space,strut=off}|\mbox{\quad.}
+\end{quote}
+% So to change this you need either define your own caption style called
+% |ruled| or use |\caption|\-|setup[ruled]|\marg{options} to specify additional
+% options.%,
+%e.g.~|\caption|\-|setup[ruled]{labelsep=|\x|colon}|.
+Так, чтобы изменить это вы можете либо определить свой стиль подписи, названный
+|ruled| или использовать |\caption|\-|setup[ruled]|\x\marg{options} и~определить
+дополнительные опции.%,
+
+% Also by using this mechanism the skip between a |boxed| float and its caption
+% is specified, overriding its global value:
+Также, используя этот механизм, отбивка между флотом в~рамке (|boxed|) и~его
+подписью переопределяет значение:
+\begin{quote}
+ |\captionsetup[boxed]{skip=2pt}|
+\end{quote}
+% For changing this, just use |\caption|\-|setup[boxed]{skip=|\x\meta{value}|}|
+% with an appropriate value. Or if you want to use the global |skip| setting
+% instead, you can remove the usage of the local setting for these floats with
+% |\clear|\-|caption|\-|setup[skip]{boxed}|.
+Для изменения этого, используйте |\caption|\-|setup[boxed]{skip=|\x\meta{value}|}|
+с~соответствующим значением. Или, если вам нужно вместо этого использовать общие
+(глобальные) установки ключа |skip|,
+вы можете отменить использование локального определения, задав
+|\clear|\-|caption|\-|setup[skip]{boxed}|.
+
+\begin{Note}
+% Only one single caption can be typeset inside environments defined with
+% |\new|\-|float| or |\re|\-|style|\-|float|, furthermore these environments
+% are not behaving exactly like the pre-defined floats |figure| and |table|.
+% As a consequence many packages do not cooperate well with these.
+% Furthermore the \package{float} package has some caveats \& limitations,
+% so if you just want to define a new simple floating environment---behaving
+% like |figure| or |table|---I recommend using |\Declare|\-|Caption|\-|Type|
+% instead.
+% And for defining non-simple floating environments and customization I
+% recommend using |\Declare|\-|New|\-|Float|\-|Type| offered by the
+% \package{floatrow} package\cite{floatrow}.
+Внутри окружений определённых командами |\new|\-|float| или |\re|\-|style|\-|float|
+можно задать только одну подрисуночную подпись, кроме того
+эти окружения работают не так, как
+определённые в~стандартном \LaTeX'е |figure| и~|table|.
+В~результате множество пакетов не может быть кооперироваться с~данным пакетом.
+Более того пакет \package{float} имеет некоторые недостатки и~ограничения, поэтому, если
+вам нужно определить новое окружение, работающее как
+|figure| или |table| \cdash--- я рекомендовал бы для этого использовать команду
+|\Declare|\-|Caption|\-|Type|.
+А~для определения других окружений флотов и~их настройки можно
+использовать команду |\Declare|\-|New|\-|Float|\-|Type| из пакета
+\package{floatrow}\cite{floatrow}.
+\end{Note}
+
+\iffalse
+% Please also note that you \emph{don't} need a |\restyle|\-|float| for using
+% the ``|H|'' float placement specifier. Some docs say so, but they are
+% wrong.
+% And |\restyle|\-|float{table}| is a very good method to shoot yourself
+% in the foot, since many packages using |table| internally are not working
+% correctly afterwards.
+Обратите внимание, что вам \emph{не} нужно задавать |\restyle|\-|float| для использования
+опции размещения «|H|». Некоторые руководства советуют это, но это неверно.
+А~задание |\restyle|\-|float{table}| хороший способ сбить себя с~ног,
+поскольку многие пакеты, использующие в~своих макрокомандах окружение |table| перестают
+работать.
+\fi
+
+\pagebreak[3]
+\subsection{Пакет floatflt}
+\label{floatflt}
+\packagedescription{%
+% The \package{floatflt} package\cite{floatflt} offers figures and tables
+% which do not span the full width of a page and are float around by text.}
+Пакет \package{floatflt}\cite{floatflt} предлагает окружения небольших
+рисунков и~таблиц,
+обтекаемых текстом.}
+
+\NEWfeature{v3.1}
+% If you want to setup special options for the |float|\-|ing|\-|figure| and
+% |float|\-|ing|\-|table| environments you can use
+Если вы хотите задать специальные опции для окружений |floating|\-|figure|
+и~|floating|\-|table|,
+можно задать
+\begin{quote}
+ |\captionsetup[floatingfigure]|\marg{options}\quad\emph{и}\\
+ |\captionsetup[floatingtable]|\marg{options}\quad.
+\end{quote}
+% These options will be executed additionally to the regular ones for
+% |figure| resp.~|table|.
+Эти опции будут добавлены соответственно к~основным для |figure| или |table|.
+
+\begin{Note}
+% The |margin| resp.~|width| setting will not be used for these figures resp.~tables,
+% unless you set it explicit with |\caption|\-|setup[floating|\-|figure]{|\ldots|}|
+% resp.~|\caption|\-|setup[floating|\-|table]{|\ldots|}|.
+Настройки ключей |margin| или |width| не используются для таких рисунков или таблиц,
+только если вы не зададите их строго,
+внутри |\caption|\-|setup[floating|\-|figure]{|\ldots|}| или
+|\caption|\-|setup[floating|\-|table]{|\ldots|}|.
+\end{Note}
+
+\pagebreak[3]
+\subsection{Пакет fltpage}
+\label{fltpage}
+\packagedescription{%
+% The \package{fltpage} package\cite{fltpage} offers the outhouse of the
+% caption for |figure|s or |table|s which needs the whole page
+% for its contents. This will be done by placing the caption on the bottom
+% of the previous or next page.}
+Пакет \package{fltpage}\cite{fltpage} предлагает внешнюю подпись для флотов
+|figure| или |table|, содержимое которых занимает целую страницу.
+Подпись при этом размещается на предыдущей или следующей странице [на развороте].}
+
+\NEWfeature{v3.1}
+% Two options control the links to the environments |FPfigure| and |FPtable|:
+Следующие ключи контролируют ссылки на окружения |FPfigure| и~|FPtable|:
+\begin{description}
+% \item{\texttt{FPlist=caption} or \texttt{FPlist=figure}}\\[\smallskipamount]
+% If set to |caption|, the list entry will link to the caption; if set to
+% |figure|, it will link to the figure contents.
+% (The default setting is |FP|\-|list=|\x|caption|.)
+% \item{\texttt{FPref=caption} or \texttt{FPref=figure}}\\[\smallskipamount]
+% If set to |caption|, a \cs{ref}, \cs{pageref}, \cs{autoref}, or \cs{nameref}
+% will link to the caption; if set to |figure|, it will link to the figure contents.
+% (The default setting is |FP|\-|ref=|\x|figure|.)
+ \item{\texttt{FPlist=caption} или \texttt{FPlist=figure}}\\[\smallskipamount]
+Если определена опция |caption|, ссылка в~Списке рисунков будет относиться к~подписи; а~если
+|figure| \cdash--- то к~содержимому флота.
+(Значение по умолчанию |FPlist=|\x|caption|.)
+\item{\texttt{FPref=caption} или \texttt{FPref=figure}}\\[\smallskipamount]
+Если определена опция |caption|, ссылки \cs{ref}, \cs{pageref}, \cs{autoref}, или \cs{nameref}
+будут привязаны к~подписи; а~если |figure| \cdash--- то к~содержимому флота.
+(Значение по умолчанию |FPref=figure|.)
+\end{description}
+
+% If you want to setup special options for the |FPfigure| and |FPtable|
+% environments you can use
+Если вы хотите задать специальные настройки для окружений |FPfigure| и~|FPtable|
+вы можете использовать
+\begin{quote}
+ |\captionsetup[FPfigure]|\marg{options}\quad\emph{и}\\
+ |\captionsetup[FPtable]|\marg{options}\quad.
+\end{quote}
+% These options will be executed additionally to the regular ones for
+% |figure| or |table|.
+Эти опции будут заданы дополнительно к~основным настройкам для
+|figure| или |table|.
+
+% Furthermore |\Declare|\-|Caption|\-|Type|\marg{name} will also define
+% an environment called |FP|\meta{name} which behaves like |FP|\-|figure| and
+% |FP|\-|table|.
+Помимо этого команда \cs{DeclareCaptionType}\marg{name} также определит
+окружение |FP|\meta{name}, которое будет аналогично |FPfigure| и~|FPtable|.
+
+\pagebreak[3]
+\subsection{Пакет hyperref}
+\label{hyperref}
+\packagedescription{%
+% The \package{hyperref} package\cite{hyperref} is used to handle cross
+% referencing commands in LaTeX to produce hypertext links in the document.}
+Пакет hyperref\cite{hyperref} используется для управления командами перекрёстных ссылок
+в~\LaTeX'е для создания гипертекстовых ссылок внутри документа.}
+
+\NEWfeature{v3.1}
+% There are two options available to control the placement of hyperlink
+% anchors:~\footnote{These options are named after the \package{hypcap} package
+% which they supersede.}
+Существуют два ключа, контролирующих размещение гиперссылок:\footnote{Эти
+опции названы по пакету \package{hypcap}, который они заменяют.}
+\begin{description}
+% \item{\texttt{hypcap=true} or \texttt{hypcap=false}}\\[\smallskipamount]
+% If set to |true| all hyperlink anchors -- where entries in the
+% List of Figures, |\ref|, and |\auto|\-|ref| will link to -- are placed at
+% the beginning of the (floating) environment.\par
+% If set to |false| the hyperlink anchor is (usually) placed at the caption.\par
+% (The default setting is |hypcap=|\x|true|.)
+\item{\texttt{hypcap=true} или \texttt{hypcap=false}}\\[\smallskipamount]
+Если задана опция |true| все гиперссылки \cdash--- записи в~Списках рисунков (таблиц),
+команды |\ref| и~|\autoref| \cdash--- будут привязаны
+к~началу окружения флота.\par
+Если задана опция |false| гиперссылки (обычно) привязываются к~подписи.\par
+(Значение по умолчанию |hypcap=true|.)
+% \item{\texttt{hypcapspace=}\meta{amount}}\\[\smallskipamount]
+% Because it looks poor if the hyperlink points exactly at the top of
+% the figure or table, you can specify a vertical distance between
+% the hyperlink anchor and the (floating) environment itself,
+% e.g.~|hyp|\-|cap|\-|space=|\x|0pt| removes this distance.\par
+% (The default setting is |hypcapspace=0.5\baselineskip|.)
+\item{\texttt{hypcapspace=}\meta{amount}}\\[\smallskipamount]
+Поскольку это выглядит плохо, если гиперссылка попадает точно вверх рисунка или таблицы,
+вы можете задать специальный параметр расстояния между привязкой гиперссылки
+и~окружением флота,
+например, |hyp|\-|cap|\-|space=|\x|0pt| убирает это расстояние.\par
+(Значение по умолчанию |hypcapspace=0.5\baselineskip|.)
+\end{description}
+
+% Both settings have no effect in |lst|\-|listing|s (provided by the
+% \package{listings} package), |long|\-|table|s (provided by the
+% \package{longtable} package), |super|\-|tabular|s (provided by the
+% \package{supertabular} package), and |x|\-|tabular|s (provided by the
+% \package{xtab} package), within these environments hyperlink
+% anchors will always be placed as if |hyp|\-|cap=|\x|true| and
+% |hyp|\-|cap|\-|space=|\x|0pt| would be set.
+Обе настройки не имеют эффекта в~окружениях |lstlisting| (предлагаемом пакетом
+\package{listings}), |longtable| (предлагаемом пакетом
+\package{longtable}), |super|\-|tabular| (предлагаемом пакетом
+\package{supertabular}) и |xtabular| (предлагаемом пакетом \package{xtab}),
+внутри этих окружений гиперссылки всегда будут заданы так,
+будто заданы опции |hyp|\-|cap=|\x|true| и~|hyp|\-|cap|\-|space=|\x|0pt|.
+
+%\pagebreak[3]Please note:\nopagebreak
+\pagebreak[3]Обратите внимание:\nopagebreak
+\begin{description}
+% \item{\cs{captionof}\marg{type}\csmarg{\purerm\ldots}
+% vs.~\cs{captionsetup}\csmarg{type=\textrm{\meta{type}}}$+$\cs{caption}\csmarg{\purerm\ldots}}%
+% \\[\smallskipamount]
+% Without \package{hyperref} loaded, both will give you identical results.
+% But with \package{hyperref} loaded, and with |hyp|\-|cap=|\x|true| requested,
+% the hyperlink anchor will be placed different.
+% For example:
+\item{\cs{captionof}\marg{type}\csmarg\ldots\ и~%
+ \cs{captionsetup}\csmarg{type=\textrm{\meta{type}}}$+$\cs{caption}\csmarg\ldots}\\[\smallskipamount]
+Без пакета \package{hyperref}, дадут вам идентичные результаты.
+Но с~загруженным пакетом \package{hyperref}, и~с~опцией |hypcap=|\x|true|,
+гиперссылка будет другой. Например:
+\begin{quote}
+|\begin{minipage}{\linewidth}|\\
+| |\ldots\\
+| \captionof{figure}{A figure}|\\
+|\end{minipage}|
+\end{quote}
+% will place the hyperlink anchor at the caption.
+% (And if |hyp|\-|cap=|\x|true| is set, you will get a warning about this.)
+% But
+Поместит гиперссылку в~подпись.
+(А~если задана опция |hyp|\-|cap=|\x|true|, вы получите предупреждение.)
+Но
+\begin{quote}
+|\begin{minipage}{\linewidth}|\\
+| \captionsetup{type=figure}|\\
+| |\ldots\\
+| \caption{A figure}|\\
+|\end{minipage}|
+\end{quote}
+% will place the hyperlink anchor at the beginning of the |mini|\-|page|,
+% since |\caption|\-|setup{type=|\x|figure}| does not only set the caption type
+% to ``figure'' but does place a hyperlink anchor, too.
+поместит гиперссылку в~начало окружения |mini|\-|page|,
+поскольку команда |\caption|\-|setup|\x|{type=|\x|figure}| не только задаёт настройки для
+флота «figure», но также помещает гиперссылку.
+
+% \item{\cs{caption}\csoarg{}\csmarg{\purerm\ldots}
+% vs.~\cs{captionsetup}\csmarg{list=false}$+$\cs{caption}\csmarg{\purerm\ldots}}\\[\smallskipamount]
+\item{\cs{caption}\csoarg{}\csmarg\ldots\ и~%
+ \cs{captionsetup}\csmarg{list=false}$+$\cs{caption}\csmarg\ldots}\\[\smallskipamount]
+% Again, without \package{hyperref} loaded, both will give you identical results.
+% But with \package{hyperref} loaded, the difference is in the nuances.
+% So for example the optional argument of |\caption| will also be written to
+% the |aux| file, and will be used by the |\name|\-|ref| command.
+% So if you choose to use |\caption| with empty optional argument,
+% |\name|\-|ref| will also give you an empty result.
+% So it's better to use |\caption|\-|setup{list=|\x|false}| if you don't
+% want an entry in the List of Figures or List of Tables.
+Опять же, без пакета \package{hyperref}, оба варианта дадут одинаковый результат.
+А~с~загруженным пакетом \package{hyperref}, отличие будет в~нюансах.
+Так, например, дополнительный аргумент команды |\caption| также будет записан в~%
+|aux|-файл, и~также будет использоваться команда |\name|\-|ref|.
+Поэтому, если вы используете команду подписи~|\caption| с~пустым дополнительным аргументом, команда
+|\name|\-|ref| также даст вам «пустой» результат.
+Поэтому лучше использовать \cs{captionsetup}\csmarg{list=false}, если вам не нужно
+записывать рисунок в~Список рисунков или таблиц.
+\end{description}
+
+\pagebreak[3]
+\subsection{Пакет hypcap}
+\label{hypcap}
+\packagedescription{%
+% The \package{hyp\-cap} package\cite{hypcap} offers a solution to the problem
+% that links to a float using \package{hyper\-ref} may anchors to the caption
+% rather than the beginning of the float.
+% Since \thispackage\ \version{3.1} already solves this problem for itself,
+% the \package{hypcap} package is usually not needed.}
+% %, at least when you use \thispackage.}
+Пакет \package{hypcap}\cite{hypcap} предлагает решение проблем, связанных с~флотами
+при использовании пакета \package{hyperref}, который помещает гиперссылки в~подпись,
+а~не в~начало флота.
+Поскольку \thispackage\ \version{3.1} уже решил эту проблему своими средствами,
+пакет \package{hypcap} обычно не нужен.%
+% , когда вы используете
+% \thispackage.
+}
+
+% If the \package{hyp\-cap} package is loaded additionally to the
+% \package{hyper\-ref} package, it takes over the control of the hyperlink
+% anchor placement from \thispackage, overriding the options |hyp|\-|cap=|
+% and |hyp|\-|cap|\-|space=|.
+Если пакет \package{hypcap} загружен дополнительно к~пакету \package{hyperref},
+то контроль за гиперссылками переходит от пакета \package{caption} к~нему,
+перекрывая опции ключей |hypcap=| и~|hyp|\-|cap|\-|space=|.
+
+% So for a manual placement of hyperlink anchors
+% |\caption|\-|setup{type=|\x\meta{type}|}| is not sufficient anymore,
+% instead you need to use |\cap|\-|start| (provided by the \package{hyp\-cap}
+% package) for this.
+Поэтому для ручного размещения гиперссылки |\caption|\-|setup{type=|\x\meta{type}|}|
+уже не годится, и~вместо этого вы должны использовать команду |\capstart|
+(предлагаемую пакетом \package{hypcap}).
+
+% Regarding the automatically placement the \package{hypcap} package offers good
+% placement of hyperlink anchors for the floating environments |figure| and
+% |table| only. In contrast the |hypcap=|\x|true| option of \thispackage\ also
+% offers good placements of hyperlink anchors for
+% |floating|\-|figure|s (provided by the \package{float\-flt} package),
+% |FP|\-|figure|s \& |FPtable|s (provided by the \package{flt\-page} package),
+% |fig|\-|window|s (provided by the \package{pic\-in\-par} package),
+% |par|\-|pic|s (provided by the \package{pic\-ins} package),
+% |SC|\-|figure|s (provided by the \package{side\-cap} package),
+% |three|\-|part|\-|table|s (provided by the \package{three\-part\-table} package),
+% and |wrapfigure|s (provided by the \package{wrap\-fig} package).%---%
+% %so by loading the \package{hypcap} package additionally you will
+% %loose that.
+При автоматическом размещении гиперссылок, пакет \package{hypcap} задаёт верное
+размещение только для окружений |figure| и~%
+|table|. В~то время как опция ключа |hypcap=true| пакета \package{caption}, предлагает также
+корректное размещения ссылок для окружений
+|floating|\-|figure| (предлагаемого пакетом \package{floatflt}),
+|FPfigure| и~|FPtable| (предлагаемых пакетом \package{fltpage}),
+|figwindow| (предлагаемого пакетом \package{picinpar}),
+|parpic| (предлагаемого пакетом \package{picins}),
+|SCfigure| (предлагаемого пакетом \package{sidecap}),
+|three|\-|part|\-|table| (предлагаемого пакетом \package{threeparttable}),
+и~|wrap|\-|figure| (предлагаемого пакетом \package{wrapfig}).%---%
+%поэтому, загружая пакет \package{hypcap}, вы теряете эти возможности.
+
+\pagebreak[3]
+\subsection{Пакет listings}
+\label{listings}
+\packagedescription{%
+% The \package{listings} package\cite{listings} typesets programming code.}
+Пакет \package{listings}\cite{listings} помогает распечатать программный код.}
+
+% If you want to setup special options for the |lst|\-|listing| environment
+% you can use
+Если вы желаете создать специальные опции для окружения |lstlinsting|
+вы можете использовать
+\begin{quote}
+ |\captionsetup[lstlisting]|\marg{options}\quad.
+\end{quote}
+
+% Please note that the \package{listings} package has its very own options
+% for controlling the position and the skips of the caption:
+% |caption|\-|pos=|, |above|\-|caption|\-|skip=|, and |below|\-|caption|\-|skip=|.
+% \See{\package{listings} documentation for details.}
+% These \package{listings} options override the \package{caption}'s ones, but
+% can be again overwritten by |\caption|\-|setup[lst|\-|listing]{|\ldots|}|,
+% e.g.%~
+Обратите внимание, что пакет \package{listings} имеет собственные опции
+для контроля расположения отбивок вокруг подписи:
+|caption|\-|pos=|, |above|\-|caption|\-|skip=|, и~|below|\-|caption|\-|skip=|.
+\See{подробнее в~документации пакета \package{listings}.}
+Опции пакета \package{listings} переопределяют опции \package{caption}, но
+могут быть в~свою очередь переписаны с~помощью настроек
+|\caption|\-|setup[lst|\-|listing]{|\ldots|}|,
+например,
+\begin{quote}|\caption|\-|setup[lst|\-|listing]{skip=|\x|10pt}|\quad.\end{quote}
+
+\pagebreak[3]
+\subsection{Пакет longtable}
+\label{longtable}
+\packagedescription{%
+% The \package{longtable} package\cite{longtable} offers an environment
+% which behaves similar to the \texttt{tabular} environment, but the table
+% itself can span multiple pages.}
+Пакет \package{longtable}\cite{longtable} предлагает окружение,
+которое работает аналогично \texttt{tabular}, но табличный материал может занимать
+несколько страниц.}
+
+% If you want to setup special options for the |long|\-|table| environment
+% you can use
+Если вы желаете создать специальные настройки для окружения |long|\-|table|
+вы можете использовать
+\begin{quote}
+ |\captionsetup[longtable]|\marg{options}\quad.
+\end{quote}
+% These options will be executed additionally to the regular ones for
+% |table|.
+Эти опции будут добавлены к~основным настройкам для
+|table|.
+
+% The |margin| and |width| settings usually override |\LT|\-|cap|\-|width|,
+% so you get an equal look \& feel of the captions in |table|s and
+% |long|\-|table|s.
+% But if you set |\LT|\-|cap|\-|width| to a value different than its default
+% $=$ |4in|, \thispackage\ will follow that.
+% (But |\LT|\-|cap|\-|width| will be overwritten by
+% |\caption|\-|setup[long|\-|table]{width=|\x\meta{value}|}|,
+% even if it is set to a value different than |4in|.)
+Настройки ключей |margin| и~|width| обычно перекрывают значение команды
+|\LTcapwidth|, поэтому
+вы можете получить идентичное оформление для подписей в~окружениях |table| и~%
+|longtable|.
+Но если вы зададите значение |\LT|\-|cap|\-|width| отличное от заданного по умолчанию,
+что равно ${}={}$|4in|, \thispackage\ будет использовать это значение.
+(Но |\LTcapwidth| будет переписано последующей настройкой
+|\caption|\-|setup[long|\-|table]{width=|\x\meta{value}|}|, даже если оно задано
+отличным от~|4in|.)
+
+\begin{Note}
+% |\caption|\-|of| and |\Continued|\-|Float| do \emph{not} work for |long|\-|table|s.
+% Furthermore neither |\caption| nor |\caption|\-|list|\-|entry| will increment
+% the |table| counter here; it's incremented by the |long|\-|table| environment
+% instead.
+% \NEWfeature{v3.1}
+% If you need a |long|\-|table| which does not increment the |table| counter
+% please use the |long|\-|table*| environment (offered by the
+% \package{ltcaption} package which is part of \thispackage\ bundle and will be
+% loaded automatically).
+Команды |\caption|\-|of| и~|\Continued|\-|Float| не работают в~окружениях |long|\-|table|.
+Кроме того ни |\caption| ни |\caption|\-|list|\-|entry| не увеличивают значение счётчика
+таблиц |table|; его значение управляется окружением |long|\-|table|.
+\NEWfeature{v3.1}
+Если вам нужно создать окружение |longtable| без увеличения счётчика таблиц, |table|,
+используйте окружение |longtable*|, предлагаемое пакетом \package{ltcaption},
+который является частью группы пакетов пакета \package{caption} и~загружается автоматически.
+\end{Note}
+
+\pagebreak[3]
+\subsection{Пакет picinpar}
+\label{picinpar}
+\packagedescription{%
+% Similar to the \package{floatflt} package the \package{picinpar}
+% package\cite{picinpar} offers figures and tables which do not span the full
+% width of a page and are float around by text.
+% For a detailed discussion about the differences between these packages
+% please take a look at The \LaTeX\ Companion\cite{TLC2}.}
+Аналогичный пакету \package{floatflt}, пакет \package{picinpar}%
+\cite{picinpar} предлагает окружения небольших рисунков и~таблиц, обтекаемых текстом.
+За более подробной информацией о~различиях пакетов обращайтесь
+к~\LaTeX\ Companion\cite{TLC2}.}
+
+\NEWfeature{v3.1}
+% If you want to setup special options for the |fig|\-|window| and
+% |tab|\-|window| environments you can use
+Если вам нужны специальные настройки для окружений |figwindow| и~|tabwindow|
+вы можете задать
+\begin{quote}
+ |\captionsetup[figwindow]|\marg{options}\quad\emph{и}\\
+ |\captionsetup[tabwindow]|\marg{options}\quad.
+\end{quote}
+% These options will be executed additionally to the regular ones for
+% |figure| or |table|.
+Эти настройки будут добавлены к~основным настройкам
+|figure| или |table|.
+
+\begin{Note}
+% The |margin| resp.~|width| setting will not be used for these figures and tables,
+% unless you set it explicit with |\caption|\-|setup[fig|\-|window]{|\ldots|}| or
+% |\caption|\-|setup[fig|\-|table]{|\ldots|}|.
+Настройки ключей |margin| и~|width| не используются для этих рисунков и~таблиц,
+только если вы не зададите строго |\caption|\-|setup|\x|[figwindow]{|\ldots|}| или
+|\caption|\-|setup|\x|[figtable]{|\ldots|}|.
+\end{Note}
+
+\pagebreak[3]
+\subsection{Пакет picins}
+\label{picins}
+\packagedescription{%
+% Similar to the \package{floatflt} and \package{picinpar} package the
+% \package{picins} package\cite{picins} offers figures and tables which do not
+% span the full width of a page and are float around by text.
+% For a detailed discussion about the differences between these packages
+% please take a look at The \LaTeX\ Companion\cite{TLC2}.}
+Аналогичен пакетам \package{floatflt} и~\package{picinpar}
+\package{picins}\cite{picins} предлагает окружения небольших рисунков и~таблиц, обтекаемых текстом.
+За более подробной информацией о~различиях пакетов обращайтесь
+к~\LaTeX\ Companion\cite{TLC2}.}
+
+\NEWfeature{v3.1}
+% If you want to setup special options for the |par|\-|pic| environment you can use
+Если вы хотите задать специальные настройки для окружения |parpic| вы можете задать
+\begin{quote}
+ |\captionsetup[parpic]|\marg{options}\quad.
+\end{quote}
+% These options will be executed additionally to the regular ones for
+% |figure| or |table|.
+Эти настройки будут добавлены к~основным настройкам
+|figure| или |table|.\par
+
+% Furthermore |\pic|\-|caption[]{|\ldots|}| produce no entry in the List of Figures,
+% and |\pic|\-|caption*{|\ldots|}| gives an unlabeled \& unnumbered caption.
+Помимо этого команда |\pic|\-|caption[]{|\ldots|}| не создаёт записи в~Списке рисунков,
+а~команда |\pic|\-|caption*{|\ldots|}| задаёт подпись без нумерационного заголовка.
+
+\begin{Note}
+% The |margin| resp.~|width| setting will not be used for these figures and tables.
% \iffalse
-% \captionsetup{labelfont=bf}
+% if |pic|\-|caption|\-|side| or |pic|\-|caption|\-|top|\-|side| is used.
+% The |width| setting will not be used (but the |margin| setting will) if
+% |pic|\-|caption|\-|out|\-|side| or |pic|\-|caption|\-|in|\-|side| is used.
% \fi
-% \caption[]{A small example with the caption beside the figure.}
-% \end{SCfigure}
-% \captionsetup{labelfont=default}
-%
-% \fi
-%
-% \iffalse
+% But you can override this by setting it explicit with
+% |\caption|\-|setup[par|\-|pic]{|\ldots|}|.
+Настройки ключей |margin| и~|width| не используются для этих рисунков и~таблиц.
+\iffalse
+если заданы команды |pic|\-|caption|\-|side| или |pic|\-|caption|\-|top|\-|side|.
+Настройки ключа |width| не будут использоваться (но ключ |margin| будет), если
+заданы команды |pic|\-|caption|\-|out|\-|side| или |pic|\-|caption|\-|in|\-|side|.
+\fi
+Но это можно переопределить настройками
+|\caption|\-|setup[par|\-|pic]{|\ldots|}|.
+\end{Note}
+
+% If you want to have a |\pic|\-|caption| of another type as |figure|, please
+% do \emph{not} re-define |\@cap|\-|type| as suggested by the \package{picins}
+% documentation. Please use the |\pic|\-|caption|\-|type|\marg{type} command
+% which is offered by \thispackage\ instead, e.g.:
+Если вам нужно задать подпись, |\piccaption|, не для |figure|, а~для другого типа флота,
+\emph{не} переопределяйте команду |\@captype|, как предложено в~документации пакета
+\package{picins}.
+Используйте команду |\piccaptiontype|\marg{type}, предлагаемую данным пакетом,
+например:
+\begin{quote}
+ |\piccaptiontype{table}|\\
+ |\piccaption{An example table}|\\
+ |\parpic(50mm,10mm)[s]{|\ldots|}|
+\end{quote}
+
+\pagebreak[3]
+\subsection{Пакет rotating}
+\label{rotating}
+\packagedescription{%
+% The \package{rotating} package\cite{rotating} offers the floating
+% environments \texttt{side\-ways\-figure} and \texttt{side\-ways\-table} which
+% are just like normal figures and tables but rotated by 90 resp.~270 degree.
+% Furthermore a command \cs{rot\-caption} is offered for rotated captions only.}
+Пакет \package{rotating}\cite{rotating} предлагает окружения флотов
+\texttt{side\-ways\-figure} и~\texttt{side\-ways\-table}
+которые являются теми же рисунками и~таблицами, но развёрнутыми на 90~градусов.
+Помимо этого используется команда \cs{rotcaption} для поворота только подписей.}
+
+\iffalse % No, we don't do that
+% If you want to setup special options for the |side|\-|ways|\-|figure| and
+% |side|\-|ways|\-|table| environments you can use
+Если вы хотите задать настройки для окружений |sidewaysfigure| и~|sidewaystable|
+вы можете задать
+\begin{quote}
+ |\captionsetup[sidewaysfigure]|\marg{options}\\
+ |\captionsetup[sidewaystable]|\marg{options}\quad.
+\end{quote}
+Эти настройки будут добавлены к~основным настройкам
+|figure| или |table|.\par
+\fi
+
+% The command |\rot|\-|caption| will be extended by \thispackage, so
+% |\rot|\-|caption*| and |\rot|\-|caption|\-|of| can be used analogous to
+% |\caption*| and |\caption|\-|of|.
+Команда |\rot|\-|caption| была расширена данным пакетом, поэтому
+|\rot|\-|caption*| или |\rot|\-|caption|\-|of| могут быть использованы аналогично
+командам |\caption*| и~|\captionof|.
+
+\NEWfeature{v3.1}
+% Furthermore |\Declare|\-|Caption|\-|Type|\marg{name} will also define
+% an environment called |side|\-|ways|\meta{name} which behaves like
+% |side|\-|ways|\-|figure| and |side|\-|ways|\-|table|.
+Помимо этого команда |\Declare|\-|Caption|\-|Type|\marg{name} определит
+окружение, называемое |side|\-|ways|\meta{name}, которое работает аналогично
+|side|\-|ways|\-|figure| и~|side|\-|ways|\-|table|.
+
+\pagebreak[3]
+\subsection{Пакет setspace}
+\label{setspace}
+\packagedescription{%
+% The \package{setspace} package\cite{setspace} offers options and commands
+% to change the spacing,
+% e.g.\ \cs{usepackage}\x\csoarg{one\-half\-spacing}\x\csmarg{set\-space}
+% causes the document to be typeset in one-and-a-half spacing.}
+Пакет \package{setspace}\cite{setspace} предлагает опции и~команды для
+изменения интерлиньяжа,
+например \cs{usepackage}\x\csoarg{one\-half\-spacing}\x\csmarg{set\-space}
+создаст документ, распечатанный с~полуторным интерлиньяжем.}
+
+% If the \package{setspace} package is used in conjunction with \thispackage,
+% the caption will be typeset with single spacing as default. This can be changed
+% by specifying either |font=|\x|one|\-|half|\-|spacing|,
+% |font=|\x|double|\-|spacing|, or |font={stretch=|\x\meta{amount}|}|.
+% \See{also \Ref{fonts}}
+Если пакет \package{setspace} используется вместе с~данным пакетом,
+подпись будет напечатана с~одинарным интерлиньяжем. Это можно переопределить,
+задав либо |font=onehalfspacing|, |font=doublespacing|, либо
+|font={stretch=|\meta{amount}|}|. \See{также \Ref{fonts}}
+
+\pagebreak[3]
+\subsection{Пакет sidecap}
+\label{sidecap}
+\packagedescription{%
+% The \package{sidecap} package\cite{sidecap} offers the floating environments
+% \texttt{SC\-figure} and \texttt{SC\-table} which are like usual figures
+% and tables but the caption will be put \emph{beside} the contents.}
+Пакет \package{sidecap}\cite{sidecap} предлагает окружения флотов
+|SCfigure| и~|SCtable|, которые являются теми же рисунками и~таблицами,
+но подписи помещаются \emph{сбоку} содержимого.}
+
+% If you want to setup special options for the |SCfigure| and |SCtable|
+% environments you can use
+Если вам нужно задать настройки для окружений |SCfigure| и~|SCtable|
+вы можете задать
+\begin{quote}
+ |\captionsetup[SCfigure]|\marg{options}\quad\emph{and}\\
+ |\captionsetup[SCtable]|\marg{options}\quad.
+\end{quote}
+% These options will be executed additionally to the regular ones for
+% |figure| or |table|.
+Эти настройки будут добавлены к~основным настройкам
+|figure| или |table|.\par
+
+\pagebreak[3]
+\NEWfeature{v3.1}
+% Furthermore |\Declare|\-|Caption|\-|Type|\marg{name} will also define
+% an environment called |SC|\meta{name} which behaves like |SC|\-|figure| and
+% |SC|\-|table|.
+Помимо этого команда \cs{DeclareCaptionType}\marg{name} может определить
+окружение |SC|\meta{name}, которое работает аналогично |SCfigure| и~|SCtable|.
+
+\pagebreak[3]
+\begin{Note}
+% The \package{sidecap} package offers its own options for justification.
+% If set, they will override the one specified with the caption option
+% |jus|\-|ti|\-|fi|\-|ca|\-|tion=| for captions beside their contents.
+Пакет \package{sidecap} предлагает опции для выключки подписей.
+И~если они заданы, то они переопределят настройки ключа
+|justification=| для подписей стоящих сбоку.
+\end{Note}
+
+\begin{Note}
+% The |margin| resp.~|width| setting will not be used for these figures and tables,
+% unless you set it explicit with |\caption|\-|setup[SC|\-|figure]{|\ldots|}|
+% or |\caption|\-|setup[SC|\-|table]{|\ldots|}|.
+Настройки ключей |margin| и~|width| не используются для этих рисунков и~таблиц,
+только если вы не зададите строго |\captionsetup|\x|[SCfigure]|\x|{|\ldots|}|
+или |\captionsetup|\x|[SCtable]|\x|{|\ldots|}|.
+\end{Note}
+
+\medskip
+
+\begin{Annotation*}
+% Instead of using the \package{sidecap} package you can also use the more
+% powerful and flexible \package{floatrow} package\cite{floatrow} for typesetting
+% captions beside the contents.
+Вместо использования пакета \package{sidecap} вы можете воспользоваться
+пакетом \package{floatrow}\cite{floatrow} для размещения подписей сбоку флотов.
+\end{Annotation*}
+
+\pagebreak[3]
+% \subsubsection*{Undocumented features}
+% The \package{sidecap} package \version{1.6} has some undocumented package
+% options and commands which allow further customization of the side-captions:
+\subsubsection*{Недокументированные особенности}
+Пакет \package{sidecap} версии \version{1.6} имеет некоторые недокументированные
+опции и~команды которые позволяют задать дополнительные настройки:
+
+\pagebreak[3]
+\DescribeMacro{margincaption}
+% The package option
+Опция пакета
+\begin{quote}
+ |margincaption|\qquad{\small(e.g.~|\usepackage[margincaption]{sidecap}|)}
+\end{quote}
+% causes all side-captions to be placed into the margin.
+позволяет поместить все подписи сбоку на поле.
+
+\pagebreak[3]
+\DescribeMacro{\sidecaptionvpos}
+% The command
+Команда
+\begin{quote}
+ |\sidecaptionvpos|\marg{float type}\marg{pos}
+\end{quote}
+% sets the vertical position of the side-caption. \meta{pos} can be either `|t|'
+% (for top alignment), `|b|' (for bottom alignment), or `|c|' (for center alignment).
+% The default setting for |table| is `|t|', for |figure| and all other ones
+% defined with |\Declare|\-|Caption|\-|Type| it's `|b|'.
+задаёт вертикальное положение подписи. Аргумент \meta{pos} может быть либо `|t|'
+(для выравнивания по верху), `|b|' (для выравнивания по низу), или `|c|'
+(для выравнивания по центру).
+Значение по умолчанию для таблиц, |table|, \cdash--- `|t|',
+для рисунков, |figure|, и~всех других окружений, определённых
+с~помощью |\Declare|\-|Caption|\-|Type| \cdash--- `|b|'.
+
+\pagebreak[3]
+\subsection{Пакет subfigure}
+\label{subfigure}
+\packagedescription{%
+% The \package{subfigure} package\cite{subfigure} provides support for small or
+% `sub' figures and tables within a single figure or table environment.
+% This package is obsolete, new users should use \package{subfig} instead.}
+Пакет \package{subfigure}\cite{subfigure} предлагает поддержку для частей флотов (подфлотов)
+внутри одного окружения |figure| или |table|.
+Этот пакет является устаревшим, новые пользователям рекомендуется пакет \package{subfig}.}
+
+% Since the \package{subfigure} package is obsolete it will only be supported in
+% a way that old documents (which have used \thispackage\ \version{1.x} during
+% development) should still compile as expected.
+Поскольку пакет \package{subfigure} устаревший, он поддерживается и~компилируется только в~старых документах
+(использующих \thispackage\ \version{1.x}).
+
+% Please use the \package{subfig} package instead with supports \thispackage\
+% \version{3.x}.
+Вместо этого используйте, пожалуйста, пакет \package{subfig}; его поддерживает \thispackage\
+\version{3.x}.
+
+% \See{the \package{subfig} package\cite{subfig} documentation for details.}
+\See{документацию пакета \package{subfig}\cite{subfig}.}
+
+\pagebreak[3]
+\subsection{Пакеты supertabular и~xtab}
+\label{supertabular}
+\packagedescription{%
+% The \package{supertabular}\cite{supertabular} and \package{xtab}\cite{xtab}
+% packages offer an environment which can span multiple pages and is quite
+% similar to the \texttt{long\-table} environment provided by the
+% \package{longtable} package\cite{longtable}.
+% For a detailed discussion about the differences between these powerful
+% packages please take a look at The \LaTeX\ Companion\cite{TLC2}.}
+Пакеты \package{supertabular}\cite{supertabular} и~\package{xtab}\cite{xtab}
+предлагают окружение,
+аналогичное \texttt{long\-table}, (пакет \package{longtable}\cite{longtable}),
+которое может разбиваться на несколько страниц.
+Детальные объяснения различий этих мощных пакетов
+см.~в~\LaTeX\ Companion\cite{TLC2}.}
+
+% If you want to setup special options for the |super|\-|tabular|
+% resp.~|x|\-|tabular| environment you can use
+Если вам нужно задать специальные настройки для окружений |super|\-|tabular|
+или~|xtabular| вы можете записать
+\begin{quote}
+ |\captionsetup[supertabular]|\marg{options}\quad\emph{и, соответственно}\\
+ |\captionsetup[xtabular]|\marg{options}\quad.
+\end{quote}
+% These options will be executed additionally to the regular ones for
+% |table|.
+Эти настройки будут добавлены к~основным настройкам
+|figure| или |table|.\par
+
+\begin{Note}
+% |\Continued|\-|Float| does not work for |super|\-|tabular|s and |x|\-|tabular|s.
+Команда |\Continued|\-|Float| не работает с~|super|\-|tabular| и~|xtabular|.
+\end{Note}
+
+\pagebreak[3]
+\subsection{Пакет threeparttable}
+\label{threeparttable}
+\packagedescription{%
+% The \package{threeparttable} package\cite{threeparttable} provides a scheme
+% for tables that have a structured note section after the table contents and
+% the caption.
+% This scheme provides an answer to the old problem of putting footnotes in
+% tables---by making footnotes entirely unnecessary.}
+Пакет \package{threeparttable}\cite{threeparttable}
+предлагает схему для таблиц, имеющих структурированный раздел замечаний после табличного материала
+и~подписи.
+Эта схема предлагает ответ для старой проблемы размещения сносок в~таблицах без необходимости
+создания сносок.}
+
+\NEWfeature{v3.1}
+% If you want to setup special options for the |three|\-|part|\-|table| and
+% |measured|\-|figure| environments you can use
+Если вам нужно создать специальные настройки для окружений
+|three|\-|part|\-|table| и~|measured|\-|figure|,
+вы можете задать
+\begin{quote}
+ |\captionsetup[threeparttable]|\marg{options}\quad\emph{и}\\
+ |\captionsetup[measuredfigure]|\marg{options}\quad.
+\end{quote}
+% These options will be executed additionally to the regular ones for
+% |table| or |figure|.
+Эти настройки будут добавлены к~основным настройкам
+|figure| или |table|.\par
+
+\begin{Note}
+% Since the caption will have the same width as the contents here,
+% the |margin| resp.~|width| setting will not be used for these figures and tables,
+% at least unless you set it explicit with
+% |\caption|\-|setup[three|\-|part|\-|table]{|\ldots|}| or
+% |\caption|\-|setup[measured|\-|figure]{|\ldots|}|.
+Поскольку ширина подписи равна ширине таблицы,
+ключи |margin| и~|width| здесь не используются для рисунков и~таблиц,
+только если вы не зададите строго
+|\caption|\-|setup|\x|[threeparttable]|\x|{|\ldots|}|
+или |\caption|\-|setup|\x|[measuredfigure]|\x|{|\ldots|}|.
+\end{Note}
+
+\medskip
+
+\begin{Annotation*}
+% Instead of using the \package{threeparttable} package you can
+% also use the \package{floatrow} package\cite{floatrow} for this purpose.
+Вместо пакета \package{threeparttable} можно использовать
+пакет \package{floatrow}\cite{floatrow}.
+\end{Annotation*}
+
+\pagebreak[3]
+\subsection{Пакет wrapfig}
+\label{wrapfig}
+\packagedescription{%
+% Similar to the \package{floatflt}, the \package{picinpar}, and the
+% \package{picins} package the \package{wrapfig} package\cite{wrapfig} offers
+% figures and tables which do not span the full width of a page and are float
+% around by text.
+% For a detailed discussion about the differences between these packages
+% please take a look at The \LaTeX\ Companion\cite{TLC2}.}
+Аналогично пакетам \package{floatflt}, \package{picinpar} и~%
+\package{picins}, пакет \package{wrapfig}\cite{wrapfig} предлагает
+окружения небольших рисунков и~таблиц обтекаемых текстом.
+За более подробной информацией о~различиях пакетов обращайтесь
+к~\LaTeX\ Companion\cite{TLC2}.}
+
+\NEWfeature{v3.1}
+% If you want to setup special options for the |wrap|\-|figure| and
+% |wrap|\-|table| environments you can use
+Если вам нужно задать специальные настройки для окружений |wrap|\-|figure|
+и~|wrap|\-|table| вы можете задать
+\begin{quote}
+ |\captionsetup[wrapfigure]|\marg{options}\\
+ |\captionsetup[wraptable]|\marg{options}\quad.
+\end{quote}
+% These options will be executed additionally to the regular ones for
+% |figure| or |table|.
+Эти настройки будут добавлены к~основным настройкам
+|figure| или |table|.\par
+
+% Furthermore |\Declare|\-|Caption|\-|Type|\marg{name} will also define
+% an environment called |wrap|\meta{name} which behaves like |wrap|\-|figure|
+% and |wrap|\-|table|.
+Помимо этого команда |\Declare|\-|Caption|\-|Type|\marg{name} определит
+новое окружение |wrap|\meta{name}, которое аналогично |wrap|\-|figure| и~|wrap|\-|table|.
+
+\begin{Note}
+% The |margin| resp.~|width| setting will not be used for these figures and
+% tables, unless you set it explicit with
+% |\caption|\-|setup[wrap|\-|figure]{|\ldots|}|
+% or |\caption|\-|setup[wrap|\-|table]{|\ldots|}|.
+Настройки ключей |margin| и~|width| не используются для рисунков и~таблиц,
+только если вы не зададите строго |\caption|\-|setup|\x|[wrapfigure]{|\ldots|}|
+или |\caption|\-|setup|\x|[wraptable]{|\ldots|}|.
+\end{Note}
+
+\begin{Note}
+% If the \package{wrapfig} package should be used in coorperation with the
+% \package{float} package, it needs to be loaded \emph{after} the
+% \package{float} package. Furthermore |\new|\-|float| and |\restyle|\-|float|
+% commands \emph{should} be placed after \emph{both} packages have been loaded.
+Если пакет \package{wrapfig} должен быть использован совместно с~пакетом
+\package{float}, то его нужно загрузить \emph{после} пакета
+\package{float}. Кроме того команды |\new|\-|float| или |\restyle|\-|float|
+\emph{должны} быть помещены после загрузки \emph{обоих} пакетов.
+\end{Note}
+
% --------------------------------------------------------------------------- %
-% \fi
-%
-%^^A \subsection{The \package{supertabular} package}
-% \subsection{Пакет \package{supertabular}}
-% \label{supertabular}
-%
-%^^A The \package{supertabular} package\cite{supertabular} offers the environment
-%^^A |supertabular| which is quite similar to the |longtable| environment provided
-%^^A by the \package{longtable} package. Both offers the typesetting of tables
-%^^A which can span multiple pages. For a detailed discussion about the
-%^^A differences between these powerful packages please take a look at
-%^^A The \LaTeX\ Companion\cite{companion}.
-% Пакет \package{supertabular}\cite{supertabular} предлагает окружение
-% |supertabular| которое аналогично |longtable| из пакета
-% \package{longtable}. Оба они предлагают создание таблиц на несколько
-% страниц. Детальный разбор различий этих пакетов
-% приведён в~The \LaTeX\ Companion\cite{companion}.
-%
-% \iffalse
+
+\clearpage
+% \section{Further reading}
+\section{Рекомендуемая литература}
+
+% I recommend the following documents for further reading:
+Я рекомендую следующие документы для дальнейшего чтения:
+
+\begin{itemize}
+\item
+% The \TeX\ FAQ -- Frequently asked questions about \TeX\ and \LaTeX:
+ The \TeX\ FAQ -- ЧаВо по \TeX'у и~\LaTeX'у:
+ \begin{quote}\url{http://faq.tug.org/}\end{quote}
+
+\item
+ A French FAQ can be found at
+ \begin{quote}\url{http://www.grappa.univ-lille3.fr/FAQ-LaTeX/}\end{quote}
+
+\item
+ ``What is a minimal working example?'' from Christian Faulhammer and Ulrich Schwarz:
+ \begin{quote}\url{http://www.minimalbeispiel.de/mini-en.html}\end{quote}
+
+\item
+%^^A \textsf{epslatex} from Keith Reckdahl contains many tips around
+%^^A including graphics in \LaTeXe\ documents.
+%^^A You will find this document in the directory
+ \textsf{epslatex} (Keith Reckdahl) содержит множество подсказок
+ как разместить иллюстрационный материал в~документации созданной в~\LaTeXe.
+ Вы найдете этот файл в~директории
+ \begin{quote}\url{ftp://tug.ctan.org/pub/tex/info/epslatex/}\end{quote}
+\end{itemize}
+
% --------------------------------------------------------------------------- %
-% \fi
-%
-%\begingroup\samepage
-%^^A \subsection{Known incompatibilities}
-% \subsection{Известные несовместимости}
-%
-% \NEWdescription{v3.0b}
-%^^A Using the \thispackage\ package together with one of the following packages
-%^^A is not recommended; usually this would cause unwanted side effects or even
-%^^A errors
-%^^A\footnote{This translation could be obsolete, please check German or English
-%^^A version for new information.}:
-% Использование пакета \thispackage\ вместе с~одним из следующих пакетов
-% не рекомендуется; обычно это даёт неожиданные побочные эффекты или даже
-% ошибки\footnote{Данные перевода этого раздела могут содержать устаревшие данные.
-% Обращайтесь к~английской или немецкой документации за более свежей информацией. \cdash---
-% \emph{Прим. перев.}}:
-% \begin{quote}
-% \package{captcont}, \package{ccaption}, \package{ftcapt}, (\package{hvfloat}),
-% \package{multicap}, \package{topcapt}, \package{nonfloat}
-% \end{quote}
-%\endgroup
-%
-% \iffalse
+
+\pagebreak[3]
+% \section{Thanks}
+\section{Благодарности}
+
+{\fontencoding{T1}%\fontfamily{ptm}
+\selectfont
+I would like to thank Katja Melzner,
+Steven D. Cochran, Frank Mittelbach, Olga Lapko,
+David Carlisle, Carsten Heinz, and Keith Reckdahl.
+Thanks a lot for all your help, ideas, patience, spirit, and support!
+
+Also I would like to thank
+Harald Harders,
+Peter L\"offler,
+Peng Yu,
+Alexander Zimmermann,
+Matthias Pospiech,
+J\"urgen Wieferink,
+Christoph Bartoschek,
+Uwe St\"ohr,
+Ralf Stubner,
+Geoff Vallis,
+Florian Keiler,
+J\"urgen G\"obel,
+Uwe Siart,
+Sang-Heon Shim,
+Henrik Lundell,
+David Byers,
+William Asquith,
+Prof.~Dr.~Dirk Hoffmann,
+Frank Martini,
+Danie Els,
+and
+Markus Kohm,
+who all helped to make this package a better one.}
+
% --------------------------------------------------------------------------- %
-% \fi
-%
-%^^A \section{Compatibility to older versions}
-% \section{Совместимость со старыми версиями}
-% \label{compatibility}
-%
-%^^A \subsection{The \thispackage\ package version $1.x$}
-% \subsection{Пакет \thispackage\ версии $1.x$}
-%
-%^^A This version of the \thispackage\ package still supports the old options
-%^^A and commands provided by the version $1.x$ of this package. So there
-%^^A shouldn't occur any problems compiling old documents, but please don't mix
-%^^A old options and commands with the new ones. This isn't supported and can
-%^^A cause ugly side effects.
-% Эта версия пакета \thispackage\ поддерживает старые опции и~команды
-% созданные в~версиях $1.x$ этого пакета. Поэтому не должно возникать
-% проблем в~компиляции старых документов, но, пожалуйста, не смешивайте
-% старые опции и~команды с~новыми. Это не поддерживается
-% и~может дать неприятные побочные эффекты.
-%
-%^^A Here comes a short oversight of the obsolete options and commands and how
-%^^A they have been replaced within this version of the \thispackage\ package:
-% Здесь дан краткий обзор устаревших опций и~команд и~чем
-% они заменены в~современной версии пакета \thispackage:
-%
-% {\small\begin{longtable}{ll}
-% \thispackage\ \version{1.x} & \thispackage\ \version{3.x}\\
-% \hline
-% \endhead
-% |normal| & |format=plain|\\
-% |hang| & |format=hang|\\
-% |isu| & |format=hang|\\
-% |center| & |justification=centering|\\
-% |centerlast| & |justification=centerlast|\\
-% \iffalse
-% |anne| & |justification=centerlast|\\
-% \fi
-% |nooneline| & |singlelinecheck=off|\\
-% |scriptsize| & |font=scriptsize|\\
-% |footnotesize| & |font=footnotesize|\\
-% |small| & |font=small|\\
-% |normalsize| & |font=normalsize|\\
-% |large| & |font=large|\\
-% |Large| & |font=Large|\\
-% |up| & |labelfont=up|\\
-% |it| & |labelfont=it|\\
-% |sl| & |labelfont=sl|\\
-% |sc| & |labelfont=sc|\\
-% |md| & |labelfont=md|\\
-% |bf| & |labelfont=bf|\\
-% |rm| & |labelfont=rm|\\
-% |sf| & |labelfont=sf|\\
-% |tt| & |labelfont=tt|\\
-% \end{longtable}}
-%
-%^^A Beside the options for setting up the desired font there were also
-%^^A the commands |\captionsize| resp.~|\captionfont| and |\captionlabelfont|
-%^^A who could be redefined with |\renewcommand| and allowed an alternate and
-%^^A more flexible way to change the font used for captions.
-%^^A This mechanism was replaced by the commands
-% Помимо опций для настроек нужного шрифта были также команды
-% |\captionsize|, а~также |\captionfont| и~|\captionlabelfont|
-% которые могли быть переопределены с~помощью |\renewcommand| и~позволяли
-% альтернативный и~более гибкий способ изменить шрифт подписей.
-% Данный механизм заменён на команды
-% \begin{quote}
-% |\DeclareCaptionFont{|\ldots|}{|\ldots|}|\qquad и\\
-% |\captionsetup{font=|\ldots|,labelfont=|\ldots|}|\qquad.
-% \end{quote}\SeeUserDefined
-%
-%^^A Setting the margin for captions was done in \version{1.x} with
-% Установки полей в~версии \version{1.x} задавались с~помощью
-% \begin{quote}
-% |\setlength{\captionmargin}{|\ldots|}|\quad.
-% \end{quote}
-%^^A This was replaced by
-% Это заменено на
-% \begin{quote}
-% |\captionsetup{margin=|\ldots|}|\qquad.
-% \end{quote}
-%^^A \See{\Section{margins}{Margins and further paragraph options}}
-% \See{\Section{margins}{Поля и другие опции формирования абзаца}}
-%
-%^^A For example the old-style code
-% Например, старый код
-% \begin{quote}
-% |\usepackage[hang,bf]{caption}|\\
-% |\renewcommand\captionfont{\small\sffamily}|\\
-% |\setlength\captionmargin{10pt}|
-% \end{quote}
-%^^A will still work fine, but should be written today as
-% до сих пор работает, но лучше переписать его как
-% \begin{quote}
-% |\usepackage[format=hang,labelfont=bf,font={small,sf},|\\
-% | margin=10pt]{caption}|
-% \end{quote}
-%^^A or
-% или
-% \begin{quote}
-% |\usepackage{caption}|\\
-% |\captionsetup{format=hang,labelfont=bf,font={small,sf},|\\
-% | margin=10pt}|\qquad.
-% \end{quote}
-%
-%^^A The quite exotic option |ruled| which allowed a partial usage of
-%^^A the caption settings for |ruled| floats defined with the
-%^^A \package{float} package will be emulated by this version of the
-%^^A caption package, too.
-%^^A But using this option is not recommended anymore since this
-%^^A version of the \thispackage\ package offers a more flexible way
-%^^A for changing the captions of these floating environments:
-% Такая экзотическая опция |ruled| которая позволяла частично использовать
-% настройки подписи для флотов с~оформлением |ruled| из пакета
-% \package{float} эмулируется и~данным пакетом тоже.
-% Но использование этой опции не рекомендуется, поскольку данная версия пакета
-% \thispackage\ предлагает более гибкий способ для изменения подписей
-% таких окружений плавающих флотов:
-% \begin{quote}
-% |\DeclareCaptionStyle{ruled}{|\ldots|}|
-% \end{quote}
-%^^A resp.
-% и, соответственно
-% \begin{quote}
-% |\captionsetup[ruled]{|\ldots|}|\qquad.
-% \end{quote}
-% \SeeUserDefined[, \Section*{misc}{Полезные утилиты} и
-% \Section*{float}{Пакет \package{float}}]
-%
-%^^A \subsection{The \package{caption2} package version $2.x$}
-% \subsection{Пакет \package{caption2} версии $2.x$}
-%
-%^^A Although they do very similar stuff, the packages \package{caption} and
-%^^A its experimental and now obsolete variant \package{caption2} have a
-%^^A very different implementation design.
-%^^A Therefore a full compatibility could not be offered.
-%^^A For that reason you will still find a file called |caption2.sty| in
-%^^A this package distribution, so old documents using the \package{caption2}
-%^^A package will still compile fine.
-% Хотя используются одни и~те же настройки и~в~пакете \package{caption}
-% и~в~экспериментальной, но сейчас устаревшей версии"=пакете
-% \package{caption2}, у~этих пакетов совершенно разный механизм их задания.
-% Поэтому полная совместимость невозможна.
-% По этой причине до сих пор существует пакет |caption2.sty| в~данном
-% дистрибутиве, и~старые документы, использующие пакет \package{caption2}
-% будут компилироваться.
-%
-%^^A Newly created documents should use the actual version of the
-%^^A \thispackage\ package instead. In most cases it's sufficient to replace
-%^^A the command
-% Новые документы должны использовать современные версии пакета
-% \thispackage. В~большинстве случаев можно заменить строку
-% \begin{quote}
-% |\usepackage[...]{caption2}|
-% \end{quote}
-%^^A by
-% на
-% \begin{quote}
-% |\usepackage[...]{caption}|\qquad.
-% \end{quote}
-%^^A But some options and commands will not be emulated, so you can get
-%^^A error messages afterwards. This section will hopefully help you removing
-%^^A these errors. If you have problems migrating from \package{caption2}
-%^^A to \package{caption} please don't hesitate to send me an e-mail asking
-%^^A for help.
-% Но некоторые опции и~команды не эмулируются, и~вы можете
-% получить сообщения об ошибках. Данный раздел поможет вам ликвидировать
-% такие ошибки. Если у~вас проблемы по замене пакета \package{caption2}
-% на \package{caption} не раздумывайте и~отправляйте мне e-mail.
-%
-%^^A In addition to the obsolete options shown in the last section
-%^^A these ones will be emulated, too:
-% Помимо устаревших опций из предыдущего раздела
-% следующие также эмулируются:
-%
-% {\small\begin{longtable}{ll}
-% \package{caption2} \version{2.x} & \thispackage\ \version{3.x}\\
-% \hline
-% \endhead
-% |flushleft| & |justification=raggedright|\\
-% |flushright| & |justification=raggedleft|\\
-% |oneline| & |singlelinecheck=on|\\
-% \end{longtable}}
-%
-%^^A Setting the margin for captions was done in \version{2.x} with
-% Задание втяжек (полей) для подписей, созданных в~\version{2.x}
-% \begin{quote}\leavevmode\hbox{%
-% |\setcaptionmargin{|\ldots|}| resp.
-% |\setcaptionwidth{|\ldots|}|\quad.
-% }\end{quote}
-%^^A This was replaced by
-% Они могут быть заменены на
-% \begin{quote}\leavevmode\hbox{%
-% |\captionsetup{margin=|\ldots|}| resp.
-% |\captionsetup{width=|\ldots|}|\quad.
-% }\end{quote}
-%^^A \See{\Section{margins}{Margins and further paragraph options}}
-% \See{\Section{margins}{Поля и другие опции формирования абзаца}}
-%
-%^^A Setting an indention was done in \version{2.x} with
-% Задание втяжки в~версии \version{2.x} задавалось как
-% \begin{quote}
-% |\captionstyle{indent}|\\
-% |\setlength\captionindent{|\ldots|}|\quad.
-% \end{quote}
-%^^A This is now done with
-% Сейчас это задаётся в~виде
-% \begin{quote}
-% |\captionsetup{format=plain,indention=|\ldots|}|\quad.
-% \end{quote}
-%
-%^^A The so-called single-line-check was controlled by the commands
-%^^A |\oneline|\-|captions|\-|false| (for switching the check off) and
-%^^A |\oneline|\-|captions|\-|true| (for switching the check on).
-%^^A This was replaced by
-% Контроль короткой подписи контролируется командами
-% |\oneline|\-|captions|\-|false| (отключает контроль)
-% и~|\oneline|\-|captions|\-|true| (для включения контроля).
-% Это заменено
-% |\captionsetup{|\discretionary{}{}{}|singlelinecheck=|\discretionary{}{}{}|off}|
-%^^A resp.
-% и, соответственно
-% |\captionsetup{|\discretionary{}{}{}|singlelinecheck=|\discretionary{}{}{}|on}|.
-% \See{\Section{justification}{Выключка}}
-%
-%^^A The commands
-% Команды
-% \begin{quote}
-% |\captionlabeldelim|, |\captionlabelsep|, |\captionstyle|,\\
-% |\defcaptionstyle|, |\newcaptionstyle|, and |\renewcaptionstyle|
-% \end{quote}
-%^^A do not have a simple replacement and therefore will not be emulated
-%^^A by this version of the \thispackage\ package. (So using them will
-%^^A cause error messages.) Rewriting such code is not always easy and
-%^^A straight-ahead, but by conscientious reading of this manual you should
-%^^A find appropriate options and commands instead.
-% не имеют простой замены поэтому не эмулируются
-% данной версией пакета \thispackage. (Их использование вызовет
-% сообщение об ошибке.) Замена этого кода не всегда проста,
-% но добросовестно прочитав данное руководство, вы найдёте
-% подходящие опции и~команды замены.
-%
-% \iffalse
-% ... (some examples)
-% \fi
-%
-%^^A The \version{2.x} option |ignoreLTcapwidth| do not have a replacement, too.
-%^^A But in most cases you can simply drop using that option because
-%^^A in this version of the \thispackage\ package the value of |\LTcapwidth|
-%^^A will be ignored anyway (unless you set it to a different value than the
-%^^A default one).
-%^^A \See{\Section{longtable}{The \package{longtable} package}}
-% Опция версии \version{2.x} |ignoreLTcapwidth| тоже не имеет замены.
-% Но в~большинстве случаев эту опцию можно опустить, потому что в~данной
-% версии пакета \thispackage\ значение |\LTcapwidth|
-% будет игнорировать в~любом случае (если только вы не зададите значение,
-% отличное от заданного по умолчанию).
-% \See{\Section{longtable}{Пакет \package{longtable}}}
-%
-% \iffalse
+
+\clearpage\appendix
+% \section{Alphabetical Reference}
+\section{Алфавитный указатель}
+
+%\newenvironment{Warnings}%
+% {\begin{trivlist}%
+% \def\Message{\pagebreak[3]\leftskip=0pt\relax\item[]\color{blue}}%
+% \def\Description{\nopagebreak\par\nopagebreak\color{black}\leftskip=1.5em\nopagebreak}%
+% }%
+% {\color{black}\end{trivlist}}
+\makeatletter
+\newenvironment{Warnings}{%
+ \newif\ifMessage
+ \def\Message{%
+ \ifMessage\end{minipage}\par\vspace\itemsep\pagebreak[3]\fi
+ \begin{minipage}{\linewidth}%
+ \setlength\parindent{0pt}%
+ \setlength\parskip{\smallskipamount}%
+ \setlength\leftskip{0pt}%
+ \color{blue}%
+ \Messagetrue}%
+ \def\Description{%
+ \par\color{black}\leftskip=1.5em}%
+ \def\Or{\@testopt\@Or{или}}%
+ \def\@Or[##1]{%
+ \\{\small\color{black}\hspace{1.5em}\textit{-- ##1 --}}\\}%
+}{%
+ \ifMessage\end{minipage}\par\fi
+}
+\makeatother
+
+% \subsection{Options}
+\subsection{Ключи (опции)}
+\newcommand\preambleoption{\,%
+ \begingroup\def\thefootnote{\fnsymbol{footnote}}%
+ \footnotemark[2]%
+ \endgroup}
+\newcommand\preambleoptiontext{%
+ \begingroup\def\thefootnote{\fnsymbol{footnote}}%
+% \footnotetext[2]{These options are only available in the preamble of the document.}%
+ \footnotetext[2]{Эти опции можно использовать только в~преамбуле документа.}%
+ \endgroup}
+
+\newcommand\cell[1]{\tabular[t]{@{}l@{}}#1\endtabular}
+
+\begin{longtable*}{@{}l@{\ }ll@{}}
+% Option & Short description & Section \\
+Ключ & Краткое описание & Раздел \\
+\hline\noalign{\vskip2pt}
+\endhead
+% |aboveskip| & sets the skip above caption & \ref{skips} \\
+|aboveskip| & задаёт отбивку над подписью & \ref{skips} \\
+% |belowskip| & sets the skip below caption & \ref{skips} \\
+|belowskip| & задаёт отбивку под подписью & \ref{skips} \\
+% |compatibility|\preambleoption & force (non-)compatibility & \ref{classes} \\
+|compatibility|\preambleoption & форсировать (не)совместимость & \ref{compatibility} \\
+%|config| & & \ref{x} \\
+% |figurename|\preambleoption & sets the figure name & \ref{names} \\
+|figurename|\preambleoption & задание имени рисунка в~метке & \ref{names} \\
+% |figureposition|\preambleoption & gives a hint about the figure caption position & \ref{skips} \\
+|figureposition|\preambleoption & даёт подсказку о~размещении позиции подписи рисунка & \ref{skips} \\
+% |figurewithin|\preambleoption & sets the figure ``within'' counter & \ref{numbering} \\
+|figurewithin|\preambleoption & \cell{задаёт счётчик раздела, которому подчиняется\\ нумерация рисунков}
+ & \ref{numbering} \\
+% |font|(|+|) & sets the font & \ref{fonts} \\
+|font|(|+|) & задаёт шрифт & \ref{fonts} \\
+% |format| & sets the format & \ref{formats} \\
+|format| & задаёт формат & \ref{formats} \\
+% |FPlist| & to where the list entry of a FPfigure should link? & \ref{fltpage} \\
+|FPlist| & к~чему привязывать FPfigure в~Списке флотов? & \ref{fltpage} \\
+% |FPref| & to where a |\ref| to a FPfigure should link? & \ref{fltpage} \\
+|FPref| & к~чему привязывать |\ref| для FPfigure? & \ref{fltpage} \\
+% |hangindent| & sets the hang indention & \ref{margins} \\
+|hangindent| & \cell{задаёт втяжку [на весу;\\ соответствует команде \cs{hangindent}]} & \ref{margins} \\
+% |hypcap| & select `hypcap' feature & \ref{hyperref} \\
+|hypcap| & определяет работу пакета `hypcap' & \ref{hyperref} \\
+% |hypcapspace| & sets the distance between hyperlink \& contents & \ref{hyperref} \\
+|hypcapspace| & \cell{задаёт расстояние между гиперссылкой\\ и~содержимым
+объекта} & \ref{hyperref} \\
+% |indention| & sets the indention & \ref{margins} \\
+|indention| & задаёт втяжку & \ref{margins} \\
+% |justification| & sets the justification & \ref{justification} \\
+|justification| & задаёт выключку & \ref{justification} \\
+% |labelfont|(|+|) & sets the font of the caption label & \ref{fonts} \\
+|labelfont|(|+|) & задаёт шрифт для метки флота & \ref{fonts} \\
+% |labelformat| & sets the format of the caption label & \ref{formats} \\
+|labelformat| & \cell{задаёт формат [оформление] нумерационного\\ заголовка} & \ref{formats} \\
+% |labelsep| & sets the label separator & \ref{formats} \\
+|labelsep| & \cell{задаёт разделитель между нумерационным\\ заголовком
+и~текстом подписи} & \ref{formats} \\
+% |labelseparator| & sets the label separator & \ref{formats} \\
+|labelseparator| & \cell{задаёт разделитель между нумерационным\\ заголовком
+и~текстом подписи} & \ref{formats} \\
+% |list| & switches the entries in the `List of' on or off & \ref{lists} \\
+|list| & \cell{определяет (включает/отключает) вывод подписей\\ в~Списке флотов} & \ref{lists} \\
+% |listformat| & sets the `List of' entry format & \ref{lists} \\
+% |listfigurename| & sets the `List of Figure' name & \ref{names} \\
+|listfigurename| & задаёт заголовок для Списка рисунков & \ref{names} \\
+|listformat| & определяет формат для вывода в~Списке флотов & \ref{lists} \\
+% |listtablename| & sets the `List of Tables' name & \ref{names} \\
+|listtablename| & задаёт заголовок для Списка таблиц & \ref{names} \\
+% |margin| & sets the margin & \ref{margins} \\
+|margin| & задаёт поля вокруг подписи & \ref{margins} \\
+% |margin*| & sets the margin, but only if no width is set & \ref{margins} \\
+|margin*| & \cell{задаёт поля, в~случае, если ширина подписи\\ не задана} & \ref{margins} \\
+% |maxmargin| & sets the max. margin & \ref{margins} \\
+|maxmargin| & задаёт максимальную величину поля & \ref{margins} \\
+% |minmargin| & sets the min. margin & \ref{margins} \\
+|minmargin| & задаёт минимальную величину поля & \ref{margins} \\
+%| name| & sets the name of the current environment & \ref{names} \\
+|name| & задаёт имя нового окружения & \ref{names} \\
+% |oneside| & selects the one-side mode & \ref{margins} \\
+|oneside| & задаёт одностороннюю печать документа & \ref{margins} \\
+% |options| & executes the given option list & \ref{x} \\
+|options| & включает данный список опций & \\
+% |parindent| & sets the paragraph indention & \ref{margins} \\
+|parindent| & задаёт абзацный отступ & \ref{margins} \\
+% |parskip| & sets the skip between paragraphs & \ref{margins} \\
+|parskip| & задаёт отбивку между абзацами & \ref{margins} \\
+% |position| & gives a hint about the caption position & \ref{skips} \\
+|position| & даёт подсказку о~размещении подписи & \ref{skips} \\
+% |singlelinecheck| & switches the single-line-check on or off & \ref{justification} \\
+|singlelinecheck| & включает контроль [оформления] однострочных подписей & \ref{justification} \\
+%|size| & sets the size of font & \ref{x} \\
+% |skip| & sets the skip between content \& caption & \ref{skips} \\
+|skip| & \cell{задаёт отбивку между содержимым флота и~подписи} & \ref{skips} \\
+% |strut| & switches the usage of |\strut|s on or off & \ref{formats} \\
+|strut| & включает использование команды распорки |\strut| & \ref{formats} \\
+% |style| & sets the caption style & \ref{style} \\
+|style| & задаёт стиль оформления подписи & \ref{style} \\
+%|style*| & sets the caption style & \ref{style} \\
+% |subtype| & sets the sub-caption type & \phantom{t}--~\footnotemark \\
+|subtype| & задаёт вывод подписи части флота & \phantom{t}--~\footnotemark \\
+% |tablename|\preambleoption & sets the table name & \ref{names} \\
+|tablename|\preambleoption & задаёт имя таблицы & \ref{names} \\
+% |tableposition|\preambleoption & gives a hint about the table caption position & \ref{skips} \\
+|tableposition|\preambleoption & \cell{даёт подсказку о~положении подписи таблицы
+ \\(табличного заголовка)} & \ref{skips} \\
+% |tablewithin|\preambleoption & sets the table ``within'' counter & \ref{numbering} \\
+|tablewithin|\preambleoption & \cell{задаёт счётчик раздела, которому подчиняется\\ нумерация таблиц}
+ & \ref{numbering} \\
+% |textfont|(|+|) & sets the font of the caption text & \ref{fonts} \\
+|textfont|(|+|) & задаёт шрифт для текста подписи & \ref{fonts} \\
+% |textformat| & sets the format of the caption text & \ref{formats} \\
+|textformat| & задаёт формат текста подписи & \ref{formats} \\
+% |twoside| & selects the two-side mode & \ref{margins} \\
+|twoside| & задаёт двустороннюю печать документа & \ref{margins} \\
+% |type| & sets the caption type \& places a hyperlink anchor & \ref{types} \\
+|type| & задаёт тип подписи и~помещает начало гиперссылки & \ref{types} \\
+% |type*| & sets the caption type only & \ref{types} \\
+|type*| & задаёт только тип подписи & \ref{types} \\
+% |width| & sets a fixed caption width & \ref{margins} \\
+|width| & задаёт фиксированную ширину подписи & \ref{margins} \\
+\end{longtable*}
+\preambleoptiontext
+% \footnotetext{The option \opt{subtype} is explained in the
+% \package{subcaption} package documentation.}
+\footnotetext{Значение опции \texttt{subtype} объясняется в~документации к~пакету
+ \package{subcaption}.}
+
+\nopagebreak\parbox[t]{\linewidth}{%
+\begin{Note*}
+% Obsolete options are not listed here. See
+% \Ref{caption1} and
+% \Ref{caption2} for a list of these options.}
+ Устаревшие опции здесь не перечисляются. За списком этих опций обратитесь к~документации
+ \Ref{caption1} и~\Ref{caption2}.
+\end{Note*}}
+
+% \subsection{Commands}
+\subsection{Команды}
+
+\begin{longtable*}{lll}
+Команда & & Раздел \\
+\hline
+\endhead
+|\abovecaptionskip| & & \ref{skips} \\
+%|\AtBeginCaption| & & \ref{hooks} \\
+%|\AtEndCaption| & & \ref{hooks} \\
+|\belowcaptionskip| & & \ref{skips} \\
+|\caption| & & \ref{caption} \\
+|\caption*| & & \ref{caption} \\
+|\captionlistentry| & & \ref{captionlistentry} \\
+|\captionof| & & \ref{caption} \\
+|\captionof*| & & \ref{caption} \\
+|\captionsetup| & & \ref{captionsetup} \\
+|\captionsetup*| & & \ref{captionsetup} \\
+|\centerfirst| & & \ref{justification} \\
+|\centerlast| & & \ref{justification} \\
+|\clearcaptionsetup| & & \ref{captionsetup} \\
+|\clearcaptionsetup*| & & \ref{captionsetup} \\
+|\ContinuedFloat| & & \ref{ContinuedFloat} \\
+|\DeclareCaptionFont| & & \ref{declare} \\
+|\DeclareCaptionFormat| & & \ref{declare} \\
+|\DeclareCaptionFormat*| & & \ref{declare} \\
+|\DeclareCaptionJustification| & & \ref{declare} \\
+|\DeclareCaptionLabelFormat| & & \ref{declare} \\
+|\DeclareCaptionLabelSeparator| & & \ref{declare} \\
+|\DeclareCaptionLabelSeparator*| & & \ref{declare} \\
+|\DeclareCaptionListFormat| & & \ref{declare} \\
+|\DeclareCaptionOption| & & \ref{declare} \\
+|\DeclareCaptionStyle| & & \ref{declare} \\
+|\DeclareCaptionSubType| & & --~\footnotemark \\
+|\DeclareCaptionTextFormat| & & \ref{declare} \\
+|\DeclareCaptionType| & & \ref{declare} \\
+|\showcaptionsetup| & & \ref{captionsetup} \\
+\end{longtable*}
+% \footnotetext{\cs{DeclareCaptionSubType} is explained in the
+% \package{subcaption} package documentation.}
+\footnotetext{Команда \cs{DeclareCaptionSubType} описана
+ в~документации к~пакету \package{subcaption}.}
+
+\clearpage
+% \subsection{Warnings}
+\subsection{Предупреждения}
+
+\begin{Warnings}
+
+\Message
+ |\caption outside box or environment.|
+\Or
+ |\captionsetup{type=...} outside box or environment.|
+\Or
+ |\captionsetup{type*=...} or \captionof outside box|\\
+ | or environment.|
+\Description
+% You have placed a |\caption|, |\caption|\-|of|, or
+% |\caption|\-|setup{type=|\x\meta{type}|}| command outside an box, group,
+% or environment.
+% You should not do this since it could cause some bad side-effects.
+% \par\See{\Ref{types} and \Ref{caption}}
+ Вы поместили |\caption|, |\caption|\-|of|, или
+ |\caption|\-|setup{type=|\x\meta{type}|}| вне бокса, группы
+ или окружения.
+ Это может создать побочные эффекты.
+ \par\See{\Ref{types} и~\Ref{caption}}
+
+\Message
+ |\caption will not be redefined since it's already|\\
+ |redefined by a document class or package which is|\\
+ |unknown to the caption package.|
+\Description
+% If \thispackage\ detects that some (unknown) document class or
+% package has enhanced |\caption|, it will not redefine
+% |\caption|, too, since this would simply kill the enhancement.
+% As a result some features, like |\caption*|, |\Continued|\-|Float|,
+% using the optional argument of |\caption|\-|setup|,
+% or the options |list=| and |hypcap=| will not be available.\par
+% If you don't care about the original enhancements but would
+% like to use the full range of features of \thispackage\ instead
+% you can give the unsupported(!) option |compatibility=|\x|false|
+% a try and keep your fingers crossed.
+% (But you will get the next warning instead.)
+% \par\See{\Ref{classes} and \Ref{compatibility}}
+ \Thispackage\ обнаружил, что используется какой-либо (неизвестный) класс документа или
+ пакет, расширивший определение |\caption|, поэтому дальнейшее переопределение
+ |\caption| может уничтожить используемые настройки.
+ В~результате некоторые особенности, такие как |\caption*|, |\ContinuedFloat|,
+ использование дополнительного аргумента |\captionsetup|,
+ или опций |list=| и~|hypcap=| невозможно.\par
+ Если вам не нужны оригинальные настройки и~важнее использовать
+ полный спектр возможностей данного пакета, вы можете задать
+ неподдерживаемую(!) опцию |compatibility=false|
+ и~надеяться на лучшее.
+ (Но в~этом случае вы получите следующее предупреждение.)
+ \par\See{\Ref{classes}}
+
+\Message
+ |Forced redefinition of \caption since the|\\
+ |unsupported(!) package option `compatibility=false'|\\
+ |was given.|
+\Description
+% Since you were so keen to specify the option |compatibility=|\x|false|
+% \thispackage\ will try to do its best to fulfill your wishes.
+% But depending on the document class or other packages you use that
+% can end in non-functional features or even errors. So keep your
+% fingers crossed!
+ Если вы были столь отважны, задав опцию |compatibility=|\x|false|,
+ \thispackage\ постарается сделать всё, что вы потребуете.
+ Но такое использование этого пакета совместно с~таким пакетом или классом
+ может отключить некоторые особенности или породить ошибки.
+ Итак, надейтесь на лучшее!
+ \par\See{\Ref{compatibility}}
+
+\Message
+ |Hyperref support is turned off because hyperref has|\\
+ |stopped early.|
+\Description
+% If the \package{hyperref} package stops early during loading
+% (because of what-ever reason), the \package{hyperref} support of
+% \thispackage\ will not be available. As a result you could get
+% \package{hyperref} warnings and non-functional hyperlinks to figures
+% or tables.
+ Если загрузка пакета \package{hyperref} завершилась раньше положенного
+ (по какой-либо причине), поддержка пакета \package{hyperref} пакетом
+ \package{caption} будет отключена. В~результате вы получите
+ \package{hyperref} предупреждения и~нефункционирующие гиперссылки на рисунки
+ или таблицы.
+ \par\See{\Ref{hyperref}\,}
+
+\Message
+ |Ignoring optional argument [|\meta{pos}|] of \setcapwidth.|
+\Description
+% \Thispackage\ tries to emulate the \KOMAScript\ commands regarding
+% captions as best as it can. But the optional argument of the
+% \KOMAScript\ command |\setcapwidth| is not (yet) working if you use
+% this package, so if you try to use it anyway, you will get this warning.
+ \Thispackage\ старается корректно эмулировать команды \KOMAScript, относящиеся к~подписям.
+ Но опция команды |\setcapwidth| из
+ \KOMAScript\ ещё не работает вместе с~этим пакетом,
+ поэтому, если вы решите её использовать, вы получите предупреждение.
+ \par\See{\Ref{KOMA}}
+
+\Message
+ |Internal Warning: |\meta{warning message}|.|
+\Description
+% You should never see this warning, either you use a package which redefines
+% |figure| or |table| and which is unknown to \thispackage, or this is a bug
+% in \thispackage.
+% Please send me an e-mail reporting this issue.
+ Надеюсь вы не увидите такого сообщения, оно появится в~случае переопределений окружений
+ |figure| или |table|, неизвестных данному пакету, или это ошибка самого пакета
+ \package{caption}.
+ Пожалуйста, пришлите e-mail с~образцом, дающим это сообщение.
+
+\Message
+ |\label before \caption ignored|
+\Description
+% Regarding |\label| the floating environments behave differently than its
+% non-floating counterparts: The internal reference will not be generated
+% at the beginning of the environment, but at |\caption| instead.
+% So you have to place the |\label| command either just \emph{after} or
+% \emph{inside} the caption text (mandatory argument of |\caption|).
+ Метки, |\label|, к~плавающим объектам работают не так, как неплавающие окружения:
+ информация для метки генерируется не в~начале окружения,
+ а~после команды |\caption|.
+ Поэтому вы должны поместить команду |\label| либо \emph{после} текста
+ |\caption| либо внутри текста подписи.
+
+\Message
+ |Option `|\meta{option}|' was not in list `|\meta{option list}|'.|
+\Description
+% If you try to remove a specific option of an option list,
+% for example with |\clear|\-|caption|\-|setup[po|\-|si|\-|tion]{table}|,
+% and this option can not be found inside the option list, you will
+% get this warning. If this is not because of a typo and you would like
+% to suppress this warning, use |\clear|\-|caption|\-|setup*| instead of
+% |\clear|\-|caption|\-|setup|.
+ Если вы попробуете удалить опцию из списка опций,
+ например, |\clear|\-|caption|\-|setup[po|\-|si|\-|tion]{table}|,
+ а~эта опция не была обнаружена в~списке, вы получите
+ это предупреждение. Если это происходит не из-за опечатки и~вы хотите запретить это
+ предупреждение, используйте |\clearcaptionsetup*| вместо
+ |\clearcaptionsetup|.
+ \par\See{\Ref{captionsetup}}
+
+\Message
+ |Option list `|\meta{option list}|' undefined.|
+\Description
+% If you try to remove a specific option of an option list,
+% for example with |\clear|\-|caption|\-|setup[for|\-|mat]{figure}|,
+% and this option list is not defined (yet), you will
+% get this warning. If this is not because of a typo and you would like
+% to suppress this warning, use |\clear|\-|caption|\-|setup*| instead of
+% |\clear|\-|caption|\-|setup|.
+ Если вы попробуете удалить опцию из списка опций,
+ например, |\clear|\-|caption|\-|setup[for|\-|mat]{figure}|,
+ а~эта опция не была обнаружена в~списке, вы получите
+ это предупреждение. Если это происходит не из-за опечатки и~вы хотите запретить это
+ предупреждение, используйте |\clearcaptionsetup*| вместо
+ |\clearcaptionsetup|.
+ \par\See{\Ref{captionsetup}}
+
+\iffalse
+\Message
+ |Possibly superfluous \restylefloat{|\meta{type}|} detected.|\\
+ |If you think that this warning is unjustified,|\\
+ |you can switch it off using the caption package|\\
+ |option `restylefloatcheck=off'.|
+\Description
+ \TODO
+\fi
+
+\Message
+ |`ragged2e' package not loaded, therefore|\\
+ |substituting \raggedright for \RaggedRight.|
+\Description
+% The caption option |justification=|\x|RaggedRight| is only full functional
+% if you have the \package{ragged2e} package installed in your \TeX\ system.
+% If not, you will get this warning, and |justification=|\x|RaggedRight|
+% will be treated as |justification=|\x|raggedright|.
+ Опция |justification=|\x|RaggedRight| будет функционировать
+ если пакет \package{ragged2e} инсталлирован в~вашей системе \TeX{}.
+ Если пакета нет, вы получите предупреждение, и~|justification=|\x|RaggedRight|
+ будет работать как |justification=|\x|raggedright|.
+ \par\See{\Ref{justification}}
+
+\Message
+ |Obsolete option `ignoreLTcapwidth' ignored.|
+\Description
+% The \package{caption2} package option |ignoreLTcapwidth| will not be
+% emulated by this version of \thispackage, usually you can simply wipe it
+% away.
+ Опция пакета \package{caption2}, |ignoreLTcapwidth|, не будет эмулироваться
+ данной версией пакета, обычно это предупреждение можно игнорировать.
+ \par\See{\Ref{caption2} and \Ref{longtable}}
+
+\Message
+ |`ragged2e' support has been changed. Rerun to get|\\
+ |captions right.|
+\Description
+% The \package{ragged2e} package will only be loaded by \thispackage\ if it
+% is actually needed.
+% At least two \LaTeX\ runs are needed for that, so on the first run you could
+% get this warning.
+% Just compile your document again and this warning should go away.
+ Пакет \package{ragged2e} может быть загружен пакетом \package{caption} если это
+ действительно необходимо.
+ По крайней мере для этого нужны две обработки \LaTeX'а, и~при первой обработке
+ вы получите это сообщение.
+ Скомпилируйте документ второй раз и предупреждение исчезнет.
+ \par\See{\Ref{justification}}
+
+\Message
+ |Reference on page |\meta{page no.}| undefined.|
+\Description
+% If you use a |twoside| page layout, \thispackage\ needs to track the
+% page numbers to get the margins right.
+% At least two \LaTeX\ runs are needed for that, on the first run you could get
+% this warning.
+% Just compile your document again and this warning should go away.
+ Если вы используете опцию документа |twoside|, пакету нужно контролировать нумерацию страниц,
+ чтобы получить верно размещённые поля.
+ Для этого нужны две обработки \LaTeX'ом, а~при первой обработке вы получите это
+ сообщение.
+ Скомпилируйте документ второй раз и предупреждение исчезнет.
+ \par\See{\Ref{margins}}
+
+\Message
+ |The caption type was already set to `|\meta{type}|'.|
+\Description
+% This warning informs you about mixed caption options. For example if
+% you use a |\caption|\-|setup{type=|\x|table}| or
+% |\caption|\-|of{table}{|\ldots|}| inside a |figure| environment,
+% this would result in using both option sets for that specific caption,
+% the one for |figure| (specified with |\caption|\-|setup[figure]{|\ldots|}|)
+% and the one for |table| (specified with |\caption|\-|setup[table]{|\ldots|}|)
+% as well.\par
+% {\small(You can suppress this warning by using the starred form
+% |\caption|\-|setup*{type=|\x\ldots|}|.)\par}
+ Это предупреждение информирует о~смешении опций. Например,
+ вы используете |\captionof{table}{|\ldots|}| внутри окружения |figure|,
+ это является результатом использования обеих опций для этой специфической подписи:
+ для |figure| (заданной с~помощью |\captionsetup[figure]{|\ldots|}|)
+ и~для |table| (заданной с~помощью |\captionsetup[table]{|\ldots|}|).\par
+ {\small(Вы можете отключить это предупреждение, используя звёздную форму команды
+ |\caption|\-|setup*{type=|\x\ldots|}|.)\par}
+ \par\See{\Ref{captionsetup}}
+
+\Message
+ |The option `hypcap=true' will be ignored for this|\\
+ |particular \caption.|
+\Description
+% \Thispackage\ hasn't found a proper hyperlink anchor for this particular
+% caption, so it decides to ignore the setting |hypcap=|\x|true| (which is set by
+% default). As a result a link to this caption (e.g.~in the List of Figures,
+% or set by |\ref| or |\auto|\-|ref|) will link you to the caption of the figure
+% or table, not to the figure or table itself.\par
+ \Thispackage\ не нашёл подходящее место для гиперссылки для данной
+ подписи, поэтому пакет решает игнорировать настройки |hypcap=|\x|true| (заданные
+ по умолчанию). В~результате ссылка на эту подпись (например, в~Списке рисунков,
+ или в~командах |\ref| или |\autoref|) будет привязана к~подписи рисунка или таблицы,
+ а~не к~содержимому рисунка или таблицы.\par
+% This can happen if you use |\caption|\-|of| inside a non-floating environment,
+% but also if you use some package which redefines |figure| or |table|, and
+% which is unknown to \thispackage.\par
+ Это может произойти если вы используете команду |\captionof| в~неплавающем окружении,
+ а~также при использовании пакета, переопределяющего окружения |figure| или |table|,
+ неизвестного данному пакету.\par
+% If this is ok for you but you want to suppress this warning, simply place a
+% |\caption|\-|setup{hyp|\-|cap=|\x|false}| just before the |\caption| or
+% |\caption|\-|of| command which is causing the warning.
+ Если вам это подходит и~вы хотите запретить это предупреждение, задайте код
+ |\caption|\-|setup{hyp|\-|cap=|\x|false}| перед |\caption| или
+ |\captionof|, которые порождают предупреждение.
+% If this is not ok for you, you can set a hyperlink anchor with
+% |\caption|\-|setup{type=|\x\meta{float type}|}| for yourself.
+ Если же это вас не устраивает, вы можете попробовать задать гиперссылку, с~помощью
+ |\caption|\-|setup{type=|\x\meta{float type}|}|.
+ \par\See{\Ref{hyperref}}
+
+\Message
+ |Unsupported document class (or package) detected,|\\
+ |usage of the caption package is not recommended.|
+\Description
+% Either the document class you use is unknown to \thispackage, or you
+% have included a package in your document which redefines |\@make|\-|caption|
+% (which is responsible for typesetting the caption internally) as well.
+% This means \thispackage\ will either change the design of captions in an
+% unwanted way, or it even refuses to work correctly at all.
+ Либо класс документа неизвестен данному пакету, либо вы
+ подключили пакет, который переопределяет команду |\@makecaption|
+ (внутренняя команда, создающая подписи).
+ Это означает что \thispackage\ изменит оформление подписей в~нежелательным способом,
+ или вообще откажется работать.
+ \par\See{\Ref{classes} и~\Ref{compatibility}}
+
+\Message
+ |Unused \captionsetup[|\meta{type}|].|
+\Description
+% You have specified options with |\caption|\-|setup[|\meta{type}|]| which are
+% not used later on.
+% This can be because of a typo in \meta{type},
+% or because you use a package which redefines |figure| or |table| and
+% which is unknown to \thispackage, or simply because you don't have any usage
+% of the environment \meta{type} after this line.
+% (If you want to suppress this warning you can use |\caption|\-|setup*|
+% instead of |\caption|\-|setup|.)
+ Вы определили опции |\captionsetup[|\meta{type}|]| которые
+ позднее не использовались.
+ Это может произойти из-за опечатки в~аргументе \meta{type},
+ или потому, что вы используете пакет, который переопределяет окружения |figure| или |table|,
+ неизвестный данному пакету, или просто вы не использовали окружения
+ \meta{type} после заданных настроек.\par
+ (Если вы хотите запретить это предупреждение, вы можете задать |\captionsetup*| вместо
+ |\captionsetup|.)\enlargethispage{\baselineskip}
+ \par\See{\Ref{captionsetup}}
+
+\Message
+ |Usage of the |\meta{package}| package together with the|\\
+ |caption package is strongly not recommended.|\\
+ |Instead of loading the |\meta{package}| package you should|\\
+ |use the caption package option `tableposition=top'.|
+\Description
+% The package \meta{package} is dealing with caption skips as well.
+% Please decide which one do you actually want to use, \thispackage\ or the
+% other one, using both can lead to wrong skips above or below the caption.
+ Пакет \meta{package} изменяет отбивки вокруг подписи.
+ Решите, чей интерфейс вы предпочтёте: \thispackage\ или
+ другой пакет, использование обоих может задать неверные отбивки вокруг подписи.
+ \par\See{\Ref{skips}}
+
+\end{Warnings}
+
+\pagebreak[3]
+%^^A\subsection{Errors}
+\subsection{Сообщения об ошибках}
+
+\begin{Warnings}
+
+\Message
+ |Argument of \@caption has an extra }.|
+\Or
+ |Paragraph ended before \@caption was complete.|
+\Description
+% If you want to typeset something special (like a tabular) as caption,
+% you need to give an optional argument to |\caption| resp.~|\caption|\-|of|
+% for the List of Figures resp.~List of Tables, too, even if you don't
+% use such list.
+ Если вы хотите создать что-то необычное (например таблицу) внутри подписи,
+ вы должны задать дополнительный аргумент для команды |\caption| или |\captionof|,
+ чтобы поместить текст в~Список рисунков или таблиц, даже если вы не используете
+ такой список.
+ \par\See{\Ref{caption}, \Ref{lists}, и~\Ref{hyperref}\,}
+
+\Message
+ |\caption outside float.|
+\Description
+% You have placed a |\caption| command outside a floating environment, or
+% a |long|\-|table| or |wrap|\-|figure|.
+% If this is what you want to, please use either
+% |\caption|\-|setup{type=|\x\meta{type}|}| $+$ |\caption| or
+% |\caption|\-|of|.
+ Вы поместили команду |\caption| за пределами окружения флота или
+ |longtable|. Если вы делаете это сознательно, задайте
+ |\captionsetup{|\x|type=|\x\meta{type}|}| $+$ |\caption| или |\captionof|.
+ \par\See{\Ref{caption}}
+
+\Message
+ |\ContinuedFloat outside float.|
+\Description
+% You have placed a |\Continued|\-|Float| command outside a floating
+% environment. % or |long|\-|table|.
+ Вы поместили команду |\ContinuedFloat| вне окружения флота.
+% If this is what you want to, please use the combination
+% |\caption|\-|setup{type=|\x\meta{type}|}| $+$ |\Continued|\-|Float|.\par
+ Если вы это сделали сознательно, используйте комбинацию
+ |\captionsetup{|\x|type=|\x\meta{type}|}| $+$ |\ContinuedFloat|.\par
+% Please note that |\Continued|\-|Float| inside a |long|\-|table| is not
+% working, but maybe using the |long|\-|table*| environment, which
+% typesets a |long|\-|table| without incrementing the |table| counter,
+% if sufficient for you.
+ Обратите внимание, что использование |\ContinuedFloat| внутри |longtable| (пока) не работает,
+ но, возможно использование окружения |longtable*|, которое создаёт |longtable|
+ без увеличения нумерации |table|, решит ваши проблемы.
+ \par\See{\Ref{ContinuedFloat} и~\Ref{longtable}}
+
+\Message
+ |Continued `|\meta{type}|' after `|\meta{type}|'.|
+\Description
+% Continued figures or tables are not allowed to be interrupted by a floating
+% environment (or |long|\-|table|) of another type,
+% e.g.~a table between a figure and a continued figure.
+ Продолжающиеся рисунки или таблицы не должны прерываться
+ окружением другого типа (или окружением |long|\-|table|),
+ например таблица между рисунком и~его продолжением.
+ \par\See{\Ref{ContinuedFloat}}
+
+\Message
+ |For a successful cooperation of the `wrapfig' package|\\
+ |with the `float' package you should load the `wrapfig'|\\
+ |package *(right) after* the `float' package.|
+\Description
+% Please take care of the load order of packages
+% if you use the \package{wrapfig} package in cooperation with the
+% \package{float} package.
+ Будьте внимательны с~порядком загрузки пакетов, если вы используете
+ пакет \package{wrapfig} совместно с~пакетом
+ \package{float}.
+ \par\See{\Ref{wrapfig}}
+
+\Message
+ |For a successful cooperation of the `wrapfig' package|\\
+ |with the `float' package you should use at least|\\
+ |`wrapfig' version 3.6.|
+\Description
+% Please take care of the version of the \package{wrapfig} package
+% if you use the \package{wrapfig} package in cooperation with the
+% \package{float} package.
+ Обратите внимание на версию пакета \package{wrapfig}, которую вы используете,
+ если вы используете этот пакет вместе с~пакетом
+ \package{float}.
+ \par\See{\Ref{wrapfig}}
+
+\Message
+ |For a successful cooperation we need at least version|\\
+ |`|\meta{date}|' of package |\meta{package}|, but only version|\\
+ |`|\meta{old-date}|' is available.|
+\Description
+% \Thispackage\ does not work with such an outdated package, please update it
+% to a more recent version, at least to the one requested.
+ \Thispackage\ не работает с~данной версией пакета, обновите его,
+ как минимум до требуемой версии.
+
+\Message
+ |Internal Error: |\meta{error message}|.|
+\Description
+% You should never see this error.
+% Please send me an e-mail reporting this issue.
+ Вы не должны получать такое сообщение.
+ Пожалуйста, пришлите e-mail с~образцом, дающим это сообщение.
+
+\Message
+ |No float type '|\meta{type}|' defined.|
+\Description
+% The \meta{type} you have specified in |\caption|\-|setup{type=|\x\meta{type}|}|,
+% |\caption|\-|of|\marg{type}, or |\Declare|\-|Caption|\-|Sub|\-|Type| is
+% not defined.
+% \meta{type} should be either `\texttt{figure}' or `\texttt{table}', or
+% any other floating environment defined with |\Declare|\-|Caption|\-|Type|,
+% |\new|\-|float| offered by the \package{float} package\cite{float},
+% or |\Declare|\-|New|\-|Float|\-|Type| offered by the \package{floatrow}
+% package\cite{floatrow}.
+ Тип флота \meta{type}, который вы выбрали в~командах |\captionsetup|\x|{type=|\x\meta{type}|}|,
+ |\captionof|\x\marg{type} или |\Declare|\-|Caption|\-|SubType| не определён.
+ Флот \meta{type} должен быть либо `\texttt{figure}' или `\texttt{table}', или
+ любое другое окружение определённое с~помощью команды |\Declare|\-|Caption|\-|Type|,
+ |\newfloat|, предлагаемой пакетом \package{float}\cite{float},
+ или |\Declare|\-|NewFloat|\-|Type| предлагаемой пакетом \package{floatrow}\cite{floatrow}.
+
+\Message
+ |Not allowed in longtable* environment.|
+\Description
+% The usage of |\caption| is not allowed inside the |long|\-|table*| environment.
+% Please use either |\caption*| for a caption without label or use the regular
+% |long|\-|table| environment instead.
+ Использование команды |\caption| невозможно внутри окружения |long|\-|table*|.
+ Либо используйте команду |\caption*| для создания подписи, либо замените окружение на
+ |longtable|.
+
+\Message
+ |Not available in compatibility mode.|
+\Description
+% The feature required is not supported in compatibility mode.
+% `compatibility mode' means that \thispackage\ has detected either an
+% incompatible document class or an incompatible package which also
+% extents the |\caption| command. Leaving the original extension intact,
+% some features of \thispackage\ are not supported.
+ Требуемая настройка не поддерживается в~режиме совместимости.
+ Термин `compatibility mode' («режим совместимости») означает, что \thispackage\ обнаружил
+ несовместимый класс документа или пакет, который модифицирует
+ команду |\caption|. Оставив оригинальные настройки нетронутыми,
+ \thispackage\ отменяет некоторые свои настройки.
+ \par\See{\Ref{compatibility}}
+
+\Message
+ |Only one \caption can be placed in this environment.|
+\Description
+% Inside the environments offered by the \package{fltpage} and \package{sidecap}
+% package only \emph{one} caption can be placed. (This is due implementation design.)
+ Внутри окружений, предлагаемых пакетами \package{fltpage} и~\package{sidecap}
+ можно поместить только одну подпись. (Это требования оформления.)
+
+\Message
+ |Option clash for package caption.|
+%\Or[but sometimes also]
+\Or[но иногда также]
+ |Missing \begin{document}.|
+\Description
+% \Thispackage\ has already been loaded by some other \LaTeX\ package,
+% so you can't do that again specifying different options.
+% A candidate causing this could be the \package{subfig} package; if this is
+% the case, please load \thispackage\ \emph{before} the \package{subfig}
+% package or specify the option |caption=|\x|false| while loading the
+% \package{subfig} package.
+% \par\See{the \package{subfig} package\cite{subfig} documentation}
+ \Thispackage\ уже загружен другим пакетом \LaTeX'а,
+ и~нельзя загружать пакет повторно, задав другие опции.
+ Первой причиной вызвавшей такое сообщение может быть пакет \package{subfig};
+ и~если это так,
+ загрузите \thispackage\ \emph{до} пакета \package{subfig}
+ или определите |caption=|\x|false| при загрузке
+ \package{subfig}.
+ \par\See{документацию пакета \package{subfig}\cite{subfig}}
+
+\Message
+ |Paragraph ended before \caption@makecurrent was complete.|
+\Or
+ |Paragraph ended before \caption@prepareanchor was complete.|
+\Description
+% If you want to typeset multi-paragraph captions, you need to give an
+% optional argument to |\caption| resp.~|\caption|\-|of| for the List of
+% Figures resp.~List of Tables, too, even if you don't use such list.
+% \par\See{\Ref{caption}, \Ref{lists}, and \Ref{hyperref}\,}
+ Если вам нужно создать подпись из нескольких абзацев, вы должны создать
+ дополнительный аргумент в~командах |\caption| или~|\captionof| для Списка рисунков или
+ Списка таблицы, даже если вы не используете эти списки.
+ \par\See{\Ref{caption}, \Ref{lists}, и~\Ref{hyperref}\,}
+
+\iffalse % was removed in v3.1b
+\Message
+ |Something is going wrong here...|\\
+ |For a removal of this problem please consult the|\\
+ |caption package documentation, especially the sections|\\
+ |about the `float' and the `wrapfig' package.|
+\Description
+% Please take care of the load order of packages
+% if you use the \package{wrapfig} package in cooperation with the
+% \package{float} package. But maybe a different package tried to extent
+% the \package{float} package in a manner which is incompatible to
+% \thispackage!?
+% \par\See{\Ref{float} and \Ref{wrapfig}}
+ Обратите внимание на порядок загруженных пакетов,
+ если вы используете пакет \package{wrapfig} вместе с~пакетом
+ \package{float}. Но возможно какой"=то другой пакет пытается расширить настройки пакета
+ \package{float} неизвестным пакету \package{caption} способом!?
+ \par\See{\Ref{float} и~\Ref{wrapfig}}
+\fi
+
+\Message
+ |Something's wrong--perhaps a missing \caption|\\
+ |in the last figure or table.|
+\Description
+% It seems that you have used a |\sub|\-|caption| command (or a different one
+% which has typeset a sub-caption) without a corresponding |\caption| command.
+% This is not supported.
+ Возможно вы использовали команду |\sub|\-|caption| (или другую команду, создающую
+ подпись части рисунка) без соответствующей команды |\caption|.
+ Это не поддерживается.
+
+\Message
+ |The option `labelsep=|\meta{name}|' does not work|\\
+ |with `format=hang'.|
+\Or
+ |The option `labelsep=|\meta{name}|' does not work|\\
+ |with \setcaphanging (which is set by default).|
+\Description
+% A caption label separator which contains a |\\| command (like
+% |labelsep=|\x|newline|) can not be combined with a hanging caption format
+% (like |format=|\x|hang|).
+% Please select either another caption label separator
+% (e.g.~|labelsep=|\x|colon|) or another caption format
+% (e.g.~|format=|\x|plain|).
+% \par\See{\Ref{formats} resp.~\Ref{KOMA}}
+ Разделитель нумерационного заголовка и~текста подписи, заданный как команда |\\| (т.\,е.
+ |labelsep=|\x|newline|) не может быть скомбинирован с~форматом создающим строку на весу
+ (like |format=|\x|hang|).
+ Задайте либо другой разделитель
+ (например~|labelsep=|\x|colon|) либо другой формат подписи
+ (e.g.~|format=|\x|plain|).
+ \par\See{\Ref{formats} или~\Ref{KOMA}}
+
+\Message
+ |The package option `caption=false' is obsolete.|\\
+ |Please pass this option to the subfig package instead|\\
+ |and do *not* load the caption package anymore.|
+\Description
+% You have specified the option |caption=|\x|false|. This used to be a workaround
+% for not using the whole \package{caption} package (leaving the caption stuff
+% offered by the document class or other packages intact), but keeping the
+% \package{subfig} package working. This mechanism is obsolete and not offered
+% anymore, please pass this option to the \package{subfig} package instead and
+% do not load \thispackage\ anymore.
+% \par\See{the \package{subfig} package\cite{subfig} documentation}
+ Вы задали опцию |caption=|\x|false|. Это используется для того,
+ чтобы не использовать пакет \package{caption} целиком (оставив изменения команд
+ подписей, сделанные классом документа или другим пакетом нетронутыми), но позволяет работать
+ пакету \package{subfig}. Этот механизм устаревший и~более не поддерживается,
+ поэтому используйте эту опцию при загрузке пакета \package{subfig} и~не загружайте
+ \thispackage\ вовсе.
+ \par\See{документацию пакета \package{subfig}\cite{subfig}}
+
+\Message
+ |Undefined boolean value `|\meta{value}|'.|
+\Description
+% You tried to set a boolean option (like |singlelinecheck=| or |hypcap=|)
+% with an improper value. Only |false|, |no|, |off|, |0| or |true|, |yes|,
+% |on|, |1| is allowed here.
+ Вы пытались задать булев ключ (например, |singlelinecheck=| или |hypcap=|)
+ с~неверной опцией. Только |false|, |no|, |off|, |0| или |true|, |yes|,
+ |on|, |1| допускаются в~опциях этих ключей.
+
+\Message
+ |Undefined format `|\meta{name}|'.|
+\Description
+% You tried to set a caption format which does not exists.
+% Maybe a typo!?
+ Вы пытаетесь задать формат подписи, который не существует.
+ Может быть это опечатка!?
+ \par\See{\Ref{formats}}
+
+\Message
+ |Undefined label format `|\meta{name}|'.|
+\Description
+% You tried to set a caption label format which does not exists.
+% Maybe a typo!?
+ Вы пытаетесь загрузить формат метки, который не существует.
+ Может быть это опечатка!?
+ \par\See{\Ref{formats}}
+
+\Message
+ |Undefined label separator `|\meta{name}|'.|
+\Description
+% You tried to set a caption label separator which does not exists.
+% Maybe a typo!?
+ Вы пытаетесь задать разделитель, который не существует.
+ Может быть это опечатка!?
+ \par\See{\Ref{formats}}
+
+\Message
+ |Undefined list format `|\meta{name}|'.|
+\Description
+% You tried to set a caption list-of format which does not exists.
+% Maybe a typo!?
+ Вы пытаетесь задать формат вывода для Списка флотов, который не существует.
+ Может быть это опечатка!?
+ \par\See{\Ref{lists}}
+
+\Message
+ |Undefined position `|\meta{name}|'.|
+\Description
+% You tried to set a caption position with an improper value.
+% Maybe a typo!?
+ Вы пытаетесь задать опцию расположения подписи, которая не существует.
+ Может быть это опечатка!?
+ \par\See{\Ref{skips}}
+
+\Message
+ |Undefined style `|\meta{name}|'.|
+\Description
+% You tried to set a caption style which does not exists.
+% Maybe a typo!?
+ Вы пытаетесь задать стиль подписи, который не существует.
+ Может быть это опечатка!?
+ \par\See{\Ref{style}}
+
+\Message
+ |Usage of the `position' option is incompatible|\\
+ |to the `|\meta{package}|' package.|
+\Description
+% % (ftcap,nonfloat,topcapt)
+% The given package is dealing with caption skips as well.
+% Please decide which one do you actually want to use: The |position=| option
+% of \thispackage\ or the mechanism of the other one; using both this way
+% would lead to wrong skips above or below the caption and is therefore
+% not supported.
+ Данный пакет изменяет отбивки вокруг подписи.
+ Решите, каким пакетом что вы собираетесь использовать: ключ |position=|
+ пакета \package{caption} или механизм другого пакета; использование обоих пакетов
+ может породить неверные отбивки сверху или снизу подписи и~соответственно не поддежривается.
+ \par\See{\Ref{skips}}
+
+\Message
+ |Undefined text format `|\meta{name}|'.|
+\Description
+% You tried to set a caption text format which does not exists.
+% Maybe a typo!?
+ Вы пытаетесь задать формат текста подписи, который не существует.
+ Может быть это опечатка!?
+ \par\See{\Ref{formats}}
+
+\Message
+ |You can't use both, the (obsolete) caption2 *and*|\\
+ |the (current) caption package.|
+\Description
+% This error message says it all, you simply can't do that.
+% Please use only \thispackage.
+ Это сообщение об ошибке сказало уже всё, и~вам просто нельзя это делать
+ [использовать пакеты \package{caption} и~\package{caption}2].
+ Используйте только \thispackage.
+ \par\See{\Ref{caption2}}
+
+
+\end{Warnings}
+
% --------------------------------------------------------------------------- %
-% \fi
-%
-% \pagebreak[3]
-%^^A \section{Further reading}
-% \section{Рекомендуемая литература}
-%
-%^^A I recommend the following documents for further reading:
-% Я рекомендую следующие документы для дальнейшего чтения:
-% \begin{itemize}
-% \def\tempa{ftm}\ifx\rmdefault\tempa
-% \fontencoding{T1}\fontfamily{ptm}\selectfont\fi
-% \item
-% The \TeX\ FAQ - Frequently asked questions about \TeX\ and \LaTeX :
-% \begin{quote}\url{http://faq.tug.org/}\end{quote}
-%
-% \item
-% A French FAQ can be found at
-% \begin{quote}\url{http://www.grappa.univ-lille3.fr/FAQ-LaTeX/}\end{quote}
-%
-% \item
-% \textsf{epslatex} from Keith Reckdahl contains many tips around
-% including graphics in \LaTeXe\ documents.
-% You will find this document in the directory
-% \begin{quote}\url{ftp://ftp.ctan.org/pub/tex/info/epslatex/}\end{quote}
-% \end{itemize}
-%
-% \iffalse
+
+\clearpage
+% \section{Version history}
+\section{История создания версий}
+\label{history}
+
+% The version $1.0$ was written in 1994 and was offering a handful of options
+% to customize the look \& feel of the captions.
+% Furthermore this version already supported the \package{rotating} and
+% \package{subfigure} packages.
+% Version $1.1$ introduced the |center|\-|last| option;
+% version $1.2$ added the support of the \package{float} package.
+% Version $1,3$ offered a better support of the \package{subfigure} package,
+% while version $1.4$ came with the new option |nooneline|.
+Версия $1.0$ была написана в~1994~году и~предлагала множество опций
+для настройки вывода подписей. Кроме того эта версия уже поддерживала пакеты
+\package{rotating} и~\package{subfigure}.
+Версия $1.1$ предложила опцию |center|\-|last|;
+версия $1.2$ добавила
+поддержку пакета \package{float}.
+Версия $1.3$ предложила улучшенную поддержку пакета \package{subfigure},
+тогда как версия $1.4$ вышла с~поддержкой опции |nooneline|.
+
+% The \package{caption2} package $2.0$ was an experimental side-version of
+% the regular \package{caption} package. It was made public as beta test version
+% without proper documentation in 1995 because of the strong demand for new
+% features and adaptations to additional packages like the \package{longtable}
+% package.
+% Furthermore it offered a revised support of the \package{subfigure} package.
+% (A version $2.1$ was offered as bugfix-release in 2002.)
+Пакет \package{caption2} версии $2.0$ был экспериментальной побочной версией
+основного пакета \package{caption}. Он был опубликован как бета-тест-версия
+без соответствующей документации в~1995~году, так как уже назрела необходимость
+в~новых настройках для других пакетов, например для \package{longtable}.
+Помимо этого была предложена поддержка пакета \package{subfigure}.
+(В~версии $2.1$, написанной в~2002~году были исправления ошибок.)
+
+% In 2003 I finally found some time, so a new regular release $3.0$
+% of the \package{caption} package could be build in cooperation with
+% Frank Mittelbach and Steven Cochran.
+% It was released in December 2003 and superseded the neglected
+% \package{caption2} package.
+% Main parts were re-written and it provided a complete re-work of
+% the user interface.
+% Furthermore it supported the \package{hyperref}, \package{hypcap},
+% \package{listings}, \package{sidecap}, and \package{supertabular} packages
+% additionally.
+В~2003~году я всё-таки нашёл немного времени, для нового релиза $3.0$
+пакета \package{caption}, созданного совместно
+с~Франком Миттельбахом (Frank Mittelbach) и~Стивеном Кокрейном (Steven Cochran).
+Эта версия была опубликована в~декабре 2003~года и~стала заменой
+пакета \package{caption2}.
+Основные части были переписаны, и~был предложен новый пользовательский интерфейс.
+Помимо этого появилась поддержка других пакетов \package{hyperref}, \package{hypcap},
+\package{listings}, \package{sidecap} и~\package{supertabular}.
+
+% While all the previous versions were designed for usage with the standard
+% \LaTeX\ document classes \class{article}, \class{report}, and \class{book},
+% the current version $3.1$ released in 2007 also supports the \AmS,
+% \KOMAScript, \NTG, and \SmF\ document classes, and the \class{beamer} class
+% as well.
+В~то время как предыдущие версии были созданы для стандартных классов
+\LaTeX'а: \class{article}, \class{report} и~\class{book},
+текущая версия $3.1$, опубликованная в~2007~году предлагает также поддержку для пакетов \AmS,
+\KOMAScript, {\NTG} и~\SmF, а~также класса \class{beamer}.
+% Furthermore it was adapted to the \package{frenchb} Babel option,
+% the \package{frenchle} \& \package{frenchpro} packages,
+% and the \package{floatflt}, \package{fltpage}, \package{picinpar},
+% \package{picins}, \package{setspace}, \package{threeparttable},
+% and \package{wrapfig} packages.
+Помимо этого создана поддержка к~опции \package{frenchb} пакета \package{babel},
+пакетам \package{frenchle} и~\package{frenchpro},
+а~также пакетам \package{floatflt}, \package{fltpage}, \package{picinpar},
+\package{picins}, \package{setspace}, \package{threeparttable}
+и~\package{wrapfig}.
+% New options and commands were introduced as well, among other things
+% |font+|, |figure|\-|within| \& |table|\-|within|,
+% |list| \& |list|\-|format|, |max|\-|margin| \& |min|\-|margin|,
+% |\caption|\-|list|\-|entry|, |\Declare|\-|Caption|\-|List|\-|Format|, and
+% |\Declare|\-|Caption|\-|Type|.
+Были предложены новые команды и~ключи, например помимо прочего
+|font+|, |figure|\-|within| и~|table|\-|within|,
+|list| и~|list|\-|format|, |max|\-|margin| и~|min|\-|margin|,
+|\caption|\-|list|\-|entry|, |\Declare|\-|Caption|\-|List|\-|Format| и~%
+|\Declare|\-|Caption|\-|Type|.
+% Further benefits are the new compatibility check \see*{\Ref{compatibility}},
+% the new ``hypcap'' feature \see*{\Ref{hyperref}\,}, and the sub-caption
+% feature \see*{\package{subcaption} package documentation}.
+В~дальнейшем были добавлены контроль совместимости с~классами и~пакетами
+\see*{\Ref{compatibility}},
+поддержка опции |hypcap| \see*{\Ref{hyperref}}
+и~возможности создания подписей частей флотов
+\see*{документацию к~пакету \package{subcaption}}.
+
+\clearpage
+% \section{Compatibility to older versions}
+\section{Совместимость со старыми версиями}
+
+\subsection{Пакет \package{caption} v\texorpdfstring{$1.x$}{1.x}}
+\label{caption1}
+
+% This version of \thispackage\ still supports the old options
+% and commands provided by the version $1.0$ to $1.4$ of this package.
+% So there shouldn't occur any problems compiling old documents, but please
+% don't mix old options and commands with the new ones. This isn't supported
+% and can cause ugly side effects.
+Данная версия пакета поддерживает старые опции и~команды
+созданные в~версиях $1.0$--$1.4$ этого пакета. Поэтому не должно возникать
+проблем в~компиляции старых документов, но, пожалуйста, не смешивайте
+старые опции и~команды с~новыми. Это не поддерживается
+и~может дать неприятные побочные эффекты.
+
+% Here comes a short oversight of the obsolete options and how
+% they have been replaced within this version of \thispackage:
+Здесь дан краткий обзор устаревших опций и~команд и~чем
+они заменены в~современной версии пакета \package{caption}:
+
+\begin{center}\small
+\begin{tabular}{ll}
+\package{caption} \version{1.x} & \package{caption} \version{3.x}\\
+\hline
+%\endhead
+|normal| & |format=plain|\\
+|hang| & |format=hang|\\
+|isu| & |format=hang|\\
+|center| & |justification=centering|\\
+|centerlast| & |justification=centerlast|\\
+%|anne| & |justification=centerlast|\\
+|nooneline| & |singlelinecheck=off|\\
+|scriptsize| & |font=scriptsize|\\
+|footnotesize| & |font=footnotesize|\\
+|small| & |font=small|\\
+|normalsize| & |font=normalsize|\\
+|large| & |font=large|\\
+|Large| & |font=Large|\\
+|up| & |labelfont=up|\\
+|it| & |labelfont=it|\\
+|sl| & |labelfont=sl|\\
+|sc| & |labelfont=sc|\\
+|md| & |labelfont=md|\\
+|bf| & |labelfont=bf|\\
+|rm| & |labelfont=rm|\\
+|sf| & |labelfont=sf|\\
+|tt| & |labelfont=tt|\\
+\end{tabular}
+\end{center}
+
+% Beside the options for setting up the desired font there were also
+% the commands |\caption|\-|size| resp.~|\caption|\-|font| and
+% |\caption|\-|label|\-|font| who could be redefined with
+% |\re|\-|new|\-|command| and allowed an alternate and more flexible way to
+% change the font used for captions.
+% This mechanism was replaced by the commands
+Помимо опций для настроек нужного шрифта были также команды
+|\caption|\-|size|, а~также |\caption|\-|font| и~|\caption|\-|label|\-|font|
+которые могли быть переопределены с~помощью |\renewcommand| и~позволяли
+альтернативный и~более гибкий способ изменить шрифт подписей.
+Данный механизм заменён на команды
+\begin{quote}
+ |\DeclareCaptionFont{|\ldots|}{|\ldots|}|\qquad и\\
+ |\captionsetup{font=|\ldots|,labelfont=|\ldots|}|\qquad.
+\end{quote}
+\SeeUserDefined
+
+% Setting the margin for captions was done in \version{1.x} with
+Установки полей в~версии \version{1.x} задавались с~помощью
+\begin{quote}
+ |\setlength{\captionmargin}{|\ldots|}|\quad.
+\end{quote}
+% This was replaced by
+Это заменено на
+\begin{quote}
+ |\captionsetup{margin=|\ldots|}|\qquad.
+\end{quote}
+\See{\Ref{margins}}
+
+% For example the old-style code
+Например, старый код
+\begin{quote}
+ |\usepackage[hang,bf]{caption}|\\
+ |\renewcommand\captionfont{\small\sffamily}|\\
+ |\setlength\captionmargin{10pt}|
+\end{quote}
+% will still work fine, but should be written today as
+до сих пор работает, но лучше переписать его как
+\begin{quote}
+ |\usepackage[format=hang,labelfont=bf,font={small,sf},|\\
+ | margin=10pt]{caption}|
+\end{quote}
+% or
+или
+\begin{quote}
+ |\usepackage{caption}|\\
+ |\captionsetup{format=hang,labelfont=bf,font={small,sf},|\\
+ | margin=10pt}|\qquad.
+\end{quote}
+
+% The quite exotic option |ruled| which allowed a partial usage of
+% the caption settings for |ruled| floats defined with the
+% \package{float} package will be emulated by this version of the
+% caption package, too.
+% But using this option is not recommended anymore since this
+% version of \thispackage\ offers a more flexible way
+% for changing the captions of these floating environments:
+Такая экзотическая опция |ruled|, которая позволяла частично использовать
+настройки подписи для флотов с~оформлением |ruled| из пакета
+\package{float}, эмулируется и~данным пакетом тоже.
+Но использование этой опции не рекомендуется, поскольку данная версия пакета
+предлагает более гибкий способ для изменения подписей
+таких окружений плавающих флотов:
+\begin{quote}
+ |\DeclareCaptionStyle{ruled}{|\ldots|}|
+\end{quote}
+% resp.
+и, соответственно
+\begin{quote}
+ |\captionsetup[ruled]{|\ldots|}|\qquad.
+\end{quote}
+\SeeUserDefined[, \Ref{captionsetup}, и~\Ref{float}]
+
+\subsection{Пакет caption2 v\texorpdfstring{$2.x$}{2.x}}
+\label{caption2}
+
+% Although they do very similar stuff, the packages \package{caption} and
+% its experimental and now obsolete variant \package{caption2} have a
+% very different implementation design.
+% Therefore a full compatibility could not be offered.
+% For that reason you will still find a file called |caption2.sty| in
+% this package distribution, so old documents using the \package{caption2}
+% package will still compile fine.
+Хотя используются одни и~те же настройки и~в~пакете \package{caption}
+и~в~экспериментальной, но сейчас устаревшей версии"=пакете
+\package{caption2}, у~этих пакетов совершенно разный механизм их задания.
+Поэтому полная совместимость невозможна.
+По этой причине до сих пор существует пакет |caption2.sty| в~данном
+дистрибутиве, и~старые документы, использующие пакет \package{caption2}
+будут компилироваться.
+
+% Newly created documents should use the actual version of
+% \thispackage\ instead. In most cases it's sufficient to replace the command
+Новые документы должны использовать современные версии пакета
+\package{caption}. В~большинстве случаев можно заменить строку
+\begin{quote}
+ |\usepackage[...]{caption2}|
+\end{quote}
+% by
+на
+\begin{quote}
+ |\usepackage[...]{caption}|\qquad.
+\end{quote}
+% But some options and commands will not be emulated, so you can get
+% error messages afterwards. This section will hopefully help you removing
+% these errors. If you have problems migrating from \package{caption2}
+% to \package{caption} please don't hesitate to send me an e-mail asking
+% for help.
+Но некоторые опции и~команды не эмулируются, и~вы можете
+получить сообщения об ошибках. Данный раздел поможет вам ликвидировать
+такие ошибки. Если у~вас проблемы по замене пакета \package{caption2}
+на \package{caption} не раздумывайте и~отправляйте мне e-mail.
+
+% In addition to the obsolete options shown in the last section
+% these ones will be emulated, too:
+Помимо устаревших опций из предыдущего раздела
+следующие также эмулируются:
+
+\begin{center}\small
+\begin{tabular}{ll}
+\package{caption2} \version{2.x} & \package{caption} \version{3.x}\\
+\hline
+%\endhead
+|flushleft| & |justification=raggedright|\\
+|flushright| & |justification=raggedleft|\\
+|oneline| & |singlelinecheck=on|\\
+\end{tabular}
+\end{center}
+
+% Setting the margin for captions was done in \version{2.x} with
+Задание втяжек (полей) для подписей, созданных в~\version{2.x}
+\begin{quote}\leavevmode\hbox{%
+ |\setcaptionmargin{|\ldots|}| или, соответственно
+ |\setcaptionwidth{|\ldots|}|\quad.
+}\end{quote}
+% This was replaced by
+Они могут быть заменены на
+\begin{quote}\leavevmode\hbox{%
+ |\captionsetup{margin=|\ldots|}| или, соответственно
+ |\captionsetup{width=|\ldots|}|\quad.
+}\end{quote}
+\See{\Ref{margins}}
+
+% Setting an indention was done in \version{2.x} with
+Втяжка в~версии \version{2.x} задавалась как
+\begin{quote}
+ |\captionstyle{indent}|\\
+ |\setlength\captionindent{|\ldots|}|\quad.
+\end{quote}
+\pagebreak[3]
+% This is now done with
+Сейчас это задаётся как
+\nopagebreak[3]
+\begin{quote}
+ |\captionsetup{format=plain,indention=|\ldots|}|\quad.
+\end{quote}
+
+% The so-called single-line-check was controlled by the commands
+% |\oneline|\-|captions|\-|false| (for switching the check off) and
+% |\oneline|\-|captions|\-|true| (for switching the check on).
+% This was replaced by
+Контроль короткой подписи контролируется командами
+|\oneline|\-|captions|\-|false| (отключает контроль)
+и~|\oneline|\-|captions|\-|true| (для включения контроля).
+Это заменено на
+|\caption|\-|setup{single|\-|line|\-|check=|\x|off}|
+% resp.
+и, соответственно
+|\caption|\-|setup{single|\-|line|\-|check=|\x|on}|.
+\See{\Ref{justification}}
+
+% The commands
+Команды
+\begin{quote}
+ |\captionlabeldelim|, |\captionlabelsep|, |\captionstyle|,\\
+ |\defcaptionstyle|, |\newcaptionstyle|, и~|\renewcaptionstyle|
+\end{quote}
+% do not have a simple replacement and therefore will not be emulated
+% by this version of \thispackage. (So using them will
+% cause error messages.) Rewriting such code is not always easy and
+% straight-ahead, but by conscientious reading of this manual you should
+% be able to find appropriate options and commands instead.
+не имеют простой замены поэтому не эмулируются
+данной версией пакета. (Их использование вызовет
+сообщение об ошибке.) Замена этого кода не всегда проста,
+но добросовестно прочитав данное руководство, вы сможете найти
+подходящие опции и~команды замены.
+
+\iffalse
+... (some examples)
+\fi
+
+% The \version{2.x} option |ignore|\-|LT|\-|cap|\-|width| do not have a
+% replacement, too.
+% But in most cases you can simply drop using that option because
+% in this version of \thispackage\ the value of |\LT|\-|cap|\-|width|
+% will be ignored anyway (unless you set it to a different value than the
+% default one which is |4in|).
+Опция |ignore|\-|LT|\-|cap|\-|width| версии \version{2.x} тоже не имеет замены.
+Но в~большинстве случаев эту опцию можно опустить, потому что в~данной
+версии пакета значение |\LT|\-|cap|\-|width|
+будет игнорироваться в~любом случае (если только вы не зададите значение,
+отличное от заданного по умолчанию |4in|).
+\See{\Ref{longtable}}
+
+\subsection{Пакет caption v\texorpdfstring{$3.0$}{3.0}}
+\label{caption3}
+
+%\NEWdescription{v3.1}
+% \Thispackage\ \version{3.0} did not support any document classes
+% other than the standard \LaTeX\ ones: \class{article}, \class{report},
+% and \class{book}.
+% Therefore the default settings used to be fixed, but now \thispackage{}
+% supports more classes, therefore they are now set in dependence on the
+% document class used.
+\Thispackage\ \version{3.0} не поддерживал никаких классов документов, кроме
+стандартных классов \LaTeX'а: \class{article}, \class{report},
+and \class{book}.
+В~старых настройках ведётся работа над ошибками, но~теперь \thispackage{}
+поддерживает больше классов, поэтому настройки подписей зависят от используемого
+класса документа.
+
+% For example: While in \version{3.0} the default caption
+% |jus|\-|ti|\-|fi|\-|ca|\-|tion| used to be always |jus|\-|ti|\-|fied|,
+% it's now still |jus|\-|ti|\-|fied| when using one of the standard document
+% classes, but |ragged|\-|right| will be used as default format when used
+% with the \class{beamer} document class.
+Например, в~то время как в~версии $3.0$ значением ключа |justification|
+по умолчанию является |justi|\-|fied|, оно останется |justi|\-|fied| при использовании
+стандартных классов документов, но заменяется на |ragged|\-|right| при использовании
+класса документа \class{beamer}.
+
+% %An easy way to select the `old' defaults---if desired---is using the option
+% An easy way to select the `old' defaults is using the option
+% |style=base| when loading \thispackage\ (or later on using |\caption|\-|setup|).
+Простой путь задать «старые» значения по умолчанию \cdash--- использовать опцию
+|style=base| при загрузке пакета (или позднее, в~команде |\caption|\-|setup|).
+
+% Another new feature is the automatic check for compatibility; if an
+% incompatibility will be found, a warning message will be issued and if a strong
+% incompatibility was found some features of \thispackage\ will be disabled.
+Ещё одной особенностью стала автоматическая проверка на совместимость [класса и~пакета]; если
+обнаруживается несовместимость, выдаётся предупреждение о~несовместимости некоторых возможностей
+данного пакета с~классом документа.
+% Please note that only this check was added to \thispackage, so if you get
+% such warning message, the previous versions of \thispackage\ were incompatible
+% as well, but did not issued such warning, they were ``only'' having
+% side-effects or causing problems.
+Обратите внимание, что такое предупреждение появилось только в~текущей версии пакета, поэтому если
+вы получили это сообщение это означает, что и~предыдущие версии были также несовместимы,
+и~они уже имели побочные эффекты и~могли создавать проблемы.
+% So these warnings only say that some bad side effects or problems could
+% happen, but not that they actually will happen.
+% Anyway, if you use \thispackage\ in such circumstances,
+% you should use it with care.
+Эти предупреждения говорят, что \emph{могут} появиться проблемы, но это не значит, что они
+непременно появятся.
+В~любом случае если вы используете \thispackage\ игнорируя это предупреждение,
+будьте осторожны.
+
+\bigskip
+
+\begin{Note*}
+% \Thispackage\ \version{3.0} offered the option |caption=|\x|false|,
+% which used to be a workaround for not using the whole \package{caption} package
+% (leaving the caption stuff offered by the document class or other packages
+% intact), but keeping the \package{subfig} package\cite{subfig} working.
+% This mechanism is obsolete and not offered anymore, please pass this option
+% to the \package{subfig} package instead and do not load \thispackage\ anymore.
+% %\par\See{the \package{subfig} package documentation}
+Пакет версии \version{3.0} предлагал опцию |caption=false|, которая включала лишь
+частичное использование возможностей пакета \package{caption} (сохраняя
+настройки класса документа или других пакетов нетронутыми), но оставляла
+возможность работы пакета \package{subfig}.
+Этот механизм теперь устаревший и~больше не поддерживается,
+поэтому задавайте, пожалуйста, эту опцию при загрузке пакета \package{subfig},
+и~не загружайте данный пакет вовсе.
+%\par\See{the \package{subfig} package\cite{subfig} documentation}
+\end{Note*}
+
% --------------------------------------------------------------------------- %
-% \fi
-%
-%^^A \section{Thanks}
-% \section{Благоданости}
-%
-%\begingroup
-% \fontencoding{T1}\fontfamily{ptm}\selectfont
-% I would like to thank Katja Melzner,
-% Steven D. Cochran, Frank Mittelbach,
-% David Carlisle, Carsten Heinz, Olga Lapko, and Keith Reckdahl.
-% Thanks a lot for all your help, ideas, patience, spirit, and support!
-%
-% Also I would like to thank
-% Harald Harders,
-% Peter L\"offler,
-% Peng Yu,
-% Alexander Zimmermann,
-% Matthias Pospiech,
-% J\"urgen Wieferink,
-% Christoph Bartoschek,
-% Uwe St\"ohr,
-% Ralf Stubner,
-% Geoff Vallis,
-% Florian Keiler,
-% J\"urgen G\"obel,
-% Uwe Siart,
-% Sang-Heon Shim,
-% Henrik Lundell,
-% David Byers,
-% William Asquith,
-% and
-% Prof.~Dr.~Dirk Hoffmann,
-% who all helped to make this package a better one.
-%
-%\endgroup
+
+\clearpage
+\begin{thebibliography}{99}
+\fontencoding{T1}%\fontfamily{ptm}
+\selectfont
+ \bibitem{TLC2}
+ Frank Mittelbach and Michel Goossens:\\
+ \newblock {\em The {\LaTeX} Companion (2nd.~Ed.)},\\
+ \newblock Addison-Wesley, 2004.
+
+ \bibitem{beamer}
+ Till Tantau:\\
+ \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/beamer/}%
+% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/beamer/doc/beameruserguide.pdf}%
+ {\emph{User Guide to the Beamer Class, Version 3.07}},\\
+ March 11, 2007
+
+ \bibitem{KOMAScript}
+ Markus Kohm \& Jens-Uwe-Morawski:\\
+ \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/koma-script/}%
+% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/koma-script/scrguien.pdf}%
+ {\emph{KOMA-Script -- a versatile \LaTeXe\ bundle}},\\
+ 2007-01-09
+
+ \bibitem{NTG}
+ Victor Eijkhout:\\
+ \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/ntgclass/}%
+% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/ntgclass/classdoc.pdf}%
+ {\emph{An introduction to the Dutch \LaTeX\ document classes}},\\
+ 3 September 1989
+
+ \bibitem{algorithms}
+ Rog\'erio Brito:\\
+ \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/algorithms/}%
+% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/algorithms/algorithms.pdf}%
+ {\emph{Algorithms}},\\
+ June 2, 2006
+%
+\iffalse
+ \bibitem{algorithm2e}
+ Christophe Fiorio:\\
+ \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/algorithm2e/}%
+% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/algorithm2e/algorithm2e.pdf}%
+ {\emph{algorithm2e.sty -- package for algorithms}},\\
+ March 11, 2007
+\fi
%
-% \iffalse
+ \bibitem{float}
+ Anselm Lingnau:\\
+ \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/float/}%
+% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/float/float.pdf}%
+ {\emph{An Improved Environment for Floats}},\\
+ 2001/11/08
+
+ \bibitem{floatflt}
+ Mats Dahlgren:\\
+ \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/floatflt/}%
+% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/floatflt/floatflt.pdf}%
+ {\emph{Welcome to the floatflt package}},\\
+ 1998/06/05
+
+ \bibitem{floatrow}
+ Olga Lapko:\\
+ \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/floatrow/}%
+% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/floatrow/floatrow.pdf}%
+ {\emph{The floatrow package documentation}},\\
+ 2008/03/28
+
+ \bibitem{fltpage}
+ Sebastian Gross:\\
+ \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/fltpage/}%
+% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/fltpage/fltpage.pdf}%
+ {\emph{Welcome to the beta test of fltpage package!}},\\
+ 1998/11/13
+
+ \bibitem{hyperref}
+ Sebastian Rahtz \& Heiko Oberdiek:\\
+ \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/hyperref/}%
+% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/hyperref/hyperref.pdf}%
+ {\emph{Hypertext marks in \LaTeX}},\\
+ November 12, 2007
+
+ \bibitem{hypcap}
+ Heiko Oberdiek:\\
+ \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/oberdiek/}%
+% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/oberdiek/hypcap.pdf}%
+ {\emph{The hypcap package -- Adjusting anchors of captions}},\\
+ 2007/04/09
+
+ \bibitem{listings}
+ Carsten Heinz \& Brooks Moses:\\
+ \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/listings/}%
+% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/listings/listings.pdf}%
+ {\emph{The Listings Package}},\\
+ 2007/02/22
+
+ \bibitem{longtable}
+ David Carlisle:\\
+ \href{http://tug.ctan.org/tex-archive/macros/latex/required/tools/}%
+% \href{ftp://tug.ctan.org/tex-archive/macros/latex/required/tools/longtable.pdf}%
+ {\emph{The longtable package}},\\
+ 2004/02/01
+
+ \bibitem{picinpar}
+ Friedhelm Sowa:\\
+ \href{http://tug.ctan.org/tex-archive/macros/latex209/contrib/picinpar/}%
+% \href{ftp://tug.ctan.org/tex-archive/macros/latex209/contrib/picinpar/}%
+ {\emph{Pictures in Paragraphs}},\\
+ July 13, 1993
+
+ \bibitem{picins}
+ Joachim Bleser and Edmund Lang:\\
+ \href{http://tug.ctan.org/tex-archive/macros/latex209/contrib/picins/}%
+% \href{ftp://tug.ctan.org/tex-archive/macros/latex209/contrib/picins/mpic.dvi}%
+ {\emph{PicIns-Benutzerhandbuch Version 3.0}},\\
+ September~1992
+
+ \bibitem{rotating}
+ Sebastian Rahtz and Leonor Barroca:\\
+ \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/rotating/}%
+% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/rotating/}%
+ {\emph{A style option for rotated objects in \LaTeX}},\\
+ 1997/09/26
+
+ \bibitem{setspace}
+ Erica M. S. Harris \& Geoffrey Tobin:\\
+ \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/setspace/}%
+% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/setspace/}%
+ {\emph{LaTeX Document Package ``setspace''}},\\
+ 1 December 2000
+
+ \bibitem{sidecap}
+ Rolf Niepraschk \& Hubert G\"a\ss lein:\\
+ \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/sidecap/}%
+% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/sidecap/sidecap.pdf}%
+ {\emph{The sidecap package}},\\
+ 2003/06/06
+
+ \bibitem{subfigure}
+ Steven D. Cochran:\\
+ \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/subfigure/}%
+% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/subfigure/subfigure.pdf}%
+ {\emph{The subfigure package}},\\
+ 2002/07/02
+
+ \bibitem{subfig}
+ Steven D. Cochran:\\
+ \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/subfig/}%
+% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/subfig/subfig.pdf}%
+ {\emph{The subfig package}},\\
+ 2005/07/05
+
+ \bibitem{supertabular}
+ Johannes Braams and Theo Jurriens:\\
+ \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/supertabular/}%
+% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/supertabular/supertabular.pdf}%
+ {\emph{The supertabular environment}},\\
+ 2002/07/19
+
+ \bibitem{threeparttable}
+ Donald Arseneau:\\
+ \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/misc/}%
+% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/misc/threeparttable.sty}%
+ {\emph{Three part tables: title, tabular environment, notes}},\\
+ 2003/06/13
+
+ \bibitem{wrapfig}
+ Donald Arseneau:\\
+ \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/wrapfig/}%
+% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/wrapfig/wrapfig.sty}%
+ {\emph{WRAPFIG.STY ver 3.6}},\\
+ 2003/01/31
+
+ \bibitem{xtab}
+ Peter Wilson:\\
+ \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/xtab/}%
+ {\emph{The xtab package}},\\
+ 2004/05/24
+
+\end{thebibliography}
+
% --------------------------------------------------------------------------- %
-% \fi
-% \StopEventually{\begin{thebibliography}{9}
-% \fontencoding{T1}\fontfamily{ptm}\selectfont
-% \bibitem{companion}
-% Frank Mittelbach and Michel Goossens:
-% \newblock {\em The {\LaTeX} Companion (2nd.~Ed.)},
-% \newblock Addison-Wesley, 2004.
-%
-% \bibitem{float}
-% Anselm Lingnau:
-% \emph{An Improved Environment for Floats},
-% 2001/11/08
-%
-% \bibitem{floatrow}
-% Olga Lapko:
-% \emph{The floatrow package documentation},
-% 2005/05/22
-%
-% \bibitem{hyperref}
-% Sebastian Rahtz \& Heiko Oberdiek:
-% \emph{Hypertext marks in \LaTeX},
-% 2007/01/25
-%
-% \bibitem{hypcap}
-% Heiko Oberdiek:
-% \emph{The hypcap package -- Adjusting anchors of captions}
-% 2001/08/27
-%
-% \bibitem{listings}
-% Carsten Heinz:
-% \emph{The Listings Package},
-% 2004/02/13
-%
-% \bibitem{longtable}
-% David Carlisle:
-% \emph{The longtable package},
-% 2000/10/22
-%
-% \bibitem{rotating}
-% Sebastian Rahtz and Leonor Barroca:
-% \emph{A style option for rotated objects in \LaTeX},
-% 1997/09/26
-%
-% \bibitem{sidecap}
-% Rolf Niepraschk und Hubert G\"a\ss lein:
-% \emph{The sidecap package},
-% 2003/06/06
-%
-% \bibitem{subfig}
-% Steven D. Cochran:
-% \emph{The subfig package},
-% 2005/07/05
-%
-% \bibitem{supertabular}
-% Johannes Braams und Theo Jurriens:
-% \emph{The supertabular environment},
-% 2002/07/19
-%
-% \bibitem{Anne}
-% Anne Br\"uggemann-Klein:
-% \emph{Einf\"uhrung in die Dokumentverarbeitung},
-% B.G. Teubner, Stuttgart, 1989
-% \end{thebibliography}}
-%
-% \Finale
-%
-\endinput
+
+\end{document}