From 0b904a95f3f8050fe64fda5a4762fee1871e6e62 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 9 Apr 2008 18:18:02 +0000 Subject: caption 3.1h (7apr08) git-svn-id: svn://tug.org/texlive/trunk@7360 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/caption/README | 2 +- .../texmf-dist/doc/latex/caption/caption-rus.pdf | Bin 429149 -> 675898 bytes .../texmf-dist/doc/latex/caption/caption-rus.tex | 8596 ++++++++++++++------ 3 files changed, 6146 insertions(+), 2452 deletions(-) (limited to 'Master/texmf-dist/doc/latex/caption') diff --git a/Master/texmf-dist/doc/latex/caption/README b/Master/texmf-dist/doc/latex/caption/README index 96aceb06fad..25b8750151b 100644 --- a/Master/texmf-dist/doc/latex/caption/README +++ b/Master/texmf-dist/doc/latex/caption/README @@ -24,7 +24,7 @@ Furthermore the `floatrow', the `subcaption', and the `subfig' package supports the `caption' package and uses its \captionsetup interface. User Manual: caption-eng.pdf (English) - caption-rus.pdf (Russian, outdated) + caption-rus.pdf (Russian) caption-deu.pdf (German) -------------------------------------------------------------------------- diff --git a/Master/texmf-dist/doc/latex/caption/caption-rus.pdf b/Master/texmf-dist/doc/latex/caption/caption-rus.pdf index 80802bf0584..7f48b7ebab8 100644 Binary files a/Master/texmf-dist/doc/latex/caption/caption-rus.pdf and b/Master/texmf-dist/doc/latex/caption/caption-rus.pdf differ diff --git a/Master/texmf-dist/doc/latex/caption/caption-rus.tex b/Master/texmf-dist/doc/latex/caption/caption-rus.tex index 8a47c6521c8..2cd238509b2 100644 --- a/Master/texmf-dist/doc/latex/caption/caption-rus.tex +++ b/Master/texmf-dist/doc/latex/caption/caption-rus.tex @@ -1,10 +1,8 @@ -% \iffalse meta-comment % % This is file `caption-rus.tex'. -% Russian translation of documented part of `caption.dtx' +% Russian translation of `caption-eng.tex' % % Copyright (C) 1994-2007 Axel Sommerfeldt (caption@sommerfee.de) -% and Olga Lapko (Lapko.O@g23.relcom.ru) % % -------------------------------------------------------------------------- % @@ -25,2530 +23,6226 @@ % caption2.sty, caption3.sty, ltcaption.sty, and subcaption.sty, and the % user manuals caption-deu.tex, caption-eng.tex, and caption-rus.tex. % -% \fi -% \CheckSum{0} -% -% \iffalse -%<*driver> -\documentclass[russian]{ltxdoc} +\NeedsTeXFormat{LaTeX2e}[1994/12/01] +\ProvidesFile{caption-rus.tex}[2008/04/06 v3.1h The caption package in Russian] +\hbadness=9999 \newcount\hbadness \hfuzz=20pt % Make TeX shut up. +%\errorcontextlines=3 +\documentclass[USenglish,russian,a4paper]{ltxdoc} +\usepackage{fixltx2e} \usepackage{mathtext} \usepackage[T2A]{fontenc} \usepackage[cp1251]{inputenc} \usepackage{babel} -\usepackage{listpen} +\usepackage{listpen,afterpage} + \setlength\parindent{0pt} \setlength\parskip{\smallskipamount} -% -\newcommand\NEWfeature{\NEW{Новая возможность}} -\newcommand\NEWdescription{\NEW{Новое описание}} -% -\font\manual=manfnt -\newcommand\DANGER{\hskip 1sp \marginpar{\raggedleft\textcolor{blue}{{\manual\char127}}}} -% -\ifx\pdfoutput\undefined\else - \ifcase\pdfoutput\else -% \usepackage{mathptmx,courier} -% \usepackage[scaled=0.90]{helvet} -% \def\rmdefault{ftm} -% \def\sfdefault{ftx} -% \def\ttdefault{cmtt} - \addtolength\marginparwidth{15pt} +\setlength\leftmargini{1.5em}% default = 2.5em +\makeatletter +\g@addto@macro\MacroFont{\normalcolor} +\@flushglue = 1em plus 1fil +\parfillskip = 1em plus 1fil +\makeatother + +\newcommand\LineBreak{\linebreak[3]} +\newcommand\PageBreak{\pagebreak[3]} +\usepackage{ifpdf} +\ifpdf + \usepackage{mathptmx} + \addtolength\marginparwidth{15pt} + \IfFileExists{literat.sty}{\usepackage{literat}}{} +% \IfFileExists{t2aftx.fd}{\def\sfdefault{ftx}}{} +% \IfFileExists{t2apxtt.fd}{\def\ttdefault{pxtt}}{} + \ifdim\paperheight=297mm % a4paper + \advance\textheight.5in + \advance\topmargin-.35in + \emergencystretch1em + \tolerance7000 + \renewcommand\LineBreak{\\} + \renewcommand\PageBreak{\clearpage} \fi \fi -% -%\usepackage[french,USenglish]{babel} -\usepackage{color,setspace} -% -%\usepackage{float} -\usepackage{longtable} -%\usepackage[raggedright]{sidecap} -% -\usepackage{caption}[2005/08/24] -\DeclareCaptionLabelSeparator{endash}{\space\textendash\space} -\usepackage[unicode]{hyperref} -% -\DeclareCaptionFont{singlespacing}{\setstretch{1}} -\DeclareCaptionFont{onehalfspacing}{\onehalfspacing} -\DeclareCaptionFont{doublespacing}{\doublespacing} -\DeclareCaptionFont{red}{\color{red}} -\DeclareCaptionFont{green}{\color{green}} -\DeclareCaptionFont{blue}{\color{blue}} -% -\DeclareCaptionLabelSeparator{period-newline}{. \\} -\DeclareCaptionStyle{period-newline}[labelsep=period]{labelsep=period-newline} -\DeclareCaptionStyle{period-newline2}[labelsep=period,justification=centering]{labelsep=period-newline} -\DeclareCaptionStyle{period-newline3}[labelsep=period]{labelsep=period-newline,justification=centering} + +\usepackage[bottom]{footmisc} +\usepackage{graphicx,longtable,setspace} +\IfFileExists{test/tlc2/cat.eps}{\graphicspath{{test/tlc2/}}}{}% + +\usepackage{hypdoc} +\hypersetup{unicode} +\ifpdf\usepackage{hypdestopt}\fi +\hypersetup{pdfkeywords={LaTeX, package, caption},pdfstartpage={},pdfstartview={}} +\hypersetup{breaklinks=true} + +\usepackage[listof=0,hypcap=false]{caption}[2008/04/01] + +\def\itemautorefname {\cyr\cyrp.}% +\def\figureautorefname {\cyr\cyrr\cyri\cyrs.}% +\def\tableautorefname {\cyr\cyrt\cyra\cyrb\cyrl.}% +\def\partautorefname {\cyr\cyrch.}% +\def\appendixautorefname {\cyr\cyrp\cyrr\cyri\cyrl.}% +\def\chapterautorefname {\cyr\cyrg\cyrl.}% +\def\sectionautorefname {\cyr\cyrr\cyra\cyrz\cyrd.}% +\def\subsectionautorefname {\cyr\cyrr\cyra\cyrz\cyrd.}% +\def\subsubsectionautorefname {\cyr\cyrr\cyra\cyrz\cyrd.}% +\def\paragraphautorefname {\cyr\cyrp.}% +\def\subparagraphautorefname {\cyr\cyrp.}% +\def\pageautorefname {\cyr\cyrs.}% + +\DeclareRobustCommand*\eTeX{\texorpdfstring + {\leavevmode\hbox{$\varepsilon$}-\TeX}% + {e-TeX}} +\DeclareRobustCommand*\AmS{\texorpdfstring + {{\protect\usefont{OMS}{cmsy}{m}{n}A\kern-.1667em\lower.5ex\hbox{M}\kern-.125emS}}% + {AMS}} +\DeclareRobustCommand*\KOMAScript{\texorpdfstring + {\textsf{K\kern.05em O\kern.05em M\kern.05em A\kern.1em-\kern.1em Script}}% + {KOMA-Script}} +\DeclareRobustCommand*\NTG{NTG} +\DeclareRobustCommand*\SmF{SMF} + +\usepackage{marvosym} +\makeatletter +\newcommand*\INFO{\@ifstar{\@INFO{}}{\@INFO{\vbox to \ht\strutbox}}} +\newcommand*\@INFO[1]{\MARGINSYM{#1{\hspace*{-1em}\LARGE\Info\hspace*{1em}}}} +\makeatother + +\newcommand*\MARGINSYM[1]{\hskip 1sp \marginpar{\raggedleft\textcolor{blue}{{#1}}}} +\newcommand*\NEW[2]{}%\hskip 1sp \marginpar{\footnotesize\sffamily\raggedleft#1\\#2}} + +% \ContinuedFloat +\DeclareCaptionLabelFormat{continued1e}{Continued #1~#2} +\DeclareCaptionLabelFormat{continued1r}{#1~#2 (\textit{продолжение})} +\DeclareCaptionLabelFormat{continued2}{#1~#2\asbuk{ContinuedFloat}} +% \DeclareCaptionLabelFormat +\DeclareCaptionLabelFormat{bf-parens}{(\textbf{#2})} +% \DeclareCaptionStyle +\DeclareCaptionStyle{mystyle}[margin=5mm,justification=centering]% + {font=footnotesize,labelfont=sc,margin={10mm,0mm}} +% Example 1 +\DeclareCaptionFormat{myformat1}{#1#2\\#3} +\newlength\myindention +\DeclareCaptionFormat{myformat2}{#1#2\\\hspace*\myindention#3} +\DeclareCaptionOption{myindention}{\setlength\myindention{#1}} +% Example 2 \DeclareCaptionFormat{reverse}{#3#2#1} -\DeclareCaptionFormat{llap}{\llap{#1#2}#3\par} -\DeclareCaptionLabelFormat{fullparens}{(\bothIfFirst{#1}{ }#2)} +\DeclareCaptionLabelFormat{fullparens}{(\bothIfFirst{#1}{~}#2)} \DeclareCaptionLabelSeparator{fill}{\hfill} -% -\DeclareRobustCommand{\KOMAScript}{\textsf{K\kern.05em O\kern.05em% - M\kern.05em A\kern.1em-\kern.1em Script}} -\clubpenalty10000 +% Example 3 +\DeclareCaptionFormat{llap}{\llap{#1#2}#3\par} +\DeclareCaptionFormat{llapx}{\llap{\makebox[5em][l]{#1}}#3\par} +% Example 4 +\DeclareCaptionLabelFormat{andtable}{#1~#2 \& \tablename~\thetable} + +\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 -\let\oriquote\quote -\def\quote{\allowprelistbreaks[-4]\oriquote} +\newcommand*\csmarg[1]{\texttt{\char`\{#1\char`\}}} +\newcommand*\csoarg[1]{\texttt{\char`\[#1\char`\]}} +\newcommand*\version[2][]{$v#2$} +\newcommand*\x{\discretionary{}{}{}} + +\newenvironment{Annotation}% + {\ifvmode\else\unskip\par\fi\pagebreak[2]% + \smallskip + \small(\ignorespaces}{\unskip)\par} +\newenvironment{Annotation*}% + {\ifvmode\else\unskip\par\fi\pagebreak[2]% + \small(\ignorespaces}{\unskip)\par} + +\newenvironment{Example}% + {\ifvmode\else\unskip\par\fi\pagebreak[2]% + \minipage{\linewidth}\smallskip}% + {\smallskip\endminipage\par} \makeatletter -\let\NoBreak\@nobreaktrue -\newcommand\NEW[2]{\hskip 1sp\@nobreaktrue - \marginpar - {\footnotesize\sffamily\raggedleft#1\\#2}} +\newcommand\example{\@ifstar + {\@example{belowskip=\abovecaptionskip}}% + {\@example{}}} +\def\@example#1{% + \@testopt{\@@example{#1}}{figure}} +\long\def\@@example#1[#2]#3#4{% + \begingroup + \captionsetup{#1,size=small,margin={\leftmargini,10pt},#3}% + \captionof{#2}[]{#4}% + \endgroup} \makeatother -\setcounter{IndexColumns}2 -\def\IndexParms{\raggedright\advance\rightskip1em} -% -%<+driver>\OnlyDescription -% + +\newenvironment{Expert}% + {\ifvmode\else\unskip\par\fi\pagebreak[3]% + \smallskip + \footnotesize\ignorespaces}{\par} +\newenvironment{Expert*}% + {\ifvmode\else\unskip\par\fi\pagebreak[3]% + \footnotesize\ignorespaces}{\par} + +\newenvironment{Note}[1][\DefaultNoteText]% + {\ifvmode\else\unskip\par\fi + \smallskip + \small\emph{#1}:~\ignorespaces}{\par} +\newenvironment{Note*}[1][\DefaultNoteText]% + {\ifvmode\else\unskip\par\fi + \small\emph{#1}:~\ignorespaces}{\par} + +\newenvironment{Options}[1]% + {\list{}{\renewcommand\makelabel[1]{\texttt{##1}\hfil}% + \settowidth\labelwidth{\texttt{#1\space}}% + \setlength\leftmargin{10pt}% + \addtolength\leftmargin{\labelwidth}% + \addtolength\leftmargin{\labelsep}}}% + {\endlist} + +\makeatletter +\newcommand*\Ref{\@ifstar{\@Ref\ref}{\@Ref\autoref}} +\newcommand*\@Ref[2]{#1{#2}: \textit{\nameref{#2}}} +\newcommand*\SEE[3][]{\nopagebreak{#1(#2 #3)}} +\newcommand*\SeeUserDefined[1][]{\See{\Ref{declare}#1}} +\makeatother + \begin{document} - \DocInput{caption-rus.tex} -\end{document} -% -% \fi -% -% -% -% \iffalse +\let\subsectionautorefname\sectionautorefname +\let\subsubsectionautorefname\sectionautorefname + +\def\thispackage{пакет \package{caption}} +\def\Thispackage{Пакет \package{caption}} + +\newcommand*\DefaultNoteText{Замечание} +% \newcommand\NEWfeature{\NEW{New feature}} +% \newcommand\NEWdescription{\NEW{New description}} +\newcommand\NEWfeature{\NEW{Новая возможность}} +\newcommand\NEWdescription{\NEW{Новое описание}} +\makeatletter +\newcommand*\See{\@ifstar{\SEE{См.}}{\SEE[\small]{См.}}} +\newcommand*\see{\@ifstar{\SEE{см.}}{\SEE[\small]{см.}}} + % --------------------------------------------------------------------------- % -% \fi -% \newcommand*\purerm[1]{{\upshape\mdseries\rmfamily #1}} -% \newcommand*\puresf[1]{{\upshape\mdseries\sffamily #1}} -% \newcommand*\purett[1]{{\upshape\mdseries\ttfamily #1}} -% \let\package\puresf\def\thispackage{\package{caption}} -% \let\env\purett \let\opt\purett -% -% \newcommand*\version[2][]{$v#2$} -% -% \newenvironment{Options}[1]% -% {\list{}{\renewcommand{\makelabel}[1]{\texttt{##1}\hfil}% -% \settowidth{\labelwidth}{\texttt{#1\space}}% -% \setlength{\leftmargin}{\labelwidth}% -% \addtolength{\leftmargin}{\labelsep}}}% -% {\endlist} -% -% \newenvironment{Example}% -% {\ifvmode\else\unskip\par\fi -% \minipage{\linewidth}\smallskip}% -% {\smallskip\endminipage} -% \newcommand\example[3][figure]{% -% \begingroup -% \captionsetup{#2}% -% \captionof{#1}[]{#3}% -% \endgroup} -% -% \GetFileInfo{caption.sty} -% \title{Печать подписей плавающих объектов (флотов) с~помощью пакета -% \thispackage\thanks{Данный пакет версии -% \fileversion, последний раз модифицирован \filedate. -%^^A% Translated by O. Lapko 2007/05/24. The questions and notes -%^^A% about translation please + +\GetFileInfo{caption-rus.tex} +\let\docdate\filedate +\GetFileInfo{caption.sty} + +% \title{Customizing captions of floating environments +% using the caption package\texorpdfstring{\thanks{% +% This package has version number \fileversion, +% last revised \filedate. +\title{Настройка подписей плавающих объектов (флотов) с~помощью пакета + \package{caption}\thanks{Данный пакет версии + \fileversion, последний раз модифицирован \filedate. +%^^A% Translattion of the version v3.1h, dated 2008/04/03. +%^^A% The questions and notes about translation please %^^A% send to \texttt{Lapko.O@g23.relcom.ru} (Olga Lapko). %^^A% The version of translation could be obsolete. Please %^^A% look English or German documentation for the new information %^^A% (see margin labels).}} -% Перевод О.\,Лапко, 2007/05/24. Вопросы и~замечания по переводу -% направляйте по адресу \texttt{Lapko.O@g23.relcom.ru}. -% \emph{Версия перевода относится к~одной из предыдущих версий пакета и~может -% содержать устаревшие данные. -% Обращайтесь к~английской или немецкой документации за более свежей информацией -% (см.~пометки на полях)}.}} -% \author{Аксель Зоммерфельдт (Axel Sommerfeldt)\\ -% \href{mailto:caption@sommerfee.de}{\texttt{caption@sommerfee.de}}} -% \date{2007/04/09} -% \maketitle -% -%^^A \begin{abstract} -%^^A The \thispackage\ package offers customization of captions -%^^A in floating environments such |figure| and |table| and cooperates with -%^^A many other packages.\footnote{A complete re-work of the user interface -%^^A done with Steven D. Cochran and Frank Mittelbach has lead to -%^^A this new enhanced version 3.0.} -%^^A \end{abstract} -% \begin{abstract} -% Пакет \thispackage\ предлагает множество путей настройки печати -% подписей для плавающих объектов (флотов) -% |figure| и~|table| и~совместим (кооперируется) -% со~многими пакетами.\footnote{Полная переработка пользовательского -% интерфейса сделана совместно со~Стивеном Кокрейном (Steven~D.~Cochran) -% и~Франком Миттельбахом (Frank Mittelbach) -% и~создана для новой расширенной версии~3.0.} -% \end{abstract} -% -% \begingroup\small + Перевод документации v3.1h, датированной 2008/04/03. + Вопросы и~замечания по переводу направляйте по адресу \texttt{Lapko.O@g23.relcom.ru}. + \emph{Версия перевода может относиться к~одной из предыдущих версий пакета и~может + содержать устаревшие данные. + Обращайтесь к~английской или немецкой документации за более свежей информацией + (обращайте внимание на пометки на полях). + }}{}} +% \author{Axel Sommerfeldt\\ +\author{Аксель Зоммерфельдт (Axel Sommerfeldt)\\ + \href{mailto:caption@sommerfee.de}{\texttt{caption@sommerfee.de}}} +\date{\docdate} +\maketitle + +% --------------------------------------------------------------------------- % + +\begin{abstract} +% \Thispackage\ offers customization of captions +% in floating environments such |figure| and |table| and cooperates with +% many other packages. +% \par\smallskip + \Thispackage\ предлагает настройки печати + подписей для плавающих объектов (флотов) + |figure| и~|table| и~совместим (кооперируется) + со~многими пакетами. +% \textit{Please note:} Many document classes already have build-in options and +% commands for customizing captions. +% If these possibilities are sufficient for you, there is usually no need for +% you to use the \package{caption} package at all. +% And if you are just interested in using the command \cs{captionof}, loading of +% the very small \package{capt-of} package is usually sufficient. +\par\smallskip +\textit{Обратите внимание}: множество классов документов уже имеют встроенные опции +и~команды для настройки подписей. +Если эти настройки вас удовлетворяют, то вовсе нет необходимости в~использовании пакета +\package{caption}. +Если вам нужна только команда \cs{captionof} \cdash--- загрузка небольшого пакета +\package{capt-of} будет достаточна. +\end{abstract} + +\newcommand\exampletext{% +% White sand beaches. The pink smoothness of the conch shell. A sea abundant +% with possibilities. Duty-free shops filled with Europe's finest gifts and +% perfumes. Play your favorite game of golf amidst the tropical greens on one +% of the many championship courses.} + Тибетская мандала представляет собой своеобразную карту особого храма + и~Шамбалы. Видны ворота по четырём сторонам света, постройка идёт + уступами вверх. (Мозаика пола рыцарского храма на о.\,Родос воспроизводит + узор мандалы.)} + +% --------------------------------------------------------------------------- % + +% \section*{Introduction} +\section*{Введение} + +% Within the standard \LaTeX\ document classes captions haven't received the +% attention they deserve. Simply typeset as an ordinary paragraph there is no +% remarkable visual difference from the rest of the text, like here: +Внутри стандартных классов \LaTeX'а~подписи не получили заслуженного +внимания. Они набираются как обычный абзац и~внешне не отличаются от основного +текста, как здесь: + +\example*{size=normalsize,margin=0pt}{\exampletext} + +% There should be possibilities to change this; for example, it would be nice +% to make the text of the caption a little bit smaller as the normal +% text, add an extra margin, typeset the caption label with the same font +% family and shape as your headings etc. Just like this one: +Должна быть возможность изменить это; например, текст лучше задать +меньшим кеглем, добавить втяжку (с~обеих сторон), +у~нумерационных заголовков подписей задать такие же +начертание или насыщенность, как у~заголовков разделов. Например, как следующую подпись: + +\example*{size=small,margin=10pt,labelfont=bf,labelsep=endash}{\exampletext} + +% You can do this easily with this package as there are many ready-to-use +% caption formatting options, but you are free to define your very own stuff, too. +С~данным пакетом это сделать просто, поскольку в~нём уже есть множество готовых +опций ключей настройки, и~вы свободны и~выбрать своё сочетание опций для +оформления, и~создать свои опции. + +\bigskip + +\INFO\begin{minipage}[t]{\textwidth} +\small +% Please note that \thispackage\ is only controlling the look \& feel of the +% captions. It does \emph{not} control the placement of the captions. +% (But you could do so by using other packages like the \package{floatrow} +% package\cite{floatrow}.) +Обратите внимание, что \thispackage\ контролирует только оформление +подписей. Он \emph{не} контролирует размещение подписей. +(Но это возможно, если использовать дополнительно другие пакеты, +например \package{floatrow}\cite{floatrow}.) +\end{minipage} + +\begingroup\small %^^A% \vspace{2ex}\centerline{\textbf{Frequently Appeared Design\footnote %^^A% {Added in translated text.}}\nopagebreak} -% \vspace{2ex}\centerline{\textbf{\TeX ническое редактирование\footnote -% {Добавлено при переводе.}}\nopagebreak} -% \begin{multicols}{2}\raggedright\advance\rightskip1em -% \makeatletter\let\item\@idxitem\ignorespaces\makeatother +\vspace{2ex}\centerline{\textbf{\TeX ническое редактирование\footnote + {Добавлено при переводе.}}\nopagebreak} +\begin{multicols}{2}\raggedright\advance\rightskip1em + \makeatletter\let\item\@idxitem\ignorespaces\makeatother %^^A% \item Last line of caption centered -% \item Выключка последней строки по центру -% \pageref{TeXr:centerlast} +\item Выключка последней строки по центру + \pageref{TeXr:centerlast} %^^A% \item Hanged caption label -% \item Нумерационный заголовок на весу -% \pageref{TeXr:hang:label} +\item Нумерационный заголовок на весу + \pageref{TeXr:hang:label} % -% %^^A \indexspace +%^^A \indexspace % %^^A% \item Spaces above and below captions -% \item Отбивки у~подписей над и~под флотами -% \pageref{TeXr:captionskips:a}%^^A--\pageref{TeXr:captionskips:z} +\item Отбивки у~подписей над и~под флотами + \pageref{TeXr:captionskips:a}%^^A--\pageref{TeXr:captionskips:z} %^^A% \item Settings, for caption label -% \item Оформление +\item Оформление %^^A% \subitem for caption label -% \subitem нумерационных заголовков -% \pageref{TeXr:caplabel:a}%^^A--\pageref{TeXr:caplabel:z} +\subitem нумерационных заголовков + \pageref{TeXr:caplabel:a}%^^A--\pageref{TeXr:caplabel:z} %^^A% \subitem for one-line captions -% \subitem однострочных подписей -% \pageref{TeXr:singleline:a}%^^A--\pageref{TeXr:singleline:z} +\subitem однострочных подписей + \pageref{TeXr:singleline:a}%^^A--\pageref{TeXr:singleline:z} %^^A% \subitem for multi-paragraph captions -% \subitem подписей из нескольких абзацев -% \pageref{TeXr:multipar:a}%^^A--\pageref{TeXr:multipar:z} +\subitem подписей из нескольких абзацев + \pageref{TeXr:multipar:a}%^^A--\pageref{TeXr:multipar:z} % -% %^^A \indexspace +%^^A \indexspace % %^^A% \item Captions -% \item Подписи\nopagebreak +\item Подписи\nopagebreak %^^A% \subitem for continued floats -% \subitem к~флотам с~продолжением -% \pageref{TeXr:continued:a}\nopagebreak %^^A--\pageref{TeXr:continued:z} +\subitem к~флотам с~продолжением + \pageref{TeXr:continued:a}\nopagebreak %^^A--\pageref{TeXr:continued:z} %^^A% \subitem above tables -% \subitem над таблицами -% \pageref{TeXr:captop:a}%^^A--\pageref{TeXr:captop:z} +\subitem над таблицами + \pageref{TeXr:captop:a}%^^A--\pageref{TeXr:captop:z} %^^A% \subitem skipped entry in list -% \subitem без записи в~списке рисунков, +\subitem без записи в~списке рисунков, %^^A% \subsubitem trick with empty option -% \subsubitem трюк с~дополнительным аргументом команды -% |\caption| \pageref{TeXr:nolistentry:I} + \subsubitem трюк с~дополнительным аргументом команды + |\caption| \pageref{TeXr:nolistentry:I} %^^A% \subsubitem key |listof=| -% \subsubitem ключ пакета |listof=| -% \pageref{TeXr:nolistentry:II} + \subsubitem ключ пакета |list=| + \pageref{TeXr:nolistentry:II} %^^A% \subitem unlabeled -% \subitem без нумерационного заголовка -% \pageref{TeXr:starcaption:a}%^^A--\pageref{TeXr:starcaption:z} +\subitem без нумерационного заголовка + \pageref{TeXr:starcaption:a}%^^A--\pageref{TeXr:starcaption:z} %^^A% \subitem outside float -% \subitem вне окружения флота -% \pageref{TeXr:captiononof:a}%^^A--\pageref{TeXr:captiononof:z} +\subitem вне окружения флота + \pageref{TeXr:captionof:a}%^^A--\pageref{TeXr:captiononof:z} % -% \end{multicols}% -% \endgroup -% \newpage +\end{multicols}% +\endgroup +\clearpage % -% \tableofcontents -%^^A \newcommand\figuretext{^^A -%^^A White sand beaches. The pink smoothness of the conch shell. A sea abundant -%^^A with possibilities. Duty-free shops filled with Europe's finest gifts and -%^^A perfumes. Play your favorite game of golf amidst the tropical greens on one -%^^A of the many championship courses.} -%^^A^^A Here is not translation! -% \newcommand\figuretext{^^A -% Тибетская мандала (1800\,г.) представляет собой своеобразную карту как -% особого храма, так и Шамбалы~(?). Хорошо видны ворота по четырём сторонам -% света, сама постройка идёт уступами вверх. (Мозаика пола рыцарского храма -% на о.~Родос точным образом воспроизводит узор тибетской мандалы.)} -% -% \iffalse % --------------------------------------------------------------------------- % -% \fi -% -%^^A \section{Introduction} -% \section{Введение} -% -%^^A Within the standard \LaTeX\ classes captions haven't received the attention -%^^A they deserve. Simply typeset as an ordinary paragraph there is no -%^^A remarkable visual difference from the rest of the text, like here: -% Внутри стандартных классов \LaTeX'а~подписи не получили заслуженного -% внимания. Они набираются как обычный абзац без всяких отличий от основного -% текста, как здесь: -% -% \example{belowskip=\abovecaptionskip}{\figuretext} -% -%^^A There should be possibilities to change this; for example, it would be nice -%^^A if you could make the text of the caption a little bit smaller as the normal -%^^A text, add an extra margin, typeset the caption label with the same font -%^^A family and shape as your headings etc. Just like this one: -% Должна быть возможность изменить это; например будет лучше, если текст -% задать меньшим кеглем, добавить втяжку (с~обеих сторон), набрать -% нумерационный заголовок подписи шрифтом основного текста, но задать -% начертание или насыщенность как у~заголовков и~т.\,д. Например, как следующую подпись: -% -% \example{belowskip=\abovecaptionskip,size=small,margin=10pt,labelfont=bf,labelsep=endash}{\figuretext} -% -%^^A You can do this easily with this package as there are many ready-to-use -%^^A caption formatting options, but you are free to define your very own stuff, too. -% С~данным пакетом это просто сделать, поскольку в~нём уже есть множество готовых -% опций ключей настройки, и~вы свободны и~выбрать своё сочетание опций для -% оформления, и~создать свои опции. -% -% \iffalse + +\clearpage +\tableofcontents + % --------------------------------------------------------------------------- % -% \fi -% -% -%^^A \section{Using the package} -% \section{Использование пакета} -% \label{usage} -% -% \DescribeMacro{\usepackage} -%^^A Insert -% Добавьте -% \begin{quote} -% |\usepackage|\oarg{options}|{caption}[|\texttt{\filedate}|]| -% \end{quote} -%^^A into the preamble of your document, i.e.~the part of your document -%^^A between |\documentclass| and |\begin{document}|. -%^^A The options control how your captions will look like; e.g., -% в~преамбулу вашего документа, т.\,е. в~часть файла между командами -% |\documentclass| и~|\begin{document}|. -% Опции задают настройки оформления подписей в~книге; например, опции -% \begin{quote} -% |\usepackage[margin=10pt,font=small,labelfont=bf]{caption}| -% \end{quote} -%^^A would result in captions looking like the second one in the introduction. -% зададут подписи, похожие на второй пример во введении. -% -% \DescribeMacro{\captionsetup} -%^^A For a later change of options the \thispackage\ package provides the command -% Для последующих изменений пакет \thispackage\ предлагает команду -% \begin{quote} -% |\captionsetup|\oarg{float type}\marg{options} -% \end{quote} -%^^A So -% Следовательно, определения -% \begin{quote} -% |\usepackage[margin=10pt,font=small,labelfont=bf]{caption}| -% \end{quote} -%^^A and -% и -% \begin{quote} -% |\usepackage{caption}|\\ -% |\captionsetup{margin=10pt,font=small,labelfont=bf}| -% \end{quote} -%^^A are equal in their results. -% эквивалентны. -% -%^^A It's good to know that |\captionsetup| has an effect on the current -%^^A environment only. So if you want to change some settings for the -%^^A current |figure| or |table| only, just place the |\captionsetup| command -%^^A inside the |figure| or |table| right before the |\caption| command. -%^^A For example -% Нужно обратить внимание, что установки |\captionsetup| могут действовать и~на одно -% окружение. Так что, если вы хотите изменить установки только -% текущего окружения |figure| или |table|, поместите команду |\captionsetup| -% внутри |figure| или |table| прямо перед командой |\caption|. -% Например -% \begin{quote} -% |\begin{figure}|\\ -% | |\ldots\\ -% | \captionsetup{singlelinecheck=off}|\\ -% | \caption{|\ldots|}|\\ -% |\end{figure}| -% \end{quote} -%^^A switches the single-line-check off, but only for this |figure| so all -%^^A the other captions remain untouched. -% отключает контроль однострочной подписи (см.~об этом ниже), но только для данного -% окружения |figure|, другие подписи не изменятся. -% -%^^A (For a description of the optional parameter \meta{float type} see -%^^A section \ref{misc}: \textit{``Useful stuff''}.) -% (Для описания дополнительного параметра \meta{float type} -% см.~разд.~\ref{misc}: \textit{«Полезные утилиты»}.) -% -% \iffalse + +\clearpage +% \section{Using this package} +\section{Использование пакета} +\label{usage} + +\DescribeMacro{\usepackage} +% Insert +Добавьте +\begin{quote} + |\usepackage|\oarg{options}|{caption}[|\texttt{\filedate}|]| +\end{quote} +% into the preamble of your document, i.e.~the part of your document +% between |\document|\-|class| and |\begin{doc|\-|u|\-|ment}|. +% The options control how your captions will look like; e.g., +в~преамбулу вашего документа, т.\,е. в~часть файла между командами +|\document|\-|class| и~|\begin{document}|. +Опции задают настройки оформления подписей в~книге; например, опции +\begin{quote} + |\usepackage[margin=10pt,font=small,labelfont=bf,|\\ + | labelsep=endash]{caption}|% + %|[|\texttt{\filedate}|]| +\end{quote} +% would result in captions looking like the second one in the introduction. +зададут подписи, похожие на второй пример во введении. + +\DescribeMacro{\captionsetup} +% For a later change of options \thispackage\ provides the command +Для последующих изменений \thispackage\ предлагает команду +\begin{quote} + |\captionsetup|\oarg{float type}\marg{options}\quad. +\end{quote} +% So +Следовательно, определения +\begin{quote} + |\usepackage[margin=10pt,font=small,labelfont=bf]{caption}| +\end{quote} +% and +и +\begin{quote} + |\usepackage{caption}|\\ + |\captionsetup{margin=10pt,font=small,labelfont=bf}| +\end{quote} +% are equal in their results. +эквивалентны. + +% It's good to know that |\caption|\-|setup| has an effect on the current +% environment only. So if you want to change settings for the +% current |figure| or |table| only, just place the |\caption|\-|setup| command +% inside the |figure| or |table| right before the |\caption| command. +% For example +Нужно обратить внимание, что установки |\captionsetup| могут действовать и~на одно +окружение. Так что, если вы хотите изменить установки только +одного окружения |figure| или |table|, поместите команду |\captionsetup| +внутри |figure| или |table| прямо перед командой |\caption|. +Например +\begin{quote} + |\begin{figure}|\\ + | |\ldots\\ + | \captionsetup{singlelinecheck=off}|\\ + | \caption{|\ldots|}|\\ + |\end{figure}| +\end{quote} +% switches the single-line-check off, but only for this |figure|, +% so all the other captions remain untouched. +отключает контроль однострочной подписи (см.~об этом ниже), но только для этого +окружения |figure|, другие подписи не изменятся. + +\smallskip + +\begin{Annotation} +% For a detailed description of |\caption|\-|setup| see \Ref{captionsetup}. +Подробное описание команды |\captionsetup| см.~в~\Ref{captionsetup}. +\end{Annotation} + % --------------------------------------------------------------------------- % -% \fi -% -% -%^^A \section{Options} -% \section{Опции} -% -% \def\OptionLabel{RaggedRight} -% \def\UserDefined{\ldots} -% \makeatletter -% \newcommand*\Section{\@ifstar{\@Section\relax}{\@Section{разд.}}} -% \newcommand*\@Section[3]{#1 \ref{#2}: \textit{«#3»}} -% \makeatother -% \newcommand*\See[1]{{\small (См.~#1)}} -% \newcommand*\SeeUserDefined[1][]{% -% \See{\Section{declare}{Делаем сами}#1}} -% -% \iffalse + +\clearpage +% \section{Options} +\section{Опции} +\label{options} + +\def\OptionLabel{RaggedRight} +\def\UserDefined{\ldots} + % --------------------------------------------------------------------------- % -% \fi -% -%^^A \subsection{Formatting} -% \subsection{Оформление} -% -% \DescribeMacro{format=} -%^^A A figure or table caption mainly consists of three parts: the caption label, -%^^A which says if this object is a `Figure' or `Table' and what number is -%^^A associated with it, the caption text itself, which is normally a short -%^^A description of contents, and the caption separator which separates the text -%^^A from the label. -% Подпись рисунка или таблицы обычно имеет три части\nopagebreak: нумерационный -% заголовок, который объявляет, что этот объект `Рис'унок или `Таблица' и~какой -% номер он имеет, собственно текст подписи, который обычно даёт краткое описание -% содержания, и~разделитель между нумерационной частью подписи и~текстом. -% -%^^A The \textit{caption format} determines how this information will be presented; -%^^A it is specified with the option -% \textit{Формат подписи} определяет, как данная информация будет представлена; -% это определяется ключом -% \begin{quote} -% |format=|\meta{format name}\quad , -% \end{quote} -%^^A having the name of the caption format as its argument. -% с~опцией, определяющей оформление (формат) подписи. -% -%^^A There are two standard caption formats: -% Далее два стандартных оформления подписи: -% \iffalse -%^^A \footnote{You have the option to -%^^A define your own ones, too. See section \ref{declare}: -%^^A \textit{``Do it yourself!''} for details.} -% \footnote{Вы можете задавать опции -% для создания своего оформления. См. подробнее в~разд.~\ref{declare}: -% \textit{«Делаем сами!»}.} -% \fi -% -% \begin{Options}{\OptionLabel} -% \item[plain]\NEWdescription{v3.0h} -%^^A Typesets the captions as a normal paragraph. -%^^A (This is the default behaviour, it -%^^A is adapted from the standard \LaTeX\ document classes.) -% Печатает подписи как обычный абзац. -% (Это оформление задано по умолчанию, -% и~аналогично стандартному оформлению классов \LaTeX'а.) -% -% \item[hang] -%^^A Indents the caption text, so it will `hang' under the first line of the text. -% Делает втяжку так, что первая строка (нумерационный заголовок) выступает влево.%^^A -% \label{TeXr:hang:label} -% -% \item[\UserDefined] -%^^A Own formats can be defined using |\DeclareCaptionFormat|. -% Собственное оформление может быть определено, с~помощью команды -% |\DeclareCaptionFormat|. \SeeUserDefined -% \end{Options} -% -% \begin{Example} -%^^A An example: Specifying the option -% Пример: задание опции -% \begin{quote} -% |format=hang| -% \end{quote} -%^^A yields captions like this: -% создаёт подписи как эта: -% \example{format=hang}{\figuretext} -% \end{Example} -% -% \DescribeMacro{indention=} -%^^A For both formats (\texttt{plain} and \texttt{hang}) you can setup an extra -%^^A indention starting at the second line of the caption. You do this with the -%^^A option -% Для обоих оформлений (\texttt{plain} и~\texttt{hang}) можно установить -% дополнительную втяжку второй строки подписи. Это можно сделать с~ключом -% \begin{quote} -% |indention=|\meta{amount}. -% \end{quote} + +% \subsection{Formatting} +\subsection{Оформление} +\label{formats} + +\DescribeMacro{format=} +% A figure or table caption mainly consists of three parts: the caption label, +% which says if this object is a `Figure' or `Table' and what number is +% associated with it, the caption text itself, which is normally a short +% description of contents, and the caption separator which separates the text +% from the label. +Подпись рисунка или таблицы обычно имеет три части\nopagebreak: нумерационный +заголовок, который объявляет, что этот объект называется `Рис'унок или `Таблица' и~имеет +свой номер; собственно текст, который обычно даёт краткое описание +содержания; разделитель между нумерационным заголовком и~текстом. + +% The \textit{caption format} determines how this information will be presented; +% it is specified with the option +\textit{Формат подписи} определяет, как данная информация будет представлена; +это задаётся ключом +\begin{quote} + |format=|\meta{format name}\quad +\end{quote} +% having the name of the caption format as its argument. +с~опцией, определяющей оформление (формат) подписи. + +% There are two standard caption formats: +Далее два стандартных оформления подписи: +%\footnote{You have the option to +%define your own ones, too. See section \ref{declare}: +%\textit{``Do it yourself!''} for details.} + +\begin{Options}{\OptionLabel} + \item[plain]%\NEWdescription{v3.0h} +% Typesets the captions as a normal paragraph. + Печатает подписи как обычный абзац. + + \item[hang] +% Indents the caption text, so it will `hang' under the first line of the text. + Делает втяжку так, что первая строка [нумерационный заголовок] выступает влево.% + \label{TeXr:hang:label} + + \item[\UserDefined] +% Own formats can be defined using |\Declare|\-|Caption|\-|Format|.\LineBreak +% \SeeUserDefined + Собственное оформление может быть определено, с~помощью команды + |\Declare|\-|Caption|\-|Format|. \SeeUserDefined +\end{Options} + +\begin{Example} +% An example: Specifying the option + Пример: задание опции + \begin{quote} + |format=hang| + \end{quote} +% yields captions like this: + создаёт подписи как эта: + \example{format=hang}{\exampletext} +\end{Example} + +\pagebreak[3] +\DescribeMacro{indention=} +% For both formats (\texttt{plain} and \texttt{hang}) you can setup an extra +% indention starting at the second line of the caption. You do this with the +% option +Для обоих оформлений (\texttt{plain} и~\texttt{hang}) можно установить +дополнительную втяжку вторых строк подписи. Это можно сделать с~ключом +\begin{quote} + |indention=|\meta{amount}\quad. +\end{quote} %^^A% [Please note, that indention of the keys \verb|format=hang| and %^^A% |indention=|\meta{amount} are summarized.---\emph{Trans.}] -% [Обратите внимание, что втяжка из ключей \verb|format=hang| и~|indention=|\meta{amount} -% суммируются. \cdash--- \emph{Прим.\,перев.}] -% -%^^A Two examples: -% Пара примеров: -% -% \begin{Example} -% \begin{quote} -% |format=plain,indention=.5cm| -% \end{quote} -% \captionsetup{aboveskip=0pt} -% \example{format=plain,indention=.5cm}{\figuretext} -% \end{Example} -% -% \begin{Example} -% \begin{quote} -% |format=hang,indention=-0.5cm| -% \end{quote} -% \captionsetup{aboveskip=0pt} -% \example{format=hang,indention=-0.5cm}{\figuretext} -% \end{Example} -% -% -% \DescribeMacro{labelformat=} -%^^A With the option -% С~ключом\label{TeXr:caplabel:a} -% \nopagebreak[3] -% \begin{quote} -% |labelformat=|\meta{label format name} -% \end{quote} -% \NEWdescription{v3.0e} -%^^A you specify how the caption label will be typeset. -%^^A There are four standard caption label formats: -% вы задаёте, как печатается нумерационная часть. -% Существуют четыре стандартных оформления нумерационного заголовка: -% -% \begin{Options}{\OptionLabel} -% \item[default] -%^^A the caption label will be typeset as specified by the document class, -%^^A usually this means the name and the number (like \texttt{simple}). -%^^A (this is the default behaviour.) -% нумерационный заголовок печатается так же как в~стандартных классах, -% это обычно название флота и~номер (как \texttt{simple}). -% (Задаётся по умолчанию.) -% -% \item[empty] -%^^A The caption label will be empty. (This option makes sense when used -%^^A together with other options like \texttt{labelsep=none}.) -% Нумерационный заголовок отсутствует. (Эта опция имеет смысл вместе -% с~опциями типа \texttt{labelsep=none}.) -% -% \item[simple] -%^^A The caption label will be typeset as a name and a number. -% Нумерационный заголовок печатается как название флота и~его номер. -% -% \item[parens] -%^^A The number of the caption label will be typeset in parentheses. -% Номер в~нумерационной части заголовка печатается в~скобках. -% -% \item[\UserDefined] -%^^A Own label formats can be defined using |\DeclareCaptionLabelFormat|. -% Собственное оформление может быть определено с~помощью -% команды |\DeclareCaptionLabelFormat|. +[Обратите внимание, что втяжка из ключей \verb|format=hang| и~|indention=|\meta{amount} +суммируются. \cdash--- \emph{Прим.\,перев.}] + +% Two examples: +Пара примеров: + +\begin{Example} + \begin{quote} + |format=plain,indention=.5cm| + \end{quote} + \captionsetup{skip=0pt} + \example{format=plain,indention=.5cm}{\exampletext} +\end{Example} + +\begin{Example} + \begin{quote} + |format=hang,indention=-0.5cm| + \end{quote} + \captionsetup{skip=0pt} + \example{format=hang,indention=-0.5cm}{\exampletext} +\end{Example} + +\bigskip + +\pagebreak[3] +\DescribeMacro{labelformat=} +% With the option +С~ключом\label{TeXr:caplabel:a}% +\nopagebreak[3] +\begin{quote} + |labelformat=|\meta{label format name} +\end{quote} +\nopagebreak[3] +%\NEWdescription{v3.0e} +% you specify how the caption label will be typeset. +% There are five standard caption label formats: +вы задаёте, как печатается нумерационная часть. +Существуют четыре стандартных оформления нумерационного заголовка: + +\begin{Options}{\OptionLabel} + \item[default] +% The caption label will be typeset as specified by the document class, +% usually this means the name and the number (like \texttt{simple}). +% (This is the default behaviour.) + нумерационный заголовок печатается так же как в~стандартных классах, + это обычно название флота и~номер (как \texttt{simple}). + (Задаётся по умолчанию.) + + \item[empty] +% The caption label will be empty. + Нумерационный заголовок отсутствует. +\iffalse +% (This option makes sense when used together with other options like +% \texttt{labelsep=none}.) + (Эта опция имеет смысл вместе с~опциями типа \texttt{labelsep=none}.) +\fi + + \item[simple] +% The caption label will be typeset as a name and a number. + Нумерационный заголовок печатается как название флота и~его номер. + + \item[brace]\NEWfeature{v3.1f} +% The caption label will be closed with a single (right) brace. + Нумерационный заголовок (номер подфлота) отделён справа круглой скобкой. + + \item[parens] +% The number of the caption label will be typeset in parentheses. + Номер в~нумерационной части заголовка печатается в~скобках. + + \item[\UserDefined] +% Own label formats can be defined using |\Declare|\-|Caption|\-|Label|\-|Format|. % \SeeUserDefined -% \end{Options} -% -% \begin{Example} -%^^A An example: Using the options -% Пример: с~опциями ключей -% \begin{quote} -% |labelformat=parens,labelsep=quad| -% \end{quote} -%^^A gives captions like this one: -% создаётся такая подпись: -% \example{labelformat=parens,labelsep=quad}{\figuretext} -% \end{Example} -% -% \DescribeMacro{labelsep=} -%^^A With the option -% С~ключом -% \begin{quote} -% |labelsep=|\meta{label separator name} -% \end{quote} -%^^A you specify what caption separator will be used. -%^^A You can choose one of the following: -% вы определяете какой разделитель [между нумерационным заголовком и~текстом] -% будет использоваться. -% Вы можете задать следующие опции: -% -% \begin{Options}{\OptionLabel} -% \item[none] -%^^A There is no caption separator. (This option makes sense when used -%^^A together with other options like \texttt{labelformat=empty}.) -% Отсутствует разделитель нумерационной части и~текста подписи. (Применение этой опции -% имеет смысл вместе с~опциями типа \texttt{labelformat=empty}.) -% -% \item[colon] -%^^A The caption label and text will be separated by a colon and a space. -%^^A (This is the default one.) -% Нумерационный заголовок и~текст разделены двоеточием и~пробелом. -% (Задаётся по умолчанию.) -% -% \item[period] -%^^A The caption label and text will be separated by a period and a space. -% Нумерационная часть и~текст разделены точкой и~пробелом. -% -% \item[space] -%^^A The caption label and text will be separated by a single space. -% Нумерационная часть и~текст разделяется пробелом. -% -% \item[quad] -%^^A The caption label and text will be separated by a |\quad|. -% Нумерационная часть и~текст разделяется кегельной (|\quad|). -% -% \item[newline] -%^^A The caption label and text will be separated by a line break (|\\|). -% Нумерационный заголовок и~текст разделены новой строкой~(|\\|). -% -% -% \item[endash]\NEWfeature{v3.0h} -%^^A The caption label and text will be separated by an en-dash, -%^^A surrounded by spaces (| -- |). -% Нумерационный заголовок и~текст разделяется кратким тире, -% окружённым пробелами (| -- |). -% -% \item[\UserDefined] -%^^A Own separators can be defined using |\DeclareCaptionLabelSeparator|. -% Собственные разделители можно определить, используя команду -% |\DeclareCaptionLabelSeparator|. + Собственное оформление может быть определено с~помощью + команды |\Declare|\-|Caption|\-|Label|\-|Format|. +\end{Options} + +\begin{Example} +% An example: Using the options + Пример: с~опциями ключей + \begin{quote} + |format=plain,labelformat=parens,labelsep=quad,|\\ + | figurename=\CYRR\cyri\cyrs\cyru\cyrn\cyro\cyrk| + \end{quote} +% gives captions like this one: + создаётся такая подпись: + \example{format=plain,labelformat=parens,labelsep=quad, + figurename=\CYRR\cyri\cyrs\cyru\cyrn\cyro\cyrk}{\exampletext} +\end{Example} +[Название в~нумерационном заголовке для данного примера изменено с~помощью +опции |figurename|. \See{\Ref{names}}] + +\medskip + +\begin{Note*} +% Some environments, e.g.~the |algorithm| environment offered by the +% \package{algorithm2e} package, might react allergic to a change of the +% caption label format. +У~некоторых окружений, например у~окружения |algorithm|, предлагаемого +пакетом \package{algorithm2e}, изменение формата нумерационного заголовка +может вызвать аллергию. +\end{Note*} + +\bigskip + +\pagebreak[3] +\DescribeMacro{labelsep=} +% With the option +С~ключом +\begin{quote} + |labelsep=|\meta{label separator name} +\end{quote} +% you specify what caption separator will be used.\footnote{% +% If the caption label or the caption text is empty, +% no separator will be used.} +% You can choose one of the following: +вы определяете какой разделитель [между нумерационным заголовком и~текстом] +будет использоваться\footnote{% + Если нумерационный заголовок или текст подписи пустые, + разделитель не используется.}. +Вы можете задать следующие опции: + +\begin{Options}{newline} + \item[none] +% There is no caption separator. + Отсутствует разделитель нумерационной части и~текста подписи. +\iffalse +% (This option makes sense when used together with other options like +% \texttt{labelformat=empty}.) + (Применение этой опции + имеет смысл вместе с~опциями типа \texttt{labelformat=empty}.) +\fi + + \item[colon] +% The caption label and text will be separated by a colon and a space. + Нумерационный заголовок и~текст разделены двоеточием и~пробелом. + + \item[period] +% The caption label and text will be separated by a period and a space. + Нумерационный заголовок и~текст разделены точкой и~пробелом. + + \item[space] +% The caption label and text will be separated by a single space. + Нумерационный заголовок и~текст разделены пробелом. + + \item[quad] +% The caption label and text will be separated by a |\quad|. + Нумерационный заголовок и~текст разделены кегельной (|\quad|). + + \item[newline] +% The caption label and text will be separated by a line break (|\\|). +% Please note that this separator does not work with all caption +% formats (e.g.~|format=|\x|hang|), and you'll get an error message +% trying such combination of options. + Нумерационный заголовок и~текст разделены новой строкой~(|\\|). + Обратите внимание, что этот разделитель не работает с~некоторыми + форматами (например, |format=|\x|hang|), и~вы получите сообщение + об ошибке при попытке использовать эту комбинацию. + + \item[endash]\NEWfeature{v3.0h} +% The caption label and text will be separated by an en-dash, +% surrounded by spaces (\verb*| -- |). + Нумерационный заголовок и~текст разделяется кратким тире, + окружённым пробелами (\verb*| -- |). + + \item[\UserDefined] +% Own separators can be defined using |\Declare|\-|Caption|\-|Label|\-|Sep|\-|a|\-|ra|\-|tor|. % \SeeUserDefined -% \end{Options} -% -%^^A Three examples: -% Три примера: -% \begin{Example} -% \begin{quote} -% |labelsep=period| -% \end{quote} -% \captionsetup{aboveskip=0pt} -% \example{labelsep=period}{\figuretext} -% \end{Example} -% -% \begin{Example} -% \begin{quote} -% |labelsep=newline,singlelinecheck=false| -% \end{quote} -% \captionsetup{aboveskip=0pt} -% \example{labelsep=newline,singlelinecheck=false}{\figuretext} -% \end{Example} -% -% \begin{Example} -% \begin{quote} -% |labelsep=endash| -% \end{quote} -% \captionsetup{aboveskip=0pt} -% \example{labelsep=endash}{\figuretext}%^^A -% \label{TeXr:caplabel:z} -% \end{Example} -% -% \iffalse + Собственные разделители можно определить, используя команду + |\Declare|\-|Caption|\-|Label|\-|Sep|\-|a|\-|ra|\-|tor|. + \SeeUserDefined +\end{Options} + +% Three examples: +Три примера: +\begin{Example} + \begin{quote} + |format=plain,labelsep=period| + \end{quote} + \captionsetup{skip=0pt} + \example{format=plain,labelsep=period}{\exampletext} +\end{Example} + +\begin{Example} + \begin{quote} + |format=plain,labelsep=newline,singlelinecheck=false| + \end{quote} + \captionsetup{skip=0pt} + \example{format=plain,labelsep=newline,singlelinecheck=false}{\exampletext} +\end{Example} + +\begin{Example} + \begin{quote} + |format=plain,labelsep=endash| + \end{quote} + \captionsetup{skip=0pt} + \example{format=plain,labelsep=endash}{\exampletext} +\end{Example} + +\bigskip + +\pagebreak[3] +\DescribeMacro{textformat=}\NEWfeature{v3.0l}% +% With the option +С~опцией +\nopagebreak[3] +\begin{quote} + |textformat=|\meta{text format name} +\end{quote} +\nopagebreak[3] +% you specify how the caption text will be typeset. +% There are two standard caption text formats: +вы определяете как текст подписи будет напечатан. +Существует два стандартных формата подписи: + +\begin{Options}{\OptionLabel} + \item[simple] +% The caption text will be typeset as it is. + Текст подписи будет напечатан как есть. + + \item[period] +% The caption text will be followed by a period. + В~конце подписи ставится точка. + + \item[\UserDefined] +% Own label formats can be defined using |\Declare|\-|Caption|\-|Text|\-|Format|. +% \SeeUserDefined + Собственные форматы текста могут быть определены с~использованием команды |\Declare|\-|Caption|\-|Text|\-|Format|. + \SeeUserDefined +\end{Options} + % --------------------------------------------------------------------------- % -% \fi -% -%^^A \subsection{Justification} -% \subsection{Выключка} -% \label{justification} -% -% \DescribeMacro{justification=} -%^^A As addition to the caption format you could also specify a -%^^A \emph{caption justification}; it is specified with the option -% При оформлении подписи вы можете определить -% \emph{выключку подписи}; она задаётся ключом -% \begin{quote} -% |justification=|\meta{justification name}\quad. -% \end{quote} -% -%^^A You can choose one of the following: -% Вы можете выбрать следующие опции: -% -% \begin{Options}{\OptionLabel} -% \item[justified] -%^^A Typesets the caption as a normal paragraph. (This is the default.) -% Печатает подпись в~виде обычного абзаца. (По умолчанию.) -% -% \item[centering] -%^^A Each line of the caption will be centered. -% Все строки выключены по центру. -% -% \iffalse -% \item[Centering] -%^^A Each line of the caption will be centered, too. -%^^A But this time the command |\Centering| of the \package{ragged2e} package -%^^A will be used to achieve this. This difference is that this time the word -%^^A breaking algorithm of \TeX\ will work inside the caption. -% Каждая строка также выключена по центру. -% Но в~данном случае используется команда |\Centering| из пакета \package{ragged2e}. -% Это означает что включается алгоритм разрыва [слов] на строки Plain \TeX'а. -% \fi -% -% \item[centerlast] -%^^A The last line of each paragraph of the caption text will be centered. -% Абзац набирается на полный формат, последняя строка выключена по центру. -% -% \item[centerfirst] -%^^A Only the first line of the caption will be centered. -% Центрируется только первая строка [остальные, в~том числе и~концевая, -% выключаются на полный формат]. -% -% \item[raggedright] -%^^A Each line of the caption will be moved to the left margin. -% Строки подписи выключены влево. -% -% \iffalse -% \item[RaggedRight] -%^^A Each line of the caption will be moved to the left margin using -%^^A the command |\RaggedRight| from the \package{ragged2e} package. -% Строки подписи выключены влево с~использованием команды + +\PageBreak +% \subsection{Justification} +\subsection{Выключка} +\label{justification} + +\DescribeMacro{justification=} +% As addition to the caption format you could also specify a +% \emph{caption justification}; it is specified with the option +При оформлении подписи вы можете определить +\emph{выключку подписи}; она задаётся ключом +\begin{quote} + |justification=|\meta{justification name}\quad. +\end{quote} + +% You can choose one of the following: +Вы можете выбрать следующие опции: + +\begin{Options}{\OptionLabel} + \item[justified] +% Typesets the caption as a normal paragraph. + Печатает подпись в~виде обычного абзаца. (По умолчанию.) + + \item[centering] +% Each line of the caption will be centered. + Все строки выключены по центру. + +% \item[Centering] + + \item[centerlast] +% The last line of each paragraph of the caption text will be centered. + Абзац набирается на полный формат, последняя строка выключена по центру. + + \item[centerfirst] +% Only the first line of the caption will be centered. + Центрируется только первая строка [остальные, в~том числе и~концевая, + выключаются на полный формат]. + + \item[raggedright] +% Each line of the caption will be moved to the left margin. + Строки подписи выключены влево. + +\iffalse + \item[RaggedRight] +% Each line of the caption will be moved to the left margin using +% the command |\RaggedRight| from the \package{ragged2e} package. + Строки подписи выключены влево с~использованием команды + |\RaggedRight| из пакета \package{ragged2e}. +\else + \item[RaggedRight] +% Each line of the caption will be moved to the left margin, too. +% But this time the command |\RaggedRight| of the \package{ragged2e} +% package will be used to achieve this. +% The main difference to |raggedright| is that the word breaking +% algorithm of \TeX\ will work inside captions.\footnote{% +% The need for the \package{ragged2e} package will be detected at +% run-time, therefore you maybe need a second \LaTeX\ run if this +% option is used for the first time.} + Строки подписи также выключены влево. + Но в~данном случае используется команда |\RaggedRight| пакета + \package{ragged2e}. Основное отличие от опции |raggedright| + заключается в~использовании алгоритма Plain \TeX'а для разрыва + слов внутри подписи.\footnote{ + Необходимость в~этом пакете определяется «на лету», + поэтому при использовании этой опции документ нужно дважды обработать \LaTeX'ом.}. +\fi + + \item[raggedleft] +% Each line of the caption will be moved to the right margin. + Строки подписи выключены вправо. + +% \item[RaggedLeft] +% % Each line of the caption will be moved to the right margin using +% % the command |\RaggedLeft| from the \package{ragged2e} package. +% Строки подписи выключены вправо с~использованием команды % |\RaggedRight| из пакета \package{ragged2e}. -% \fi -% \item[RaggedRight] -%^^A Each line of the caption will be moved to the left margin, too. -%^^A But this time the command |\RaggedRight| of the \package{ragged2e} package -%^^A will be used to achieve this. The main difference is that the word -%^^A breaking algorithm of \TeX\ will work inside captions. -% Строки подписи также выключены влево, -% но в~данном случае используется |\RaggedRight| пакета \package{ragged2e}. -% Отличие состоит в~том, что используется -% алгоритм разрыва [слов] на строки Plain \TeX'а. -% -% \item[raggedleft] -%^^A Each line of the caption will be moved to the right margin. -% Строки подписи выключены вправо. -% -% \iffalse -% \item[RaggedLeft] -%^^A Each line of the caption will be moved to the right margin using -%^^A the command |\RaggedLeft| from the \package{ragged2e} package. -% Строки подписи выключены вправо с~использованием команды -% |\RaggedRight| из пакета \package{ragged2e}. -% \fi -% -% \item[\UserDefined] -%^^A Own justifications can be defined using |\DeclareCaptionJustification|. -% Собственные определения выключки можно задать с~помощью команды -% |\DeclareCaptionJustification|. + +%\showhyphens{justification} + \item[\UserDefined] +% Own justifications can be defined using +% |\Declare|\-|Caption|\-|Jus|\-|ti|\-|fi|\-|ca|\-|tion|. % \SeeUserDefined -% \end{Options} -% -%^^A Three examples: -% Три примера:\label{TeXr:centerlast} -% \begin{Example} -% \begin{quote} -% |justification=centerlast| -% \end{quote} -% \captionsetup{aboveskip=0pt} -% \example{justification=centerlast}{\figuretext} -% \end{Example} -% -% \begin{Example} -% \begin{quote} -% |format=hang,justification=raggedright| -% \end{quote} -% \captionsetup{aboveskip=0pt} -% \example{format=hang,justification=raggedright}{\figuretext} -% \end{Example} -% -% \begin{Example} -% \begin{quote} -% |labelsep=newline,justification=centering| -% \end{quote} -% \captionsetup{aboveskip=0pt} -% \example{belowskip=\abovecaptionskip,labelsep=newline,justification=centering}{\figuretext} -% \end{Example} -% -% \DescribeMacro{singlelinecheck=}\label{TeXr:singleline:a} -%^^A The standard \LaTeX\ document classes (|article|, |report|, and |book|) -%^^A automatically center a caption if it fits in one single line: -% Стандартные классы \LaTeX'а (|article|, |report|, и~|book|) -% автоматически центрируют подпись если она однострочная: -% -% \example{belowskip=\abovecaptionskip}{Коротенькая подпись.} -% -% \DANGER -%^^A The \thispackage\ package adapts this behaviour and therefore usually -%^^A ignores the justification you have set with |justification=| in such case. -%^^A But you can switch this special treatment of such short captions off -%^^A with the option -% Пакет \thispackage\ следует за этим алгоритмом и~поэтому -% в~таких случаях игнорирует выключку, заданную ключом |justification=|. -% Определить, следовать этому алгоритму или нет можно, -% задав ключ -% \begin{quote} -% |singlelinecheck=|\meta{bool}\quad. -% \end{quote} -%^^A Using |false|, |no|, |off| or |0| for \meta{bool} switches the -%^^A extra centering off: -% Используя |false|, |no|, |off| или |0| вместо \meta{bool} вы отключите -% центрирование однострочной подписи: -% \begin{quote} -% |singlelinecheck=false| -% \end{quote} -%^^A Doing so the above short caption would look like -% После этого определения короткие подписи -% [при задании выключки по умолчанию в~виде обычного абзаца] -% будут выглядеть так -% -% \begingroup -% \captionsetup{type=figure} -% \ContinuedFloat -% \endgroup -% \example{belowskip=\abovecaptionskip,singlelinecheck=false}{Коротенькая подпись.} -% -%^^A You switch the extra centering on again by using |true|, |yes|, |on| or |1| -%^^A for \meta{bool}. (The default is on.) -% Используя |true|, |yes|, |on| или |1| вместо \meta{bool} вы включите механизм -% центрирования коротких подписей. (Задано по умолчанию.)%^^A -% \label{TeXr:singleline:z} -% -% \iffalse + Собственные определения выключки можно задать с~помощью команды + |\Declare|\-|Caption|\-|Jus|\-|ti|\-|fi|\-|ca|\-|tion|. + \SeeUserDefined +\end{Options} + +% Three examples: +Три примера:\label{TeXr:centerlast}% +\begin{Example} + \begin{quote} + |format=plain,justification=centerlast| + \end{quote} + \captionsetup{skip=0pt} + \example{format=plain,justification=centerlast}{\exampletext} +\end{Example} + +\begin{Example} + \begin{quote} + |format=hang,justification=raggedright| + \end{quote} + \captionsetup{skip=0pt} + \example{format=hang,justification=raggedright}{\exampletext} +\end{Example} + +\begin{Example} + \begin{quote} + |format=plain,labelsep=newline,justification=centering| + \end{quote} + \captionsetup{skip=0pt} + \example*{format=plain,labelsep=newline,justification=centering}{\exampletext} +\end{Example} + +\smallskip + +\PageBreak +\DescribeMacro{singlelinecheck=}\label{TeXr:singleline:a}% +% The standard \LaTeX\ document classes (\class{article}, \class{report}, and +% \class{book}) automatically center a caption if it fits in one single line: +Стандартные классы \LaTeX'а (\class{article}, \class{report}, и~\class{book}) +автоматически центрируют подпись если она однострочная: + +\example*{}{A short caption.} + +\INFO +% \Thispackage\ adapts this behavior and therefore usually ignores the +% justification \& indention you have set with |justification=| \& +% |indention=| in such case. +% But you can switch this special treatment of such short captions off +% with the option +\Thispackage\ следует за этим алгоритмом и~поэтому +в~таких случаях игнорирует выключку, заданную ключами |justification=| и~|indention=|. +Определить, следовать этому алгоритму или нет можно, +задав ключ +\begin{quote} + |singlelinecheck=|\meta{bool}\quad. +\end{quote} +% Using |false|, |no|, |off| or |0| for \meta{bool} switches the +% extra centering off: +Используя |false|, |no|, |off| или |0| вместо \meta{bool} вы отключите +центрирование однострочной подписи: +\begin{quote} + |singlelinecheck=false| +\end{quote} +% Doing so the above short caption would look like +После этого определения короткие подписи +[при задании выключки по умолчанию, в~виде обычного абзаца] +будут выглядеть так + +\begingroup + \captionsetup{type=figure} + \ContinuedFloat + \example*{singlelinecheck=false}{A short caption.} +\endgroup + +% You switch the extra centering on again by using |true|, |yes|, |on| or |1| +% for \meta{bool}. (The default is on.) +Используя |true|, |yes|, |on| или |1| вместо \meta{bool} вы включите механизм +центрирования коротких подписей. (Задано по умолчанию.)%^^A +\label{TeXr:singleline:z} + % --------------------------------------------------------------------------- % -% \fi -% -%^^A \subsection{Fonts} -% \subsection{Шрифты} -% \label{fonts} -% -% \DescribeMacro{font=} -% \DescribeMacro{labelfont=} -% \DescribeMacro{textfont=} -%^^A There are three font options which affects different parts of the caption: -%^^A One affecting the whole caption (|font|), one which only affects the caption -%^^A label and separator (|labelfont|) and at least one which only affects the -%^^A caption text (|textfont|). -%^^A You set them up using the options -% Заданы три ключа которые определяют шрифт разных элементов подписи: -% Один задаёт шрифт для всей подписи (|font|), другой задаёт шрифт только -% для нумерационного заголовка и~разделителя (|labelfont|), и~ещё один -% \cdash--- шрифт для текста (|testfont|). -% Вы задаёте их, используя ключи -% \begin{quote}\begin{tabular}{@{}r@{}ll} -% |font=| & \marg{font options} & ,\\ -% |labelfont=| & \marg{font options} & и\\ -% |textfont=| & \marg{font options} & .\\ -% \end{tabular}\end{quote} -% -%^^A And these are the available font options: -% Теперь существующие опции данных ключей: -% -% \begin{Options}{\OptionLabel} -% \item[scriptsize] {\scriptsize Very small size} -% \item[footnotesize] {\footnotesize The size usually used for footnotes} -% \item[small] {\small Small size} -% \item[normalsize] {\normalsize Normal size} -% \item[large] {\large Large size} -% \item[Large] {\Large Even larger size} -% -% \item[up] {\upshape Upright shape} -% \item[it] {\itshape Italic shape} -% \item[sl] {\slshape Slanted shape} -% \item[sc] {\scshape Small Caps shape} -% -% \item[md] {\mdseries Medium series} -% \item[bf] {\bfseries Bold series} -% -% \item[rm] {\rmfamily Roman family} -% \item[sf] {\sffamily Sans Serif family} -% \item[tt] {\ttfamily Typewriter family} -% -% \item[\UserDefined] -%^^A Own font options can be defined using |\DeclareCaptionFont|. -% Собственные опции могут быть определены с~помощью команды -% |\DeclareCaptionFont|. + +% \subsection{Fonts} +\subsection{Шрифты} +\label{fonts} + +\DescribeMacro{font=} +\DescribeMacro{labelfont=} +\DescribeMacro{textfont=} +% There are three font options which affects different parts of the caption: +% One affecting the whole caption (|font|), one which only affects the caption +% label and separator (|label|\-|font|) and at least one which only affects the +% caption text (|text|\-|font|). +% You set them up using the options +Заданы три ключа которые определяют шрифт разных элементов подписи: +Первый задаёт шрифт для всей подписи (|font|), второй задаёт шрифт только +для нумерационного заголовка и~разделителя (|label|\-|font|), и~третий +\cdash--- шрифт для текста (|text|\-|font|). +Вы задаёте их, используя ключи +\begin{quote}\begin{tabular}{@{}r@{}ll} + |font=| & \marg{font options} & ,\\ + |labelfont=| & \marg{font options} & , и\\ + |textfont=| & \marg{font options} & .\\ +\end{tabular}\end{quote} +% where \meta{font options} is a list of comma separated font options. +где аргументом \meta{font options} являются перечисленные через запятую опции. + +% And these are the available font options: +Далее уже созданные опции данных ключей: + +\begin{Options}{stretch=\meta{amount}} + \item[scriptsize] {\scriptsize Очень маленький} + \item[footnotesize] {\footnotesize Обычно используется в~сносках} + \item[small] {\small Маленький} + \item[normalsize] {\normalsize Нормальный} + \item[large] {\large Большой} + \item[Large] {\Large Ещё больше} +\end{Options} +\vspace{0pt}\pagebreak[3] +\begin{Options}{stretch=\meta{amount}} +% \item[normalfont] {\normalfont Normal shape \& series \& family} + \item[normalfont] {\normalfont Исходные семейство, насыщенность и~начертание} + + \item[up] {\upshape Прямой} + \item[it] {\itshape Курсив} + \item[sl] {\slshape Наклонный} + \item[sc] {\scshape Капитель} + + \item[md] {\mdseries Нормальная насыщенность (светлый)} + \item[bf] {\bfseries Полужирный} + + \item[rm] {\rmfamily Шрифт с~засечками} + \item[sf] {\sffamily Рубленый} + \item[tt] {\fontfamily{cmtt}\selectfont Шрифт пишущей машинки (равноширинный)} +\end{Options} +\vspace{0pt}\pagebreak[3] +\begin{Options}{stretch=\meta{amount}} +% \item[singlespacing] Single spacing \See{\Ref{setspace}} +% \item[onehalfspacing] One-and-a-half spacing \See{\Ref{setspace}} +% \item[doublespacing] Double spacing \See{\Ref{setspace}} +% \item[stretch=\meta{amount}] |\setstretch|\marg{amount} \See{\Ref{setspace}} + \item[singlespacing] Одинарный интерлиньяж \See{\Ref{setspace}} + \item[onehalfspacing] Полуторный интерлиньяж \See{\Ref{setspace}} + \item[doublespacing] Двойной интерлиньяж \See{\Ref{setspace}} + \item[stretch=\meta{amount}] ${} \equiv {}$|\setstretch|\marg{amount} \See{\Ref{setspace}} +\end{Options} +\vspace{0pt}\pagebreak[3] +\begin{Options}{stretch=\meta{amount}} +% \item[normalcolor] |\normalcolor| +% \item[color=\meta{colour}] |\color|\marg{colour} +% {\small(If the \package{color} or \package{xcolor} package is loaded, +% see \Ref{declare} for an example)} + \item[normalcolor] соответствует команде |\normalcolor| + \item[color=\meta{colour}] опция ключа эквивалентна аргументу команды |\color|\marg{colour} + {\small(Если загружен пакет \package{color} или \package{xcolor}, + см., например~\Ref{declare})} +\end{Options} +\vspace{0pt}\pagebreak[3] +\begin{Options}{stretch=\meta{amount}} +% \item[normal] The combination of the options |normal|\-|color|, +% |normal|\-|font|, |normal|\-|size|, and |single|\-|spacing| + \item[normal] Комбинация опций |normal|\-|color|, + |normal|\-|font|, |normal|\-|size| и~|single|\-|spacing| + + \item[\UserDefined] +% Own font options can be defined using |\Declare|\-|Caption|\-|Font|. % \SeeUserDefined -% \end{Options} -% -%^^A If you use only one of these options you can omit the braces; -%^^A e.g., the options -% Если используется одна опция ключа, фигурные скобки можно опустить; -% например, опции -% \iffalse -% \begin{quote} -% \fi -% |font={small}| -% \iffalse -% \end{quote} -% \fi -% и -% \iffalse -% \begin{quote} -% \fi -% |font=small| -% \iffalse -% \end{quote} -% \fi -%^^A will give the same result. -% дадут одинаковый результат. -% -%^^A Two examples: -% Пара примеров: -% \begin{Example} -% \begin{quote} -% |font={small,it},labelfont=bf| -% \end{quote} -% \captionsetup{aboveskip=0pt} -% \example{font={small,it},labelfont=bf}{\figuretext} -% \end{Example} -% -% \begin{Example} -% \begin{quote} -% |font=small,labelfont=bf,textfont=it| -% \end{quote} -% \captionsetup{aboveskip=0pt} -% \example{font=small,labelfont=bf,textfont=it}{\figuretext} -% \end{Example} -% -% \iffalse + Собственные опции могут быть определены с~помощью команды + |\Declare|\-|Caption|\-|Font|. + \SeeUserDefined +\end{Options} + +% If you use only one of these options you can omit the braces; +% e.g., the options +Если используется одна опция ключа, фигурные скобки можно опустить; +например, опции +%\begin{quote} + |font={small}| +%\end{quote} +% and +и +%\begin{quote} + |font=small| +%\end{quote} +% will give the same result. +дадут одинаковый результат. + +% Three examples: +Три примера +\begin{Example} + \begin{quote} + |font=it,labelfont=bf| + \end{quote} + \captionsetup{skip=0pt} + \example{font=it,labelfont=bf}{\exampletext} +\end{Example} + +\begin{Example} + \begin{quote} + |labelfont=bf,textfont=it| + \end{quote} + \captionsetup{skip=0pt} + \example{labelfont=bf,textfont=it}{\exampletext} +\end{Example} + +\begin{Example} + \begin{quote} + |font={small,stretch=0.80}| + \end{quote} + \captionsetup{skip=0pt} + \example{font={small,stretch=0.80}}{\exampletext} +\end{Example} + +\medskip + +\pagebreak[3] +\DescribeMacro{font+=} +\DescribeMacro{labelfont+=} +\DescribeMacro{textfont+=} +\NEWfeature{v3.1f}% +% You can also add font options to the current ones, so for example +Вы также можете добавить опции шрифта к~текущим, так например запись +\begin{quote} + |\captionsetup{font=small}|\\ + |\captionsetup{font+=it}| +\end{quote} +% is identical to +будет идентична +\begin{quote} + |\captionsetup{font={small,it}}| +\end{quote} + % --------------------------------------------------------------------------- % -% \fi -% -%^^A \subsection{Margins and further paragraph options} -% \subsection{Поля и~другие опции формирования абзаца} -% \label{margins} -% -% \DescribeMacro{margin=} -% \DescribeMacro{width=} -%^^A For all captions you can specify \emph{either} an extra margin \emph{or} -%^^A a fixed width. You do this by using the options -% Для всех подписей можно определить \emph{либо} дополнительную втяжку -% \emph{либо} фиксированную ширину. Это задаётся ключами -% \begin{quote} -% \begin{tabular}{@{}r@{}ll} -% |margin=| & \meta{amount} & \emph{или}\\ -% |width=| & \meta{amount} & \\ -% \end{tabular}\end{quote} -%^^A Nevertheless what option you use, the left and right margin will be the -%^^A same. -% Независимо от того, какой ключ используется, левое и~правое поле -% будут симметричны. -% -%^^A Two examples will illustrating this: -% Два иллюстрирующих примера: -% \begin{Example} -% \begin{quote} -% |margin=10pt| -% \end{quote} -% \captionsetup{aboveskip=0pt} -% \example{margin=10pt}{\figuretext} -% \end{Example} -% -% \begin{Example} -% \begin{quote} -% |width=.75\textwidth| -% \end{quote} -% \captionsetup{aboveskip=0pt} -% \example{width=.75\textwidth}{\figuretext} -% \end{Example} -% -% \DescribeMacro{parskip=}\label{TeXr:multipar:a} -%^^A This option is useful for captions containing more than one paragraph. -%^^A It specifies the extra vertical space inserted between them: -% Данный ключ понадобится, если подписи содержат более одного абзаца. -% Он задаёт дополнительную вертикальную отбивку между абзацами: -% \begin{quote} -% |parskip=|\meta{amount} -% \end{quote} -%^^A One example: -% Пример: -% \begin{Example} -% \begin{quote} -% |margin=10pt,parskip=5pt| -% \end{quote} -% \captionsetup{aboveskip=0pt} -% \example{margin=10pt,parskip=5pt}{ -%^^A First paragraph of the caption. This one contains some test, just to -%^^A show how these options affect the layout of the caption. -%^^A -%^^A Second paragraph of the caption. This one contains some text, too, to -%^^A show how these options affect the layout of the caption.} -% Первый абзац подписи. Он содержит немного текста, чтобы показать -% как заданные настройки создают оформление подписи. -% -% Второй абзац подписи. Он тоже содержит немного текста, чтобы показать -% как заданные настройки создают оформление подписи.} -% \end{Example} -% -% \DescribeMacro{hangindent=} -%^^A The option -% Ключ -% \begin{quote} -% |hangindent=|\meta{amount} -% \end{quote} -%^^A is for setting up a hanging indention starting from the second line of each -%^^A paragraph. If the caption contains just a single paragraph, using this option -%^^A leads to the same result as the option |indention=| you already know about. -%^^A But if the caption contains multiple paragraphs you will notice the difference: -% задаёт втяжку для вторых строк каждого абзаца подписи. -% Если подпись состоит из одного абзаца, этот ключ даёт тот же результат -% что и~известный вам ключ |indention=|. -% Но в~подписи из нескольких абзацев вы увидите разницу: -% -% \begin{Example} -% \begin{quote} -% |format=hang,indention=-.5cm| -% \end{quote} -% \captionsetup{aboveskip=0pt} -% \example{format=hang,indention=-.5cm}{ -% Первый абзац подписи. Он содержит немного текста, чтобы показать -% как заданные настройки создают оформление подписи. -% -% Второй абзац подписи. Он тоже содержит немного текста, чтобы показать -% как заданные настройки создают оформление подписи.} -% \end{Example} -% -% \begin{Example} -% \begin{quote} -% |format=hang,hangindent=-.5cm| -% \end{quote} -% \captionsetup{aboveskip=0pt} -% \example{format=hang,hangindent=-.5cm}{ -% Первый абзац подписи. Он содержит немного текста, чтобы показать -% как заданные настройки создают оформление подписи. -% -% Второй абзац подписи. Он тоже содержит немного текста, чтобы показать -% как заданные настройки создают оформление подписи.} -% \label{TeXr:multipar:z} -% \end{Example} -% -% \iffalse + +% \subsection{Margins and further paragraph options} +\subsection{Поля и~другие опции формирования абзаца} +\label{margins} + +\DescribeMacro{margin=} +\DescribeMacro{width=} +% For all captions you can specify \emph{either} an extra margin \emph{or} +% a fixed width:~\footnote{Only fixed widths are supported here; if you are +% looking for a way to limit the width of the caption to the width of the +% figure or table, please take a look at the \package{floatrow}\cite{floatrow} +% or \package{threeparttable}\cite{threeparttable} package.} +Для всех подписей можно определить \emph{либо} дополнительную втяжку +\emph{либо} фиксированную ширину. Это задаётся ключами\footnote{Здесь поддерживаются + только фиксированные ширины; если вам нужно задать ширину подписи по ширине + графики или табличного материала, обратитесь к~пакетам \package{floatrow}\cite{floatrow} + или \package{threeparttable}\cite{threeparttable}.} +\begin{quote}\begin{tabular}{@{}r@{}ll} + |margin=| & \meta{amount} & \emph{--или--}\\ + |margin=| & |{|\meta{left amount}|,|\meta{right amount}|}| & \emph{--или--}\\ + |width=| & \meta{amount} & \\ +\end{tabular}\end{quote} +\NEWfeature{v3.1} +% If you specify just one \meta{amount} for the margin, it will be used for +% both, the left and right margin, e.g.~|margin=|\x|10pt| is equivalent to +% |margin=|\x|{10pt,10pt}|. +% In two-side documents the left and right margin will be swapped on even pages. +Если вы определите только одно значение \meta{amount} для поля, оно будет использовано для обоих полей, +левого и~правого, например,~|margin=|\x|10pt| эквивалентно |margin=|\x|{10pt,10pt}|. +Для двусторонних документов левое и~правое поля на чётных полосах зеркально отобразятся. +\DescribeMacro{oneside} +\DescribeMacro{twoside} +% To prevent this you can specify the option |oneside| additionally, +% e.g.~|\caption|\-|setup{margin=|\x|{0pt,10pt},|\x|oneside}|.\par +% But if you are specifying a width, then both, the left and the right margin, +% will have the same amount. +Если вам это не нужно вы можете задать дополнительно опцию |oneside|, +например,~|\caption|\-|setup|\x|{margin=|\x|{0pt,10pt},|\x|oneside}|.\par +Но если вы определяете ширину подписи, то оба поля будут одинаковыми. + +% Three examples will illustrating this: +Три примера для иллюстрации: +\begin{Example} + \begin{quote} + |margin=10pt| + \end{quote} + \captionsetup{skip=0pt} + \example{margin=10pt}{\exampletext} +\end{Example} + +\begin{Example} + \begin{quote} + |margin={1cm,0cm}| + \end{quote} + \captionsetup{skip=0pt} + \example{margin={1cm,0cm}}{\exampletext} +\end{Example} + +\begin{Example} + \begin{quote} + |width=.75\textwidth| + \end{quote} + \captionsetup{skip=0pt} + \example{width=.75\textwidth}{\exampletext} +\end{Example} + +\begin{Note} +% When the caption is placed beside the contents (for example in a |SC|\-|figure| +% environment offered by the \package{sidecap} package\cite{sidecap}) or the +% figure is an in-text figure (for example in a |wrap|\-|figure| environment +% offered by the \package{wrapfig} package\cite{wrapfig}), the margin setting +% will be automatically reset to |0pt| at the very beginning of the environment. +% But if you really want to setup an extra margin for these environments, you can +% do so by setting this margin either inside the environment itself, of by +% specifying a margin for this particular environment, +% e.g.~|\caption|\-|setup[SC|\-|figure]{margin=|\x|10pt}|. +Когда подпись помещена рядом с~содержимым (например внутри +окружения |SCfigure|, предлагаемого пакетом \package{sidecap} package\cite{sidecap}) +или окружение флота обтекается текстом (флот помещён в~оборку, например в~окружении |wrap|\-|figure| +предлагаемом пакетом \package{wrapfig}\cite{wrapfig}), установки полей +обнуляются в~начале окружения. Но если вам действительно нужно задать +втяжку для этих окружений, вы можете задать нужные поля внутри окружения, задав +установки полей специально для этих окружений, например, +|\caption|\-|setup[SC|\-|figure]|\x|{margin=10pt}|. + \end{Note} + +\begin{Expert} +\DescribeMacro{margin*=}\NEWfeature{v3.1}% +% There is also a starred variant of the |margin=| option, |margin*=|, which only +% changes the margin if no width was set. +Существует также «звёздный» вариант ключа |margin=|, ключ |margin*=|, который +изменяет поля только когда не задана ширина. +\end{Expert} + +\begin{Expert} +\DescribeMacro{minmargin=} +\DescribeMacro{maxmargin=}\NEWfeature{v3.1}% +% You can also set a minimum or maximum margin amount. This can be useful for +% limiting the margin amount in smaller environments, e.g.~|minipage|s. +% For example the \SmF\ document classes limit the margin amount to +% |maxmargin=|\x|0.1\linewidth|. (See \Ref{SMF}) +Вы можете также задать минимальный или максимальный размер полей. Это может быть полезно +для ограничения размера полей в~уменьшенных форматах, например внутри окружения~|minipage|. +Например классы документов \SmF\ ограничивают поля +|maxmargin=|\x|0.1\linewidth|. (См.~\Ref{SMF}) +\end{Expert} + +\medskip + +\pagebreak[3] +\DescribeMacro{parskip=}\label{TeXr:multipar:a}% +% This option is useful for captions containing more than one paragraph. +% It specifies the extra vertical space inserted between them: +Данный ключ понадобится, если подписи содержат более одного абзаца. +Он задаёт дополнительную вертикальную отбивку между абзацами: +\begin{quote} + |parskip=|\meta{amount} +\end{quote} +% One example: +Пример: +\begin{Example} + \begin{quote} + |margin=10pt,parskip=5pt| + \end{quote} + \captionsetup{skip=0pt} + \example{margin=10pt,parskip=5pt}{% +% First paragraph of the caption. This one contains some test, just to +% show how these options affect the layout of the caption.\par +% Second paragraph of the caption. This one contains some text, too, to +% show how these options affect the layout of the caption.} + Первый абзац подписи. Он содержит немного текста, чтобы показать + как заданные настройки создают оформление подписи.\par + Второй абзац подписи. Он тоже содержит немного текста, чтобы показать + как заданные настройки создают оформление подписи.} +\end{Example} + +\pagebreak[3] +\DescribeMacro{hangindent=} +% The option +Ключ +\begin{quote} + |hangindent=|\meta{amount} +\end{quote} +% is for setting up a hanging indention starting from the second line of each +% paragraph. If the caption contains just a single paragraph, using this option +% leads to the same result as the option |indention=|\meta{amount} you already +% know about. +% But if the caption contains multiple paragraphs you will notice the difference: +задаёт втяжку для вторых строк каждого абзаца подписи. +Если подпись состоит из одного абзаца, этот ключ даёт тот же результат +что и~известный вам ключ |indention=|\meta{amount}. +Но в~подписи из нескольких абзацев вы увидите разницу: + +\begin{Example} + \begin{quote} + |format=hang,indention=-.5cm| + \end{quote} + \captionsetup{skip=0pt} + \example{format=hang,indention=-.5cm}{% +% First paragraph of the caption. This one contains some test, just to +% show how these options affect the layout of the caption.\par +% Second paragraph of the caption. This one contains some text, too, to +% show how these options affect the layout of the caption.} + Первый абзац подписи. Он содержит немного текста, чтобы показать + как заданные настройки создают оформление подписи.\par + Второй абзац подписи. Он тоже содержит немного текста, чтобы показать + как заданные настройки создают оформление подписи.} +\end{Example} + +\begin{Example} + \begin{quote} + |format=hang,hangindent=-.5cm| + \end{quote} + \captionsetup{skip=0pt} + \example{format=hang,hangindent=-.5cm}{% +% First paragraph of the caption. This one contains some test, just to +% show how these options affect the layout of the caption.\par +% Second paragraph of the caption. This one contains some text, too, to +% show how these options affect the layout of the caption.} + Первый абзац подписи. Он содержит немного текста, чтобы показать + как заданные настройки создают оформление подписи.\par + Второй абзац подписи. Он тоже содержит немного текста, чтобы показать + как заданные настройки создают оформление подписи.} +\end{Example} + +\begin{Note} +% If your caption contains more than one paragraph, you have +% to specify an alternative caption for the list-of-figures using the +% optional argument of |\caption| or |\caption|\-|of|, otherwise you will +% get an error message. +Если подпись содержит более одного абзаца, вам нужно +задать сокращённый вариант подписи для списков рисунков или таблиц, используя +дополнительный аргумент команд |\caption| или |\captionof|, иначе вы получите +сообщение об ошибке. +\end{Note} + % --------------------------------------------------------------------------- % -% \fi -% -% -%^^A \subsection{Styles} -% \subsection{Стили} -% \label{style} -% -% \NoBreak\DescribeMacro{style=} -%^^A A suitable combination of caption options is called \emph{caption style}. -%^^A You can compare them more or less to page styles which you set up with -%^^A |\pagestyle|: The caption style provides all settings for a whole caption layout. -% Определённая\nopagebreak[4] комбинация нескольких ключей создаёт \emph{стиль подписи}. -% Это можно сравнить со стилями колонтитула, задаваемого командой -% |\pagestyle|: стиль подписи задаёт все настройки для оформления подписи. -% -%^^A You switch to an already defined caption style with the option -% Предварительно созданный стиль можно вызвать ключом -% \begin{quote} -% |style=|\meta{style name}\quad. -% \end{quote} -%^^A The \thispackage\ package usually defines only the style |default| which -%^^A puts all options you already know about to the default ones. -%^^A This means that specifying the option -% Пакет \thispackage\ задаёт стиль |default|, который -% устанавливает известным вам ключам значения по умолчанию. -% Это означает, что определение этого ключа как -% \begin{quote} -% |style=default| -% \end{quote} -%^^A has the same effect as specifying all these options: -% даст тот же эффект, что и~задание всех ключей, приведённых ниже: -% \begin{quote} -% |format=default,labelformat=default,labelsep=default,|\\ -% |justification=default,font=default,labelfont=default,|\\ -% |textfont=default,margin=0pt,indention=0pt,parindent=0pt|\\ -% |hangindent=0pt,singlelinecheck=true| -% \end{quote} -% -%^^A Own caption styles can be defined using |\DeclareCaptionStyle|. -% Собственный стиль подписи можно определить, используя |\DeclareCaptionStyle|. + +\PageBreak +% \subsection{Styles} +\subsection{Стили} +\label{style} + +\DescribeMacro{style=} +% A suitable combination of caption options is called \emph{caption style}. +% You can compare them more or less to page styles which you set up with +% |\page|\-|style|; +% the caption style provides all settings for a whole caption layout. +Определённая комбинация нескольких ключей создаёт \emph{стиль подписи}. +Это можно сравнить со стилями колонтитула, задаваемого командой +|\pagestyle|: стиль подписи задаёт все настройки для оформления подписи. + +% You switch to an already defined caption style with the option +Предварительно созданный стиль можно вызвать ключом +\begin{quote} + |style=|\meta{style name}\quad. +\end{quote} +% \Thispackage\ pre-defines two styles: |base| and |default|. +\Thispackage\ определяет два стиля: |base| и~|default|. + +\NEWfeature{v3.1} +% The |base| style puts all options you already know about to values reflecting +% the look of the captions when using one of the base \LaTeX\ document classes +% \class{article}, \class{report}, and \class{book}. +% This means that specifying the option +Стиль |base| задаёт все известные вам ключи со значениями, +соответствующими заданным в~базовых классах \LaTeX'а +\class{article}, \class{report} и~\class{book}. +Это означает, что задание опции +\begin{quote} + |style=base| +\end{quote} +% has the same effect as specifying all these options: +даст тот же эффект, что и задание всех перечисленных опций: +\begin{quote} + |format=plain,labelformat=default,labelsep=colon,|\\ + |justification=justified,font={},labelfont={},|\\ + |textfont={},margin=0pt,indention=0pt|\\ + |parindent=0pt,hangindent=0pt,singlelinecheck=true| +\end{quote} +\begin{Annotation*} +% But |justification=centering,indention=0pt| will be set if +% the caption fits into a single line. +А~для однострочной подписи будут заданы настройки |justification=|\x|centering,|\x|indention=0pt|. +\end{Annotation*} + +% In contrast the |default| style follows the default values, reflecting +% the look of the captions given by the document class you actually use. +% This style is selected by default and represents these options: +В~отличие от предыдущего стиль |default| задаёт значения, отвечающие +виду подписей, создаваемых данным классом документа. +Этот стиль определяет следующие опции: +\begin{quote} + |format=default,labelformat=default,labelsep=default,|\\ + |justification=default,font=default,labelfont=default,|\\ + |textfont=default,margin=0pt,indention=0pt|\\ + |parindent=0pt,hangindent=0pt,singlelinecheck=true| +\end{quote} +\begin{Annotation*} +% But again |justification=centering,indention=0pt| will be set if +% the caption fits into a single line. +Но при этом снова действуют настройки +|justification=|\x|centering,|\x|indention=0pt| для однострочных подписей. +\end{Annotation*} + +% So if you use one of the base \LaTeX\ document classes \class{article}, +% \class{report}, or \class{book}, both caption styles, |base| and |default|, +% point to (nearly) the same settings. +Поэтому, если вы используете один из классов \LaTeX'а \class{article}, +\class{report} или \class{book}, обе опции, |base| и~|default|, зададут фактически +одинаковые настройки. + +\begin{Note} +% Own caption styles can be defined using |\Declare|\-|Caption|\-|Style|.\LineBreak % \SeeUserDefined -% -% \iffalse +Собственные стили подписи могут быть определены с~помощью +команды |\Declare|\-|Caption|\-|Style|.\LineBreak\SeeUserDefined +\end{Note} + % --------------------------------------------------------------------------- % -% \fi -% -%^^A \subsection{Skips} -% \subsection{Отбивки} -% -% \DescribeMacro{aboveskip=} -% \DescribeMacro{belowskip=} -%^^A The spaces above and below the caption are controlled by the skips -%^^A |\abovecaptionskip| and |\belowcaptionskip|. The standard \LaTeX\ document -%^^A classes |article|, |report| and |book| set |\abovecaptionskip| to |10pt| -%^^A and |\belowcaptionskip| to |0pt|. -% Отбивки сверху и~снизу подписи определяются командами -% |\abovecaptionskip| и~|\belowcaptionskip|. Стандартные классы \LaTeX'а -% |article|, |report| и~|book| задают |\abovecaptionskip| равным |10pt|, -% а~|\belowcaptionskip|\hbox{ \cdash--- |0pt|}. -% -% -%^^A Both skips can be changed with the command |\setlength|, but you can -%^^A use these options, too: -% Обе отбивки могут быть изменены командой |\setlength|, но также можно -% использовать и~ключи: -% \nopagebreak[3] -% \begin{quote}\begin{tabular}{@{}r@{}ll} -% |aboveskip=| & \meta{amount} & и\\ -% |belowskip=| & \meta{amount} & .\\ -% \end{tabular}\end{quote} -% -% \DescribeMacro{position=}\label{TeXr:captionskips:a} -%^^A Using |\abovecaptionskip| and |\belowcaptionskip| has a major design flaw: -%^^A If the caption is typeset \emph{above} (and not \emph{below}) the figure -%^^A or table they are not set up very useful at default, because there will be -%^^A some extra space above the caption but no space between the caption and the -%^^A figure or table itself. (Remember: |\belowcaptionskip| is usually set to |0pt|.) -% Использование команд |\abovecaptionskip| и~|\belowcaptionskip| имеет один -% недостаток: если подпись должна быть помещена \emph{над}, а~не \emph{под} -% плавающим объектом, то, в~результате, мы можем получить ненужную отбивку сверху -% и~никакой отбивки между подписью и~объектом. -% (Напомним: |\belowcaptionskip| обычно определена как~|0pt|.) -% -%^^A Please compare the spacing in these small tables: -% Пожалуйста, сравните отбивки у~двух небольших таблиц: -% \begin{Example} -% \begin{minipage}[c]{.5\linewidth} + +% \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 -% \captionsetup{aboveskip=0pt}% +% This can get quite useful when setting generic options which are independent +% of a specific document. % \fi -% \captionof{table}{Табличка} -% \centering\begin{tabular}{ll} -% A & B \\ -% C & D \\ -% \end{tabular} -% \end{minipage} -% \begin{minipage}[c]{.5\linewidth} -% \centering\begin{tabular}{ll} -% A & B \\ -% C & D \\ -% \end{tabular} -% \captionof{table}{Табличка} -% \end{minipage} -% \end{Example} -% -%^^A But you can fix this by using the option |position=|: It specifies how the -%^^A spacing above and below the caption will be used: -% Но это можно исправить используя ключ |position=|: он определяет, как -% отбивки сверху и~снизу будут использованы; опция -% \begin{quote} -% |position=top|\quad(или |position=above|) -% \end{quote} -%^^A tells the \thispackage\ package to use the spacing useful for caption -%^^A \emph{above} the figure or table and -% говорит пакету \thispackage, что нужно задать соответствующие отбивки для подписи -% \emph{сверху} рисунка или таблицы и~опция -% \begin{quote} -% |position=bottom|\quad(или |position=below|) -% \end{quote} -%^^A tells the \thispackage\ package to use the spacing useful for captions -%^^A \emph{below} the figure or table. (The last one is the default setting -%^^A except for |longtable|s.) -% велит пакету \thispackage\ расставить соответствующие отбивки для подписи -% \emph{снизу} рисунка или таблицы. (Данная опция задаётся по умолчанию -% кроме окружения многостраничной таблицы |longtable|.) -% -%^^A So adding an extra |\captionsetup{position=top}| to the left example -%^^A table gives you proper spacing around both captions: -% Итак задание |\captionsetup{position=top}| для левой таблицы, -% в~примере выше даст нужные отбивки для обеих подписей: -% \begin{Example} -% \begin{minipage}[c]{.5\linewidth} -% \captionsetup{position=top} -% \captionof{table}{Табличка} -% \centering\begin{tabular}{ll} -% A & B \\ -% C & D \\ -% \end{tabular} -% \end{minipage} -% \begin{minipage}[c]{.5\linewidth} -% \centering\begin{tabular}{ll} -% A & B \\ -% C & D \\ -% \end{tabular} -% \captionof{table}{Табличка} -% \end{minipage} -% \end{Example} -% -%^^A (Technically speaking |\abovecaptionskip| and |\belowcaptionskip| will -%^^A be swapped if you specify the option |position=top|, so in both cases -%^^A |\abovecaptionskip| will be used between the caption and the figure or -%^^A table itself.) -% («Техника» работы ключа такова: |\abovecaptionskip| и~|\belowcaptionskip| -% меняются местами если задана опция |position=top|, поэтому в~обоих случаях -% |\abovecaptionskip| задаётся между подписью и~рисунком или таблицей.) -% -%^^A This option is especially useful when used together with the optional -%^^A argument of the |\captionsetup| command. -%^^A \See{\Section{misc}{Useful stuff} for details}\par -%^^A For example -% Этот ключ нужен когда используется вместе с~дополнительным аргументом -% команды |\captionsetup|. -% \See{\Section{misc}{Полезные утилиты}, чтобы узнать -% подробности.}\par Например, опция ключа -% \begin{quote} -% |\captionsetup[table]{position=top}| -% \end{quote} -%^^A causes all captions within tables to be treated as captions \emph{above} -%^^A the table (regarding spacing around it). -% говорит, что подписи в~плавающих таблицах помещаются \emph{сверху} -% (с~соответствующим отбивками). -% \DescribeMacro{tableposition=}\label{TeXr:captop:a}%^^A -% \NEWfeature{v3.0a} -%^^A Because this is a very common setting the \thispackage\ package offers -%^^A an abbreviating option for the use with |\usepackage|: -% Поскольку такая установка очень популярна, пакет \thispackage\ предлагает -% ключ"=аббревиатуру, для использования его в~строке |\usepackage|: -% \begin{quote} -%^^A% |\usepackage[|\ldots|,tableposition=top]{caption}|\footnote{Please -%^^A% note that this is \emph{not} sufficient when using a -%^^A% \KOMAScript\ document class, you need to use the \emph{global} -%^^A% option |tablecaptionabove|, too.} -% |\usepackage[|\ldots|,tableposition=top]{caption}|\footnote{Обратите внимание, -% что этот ключ \emph{не} достаточен, если используется класс -% \KOMAScript, вам понадобится также \emph{глобальная} -% опция |tablecaptionabove|.} -% \end{quote} -%^^A is equivalent to -% что эквивалентно -% \begin{quote} -% |\usepackage[|\ldots|]{caption}|\\ -% |\captionsetup[table]{position=top}| -% \end{quote}\label{TeXr:captionskip:z}%^^A -% \label{TeXr:captop:z} -% -% \iffalse +В~то время как незвёздный вариант даст вам предупреждение, если \meta{options} не +использовались в~документе (например настройки |\captionsetup[table]{font=sf}| \cdash--- +и~ни одного окружения |table|), звёздный вариант этого не делает. +\iffalse +Это может быть очень полезно для создания настроек, независимых от конкретного документа. +\fi +\end{Expert} + +\medskip + +\pagebreak[3] +\DescribeMacro{\clearcaptionsetup} +% If you want to get rid of these parameters marked for an automatic use within +% a particular environment you can use the command +Если вам внутри данного окружения нужно отменить параметры, заданные для +текущего типа флота, используйте команду +\begin{quote} + |\clearcaptionsetup|\oarg{option}\marg{float type}\quad. +\end{quote} + +% For example |\clearcaptionsetup{figure}| would clear all the extra handling +% for figures in the example above: +Например |\clearcaptionsetup{figure}| отменит дополнительные настройки +из примера выше: +\begin{quote} + |\captionsetup{font=small}|\\ + |\captionsetup[figure]{labelfont=bf,textfont=it}|\\ + \ldots\\ + | \caption{A figure}|\\ + \ldots\\ + |\clearcaptionsetup{figure}|\\ + \ldots\\ + | \caption{A figure}|\\ + \ldots\\ +\end{quote} +\pagebreak[3] +\begin{Example} + \captionsetup{font=small} + \captionsetup[figure]{labelfont=bf,textfont=it} + \begingroup + \captionof{figure}{A figure} + \endgroup + \captionsetup{position=top} + \clearcaptionsetup{figure} + \begingroup + \captionof{figure}{A figure} + \endgroup +\end{Example} + +\pagebreak[3] +\NEWfeature{v3.1} +% If an optional argument \meta{option} is given, only the settings regarding +% this particular \meta{option} are cleared.\footnote{You can only specify +% \emph{one} option here, not a list of options. +% If you want to clean more than one option, you need to use more than one +% \cs{clear}\-\texttt{caption}\-\texttt{setup}.} +% While the example above not only clears the options +% |labelfont=bf,|\x|textfont=it| +% for figures (but all options for figures instead), +% this one would only clear the |labelfont=bf| setting, leaving all other +% settings for figures intact: +Если задан дополнительный аргумент \meta{option}, отменяются только настройки +данной опции \meta{option}.\footnote{Вы можете задать только +\emph{одну} опцию, а~не список опций. +Если вам нужно отменить настройки для ряда опций, вам придётся использовать несколько команд +\cs{clearcaptionsetup}.} +В~то время как пример выше не только отменил опции ключей |labelfont=bf,|\allowbreak +|textfont=it| +для рисунков (но и~все опции для рисунков), +следующий пример отменит только настройку |labelfont=bf|, оставив все остальные +настройки нетронутыми: +\begin{quote} + |\captionsetup{font=small}|\\ + |\captionsetup[figure]{labelfont=bf,textfont=it}|\\ + \ldots\\ + | \caption{A figure}|\\ + \ldots\\ + |\clearcaptionsetup[labelfont]{figure}|\\ + \ldots\\ + | \caption{A figure}|\\ + \ldots +\end{quote} +\begin{Example} + \captionsetup{font=small} + \captionsetup[figure]{labelfont=bf,textfont=it} + \begingroup + \captionof{figure}{A figure} + \endgroup + \captionsetup{position=top} + \clearcaptionsetup[labelfont]{figure} + \begingroup + \captionof{figure}{A figure} + \endgroup +\end{Example} +\begin{Expert} +% Analogous to |\caption|\-|setup*| there is also a starred form +% |\clear|\-|caption|\-|setup*| which suppresses warnings if the given +% \meta{option} was not setup for the specified \meta{float type}. +Аналогично команде |\captionsetup*| существует также звёздная форма +|\clearcaptionsetup*| которая отменяет предупреждения, если \meta{option} +не является настройкой для данного \meta{float type}. +\end{Expert} + +\medskip + +\DescribeMacro{\showcaptionsetup} +% For debugging purposes the command\nopagebreak +Для возможностей настройки настроек, предложена команда\nopagebreak +\begin{quote} + |\showcaptionsetup|\marg{float type}\quad.\nopagebreak[3] +\end{quote} +% is offered. It generates a log file entry, showing the given options +% for the specified \meta{float type}. For example +Она создаёт сообщение в~log-файле, показывая заданные опции +для выбранного \meta{float type}. Например +\begin{quote} + |\captionsetup[figure]{labelfont=bf,textfont=it}|\\ + |\showcaptionsetup{figure}| +\end{quote} +% gives the info: +даст сообщение: +\begin{quote}\small + |Caption Info: Option list on `figure'|\\ + |Caption Data: {labelfont=bf,textfont=it} on input line 5.| +\end{quote} + +\pagebreak[3] +% \subsection{Continued floats} +\subsection{Продолжающиеся флоты} +\label{ContinuedFloat} + +\DescribeMacro{\ContinuedFloat}\label{TeXr:continued:a}% +% Sometimes you want to split figures or tables without giving them +% their own reference number. This is what the command +Иногда возникает необходимость разбить рисунки или таблицы на несколько +частей, задав им общий номер. Для этого предназначена команда +\begin{quote} + |\ContinuedFloat|\quad. +\end{quote} +% is for; it should be used as first command inside the floating environment. +% It prevents the incrementation of the relevant counter (usually done by +% |\caption|), so a figure or table containing a |\Continued|\-|Float| inside +% gets the same reference number as the figure or table before. +% An example: +Лучше её поставить первой внутри окружения флота. +Команда |\ContinuedFloat| отменяет увеличение соответствующего счётчика флота +(используемого командой |\caption|) +и~задаёт тот же номер как и~у~рисунка или таблицы выше. Пример +\begin{quote} + |\begin{table}|\\ + | \caption{A table}|\\ + | |\ldots\\ + |\end{table}|\\ + \ldots\\ + |\begin{table}\ContinuedFloat|\\ + | \caption{A table (cont.)}|\\ + | |\ldots\\ + |\end{table}| +\end{quote} +% gives the following result: +даст следующий результат: +\begin{Example} + \captionsetup{type=table,position=b,skip=0pt} + \caption{A table} + \centerline{\ldots} + \ContinuedFloat + \caption{A table (cont.)} + \centerline{\ldots} +\end{Example} + +\bigskip + +\NEWfeature{v3.1} +% Furthermore the |\Continued|\-|Float| command executes options associated with +% the type name ``|Continued|\-|Float|''. For example this can be used to switch +% to a different label format for continued figures or tables, as shown here: +Помимо этого команда |\Continued|\-|Float| включает опции, связанные +с~соответствующей опцией"=типом «|Continued|\-|Float|». Например, это может быть использовано для +создания альтернативных форматов меток для таблиц и~рисунков, как показано здесь: +\begin{quote} + |\DeclareCaptionLabelFormat{continued}{Continued #1~#2}|\\ + |\captionsetup[ContinuedFloat]{labelformat=continued}|\\ + \ldots\\ + |\begin{table}\ContinuedFloat|\\ + | \caption{A table}|\\ + | |\ldots\\ + |\end{table}| +\end{quote} +\begin{Example}\selectlanguage{USenglish} + \captionsetup{type=table,position=b,skip=0pt} + \captionsetup[ContinuedFloat]{labelformat=continued1e} + \ContinuedFloat + \caption{A table}\label{continued1e} + \centerline{\ldots} +\end{Example} +В~русской документации это может выглядеть так: +\begin{quote} + |\DeclareCaptionLabelFormat{continued}{#1~#2 (\textit{продолжение})}|\\ + |\captionsetup[ContinuedFloat]{labelformat=continued}|\\ + \ldots\\ + |\begin{table}\ContinuedFloat|\\ + | \caption{A table}|\\ + | |\ldots\\ + |\end{table}| +\end{quote} +\begin{Example} + \captionsetup{type=table,position=b,skip=0pt} + \captionsetup[ContinuedFloat]{labelformat=continued1r} + \ContinuedFloat + \caption{A table}\label{continued1r} + \centerline{\ldots} +\end{Example} +\smallskip +% \See{\Ref{declare} for an explanation of +% \cs{Declare}\-\texttt{Caption}\-\texttt{Label}\-\texttt{Format}.} +\See{\Ref{declare} описывающий + \cs{Declare}\-\texttt{Caption}\-\texttt{Label}\-\texttt{Format}.} + +\medskip + +% There is also a \LaTeX\ counter called |Continued|\-|Float| which could be +% used for own purposes. +% For ordinary (floating) environments it's set to zero, to one for the first +% continued float, to two inside the second one, and so on. +% So every |\Continued|\-|Float| increments this counter and a floating +% environment without |\Continued|\-|Float| command resets this counter to zero. +% An example: +Создан также счётчик \LaTeX'а, названный |Continued|\-|Float|, который может быть +использован при необходимости. +В~обычных окружениях плавающих объектов он равен нулю, в~первом продолжающемся +флоте он равен единице, в~следующем для второго окружения и~т.\,д. +Так, каждая команда |\Continued|\-|Float| увеличивает этот счётчик и~плавающий объект +без команды |\Continued|\-|Float| вновь обнуляет этот счётчик. +Пример: +\begin{quote} + |\DeclareCaptionLabelFormat{cont}{#1~#2\asbuk{ContinuedFloat}}|\\ + |\captionsetup[ContinuedFloat]{labelformat=cont}|\\ + \ldots\\ + |\begin{table}\ContinuedFloat|\\ + | \caption{A table}|\\ + | |\ldots\\ + |\end{table}| +\end{quote} +\begin{Example} + \captionsetup{type=table,position=b,skip=0pt} + \captionsetup[ContinuedFloat]{labelformat=continued2} + \ContinuedFloat + \caption{A table}\label{continued2} + \centerline{\ldots} +\end{Example} +\medskip +% A reference to this table would still result in the output +% ``\autoref{continued2}'' since only the caption label format was changed. +% If you would like to use the |Continued|\-|Float| counter for the references, +% too, you could redefine the command |\the|\-|Continued|\-|Float| instead, +% which will be appended to the figure or table counter automatically in +% continued floats and is preset to be empty. +Ссылка на эту таблицу останется в~виде +«\autoref{continued2}», поскольку изменялся только формат метки. +Если вам нужно использовать также счётчик |Continued|\-|Float| в~ссылках, +вы должны переопределить команду |\the|\-|Continued|\-|Float|, +которая, подключается автоматически в~продолжающихся флотах, +тогда как по умолчанию эта команда пуста. +\begin{quote} + |\renewcommand\theContinuedFloat{\asbuk{ContinuedFloat}}|\\ + \ldots\\ + |\begin{table}\ContinuedFloat|\\ + | \caption{A table}|\\ + | |\ldots\\ + |\end{table}| +\end{quote} +\begin{Example} + \captionsetup{type=table,position=b,skip=0pt} + \renewcommand\theContinuedFloat{\asbuk{ContinuedFloat}} + \ContinuedFloat + \caption{A table}\label{continued3} + \centerline{\ldots} +\end{Example} +\medskip +% A reference to that table would result in the output ``\autoref{continued3}''. +Ссылка на эту таблицу даст следующий результат «\autoref{continued3}». + +\pagebreak[3] +\DescribeMacro{\ContinuedFloat*} +% Suppose you want to start the first figure or table of such a series with a +% kind of ``Figure 7a'' and not with ``Figure 7'' (and the second one with +% ``Figure 7b'' instead of ``Figure 7a''). +% This is possible, too, by using the starred variant |\Continued|\-|Float*| +% which---just like |\Continued|\-|Float|---executes options associated with the +% type name ``|Continued|\-|Float|'' and increments the \LaTeX\ counter +% |Continued|\-|Float|, \emph{but} marks the first figure or table of a series +% instead: +Предположим вам нужно создать продолжающиеся рисунок или таблицу с~нумерационным +заголовком вида «Figure 7a», а~не «Figure 7» (а~затем, как +«Figure 7b», вместо «Figure 7a»). +Это также возможно, если использовать звёздный вариант команды |\Continued|\-|Float*| +которая \cdash--- как и~|\Continued|\-|Float| \cdash--- подключает опции +с~помощью команды «|Continued|\-|Float|» и~увеличивает счётчик \LaTeX'а +|Continued|\-|Float|, \emph{но} отмечает и~первый флот из серии +продолжающихся флотов: +\begin{quote} + |\renewcommand\theContinuedFloat{\asbuk{ContinuedFloat}}|\\ + \ldots\\ + |\begin{figure}\ContinuedFloat*|\\ + | |\ldots\\ + | \caption{First figure of a series}|\\ + |\end{figure}|\\ + \ldots\\ + |\begin{figure}\ContinuedFloat|\\ + | |\ldots\\ + | \caption{Second figure of a series}|\\ + |\end{figure}|\\ + \ldots\\ + |\begin{figure}\ContinuedFloat|\\ + | |\ldots\\ + | \caption{Third figure of a series}|\\ + |\end{figure}| +\end{quote} +\begin{Example} + \captionsetup{type=figure,position=b,skip=0pt} + \renewcommand\theContinuedFloat{\asbuk{ContinuedFloat}} + \begingroup + \ContinuedFloat* + \centerline{\ldots} + \caption{First figure of a series} + \endgroup + \begingroup + \ContinuedFloat + \centerline{\ldots} + \caption{Second figure of a series} + \endgroup + \begingroup + \ContinuedFloat + \centerline{\ldots} + \caption{Third figure of a series} + \endgroup +\end{Example} +\smallskip +% \Note{Unfortunately \cs{ContinuedFloat*} is not available if the +% \package{subfig} package\cite{subfig} is loaded.} +\Note{К~сожалению команду \cs{ContinuedFloat*} нельзя использовать при загруженном пакете + \package{subfig}\cite{subfig}.} + +\pagebreak[3] +% \subsubsection*{A note about longtables} +\subsubsection*{A note about longtables} +% If you want to have a different caption label in |long|\-|table|s (offered +% by the \package{longtable} package\cite{longtable}) after a page break, +% this can \emph{not} be archived by using |\Continued|\-|Float|, +% but instead you could write something like: +Если вам нужно создать отличающийся формат метки для продолжения +окружения |long|\-|table| +(предлагаемого пакетом \package{longtable}\cite{longtable}) +на следующей странице, +использование |\Continued|\-|Float| \emph{не} даст результатов, +но вы можете задать что-то вроде: +\begin{quote} + |\DeclareCaptionLabelFormat{continued}{Continued #1~#2}|\\ + \ldots\\ + |\begin{longtable}{|\ldots|}|\\ + | \caption{A longtable}\\|\\ + |\endfirsthead|\\ + | \captionsetup{labelformat=continued}|\\ + | \caption[]{A longtable}\\|\\ + |\endhead|\\ + | |\ldots\\ + |\end{longtable}| +\end{quote} + % --------------------------------------------------------------------------- % -% \fi -% -% -%^^A \section{Useful stuff} -% \section{Полезные утилиты} -% \label{misc} -% -% \DescribeMacro{\caption} -%^^A The command -% Команда -% \nopagebreak[3] -% \begin{quote} -% |\caption|\oarg{lst\_entry}\marg{heading} -% \end{quote} -% \nopagebreak[3] -%^^A typesets the caption inside a floating environment like |figure| or |table|. -%^^A Well, you already know this, but the \thispackage\ package offers an extension: -%^^A If you leave the argument \meta{lst\_entry} empty, no entry in the list of -%^^A figures or tables will be made. For example: -% печатает подпись внутри окружения флота, типа |figure| или |table|. -% Так, это нам известно, но новость состоит в~том, что если -% задать аргумент \meta{lst\_entry} пустым, подпись в~списке рисунков или -% таблиц не появится; например, -% \begin{quote} -%^^A |\caption[]{A figure without entry in the list of figures.}| -% |\caption[]{Подпись без записи в списке рисунков.}| -% \label{TeXr:nolistentry:I} -% \end{quote} -% -% \DescribeMacro{\caption*}\label{TeXr:starcaption:a}%^^A -%^^A The \package{longtable} package defines the command |\caption*| which -%^^A typesets the caption without label and without entry in the list of tables. -%^^A An example: -% Пакет \package{longtable} определяет команду |\caption*| которая -% печатает подпись без метки и~занесения её в~список таблиц. -% Пример: -% \begin{quote} -% |\begin{longtable}{cc}|\\ -% | \caption*{Табличка}\\|\\ -% | A & B \\|\\ -% | C & D \\|\\ -% |\end{longtable}| -% \end{quote} -% выглядит следующим образом:\nopagebreak -% \begin{longtable}{cc} -% \caption*{Табличка}\\ -% A & B \\ -% C & D \\ -% \end{longtable} -% -%^^A This package offers this feature, too, so you can use this command now within -%^^A every floating environment like |figure| or |table|, like: -% Данный пакет тоже предлагает такую возможность. И~теперь вы можете использовать эту команду -% с~любым окружением плавающего объекта, например |figure| или |table|, как здесь: -% \begin{quote} -% |\begin{table}|\\ -% | \caption*{Табличка}|\\ -% | \begin{tabular}{cc}|\\ -% | A & B \\|\\ -% | C & D \\|\\ -% | \end{tabular}|\\ -% |\end{table}| -% \end{quote} -% -% \DescribeMacro{\captionof}%^^A -% \DescribeMacro{\captionof*}\label{TeXr:captiononof:a}%^^A -%^^A Sometimes you want to typeset a caption \emph{outside} a floating environment, -%^^A putting a figure within a |minipage| for instance. For this purpose the -%^^A \thispackage\ package offers the command -% Иногда вам нужно создать подпись \emph{вне} окружения флота, -% поместив, к~примеру, подпись внутри окружения |minipage|. Для этой цели пакет -% \thispackage\ предлагает команду -% \begin{quote} -% |\captionof|\marg{float type}\oarg{lst\_entry}\marg{heading}\quad. -% \end{quote} -%^^A Note that the first argument, the \meta{float type}, is mandatory here, because -%^^A the |\captionof| command needs to know which name to put into the caption label -%^^A (e.g. ``Figure'' or ``Table'') and in which list to put the contents entry. -%^^A An example: -% Обратите внимание, что первый аргумент, \meta{float type}, в~данном случае является -% обязательным, поскольку команда |\captionof| должна знать, к~какому плавающему -% объекту создать подпись (например. «Рис.» или «Таблица») и~в~какой список поместить -% подпись. Пример -% \begin{quote} -% |\captionof{figure}{Картинка}|\\ -% |\captionof{table}{Табличка}| -% \end{quote} -%^^A typesets captions like this: -% создаёт подписи как здесь: -% \begin{Example} -% \captionof{figure}{Картинка} -% \captionsetup{belowskip=\abovecaptionskip} -% \captionof{table}{Табличка} -% \end{Example} -% -%^^A The star variant |\captionof*| has the same behaviour as the |\caption*| command: -%^^A it typesets the caption without label and without entry to the list of figures -%^^A or tables. -% «Звёздный» вариант |\captionof*| даёт тот же результат, что и~|\caption*|: -% печатает подпись без нумерационного заголовка и~вывода в~список рисунков или -% таблиц. -% -%^^A Please use both |\captionof| and |\captionof*| only \emph{inside} environments -%^^A (like |minipage| or |\parbox|), otherwise a page break can appear between content -%^^A and caption. Furthermore some strange effects could occur (e.g., wrong spacing -%^^A around captions). -% Используйте обе команды, |\captionof| и~|\captionof*|, только в~окружениях -% (типа |minipage| или |\parbox|), иначе подпись может разорваться между страницами. -% Кроме этого могут возникнуть побочные эффекты (например, неверные отбивки -% вокруг подписи).\label{TeXr:captiononof:z}\label{TeXr:starcaption:z} -% -% \DescribeMacro{\ContinuedFloat}\label{TeXr:continued:a} -%^^A Sometimes you want to split figures or tables without giving them -%^^A their own reference number. This is what the command -% Иногда возникает необходимость разбить рисунки или таблицы на несколько -% частей, задав им общий номер. Для этого предназначена команда -% \begin{quote} -% |\ContinuedFloat|\quad. -% \end{quote} -%^^A is for; it should be used as first command inside the floating environment. -%^^A It prevents the increment of the relevant counter (usually done by |\caption|) -%^^A so a figure or table with a |\ContinuedFloat| in it gets the same reference -%^^A number as the figure or table before. -% Лучше её поставить первой внутри окружения флота. -% Команда |\ContinuedFloat| отменяет увеличение соответствующего счётчика флота -% (используемого командой |\caption|) -% и~задаёт тот же номер как и~у~рисунка или таблицы выше. -% -%^^A An example: -% Пример: -% \begin{quote} -% |\begin{table}|\\ -% |\caption{Табличка}|\\ -% \ldots\\ -% |\end{table}|\\ -% \ldots\\ -% |\begin{table}\ContinuedFloat|\\ -% |\caption{Табличка (продолжение)}|\\ -% \ldots\\ -% |\end{table}| -% \end{quote} -%^^A gives the following result: -% даст следующий результат: -% \begin{Example} -% \makeatletter\def\@captype{table}\makeatother -% \caption[]{Табличка} -% \centerline{\ldots} -% \ContinuedFloat -% \captionsetup{aboveskip=0pt} -% \caption[]{Табличка (продолжение)} -% \label{TeXr:continued:z} -% \end{Example} -% -% \DescribeMacro{\captionsetup} -%^^A We already know the |\captionsetup| command (see \Section{usage} -%^^A {Using the package}), but this time we get enlighten about -%^^A its optional argument \meta{float type}. -% Нам уже известна команда |\captionsetup| (см.~\Section{usage} -% {Использование пакета}), Но сейчас мы разберём значение -% дополнительного аргумента, \meta{float type}. -% -%^^A Remember, the syntax of this command is -% Напомним синтаксис этой команды -% \begin{quote} -% |\captionsetup|\oarg{float type}\marg{options}\quad. -% \end{quote} -% -%^^A If a \meta{float type} gets specified, all the \meta{options} don't -%^^A change anything at this time. Instead they only get marked for a later use, -%^^A when a caption inside of a floating environment of the particular type -%^^A \meta{float type} gets typeset. -%^^A For example -% Если \meta{float type} задан, все ключи и~опции, \meta{options} ничего -% не изменят в~месте задания. Они только определены для будущего использования, -% в~момент, когда подпись внутри окружения флота данного типа, -% \meta{float type}, будет напечатана. -% Например -% \begin{quote} -% |\captionsetup[figure]|\marg{options} -% \end{quote} -%^^A forces captions within a |figure| environment to use the given \meta{options}. -% определяет оформление \meta{options} для подписи внутри окружения |figure|. -% -%^^A Here comes an example to illustrate this: -% Далее идёт пример иллюстрирующий сказанное: -% \begin{quote} -% |\captionsetup{font=small}|\\ -% |\captionsetup[figure]{labelfont=bf}| -% \end{quote} -%^^A gives captions like this: -% создаст подписи вида: -% \begin{Example} -% \captionsetup{font=small} -% \captionsetup[figure]{labelfont=bf} -% \captionof{figure}[]{Картинка} -% \captionsetup{belowskip=\abovecaptionskip} -% \captionof{table}[]{Табличка} -% \end{Example} -% -%^^A As you see the command |\captionsetup[figure]{labelfont=bf}| only changed -%^^A the font of the figure caption labels, not touching all other ones. -% Как вы видите установка |\captionsetup[figure]{labelfont=bf}| изменяет -% только шрифт нумерационной части подписи, всё остальное остаётся. -% -% \DescribeMacro{\clearcaptionsetup} -%^^A If you want to get rid of these parameters marked for an automatic use within -%^^A a particular environment you can use the command -% Если вам внутри данного окружения нужно отменить параметры, заданные для -% текущего типа флота, используйте команду + +\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} -% |\clearcaptionsetup|\marg{float type}\quad. +% |\DeclareCaptionType{diagram}[Diagramm][Diagrammverzeichnis]| % \end{quote} % -%^^A For example |\clearcaptionsetup{figure}| would clear the extra handling in the -%^^A example above: -% Например |\clearcaptionsetup{figure}| отменит дополнительные настройки -% из примера выше: -% \begin{Example} -% \captionsetup{font=small} -% \captionof{figure}[]{Картика} -% \captionsetup{belowskip=\abovecaptionskip} -% \captionof{table}[]{Табличка} -% \end{Example} -% -%^^A As \meta{float type} you can usually give one of these two only: -%^^A |figure| or |table|. -%^^A But as we will see later some \LaTeX\ packages (like the -%^^A \package{float}, \package{longtable}, and \package{sidecap} package -%^^A for example) offer additional floating environments and these two -%^^A commands can also be used with them. -% В~качестве опции в~\meta{float type} вы можете обычно указывать два из них: -% |figure| или |table|. -% Но, как увидите позже, некоторые пакеты \LaTeX'а (как, например, -% \package{float}, \package{longtable}, и~\package{sidecap}) -% определяют дополнительные окружения и~эти две команды могут быть -% в~них использованы. -% -% \iffalse +Подобное же определение для русской документации должно выглядеть так: +\begin{quote} + |\DeclareCaptionType{diagram}[Диаграмма][Список диаграмм]| +\end{quote} + % --------------------------------------------------------------------------- % -% \fi -% -% -%^^A \section{Do it yourself!} -% \section{Делаем сами!} -% \label{declare} -% -%^^A A family of commands is provided to allow users to define their own formats. -%^^A This enables information on separators, justification, fonts, and styles to -%^^A be associated with a name and kept in one place -%^^A (these commands need to appear in the document preamble, -%^^A this is the part between |\documentclass| and |\begin{document}|). -% Имеется семейство команд, позволяющих пользователю самостоятельно -% создать собственное оформление. -% Это позволяет информацию о~разделителях, выключке, шрифтах, и~стилях -% привязать к~определённому ключу, и~поместить всё это в~одном месте -% (такие команды должны находиться в~преамбуле документа \cdash--- -% это часть между строками команд |\documentclass| и~|\begin{document}|). -% -% -% \DescribeMacro{\DeclareCaptionFormat} -%^^A You can define your own caption formats using the command -% Вы можете определить своё оформление подписи, используя команду -% \begin{quote} -% |\DeclareCaptionFormat|\marg{name}\marg{code using \#1, \#2 and \#3}\quad. -% \end{quote} -%^^A At usage the system replaces \#1 with the caption label, \#2 with the -%^^A separator and \#3 with the text. So the standard format |plain| is -%^^A pre-defined by the \thispackage\ package as -% При использовании пакет заменяет \#1 на нумерационный заголовок, \#2 на -% разделитель и~\#3 на текст подписи. Итак, стандартный формат |plain| определён -% внутри пакета \thispackage\ как -% \begin{quote} -% |\DeclareCaptionFormat{plain}{#1#2#3\par}| -% \end{quote} -% -% \DescribeMacro{\DeclareCaptionLabelFormat} -%^^A Likewise you can define your own caption label formats: -% Аналогично вы можете определить формат нумерационного заголовка: -% \begin{quote} -% |\DeclareCaptionLabelFormat|\marg{name}\marg{code using \#1 and \#2} -% \end{quote} -%^^A At usage \#1 gets replaced with the name (e.g. ``figure'') and \#2 -%^^A gets replaced with the reference number (e.g. ``12''). -% При использовании \#1 заменяется на имя флота (например. «Рис.») и~\#2 -% заменяется на порядковый номер (например «12»). -% -% \DescribeMacro{\bothIfFirst} -% \DescribeMacro{\bothIfSecond} -%^^A If you define your own caption label formats and use the \package{subfig} -%^^A package\cite{subfig}, you should take care of empty caption label names. -%^^A For this purpose the commands -% Когда вы определяете своё оформление нумерационного заголовка и~используете -% также пакет \package{subfig}, вы должны помнить что в~подфлотах элемент -% «имя флота» будет пустым. Для этой цели следующие команды -% \begin{quote} -% |\bothIfFirst|\marg{first arg}\marg{second arg}\quad и\\ -% |\bothIfSecond|\marg{first arg}\marg{second arg} -% \end{quote} -%^^A are offered. |\bothIfFirst| tests if the first argument exists (means: is -%^^A not empty), |\bothIfSecond| tests if the second argument exists. If yes, -%^^A both arguments get typeset, otherwise none of them. -% и~предложены. Команда |\bothIfFirst| тестирует наличие первого аргумента (что он -% непустой), команда |\bothIfSecond| тестирует наличие второго. Если тестируемый -% аргумент есть, то печатаются оба аргумента, в~противном случае ни одного. -% -%^^A For example the standard label format |simple| is \emph{not} defined as -% Например, стандартное оформление нумерации |simple| определено не так: -% \begin{quote} -% |\DeclareCaptionLabelFormat{simple}{#1 #2}|\quad, -% \end{quote} -%^^A because this could cause an extra space if \#1 is empty. Instead |simple| -%^^A is defined as -% поскольку аргумент \#1 может быть пустым. Вместо этого |simple| -% определён следующим образом -% \begin{quote} -% |\DeclareCaptionLabelFormat{simple}{\bothIfFirst{#1}{ }#2}|\quad, -% \end{quote} -%^^A causing the space to appear only if the label name is present. -% в~результате пробел появится только тогда, когда есть имя нумерационного -% заголовка. -% -% -% \DescribeMacro{\DeclareCaptionLabelSeparator} -%^^A You can define your own caption label separators with -% Можно определить свой разделитель номера и~текста подписи с~помощью -% команды -% \begin{quote} -% |\DeclareCaptionLabelSeparator|\marg{name}\marg{code}\quad. -% \end{quote} -% \nopagebreak[3] -%^^A Again an easy example taken from the \thispackage\ package itself: -% И~опять простой пример из самого пакета \thispackage: -% \nopagebreak[3] -% \begin{quote} -% |\DeclareCaptionLabelSeparator{colon}{: }| -% \end{quote} -% -% -% \DescribeMacro{\DeclareCaptionJustification} -%^^A You can define your own caption justifications with -% Вы можете определить собственную выключку с~помощью команды -% \begin{quote} -% |\DeclareCaptionJustification|\marg{name}\marg{code}\quad. -% \end{quote} -%^^A The \meta{code} simply gets typeset just before the caption. -%^^A E.g.~using the justification |raggedright|, which is defined as -% Аргумент \meta{code} задаёт выключку до начала подписи. -% Например использование выключки |raggedright|, которая определена как -% \begin{quote} -% |\DeclareCaptionJustification{raggedright}{\raggedright}|\quad, -% \end{quote} -%^^A lets captions with all lines moved to the left margin. -% выключает все строки подписи к~левому полю. -% -% \DescribeMacro{\DeclareCaptionFont} -%^^A You can define your own caption fonts with -% Вы можете задать свой шрифт для подписи с~помощью -% \begin{quote} -% |\DeclareCaptionFont|\marg{name}\marg{code}\quad. -% \end{quote} -%^^A For example this package defines the options |small| and |bf| as -% Например данный пакет определяет опции |small| и~|bf| как -% \begin{quote} -% |\DeclareCaptionFont{small}{\small}|\quad и\\ -% |\DeclareCaptionFont{bf}{\bfseries}|\quad. -% \end{quote} -%^^A The line spacing could be customized using the \package{setspace} package, -%^^A for example:\NEWdescription{v3.0h} -% Интерлиньяж может быть настроен с~помощью пакета \package{setspace}, -% например:\NEWdescription{v3.0h} -% \begin{quote} -% |\usepackage{setspace}|\\ -% \iffalse -%^^A |\DeclareCaptionFont{singlespacing}{\setstretch{1}}|\quad\footnote{% -%^^A \emph{Note:} Using \cs{singlespacing} does not work here since it contains -%^^A a \cs{vskip} command.}\\ -% |\DeclareCaptionFont{singlespacing}{\setstretch{1}}|\quad\footnote{% -% \emph{Примечание:} Использование \cs{singlespacing} в данном случае -% не работает поскольку содержит команду \cs{vskip}.}\\ -% |\DeclareCaptionFont{onehalfspacing}{\onehalfspacing}|\\ -% |\DeclareCaptionFont{doublespacing}{\doublespacing}|\\ -% \fi -% |\captionsetup{font={onehalfspacing,small},labelfont=bf}| -% \end{quote} -% \example{font={onehalfspacing,small},labelfont=bf,singlelinecheck=off}\figuretext -%^^A An example which brings color into life: -% Пример использования цвета: -% \begin{quote} -% |\usepackage{color}|\\ -% |\DeclareCaptionFont{red}{\color{red}}|\\ -% |\DeclareCaptionFont{green}{\color{green}}|\\ -% |\DeclareCaptionFont{blue}{\color{blue}}|\\ -% |\captionsetup{labelfont=blue,textfont=green}| -% \end{quote} -% \example{labelfont=blue,textfont=green,singlelinecheck=off}\figuretext -% -% \DescribeMacro{\DeclareCaptionStyle} -%^^A You can define your own caption styles with -% Вы можете определить свои собственные стили с~помощью -% \begin{quote} -% |\DeclareCaptionStyle|\marg{name}\oarg{additional options}\marg{options} -% \end{quote} -%^^A Remember, caption styles are just a collection of suitable options, saved -%^^A under a given name. You can wake up these options at any time with the -%^^A option |style=|\meta{style name}. -% Вспомним, что стили подписи это коллекция ключей, сохранённых -% под данным именем. Вы можете привести их в~действие с~помощью ключа -% |style=|\meta{style name}. -% -%^^A All caption styles are based on the default set of options. (See \Section -%^^A {style}{Styles} for a complete list.) So you only need -%^^A to specify options which are different to them. -% Все стили подписей базируются на установках по умолчанию. (См. полный список -% в~\Section {style}{Стили}.) Поэтому достаточно определить опции, отличные -% от уже заданных. -% -%^^A If you specify \meta{additional options} they get used in addition when -%^^A the caption fits into a single line and this check was not disabled with -%^^A the option |singlelinecheck=off|. -% Если вы определите \meta{additional options} они будут использоваться когда -% подпись будет однострочной, и~контроль коротких подписей не отключен -% заданием опции |singlelinecheck=off|. -% -%^^A Again a very easy example taken from the core of this package: The -%^^A caption style |default| is pre-defined as -% Опять же очень простой пример из самого |caption.sty|: -% \begin{quote} -% |\DeclareCaptionStyle{default}[justification=centering]{}| -% \end{quote} -% -% \iffalse + +% \subsection{Further examples} +\subsection{Ещё несколько примеров} +\label{examples} + +\subsubsection*{Example 1} + +%\NEWdescription{v3.1} +% If you would like to have a line break between caption label and text +% you could define it this way: +Если вам нужно задать новую строку между нумерационным заголовком и~текстом, +вы можете задать это следующим образом: +\begin{quote} + |\DeclareCaptionFormat{myformat}{#1#2\\#3}| +\end{quote} +% If you select this format with |\caption|\-|setup{format=|\x|myformat}| +% you get captions like this: +Если вы выберете этот формат, задав |\caption|\-|setup{format=|\x|myformat}| +вы получите такой вид подписей: +%\begin{Example} +% \captionsetup{skip=0pt} + \example{format=myformat1,labelfont=bf}{\exampletext} +%\end{Example} +% You could even use an indention with this caption format: +Вы можете использовать втяжку с~этим форматом: +\begin{quote} + |\captionsetup{format=myformat,indention=1cm}| +\end{quote} +% This would look like this: +Это будет выглядеть так: +%\begin{Example} +% \captionsetup{skip=0pt} + \example{format=myformat1,indention=1cm,labelfont=bf}{\exampletext} +%\end{Example} +% Instead, you would like to have an indention only of the first line of +% the caption text? No problem, e.g. +А~что если, вместо этого, задать втяжку только для первой строки подписи? +Нет проблем, например +\begin{quote} + |\newlength\myindention|\\ + |\DeclareCaptionFormat{myformat}%|\\ + | {#1#2\\\hspace*{\myindention}#3}|\\ + \ldots\\ + |\setlength\myindention{1cm}|\\ + |\captionsetup{format=myformat}| +\end{quote} +% would give you captions like +даст подпись вида +%\begin{Example} +% \captionsetup{skip=0pt} + \example{format=myformat2,myindention=1cm,labelfont=bf}{\exampletext} +%\end{Example} +% But you want to have an caption option for this indention, so you can use +% it for example with +% |\caption|\-|setup|\x|[figure]|\x|{my|\-|indention=|\x\ldots|}|? +% This could be done, too: +Но вы хотите создать опцию для этой втяжки, для того, чтобы +использовать её как |\captionsetup|\x|[figure]|\x|{myindention=|\ldots|}|? +Это тоже можно сделать: +\begin{quote} + |\newlength\myindention|\\ + |\DeclareCaptionOption{myindention}%|\\ + | {\setlength\myindention{#1}}|\\ + |\DeclareCaptionFormat{myformat}%|\\ + | {#1#2\\\hspace\myindention #3}|\\ + \ldots\\ + |\captionsetup{format=myformat,myindention=1cm}| +\end{quote} +% would give the same result as the example above. +что даст результат аналогичный приведённому выше. + +% \subsubsection*{Example 2} +\subsubsection*{Пример 2} + +% You want captions to look like this: +Вы хотите получить подписи такого вида: +%\begin{Example} +% \captionsetup{skip=0pt} + \example{format=reverse,labelformat=fullparens,labelsep=fill,labelfont=it}{\exampletext} +%\end{Example} +\pagebreak[2] +% You could do it this way: +Это можно сделать следующим образом: +\nopagebreak[3] +\begin{quote} + |\DeclareCaptionFormat{reverse}{#3#2#1}|\\ + |\DeclareCaptionLabelFormat{fullparens}%|\\ + | {(\bothIfFirst{#1}{~}#2)}|\\ + |\DeclareCaptionLabelSeparator{fill}{\hfill}|\\ + |\captionsetup{format=reverse,labelformat=fullparens,|\\ + | labelsep=fill,font=small,labelfont=it}| +\end{quote} + +% \subsubsection*{Example 3} +\subsubsection*{Пример 3} + +% The caption text should go into the left margin? A possible solution would be: +Текст нумерационного заголовка подписи должен быть выведен в~левое поле? Возможное решение: +\begin{quote} + |\DeclareCaptionFormat{llap}{\llap{#1#2}#3\par}|\\ + |\captionsetup{format=llap,labelsep=quad,singlelinecheck=no}| +\end{quote} +% As a result you would get captions like this: +В~результате вы получите такие подписи: +\example{format=llap,labelsep=quad,singlelinecheck=no,margin=0pt}{\exampletext} + +\medskip + +% If the indention into the margin shall be fixed, you could use a combination +% of |\llap| and |\makebox|, for example: +Если левый край подписи при выходе подписи на поля должен быть на фиксированном расстоянии, +можно использовать комбинацию команд +|\llap| и~|\makebox|, например: +\begin{quote} + |\DeclareCaptionFormat{llapx}%|\\ + | {\llap{\makebox[5em][l]{#1}}#3\par}|\\ + |\captionsetup{format=llapx,singlelinecheck=off}| +\end{quote} +\example{format=llapx,singlelinecheck=off,skip=0pt,margin=0pt}{\exampletext} + +% \subsubsection*{Example 4} +\subsubsection*{Пример 4} + +% This example puts a figure aside a table, but uses only one common caption for both. +% This will be achieved by a combination of +% |\Declare|\-|Caption|\-|Label|\-|Format| and |\caption|\-|list|\-|entry|: +Следующий пример помещает рисунок рядом с~таблицей, но использует общую для них подпись. +Это можно сделать комбинацией команд +|\Declare|\-|Caption|\-|Label|\-|Format| и~|\caption|\-|list|\-|entry|: +\begin{quote} + |\DeclareCaptionLabelFormat{andtable}%|\\ + | {#1~#2 \& \tablename~\thetable}|\\ + \ldots\\ + |\begin{figure}|\\ + | \centering|\\ + | \includegraphics{|\ldots|}%|\\ + | \qquad|\\ + | \begin{tabular}[b]{\ldots}|\\ + | |\ldots\\ + | \end{tabular}|\\ + | \captionlistentry[table]{|\ldots|}|\\ + | \captionsetup{labelformat=andtable}|\\ + | \caption{|\ldots|}|\\ + |\end{figure}| +\end{quote} +\DeleteShortVerb{\|}% +\noindent\begin{minipage}{\linewidth} + \captionsetup{type=figure} + \centering + \includegraphics[width=30pt]{cat}% + \qquad + \begin{tabular}[b]{r|rr} + & x & y \\\hline + a & 1 & 2 \\ + b & 3 & 4 \\ + \end{tabular} +% \captionlistentry[table]{A figure and a table with a common caption} +% \captionsetup{labelformat=andtable} +% \caption{A figure and a table with a common caption~\footnotemark} + \captionlistentry[table]{Рисунок и~таблица с~общей подписью} + \captionsetup{labelformat=andtable} + \caption{Рисунок и~таблица с~общей подписью\footnotemark} +\end{minipage} +% \footnotetext{The picture was taken with permission from the +% \LaTeX\ Companion\cite{TLC2} examples.} +\IfFileExists{cat.eps}% +{\footnotetext{Рисунок любезно предоставлен из примеров книги + \LaTeX\ Companion\cite{TLC2}.}}{} +\MakeShortVerb{\|} +% (Please remember that |\caption|\-|list|\-|entry| increments the figure +% resp.~table counter.) +(Напомним, что команда |\caption|\-|list|\-|entry|, как и~|\caption|, увеличивает счётчик флота.) + + % --------------------------------------------------------------------------- % -% \fi -% -%^^A \subsection{Further Examples} -% \subsection{Ещё несколько примеров} -% -%^^A If you would like to have a colon \emph{and} a line break as caption -%^^A separator you could define it this way: -% Если вам нужно точка и новая строка как разделитель между номером и~текстом -% определите это так: -% \begin{quote} -% |\DeclareCaptionLabelSeparator{period-newline}{. \\}| -% \end{quote} -%^^A Selecting this separator with |\captionsetup{labelsep=period-newline}| you -%^^A get captions like this: -% Задав этот разделитель как |\captionsetup{labelsep=period-newline}| вы -% получите следующую подпись: -% \begin{Example} -% \captionsetup{labelsep=period-newline,labelfont=bf,margin=10pt} -% \captionsetup{aboveskip=0pt,type=figure} -% \caption[]{\figuretext} -% \end{Example} -% -%^^A For short captions---which fit into one single line---this separator -%^^A may not be satisfying, even when the automatically centering process -%^^A is switched off (with |singlelinecheck=off|): -% Для кратких подписей \cdash--- которые помещаются на одной строке \cdash--- такой -% разделитель не годится, даже если отменено автоматическое центрирование -% (с~помощью |singlelinecheck=off|): -% \begin{Example} -% \captionsetup{labelsep=period-newline,labelfont=bf,margin=10pt,singlelinecheck=0} -% \captionsetup{aboveskip=0pt,type=figure} -% \caption[]{Картинка.} -% \end{Example} -% -%^^A An own caption style which selects another caption separator automatically -%^^A puts this right: -% Специальный стиль, который определяет другой разделитель автоматически -% возвращает всё на места: -% \begin{quote} -% |\DeclareCaptionStyle{period-newline}%|\\ -% | [labelsep=period]{labelsep=period-newline}| -% \end{quote} -% \begin{Example} -% \captionsetup{style=period-newline,labelfont=bf,margin=10pt} -% \captionsetup{aboveskip=0pt,type=figure} -% \ContinuedFloat -% \caption[]{Картинка.} -% \end{Example} -%^^A If you would like to keep the centering of these captions instead, an -%^^A appropriate definition would be something like -% Если вы предпочтёте оставить центрирование короткой строки -% нужно определить -% \begin{quote} -% |\DeclareCaptionStyle{period-newline}%|\\ -% | [labelsep=period,justification=centering]%|\\ -% | {labelsep=period-newline}|\quad. -% \end{quote} -%^^A Using this definition short captions look like -% При этом определении короткие подписи будут выглядеть так -% \begin{Example} -% \captionsetup{style=period-newline2,labelfont=bf,margin=10pt} -% \captionsetup{aboveskip=0pt,type=figure} -% \ContinuedFloat -% \caption[]{Картинка.} -% \end{Example} -%^^A while long ones still have a line break after the caption label. -% в~то же время длинные подписи сохранят разрыв после номера флота. -% -%^^A Slightly changed, you also get centered captions if they are longer than -%^^A one line: -% Чуть изменив стиль, вы получите и~длинные подписи центрированными: -% \begin{quote} -% |\DeclareCaptionStyle{period-newline}%|\\ -% | [labelsep=period]%|\\ -% | {labelsep=period-newline,justification=centering}| -% \end{quote} -% \begin{Example} -% \captionsetup{style=period-newline3,labelfont=bf,margin=10pt} -% \captionsetup{aboveskip=0pt,type=figure} -% \caption[]{\figuretext} -% \end{Example} -% -% \bigskip -%^^A Another example: You want captions to look like this: -% Другой пример: вы хотите получить такие подписи: -% \begin{Example} -% \captionsetup{format=reverse,labelformat=fullparens,labelsep=fill,font=small,labelfont=it} -% \captionsetup{aboveskip=0pt} -% \captionof{figure}[]{\figuretext} -% \end{Example} -% \pagebreak[2] -%^^A You could do it this way: -% Вы должны задать их следующим образом: -% \nopagebreak[3] -% {\leftmargini=10pt -% \begin{quote} -% |\DeclareCaptionFormat{reverse}{#3#2#1}|\\ -% |\DeclareCaptionLabelFormat{fullparens}{(\bothIfFirst{#1}{ }#2)}|\\ -% |\DeclareCaptionLabelSeparator{fill}{\hfill}|\\ -% |\captionsetup{format=reverse,labelformat=fullparens,|\\ -% | labelsep=fill,font=small,labelfont=it}| -% \end{quote}} -% -% \bigskip\pagebreak[3] -%^^A Another example: The caption text should go into the left margin; a possible -%^^A solution would be: -% Ещё пример: поместить нумерационный заголовок подписи на левом поле; возможное решение: -% {\leftmargini=10pt -% \begin{quote} -% |\DeclareCaptionFormat{llap}{\llap{#1#2}#3\par}|\\ -% |\captionsetup{format=llap,labelsep=quad,singlelinecheck=no}| -% \end{quote}} -%^^A As a result you would get captions like this: -% В~результате вы получите такую подпись: -% \begin{Example} -% \captionsetup{format=llap,singlelinecheck=no,labelsep=quad} -% \captionsetup{aboveskip=0pt} -% \captionof{figure}[]{\figuretext} -% \end{Example} -% -% \iffalse + +\clearpage +% \section{Document classes \& Babel support} +\section{Классы документов и~поддержка пакета \package{babel}} +\label{classes} + +% This section will give you an overview of the document classes the +% \package{caption} supports, what do they already offer regarding captions, +% what side effects will occur when using the \package{caption} package with +% them, and what are the `default' settings for them. +Этот раздел даст обзор классов документов, которые поддерживаются пакетом +\package{caption}, что они уже предлагают для работы с~подписями, +какие побочные эффекты возникают при использовании с~ними пакета \package{caption} +и~каковы установки по умолчанию для этих классов. + +\NEWfeature{v3.1} +% The `default' settings depend on the document class you use; they represent +% how the class author wanted the captions to look like. So for example +% setting |format=|\x|default| can give you different visual designs when used +% with different document classes. +Установки по умолчанию зависят от класса документа, используемого вами; они представляют +оформление подписей, соответствующее замыслам автора данного класса документа. Например, настройки +|format=|\x|default| дадут различный результат при использовании с~разными классами. + +\begingroup\setlength\leftmargini{0.3em}% default = 2.5em +\INFO +% If you don't find the document class you use in this section, you usually +% don't have to worry: Many document classes (e.g.~the \class{octavo} class) +% are derived from one of the standard document classes \class{article}, +% \class{report}, or \class{book}, and behave the same regarding captions. +% \Thispackage\ automatically does a compatibility check against the document +% class used and will give you the clear warning +Если вы не нашли класс документа в~этом разделе, то, обычно, это не повод для волнения: +множество классов документов (например, класс \class{octavo}) +получены из стандартных классов документов +\class{article}, \class{report} или \class{book}, и~имеют +аналогичные настройки для подписей. +\Thispackage\ автоматически делает проверку совместимости класса документа +и~даёт недвусмысленное предупреждение +\begin{quote}\footnotesize + |Package caption Warning: Unsupported document class (or package) detected,|\\ + |(caption) usage of the caption package is not recommended.|\\ + |See the caption package documentation for explanation.| +\end{quote} +% if such an incompatibility was detected. +% If you don't get such warning everything is fine, but if you get it the +% usage of \thispackage\ is not recommended and especially not supported. +если была определена несовместимость. +Если вы такого предупреждения не получили, то всё в~порядке, но если вы это предупреждение +всё же получили, \thispackage\ не рекомендуется и~тем более не поддерживается. + +\begin{Expert} +% If you get such a compatibility warning but decide to use \thispackage{} +% anyway, you should watch carefully what side-effects occur, usually the +% look and feel of your captions will change by just including \thispackage{} +% without options, meaning they do not look like as intended by the author +% of the document class. +% If this is fine for you, you should first specify the option |style=|\x|base| +% via |\use|\-|package[style=|\x|base]{caption}| or +% |\caption|\-|setup{style=|\x|base}| to set \thispackage\ into a well-defined +% state. +% Afterwards you can start setting your own options additionally and +% keep your fingers crossed. +Если вы, несмотря на предупреждение, решили всё равно использовать \thispackage{}, +вы должны проверить, какой побочный эффект возникает. Обычно подключенный \thispackage{} +безо всяких опций в~таких случаях изменяет вывод подписей, и~они выглядят не так, как +предусмотрено автором класса документа. +Если это вас удовлетворяет, вы можете для начала задать ключ |style=|\x|base|, +задав его в~строке |\use|\-|package[style=|\x|base]{caption}| или в~команде +|\caption|\-|setup{style=|\x|base}|, что вернёт хорошо настроенные пакетом установки. +После этого вы можете задавать свои опции и~надеяться на лучшее. +\end{Expert} +\endgroup + +\newcommand*\Option{Опция} +\newcommand*\defaultvalue{значение \texttt{по умолчанию}} +\newcommand*\uses{\textit{использует}} +\newcommand*\settings{\textit{настройки}} +\newcommand*\nofont{\textit{отсутствует}} + +% \subsection{Standard \LaTeX: article, report, and book} +\subsection{Стандартный \LaTeX: article, report, и~book} + +\begin{tabular}{ll} +\Option & \defaultvalue \\\hline +|format=| & |plain| \\ +|labelformat=| & |simple| \\ +|labelsep=| & |colon| \\ +|justification=| & |justified| \\ +|font=| & \nofont \\ +|labelfont=| & \nofont \\ +|textfont=| & \nofont \\ +\end{tabular} + +\begin{Annotation} +% This also applies to document classes derived from them. +Это относится и~к~производным от них классам. +\end{Annotation} + +% \subsection{\AmS: amsart, amsproc, and amsbook} +\subsection{Классы \AmS: amsart, amsproc, и~amsbook} +\label{AMS} + +\begin{tabular}{ll} +\Option & \defaultvalue \\\hline +|format=| & |plain| \\ +|labelformat=| & |simple| \\ +|labelsep=| & |.\enspace| \\ +|justification=| & |justified| \\ +|font=| & |\@captionfont| \\ +|labelfont=| & |\@captionheadfont| \\ +|textfont=| & |\@captionfont\upshape| \\ +\end{tabular} + +\begin{Annotation*} +% |\@caption|\-|font| will be set to |\normal|\-|font|, and +% |\@caption|\-|head|\-|font| to |\sc|\-|shape| by the \AmS\ document classes. +Классы \AmS\ определяют команду |\@caption|\-|font|, которая задаётся как +|\normal|\-|font|, а~|\@caption|\-|head|\-|font| \cdash--- как |\scshape|. +\end{Annotation*} + +% Furthermore the margin will be set to |\caption|\-|indent| for +% more-than-one-line captions (which will be set to |3pc| by the \AmS\ classes), +% the margin for single-line captions will be set to the half of it instead. +% If you want to use a common margin for both, insert +% |\clear|\-|caption|\-|setup[margin*]{single|\-|line}| +% into the preamble of your document, after loading \thispackage. +Кроме этого поле принимает значение |\captionindent| в~многострочных подписях +(которое равно в~этих классах~|3pc|), +поле для однострочной подписи уменьшается в~два раза. +Если вы хотите задать общее поле для обоих вариантов, добавьте в~преамбуле документа +|\clear|\-|caption|\-|setup[margin*]{single|\-|line}| +после загрузки пакета. + +% Additionally the options |figure|\-|position=b,|\x|table|\-|position=t| +% will be set. You can override these settings by specifying other values for +% |figure|\-|position=| or |table|\-|position=| in the option list while +% loading \thispackage. +Дополнительно задаются опции |figure|\-|position=b,|\x|table|\-|position=t|. +Вы можете изменить эти установки, задав другие значения для ключей +|figure|\-|position=| или |table|\-|position=| при загрузке пакета. + +\subsection{Класс beamer} +\label{beamer} + +\begin{tabular}{ll} +\Option & \defaultvalue \\\hline +|format=| & |plain| \\ +|labelformat=| & \textit{не нумеруется} \\ +|labelsep=| & |colon| \\ +|justification=| & |raggedright| \\ +|font=| & \class{beamer} «|caption|» \settings \\ +|labelfont=| & \class{beamer} «|caption name|» \settings \\ +|textfont=| & \nofont \\ +\end{tabular} + +% \subsubsection*{Build-in features, and side-effects} +% You can setup font and color settings with +% |\set|\-|beamer|\-|font{caption}|\marg{options} and +% |\set|\-|beamer|\-|font{caption name}|\marg{options}. +% This will still work, unless you set a different font with +% |\caption|\-|setup{font=|\x\meta{options}|}| or +% |\caption|\-|setup{label|\-|font=|\x\meta{options}|}|.\par +% Furthermore the \class{beamer} classes offer different caption templates +% which can be chosen with +% |\set|\-|beamer|\-|template|\x|{caption}|\x|[|\meta{template}|]|. +% Since \thispackage\ replaces this caption template mechanism, +% |\def|\-|beamer|\-|template*|\x|{caption}|\x\marg{template code} +% and +% |\set|\-|beamer|\-|template|\x|{caption}|\x|[|\meta{template}|]| +% will have no effect when \thispackage\ is used. +\subsubsection*{Встроенные особенности и~побочные эффекты} +Вы можете задать шрифт и~цвет с~помощью +|\set|\-|beamer|\-|font{caption}|\marg{options} и~% +|\set|\-|beamer|\-|font{caption name}|\marg{options}. +Это будет работать, если только вы не зададите другой шрифт через +|\caption|\-|setup{font=|\x\meta{options}|}| или +|\caption|\-|setup{label|\-|font=|\x\meta{options}|}|.\par +Кроме этого класс \class{beamer} предлагает различные шаблоны +оформления подписей, задаваемые через +|\set|\-|beamer|\-|template|\x|{caption}|\x|[|\meta{template}|]|. +Поскольку \thispackage\ заменяет этот механизм, команды +|\def|\-|beamer|\-|template*|\x|{caption}|\x\marg{template code} +и~|\set|\-|beamer|\-|template|\x|{caption}|\x|[|\meta{template}|]| +не имеют силы при его использовании. + +% \subsection{\KOMAScript: scrartcl, scrreprt, and scrbook} +\subsection{Классы \KOMAScript: scrartcl, scrreprt, и~scrbook} +\label{KOMA} + +\begin{tabular}{ll} +\Option & \defaultvalue \\\hline +% |format=| & \uses\ |\setcapindent| \textit{\&} |\setcaphanging| \settings \\ +|format=| & \uses\ |\setcapindent| и~|\setcaphanging| \settings \\ +% |labelformat=| & \textit{like \purett{simple}, but with support of ``autodot''}\\ +|labelformat=| & \textit{то же, что \purett{simple}, но с~поддержкой ``autodot''}\\ +|labelsep=| & |\captionformat| \\ +|justification=| & |justified| \\ +|font=| & \settings\ |\setkomafont{caption}| \\ +|labelfont=| & \settings\ |\setkomafont{captionlabel}| \\ +|textfont=| & \nofont \\ +\end{tabular} + +% \subsubsection*{Build-in features} +% The \KOMAScript\ document classes offer many ways to customize the look and +% feel of the captions. For an overview and a full description please take a +% look at the \KOMAScript\ documentation, section `Tables and Figures'. +\subsubsection*{Встроенные возможности} +Классы \KOMAScript\ предлагают много вариантов для настройки вывода +подписей. Полный обзор вы можете найти в~[английской] документации +\KOMAScript, раздел `Tables and Figures'. + +% \subsubsection*{Side effects} +% The optional argument of |\set|\-|cap|\-|width| is not supported and +% will be ignored if used in conjunction with the \package{caption} package. +% Furthermore the \KOMAScript\ options |table|\-|caption|\-|above| \& +% |table|\-|caption|\-|below| and the commands |\caption|\-|above| \& +% |\caption|\-|below| are stronger than the |position=| setting offered by +% the \package{caption} package. +\subsubsection*{Побочные эффекты} +Дополнительный аргумент команды |\setcapwidth| не поддерживается (пока) +и~будет игнорироваться при совместном использовании с~пакетом \package{caption}. +Помимо этого, опции \KOMAScript\ |tablecaptionabove| и~% +|table|\-|caption|\-|below| и~команды |\caption|\-|above| и~|\caption|\-|below| +будут сильнее чем настройки ключа |position=| предлагаемого пакетом \package{caption}. + +% \subsection{\NTG: artikel, rapport, and boek} +\subsection{Классы \NTG: artikel, rapport, и~boek} +\label{NTG} + +\begin{tabular}{ll} +\Option & \defaultvalue \\\hline +|format=| & |plain| \\ +|labelformat=| & |simple| \\ +|labelsep=| & |colon| \\ +|justification=| & |justified| \\ +|font=| & \nofont \\ +|labelfont=| & |\CaptionLabelFont| \\ +|textfont=| & |\CaptionTextFont| \\ +\end{tabular} + +% \subsubsection*{Build-in features, and side-effects} +% |\Caption|\-|Label|\-|Font| and |\Caption|\-|Text|\-|Font| can be set either +% directly or by using |\Caption|\-|Fonts|. +% Both is still supported unless you use one of the two options +% |label|\-|font=| or |text|\-|font=| offered by \thispackage. +\subsubsection*{Встроенные особенности и~побочные эффекты} +|\CaptionLabelFont| и~|\Caption|\-|Text|\-|Font| могут быть +заданы либо непосредственно, либо +с~использованием команды |\Caption|\-|Fonts|. Оба варианта +поддерживаются, только если не был +задан один из ключей |labelfont=| или |textfont=| данного пакета. + +% \subsection{\SmF{}: smfart and smfbook} +\subsection{Классы \SmF{}: smfart и~smfbook} +\label{SMF} + +% Since the \SmF\ document classes are derived from the \AmS\ document classes +% the same default values are valid here. +Поскольку классы \SmF\ являются производными классов \AmS, то те же ограничения +действуют и~здесь. + +% Additionally the margin is limited up to the tenth of the |\line|\-|width|. +% If you don't like this limitation, you can switch it off with the option +% |max|\-|margin=|\x|off| or |max|\-|margin=|\x|false| +% (which both means the same). +Кроме того размер поля ограничен одной десятой от значения |\linewidth|. +Если вас не устраивают эти ограничения, их можно отключить с~помощью +|maxmargin=|\x|off| или |maxmargin=|\x|false| (оба варианта дают одно и~то же). + +\subsection{Класс thesis} +\label{thesis} + +\begin{tabular}{ll} +\Option & \defaultvalue \\\hline +|format=| & |hang| \\ +% |labelformat=| & \textit{like \purett{simple}, but with short name}\\ +|labelformat=| & \textit{то же, что \purett{simple}, но с~кратким именем}\\ +|labelsep=| & |colon| \\ +|justification=| & |justified| \\ +|font=| & \nofont \\ +|labelfont=| & |\captionheaderfont| \\ +|textfont=| & |\captionbodyfont| \\ +\end{tabular} + +% \subsubsection*{Build-in features, and side-effects} +\subsubsection*{Встроенные особенности и~побочные эффекты} +% The caption label font can be set with |\caption|\-|header|\-|font|, +% the caption text font with |\caption|\-|body|\-|font|. +% Both is still supported unless you use one of the two options +% |label|\-|font=| or |text|\-|font=| offered by \thispackage. +Шрифт нумерационного заголовка может быть задан через команду |\caption|\-|header|\-|font|, +шрифт для текста подписи \cdash--- через |\caption|\-|body|\-|font|. +Обе команды поддерживаются, только если вы не использовали опции +|label|\-|font=| или |text|\-|font=|, которые предлагает \thispackage. + +% \subsection{frenchb Babel option} +\subsection{Опция frenchb пакета Babel} +\label{frenchb} + +% If you use the \package{frenchb} option of the \package{babel} package +% with one of the three standard \LaTeX{} classes (or a one derived from them) +% the default |label|\-|sep=| will be set to |\Caption|\-|Sep|\-|a|\-|ra|\-|tor| +% (offered by \package{frenchb}), overriding the default value set by the +% document class. +% So redefining |\Caption|\-|Sep|\-|a|\-|ra|\-|tor| will still work, unless you +% don't select a different |label|\-|sep=| than the default one. +Если вы используете опцию \package{frenchb} пакета \package{babel} +с~одним из трёх стандартных классов \LaTeX'а (или их производными) +значение по умолчанию ключа |labelsep=| [опция |labelsep=default|] будет использовать +значение команды |\Caption|\-|Sep|\-|a|\-|ra|\-|tor| (предлагаемой +пакетом \package{frenchb}), заменив значение по умолчанию, заданное классом. +А~переопределённая команда |\Caption|\-|Sep|\-|a|\-|ra|\-|tor| +будет работать до тех пор, пока вы +не определите другое значение |labelsep=|, отличающееся от значения по умолчанию. + +\INFO* +% Please load \thispackage\ \emph{after} the \package{babel} package. +Пожалуйста загружайте \thispackage\ \emph{после} пакета \package{babel}. + +% \subsection{frenchle and frenchpro packages} +\subsection{Пакеты frenchle и~frenchpro} +\label{frenchpro} + +% If you use the \package{frenchle} or \package{frenchpro} package, +% the default |label|\-|sep=| will be set to |\caption|\-|sep|\-|a|\-|ra|\-|tor| +% (offered by \package{frenchle/pro}) plus \cs{space}, overriding the default +% value set by the document class. +% So redefining |\caption|\-|sep|\-|a|\-|ra|\-|tor| will still work, unless you +% don't select a different |label|\-|sep=| than the default one. +Если вы используете пакеты \package{frenchle} или \package{frenchpro}, +значение по умолчанию |label|\-|sep=| определит значение команды +|\caption|\-|sep|\-|a|\-|ra|\-|tor| (предлагаемой +пакетами \package{frenchle/pro}) плюс \cs{space}, заменив значение, заданное классом +по умолчанию. +Поэтому переопределение |\caption|\-|sep|\-|a|\-|ra|\-|tor| +работает до тех пор, пока вы +не определите другое значение |labelsep=|, отличающееся от значения по умолчанию. + +% Furthermore the default |text|\-|font=| will be set to |text|\-|font=|\x|it|, +% since this emulates the default setting of |\caption|\-|font| defined by the +% \package{frenchle} or \package{frenchpro} package. +% %If you redefine |\captionfont| after loading the \package{frenchle} or +% %\package{frenchpro} package, this redefinition gets lost. +Помимо этого ключ по умолчанию |text|\-|font=| будет задан как |text|\-|font=|\x|it|, +поскольку это эмулирует настройки команды |\caption|\-|font| определённой пакетами +\package{frenchle} или \package{frenchpro}. +% %Если вы переопределите команду |\captionfont| после загрузки \package{frenchle} или +% %\package{frenchpro}, это переопределение пропадёт. +% Please note that the command |\caption|\-|font| is used by the +% \package{caption} package internally for a different purpose, +% so you should not change it (anymore). +Обратите внимание, что команда |\caption|\-|font| используется пакетом +\package{caption} для других целей, поэтому лучше ею больше не пользоваться. + +% The command |\un|\-|numbered|\-|captions|\marg{figure \emph{or} table} will +% still work, but only unless you don't select a different |label|\-|format=| +% than the default one. +Команда |\un|\-|numbered|\-|captions|\marg{figure \emph{или} table} будет работать, +но только, если вы не определили ключ |label|\-|format=|, отличающийся +от значения по умолчанию. + +\INFO* +% Please load \thispackage\ \emph{after} the \package{frenchle} +% or \package{frenchpro} package. +Пожалуйста, загружайте \thispackage\ \emph{после} пакетов \package{frenchle} +или \package{frenchpro}. + % --------------------------------------------------------------------------- % -% \fi -% -% \pagebreak[1] -%^^A \section{Using non-standard document classes} -% \section{Использование нестандартных классов документа} -% -% \NEWdescription{v3.0p} -%^^A% The \thispackage\ package was developed using the standard document classes -%^^A% |article|, |report| and |book|, it also works with the Dutch document classes -%^^A% |artikel|, |rapport| and |boek|. It is \emph{incompatible} with all other -%^^A% document classes, except the ones based on one of the above. -% Пакет \thispackage\nopagebreak\ настроен на использование со стандартными классами -% |article|, |report| и~|book|, он также работает с~классами для немецких публикаций -% |artikel|, |rapport| и~|boek|. -% -%^^A% If you are unsure if your document class is supported or not, it's better -%^^A% \emph{not} to use this package. You could try if your document will compile -%^^A% fine with the \thispackage\ package anyway, but you should watch carefully -%^^A% if side-effects occur, i.e. the look and feel of your captions should -%^^A% \emph{not} change if you just include the caption package without options. -%^^A% (If it does, you can carry on, but you should be warned that the output -%^^A% could change with upcoming versions of the \thispackage\ package.) -%^^A% If this is fine, you can start setting options with -%^^A% |\usepackage[|\ldots|]{caption}| or |\captionsetup| and keep your fingers -%^^A% crossed. -% Если вы не уверены поддерживается ли ваш класс документа или нет, -% лучше данный пакет не использовать. Вы в~любом случае можете попробовать -% обработать свой документ с~пакетом \thispackage, но в~этом случае внимательно -% проверьте, есть ли побочные эффекты, т.\,е. при подключённом без опций пакете -% и~без него вид подрисуночных подписей \emph{не} должен меняться. -% (Если это происходит, можете продолжить, но знайте, что следующие версии -% пакета \thispackage\ могут изменить вывод вашего документа.) -% Если всё прекрасно, можно теперь задать опции, используя -% |\usepackage[|\ldots|]{caption}| или |\captionsetup| и~надеяться на лучшее. -% -%^^A% The upcoming version \version{3.1} of the \thispackage\ package will be -%^^A% adapted to several document classes, e.g. the \package{beamer} class and -%^^A% the \KOMAScript\ ones. It's planned for release during Summer 2007. -% Следующая версия \version{3.1} пакета \thispackage\ будет работать с~такими классами, -% как \package{beamer} и~классы \KOMAScript. Выход версии планируется на лето 2007\,г. -% + +\pagebreak[4] +% \section{Package support} +\section{Поддержка пакетов} +\label{packages} +\label{compatibility} + +%\NEWdescription{v3.1} +% \Thispackage\ was adapted to the following packages which deals with +% captions, too: +\Thispackage\ адаптирован с~пакетами, которые также работают с~подрисуночными подписями: +\begin{quote} + \package{float}, \package{floatflt}, \package{fltpage}, + \package{hyperref}, \package{hypcap}, \package{listings}, + \package{longtable}, \package{picinpar}, \package{picins}, + \package{rotating}, \package{setspace}, \package{sidecap}, + \package{subfigure}, \package{supertabular}, \package{threeparttable}, + \package{wrapfig}, and \package{xtab} +\end{quote} + +% Furthermore the \package{floatrow} package\cite{floatrow}, the +% \package{subcaption} package (which is part of the \package{caption} package +% bundle), and the \package{subfig} package\cite{subfig} support \thispackage{} +% and use its |\caption|\-|setup| interface. +Помимо этого пакеты \package{floatrow}\cite{floatrow}, +пакет \package{subcaption} (является частью группы пакетов \package{caption}), +и~пакет \package{subfig}\cite{subfig} +поддерживают \thispackage\ и~используют интерфейс |\caption|\-|setup|. + +\begingroup\setlength\leftmargini{0.3em}% default = 2.5em +\INFO +% If a package (or document class) unknown to \thispackage\ redefines +% the |\caption| command as well, this redefinition will be preferred +% over the one this package offers, providing maximum compatibility and +% avoiding conflicts. +% If such a potential incompatibility is detected, you will see this +% warning message:~\footnote{% +% You can suppress this warning by specifying the option +% \texttt{compatibility=true} when loading \thispackage.} +Если пакет (или класс документа), неизвестный данному пакету, переопределяет +команду |\caption|, это переопределение будет более предпочтительно по +сравнению с~тем что предлагает \thispackage, что создаст максимум совместимости +и~даст возможность избежать последствий конфликтов. +Если потенциальная несовместимость будет обнаружена, вы увидите следующее +предупреждение:\footnote{% + Вы можете запретить это предупреждение, задав опцию \texttt{compatibility=true} + при загрузке данного пакета.} +\begin{quote}\footnotesize + |Package caption Warning: \caption will not be redefined since it's already|\\ + |(caption) redefined by a document class or package which is|\\ + |(caption) unknown to the caption package.|\\ + |See the caption package documentation for explanation.| +\end{quote} +\endgroup + +% As a result, the following features offered by \thispackage\ will not be available: +В~результате, следующие настройки, которые предлагает \thispackage, +не будут работать: +\begin{itemize} +% \item the options |labelformat=|, |position=auto|, |list=|, and |listformat=| +% \item |\caption*| (to produce a caption without label) +% \item |\caption[]{|\ldots|}| (to produce no entry in the List of Figures or Tables) +% \item |\caption{}| (to produce an empty caption without label separator) +% \item |\ContinuedFloat| +% \item correctly justified captions in environments like \texttt{wide} and +% \texttt{addmargin} which add extra margins +% \item the \textsf{hypcap} feature \See{\Ref{hyperref}\,} +% \item the sub-caption feature \See{\package{subcaption} package documentation} + \item опции |labelformat=|, |position=auto|, |list=| и~|listformat=| + \item |\caption*| (создание подписи без нумерационного заголовка) + \item |\caption[]{|\ldots|}| (отключение вывода в~Список флотов) + \item |\caption{}| (создание подписи без разделителя между нумерационным заголовком и~текстом) + \item |\ContinuedFloat| + \item правильная выключка подписей в~окружениях типа \texttt{wide} и~\texttt{addmargin}, + которые добавляют дополнительные поля + \item опция \textsf{hypcap} \See{\Ref{hyperref}\,} + \item возможность создания подподписи \See{документацию к~пакету \package{subcaption}} +\end{itemize} + +\DescribeMacro{compatibility=} +% You can override this compatibility mode by specifying the option +Вы можете отключить такой режим совместимости, задав +\begin{quote} + |compatibility=false| +\end{quote} +% when loading \thispackage. +% But please note that using this option is neither recommended nor supported +% since unwanted side-effects or even errors could occur afterwards. +% (For that reason you will get a warning about this.) +при загрузке пакета. +Но обратите внимание, что использование этой опции и~не рекомендуется, и~не поддерживается +поскольку могут возникнуть побочные эффекты и~даже ошибки. +(По этому поводу вы как раз уже получили предупреждение.) + +\newcommand\packagedescription[1]{% + \ifvmode\else\par\fi + \nopagebreak + \parbox[b]{\linewidth}{\footnotesize\leftskip=10pt\rightskip=10pt\relax#1}\par + \nopagebreak\smallskip\nopagebreak} + +\pagebreak[3] +\subsection{Пакет algorithms} +\label{algorithms} +\packagedescription{% +% The \package{algorithms} package bundle\cite{algorithms} provides two +% environments: The \texttt{algorithmic} environment provides a possibility +% for describing algorithms, and the \texttt{algorithm} environment provides +% a ``float'' wrapper for algorithms.} +Группа пакетов \package{algorithms}\cite{algorithms} предлагает два окружения: +Окружение \texttt{algorithmic} предлагает возможность для записи алгоритмов, +а~\texttt{algorithm} \cdash--- «плавающий» вариант алгоритмов.} + +% Since the \texttt{algorithm} environment is implemented via |\new|\-|float| +% provided by the \package{float} package\cite{float}, please see \Ref{float}. +Поскольку окружение \texttt{algorithm} задаётся через команду |\new|\-|float|, +предлагаемую пакетом \package{float}\cite{float}, ознакомьтесь с~\Ref{float}. + +\iffalse +\pagebreak[3] +\subsection{Пакет algorithm2e} +\label{algorithm2e} +\packagedescription{% +% The \package{algorithm2e} package\cite{algorithm2e} offers an environment for +% writing algorithms in LaTeX2e.} +Пакет \package{algorithm2e}\cite{algorithm2e} предлагает окружение для +записи алгоритмов в~LaTeX2e.} + +% Since the \package{algorithm2e} package does not use some kind of standard +% interface for defining its floating environment (e.g.~|\newfloat| of the +% \package{float} package) and typesetting its caption, +% the \package{algorithm2e} package is \emph{not} supported by \thispackage. +Поскольку пакет \package{algorithm2e} не использует стандартный интерфейс для +определения собственного окружения флота (например, команду~|\newfloat| из пакета +\package{float}) и~создания подписи, +пакет \package{algorithm2e} \emph{не} поддерживается данным пакетом. +% +% So if you want to customize the captions using \thispackage, +% you have to build a new environment which uses a supported interface regarding +% floats (e.g. using the \package{float} or \package{floatrow} package), +% and combine this environment with the internal \package{algorithm2e} code. +Поэтому, если вам нужно настроить подписи используя \thispackage, +вы должны сами создать новое окружение, используя поддерживаемый интерфейс работы с~флотами +(например, используя пакеты \package{float} или \package{floatrow}), +и~скомбинировать это окружение с~кодом пакета \package{algorithm2e}. +% +% As first step you could define a non-floating environment \texttt{algorithmic}, +% for example: +Сначала вы должны определить неплавающее окружение \texttt{algorithmic}, +например: +\begin{quote} + |\usepackage{algorithm2e}|\\ + |% save the "algorithm" environment from the algorithm2e package|\\ + |\let\ORIGalgorithm\algorithm|\\ + |\let\ORIGendalgorithm\endalgorithm|\\ + |% define the algorithmic environment|\\ % , based on the saved environment + |\newenvironment{algorithmic}%|\\ + | {\renewenvironment{algocf}[1][h]{}{}% pass over floating stuff|\\ + | \ORIGalgorithm}%|\\ + | {\ORIGendalgorithm}|\\ + \ldots +\end{quote} +% Having defined this non-floating environment, you could define your own new +% floating environment with |\newfloat| of the \package{float} package +% (or |\DeclareNewFloatType| of the \package{floatrow} package), +% and use the combination of this floating environment and \texttt{algorithmic} +% in its body, just like you would do when you use the +% \package{algorithm}/\package{algorithmic} package tandem. +Определив такое неплавающее окружение, +вы можете определить своё собственное окружение флота с~помощью команды |\newfloat| пакета +\package{float}, (или |\DeclareNewFloatType| пакета \package{floatrow}), +и~использовать комбинацию этого окружения флота и~окружения +\texttt{algorithmic} внутри него, аналогично тому, как это используется +при тандеме пакетов +\package{algorithm}/\package{algorithmic}. + +% You could even use the \package{algorithm} package for this purpose, for example: +Вы можете использовать для этих целей пакет \package{algorithm}, например: +\begin{quote} + \ldots\\ + |% load the algorithm package to re-define the|\\ + |% floating environment "algorithm" and \listofalgorithms|\\ + |\let\listofalgorithms\undefined|\\ + |\usepackage{algorithm}|\\ + \ldots\\ + |% Example usage:|\\ + |\begin{algorithm}|\\ + |\caption{An algorithm}|\\ + |\begin{algorithmic}|\\ + | \SetVline|\\ + | \eIf{cond1}{|\\ + | a line\;|\\ + | }{|\\ + | another line\;|\\ + | }|\\ + |\end{algorithmic}| +\end{quote} +% Now you are finally able to customize the float and caption layout like every +% other floating environment defined with the \package{float} package\cite{float}, +% please see \Ref{float}. +Теперь вы можете создать настройки для содержимого флота и~его подписи, аналогично любому другому +окружению флота, определённому пакетом \package{float} package\cite{float}, +см.~\Ref{float}. + +% \begin{Annotation} +% An alternative would be using the \package{algorithmicx} package. +В~качестве альтернативы можно использовать пакет \package{algorithmicx}. +% \end{Annotation} +\fi + +\pagebreak[3] +\subsection{Пакет float} +\label{float} +\packagedescription{% +% The \package{float} package\cite{float} introduces the commands +% \cs{restylefloat} to give existing floating environments a new look \& feel +% and \cs{newfloat} to define new floating environments. +% It also provides the ``\texttt{H}'' float placement option which places +% the environments ``here'' instead of letting them floating around.} +Пакет \package{float}\cite{float} предлагает команды +\cs{restylefloat} для переопределения уже существующего макета флота +и~\cs{newfloat} для определения новых окружений флотов. +Также он предлагает специальную опцию размещения флота \texttt{H}, которая помещает +флот «здесь», отключив плавание флота.} + +% For floating environments defined with \cs{newfloat} or \cs{restylefloat} the +% |po|\-|si|\-|tion| option has no effect on the main caption anymore, since its +% placement and spacing will be controlled by the selected float style instead. +Для окружений флотов, определённых с~помощью команд \cs{newfloat} или +\cs{restylefloat} опция +|po|\-|si|\-|tion| не имеет эффекта, так как механизм размещения и~расстановок +отбивок контролируется стилем флота пакета \package{float}. + +% A caption style and options defined with the name of the float style will be +% executed additionally to the regular ones. +% Using this mechanism \thispackage\ emulates the default look \& feel of the +% |ruled| captions: It defines the caption style +Стили подписи и~ключи ассоциированные с~названием данного стиля флота +включаются при запуске данного окружения. +Используя этот механизм \thispackage\ эмулирует вывод подписей в~стиле +|ruled|: он определяет стиль подписи +\begin{quote} + |\DeclareCaptionStyle{ruled}%|\\ + | {labelfont=bf,labelsep=space,strut=off}|\mbox{\quad.} +\end{quote} +% So to change this you need either define your own caption style called +% |ruled| or use |\caption|\-|setup[ruled]|\marg{options} to specify additional +% options.%, +%e.g.~|\caption|\-|setup[ruled]{labelsep=|\x|colon}|. +Так, чтобы изменить это вы можете либо определить свой стиль подписи, названный +|ruled| или использовать |\caption|\-|setup[ruled]|\x\marg{options} и~определить +дополнительные опции.%, + +% Also by using this mechanism the skip between a |boxed| float and its caption +% is specified, overriding its global value: +Также, используя этот механизм, отбивка между флотом в~рамке (|boxed|) и~его +подписью переопределяет значение: +\begin{quote} + |\captionsetup[boxed]{skip=2pt}| +\end{quote} +% For changing this, just use |\caption|\-|setup[boxed]{skip=|\x\meta{value}|}| +% with an appropriate value. Or if you want to use the global |skip| setting +% instead, you can remove the usage of the local setting for these floats with +% |\clear|\-|caption|\-|setup[skip]{boxed}|. +Для изменения этого, используйте |\caption|\-|setup[boxed]{skip=|\x\meta{value}|}| +с~соответствующим значением. Или, если вам нужно вместо этого использовать общие +(глобальные) установки ключа |skip|, +вы можете отменить использование локального определения, задав +|\clear|\-|caption|\-|setup[skip]{boxed}|. + +\begin{Note} +% Only one single caption can be typeset inside environments defined with +% |\new|\-|float| or |\re|\-|style|\-|float|, furthermore these environments +% are not behaving exactly like the pre-defined floats |figure| and |table|. +% As a consequence many packages do not cooperate well with these. +% Furthermore the \package{float} package has some caveats \& limitations, +% so if you just want to define a new simple floating environment---behaving +% like |figure| or |table|---I recommend using |\Declare|\-|Caption|\-|Type| +% instead. +% And for defining non-simple floating environments and customization I +% recommend using |\Declare|\-|New|\-|Float|\-|Type| offered by the +% \package{floatrow} package\cite{floatrow}. +Внутри окружений определённых командами |\new|\-|float| или |\re|\-|style|\-|float| +можно задать только одну подрисуночную подпись, кроме того +эти окружения работают не так, как +определённые в~стандартном \LaTeX'е |figure| и~|table|. +В~результате множество пакетов не может быть кооперироваться с~данным пакетом. +Более того пакет \package{float} имеет некоторые недостатки и~ограничения, поэтому, если +вам нужно определить новое окружение, работающее как +|figure| или |table| \cdash--- я рекомендовал бы для этого использовать команду +|\Declare|\-|Caption|\-|Type|. +А~для определения других окружений флотов и~их настройки можно +использовать команду |\Declare|\-|New|\-|Float|\-|Type| из пакета +\package{floatrow}\cite{floatrow}. +\end{Note} + +\iffalse +% Please also note that you \emph{don't} need a |\restyle|\-|float| for using +% the ``|H|'' float placement specifier. Some docs say so, but they are +% wrong. +% And |\restyle|\-|float{table}| is a very good method to shoot yourself +% in the foot, since many packages using |table| internally are not working +% correctly afterwards. +Обратите внимание, что вам \emph{не} нужно задавать |\restyle|\-|float| для использования +опции размещения «|H|». Некоторые руководства советуют это, но это неверно. +А~задание |\restyle|\-|float{table}| хороший способ сбить себя с~ног, +поскольку многие пакеты, использующие в~своих макрокомандах окружение |table| перестают +работать. +\fi + +\pagebreak[3] +\subsection{Пакет floatflt} +\label{floatflt} +\packagedescription{% +% The \package{floatflt} package\cite{floatflt} offers figures and tables +% which do not span the full width of a page and are float around by text.} +Пакет \package{floatflt}\cite{floatflt} предлагает окружения небольших +рисунков и~таблиц, +обтекаемых текстом.} + +\NEWfeature{v3.1} +% If you want to setup special options for the |float|\-|ing|\-|figure| and +% |float|\-|ing|\-|table| environments you can use +Если вы хотите задать специальные опции для окружений |floating|\-|figure| +и~|floating|\-|table|, +можно задать +\begin{quote} + |\captionsetup[floatingfigure]|\marg{options}\quad\emph{и}\\ + |\captionsetup[floatingtable]|\marg{options}\quad. +\end{quote} +% These options will be executed additionally to the regular ones for +% |figure| resp.~|table|. +Эти опции будут добавлены соответственно к~основным для |figure| или |table|. + +\begin{Note} +% The |margin| resp.~|width| setting will not be used for these figures resp.~tables, +% unless you set it explicit with |\caption|\-|setup[floating|\-|figure]{|\ldots|}| +% resp.~|\caption|\-|setup[floating|\-|table]{|\ldots|}|. +Настройки ключей |margin| или |width| не используются для таких рисунков или таблиц, +только если вы не зададите их строго, +внутри |\caption|\-|setup[floating|\-|figure]{|\ldots|}| или +|\caption|\-|setup[floating|\-|table]{|\ldots|}|. +\end{Note} + +\pagebreak[3] +\subsection{Пакет fltpage} +\label{fltpage} +\packagedescription{% +% The \package{fltpage} package\cite{fltpage} offers the outhouse of the +% caption for |figure|s or |table|s which needs the whole page +% for its contents. This will be done by placing the caption on the bottom +% of the previous or next page.} +Пакет \package{fltpage}\cite{fltpage} предлагает внешнюю подпись для флотов +|figure| или |table|, содержимое которых занимает целую страницу. +Подпись при этом размещается на предыдущей или следующей странице [на развороте].} + +\NEWfeature{v3.1} +% Two options control the links to the environments |FPfigure| and |FPtable|: +Следующие ключи контролируют ссылки на окружения |FPfigure| и~|FPtable|: +\begin{description} +% \item{\texttt{FPlist=caption} or \texttt{FPlist=figure}}\\[\smallskipamount] +% If set to |caption|, the list entry will link to the caption; if set to +% |figure|, it will link to the figure contents. +% (The default setting is |FP|\-|list=|\x|caption|.) +% \item{\texttt{FPref=caption} or \texttt{FPref=figure}}\\[\smallskipamount] +% If set to |caption|, a \cs{ref}, \cs{pageref}, \cs{autoref}, or \cs{nameref} +% will link to the caption; if set to |figure|, it will link to the figure contents. +% (The default setting is |FP|\-|ref=|\x|figure|.) + \item{\texttt{FPlist=caption} или \texttt{FPlist=figure}}\\[\smallskipamount] +Если определена опция |caption|, ссылка в~Списке рисунков будет относиться к~подписи; а~если +|figure| \cdash--- то к~содержимому флота. +(Значение по умолчанию |FPlist=|\x|caption|.) +\item{\texttt{FPref=caption} или \texttt{FPref=figure}}\\[\smallskipamount] +Если определена опция |caption|, ссылки \cs{ref}, \cs{pageref}, \cs{autoref}, или \cs{nameref} +будут привязаны к~подписи; а~если |figure| \cdash--- то к~содержимому флота. +(Значение по умолчанию |FPref=figure|.) +\end{description} + +% If you want to setup special options for the |FPfigure| and |FPtable| +% environments you can use +Если вы хотите задать специальные настройки для окружений |FPfigure| и~|FPtable| +вы можете использовать +\begin{quote} + |\captionsetup[FPfigure]|\marg{options}\quad\emph{и}\\ + |\captionsetup[FPtable]|\marg{options}\quad. +\end{quote} +% These options will be executed additionally to the regular ones for +% |figure| or |table|. +Эти опции будут заданы дополнительно к~основным настройкам для +|figure| или |table|. + +% Furthermore |\Declare|\-|Caption|\-|Type|\marg{name} will also define +% an environment called |FP|\meta{name} which behaves like |FP|\-|figure| and +% |FP|\-|table|. +Помимо этого команда \cs{DeclareCaptionType}\marg{name} также определит +окружение |FP|\meta{name}, которое будет аналогично |FPfigure| и~|FPtable|. + +\pagebreak[3] +\subsection{Пакет hyperref} +\label{hyperref} +\packagedescription{% +% The \package{hyperref} package\cite{hyperref} is used to handle cross +% referencing commands in LaTeX to produce hypertext links in the document.} +Пакет hyperref\cite{hyperref} используется для управления командами перекрёстных ссылок +в~\LaTeX'е для создания гипертекстовых ссылок внутри документа.} + +\NEWfeature{v3.1} +% There are two options available to control the placement of hyperlink +% anchors:~\footnote{These options are named after the \package{hypcap} package +% which they supersede.} +Существуют два ключа, контролирующих размещение гиперссылок:\footnote{Эти +опции названы по пакету \package{hypcap}, который они заменяют.} +\begin{description} +% \item{\texttt{hypcap=true} or \texttt{hypcap=false}}\\[\smallskipamount] +% If set to |true| all hyperlink anchors -- where entries in the +% List of Figures, |\ref|, and |\auto|\-|ref| will link to -- are placed at +% the beginning of the (floating) environment.\par +% If set to |false| the hyperlink anchor is (usually) placed at the caption.\par +% (The default setting is |hypcap=|\x|true|.) +\item{\texttt{hypcap=true} или \texttt{hypcap=false}}\\[\smallskipamount] +Если задана опция |true| все гиперссылки \cdash--- записи в~Списках рисунков (таблиц), +команды |\ref| и~|\autoref| \cdash--- будут привязаны +к~началу окружения флота.\par +Если задана опция |false| гиперссылки (обычно) привязываются к~подписи.\par +(Значение по умолчанию |hypcap=true|.) +% \item{\texttt{hypcapspace=}\meta{amount}}\\[\smallskipamount] +% Because it looks poor if the hyperlink points exactly at the top of +% the figure or table, you can specify a vertical distance between +% the hyperlink anchor and the (floating) environment itself, +% e.g.~|hyp|\-|cap|\-|space=|\x|0pt| removes this distance.\par +% (The default setting is |hypcapspace=0.5\baselineskip|.) +\item{\texttt{hypcapspace=}\meta{amount}}\\[\smallskipamount] +Поскольку это выглядит плохо, если гиперссылка попадает точно вверх рисунка или таблицы, +вы можете задать специальный параметр расстояния между привязкой гиперссылки +и~окружением флота, +например, |hyp|\-|cap|\-|space=|\x|0pt| убирает это расстояние.\par +(Значение по умолчанию |hypcapspace=0.5\baselineskip|.) +\end{description} + +% Both settings have no effect in |lst|\-|listing|s (provided by the +% \package{listings} package), |long|\-|table|s (provided by the +% \package{longtable} package), |super|\-|tabular|s (provided by the +% \package{supertabular} package), and |x|\-|tabular|s (provided by the +% \package{xtab} package), within these environments hyperlink +% anchors will always be placed as if |hyp|\-|cap=|\x|true| and +% |hyp|\-|cap|\-|space=|\x|0pt| would be set. +Обе настройки не имеют эффекта в~окружениях |lstlisting| (предлагаемом пакетом +\package{listings}), |longtable| (предлагаемом пакетом +\package{longtable}), |super|\-|tabular| (предлагаемом пакетом +\package{supertabular}) и |xtabular| (предлагаемом пакетом \package{xtab}), +внутри этих окружений гиперссылки всегда будут заданы так, +будто заданы опции |hyp|\-|cap=|\x|true| и~|hyp|\-|cap|\-|space=|\x|0pt|. + +%\pagebreak[3]Please note:\nopagebreak +\pagebreak[3]Обратите внимание:\nopagebreak +\begin{description} +% \item{\cs{captionof}\marg{type}\csmarg{\purerm\ldots} +% vs.~\cs{captionsetup}\csmarg{type=\textrm{\meta{type}}}$+$\cs{caption}\csmarg{\purerm\ldots}}% +% \\[\smallskipamount] +% Without \package{hyperref} loaded, both will give you identical results. +% But with \package{hyperref} loaded, and with |hyp|\-|cap=|\x|true| requested, +% the hyperlink anchor will be placed different. +% For example: +\item{\cs{captionof}\marg{type}\csmarg\ldots\ и~% + \cs{captionsetup}\csmarg{type=\textrm{\meta{type}}}$+$\cs{caption}\csmarg\ldots}\\[\smallskipamount] +Без пакета \package{hyperref}, дадут вам идентичные результаты. +Но с~загруженным пакетом \package{hyperref}, и~с~опцией |hypcap=|\x|true|, +гиперссылка будет другой. Например: +\begin{quote} +|\begin{minipage}{\linewidth}|\\ +| |\ldots\\ +| \captionof{figure}{A figure}|\\ +|\end{minipage}| +\end{quote} +% will place the hyperlink anchor at the caption. +% (And if |hyp|\-|cap=|\x|true| is set, you will get a warning about this.) +% But +Поместит гиперссылку в~подпись. +(А~если задана опция |hyp|\-|cap=|\x|true|, вы получите предупреждение.) +Но +\begin{quote} +|\begin{minipage}{\linewidth}|\\ +| \captionsetup{type=figure}|\\ +| |\ldots\\ +| \caption{A figure}|\\ +|\end{minipage}| +\end{quote} +% will place the hyperlink anchor at the beginning of the |mini|\-|page|, +% since |\caption|\-|setup{type=|\x|figure}| does not only set the caption type +% to ``figure'' but does place a hyperlink anchor, too. +поместит гиперссылку в~начало окружения |mini|\-|page|, +поскольку команда |\caption|\-|setup|\x|{type=|\x|figure}| не только задаёт настройки для +флота «figure», но также помещает гиперссылку. + +% \item{\cs{caption}\csoarg{}\csmarg{\purerm\ldots} +% vs.~\cs{captionsetup}\csmarg{list=false}$+$\cs{caption}\csmarg{\purerm\ldots}}\\[\smallskipamount] +\item{\cs{caption}\csoarg{}\csmarg\ldots\ и~% + \cs{captionsetup}\csmarg{list=false}$+$\cs{caption}\csmarg\ldots}\\[\smallskipamount] +% Again, without \package{hyperref} loaded, both will give you identical results. +% But with \package{hyperref} loaded, the difference is in the nuances. +% So for example the optional argument of |\caption| will also be written to +% the |aux| file, and will be used by the |\name|\-|ref| command. +% So if you choose to use |\caption| with empty optional argument, +% |\name|\-|ref| will also give you an empty result. +% So it's better to use |\caption|\-|setup{list=|\x|false}| if you don't +% want an entry in the List of Figures or List of Tables. +Опять же, без пакета \package{hyperref}, оба варианта дадут одинаковый результат. +А~с~загруженным пакетом \package{hyperref}, отличие будет в~нюансах. +Так, например, дополнительный аргумент команды |\caption| также будет записан в~% +|aux|-файл, и~также будет использоваться команда |\name|\-|ref|. +Поэтому, если вы используете команду подписи~|\caption| с~пустым дополнительным аргументом, команда +|\name|\-|ref| также даст вам «пустой» результат. +Поэтому лучше использовать \cs{captionsetup}\csmarg{list=false}, если вам не нужно +записывать рисунок в~Список рисунков или таблиц. +\end{description} + +\pagebreak[3] +\subsection{Пакет hypcap} +\label{hypcap} +\packagedescription{% +% The \package{hyp\-cap} package\cite{hypcap} offers a solution to the problem +% that links to a float using \package{hyper\-ref} may anchors to the caption +% rather than the beginning of the float. +% Since \thispackage\ \version{3.1} already solves this problem for itself, +% the \package{hypcap} package is usually not needed.} +% %, at least when you use \thispackage.} +Пакет \package{hypcap}\cite{hypcap} предлагает решение проблем, связанных с~флотами +при использовании пакета \package{hyperref}, который помещает гиперссылки в~подпись, +а~не в~начало флота. +Поскольку \thispackage\ \version{3.1} уже решил эту проблему своими средствами, +пакет \package{hypcap} обычно не нужен.% +% , когда вы используете +% \thispackage. +} + +% If the \package{hyp\-cap} package is loaded additionally to the +% \package{hyper\-ref} package, it takes over the control of the hyperlink +% anchor placement from \thispackage, overriding the options |hyp|\-|cap=| +% and |hyp|\-|cap|\-|space=|. +Если пакет \package{hypcap} загружен дополнительно к~пакету \package{hyperref}, +то контроль за гиперссылками переходит от пакета \package{caption} к~нему, +перекрывая опции ключей |hypcap=| и~|hyp|\-|cap|\-|space=|. + +% So for a manual placement of hyperlink anchors +% |\caption|\-|setup{type=|\x\meta{type}|}| is not sufficient anymore, +% instead you need to use |\cap|\-|start| (provided by the \package{hyp\-cap} +% package) for this. +Поэтому для ручного размещения гиперссылки |\caption|\-|setup{type=|\x\meta{type}|}| +уже не годится, и~вместо этого вы должны использовать команду |\capstart| +(предлагаемую пакетом \package{hypcap}). + +% Regarding the automatically placement the \package{hypcap} package offers good +% placement of hyperlink anchors for the floating environments |figure| and +% |table| only. In contrast the |hypcap=|\x|true| option of \thispackage\ also +% offers good placements of hyperlink anchors for +% |floating|\-|figure|s (provided by the \package{float\-flt} package), +% |FP|\-|figure|s \& |FPtable|s (provided by the \package{flt\-page} package), +% |fig|\-|window|s (provided by the \package{pic\-in\-par} package), +% |par|\-|pic|s (provided by the \package{pic\-ins} package), +% |SC|\-|figure|s (provided by the \package{side\-cap} package), +% |three|\-|part|\-|table|s (provided by the \package{three\-part\-table} package), +% and |wrapfigure|s (provided by the \package{wrap\-fig} package).%---% +% %so by loading the \package{hypcap} package additionally you will +% %loose that. +При автоматическом размещении гиперссылок, пакет \package{hypcap} задаёт верное +размещение только для окружений |figure| и~% +|table|. В~то время как опция ключа |hypcap=true| пакета \package{caption}, предлагает также +корректное размещения ссылок для окружений +|floating|\-|figure| (предлагаемого пакетом \package{floatflt}), +|FPfigure| и~|FPtable| (предлагаемых пакетом \package{fltpage}), +|figwindow| (предлагаемого пакетом \package{picinpar}), +|parpic| (предлагаемого пакетом \package{picins}), +|SCfigure| (предлагаемого пакетом \package{sidecap}), +|three|\-|part|\-|table| (предлагаемого пакетом \package{threeparttable}), +и~|wrap|\-|figure| (предлагаемого пакетом \package{wrapfig}).%---% +%поэтому, загружая пакет \package{hypcap}, вы теряете эти возможности. + +\pagebreak[3] +\subsection{Пакет listings} +\label{listings} +\packagedescription{% +% The \package{listings} package\cite{listings} typesets programming code.} +Пакет \package{listings}\cite{listings} помогает распечатать программный код.} + +% If you want to setup special options for the |lst|\-|listing| environment +% you can use +Если вы желаете создать специальные опции для окружения |lstlinsting| +вы можете использовать +\begin{quote} + |\captionsetup[lstlisting]|\marg{options}\quad. +\end{quote} + +% Please note that the \package{listings} package has its very own options +% for controlling the position and the skips of the caption: +% |caption|\-|pos=|, |above|\-|caption|\-|skip=|, and |below|\-|caption|\-|skip=|. +% \See{\package{listings} documentation for details.} +% These \package{listings} options override the \package{caption}'s ones, but +% can be again overwritten by |\caption|\-|setup[lst|\-|listing]{|\ldots|}|, +% e.g.%~ +Обратите внимание, что пакет \package{listings} имеет собственные опции +для контроля расположения отбивок вокруг подписи: +|caption|\-|pos=|, |above|\-|caption|\-|skip=|, и~|below|\-|caption|\-|skip=|. +\See{подробнее в~документации пакета \package{listings}.} +Опции пакета \package{listings} переопределяют опции \package{caption}, но +могут быть в~свою очередь переписаны с~помощью настроек +|\caption|\-|setup[lst|\-|listing]{|\ldots|}|, +например, +\begin{quote}|\caption|\-|setup[lst|\-|listing]{skip=|\x|10pt}|\quad.\end{quote} + +\pagebreak[3] +\subsection{Пакет longtable} +\label{longtable} +\packagedescription{% +% The \package{longtable} package\cite{longtable} offers an environment +% which behaves similar to the \texttt{tabular} environment, but the table +% itself can span multiple pages.} +Пакет \package{longtable}\cite{longtable} предлагает окружение, +которое работает аналогично \texttt{tabular}, но табличный материал может занимать +несколько страниц.} + +% If you want to setup special options for the |long|\-|table| environment +% you can use +Если вы желаете создать специальные настройки для окружения |long|\-|table| +вы можете использовать +\begin{quote} + |\captionsetup[longtable]|\marg{options}\quad. +\end{quote} +% These options will be executed additionally to the regular ones for +% |table|. +Эти опции будут добавлены к~основным настройкам для +|table|. + +% The |margin| and |width| settings usually override |\LT|\-|cap|\-|width|, +% so you get an equal look \& feel of the captions in |table|s and +% |long|\-|table|s. +% But if you set |\LT|\-|cap|\-|width| to a value different than its default +% $=$ |4in|, \thispackage\ will follow that. +% (But |\LT|\-|cap|\-|width| will be overwritten by +% |\caption|\-|setup[long|\-|table]{width=|\x\meta{value}|}|, +% even if it is set to a value different than |4in|.) +Настройки ключей |margin| и~|width| обычно перекрывают значение команды +|\LTcapwidth|, поэтому +вы можете получить идентичное оформление для подписей в~окружениях |table| и~% +|longtable|. +Но если вы зададите значение |\LT|\-|cap|\-|width| отличное от заданного по умолчанию, +что равно ${}={}$|4in|, \thispackage\ будет использовать это значение. +(Но |\LTcapwidth| будет переписано последующей настройкой +|\caption|\-|setup[long|\-|table]{width=|\x\meta{value}|}|, даже если оно задано +отличным от~|4in|.) + +\begin{Note} +% |\caption|\-|of| and |\Continued|\-|Float| do \emph{not} work for |long|\-|table|s. +% Furthermore neither |\caption| nor |\caption|\-|list|\-|entry| will increment +% the |table| counter here; it's incremented by the |long|\-|table| environment +% instead. +% \NEWfeature{v3.1} +% If you need a |long|\-|table| which does not increment the |table| counter +% please use the |long|\-|table*| environment (offered by the +% \package{ltcaption} package which is part of \thispackage\ bundle and will be +% loaded automatically). +Команды |\caption|\-|of| и~|\Continued|\-|Float| не работают в~окружениях |long|\-|table|. +Кроме того ни |\caption| ни |\caption|\-|list|\-|entry| не увеличивают значение счётчика +таблиц |table|; его значение управляется окружением |long|\-|table|. +\NEWfeature{v3.1} +Если вам нужно создать окружение |longtable| без увеличения счётчика таблиц, |table|, +используйте окружение |longtable*|, предлагаемое пакетом \package{ltcaption}, +который является частью группы пакетов пакета \package{caption} и~загружается автоматически. +\end{Note} + +\pagebreak[3] +\subsection{Пакет picinpar} +\label{picinpar} +\packagedescription{% +% Similar to the \package{floatflt} package the \package{picinpar} +% package\cite{picinpar} offers figures and tables which do not span the full +% width of a page and are float around by text. +% For a detailed discussion about the differences between these packages +% please take a look at The \LaTeX\ Companion\cite{TLC2}.} +Аналогичный пакету \package{floatflt}, пакет \package{picinpar}% +\cite{picinpar} предлагает окружения небольших рисунков и~таблиц, обтекаемых текстом. +За более подробной информацией о~различиях пакетов обращайтесь +к~\LaTeX\ Companion\cite{TLC2}.} + +\NEWfeature{v3.1} +% If you want to setup special options for the |fig|\-|window| and +% |tab|\-|window| environments you can use +Если вам нужны специальные настройки для окружений |figwindow| и~|tabwindow| +вы можете задать +\begin{quote} + |\captionsetup[figwindow]|\marg{options}\quad\emph{и}\\ + |\captionsetup[tabwindow]|\marg{options}\quad. +\end{quote} +% These options will be executed additionally to the regular ones for +% |figure| or |table|. +Эти настройки будут добавлены к~основным настройкам +|figure| или |table|. + +\begin{Note} +% The |margin| resp.~|width| setting will not be used for these figures and tables, +% unless you set it explicit with |\caption|\-|setup[fig|\-|window]{|\ldots|}| or +% |\caption|\-|setup[fig|\-|table]{|\ldots|}|. +Настройки ключей |margin| и~|width| не используются для этих рисунков и~таблиц, +только если вы не зададите строго |\caption|\-|setup|\x|[figwindow]{|\ldots|}| или +|\caption|\-|setup|\x|[figtable]{|\ldots|}|. +\end{Note} + +\pagebreak[3] +\subsection{Пакет picins} +\label{picins} +\packagedescription{% +% Similar to the \package{floatflt} and \package{picinpar} package the +% \package{picins} package\cite{picins} offers figures and tables which do not +% span the full width of a page and are float around by text. +% For a detailed discussion about the differences between these packages +% please take a look at The \LaTeX\ Companion\cite{TLC2}.} +Аналогичен пакетам \package{floatflt} и~\package{picinpar} +\package{picins}\cite{picins} предлагает окружения небольших рисунков и~таблиц, обтекаемых текстом. +За более подробной информацией о~различиях пакетов обращайтесь +к~\LaTeX\ Companion\cite{TLC2}.} + +\NEWfeature{v3.1} +% If you want to setup special options for the |par|\-|pic| environment you can use +Если вы хотите задать специальные настройки для окружения |parpic| вы можете задать +\begin{quote} + |\captionsetup[parpic]|\marg{options}\quad. +\end{quote} +% These options will be executed additionally to the regular ones for +% |figure| or |table|. +Эти настройки будут добавлены к~основным настройкам +|figure| или |table|.\par + +% Furthermore |\pic|\-|caption[]{|\ldots|}| produce no entry in the List of Figures, +% and |\pic|\-|caption*{|\ldots|}| gives an unlabeled \& unnumbered caption. +Помимо этого команда |\pic|\-|caption[]{|\ldots|}| не создаёт записи в~Списке рисунков, +а~команда |\pic|\-|caption*{|\ldots|}| задаёт подпись без нумерационного заголовка. + +\begin{Note} +% The |margin| resp.~|width| setting will not be used for these figures and tables. % \iffalse -% --------------------------------------------------------------------------- % +% if |pic|\-|caption|\-|side| or |pic|\-|caption|\-|top|\-|side| is used. +% The |width| setting will not be used (but the |margin| setting will) if +% |pic|\-|caption|\-|out|\-|side| or |pic|\-|caption|\-|in|\-|side| is used. % \fi -% -%^^A \section{Compatibility to other packages} -% \section{Совместимость с другими пакетами} -% \label{packages} -% -%^^A The \thispackage\ package contains special adaptations to other packages, -%^^A so the captions should always look like you have specified them to look like. -% Пакет \thispackage\ содержит специальные адаптации с~другими пакетами, -% также работающими с~подписями, поэтому подписи \emph{всегда} выглядят так, -% как вы определили им настройки. -% -%^^A These are the packages the \thispackage\ package is adapted to: -% Здесь приведены пакеты, которые адаптированы на совместное использование -% с~\thispackage: -% -%^^A \begin{tabular}{ll} -%^^A |float| & Gives you the possibility to define new floating environments\\ -%^^A |listings| & Typesets source code listings\\ -%^^A |longtable| & Typesets tables spanned over multiple pages\\ -%^^A |rotating| & Supports rotated figures and tables\\ -%^^A |sidecap| & Offers captions \emph{beside} figures or tables\\ -%^^A |supertabular| & Typesets tables spanned over multiple pages\\ -%^^A \end{tabular} -% \begin{tabular}{ll} -% |float| & Даёт возможность определить новое окружение флота \\ -% |listings| & Печатает исходные тексты программ\\ -% |longtable| & Печатает многостраничные таблицы\\ -% |rotating| & Поддерживает поворот рисунков и таблиц\\ -% |sidecap| & Предлагает окружения с подписями сбоку\\ -% |supertabular| & Печатает многостраничные таблицы [альтернатива |longtable|]\\ -% \end{tabular} -% -% \NEWfeature{v3.0b} -%^^A If you use one of the above packages together with the {\thispackage} package -%^^A you get the additional possibility to set up captions with -% Если вы используете один из этих пакетов вместе с~пакетом {\thispackage} -% вы получаете дополнительные возможности для настроек оформления с~помощью -% \begin{quote}|\captionsetup|\oarg{environment}\marg{options}\quad,\end{quote} -%^^A where \meta{environment} stands for any environment the above packages offer. -%^^A (Please note that this do not work with the |sideways| environments offered by -%^^A the \package{rotating} package.) -%^^A For example -% где \meta{environment} определяет окружения, заданные упомянутыми выше пакетами. -% (Обратите внимание, что это не работает с~окружениями |sideways...| пакета -% \package{rotating}.) -% Например -% \begin{quote}|\captionsetup[lstlisting]{labelfont=bf}|\end{quote} -%^^A forces captions inside the |lstlisting| environment to have bold labels. -% Задаёт подписям внутри окружения |lstlisting| полужирные нумерационные части. -% -%^^A If a certain support is not desired you can switch it off using the -%^^A \thispackage\ package option -% Если такая поддержка нежелательна вы можете задать соответствующую опцию -% пакета \thispackage -% \begin{quote} -% |\usepackage[|\ldots|,|\meta{package}|=no]{caption}|\quad. -% \end{quote} -%^^A For example specifying the option |float=no| means you don't like the -%^^A \thispackage\ package to support the \package{float} package. -%^^A (Note: You can specify these options only within the |\usepackage| command, -%^^A especially \emph{not} at a later time with |\captionsetup|.) -% Например, задание опции |float=no| означает, что вы не хотите, чтобы пакет -% \thispackage\ поддерживал пакет \package{float}. (Примечание: -% вы можете определить эти опции только в~строке команды |\usepackage|, -% тем более \emph{не} в~командах |\captionsetup|.) -% -%^^A For further information about the packages mentioned above please take a look -%^^A at the documentation belonging to them or buy yourself -%^^A The \LaTeX\ Companion\cite{companion}. -% Для подробной информации о~пакетах, которые поддерживаются см. документацию -% этих пакетов или в~книге The \LaTeX\ Companion\cite{companion}. -% -% \iffalse -% --------------------------------------------------------------------------- % -% \fi -% -%^^A \subsection{The \package{float} package} -% \subsection{Пакет \package{float}} -% \label{float} -% -%^^A A very useful feature is provided by the \package{float} package\cite{float}: -%^^A It offers the float placement specifier |H| which is much more restrictive -%^^A than the specifier |h| offered by \LaTeX. While the latter one is only a -%^^A recommendation to \LaTeX\ to set the float ``here'', the |H| forces the -%^^A float to appear exactly at the spot where it occurs in your input file -%^^A and nowhere else. -% Очень полезные настройки предлагаются пакетом \package{float}\cite{float}. -% Пакет предлагает специальную опцию размещения флота |H| которая жёстче, по -% сравнению с~опцией |h| стандартного \LaTeX'а. Если стандартная опция только -% «рекомендует» \LaTeX'у~поместить флот «здесь», опция |H| помещает -% флот точно в~том месте где он записан и~нигде больше [При этой -% опции флот реально встаёт на якорь! \cdash--- \emph{Прим. перев}]. -% -%^^A Furthermore it offers different styles for floating environments, these -%^^A styles are |plain|, |plaintop|, |ruled|, and |boxed|. -%^^A You can link one of these styles to either new floating environments or -%^^A to one of the existing environments |figure| and |table|. -% Помимо этого пакет предлагает различные стили для окружений флотов, это стили -% |plain|, |plaintop|, |ruled|, и~|boxed|. -% Вы можете задать один из этих стилей как для новых окружений флотов, так -% и~для уже существующих |figure| и~|table|. -% -%^^A If you are using the \thispackage\ package together with the \package{float} -%^^A package a caption style called |ruled| gets defined automatically: -% Если вы используете пакет \thispackage\ вместе с~пакетом \package{float} -% стиль подписи |ruled| будет определён автоматически: -% \begin{quote} -% |\DeclareCaptionStyle{ruled}{labelfont=bf,labelsep=space}| -% \end{quote} -%^^A This style represents the caption layout in |ruled| styled floats. -%^^A For you as an end user this means that captions within |ruled| floats will -%^^A always look like this, nevertheless what generic caption options do you -%^^A specify: -% Этот стиль предлагает стиль подписей в~стиле флотов |ruled|. -% Для вас как пользователя это значит, что подписи внутри |ruled| флотов будут -% всегда выглядеть так, если только не переопределены заданные опции пакета: -% -% \ifx\floatstyle\undefined -% -% \begin{Example} -% \hrule height.8pt depth0pt \kern2pt -% \vbox{\strut{\bfseries Program 7.1} -% The first program. This hasn't got anything to do with the package -% but is included as an example. Note the \texttt{ruled} float style.} -% \kern2pt\hrule\kern2pt -% \begin{verbatim} -% #include -% -% int main(int argc, char **argv) -% { -% for (int i = 0; i < argc; ++i) -% printf("argv[%d] = %s\n", i, argv[i]); -% return 0; -% } -% \end{verbatim} -% \kern2pt\hrule\relax -% \end{Example} -% -% \else -% -% \floatstyle{ruled} -% \newfloat{Program}{tbp}{lop}[section] -% \floatname{Program}{Program} -% -% \begin{Program}[H] -% \begin{verbatim} -% #include -% -% int main(int argc, char **argv) -% { -% for (int i = 0; i < argc; ++i) -% printf("argv[%d] = %s\n", i, argv[i]); -% return 0; -% } -% \end{verbatim} -% \caption{The first program. This hasn't got anything to do with the package -% but is included as an example. Note the \texttt{ruled} float style.} -% \end{Program} -% -% \fi -% -%^^A If you want a different layout for |ruled| captions you have to define -%^^A your own one using the command -% Если вы желаете другое оформление для |ruled| подписей нужно -% задать свои установки, используя команду -% \begin{quote} -% |\DeclareCaptionStyle{ruled}|\marg{options}\quad. -% \end{quote} -% -%^^A This mechanism also works with all other float styles. If you want a special -%^^A caption layout---for |plain| or |boxed| floats for example---you can simply define -%^^A a suitable caption style with the same name as the float style. -% Этот механизм действует и~на другие стили флотов. Если вам нужно специальное -% оформление подписи для стиля |plain| или |boxed|, вы просто -% определяете соответствующий стиль с~тем же названием. -% -%^^A \textbf{Note:} For successful cooperation you need the float package -%^^A version 1.3 or newer. -% \textbf{Примечание:} Для успешной кооперации вам нужна версия пакета -% под номером 1.3 или выше. -% -% \iffalse -% --------------------------------------------------------------------------- % -% \fi -% -% \pagebreak[3] -%^^A \subsection{The \package{listings} package} -% \subsection{Пакет \package{listings}} -% \label{listings} -% -% \NEWdescription{v3.0b} -%^^A The \package{listings} package\cite{listings} is a source code printer for \LaTeX. -%^^A You can typeset stand alone files as well as listings with an environment -%^^A similar to \texttt{verbatim} as well as you can print code snippets using -%^^A a command similar to |\verb|. -%^^A Many parameters control the output and if your preferred programming -%^^A language isn't already supported, you can make your own definition. -% Пакет \package{listings} \cite{listings} предназначен для печати исходного -% кода в~\LaTeX'е. Вы можете печатать отдельные файлы в~окружении, аналогичном -% окружению \texttt{verbatim} или фрагменты кода так же как при использовании -% команды |\verb|. -% Множество параметров контролируют вывод кода и~если вам нужно оформить -% язык, который ещё не имеет поддержки, вы можете задать свои определения. -% -%^^A \textbf{Note:} For successful cooperation you need the listings package -%^^A version 1.2 or higher. You'll get an error message when using an -%^^A older version! -% \textbf{Примечание:} для успешной кооперации вам нужен пакет -% версии не ниже 1.2. Иначе вы получите сообщение об ошибке! -% -% \iffalse -% --------------------------------------------------------------------------- % -% \fi -% -%^^A \subsection{The \package{longtable} package} -% \subsection{Пакет \package{longtable}} -% \label{longtable} -% -%^^A The \package{longtable} package\cite{longtable} offers the environment -%^^A |longtable| which behaves similar to the |tabular| environment, but -%^^A the table itself can span multiple pages. -% Пакет \package{longtable} \cite{longtable} предлагает окружение -% |longtable| которое, аналогично окружение |tabular|, создаёт табличный -% материал, но он может разместиться на нескольких полосах. -% -%^^A \textbf{Note:} For successful cooperation you need the longtable package -%^^A version 3.15 or newer. -% \textbf{Примечание:} Для успешной кооперации используйте версию -% 3.15 или выше. -% -% \iffalse -% --------------------------------------------------------------------------- % -% \fi -% -%^^A \subsection{The \package{rotating} package} -% \subsection{Пакет \package{rotating}} -% \label{rotating} -% -%^^A The \package{rotating} package\cite{rotating} offers the floating -%^^A environments \texttt{sideways\-figure} and \texttt{sideways\-table} -%^^A which are just like normal figures and tables but rotated by 90 degree. -%^^A Furthermore they always use a full page on their own. -% Пакет \package{rotating} \cite{rotating} предлагает окружения -% \texttt{sideways\-figure} и~\texttt{sideways\-table} -% которые, аналогичны обычным рисункам и~таблицам, но повёрнуты на 90 градусов. -% Эти окружения всегда занимают полную полосу. -% -% \iffalse -% --------------------------------------------------------------------------- % -% \fi -% -%^^A \subsection{The \package{sidecap} package} -% \subsection{Пакет \package{sidecap}} -% \label{sidecap} -% -% \NEWdescription{v3.0b} -%^^A The \package{sidecap} package\cite{sidecap} offers the floating -%^^A environments |SCfigure| and |SCtable| which are like normal figures -%^^A and tables but the caption will be put \emph{beside} the contents. -% Пакет \package{sidecap}\cite{sidecap} предлагает окружения флотов -% |SCfigure| и~|SCtable|, которые аналогичны обычным рисункам и~таблицам -% но подпись помещается \emph{сбоку}. -% -%^^A The \package{sidecap} package offers it's own options for justification. -%^^A If set, they will override the one specified with the caption option -%^^A |justification=| for captions beside their contents. -% Пакет \package{sidecap} предлагает свои опции выключки. -% Если они заданы, они перекрывают заданные опции в~ключе -% |justification=|. -% -% \DescribeMacro{listof=}\label{TeXr:nolistentry:II} -%^^A Using the \package{sidecap} package you will probably notice that -%^^A suppressing the entry in the list of figures or tables with -%^^A |\caption[]{|\ldots|}| won't work inside these environments. -%^^A This is caused by the implementation design of the \package{sidecap} -%^^A package, but you can use |\captionsetup{listof=false}| inside the -%^^A figure or table as an alternative here. -% Используя пакет the \package{sidecap} вы возможно заметите, что -% отмена вывода в~список подписи с~помощью кода -% |\caption[]{|\ldots|}| не работает в~этих окружениях. -% Это связано с~настройками пакета \package{sidecap}, -% но можно использовать для этого ключ |\captionsetup{listof=false}| внутри -% нужной фигуры или таблицы. -% -% \ifx\SCfigure\undefined -% -% \begin{Example} -% \newsavebox\scbox -% \begin{lrbox}{\scbox} -% \setlength{\unitlength}{.75cm} -% \setlength{\fboxsep}{0pt} -% \fbox{\begin{picture}(4,4) -% \put(1,3){\circle{1}} -% \put(3,3){\circle{1}} -% \put(2,2){\circle{1}} -% \put(1,1){\circle{1}} -% \put(3,1){\circle{1}} -% \end{picture}} -% \end{lrbox} -% \newlength\scboxwidth -% \setlength\scboxwidth{\wd\scbox} -% \makebox[\linewidth][c]{ -% \parbox[b]{\scboxwidth}{\unhbox\scbox} -% \hspace\marginparsep -% \parbox[b]{1.5\scboxwidth}{ -% \captionsetup{justification=raggedright,labelfont=bf} -% \captionof{figure}[]{Небольшой пример с~подписью сбоку.} -% } -% } -% \end{Example} -% -% \else -% -% \captionsetup{labelfont=bf} -% \begin{SCfigure}[1.5][!ht] -% \setlength{\unitlength}{.75cm} -% \setlength{\fboxsep}{0pt} -% \fbox{\begin{picture}(4,4) -% \put(1,3){\circle{1}} -% \put(3,3){\circle{1}} -% \put(2,2){\circle{1}} -% \put(1,1){\circle{1}} -% \put(3,1){\circle{1}} -% \end{picture}} -% \iffalse -% \captionsetup{labelfont=bf} -% \fi -% \caption[]{A small example with the caption beside the figure.} -% \end{SCfigure} -% \captionsetup{labelfont=default} -% -% \fi -% -% \iffalse +% But you can override this by setting it explicit with +% |\caption|\-|setup[par|\-|pic]{|\ldots|}|. +Настройки ключей |margin| и~|width| не используются для этих рисунков и~таблиц. +\iffalse +если заданы команды |pic|\-|caption|\-|side| или |pic|\-|caption|\-|top|\-|side|. +Настройки ключа |width| не будут использоваться (но ключ |margin| будет), если +заданы команды |pic|\-|caption|\-|out|\-|side| или |pic|\-|caption|\-|in|\-|side|. +\fi +Но это можно переопределить настройками +|\caption|\-|setup[par|\-|pic]{|\ldots|}|. +\end{Note} + +% If you want to have a |\pic|\-|caption| of another type as |figure|, please +% do \emph{not} re-define |\@cap|\-|type| as suggested by the \package{picins} +% documentation. Please use the |\pic|\-|caption|\-|type|\marg{type} command +% which is offered by \thispackage\ instead, e.g.: +Если вам нужно задать подпись, |\piccaption|, не для |figure|, а~для другого типа флота, +\emph{не} переопределяйте команду |\@captype|, как предложено в~документации пакета +\package{picins}. +Используйте команду |\piccaptiontype|\marg{type}, предлагаемую данным пакетом, +например: +\begin{quote} + |\piccaptiontype{table}|\\ + |\piccaption{An example table}|\\ + |\parpic(50mm,10mm)[s]{|\ldots|}| +\end{quote} + +\pagebreak[3] +\subsection{Пакет rotating} +\label{rotating} +\packagedescription{% +% The \package{rotating} package\cite{rotating} offers the floating +% environments \texttt{side\-ways\-figure} and \texttt{side\-ways\-table} which +% are just like normal figures and tables but rotated by 90 resp.~270 degree. +% Furthermore a command \cs{rot\-caption} is offered for rotated captions only.} +Пакет \package{rotating}\cite{rotating} предлагает окружения флотов +\texttt{side\-ways\-figure} и~\texttt{side\-ways\-table} +которые являются теми же рисунками и~таблицами, но развёрнутыми на 90~градусов. +Помимо этого используется команда \cs{rotcaption} для поворота только подписей.} + +\iffalse % No, we don't do that +% If you want to setup special options for the |side|\-|ways|\-|figure| and +% |side|\-|ways|\-|table| environments you can use +Если вы хотите задать настройки для окружений |sidewaysfigure| и~|sidewaystable| +вы можете задать +\begin{quote} + |\captionsetup[sidewaysfigure]|\marg{options}\\ + |\captionsetup[sidewaystable]|\marg{options}\quad. +\end{quote} +Эти настройки будут добавлены к~основным настройкам +|figure| или |table|.\par +\fi + +% The command |\rot|\-|caption| will be extended by \thispackage, so +% |\rot|\-|caption*| and |\rot|\-|caption|\-|of| can be used analogous to +% |\caption*| and |\caption|\-|of|. +Команда |\rot|\-|caption| была расширена данным пакетом, поэтому +|\rot|\-|caption*| или |\rot|\-|caption|\-|of| могут быть использованы аналогично +командам |\caption*| и~|\captionof|. + +\NEWfeature{v3.1} +% Furthermore |\Declare|\-|Caption|\-|Type|\marg{name} will also define +% an environment called |side|\-|ways|\meta{name} which behaves like +% |side|\-|ways|\-|figure| and |side|\-|ways|\-|table|. +Помимо этого команда |\Declare|\-|Caption|\-|Type|\marg{name} определит +окружение, называемое |side|\-|ways|\meta{name}, которое работает аналогично +|side|\-|ways|\-|figure| и~|side|\-|ways|\-|table|. + +\pagebreak[3] +\subsection{Пакет setspace} +\label{setspace} +\packagedescription{% +% The \package{setspace} package\cite{setspace} offers options and commands +% to change the spacing, +% e.g.\ \cs{usepackage}\x\csoarg{one\-half\-spacing}\x\csmarg{set\-space} +% causes the document to be typeset in one-and-a-half spacing.} +Пакет \package{setspace}\cite{setspace} предлагает опции и~команды для +изменения интерлиньяжа, +например \cs{usepackage}\x\csoarg{one\-half\-spacing}\x\csmarg{set\-space} +создаст документ, распечатанный с~полуторным интерлиньяжем.} + +% If the \package{setspace} package is used in conjunction with \thispackage, +% the caption will be typeset with single spacing as default. This can be changed +% by specifying either |font=|\x|one|\-|half|\-|spacing|, +% |font=|\x|double|\-|spacing|, or |font={stretch=|\x\meta{amount}|}|. +% \See{also \Ref{fonts}} +Если пакет \package{setspace} используется вместе с~данным пакетом, +подпись будет напечатана с~одинарным интерлиньяжем. Это можно переопределить, +задав либо |font=onehalfspacing|, |font=doublespacing|, либо +|font={stretch=|\meta{amount}|}|. \See{также \Ref{fonts}} + +\pagebreak[3] +\subsection{Пакет sidecap} +\label{sidecap} +\packagedescription{% +% The \package{sidecap} package\cite{sidecap} offers the floating environments +% \texttt{SC\-figure} and \texttt{SC\-table} which are like usual figures +% and tables but the caption will be put \emph{beside} the contents.} +Пакет \package{sidecap}\cite{sidecap} предлагает окружения флотов +|SCfigure| и~|SCtable|, которые являются теми же рисунками и~таблицами, +но подписи помещаются \emph{сбоку} содержимого.} + +% If you want to setup special options for the |SCfigure| and |SCtable| +% environments you can use +Если вам нужно задать настройки для окружений |SCfigure| и~|SCtable| +вы можете задать +\begin{quote} + |\captionsetup[SCfigure]|\marg{options}\quad\emph{and}\\ + |\captionsetup[SCtable]|\marg{options}\quad. +\end{quote} +% These options will be executed additionally to the regular ones for +% |figure| or |table|. +Эти настройки будут добавлены к~основным настройкам +|figure| или |table|.\par + +\pagebreak[3] +\NEWfeature{v3.1} +% Furthermore |\Declare|\-|Caption|\-|Type|\marg{name} will also define +% an environment called |SC|\meta{name} which behaves like |SC|\-|figure| and +% |SC|\-|table|. +Помимо этого команда \cs{DeclareCaptionType}\marg{name} может определить +окружение |SC|\meta{name}, которое работает аналогично |SCfigure| и~|SCtable|. + +\pagebreak[3] +\begin{Note} +% The \package{sidecap} package offers its own options for justification. +% If set, they will override the one specified with the caption option +% |jus|\-|ti|\-|fi|\-|ca|\-|tion=| for captions beside their contents. +Пакет \package{sidecap} предлагает опции для выключки подписей. +И~если они заданы, то они переопределят настройки ключа +|justification=| для подписей стоящих сбоку. +\end{Note} + +\begin{Note} +% The |margin| resp.~|width| setting will not be used for these figures and tables, +% unless you set it explicit with |\caption|\-|setup[SC|\-|figure]{|\ldots|}| +% or |\caption|\-|setup[SC|\-|table]{|\ldots|}|. +Настройки ключей |margin| и~|width| не используются для этих рисунков и~таблиц, +только если вы не зададите строго |\captionsetup|\x|[SCfigure]|\x|{|\ldots|}| +или |\captionsetup|\x|[SCtable]|\x|{|\ldots|}|. +\end{Note} + +\medskip + +\begin{Annotation*} +% Instead of using the \package{sidecap} package you can also use the more +% powerful and flexible \package{floatrow} package\cite{floatrow} for typesetting +% captions beside the contents. +Вместо использования пакета \package{sidecap} вы можете воспользоваться +пакетом \package{floatrow}\cite{floatrow} для размещения подписей сбоку флотов. +\end{Annotation*} + +\pagebreak[3] +% \subsubsection*{Undocumented features} +% The \package{sidecap} package \version{1.6} has some undocumented package +% options and commands which allow further customization of the side-captions: +\subsubsection*{Недокументированные особенности} +Пакет \package{sidecap} версии \version{1.6} имеет некоторые недокументированные +опции и~команды которые позволяют задать дополнительные настройки: + +\pagebreak[3] +\DescribeMacro{margincaption} +% The package option +Опция пакета +\begin{quote} + |margincaption|\qquad{\small(e.g.~|\usepackage[margincaption]{sidecap}|)} +\end{quote} +% causes all side-captions to be placed into the margin. +позволяет поместить все подписи сбоку на поле. + +\pagebreak[3] +\DescribeMacro{\sidecaptionvpos} +% The command +Команда +\begin{quote} + |\sidecaptionvpos|\marg{float type}\marg{pos} +\end{quote} +% sets the vertical position of the side-caption. \meta{pos} can be either `|t|' +% (for top alignment), `|b|' (for bottom alignment), or `|c|' (for center alignment). +% The default setting for |table| is `|t|', for |figure| and all other ones +% defined with |\Declare|\-|Caption|\-|Type| it's `|b|'. +задаёт вертикальное положение подписи. Аргумент \meta{pos} может быть либо `|t|' +(для выравнивания по верху), `|b|' (для выравнивания по низу), или `|c|' +(для выравнивания по центру). +Значение по умолчанию для таблиц, |table|, \cdash--- `|t|', +для рисунков, |figure|, и~всех других окружений, определённых +с~помощью |\Declare|\-|Caption|\-|Type| \cdash--- `|b|'. + +\pagebreak[3] +\subsection{Пакет subfigure} +\label{subfigure} +\packagedescription{% +% The \package{subfigure} package\cite{subfigure} provides support for small or +% `sub' figures and tables within a single figure or table environment. +% This package is obsolete, new users should use \package{subfig} instead.} +Пакет \package{subfigure}\cite{subfigure} предлагает поддержку для частей флотов (подфлотов) +внутри одного окружения |figure| или |table|. +Этот пакет является устаревшим, новые пользователям рекомендуется пакет \package{subfig}.} + +% Since the \package{subfigure} package is obsolete it will only be supported in +% a way that old documents (which have used \thispackage\ \version{1.x} during +% development) should still compile as expected. +Поскольку пакет \package{subfigure} устаревший, он поддерживается и~компилируется только в~старых документах +(использующих \thispackage\ \version{1.x}). + +% Please use the \package{subfig} package instead with supports \thispackage\ +% \version{3.x}. +Вместо этого используйте, пожалуйста, пакет \package{subfig}; его поддерживает \thispackage\ +\version{3.x}. + +% \See{the \package{subfig} package\cite{subfig} documentation for details.} +\See{документацию пакета \package{subfig}\cite{subfig}.} + +\pagebreak[3] +\subsection{Пакеты supertabular и~xtab} +\label{supertabular} +\packagedescription{% +% The \package{supertabular}\cite{supertabular} and \package{xtab}\cite{xtab} +% packages offer an environment which can span multiple pages and is quite +% similar to the \texttt{long\-table} environment provided by the +% \package{longtable} package\cite{longtable}. +% For a detailed discussion about the differences between these powerful +% packages please take a look at The \LaTeX\ Companion\cite{TLC2}.} +Пакеты \package{supertabular}\cite{supertabular} и~\package{xtab}\cite{xtab} +предлагают окружение, +аналогичное \texttt{long\-table}, (пакет \package{longtable}\cite{longtable}), +которое может разбиваться на несколько страниц. +Детальные объяснения различий этих мощных пакетов +см.~в~\LaTeX\ Companion\cite{TLC2}.} + +% If you want to setup special options for the |super|\-|tabular| +% resp.~|x|\-|tabular| environment you can use +Если вам нужно задать специальные настройки для окружений |super|\-|tabular| +или~|xtabular| вы можете записать +\begin{quote} + |\captionsetup[supertabular]|\marg{options}\quad\emph{и, соответственно}\\ + |\captionsetup[xtabular]|\marg{options}\quad. +\end{quote} +% These options will be executed additionally to the regular ones for +% |table|. +Эти настройки будут добавлены к~основным настройкам +|figure| или |table|.\par + +\begin{Note} +% |\Continued|\-|Float| does not work for |super|\-|tabular|s and |x|\-|tabular|s. +Команда |\Continued|\-|Float| не работает с~|super|\-|tabular| и~|xtabular|. +\end{Note} + +\pagebreak[3] +\subsection{Пакет threeparttable} +\label{threeparttable} +\packagedescription{% +% The \package{threeparttable} package\cite{threeparttable} provides a scheme +% for tables that have a structured note section after the table contents and +% the caption. +% This scheme provides an answer to the old problem of putting footnotes in +% tables---by making footnotes entirely unnecessary.} +Пакет \package{threeparttable}\cite{threeparttable} +предлагает схему для таблиц, имеющих структурированный раздел замечаний после табличного материала +и~подписи. +Эта схема предлагает ответ для старой проблемы размещения сносок в~таблицах без необходимости +создания сносок.} + +\NEWfeature{v3.1} +% If you want to setup special options for the |three|\-|part|\-|table| and +% |measured|\-|figure| environments you can use +Если вам нужно создать специальные настройки для окружений +|three|\-|part|\-|table| и~|measured|\-|figure|, +вы можете задать +\begin{quote} + |\captionsetup[threeparttable]|\marg{options}\quad\emph{и}\\ + |\captionsetup[measuredfigure]|\marg{options}\quad. +\end{quote} +% These options will be executed additionally to the regular ones for +% |table| or |figure|. +Эти настройки будут добавлены к~основным настройкам +|figure| или |table|.\par + +\begin{Note} +% Since the caption will have the same width as the contents here, +% the |margin| resp.~|width| setting will not be used for these figures and tables, +% at least unless you set it explicit with +% |\caption|\-|setup[three|\-|part|\-|table]{|\ldots|}| or +% |\caption|\-|setup[measured|\-|figure]{|\ldots|}|. +Поскольку ширина подписи равна ширине таблицы, +ключи |margin| и~|width| здесь не используются для рисунков и~таблиц, +только если вы не зададите строго +|\caption|\-|setup|\x|[threeparttable]|\x|{|\ldots|}| +или |\caption|\-|setup|\x|[measuredfigure]|\x|{|\ldots|}|. +\end{Note} + +\medskip + +\begin{Annotation*} +% Instead of using the \package{threeparttable} package you can +% also use the \package{floatrow} package\cite{floatrow} for this purpose. +Вместо пакета \package{threeparttable} можно использовать +пакет \package{floatrow}\cite{floatrow}. +\end{Annotation*} + +\pagebreak[3] +\subsection{Пакет wrapfig} +\label{wrapfig} +\packagedescription{% +% Similar to the \package{floatflt}, the \package{picinpar}, and the +% \package{picins} package the \package{wrapfig} package\cite{wrapfig} offers +% figures and tables which do not span the full width of a page and are float +% around by text. +% For a detailed discussion about the differences between these packages +% please take a look at The \LaTeX\ Companion\cite{TLC2}.} +Аналогично пакетам \package{floatflt}, \package{picinpar} и~% +\package{picins}, пакет \package{wrapfig}\cite{wrapfig} предлагает +окружения небольших рисунков и~таблиц обтекаемых текстом. +За более подробной информацией о~различиях пакетов обращайтесь +к~\LaTeX\ Companion\cite{TLC2}.} + +\NEWfeature{v3.1} +% If you want to setup special options for the |wrap|\-|figure| and +% |wrap|\-|table| environments you can use +Если вам нужно задать специальные настройки для окружений |wrap|\-|figure| +и~|wrap|\-|table| вы можете задать +\begin{quote} + |\captionsetup[wrapfigure]|\marg{options}\\ + |\captionsetup[wraptable]|\marg{options}\quad. +\end{quote} +% These options will be executed additionally to the regular ones for +% |figure| or |table|. +Эти настройки будут добавлены к~основным настройкам +|figure| или |table|.\par + +% Furthermore |\Declare|\-|Caption|\-|Type|\marg{name} will also define +% an environment called |wrap|\meta{name} which behaves like |wrap|\-|figure| +% and |wrap|\-|table|. +Помимо этого команда |\Declare|\-|Caption|\-|Type|\marg{name} определит +новое окружение |wrap|\meta{name}, которое аналогично |wrap|\-|figure| и~|wrap|\-|table|. + +\begin{Note} +% The |margin| resp.~|width| setting will not be used for these figures and +% tables, unless you set it explicit with +% |\caption|\-|setup[wrap|\-|figure]{|\ldots|}| +% or |\caption|\-|setup[wrap|\-|table]{|\ldots|}|. +Настройки ключей |margin| и~|width| не используются для рисунков и~таблиц, +только если вы не зададите строго |\caption|\-|setup|\x|[wrapfigure]{|\ldots|}| +или |\caption|\-|setup|\x|[wraptable]{|\ldots|}|. +\end{Note} + +\begin{Note} +% If the \package{wrapfig} package should be used in coorperation with the +% \package{float} package, it needs to be loaded \emph{after} the +% \package{float} package. Furthermore |\new|\-|float| and |\restyle|\-|float| +% commands \emph{should} be placed after \emph{both} packages have been loaded. +Если пакет \package{wrapfig} должен быть использован совместно с~пакетом +\package{float}, то его нужно загрузить \emph{после} пакета +\package{float}. Кроме того команды |\new|\-|float| или |\restyle|\-|float| +\emph{должны} быть помещены после загрузки \emph{обоих} пакетов. +\end{Note} + % --------------------------------------------------------------------------- % -% \fi -% -%^^A \subsection{The \package{supertabular} package} -% \subsection{Пакет \package{supertabular}} -% \label{supertabular} -% -%^^A The \package{supertabular} package\cite{supertabular} offers the environment -%^^A |supertabular| which is quite similar to the |longtable| environment provided -%^^A by the \package{longtable} package. Both offers the typesetting of tables -%^^A which can span multiple pages. For a detailed discussion about the -%^^A differences between these powerful packages please take a look at -%^^A The \LaTeX\ Companion\cite{companion}. -% Пакет \package{supertabular}\cite{supertabular} предлагает окружение -% |supertabular| которое аналогично |longtable| из пакета -% \package{longtable}. Оба они предлагают создание таблиц на несколько -% страниц. Детальный разбор различий этих пакетов -% приведён в~The \LaTeX\ Companion\cite{companion}. -% -% \iffalse + +\clearpage +% \section{Further reading} +\section{Рекомендуемая литература} + +% I recommend the following documents for further reading: +Я рекомендую следующие документы для дальнейшего чтения: + +\begin{itemize} +\item +% The \TeX\ FAQ -- Frequently asked questions about \TeX\ and \LaTeX: + The \TeX\ FAQ -- ЧаВо по \TeX'у и~\LaTeX'у: + \begin{quote}\url{http://faq.tug.org/}\end{quote} + +\item + A French FAQ can be found at + \begin{quote}\url{http://www.grappa.univ-lille3.fr/FAQ-LaTeX/}\end{quote} + +\item + ``What is a minimal working example?'' from Christian Faulhammer and Ulrich Schwarz: + \begin{quote}\url{http://www.minimalbeispiel.de/mini-en.html}\end{quote} + +\item +%^^A \textsf{epslatex} from Keith Reckdahl contains many tips around +%^^A including graphics in \LaTeXe\ documents. +%^^A You will find this document in the directory + \textsf{epslatex} (Keith Reckdahl) содержит множество подсказок + как разместить иллюстрационный материал в~документации созданной в~\LaTeXe. + Вы найдете этот файл в~директории + \begin{quote}\url{ftp://tug.ctan.org/pub/tex/info/epslatex/}\end{quote} +\end{itemize} + % --------------------------------------------------------------------------- % -% \fi -% -%\begingroup\samepage -%^^A \subsection{Known incompatibilities} -% \subsection{Известные несовместимости} -% -% \NEWdescription{v3.0b} -%^^A Using the \thispackage\ package together with one of the following packages -%^^A is not recommended; usually this would cause unwanted side effects or even -%^^A errors -%^^A\footnote{This translation could be obsolete, please check German or English -%^^A version for new information.}: -% Использование пакета \thispackage\ вместе с~одним из следующих пакетов -% не рекомендуется; обычно это даёт неожиданные побочные эффекты или даже -% ошибки\footnote{Данные перевода этого раздела могут содержать устаревшие данные. -% Обращайтесь к~английской или немецкой документации за более свежей информацией. \cdash--- -% \emph{Прим. перев.}}: -% \begin{quote} -% \package{captcont}, \package{ccaption}, \package{ftcapt}, (\package{hvfloat}), -% \package{multicap}, \package{topcapt}, \package{nonfloat} -% \end{quote} -%\endgroup -% -% \iffalse + +\pagebreak[3] +% \section{Thanks} +\section{Благодарности} + +{\fontencoding{T1}%\fontfamily{ptm} +\selectfont +I would like to thank Katja Melzner, +Steven D. Cochran, Frank Mittelbach, Olga Lapko, +David Carlisle, Carsten Heinz, and Keith Reckdahl. +Thanks a lot for all your help, ideas, patience, spirit, and support! + +Also I would like to thank +Harald Harders, +Peter L\"offler, +Peng Yu, +Alexander Zimmermann, +Matthias Pospiech, +J\"urgen Wieferink, +Christoph Bartoschek, +Uwe St\"ohr, +Ralf Stubner, +Geoff Vallis, +Florian Keiler, +J\"urgen G\"obel, +Uwe Siart, +Sang-Heon Shim, +Henrik Lundell, +David Byers, +William Asquith, +Prof.~Dr.~Dirk Hoffmann, +Frank Martini, +Danie Els, +and +Markus Kohm, +who all helped to make this package a better one.} + % --------------------------------------------------------------------------- % -% \fi -% -%^^A \section{Compatibility to older versions} -% \section{Совместимость со старыми версиями} -% \label{compatibility} -% -%^^A \subsection{The \thispackage\ package version $1.x$} -% \subsection{Пакет \thispackage\ версии $1.x$} -% -%^^A This version of the \thispackage\ package still supports the old options -%^^A and commands provided by the version $1.x$ of this package. So there -%^^A shouldn't occur any problems compiling old documents, but please don't mix -%^^A old options and commands with the new ones. This isn't supported and can -%^^A cause ugly side effects. -% Эта версия пакета \thispackage\ поддерживает старые опции и~команды -% созданные в~версиях $1.x$ этого пакета. Поэтому не должно возникать -% проблем в~компиляции старых документов, но, пожалуйста, не смешивайте -% старые опции и~команды с~новыми. Это не поддерживается -% и~может дать неприятные побочные эффекты. -% -%^^A Here comes a short oversight of the obsolete options and commands and how -%^^A they have been replaced within this version of the \thispackage\ package: -% Здесь дан краткий обзор устаревших опций и~команд и~чем -% они заменены в~современной версии пакета \thispackage: -% -% {\small\begin{longtable}{ll} -% \thispackage\ \version{1.x} & \thispackage\ \version{3.x}\\ -% \hline -% \endhead -% |normal| & |format=plain|\\ -% |hang| & |format=hang|\\ -% |isu| & |format=hang|\\ -% |center| & |justification=centering|\\ -% |centerlast| & |justification=centerlast|\\ -% \iffalse -% |anne| & |justification=centerlast|\\ -% \fi -% |nooneline| & |singlelinecheck=off|\\ -% |scriptsize| & |font=scriptsize|\\ -% |footnotesize| & |font=footnotesize|\\ -% |small| & |font=small|\\ -% |normalsize| & |font=normalsize|\\ -% |large| & |font=large|\\ -% |Large| & |font=Large|\\ -% |up| & |labelfont=up|\\ -% |it| & |labelfont=it|\\ -% |sl| & |labelfont=sl|\\ -% |sc| & |labelfont=sc|\\ -% |md| & |labelfont=md|\\ -% |bf| & |labelfont=bf|\\ -% |rm| & |labelfont=rm|\\ -% |sf| & |labelfont=sf|\\ -% |tt| & |labelfont=tt|\\ -% \end{longtable}} -% -%^^A Beside the options for setting up the desired font there were also -%^^A the commands |\captionsize| resp.~|\captionfont| and |\captionlabelfont| -%^^A who could be redefined with |\renewcommand| and allowed an alternate and -%^^A more flexible way to change the font used for captions. -%^^A This mechanism was replaced by the commands -% Помимо опций для настроек нужного шрифта были также команды -% |\captionsize|, а~также |\captionfont| и~|\captionlabelfont| -% которые могли быть переопределены с~помощью |\renewcommand| и~позволяли -% альтернативный и~более гибкий способ изменить шрифт подписей. -% Данный механизм заменён на команды -% \begin{quote} -% |\DeclareCaptionFont{|\ldots|}{|\ldots|}|\qquad и\\ -% |\captionsetup{font=|\ldots|,labelfont=|\ldots|}|\qquad. -% \end{quote}\SeeUserDefined -% -%^^A Setting the margin for captions was done in \version{1.x} with -% Установки полей в~версии \version{1.x} задавались с~помощью -% \begin{quote} -% |\setlength{\captionmargin}{|\ldots|}|\quad. -% \end{quote} -%^^A This was replaced by -% Это заменено на -% \begin{quote} -% |\captionsetup{margin=|\ldots|}|\qquad. -% \end{quote} -%^^A \See{\Section{margins}{Margins and further paragraph options}} -% \See{\Section{margins}{Поля и другие опции формирования абзаца}} -% -%^^A For example the old-style code -% Например, старый код -% \begin{quote} -% |\usepackage[hang,bf]{caption}|\\ -% |\renewcommand\captionfont{\small\sffamily}|\\ -% |\setlength\captionmargin{10pt}| -% \end{quote} -%^^A will still work fine, but should be written today as -% до сих пор работает, но лучше переписать его как -% \begin{quote} -% |\usepackage[format=hang,labelfont=bf,font={small,sf},|\\ -% | margin=10pt]{caption}| -% \end{quote} -%^^A or -% или -% \begin{quote} -% |\usepackage{caption}|\\ -% |\captionsetup{format=hang,labelfont=bf,font={small,sf},|\\ -% | margin=10pt}|\qquad. -% \end{quote} -% -%^^A The quite exotic option |ruled| which allowed a partial usage of -%^^A the caption settings for |ruled| floats defined with the -%^^A \package{float} package will be emulated by this version of the -%^^A caption package, too. -%^^A But using this option is not recommended anymore since this -%^^A version of the \thispackage\ package offers a more flexible way -%^^A for changing the captions of these floating environments: -% Такая экзотическая опция |ruled| которая позволяла частично использовать -% настройки подписи для флотов с~оформлением |ruled| из пакета -% \package{float} эмулируется и~данным пакетом тоже. -% Но использование этой опции не рекомендуется, поскольку данная версия пакета -% \thispackage\ предлагает более гибкий способ для изменения подписей -% таких окружений плавающих флотов: -% \begin{quote} -% |\DeclareCaptionStyle{ruled}{|\ldots|}| -% \end{quote} -%^^A resp. -% и, соответственно -% \begin{quote} -% |\captionsetup[ruled]{|\ldots|}|\qquad. -% \end{quote} -% \SeeUserDefined[, \Section*{misc}{Полезные утилиты} и -% \Section*{float}{Пакет \package{float}}] -% -%^^A \subsection{The \package{caption2} package version $2.x$} -% \subsection{Пакет \package{caption2} версии $2.x$} -% -%^^A Although they do very similar stuff, the packages \package{caption} and -%^^A its experimental and now obsolete variant \package{caption2} have a -%^^A very different implementation design. -%^^A Therefore a full compatibility could not be offered. -%^^A For that reason you will still find a file called |caption2.sty| in -%^^A this package distribution, so old documents using the \package{caption2} -%^^A package will still compile fine. -% Хотя используются одни и~те же настройки и~в~пакете \package{caption} -% и~в~экспериментальной, но сейчас устаревшей версии"=пакете -% \package{caption2}, у~этих пакетов совершенно разный механизм их задания. -% Поэтому полная совместимость невозможна. -% По этой причине до сих пор существует пакет |caption2.sty| в~данном -% дистрибутиве, и~старые документы, использующие пакет \package{caption2} -% будут компилироваться. -% -%^^A Newly created documents should use the actual version of the -%^^A \thispackage\ package instead. In most cases it's sufficient to replace -%^^A the command -% Новые документы должны использовать современные версии пакета -% \thispackage. В~большинстве случаев можно заменить строку -% \begin{quote} -% |\usepackage[...]{caption2}| -% \end{quote} -%^^A by -% на -% \begin{quote} -% |\usepackage[...]{caption}|\qquad. -% \end{quote} -%^^A But some options and commands will not be emulated, so you can get -%^^A error messages afterwards. This section will hopefully help you removing -%^^A these errors. If you have problems migrating from \package{caption2} -%^^A to \package{caption} please don't hesitate to send me an e-mail asking -%^^A for help. -% Но некоторые опции и~команды не эмулируются, и~вы можете -% получить сообщения об ошибках. Данный раздел поможет вам ликвидировать -% такие ошибки. Если у~вас проблемы по замене пакета \package{caption2} -% на \package{caption} не раздумывайте и~отправляйте мне e-mail. -% -%^^A In addition to the obsolete options shown in the last section -%^^A these ones will be emulated, too: -% Помимо устаревших опций из предыдущего раздела -% следующие также эмулируются: -% -% {\small\begin{longtable}{ll} -% \package{caption2} \version{2.x} & \thispackage\ \version{3.x}\\ -% \hline -% \endhead -% |flushleft| & |justification=raggedright|\\ -% |flushright| & |justification=raggedleft|\\ -% |oneline| & |singlelinecheck=on|\\ -% \end{longtable}} -% -%^^A Setting the margin for captions was done in \version{2.x} with -% Задание втяжек (полей) для подписей, созданных в~\version{2.x} -% \begin{quote}\leavevmode\hbox{% -% |\setcaptionmargin{|\ldots|}| resp. -% |\setcaptionwidth{|\ldots|}|\quad. -% }\end{quote} -%^^A This was replaced by -% Они могут быть заменены на -% \begin{quote}\leavevmode\hbox{% -% |\captionsetup{margin=|\ldots|}| resp. -% |\captionsetup{width=|\ldots|}|\quad. -% }\end{quote} -%^^A \See{\Section{margins}{Margins and further paragraph options}} -% \See{\Section{margins}{Поля и другие опции формирования абзаца}} -% -%^^A Setting an indention was done in \version{2.x} with -% Задание втяжки в~версии \version{2.x} задавалось как -% \begin{quote} -% |\captionstyle{indent}|\\ -% |\setlength\captionindent{|\ldots|}|\quad. -% \end{quote} -%^^A This is now done with -% Сейчас это задаётся в~виде -% \begin{quote} -% |\captionsetup{format=plain,indention=|\ldots|}|\quad. -% \end{quote} -% -%^^A The so-called single-line-check was controlled by the commands -%^^A |\oneline|\-|captions|\-|false| (for switching the check off) and -%^^A |\oneline|\-|captions|\-|true| (for switching the check on). -%^^A This was replaced by -% Контроль короткой подписи контролируется командами -% |\oneline|\-|captions|\-|false| (отключает контроль) -% и~|\oneline|\-|captions|\-|true| (для включения контроля). -% Это заменено -% |\captionsetup{|\discretionary{}{}{}|singlelinecheck=|\discretionary{}{}{}|off}| -%^^A resp. -% и, соответственно -% |\captionsetup{|\discretionary{}{}{}|singlelinecheck=|\discretionary{}{}{}|on}|. -% \See{\Section{justification}{Выключка}} -% -%^^A The commands -% Команды -% \begin{quote} -% |\captionlabeldelim|, |\captionlabelsep|, |\captionstyle|,\\ -% |\defcaptionstyle|, |\newcaptionstyle|, and |\renewcaptionstyle| -% \end{quote} -%^^A do not have a simple replacement and therefore will not be emulated -%^^A by this version of the \thispackage\ package. (So using them will -%^^A cause error messages.) Rewriting such code is not always easy and -%^^A straight-ahead, but by conscientious reading of this manual you should -%^^A find appropriate options and commands instead. -% не имеют простой замены поэтому не эмулируются -% данной версией пакета \thispackage. (Их использование вызовет -% сообщение об ошибке.) Замена этого кода не всегда проста, -% но добросовестно прочитав данное руководство, вы найдёте -% подходящие опции и~команды замены. -% -% \iffalse -% ... (some examples) -% \fi -% -%^^A The \version{2.x} option |ignoreLTcapwidth| do not have a replacement, too. -%^^A But in most cases you can simply drop using that option because -%^^A in this version of the \thispackage\ package the value of |\LTcapwidth| -%^^A will be ignored anyway (unless you set it to a different value than the -%^^A default one). -%^^A \See{\Section{longtable}{The \package{longtable} package}} -% Опция версии \version{2.x} |ignoreLTcapwidth| тоже не имеет замены. -% Но в~большинстве случаев эту опцию можно опустить, потому что в~данной -% версии пакета \thispackage\ значение |\LTcapwidth| -% будет игнорировать в~любом случае (если только вы не зададите значение, -% отличное от заданного по умолчанию). -% \See{\Section{longtable}{Пакет \package{longtable}}} -% -% \iffalse + +\clearpage\appendix +% \section{Alphabetical Reference} +\section{Алфавитный указатель} + +%\newenvironment{Warnings}% +% {\begin{trivlist}% +% \def\Message{\pagebreak[3]\leftskip=0pt\relax\item[]\color{blue}}% +% \def\Description{\nopagebreak\par\nopagebreak\color{black}\leftskip=1.5em\nopagebreak}% +% }% +% {\color{black}\end{trivlist}} +\makeatletter +\newenvironment{Warnings}{% + \newif\ifMessage + \def\Message{% + \ifMessage\end{minipage}\par\vspace\itemsep\pagebreak[3]\fi + \begin{minipage}{\linewidth}% + \setlength\parindent{0pt}% + \setlength\parskip{\smallskipamount}% + \setlength\leftskip{0pt}% + \color{blue}% + \Messagetrue}% + \def\Description{% + \par\color{black}\leftskip=1.5em}% + \def\Or{\@testopt\@Or{или}}% + \def\@Or[##1]{% + \\{\small\color{black}\hspace{1.5em}\textit{-- ##1 --}}\\}% +}{% + \ifMessage\end{minipage}\par\fi +} +\makeatother + +% \subsection{Options} +\subsection{Ключи (опции)} +\newcommand\preambleoption{\,% + \begingroup\def\thefootnote{\fnsymbol{footnote}}% + \footnotemark[2]% + \endgroup} +\newcommand\preambleoptiontext{% + \begingroup\def\thefootnote{\fnsymbol{footnote}}% +% \footnotetext[2]{These options are only available in the preamble of the document.}% + \footnotetext[2]{Эти опции можно использовать только в~преамбуле документа.}% + \endgroup} + +\newcommand\cell[1]{\tabular[t]{@{}l@{}}#1\endtabular} + +\begin{longtable*}{@{}l@{\ }ll@{}} +% Option & Short description & Section \\ +Ключ & Краткое описание & Раздел \\ +\hline\noalign{\vskip2pt} +\endhead +% |aboveskip| & sets the skip above caption & \ref{skips} \\ +|aboveskip| & задаёт отбивку над подписью & \ref{skips} \\ +% |belowskip| & sets the skip below caption & \ref{skips} \\ +|belowskip| & задаёт отбивку под подписью & \ref{skips} \\ +% |compatibility|\preambleoption & force (non-)compatibility & \ref{classes} \\ +|compatibility|\preambleoption & форсировать (не)совместимость & \ref{compatibility} \\ +%|config| & & \ref{x} \\ +% |figurename|\preambleoption & sets the figure name & \ref{names} \\ +|figurename|\preambleoption & задание имени рисунка в~метке & \ref{names} \\ +% |figureposition|\preambleoption & gives a hint about the figure caption position & \ref{skips} \\ +|figureposition|\preambleoption & даёт подсказку о~размещении позиции подписи рисунка & \ref{skips} \\ +% |figurewithin|\preambleoption & sets the figure ``within'' counter & \ref{numbering} \\ +|figurewithin|\preambleoption & \cell{задаёт счётчик раздела, которому подчиняется\\ нумерация рисунков} + & \ref{numbering} \\ +% |font|(|+|) & sets the font & \ref{fonts} \\ +|font|(|+|) & задаёт шрифт & \ref{fonts} \\ +% |format| & sets the format & \ref{formats} \\ +|format| & задаёт формат & \ref{formats} \\ +% |FPlist| & to where the list entry of a FPfigure should link? & \ref{fltpage} \\ +|FPlist| & к~чему привязывать FPfigure в~Списке флотов? & \ref{fltpage} \\ +% |FPref| & to where a |\ref| to a FPfigure should link? & \ref{fltpage} \\ +|FPref| & к~чему привязывать |\ref| для FPfigure? & \ref{fltpage} \\ +% |hangindent| & sets the hang indention & \ref{margins} \\ +|hangindent| & \cell{задаёт втяжку [на весу;\\ соответствует команде \cs{hangindent}]} & \ref{margins} \\ +% |hypcap| & select `hypcap' feature & \ref{hyperref} \\ +|hypcap| & определяет работу пакета `hypcap' & \ref{hyperref} \\ +% |hypcapspace| & sets the distance between hyperlink \& contents & \ref{hyperref} \\ +|hypcapspace| & \cell{задаёт расстояние между гиперссылкой\\ и~содержимым +объекта} & \ref{hyperref} \\ +% |indention| & sets the indention & \ref{margins} \\ +|indention| & задаёт втяжку & \ref{margins} \\ +% |justification| & sets the justification & \ref{justification} \\ +|justification| & задаёт выключку & \ref{justification} \\ +% |labelfont|(|+|) & sets the font of the caption label & \ref{fonts} \\ +|labelfont|(|+|) & задаёт шрифт для метки флота & \ref{fonts} \\ +% |labelformat| & sets the format of the caption label & \ref{formats} \\ +|labelformat| & \cell{задаёт формат [оформление] нумерационного\\ заголовка} & \ref{formats} \\ +% |labelsep| & sets the label separator & \ref{formats} \\ +|labelsep| & \cell{задаёт разделитель между нумерационным\\ заголовком +и~текстом подписи} & \ref{formats} \\ +% |labelseparator| & sets the label separator & \ref{formats} \\ +|labelseparator| & \cell{задаёт разделитель между нумерационным\\ заголовком +и~текстом подписи} & \ref{formats} \\ +% |list| & switches the entries in the `List of' on or off & \ref{lists} \\ +|list| & \cell{определяет (включает/отключает) вывод подписей\\ в~Списке флотов} & \ref{lists} \\ +% |listformat| & sets the `List of' entry format & \ref{lists} \\ +% |listfigurename| & sets the `List of Figure' name & \ref{names} \\ +|listfigurename| & задаёт заголовок для Списка рисунков & \ref{names} \\ +|listformat| & определяет формат для вывода в~Списке флотов & \ref{lists} \\ +% |listtablename| & sets the `List of Tables' name & \ref{names} \\ +|listtablename| & задаёт заголовок для Списка таблиц & \ref{names} \\ +% |margin| & sets the margin & \ref{margins} \\ +|margin| & задаёт поля вокруг подписи & \ref{margins} \\ +% |margin*| & sets the margin, but only if no width is set & \ref{margins} \\ +|margin*| & \cell{задаёт поля, в~случае, если ширина подписи\\ не задана} & \ref{margins} \\ +% |maxmargin| & sets the max. margin & \ref{margins} \\ +|maxmargin| & задаёт максимальную величину поля & \ref{margins} \\ +% |minmargin| & sets the min. margin & \ref{margins} \\ +|minmargin| & задаёт минимальную величину поля & \ref{margins} \\ +%| name| & sets the name of the current environment & \ref{names} \\ +|name| & задаёт имя нового окружения & \ref{names} \\ +% |oneside| & selects the one-side mode & \ref{margins} \\ +|oneside| & задаёт одностороннюю печать документа & \ref{margins} \\ +% |options| & executes the given option list & \ref{x} \\ +|options| & включает данный список опций & \\ +% |parindent| & sets the paragraph indention & \ref{margins} \\ +|parindent| & задаёт абзацный отступ & \ref{margins} \\ +% |parskip| & sets the skip between paragraphs & \ref{margins} \\ +|parskip| & задаёт отбивку между абзацами & \ref{margins} \\ +% |position| & gives a hint about the caption position & \ref{skips} \\ +|position| & даёт подсказку о~размещении подписи & \ref{skips} \\ +% |singlelinecheck| & switches the single-line-check on or off & \ref{justification} \\ +|singlelinecheck| & включает контроль [оформления] однострочных подписей & \ref{justification} \\ +%|size| & sets the size of font & \ref{x} \\ +% |skip| & sets the skip between content \& caption & \ref{skips} \\ +|skip| & \cell{задаёт отбивку между содержимым флота и~подписи} & \ref{skips} \\ +% |strut| & switches the usage of |\strut|s on or off & \ref{formats} \\ +|strut| & включает использование команды распорки |\strut| & \ref{formats} \\ +% |style| & sets the caption style & \ref{style} \\ +|style| & задаёт стиль оформления подписи & \ref{style} \\ +%|style*| & sets the caption style & \ref{style} \\ +% |subtype| & sets the sub-caption type & \phantom{t}--~\footnotemark \\ +|subtype| & задаёт вывод подписи части флота & \phantom{t}--~\footnotemark \\ +% |tablename|\preambleoption & sets the table name & \ref{names} \\ +|tablename|\preambleoption & задаёт имя таблицы & \ref{names} \\ +% |tableposition|\preambleoption & gives a hint about the table caption position & \ref{skips} \\ +|tableposition|\preambleoption & \cell{даёт подсказку о~положении подписи таблицы + \\(табличного заголовка)} & \ref{skips} \\ +% |tablewithin|\preambleoption & sets the table ``within'' counter & \ref{numbering} \\ +|tablewithin|\preambleoption & \cell{задаёт счётчик раздела, которому подчиняется\\ нумерация таблиц} + & \ref{numbering} \\ +% |textfont|(|+|) & sets the font of the caption text & \ref{fonts} \\ +|textfont|(|+|) & задаёт шрифт для текста подписи & \ref{fonts} \\ +% |textformat| & sets the format of the caption text & \ref{formats} \\ +|textformat| & задаёт формат текста подписи & \ref{formats} \\ +% |twoside| & selects the two-side mode & \ref{margins} \\ +|twoside| & задаёт двустороннюю печать документа & \ref{margins} \\ +% |type| & sets the caption type \& places a hyperlink anchor & \ref{types} \\ +|type| & задаёт тип подписи и~помещает начало гиперссылки & \ref{types} \\ +% |type*| & sets the caption type only & \ref{types} \\ +|type*| & задаёт только тип подписи & \ref{types} \\ +% |width| & sets a fixed caption width & \ref{margins} \\ +|width| & задаёт фиксированную ширину подписи & \ref{margins} \\ +\end{longtable*} +\preambleoptiontext +% \footnotetext{The option \opt{subtype} is explained in the +% \package{subcaption} package documentation.} +\footnotetext{Значение опции \texttt{subtype} объясняется в~документации к~пакету + \package{subcaption}.} + +\nopagebreak\parbox[t]{\linewidth}{% +\begin{Note*} +% Obsolete options are not listed here. See +% \Ref{caption1} and +% \Ref{caption2} for a list of these options.} + Устаревшие опции здесь не перечисляются. За списком этих опций обратитесь к~документации + \Ref{caption1} и~\Ref{caption2}. +\end{Note*}} + +% \subsection{Commands} +\subsection{Команды} + +\begin{longtable*}{lll} +Команда & & Раздел \\ +\hline +\endhead +|\abovecaptionskip| & & \ref{skips} \\ +%|\AtBeginCaption| & & \ref{hooks} \\ +%|\AtEndCaption| & & \ref{hooks} \\ +|\belowcaptionskip| & & \ref{skips} \\ +|\caption| & & \ref{caption} \\ +|\caption*| & & \ref{caption} \\ +|\captionlistentry| & & \ref{captionlistentry} \\ +|\captionof| & & \ref{caption} \\ +|\captionof*| & & \ref{caption} \\ +|\captionsetup| & & \ref{captionsetup} \\ +|\captionsetup*| & & \ref{captionsetup} \\ +|\centerfirst| & & \ref{justification} \\ +|\centerlast| & & \ref{justification} \\ +|\clearcaptionsetup| & & \ref{captionsetup} \\ +|\clearcaptionsetup*| & & \ref{captionsetup} \\ +|\ContinuedFloat| & & \ref{ContinuedFloat} \\ +|\DeclareCaptionFont| & & \ref{declare} \\ +|\DeclareCaptionFormat| & & \ref{declare} \\ +|\DeclareCaptionFormat*| & & \ref{declare} \\ +|\DeclareCaptionJustification| & & \ref{declare} \\ +|\DeclareCaptionLabelFormat| & & \ref{declare} \\ +|\DeclareCaptionLabelSeparator| & & \ref{declare} \\ +|\DeclareCaptionLabelSeparator*| & & \ref{declare} \\ +|\DeclareCaptionListFormat| & & \ref{declare} \\ +|\DeclareCaptionOption| & & \ref{declare} \\ +|\DeclareCaptionStyle| & & \ref{declare} \\ +|\DeclareCaptionSubType| & & --~\footnotemark \\ +|\DeclareCaptionTextFormat| & & \ref{declare} \\ +|\DeclareCaptionType| & & \ref{declare} \\ +|\showcaptionsetup| & & \ref{captionsetup} \\ +\end{longtable*} +% \footnotetext{\cs{DeclareCaptionSubType} is explained in the +% \package{subcaption} package documentation.} +\footnotetext{Команда \cs{DeclareCaptionSubType} описана + в~документации к~пакету \package{subcaption}.} + +\clearpage +% \subsection{Warnings} +\subsection{Предупреждения} + +\begin{Warnings} + +\Message + |\caption outside box or environment.| +\Or + |\captionsetup{type=...} outside box or environment.| +\Or + |\captionsetup{type*=...} or \captionof outside box|\\ + | or environment.| +\Description +% You have placed a |\caption|, |\caption|\-|of|, or +% |\caption|\-|setup{type=|\x\meta{type}|}| command outside an box, group, +% or environment. +% You should not do this since it could cause some bad side-effects. +% \par\See{\Ref{types} and \Ref{caption}} + Вы поместили |\caption|, |\caption|\-|of|, или + |\caption|\-|setup{type=|\x\meta{type}|}| вне бокса, группы + или окружения. + Это может создать побочные эффекты. + \par\See{\Ref{types} и~\Ref{caption}} + +\Message + |\caption will not be redefined since it's already|\\ + |redefined by a document class or package which is|\\ + |unknown to the caption package.| +\Description +% If \thispackage\ detects that some (unknown) document class or +% package has enhanced |\caption|, it will not redefine +% |\caption|, too, since this would simply kill the enhancement. +% As a result some features, like |\caption*|, |\Continued|\-|Float|, +% using the optional argument of |\caption|\-|setup|, +% or the options |list=| and |hypcap=| will not be available.\par +% If you don't care about the original enhancements but would +% like to use the full range of features of \thispackage\ instead +% you can give the unsupported(!) option |compatibility=|\x|false| +% a try and keep your fingers crossed. +% (But you will get the next warning instead.) +% \par\See{\Ref{classes} and \Ref{compatibility}} + \Thispackage\ обнаружил, что используется какой-либо (неизвестный) класс документа или + пакет, расширивший определение |\caption|, поэтому дальнейшее переопределение + |\caption| может уничтожить используемые настройки. + В~результате некоторые особенности, такие как |\caption*|, |\ContinuedFloat|, + использование дополнительного аргумента |\captionsetup|, + или опций |list=| и~|hypcap=| невозможно.\par + Если вам не нужны оригинальные настройки и~важнее использовать + полный спектр возможностей данного пакета, вы можете задать + неподдерживаемую(!) опцию |compatibility=false| + и~надеяться на лучшее. + (Но в~этом случае вы получите следующее предупреждение.) + \par\See{\Ref{classes}} + +\Message + |Forced redefinition of \caption since the|\\ + |unsupported(!) package option `compatibility=false'|\\ + |was given.| +\Description +% Since you were so keen to specify the option |compatibility=|\x|false| +% \thispackage\ will try to do its best to fulfill your wishes. +% But depending on the document class or other packages you use that +% can end in non-functional features or even errors. So keep your +% fingers crossed! + Если вы были столь отважны, задав опцию |compatibility=|\x|false|, + \thispackage\ постарается сделать всё, что вы потребуете. + Но такое использование этого пакета совместно с~таким пакетом или классом + может отключить некоторые особенности или породить ошибки. + Итак, надейтесь на лучшее! + \par\See{\Ref{compatibility}} + +\Message + |Hyperref support is turned off because hyperref has|\\ + |stopped early.| +\Description +% If the \package{hyperref} package stops early during loading +% (because of what-ever reason), the \package{hyperref} support of +% \thispackage\ will not be available. As a result you could get +% \package{hyperref} warnings and non-functional hyperlinks to figures +% or tables. + Если загрузка пакета \package{hyperref} завершилась раньше положенного + (по какой-либо причине), поддержка пакета \package{hyperref} пакетом + \package{caption} будет отключена. В~результате вы получите + \package{hyperref} предупреждения и~нефункционирующие гиперссылки на рисунки + или таблицы. + \par\See{\Ref{hyperref}\,} + +\Message + |Ignoring optional argument [|\meta{pos}|] of \setcapwidth.| +\Description +% \Thispackage\ tries to emulate the \KOMAScript\ commands regarding +% captions as best as it can. But the optional argument of the +% \KOMAScript\ command |\setcapwidth| is not (yet) working if you use +% this package, so if you try to use it anyway, you will get this warning. + \Thispackage\ старается корректно эмулировать команды \KOMAScript, относящиеся к~подписям. + Но опция команды |\setcapwidth| из + \KOMAScript\ ещё не работает вместе с~этим пакетом, + поэтому, если вы решите её использовать, вы получите предупреждение. + \par\See{\Ref{KOMA}} + +\Message + |Internal Warning: |\meta{warning message}|.| +\Description +% You should never see this warning, either you use a package which redefines +% |figure| or |table| and which is unknown to \thispackage, or this is a bug +% in \thispackage. +% Please send me an e-mail reporting this issue. + Надеюсь вы не увидите такого сообщения, оно появится в~случае переопределений окружений + |figure| или |table|, неизвестных данному пакету, или это ошибка самого пакета + \package{caption}. + Пожалуйста, пришлите e-mail с~образцом, дающим это сообщение. + +\Message + |\label before \caption ignored| +\Description +% Regarding |\label| the floating environments behave differently than its +% non-floating counterparts: The internal reference will not be generated +% at the beginning of the environment, but at |\caption| instead. +% So you have to place the |\label| command either just \emph{after} or +% \emph{inside} the caption text (mandatory argument of |\caption|). + Метки, |\label|, к~плавающим объектам работают не так, как неплавающие окружения: + информация для метки генерируется не в~начале окружения, + а~после команды |\caption|. + Поэтому вы должны поместить команду |\label| либо \emph{после} текста + |\caption| либо внутри текста подписи. + +\Message + |Option `|\meta{option}|' was not in list `|\meta{option list}|'.| +\Description +% If you try to remove a specific option of an option list, +% for example with |\clear|\-|caption|\-|setup[po|\-|si|\-|tion]{table}|, +% and this option can not be found inside the option list, you will +% get this warning. If this is not because of a typo and you would like +% to suppress this warning, use |\clear|\-|caption|\-|setup*| instead of +% |\clear|\-|caption|\-|setup|. + Если вы попробуете удалить опцию из списка опций, + например, |\clear|\-|caption|\-|setup[po|\-|si|\-|tion]{table}|, + а~эта опция не была обнаружена в~списке, вы получите + это предупреждение. Если это происходит не из-за опечатки и~вы хотите запретить это + предупреждение, используйте |\clearcaptionsetup*| вместо + |\clearcaptionsetup|. + \par\See{\Ref{captionsetup}} + +\Message + |Option list `|\meta{option list}|' undefined.| +\Description +% If you try to remove a specific option of an option list, +% for example with |\clear|\-|caption|\-|setup[for|\-|mat]{figure}|, +% and this option list is not defined (yet), you will +% get this warning. If this is not because of a typo and you would like +% to suppress this warning, use |\clear|\-|caption|\-|setup*| instead of +% |\clear|\-|caption|\-|setup|. + Если вы попробуете удалить опцию из списка опций, + например, |\clear|\-|caption|\-|setup[for|\-|mat]{figure}|, + а~эта опция не была обнаружена в~списке, вы получите + это предупреждение. Если это происходит не из-за опечатки и~вы хотите запретить это + предупреждение, используйте |\clearcaptionsetup*| вместо + |\clearcaptionsetup|. + \par\See{\Ref{captionsetup}} + +\iffalse +\Message + |Possibly superfluous \restylefloat{|\meta{type}|} detected.|\\ + |If you think that this warning is unjustified,|\\ + |you can switch it off using the caption package|\\ + |option `restylefloatcheck=off'.| +\Description + \TODO +\fi + +\Message + |`ragged2e' package not loaded, therefore|\\ + |substituting \raggedright for \RaggedRight.| +\Description +% The caption option |justification=|\x|RaggedRight| is only full functional +% if you have the \package{ragged2e} package installed in your \TeX\ system. +% If not, you will get this warning, and |justification=|\x|RaggedRight| +% will be treated as |justification=|\x|raggedright|. + Опция |justification=|\x|RaggedRight| будет функционировать + если пакет \package{ragged2e} инсталлирован в~вашей системе \TeX{}. + Если пакета нет, вы получите предупреждение, и~|justification=|\x|RaggedRight| + будет работать как |justification=|\x|raggedright|. + \par\See{\Ref{justification}} + +\Message + |Obsolete option `ignoreLTcapwidth' ignored.| +\Description +% The \package{caption2} package option |ignoreLTcapwidth| will not be +% emulated by this version of \thispackage, usually you can simply wipe it +% away. + Опция пакета \package{caption2}, |ignoreLTcapwidth|, не будет эмулироваться + данной версией пакета, обычно это предупреждение можно игнорировать. + \par\See{\Ref{caption2} and \Ref{longtable}} + +\Message + |`ragged2e' support has been changed. Rerun to get|\\ + |captions right.| +\Description +% The \package{ragged2e} package will only be loaded by \thispackage\ if it +% is actually needed. +% At least two \LaTeX\ runs are needed for that, so on the first run you could +% get this warning. +% Just compile your document again and this warning should go away. + Пакет \package{ragged2e} может быть загружен пакетом \package{caption} если это + действительно необходимо. + По крайней мере для этого нужны две обработки \LaTeX'а, и~при первой обработке + вы получите это сообщение. + Скомпилируйте документ второй раз и предупреждение исчезнет. + \par\See{\Ref{justification}} + +\Message + |Reference on page |\meta{page no.}| undefined.| +\Description +% If you use a |twoside| page layout, \thispackage\ needs to track the +% page numbers to get the margins right. +% At least two \LaTeX\ runs are needed for that, on the first run you could get +% this warning. +% Just compile your document again and this warning should go away. + Если вы используете опцию документа |twoside|, пакету нужно контролировать нумерацию страниц, + чтобы получить верно размещённые поля. + Для этого нужны две обработки \LaTeX'ом, а~при первой обработке вы получите это + сообщение. + Скомпилируйте документ второй раз и предупреждение исчезнет. + \par\See{\Ref{margins}} + +\Message + |The caption type was already set to `|\meta{type}|'.| +\Description +% This warning informs you about mixed caption options. For example if +% you use a |\caption|\-|setup{type=|\x|table}| or +% |\caption|\-|of{table}{|\ldots|}| inside a |figure| environment, +% this would result in using both option sets for that specific caption, +% the one for |figure| (specified with |\caption|\-|setup[figure]{|\ldots|}|) +% and the one for |table| (specified with |\caption|\-|setup[table]{|\ldots|}|) +% as well.\par +% {\small(You can suppress this warning by using the starred form +% |\caption|\-|setup*{type=|\x\ldots|}|.)\par} + Это предупреждение информирует о~смешении опций. Например, + вы используете |\captionof{table}{|\ldots|}| внутри окружения |figure|, + это является результатом использования обеих опций для этой специфической подписи: + для |figure| (заданной с~помощью |\captionsetup[figure]{|\ldots|}|) + и~для |table| (заданной с~помощью |\captionsetup[table]{|\ldots|}|).\par + {\small(Вы можете отключить это предупреждение, используя звёздную форму команды + |\caption|\-|setup*{type=|\x\ldots|}|.)\par} + \par\See{\Ref{captionsetup}} + +\Message + |The option `hypcap=true' will be ignored for this|\\ + |particular \caption.| +\Description +% \Thispackage\ hasn't found a proper hyperlink anchor for this particular +% caption, so it decides to ignore the setting |hypcap=|\x|true| (which is set by +% default). As a result a link to this caption (e.g.~in the List of Figures, +% or set by |\ref| or |\auto|\-|ref|) will link you to the caption of the figure +% or table, not to the figure or table itself.\par + \Thispackage\ не нашёл подходящее место для гиперссылки для данной + подписи, поэтому пакет решает игнорировать настройки |hypcap=|\x|true| (заданные + по умолчанию). В~результате ссылка на эту подпись (например, в~Списке рисунков, + или в~командах |\ref| или |\autoref|) будет привязана к~подписи рисунка или таблицы, + а~не к~содержимому рисунка или таблицы.\par +% This can happen if you use |\caption|\-|of| inside a non-floating environment, +% but also if you use some package which redefines |figure| or |table|, and +% which is unknown to \thispackage.\par + Это может произойти если вы используете команду |\captionof| в~неплавающем окружении, + а~также при использовании пакета, переопределяющего окружения |figure| или |table|, + неизвестного данному пакету.\par +% If this is ok for you but you want to suppress this warning, simply place a +% |\caption|\-|setup{hyp|\-|cap=|\x|false}| just before the |\caption| or +% |\caption|\-|of| command which is causing the warning. + Если вам это подходит и~вы хотите запретить это предупреждение, задайте код + |\caption|\-|setup{hyp|\-|cap=|\x|false}| перед |\caption| или + |\captionof|, которые порождают предупреждение. +% If this is not ok for you, you can set a hyperlink anchor with +% |\caption|\-|setup{type=|\x\meta{float type}|}| for yourself. + Если же это вас не устраивает, вы можете попробовать задать гиперссылку, с~помощью + |\caption|\-|setup{type=|\x\meta{float type}|}|. + \par\See{\Ref{hyperref}} + +\Message + |Unsupported document class (or package) detected,|\\ + |usage of the caption package is not recommended.| +\Description +% Either the document class you use is unknown to \thispackage, or you +% have included a package in your document which redefines |\@make|\-|caption| +% (which is responsible for typesetting the caption internally) as well. +% This means \thispackage\ will either change the design of captions in an +% unwanted way, or it even refuses to work correctly at all. + Либо класс документа неизвестен данному пакету, либо вы + подключили пакет, который переопределяет команду |\@makecaption| + (внутренняя команда, создающая подписи). + Это означает что \thispackage\ изменит оформление подписей в~нежелательным способом, + или вообще откажется работать. + \par\See{\Ref{classes} и~\Ref{compatibility}} + +\Message + |Unused \captionsetup[|\meta{type}|].| +\Description +% You have specified options with |\caption|\-|setup[|\meta{type}|]| which are +% not used later on. +% This can be because of a typo in \meta{type}, +% or because you use a package which redefines |figure| or |table| and +% which is unknown to \thispackage, or simply because you don't have any usage +% of the environment \meta{type} after this line. +% (If you want to suppress this warning you can use |\caption|\-|setup*| +% instead of |\caption|\-|setup|.) + Вы определили опции |\captionsetup[|\meta{type}|]| которые + позднее не использовались. + Это может произойти из-за опечатки в~аргументе \meta{type}, + или потому, что вы используете пакет, который переопределяет окружения |figure| или |table|, + неизвестный данному пакету, или просто вы не использовали окружения + \meta{type} после заданных настроек.\par + (Если вы хотите запретить это предупреждение, вы можете задать |\captionsetup*| вместо + |\captionsetup|.)\enlargethispage{\baselineskip} + \par\See{\Ref{captionsetup}} + +\Message + |Usage of the |\meta{package}| package together with the|\\ + |caption package is strongly not recommended.|\\ + |Instead of loading the |\meta{package}| package you should|\\ + |use the caption package option `tableposition=top'.| +\Description +% The package \meta{package} is dealing with caption skips as well. +% Please decide which one do you actually want to use, \thispackage\ or the +% other one, using both can lead to wrong skips above or below the caption. + Пакет \meta{package} изменяет отбивки вокруг подписи. + Решите, чей интерфейс вы предпочтёте: \thispackage\ или + другой пакет, использование обоих может задать неверные отбивки вокруг подписи. + \par\See{\Ref{skips}} + +\end{Warnings} + +\pagebreak[3] +%^^A\subsection{Errors} +\subsection{Сообщения об ошибках} + +\begin{Warnings} + +\Message + |Argument of \@caption has an extra }.| +\Or + |Paragraph ended before \@caption was complete.| +\Description +% If you want to typeset something special (like a tabular) as caption, +% you need to give an optional argument to |\caption| resp.~|\caption|\-|of| +% for the List of Figures resp.~List of Tables, too, even if you don't +% use such list. + Если вы хотите создать что-то необычное (например таблицу) внутри подписи, + вы должны задать дополнительный аргумент для команды |\caption| или |\captionof|, + чтобы поместить текст в~Список рисунков или таблиц, даже если вы не используете + такой список. + \par\See{\Ref{caption}, \Ref{lists}, и~\Ref{hyperref}\,} + +\Message + |\caption outside float.| +\Description +% You have placed a |\caption| command outside a floating environment, or +% a |long|\-|table| or |wrap|\-|figure|. +% If this is what you want to, please use either +% |\caption|\-|setup{type=|\x\meta{type}|}| $+$ |\caption| or +% |\caption|\-|of|. + Вы поместили команду |\caption| за пределами окружения флота или + |longtable|. Если вы делаете это сознательно, задайте + |\captionsetup{|\x|type=|\x\meta{type}|}| $+$ |\caption| или |\captionof|. + \par\See{\Ref{caption}} + +\Message + |\ContinuedFloat outside float.| +\Description +% You have placed a |\Continued|\-|Float| command outside a floating +% environment. % or |long|\-|table|. + Вы поместили команду |\ContinuedFloat| вне окружения флота. +% If this is what you want to, please use the combination +% |\caption|\-|setup{type=|\x\meta{type}|}| $+$ |\Continued|\-|Float|.\par + Если вы это сделали сознательно, используйте комбинацию + |\captionsetup{|\x|type=|\x\meta{type}|}| $+$ |\ContinuedFloat|.\par +% Please note that |\Continued|\-|Float| inside a |long|\-|table| is not +% working, but maybe using the |long|\-|table*| environment, which +% typesets a |long|\-|table| without incrementing the |table| counter, +% if sufficient for you. + Обратите внимание, что использование |\ContinuedFloat| внутри |longtable| (пока) не работает, + но, возможно использование окружения |longtable*|, которое создаёт |longtable| + без увеличения нумерации |table|, решит ваши проблемы. + \par\See{\Ref{ContinuedFloat} и~\Ref{longtable}} + +\Message + |Continued `|\meta{type}|' after `|\meta{type}|'.| +\Description +% Continued figures or tables are not allowed to be interrupted by a floating +% environment (or |long|\-|table|) of another type, +% e.g.~a table between a figure and a continued figure. + Продолжающиеся рисунки или таблицы не должны прерываться + окружением другого типа (или окружением |long|\-|table|), + например таблица между рисунком и~его продолжением. + \par\See{\Ref{ContinuedFloat}} + +\Message + |For a successful cooperation of the `wrapfig' package|\\ + |with the `float' package you should load the `wrapfig'|\\ + |package *(right) after* the `float' package.| +\Description +% Please take care of the load order of packages +% if you use the \package{wrapfig} package in cooperation with the +% \package{float} package. + Будьте внимательны с~порядком загрузки пакетов, если вы используете + пакет \package{wrapfig} совместно с~пакетом + \package{float}. + \par\See{\Ref{wrapfig}} + +\Message + |For a successful cooperation of the `wrapfig' package|\\ + |with the `float' package you should use at least|\\ + |`wrapfig' version 3.6.| +\Description +% Please take care of the version of the \package{wrapfig} package +% if you use the \package{wrapfig} package in cooperation with the +% \package{float} package. + Обратите внимание на версию пакета \package{wrapfig}, которую вы используете, + если вы используете этот пакет вместе с~пакетом + \package{float}. + \par\See{\Ref{wrapfig}} + +\Message + |For a successful cooperation we need at least version|\\ + |`|\meta{date}|' of package |\meta{package}|, but only version|\\ + |`|\meta{old-date}|' is available.| +\Description +% \Thispackage\ does not work with such an outdated package, please update it +% to a more recent version, at least to the one requested. + \Thispackage\ не работает с~данной версией пакета, обновите его, + как минимум до требуемой версии. + +\Message + |Internal Error: |\meta{error message}|.| +\Description +% You should never see this error. +% Please send me an e-mail reporting this issue. + Вы не должны получать такое сообщение. + Пожалуйста, пришлите e-mail с~образцом, дающим это сообщение. + +\Message + |No float type '|\meta{type}|' defined.| +\Description +% The \meta{type} you have specified in |\caption|\-|setup{type=|\x\meta{type}|}|, +% |\caption|\-|of|\marg{type}, or |\Declare|\-|Caption|\-|Sub|\-|Type| is +% not defined. +% \meta{type} should be either `\texttt{figure}' or `\texttt{table}', or +% any other floating environment defined with |\Declare|\-|Caption|\-|Type|, +% |\new|\-|float| offered by the \package{float} package\cite{float}, +% or |\Declare|\-|New|\-|Float|\-|Type| offered by the \package{floatrow} +% package\cite{floatrow}. + Тип флота \meta{type}, который вы выбрали в~командах |\captionsetup|\x|{type=|\x\meta{type}|}|, + |\captionof|\x\marg{type} или |\Declare|\-|Caption|\-|SubType| не определён. + Флот \meta{type} должен быть либо `\texttt{figure}' или `\texttt{table}', или + любое другое окружение определённое с~помощью команды |\Declare|\-|Caption|\-|Type|, + |\newfloat|, предлагаемой пакетом \package{float}\cite{float}, + или |\Declare|\-|NewFloat|\-|Type| предлагаемой пакетом \package{floatrow}\cite{floatrow}. + +\Message + |Not allowed in longtable* environment.| +\Description +% The usage of |\caption| is not allowed inside the |long|\-|table*| environment. +% Please use either |\caption*| for a caption without label or use the regular +% |long|\-|table| environment instead. + Использование команды |\caption| невозможно внутри окружения |long|\-|table*|. + Либо используйте команду |\caption*| для создания подписи, либо замените окружение на + |longtable|. + +\Message + |Not available in compatibility mode.| +\Description +% The feature required is not supported in compatibility mode. +% `compatibility mode' means that \thispackage\ has detected either an +% incompatible document class or an incompatible package which also +% extents the |\caption| command. Leaving the original extension intact, +% some features of \thispackage\ are not supported. + Требуемая настройка не поддерживается в~режиме совместимости. + Термин `compatibility mode' («режим совместимости») означает, что \thispackage\ обнаружил + несовместимый класс документа или пакет, который модифицирует + команду |\caption|. Оставив оригинальные настройки нетронутыми, + \thispackage\ отменяет некоторые свои настройки. + \par\See{\Ref{compatibility}} + +\Message + |Only one \caption can be placed in this environment.| +\Description +% Inside the environments offered by the \package{fltpage} and \package{sidecap} +% package only \emph{one} caption can be placed. (This is due implementation design.) + Внутри окружений, предлагаемых пакетами \package{fltpage} и~\package{sidecap} + можно поместить только одну подпись. (Это требования оформления.) + +\Message + |Option clash for package caption.| +%\Or[but sometimes also] +\Or[но иногда также] + |Missing \begin{document}.| +\Description +% \Thispackage\ has already been loaded by some other \LaTeX\ package, +% so you can't do that again specifying different options. +% A candidate causing this could be the \package{subfig} package; if this is +% the case, please load \thispackage\ \emph{before} the \package{subfig} +% package or specify the option |caption=|\x|false| while loading the +% \package{subfig} package. +% \par\See{the \package{subfig} package\cite{subfig} documentation} + \Thispackage\ уже загружен другим пакетом \LaTeX'а, + и~нельзя загружать пакет повторно, задав другие опции. + Первой причиной вызвавшей такое сообщение может быть пакет \package{subfig}; + и~если это так, + загрузите \thispackage\ \emph{до} пакета \package{subfig} + или определите |caption=|\x|false| при загрузке + \package{subfig}. + \par\See{документацию пакета \package{subfig}\cite{subfig}} + +\Message + |Paragraph ended before \caption@makecurrent was complete.| +\Or + |Paragraph ended before \caption@prepareanchor was complete.| +\Description +% If you want to typeset multi-paragraph captions, you need to give an +% optional argument to |\caption| resp.~|\caption|\-|of| for the List of +% Figures resp.~List of Tables, too, even if you don't use such list. +% \par\See{\Ref{caption}, \Ref{lists}, and \Ref{hyperref}\,} + Если вам нужно создать подпись из нескольких абзацев, вы должны создать + дополнительный аргумент в~командах |\caption| или~|\captionof| для Списка рисунков или + Списка таблицы, даже если вы не используете эти списки. + \par\See{\Ref{caption}, \Ref{lists}, и~\Ref{hyperref}\,} + +\iffalse % was removed in v3.1b +\Message + |Something is going wrong here...|\\ + |For a removal of this problem please consult the|\\ + |caption package documentation, especially the sections|\\ + |about the `float' and the `wrapfig' package.| +\Description +% Please take care of the load order of packages +% if you use the \package{wrapfig} package in cooperation with the +% \package{float} package. But maybe a different package tried to extent +% the \package{float} package in a manner which is incompatible to +% \thispackage!? +% \par\See{\Ref{float} and \Ref{wrapfig}} + Обратите внимание на порядок загруженных пакетов, + если вы используете пакет \package{wrapfig} вместе с~пакетом + \package{float}. Но возможно какой"=то другой пакет пытается расширить настройки пакета + \package{float} неизвестным пакету \package{caption} способом!? + \par\See{\Ref{float} и~\Ref{wrapfig}} +\fi + +\Message + |Something's wrong--perhaps a missing \caption|\\ + |in the last figure or table.| +\Description +% It seems that you have used a |\sub|\-|caption| command (or a different one +% which has typeset a sub-caption) without a corresponding |\caption| command. +% This is not supported. + Возможно вы использовали команду |\sub|\-|caption| (или другую команду, создающую + подпись части рисунка) без соответствующей команды |\caption|. + Это не поддерживается. + +\Message + |The option `labelsep=|\meta{name}|' does not work|\\ + |with `format=hang'.| +\Or + |The option `labelsep=|\meta{name}|' does not work|\\ + |with \setcaphanging (which is set by default).| +\Description +% A caption label separator which contains a |\\| command (like +% |labelsep=|\x|newline|) can not be combined with a hanging caption format +% (like |format=|\x|hang|). +% Please select either another caption label separator +% (e.g.~|labelsep=|\x|colon|) or another caption format +% (e.g.~|format=|\x|plain|). +% \par\See{\Ref{formats} resp.~\Ref{KOMA}} + Разделитель нумерационного заголовка и~текста подписи, заданный как команда |\\| (т.\,е. + |labelsep=|\x|newline|) не может быть скомбинирован с~форматом создающим строку на весу + (like |format=|\x|hang|). + Задайте либо другой разделитель + (например~|labelsep=|\x|colon|) либо другой формат подписи + (e.g.~|format=|\x|plain|). + \par\See{\Ref{formats} или~\Ref{KOMA}} + +\Message + |The package option `caption=false' is obsolete.|\\ + |Please pass this option to the subfig package instead|\\ + |and do *not* load the caption package anymore.| +\Description +% You have specified the option |caption=|\x|false|. This used to be a workaround +% for not using the whole \package{caption} package (leaving the caption stuff +% offered by the document class or other packages intact), but keeping the +% \package{subfig} package working. This mechanism is obsolete and not offered +% anymore, please pass this option to the \package{subfig} package instead and +% do not load \thispackage\ anymore. +% \par\See{the \package{subfig} package\cite{subfig} documentation} + Вы задали опцию |caption=|\x|false|. Это используется для того, + чтобы не использовать пакет \package{caption} целиком (оставив изменения команд + подписей, сделанные классом документа или другим пакетом нетронутыми), но позволяет работать + пакету \package{subfig}. Этот механизм устаревший и~более не поддерживается, + поэтому используйте эту опцию при загрузке пакета \package{subfig} и~не загружайте + \thispackage\ вовсе. + \par\See{документацию пакета \package{subfig}\cite{subfig}} + +\Message + |Undefined boolean value `|\meta{value}|'.| +\Description +% You tried to set a boolean option (like |singlelinecheck=| or |hypcap=|) +% with an improper value. Only |false|, |no|, |off|, |0| or |true|, |yes|, +% |on|, |1| is allowed here. + Вы пытались задать булев ключ (например, |singlelinecheck=| или |hypcap=|) + с~неверной опцией. Только |false|, |no|, |off|, |0| или |true|, |yes|, + |on|, |1| допускаются в~опциях этих ключей. + +\Message + |Undefined format `|\meta{name}|'.| +\Description +% You tried to set a caption format which does not exists. +% Maybe a typo!? + Вы пытаетесь задать формат подписи, который не существует. + Может быть это опечатка!? + \par\See{\Ref{formats}} + +\Message + |Undefined label format `|\meta{name}|'.| +\Description +% You tried to set a caption label format which does not exists. +% Maybe a typo!? + Вы пытаетесь загрузить формат метки, который не существует. + Может быть это опечатка!? + \par\See{\Ref{formats}} + +\Message + |Undefined label separator `|\meta{name}|'.| +\Description +% You tried to set a caption label separator which does not exists. +% Maybe a typo!? + Вы пытаетесь задать разделитель, который не существует. + Может быть это опечатка!? + \par\See{\Ref{formats}} + +\Message + |Undefined list format `|\meta{name}|'.| +\Description +% You tried to set a caption list-of format which does not exists. +% Maybe a typo!? + Вы пытаетесь задать формат вывода для Списка флотов, который не существует. + Может быть это опечатка!? + \par\See{\Ref{lists}} + +\Message + |Undefined position `|\meta{name}|'.| +\Description +% You tried to set a caption position with an improper value. +% Maybe a typo!? + Вы пытаетесь задать опцию расположения подписи, которая не существует. + Может быть это опечатка!? + \par\See{\Ref{skips}} + +\Message + |Undefined style `|\meta{name}|'.| +\Description +% You tried to set a caption style which does not exists. +% Maybe a typo!? + Вы пытаетесь задать стиль подписи, который не существует. + Может быть это опечатка!? + \par\See{\Ref{style}} + +\Message + |Usage of the `position' option is incompatible|\\ + |to the `|\meta{package}|' package.| +\Description +% % (ftcap,nonfloat,topcapt) +% The given package is dealing with caption skips as well. +% Please decide which one do you actually want to use: The |position=| option +% of \thispackage\ or the mechanism of the other one; using both this way +% would lead to wrong skips above or below the caption and is therefore +% not supported. + Данный пакет изменяет отбивки вокруг подписи. + Решите, каким пакетом что вы собираетесь использовать: ключ |position=| + пакета \package{caption} или механизм другого пакета; использование обоих пакетов + может породить неверные отбивки сверху или снизу подписи и~соответственно не поддежривается. + \par\See{\Ref{skips}} + +\Message + |Undefined text format `|\meta{name}|'.| +\Description +% You tried to set a caption text format which does not exists. +% Maybe a typo!? + Вы пытаетесь задать формат текста подписи, который не существует. + Может быть это опечатка!? + \par\See{\Ref{formats}} + +\Message + |You can't use both, the (obsolete) caption2 *and*|\\ + |the (current) caption package.| +\Description +% This error message says it all, you simply can't do that. +% Please use only \thispackage. + Это сообщение об ошибке сказало уже всё, и~вам просто нельзя это делать + [использовать пакеты \package{caption} и~\package{caption}2]. + Используйте только \thispackage. + \par\See{\Ref{caption2}} + + +\end{Warnings} + % --------------------------------------------------------------------------- % -% \fi -% -% \pagebreak[3] -%^^A \section{Further reading} -% \section{Рекомендуемая литература} -% -%^^A I recommend the following documents for further reading: -% Я рекомендую следующие документы для дальнейшего чтения: -% \begin{itemize} -% \def\tempa{ftm}\ifx\rmdefault\tempa -% \fontencoding{T1}\fontfamily{ptm}\selectfont\fi -% \item -% The \TeX\ FAQ - Frequently asked questions about \TeX\ and \LaTeX : -% \begin{quote}\url{http://faq.tug.org/}\end{quote} -% -% \item -% A French FAQ can be found at -% \begin{quote}\url{http://www.grappa.univ-lille3.fr/FAQ-LaTeX/}\end{quote} -% -% \item -% \textsf{epslatex} from Keith Reckdahl contains many tips around -% including graphics in \LaTeXe\ documents. -% You will find this document in the directory -% \begin{quote}\url{ftp://ftp.ctan.org/pub/tex/info/epslatex/}\end{quote} -% \end{itemize} -% -% \iffalse + +\clearpage +% \section{Version history} +\section{История создания версий} +\label{history} + +% The version $1.0$ was written in 1994 and was offering a handful of options +% to customize the look \& feel of the captions. +% Furthermore this version already supported the \package{rotating} and +% \package{subfigure} packages. +% Version $1.1$ introduced the |center|\-|last| option; +% version $1.2$ added the support of the \package{float} package. +% Version $1,3$ offered a better support of the \package{subfigure} package, +% while version $1.4$ came with the new option |nooneline|. +Версия $1.0$ была написана в~1994~году и~предлагала множество опций +для настройки вывода подписей. Кроме того эта версия уже поддерживала пакеты +\package{rotating} и~\package{subfigure}. +Версия $1.1$ предложила опцию |center|\-|last|; +версия $1.2$ добавила +поддержку пакета \package{float}. +Версия $1.3$ предложила улучшенную поддержку пакета \package{subfigure}, +тогда как версия $1.4$ вышла с~поддержкой опции |nooneline|. + +% The \package{caption2} package $2.0$ was an experimental side-version of +% the regular \package{caption} package. It was made public as beta test version +% without proper documentation in 1995 because of the strong demand for new +% features and adaptations to additional packages like the \package{longtable} +% package. +% Furthermore it offered a revised support of the \package{subfigure} package. +% (A version $2.1$ was offered as bugfix-release in 2002.) +Пакет \package{caption2} версии $2.0$ был экспериментальной побочной версией +основного пакета \package{caption}. Он был опубликован как бета-тест-версия +без соответствующей документации в~1995~году, так как уже назрела необходимость +в~новых настройках для других пакетов, например для \package{longtable}. +Помимо этого была предложена поддержка пакета \package{subfigure}. +(В~версии $2.1$, написанной в~2002~году были исправления ошибок.) + +% In 2003 I finally found some time, so a new regular release $3.0$ +% of the \package{caption} package could be build in cooperation with +% Frank Mittelbach and Steven Cochran. +% It was released in December 2003 and superseded the neglected +% \package{caption2} package. +% Main parts were re-written and it provided a complete re-work of +% the user interface. +% Furthermore it supported the \package{hyperref}, \package{hypcap}, +% \package{listings}, \package{sidecap}, and \package{supertabular} packages +% additionally. +В~2003~году я всё-таки нашёл немного времени, для нового релиза $3.0$ +пакета \package{caption}, созданного совместно +с~Франком Миттельбахом (Frank Mittelbach) и~Стивеном Кокрейном (Steven Cochran). +Эта версия была опубликована в~декабре 2003~года и~стала заменой +пакета \package{caption2}. +Основные части были переписаны, и~был предложен новый пользовательский интерфейс. +Помимо этого появилась поддержка других пакетов \package{hyperref}, \package{hypcap}, +\package{listings}, \package{sidecap} и~\package{supertabular}. + +% While all the previous versions were designed for usage with the standard +% \LaTeX\ document classes \class{article}, \class{report}, and \class{book}, +% the current version $3.1$ released in 2007 also supports the \AmS, +% \KOMAScript, \NTG, and \SmF\ document classes, and the \class{beamer} class +% as well. +В~то время как предыдущие версии были созданы для стандартных классов +\LaTeX'а: \class{article}, \class{report} и~\class{book}, +текущая версия $3.1$, опубликованная в~2007~году предлагает также поддержку для пакетов \AmS, +\KOMAScript, {\NTG} и~\SmF, а~также класса \class{beamer}. +% Furthermore it was adapted to the \package{frenchb} Babel option, +% the \package{frenchle} \& \package{frenchpro} packages, +% and the \package{floatflt}, \package{fltpage}, \package{picinpar}, +% \package{picins}, \package{setspace}, \package{threeparttable}, +% and \package{wrapfig} packages. +Помимо этого создана поддержка к~опции \package{frenchb} пакета \package{babel}, +пакетам \package{frenchle} и~\package{frenchpro}, +а~также пакетам \package{floatflt}, \package{fltpage}, \package{picinpar}, +\package{picins}, \package{setspace}, \package{threeparttable} +и~\package{wrapfig}. +% New options and commands were introduced as well, among other things +% |font+|, |figure|\-|within| \& |table|\-|within|, +% |list| \& |list|\-|format|, |max|\-|margin| \& |min|\-|margin|, +% |\caption|\-|list|\-|entry|, |\Declare|\-|Caption|\-|List|\-|Format|, and +% |\Declare|\-|Caption|\-|Type|. +Были предложены новые команды и~ключи, например помимо прочего +|font+|, |figure|\-|within| и~|table|\-|within|, +|list| и~|list|\-|format|, |max|\-|margin| и~|min|\-|margin|, +|\caption|\-|list|\-|entry|, |\Declare|\-|Caption|\-|List|\-|Format| и~% +|\Declare|\-|Caption|\-|Type|. +% Further benefits are the new compatibility check \see*{\Ref{compatibility}}, +% the new ``hypcap'' feature \see*{\Ref{hyperref}\,}, and the sub-caption +% feature \see*{\package{subcaption} package documentation}. +В~дальнейшем были добавлены контроль совместимости с~классами и~пакетами +\see*{\Ref{compatibility}}, +поддержка опции |hypcap| \see*{\Ref{hyperref}} +и~возможности создания подписей частей флотов +\see*{документацию к~пакету \package{subcaption}}. + +\clearpage +% \section{Compatibility to older versions} +\section{Совместимость со старыми версиями} + +\subsection{Пакет \package{caption} v\texorpdfstring{$1.x$}{1.x}} +\label{caption1} + +% This version of \thispackage\ still supports the old options +% and commands provided by the version $1.0$ to $1.4$ of this package. +% So there shouldn't occur any problems compiling old documents, but please +% don't mix old options and commands with the new ones. This isn't supported +% and can cause ugly side effects. +Данная версия пакета поддерживает старые опции и~команды +созданные в~версиях $1.0$--$1.4$ этого пакета. Поэтому не должно возникать +проблем в~компиляции старых документов, но, пожалуйста, не смешивайте +старые опции и~команды с~новыми. Это не поддерживается +и~может дать неприятные побочные эффекты. + +% Here comes a short oversight of the obsolete options and how +% they have been replaced within this version of \thispackage: +Здесь дан краткий обзор устаревших опций и~команд и~чем +они заменены в~современной версии пакета \package{caption}: + +\begin{center}\small +\begin{tabular}{ll} +\package{caption} \version{1.x} & \package{caption} \version{3.x}\\ +\hline +%\endhead +|normal| & |format=plain|\\ +|hang| & |format=hang|\\ +|isu| & |format=hang|\\ +|center| & |justification=centering|\\ +|centerlast| & |justification=centerlast|\\ +%|anne| & |justification=centerlast|\\ +|nooneline| & |singlelinecheck=off|\\ +|scriptsize| & |font=scriptsize|\\ +|footnotesize| & |font=footnotesize|\\ +|small| & |font=small|\\ +|normalsize| & |font=normalsize|\\ +|large| & |font=large|\\ +|Large| & |font=Large|\\ +|up| & |labelfont=up|\\ +|it| & |labelfont=it|\\ +|sl| & |labelfont=sl|\\ +|sc| & |labelfont=sc|\\ +|md| & |labelfont=md|\\ +|bf| & |labelfont=bf|\\ +|rm| & |labelfont=rm|\\ +|sf| & |labelfont=sf|\\ +|tt| & |labelfont=tt|\\ +\end{tabular} +\end{center} + +% Beside the options for setting up the desired font there were also +% the commands |\caption|\-|size| resp.~|\caption|\-|font| and +% |\caption|\-|label|\-|font| who could be redefined with +% |\re|\-|new|\-|command| and allowed an alternate and more flexible way to +% change the font used for captions. +% This mechanism was replaced by the commands +Помимо опций для настроек нужного шрифта были также команды +|\caption|\-|size|, а~также |\caption|\-|font| и~|\caption|\-|label|\-|font| +которые могли быть переопределены с~помощью |\renewcommand| и~позволяли +альтернативный и~более гибкий способ изменить шрифт подписей. +Данный механизм заменён на команды +\begin{quote} + |\DeclareCaptionFont{|\ldots|}{|\ldots|}|\qquad и\\ + |\captionsetup{font=|\ldots|,labelfont=|\ldots|}|\qquad. +\end{quote} +\SeeUserDefined + +% Setting the margin for captions was done in \version{1.x} with +Установки полей в~версии \version{1.x} задавались с~помощью +\begin{quote} + |\setlength{\captionmargin}{|\ldots|}|\quad. +\end{quote} +% This was replaced by +Это заменено на +\begin{quote} + |\captionsetup{margin=|\ldots|}|\qquad. +\end{quote} +\See{\Ref{margins}} + +% For example the old-style code +Например, старый код +\begin{quote} + |\usepackage[hang,bf]{caption}|\\ + |\renewcommand\captionfont{\small\sffamily}|\\ + |\setlength\captionmargin{10pt}| +\end{quote} +% will still work fine, but should be written today as +до сих пор работает, но лучше переписать его как +\begin{quote} + |\usepackage[format=hang,labelfont=bf,font={small,sf},|\\ + | margin=10pt]{caption}| +\end{quote} +% or +или +\begin{quote} + |\usepackage{caption}|\\ + |\captionsetup{format=hang,labelfont=bf,font={small,sf},|\\ + | margin=10pt}|\qquad. +\end{quote} + +% The quite exotic option |ruled| which allowed a partial usage of +% the caption settings for |ruled| floats defined with the +% \package{float} package will be emulated by this version of the +% caption package, too. +% But using this option is not recommended anymore since this +% version of \thispackage\ offers a more flexible way +% for changing the captions of these floating environments: +Такая экзотическая опция |ruled|, которая позволяла частично использовать +настройки подписи для флотов с~оформлением |ruled| из пакета +\package{float}, эмулируется и~данным пакетом тоже. +Но использование этой опции не рекомендуется, поскольку данная версия пакета +предлагает более гибкий способ для изменения подписей +таких окружений плавающих флотов: +\begin{quote} + |\DeclareCaptionStyle{ruled}{|\ldots|}| +\end{quote} +% resp. +и, соответственно +\begin{quote} + |\captionsetup[ruled]{|\ldots|}|\qquad. +\end{quote} +\SeeUserDefined[, \Ref{captionsetup}, и~\Ref{float}] + +\subsection{Пакет caption2 v\texorpdfstring{$2.x$}{2.x}} +\label{caption2} + +% Although they do very similar stuff, the packages \package{caption} and +% its experimental and now obsolete variant \package{caption2} have a +% very different implementation design. +% Therefore a full compatibility could not be offered. +% For that reason you will still find a file called |caption2.sty| in +% this package distribution, so old documents using the \package{caption2} +% package will still compile fine. +Хотя используются одни и~те же настройки и~в~пакете \package{caption} +и~в~экспериментальной, но сейчас устаревшей версии"=пакете +\package{caption2}, у~этих пакетов совершенно разный механизм их задания. +Поэтому полная совместимость невозможна. +По этой причине до сих пор существует пакет |caption2.sty| в~данном +дистрибутиве, и~старые документы, использующие пакет \package{caption2} +будут компилироваться. + +% Newly created documents should use the actual version of +% \thispackage\ instead. In most cases it's sufficient to replace the command +Новые документы должны использовать современные версии пакета +\package{caption}. В~большинстве случаев можно заменить строку +\begin{quote} + |\usepackage[...]{caption2}| +\end{quote} +% by +на +\begin{quote} + |\usepackage[...]{caption}|\qquad. +\end{quote} +% But some options and commands will not be emulated, so you can get +% error messages afterwards. This section will hopefully help you removing +% these errors. If you have problems migrating from \package{caption2} +% to \package{caption} please don't hesitate to send me an e-mail asking +% for help. +Но некоторые опции и~команды не эмулируются, и~вы можете +получить сообщения об ошибках. Данный раздел поможет вам ликвидировать +такие ошибки. Если у~вас проблемы по замене пакета \package{caption2} +на \package{caption} не раздумывайте и~отправляйте мне e-mail. + +% In addition to the obsolete options shown in the last section +% these ones will be emulated, too: +Помимо устаревших опций из предыдущего раздела +следующие также эмулируются: + +\begin{center}\small +\begin{tabular}{ll} +\package{caption2} \version{2.x} & \package{caption} \version{3.x}\\ +\hline +%\endhead +|flushleft| & |justification=raggedright|\\ +|flushright| & |justification=raggedleft|\\ +|oneline| & |singlelinecheck=on|\\ +\end{tabular} +\end{center} + +% Setting the margin for captions was done in \version{2.x} with +Задание втяжек (полей) для подписей, созданных в~\version{2.x} +\begin{quote}\leavevmode\hbox{% + |\setcaptionmargin{|\ldots|}| или, соответственно + |\setcaptionwidth{|\ldots|}|\quad. +}\end{quote} +% This was replaced by +Они могут быть заменены на +\begin{quote}\leavevmode\hbox{% + |\captionsetup{margin=|\ldots|}| или, соответственно + |\captionsetup{width=|\ldots|}|\quad. +}\end{quote} +\See{\Ref{margins}} + +% Setting an indention was done in \version{2.x} with +Втяжка в~версии \version{2.x} задавалась как +\begin{quote} + |\captionstyle{indent}|\\ + |\setlength\captionindent{|\ldots|}|\quad. +\end{quote} +\pagebreak[3] +% This is now done with +Сейчас это задаётся как +\nopagebreak[3] +\begin{quote} + |\captionsetup{format=plain,indention=|\ldots|}|\quad. +\end{quote} + +% The so-called single-line-check was controlled by the commands +% |\oneline|\-|captions|\-|false| (for switching the check off) and +% |\oneline|\-|captions|\-|true| (for switching the check on). +% This was replaced by +Контроль короткой подписи контролируется командами +|\oneline|\-|captions|\-|false| (отключает контроль) +и~|\oneline|\-|captions|\-|true| (для включения контроля). +Это заменено на +|\caption|\-|setup{single|\-|line|\-|check=|\x|off}| +% resp. +и, соответственно +|\caption|\-|setup{single|\-|line|\-|check=|\x|on}|. +\See{\Ref{justification}} + +% The commands +Команды +\begin{quote} + |\captionlabeldelim|, |\captionlabelsep|, |\captionstyle|,\\ + |\defcaptionstyle|, |\newcaptionstyle|, и~|\renewcaptionstyle| +\end{quote} +% do not have a simple replacement and therefore will not be emulated +% by this version of \thispackage. (So using them will +% cause error messages.) Rewriting such code is not always easy and +% straight-ahead, but by conscientious reading of this manual you should +% be able to find appropriate options and commands instead. +не имеют простой замены поэтому не эмулируются +данной версией пакета. (Их использование вызовет +сообщение об ошибке.) Замена этого кода не всегда проста, +но добросовестно прочитав данное руководство, вы сможете найти +подходящие опции и~команды замены. + +\iffalse +... (some examples) +\fi + +% The \version{2.x} option |ignore|\-|LT|\-|cap|\-|width| do not have a +% replacement, too. +% But in most cases you can simply drop using that option because +% in this version of \thispackage\ the value of |\LT|\-|cap|\-|width| +% will be ignored anyway (unless you set it to a different value than the +% default one which is |4in|). +Опция |ignore|\-|LT|\-|cap|\-|width| версии \version{2.x} тоже не имеет замены. +Но в~большинстве случаев эту опцию можно опустить, потому что в~данной +версии пакета значение |\LT|\-|cap|\-|width| +будет игнорироваться в~любом случае (если только вы не зададите значение, +отличное от заданного по умолчанию |4in|). +\See{\Ref{longtable}} + +\subsection{Пакет caption v\texorpdfstring{$3.0$}{3.0}} +\label{caption3} + +%\NEWdescription{v3.1} +% \Thispackage\ \version{3.0} did not support any document classes +% other than the standard \LaTeX\ ones: \class{article}, \class{report}, +% and \class{book}. +% Therefore the default settings used to be fixed, but now \thispackage{} +% supports more classes, therefore they are now set in dependence on the +% document class used. +\Thispackage\ \version{3.0} не поддерживал никаких классов документов, кроме +стандартных классов \LaTeX'а: \class{article}, \class{report}, +and \class{book}. +В~старых настройках ведётся работа над ошибками, но~теперь \thispackage{} +поддерживает больше классов, поэтому настройки подписей зависят от используемого +класса документа. + +% For example: While in \version{3.0} the default caption +% |jus|\-|ti|\-|fi|\-|ca|\-|tion| used to be always |jus|\-|ti|\-|fied|, +% it's now still |jus|\-|ti|\-|fied| when using one of the standard document +% classes, but |ragged|\-|right| will be used as default format when used +% with the \class{beamer} document class. +Например, в~то время как в~версии $3.0$ значением ключа |justification| +по умолчанию является |justi|\-|fied|, оно останется |justi|\-|fied| при использовании +стандартных классов документов, но заменяется на |ragged|\-|right| при использовании +класса документа \class{beamer}. + +% %An easy way to select the `old' defaults---if desired---is using the option +% An easy way to select the `old' defaults is using the option +% |style=base| when loading \thispackage\ (or later on using |\caption|\-|setup|). +Простой путь задать «старые» значения по умолчанию \cdash--- использовать опцию +|style=base| при загрузке пакета (или позднее, в~команде |\caption|\-|setup|). + +% Another new feature is the automatic check for compatibility; if an +% incompatibility will be found, a warning message will be issued and if a strong +% incompatibility was found some features of \thispackage\ will be disabled. +Ещё одной особенностью стала автоматическая проверка на совместимость [класса и~пакета]; если +обнаруживается несовместимость, выдаётся предупреждение о~несовместимости некоторых возможностей +данного пакета с~классом документа. +% Please note that only this check was added to \thispackage, so if you get +% such warning message, the previous versions of \thispackage\ were incompatible +% as well, but did not issued such warning, they were ``only'' having +% side-effects or causing problems. +Обратите внимание, что такое предупреждение появилось только в~текущей версии пакета, поэтому если +вы получили это сообщение это означает, что и~предыдущие версии были также несовместимы, +и~они уже имели побочные эффекты и~могли создавать проблемы. +% So these warnings only say that some bad side effects or problems could +% happen, but not that they actually will happen. +% Anyway, if you use \thispackage\ in such circumstances, +% you should use it with care. +Эти предупреждения говорят, что \emph{могут} появиться проблемы, но это не значит, что они +непременно появятся. +В~любом случае если вы используете \thispackage\ игнорируя это предупреждение, +будьте осторожны. + +\bigskip + +\begin{Note*} +% \Thispackage\ \version{3.0} offered the option |caption=|\x|false|, +% which used to be a workaround for not using the whole \package{caption} package +% (leaving the caption stuff offered by the document class or other packages +% intact), but keeping the \package{subfig} package\cite{subfig} working. +% This mechanism is obsolete and not offered anymore, please pass this option +% to the \package{subfig} package instead and do not load \thispackage\ anymore. +% %\par\See{the \package{subfig} package documentation} +Пакет версии \version{3.0} предлагал опцию |caption=false|, которая включала лишь +частичное использование возможностей пакета \package{caption} (сохраняя +настройки класса документа или других пакетов нетронутыми), но оставляла +возможность работы пакета \package{subfig}. +Этот механизм теперь устаревший и~больше не поддерживается, +поэтому задавайте, пожалуйста, эту опцию при загрузке пакета \package{subfig}, +и~не загружайте данный пакет вовсе. +%\par\See{the \package{subfig} package\cite{subfig} documentation} +\end{Note*} + % --------------------------------------------------------------------------- % -% \fi -% -%^^A \section{Thanks} -% \section{Благоданости} -% -%\begingroup -% \fontencoding{T1}\fontfamily{ptm}\selectfont -% I would like to thank Katja Melzner, -% Steven D. Cochran, Frank Mittelbach, -% David Carlisle, Carsten Heinz, Olga Lapko, and Keith Reckdahl. -% Thanks a lot for all your help, ideas, patience, spirit, and support! -% -% Also I would like to thank -% Harald Harders, -% Peter L\"offler, -% Peng Yu, -% Alexander Zimmermann, -% Matthias Pospiech, -% J\"urgen Wieferink, -% Christoph Bartoschek, -% Uwe St\"ohr, -% Ralf Stubner, -% Geoff Vallis, -% Florian Keiler, -% J\"urgen G\"obel, -% Uwe Siart, -% Sang-Heon Shim, -% Henrik Lundell, -% David Byers, -% William Asquith, -% and -% Prof.~Dr.~Dirk Hoffmann, -% who all helped to make this package a better one. -% -%\endgroup + +\clearpage +\begin{thebibliography}{99} +\fontencoding{T1}%\fontfamily{ptm} +\selectfont + \bibitem{TLC2} + Frank Mittelbach and Michel Goossens:\\ + \newblock {\em The {\LaTeX} Companion (2nd.~Ed.)},\\ + \newblock Addison-Wesley, 2004. + + \bibitem{beamer} + Till Tantau:\\ + \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/beamer/}% +% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/beamer/doc/beameruserguide.pdf}% + {\emph{User Guide to the Beamer Class, Version 3.07}},\\ + March 11, 2007 + + \bibitem{KOMAScript} + Markus Kohm \& Jens-Uwe-Morawski:\\ + \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/koma-script/}% +% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/koma-script/scrguien.pdf}% + {\emph{KOMA-Script -- a versatile \LaTeXe\ bundle}},\\ + 2007-01-09 + + \bibitem{NTG} + Victor Eijkhout:\\ + \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/ntgclass/}% +% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/ntgclass/classdoc.pdf}% + {\emph{An introduction to the Dutch \LaTeX\ document classes}},\\ + 3 September 1989 + + \bibitem{algorithms} + Rog\'erio Brito:\\ + \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/algorithms/}% +% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/algorithms/algorithms.pdf}% + {\emph{Algorithms}},\\ + June 2, 2006 +% +\iffalse + \bibitem{algorithm2e} + Christophe Fiorio:\\ + \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/algorithm2e/}% +% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/algorithm2e/algorithm2e.pdf}% + {\emph{algorithm2e.sty -- package for algorithms}},\\ + March 11, 2007 +\fi % -% \iffalse + \bibitem{float} + Anselm Lingnau:\\ + \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/float/}% +% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/float/float.pdf}% + {\emph{An Improved Environment for Floats}},\\ + 2001/11/08 + + \bibitem{floatflt} + Mats Dahlgren:\\ + \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/floatflt/}% +% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/floatflt/floatflt.pdf}% + {\emph{Welcome to the floatflt package}},\\ + 1998/06/05 + + \bibitem{floatrow} + Olga Lapko:\\ + \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/floatrow/}% +% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/floatrow/floatrow.pdf}% + {\emph{The floatrow package documentation}},\\ + 2008/03/28 + + \bibitem{fltpage} + Sebastian Gross:\\ + \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/fltpage/}% +% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/fltpage/fltpage.pdf}% + {\emph{Welcome to the beta test of fltpage package!}},\\ + 1998/11/13 + + \bibitem{hyperref} + Sebastian Rahtz \& Heiko Oberdiek:\\ + \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/hyperref/}% +% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/hyperref/hyperref.pdf}% + {\emph{Hypertext marks in \LaTeX}},\\ + November 12, 2007 + + \bibitem{hypcap} + Heiko Oberdiek:\\ + \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/oberdiek/}% +% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/oberdiek/hypcap.pdf}% + {\emph{The hypcap package -- Adjusting anchors of captions}},\\ + 2007/04/09 + + \bibitem{listings} + Carsten Heinz \& Brooks Moses:\\ + \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/listings/}% +% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/listings/listings.pdf}% + {\emph{The Listings Package}},\\ + 2007/02/22 + + \bibitem{longtable} + David Carlisle:\\ + \href{http://tug.ctan.org/tex-archive/macros/latex/required/tools/}% +% \href{ftp://tug.ctan.org/tex-archive/macros/latex/required/tools/longtable.pdf}% + {\emph{The longtable package}},\\ + 2004/02/01 + + \bibitem{picinpar} + Friedhelm Sowa:\\ + \href{http://tug.ctan.org/tex-archive/macros/latex209/contrib/picinpar/}% +% \href{ftp://tug.ctan.org/tex-archive/macros/latex209/contrib/picinpar/}% + {\emph{Pictures in Paragraphs}},\\ + July 13, 1993 + + \bibitem{picins} + Joachim Bleser and Edmund Lang:\\ + \href{http://tug.ctan.org/tex-archive/macros/latex209/contrib/picins/}% +% \href{ftp://tug.ctan.org/tex-archive/macros/latex209/contrib/picins/mpic.dvi}% + {\emph{PicIns-Benutzerhandbuch Version 3.0}},\\ + September~1992 + + \bibitem{rotating} + Sebastian Rahtz and Leonor Barroca:\\ + \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/rotating/}% +% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/rotating/}% + {\emph{A style option for rotated objects in \LaTeX}},\\ + 1997/09/26 + + \bibitem{setspace} + Erica M. S. Harris \& Geoffrey Tobin:\\ + \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/setspace/}% +% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/setspace/}% + {\emph{LaTeX Document Package ``setspace''}},\\ + 1 December 2000 + + \bibitem{sidecap} + Rolf Niepraschk \& Hubert G\"a\ss lein:\\ + \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/sidecap/}% +% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/sidecap/sidecap.pdf}% + {\emph{The sidecap package}},\\ + 2003/06/06 + + \bibitem{subfigure} + Steven D. Cochran:\\ + \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/subfigure/}% +% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/subfigure/subfigure.pdf}% + {\emph{The subfigure package}},\\ + 2002/07/02 + + \bibitem{subfig} + Steven D. Cochran:\\ + \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/subfig/}% +% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/subfig/subfig.pdf}% + {\emph{The subfig package}},\\ + 2005/07/05 + + \bibitem{supertabular} + Johannes Braams and Theo Jurriens:\\ + \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/supertabular/}% +% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/supertabular/supertabular.pdf}% + {\emph{The supertabular environment}},\\ + 2002/07/19 + + \bibitem{threeparttable} + Donald Arseneau:\\ + \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/misc/}% +% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/misc/threeparttable.sty}% + {\emph{Three part tables: title, tabular environment, notes}},\\ + 2003/06/13 + + \bibitem{wrapfig} + Donald Arseneau:\\ + \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/wrapfig/}% +% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/wrapfig/wrapfig.sty}% + {\emph{WRAPFIG.STY ver 3.6}},\\ + 2003/01/31 + + \bibitem{xtab} + Peter Wilson:\\ + \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/xtab/}% + {\emph{The xtab package}},\\ + 2004/05/24 + +\end{thebibliography} + % --------------------------------------------------------------------------- % -% \fi -% \StopEventually{\begin{thebibliography}{9} -% \fontencoding{T1}\fontfamily{ptm}\selectfont -% \bibitem{companion} -% Frank Mittelbach and Michel Goossens: -% \newblock {\em The {\LaTeX} Companion (2nd.~Ed.)}, -% \newblock Addison-Wesley, 2004. -% -% \bibitem{float} -% Anselm Lingnau: -% \emph{An Improved Environment for Floats}, -% 2001/11/08 -% -% \bibitem{floatrow} -% Olga Lapko: -% \emph{The floatrow package documentation}, -% 2005/05/22 -% -% \bibitem{hyperref} -% Sebastian Rahtz \& Heiko Oberdiek: -% \emph{Hypertext marks in \LaTeX}, -% 2007/01/25 -% -% \bibitem{hypcap} -% Heiko Oberdiek: -% \emph{The hypcap package -- Adjusting anchors of captions} -% 2001/08/27 -% -% \bibitem{listings} -% Carsten Heinz: -% \emph{The Listings Package}, -% 2004/02/13 -% -% \bibitem{longtable} -% David Carlisle: -% \emph{The longtable package}, -% 2000/10/22 -% -% \bibitem{rotating} -% Sebastian Rahtz and Leonor Barroca: -% \emph{A style option for rotated objects in \LaTeX}, -% 1997/09/26 -% -% \bibitem{sidecap} -% Rolf Niepraschk und Hubert G\"a\ss lein: -% \emph{The sidecap package}, -% 2003/06/06 -% -% \bibitem{subfig} -% Steven D. Cochran: -% \emph{The subfig package}, -% 2005/07/05 -% -% \bibitem{supertabular} -% Johannes Braams und Theo Jurriens: -% \emph{The supertabular environment}, -% 2002/07/19 -% -% \bibitem{Anne} -% Anne Br\"uggemann-Klein: -% \emph{Einf\"uhrung in die Dokumentverarbeitung}, -% B.G. Teubner, Stuttgart, 1989 -% \end{thebibliography}} -% -% \Finale -% -\endinput + +\end{document} -- cgit v1.2.3