%
% This is file `caption-rus.tex'.
% Russian translation of `caption-eng.tex'
%
% Copyright (C) 1994-2007 Axel Sommerfeldt (caption@sommerfee.de)
%
% --------------------------------------------------------------------------
%
% This work may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either version 1.3
% of this license or (at your option) any later version.
% The latest version of this license is in
%   http://www.latex-project.org/lppl.txt
% and version 1.3 or later is part of all distributions of LaTeX
% version 2003/12/01 or later.
%
% This work has the LPPL maintenance status "maintained".
%
% This Current Maintainer of this work is Axel Sommerfeldt.
%
% This work consists of the files caption.ins, caption.dtx, caption2.dtx,
% ltcaption.dtx, and subcaption.dtx, the derived files caption.sty,
% caption2.sty, caption3.sty, ltcaption.sty, and subcaption.sty, and the
% user manuals caption-deu.tex, caption-eng.tex, and caption-rus.tex.
%
\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,afterpage}

\setlength\parindent{0pt}
\setlength\parskip{\smallskipamount}
\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[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}
\DeclareCaptionLabelFormat{fullparens}{(\bothIfFirst{#1}{~}#2)}
\DeclareCaptionLabelSeparator{fill}{\hfill}
% 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}

\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
\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

\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}
\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]{см.}}}

% --------------------------------------------------------------------------- %

\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).}}
      Перевод документации 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
%^^A% \item Last line of caption centered
\item Выключка последней строки по центру
  \pageref{TeXr:centerlast}
%^^A% \item Hanged caption label
\item Нумерационный заголовок на весу
  \pageref{TeXr:hang:label}
%
%^^A  \indexspace
%
%^^A% \item Spaces above and below captions
\item Отбивки у~подписей над и~под флотами
   \pageref{TeXr:captionskips:a}%^^A--\pageref{TeXr:captionskips:z}
%^^A% \item Settings, for caption label
\item Оформление
%^^A% \subitem for caption label
\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}
%^^A% \subitem for multi-paragraph captions
\subitem подписей из нескольких абзацев
   \pageref{TeXr:multipar:a}%^^A--\pageref{TeXr:multipar:z}
%
%^^A  \indexspace
%
%^^A% \item Captions
\item Подписи\nopagebreak
%^^A% \subitem for continued floats
\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}
%^^A% \subitem  skipped entry in list
\subitem без записи в~списке рисунков,
%^^A% \subsubitem trick with empty option
  \subsubitem трюк с~дополнительным аргументом команды
   |\caption| \pageref{TeXr:nolistentry:I}
%^^A% \subsubitem key |listof=|
  \subsubitem  ключ пакета |list=|
   \pageref{TeXr:nolistentry:II}
%^^A% \subitem unlabeled
\subitem без нумерационного заголовка
   \pageref{TeXr:starcaption:a}%^^A--\pageref{TeXr:starcaption:z}
%^^A% \subitem outside float
\subitem вне окружения флота
   \pageref{TeXr:captionof:a}%^^A--\pageref{TeXr:captiononof:z}
%
\end{multicols}%
\endgroup
\clearpage
%
% --------------------------------------------------------------------------- %

\clearpage
\tableofcontents

% --------------------------------------------------------------------------- %

\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}

% --------------------------------------------------------------------------- %

\clearpage
% \section{Options}
\section{Опции}
\label{options}

\def\OptionLabel{RaggedRight}
\def\UserDefined{\ldots}

% --------------------------------------------------------------------------- %

% \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{Прим.\,перев.}]

% 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
  Собственное оформление может быть определено с~помощью
  команды |\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
  Собственные разделители можно определить, используя команду
  |\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}

% --------------------------------------------------------------------------- %

\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}.

%\showhyphens{justification}
  \item[\UserDefined]
%     Own justifications can be defined using
%   |\Declare|\-|Caption|\-|Jus|\-|ti|\-|fi|\-|ca|\-|tion|.
%   \SeeUserDefined
  Собственные определения выключки можно задать с~помощью команды
  |\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}

% --------------------------------------------------------------------------- %

% \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
  Собственные опции могут быть определены с~помощью команды
  |\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}

% --------------------------------------------------------------------------- %

% \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}

% --------------------------------------------------------------------------- %

\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
Собственные стили подписи могут быть определены с~помощью
команды |\Declare|\-|Caption|\-|Style|.\LineBreak\SeeUserDefined
\end{Note}

% --------------------------------------------------------------------------- %

% \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*}

% --------------------------------------------------------------------------- %

% \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}.}

% --------------------------------------------------------------------------- %

% \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*}

% --------------------------------------------------------------------------- %

% \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.}


% --------------------------------------------------------------------------- %

\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
В~то время как незвёздный вариант даст вам предупреждение, если \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}

% --------------------------------------------------------------------------- %

\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}
%    |\DeclareCaptionType{diagram}[Diagramm][Diagrammverzeichnis]|
% \end{quote}
%
Подобное же определение для русской документации должно выглядеть так:
\begin{quote}
   |\DeclareCaptionType{diagram}[Диаграмма][Список диаграмм]|
\end{quote}

% --------------------------------------------------------------------------- %

% \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|, увеличивает счётчик флота.)


% --------------------------------------------------------------------------- %

\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}.

% --------------------------------------------------------------------------- %

\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
% 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
% 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}

% --------------------------------------------------------------------------- %

\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}

% --------------------------------------------------------------------------- %

\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.}

% --------------------------------------------------------------------------- %

\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}

% --------------------------------------------------------------------------- %

\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*}

% --------------------------------------------------------------------------- %

\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
%
  \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}

% --------------------------------------------------------------------------- %

\end{document}
