From e0c6872cf40896c7be36b11dcc744620f10adf1d Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Mon, 2 Sep 2019 13:46:59 +0900 Subject: Initial commit --- macros/latex/contrib/caption/caption-rus.tex | 6229 ++++++++++++++++++++++++++ 1 file changed, 6229 insertions(+) create mode 100644 macros/latex/contrib/caption/caption-rus.tex (limited to 'macros/latex/contrib/caption/caption-rus.tex') diff --git a/macros/latex/contrib/caption/caption-rus.tex b/macros/latex/contrib/caption/caption-rus.tex new file mode 100644 index 0000000000..c3b536cc2f --- /dev/null +++ b/macros/latex/contrib/caption/caption-rus.tex @@ -0,0 +1,6229 @@ +% +% This is file `caption-rus.tex'. +% Russian translation of `caption-eng.tex' +% +% $Id$ +% $HeadURL$ +% +% Copyright (C) 1994-2007 Axel Sommerfeldt (axel.sommerfeldt@f-m.fm) +% +% -------------------------------------------------------------------------- +% +% 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{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} + +\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. + v3.1m, последний раз модифицирован 2010/01/09. +%^^A% Translation 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)\\ + \url{https://gitlab.com/axelsommerfeldt/caption}} +\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| + \end{quote} +% gives captions like this one: + создаётся такая подпись: + \example{format=plain,labelformat=parens,labelsep=quad}{\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|, содержимое которых занимает целую страницу. +Подпись при этом размещается на предыдущей или следующей странице [на развороте].} + +\iffalse +\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} +\fi + +% 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{http://mirror.ctan.org/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} \\ +\iffalse +% |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} \\ +\fi +% |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|\\ +|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://www.ctan.org/pkg/beamer}% + {\emph{User Guide to the Beamer Class, Version 3.07}},\\ + March 11, 2007 + + \bibitem{KOMAScript} + Markus Kohm \& Jens-Uwe-Morawski:\\ + \href{http://www.ctan.org/pkg/koma-script}% + {\emph{KOMA-Script -- a versatile \LaTeXe\ bundle}},\\ + 2007-01-09 + + \bibitem{NTG} + Victor Eijkhout:\\ + \href{http://www.ctan.org/pkg/ntgclass}% + {\emph{An introduction to the Dutch \LaTeX\ document classes}},\\ + 3 September 1989 + + \bibitem{algorithms} + Rog\'erio Brito:\\ + \href{http://www.ctan.org/pkg/algorithms}% + {\emph{Algorithms}},\\ + June 2, 2006 + +\iffalse + \bibitem{algorithm2e} + Christophe Fiorio:\\ + \href{http://www.ctan.org/pkg/algorithm2e}% + {\emph{algorithm2e.sty -- package for algorithms}},\\ + March 11, 2007 +\fi + + \bibitem{float} + Anselm Lingnau:\\ + \href{http://www.ctan.org/pkg/float}% + {\emph{An Improved Environment for Floats}},\\ + 2001/11/08 + + \bibitem{floatflt} + Mats Dahlgren:\\ + \href{http://www.ctan.org/pkg/floatflt}% + {\emph{Welcome to the floatflt package}},\\ + 1998/06/05 + + \bibitem{floatrow} + Olga Lapko:\\ + \href{http://www.ctan.org/pkg/floatrow}% + {\emph{The floatrow package documentation}},\\ + 2008/03/28 + + \bibitem{fltpage} + Sebastian Gross:\\ + \href{http://www.ctan.org/pkg/fltpage}% + {\emph{Welcome to the beta test of fltpage package!}},\\ + 1998/11/13 + + \bibitem{hyperref} + Sebastian Rahtz \& Heiko Oberdiek:\\ + \href{http://www.ctan.org/pkg/hyperref}% + {\emph{Hypertext marks in \LaTeX}},\\ + November 12, 2007 + + \bibitem{hypcap} + Heiko Oberdiek:\\ + \href{http://www.ctan.org/pkg/hypcap}% + {\emph{The hypcap package -- Adjusting anchors of captions}},\\ + 2007/04/09 + + \bibitem{listings} + Carsten Heinz \& Brooks Moses:\\ + \href{http://www.ctan.org/pkg/listings}% + {\emph{The Listings Package}},\\ + 2007/02/22 + + \bibitem{longtable} + David Carlisle:\\ + \href{http://www.ctan.org/pkg/longtable}% + {\emph{The longtable package}},\\ + 2004/02/01 + + \bibitem{picinpar} + Friedhelm Sowa:\\ + \href{http://www.ctan.org/pkg/picinpar}% + {\emph{Pictures in Paragraphs}},\\ + July 13, 1993 + + \bibitem{picins} + Joachim Bleser and Edmund Lang:\\ + \href{http://www.ctan.org/pkg/picins}% + {\emph{PicIns-Benutzerhandbuch Version 3.0}},\\ + September~1992 + + \bibitem{rotating} + Sebastian Rahtz and Leonor Barroca:\\ + \href{http://www.ctan.org/pkg/rotating}% + {\emph{A style option for rotated objects in \LaTeX}},\\ + 1997/09/26 + + \bibitem{setspace} + Erica M. S. Harris \& Geoffrey Tobin:\\ + \href{http://www.ctan.org/pkg/setspace}% + {\emph{LaTeX Document Package ``setspace''}},\\ + 1 December 2000 + + \bibitem{sidecap} + Rolf Niepraschk \& Hubert G\"a\ss lein:\\ + \href{http://www.ctan.org/pkg/sidecap}% + {\emph{The sidecap package}},\\ + 2003/06/06 + + \bibitem{subfigure} + Steven D. Cochran:\\ + \href{http://www.ctan.org/pkg/subfigure}% + {\emph{The subfigure package}},\\ + 2002/07/02 + + \bibitem{subfig} + Steven D. Cochran:\\ + \href{http://www.ctan.org/pkg/subfig}% + {\emph{The subfig package}},\\ + 2005/07/05 + + \bibitem{supertabular} + Johannes Braams and Theo Jurriens:\\ + \href{http://www.ctan.org/pkg/supertabular}% + {\emph{The supertabular environment}},\\ + 2002/07/19 + + \bibitem{threeparttable} + Donald Arseneau:\\ + \href{http://www.ctan.org/pkg/threeparttable}% + {\emph{Three part tables: title, tabular environment, notes}},\\ + 2003/06/13 + + \bibitem{wrapfig} + Donald Arseneau:\\ + \href{http://www.ctan.org/pkg/wrapfig}% + {\emph{WRAPFIG.STY ver 3.6}},\\ + 2003/01/31 + + \bibitem{xtab} + Peter Wilson:\\ + \href{http://www.ctan.org/pkg/xtab}% + {\emph{The xtab package}},\\ + 2004/05/24 + +\end{thebibliography} + +% --------------------------------------------------------------------------- % + +\end{document} -- cgit v1.2.3