summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/floatrow/floatrow-rus.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2007-09-08 15:58:47 +0000
committerKarl Berry <karl@freefriends.org>2007-09-08 15:58:47 +0000
commitba8058f661bc514c2d960695ddb21d5501abbf97 (patch)
tree3ed20232ad39107bf24cde0e6795db6da5ee7e38 /Master/texmf-dist/doc/latex/floatrow/floatrow-rus.tex
parent3ed1ea28cc76e0634ad44d87ef6d963bf25f376e (diff)
float 0.2a (7sep07)
git-svn-id: svn://tug.org/texlive/trunk@4910 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/floatrow/floatrow-rus.tex')
-rw-r--r--Master/texmf-dist/doc/latex/floatrow/floatrow-rus.tex7402
1 files changed, 5202 insertions, 2200 deletions
diff --git a/Master/texmf-dist/doc/latex/floatrow/floatrow-rus.tex b/Master/texmf-dist/doc/latex/floatrow/floatrow-rus.tex
index fa6f8ac5f1c..fc13d8e75a0 100644
--- a/Master/texmf-dist/doc/latex/floatrow/floatrow-rus.tex
+++ b/Master/texmf-dist/doc/latex/floatrow/floatrow-rus.tex
@@ -2,7 +2,7 @@
% floatrow-rus.tex - The float row package
% (extension of float package)
% Russian documentation.
-% (c) 2004-2005 Olga Lapko (Lapko.O@g23.relcom.ru)
+% (c) 2004-2007 Olga Lapko (Lapko.O@g23.relcom.ru)
%
% This documentation is provided under the terms of the
% LaTeX Project Public License distributed from CTAN
@@ -21,96 +21,173 @@
\usepackage[cp1251]{inputenc}
\usepackage[english,russian]{babel}
+\makeatletter%^^A -----------------------
+
\usepackage{calc}
\usepackage{tabularx,array}
+\ifx\pdfoutput\undefined \else
+ \ifcase\pdfoutput \else
+% \usepackage{mathptm}\def\ttdefault{pxtt}
+% \usepackage[scaled=0.90]{helvet}
+ \fi
+\fi
+\settowidth\marginparwidth{\texttt{0DeclareFloatFootnoterule}}
+\advance\textheight4\baselineskip
+\advance\topskip-2\baselineskip
+
\IfFileExists{titlesec.sty}{\usepackage[raggedright]{titlesec}}{}
\IfFileExists{footmisc.sty}{\usepackage[perpage]{footmisc}}{}
-\usepackage{floatpagestyle}
+\IfFileExists{fancyhdr.sty}{\usepackage{fancyhdr}
+\pagestyle{fancy}
+\fancyhead{}\fancyfoot{}
+\fancyhead[LE]{\setlength{\dimen@}{\marginparwidth+\marginparsep}%^^A
+ \leavevmode\hbox to\dimen@{\normalsize\bfseries\thepage\hfil}
+ \ignorespaces{\nouppercase\leftmark}\hfil\strut}
+\fancyhead[LO]{\setlength{\dimen@}{\marginparwidth+\marginparsep}%^^A
+ \leavevmode\hbox to\dimen@{}
+ \ignorespaces{\nouppercase\rightmark}\hfill\hbox to2em{\hfil\normalsize\bfseries\thepage}\strut}
+\fancyheadoffset[L]{\marginparwidth+\marginparsep}
+}{}
+
+\usepackage[font=small,labelfont=bf,labelsep=period,
+ justification=centerlast]
+ {caption}[2007/04/11]
-\usepackage[font=small,labelfont=bf,labelsep=period,justification=centerlast]%
- {caption}[2004/11/28]
-\usepackage[format=default,justification=centerlast,labelfont=up]{subfig}[2005/06/28]
+\usepackage[format=default,justification=centerlast,
+ labelfont=up,captionskip=5pt]
+ {subfig}[2005/06/28]
\IfFileExists{rotating.sty}{\usepackage[figuresright]{rotating}}{}
+\usepackage{longtable}
\usepackage{wrapfig}
+%\usepackage{psfrag}
\usepackage[vflt]{floatflt}
\usepackage{picins}
%^^A\RequirePackage[writefile]{listings}[2004/09/07]
-\usepackage[style=plain,font=small,footskip=.5\skip\footins,
- footnoterule=fullsize,margins=centering,objectset=centering,floatrowsep=qquad,
- captionskip=5pt,capbesidesep=quad,facing=yes,capbesideposition=inside]{floatrow}
+\usepackage[font=small,captionskip=5pt,objectset=centering,margins=centering,
+ footskip=.5\skip\footins,footnoterule=fullsize,
+ floatrowsep=qquad,capbesidesep=quad,
+ facing=yes,capbesideposition=inside,floatHaslist=yes,doublefloataswide=yes]{floatrow}
+
+\usepackage{floatpagestyle,listpen}
+\allowprelistbreaks[-4]
\usepackage{fr-fancy}
-\IfFileExists{hyperref.sty}{\usepackage[unicode]{hyperref}
+\IfFileExists{hyperref.sty}{\usepackage[
+ linktocpage,
+ hyperindex,%
+ plainpages=false,%
+ bookmarksopenlevel=1,%
+ bookmarksnumbered=false,%
+ pdfview=FitH,
+ pdfstartview=FitH,unicode
+ ]{hyperref}
\IfFileExists{hypcap.sty}{\usepackage{hypcap}}{}
}{}
+
\ifx\pdftexversion\undefined
+ \IfFileExists{pstricks.sty}{\usepackage{pstricks,pst-eps}}{}
+\else\ifcase\pdfoutput
\IfFileExists{pstricks.sty}{\usepackage{pstricks}}{}
+\or
+%^^A \IfFileExists{pdftricks.sty}{
+%^^A \usepackage{pdftricks}
+%^^A }{}
+\fi\fi
+\ifx\pdfdisplay\undefined\else
+ \begin{psinputs}
+ \usepackage{pstricks}
+ \end{psinputs}
\fi
+
\IfFileExists{makecell.sty}{\usepackage{makecell}}{}
-\makeatletter
+
\@ifundefined{thead}%
- {\newcommand\thead[1]{\footnotesize
- \raisebox{0pt}[\height+\jot][\depth+\jot]{\begin{tabular}{@{}c@{}} #1
- \end{tabular}}}
+ {\newcommand\thead[1]{\footnotesize\raisebox
+ {0pt}[\height+\jot][\depth+\jot]{\begin{tabular}{@{}c@{}} #1\end{tabular}}}
%^^A For this documentation only
\def\multirowthead#1[#2]#3{\raisebox{-1.5ex}{\thead{#3}}}}{}
-\makeatother
\IfFileExists{multirow.sty}{\usepackage{multirow}}{}
\IfFileExists{lscape.sty}{\usepackage{lscape}}{}
+\IfFileExists{color.sty}{\usepackage{color}\definecolor{gray}{gray}{.5}}{\let\color\@gobble}
\floatsetup[table]{style=Plaintop,footnoterule=none}
+%^^A -----------------------
\floatstyle{ruled}
\newfloat{Program}{tbp}{lop}[section]
-\floatname{Program}{\CYRP\cyrr\cyro\cyrg\cyrr\cyra\cyrm\cyrm\cyra}
-
-\DeclareFloatStyle{MyBoxed}{style=Boxed,captionskip=5pt,
- frameset={\fboxrule1pt\fboxsep12pt}}
-\DeclareFloatVCode{lowthickrule}{\kern2pt\hrule height.8ptdepth0pt}
\DeclareNewFloatType{Example}%
- {placement=tb,within=section,fileext=lox,name=\CYRP\cyrr\cyri\cyrm\cyre\cyrr}
+ {placement=tb,within=section,fileext=lox}
+
+\newfloatcommand{fcapsideleft}{figure}[{\capbeside
+ \captionsetup[capbesidefigure]{format=break,labelsep=none,
+ justification=raggedleft}%
+ \thisfloatsetup{capbesideposition=left}}][\FBwidth]
+\newfloatcommand{fcapsideright}{figure}[{\capbeside
+ \captionsetup[capbesidefigure]{format=break,labelsep=none,
+ justification=raggedright}%
+ \thisfloatsetup{capbesideposition=right}}][\FBwidth]
+
+\DeclareFloatStyle{MyBoxed}{style=Boxed,
+ captionskip=5pt,frameset={\fboxrule1pt\fboxsep12pt}}
+
+\DeclareFloatVCode{lowthickrule}{\par\vskip2pt\rule{\hsize}{.8pt}\par}
+\DeclareFloatVCode{grayruleabove}{{\color{gray}\par\rule\hsize{2.8pt}\vskip4pt\par}}
+\DeclareFloatVCode{grayrulebelow}{{\color{gray}\par\vskip4pt\rule\hsize{2.8pt}}}
+
+\DeclareObjectSet{colorred}{\parskip2pt\parindent15pt\color{red}}
+
+\DeclareMarginSet{hangleft}%
+ {\setfloatmargins
+ {\hskip-\marginparwidth\hskip-\marginparsep}{\hfil}}
+\DeclareMarginSet{hangtoheads}%
+ {\setfloatmargins
+ {\hfil}{\hskip-.7\headheight\hskip-\headsep}}
-%^^A for Appendix-----------
+\DeclareFloatSeparators{colorsep}%
+ {\begingroup\color{blue}%
+ \floatfacing{\hskip6pt\vrule width4.8pt\hskip6pt}%
+ {\hskip6pt\vrule width4.8pt\hskip6pt}%
+ \endgroup}
\DeclareFloatSeparators{none}{}
\DeclareFloatSeparators{cicero}{\hskip1cc}
\DeclareFloatSeparators{enskip}{\hskip.5em}
\DeclareFloatSeparators{mcapwidth}{\hskip-\FCwidth}
-\newfloatcommand{fcapsideleft}{figure}[{\capbeside
- \captionsetup[capbesidefigure]{format=break,labelsep=none,
- justification=raggedleft}\thisfloatsetup{capbesideposition=left}}][\FBwidth]
-\newfloatcommand{fcapsideright}{figure}[{\capbeside
- \captionsetup[capbesidefigure]{format=break,labelsep=none,
- justification=raggedright}\thisfloatsetup{capbesideposition=right}}][\FBwidth]
%^^A -----------------------
+%^^A\DeclareCaptionFormat{labelonly}{#1}
+\DeclareCaptionLabelFormat{numonly}{#2)}
+\DeclareCaptionLabelFormat{list}{\bothIfFirst{#1}{ }#2)}
+\DeclareCaptionListOfFormat{comma-separated}{#1,\,#2}
+
+\DeclareCaptionFont{green}{\color{green}}
+\DeclareCaptionFont{magenta}{\color{magenta}}
\def\rightlast{\leftskip0ptplus1fil
\rightskip0ptplus-1fil\parfillskip0ptplus1fil}
\def\leftlast{\leftskip0pt\rightskip0pt\parfillskip0ptplus1fil}
+
%^^A for all versions of caption 3.x?
-\DeclareCaptionFormat{flushrightlabel}{\leavevmode\rightline{#1}#2\par#3\par}
-\DeclareCaptionJustification{togglelast}
- {\floatfacing*\rightlast\leftlast}
-\DeclareCaptionStyle{capbesidefigure}{justification=togglelast}
-\captionsetup[table]%
- {format=flushrightlabel,textfont=bf,labelsep=none,labelfont=sl,captionskip=5pt}
+\DeclareCaptionLabelFormat{rightline}{\rightline{\bothIfFirst{#1}{ }#2}}
+\DeclareCaptionJustification{togglelast}{\floatfacing*\rightlast\leftlast}
+
+\captionsetup[table]{labelformat=rightline,textfont=bf,labelfont={md,sl},labelsep=newline}
\captionsetup[capbesidefigure]{justification=togglelast}
\captionsetup[floatfoot]{format=default}
-%^^A for Appendix-----------
\DeclareCaptionFormat{break}{#1#2\par#3\par}
+
%^^A -----------------------
-\makeatletter
+\advance\oddsidemargin.25\marginparwidth
\evensidemargin\oddsidemargin
\@mparswitchfalse
\widowpenalty10000
@@ -125,14 +202,15 @@
\def\l@subsubsection{\@dottedtocline {3}{4.2em}{3.6em}}
\newcommand\Resizebox[5]{\setbox0\hbox{\setlength\unitlength{#1/#3}%^^A
- \ifx\pspicture\undefined\else\psset{unit=\unitlength}\fi{#5}}%^^A
- \@tempdima\ht0\advance\@tempdima\dp0%^^A
- \ifdim\@tempdima>#2\setlength\unitlength{#2/#4}\ifx\pspicture\undefined
- \else\psset{unit=\unitlength}\fi
- {#5}\else\box0\fi}
+ \ifx\pspicture\undefined\else\psset{unit=\unitlength}\fi{#5}}%^^A
+ \@tempdima\ht0\advance\@tempdima\dp0%^^A
+ \ifdim\@tempdima>#2
+ \setlength\unitlength{#2/#4}\ifx\pspicture\undefined
+ \else\psset{unit=\unitlength}\fi
+ {#5}\else\box0\fi}
\providecommand*{\file}[1]{\texttt{#1}}
-\providecommand*{\pkg}[1]{\textsf{#1}}
+\providecommand*{\package}[1]{\textsf{#1}}
\providecommand*{\cls}[1]{\textsf{#1}}
\providecommand*{\env}[1]{\texttt{#1}}
\providecommand*{\meta}[1]{$\langle$\textit{#1}$\rangle$}
@@ -146,6 +224,8 @@
\setlength{\parsep}{0pt}%
}}%
{\endlist}
+
+\newenvironment{Quote}{\par\RestoreSpaces\small\begin{quote}\obeylines\parskip0pt}{\end{quote}\par\@endpetrue}
\def\OptionLabel{RaggedRight}
\DeclareRobustCommand\La{L\kern-.36em%
@@ -157,11 +237,33 @@
\vss}%
}%
}
-\makeatother
-%\OnlyDescription
+%maybe there is better solution?
+\def\DescribeMacro{\let\outer@nobreak\@nobreaktrue
+ \leavevmode\everypar{\@nobreakfalse}\@bsphack
+ \begingroup\MakePrivateLetters\Describe@Macro}
+\def\DescribeEnv{\let\outer@nobreak\@nobreaktrue
+ \leavevmode\everypar{\@nobreakfalse}\@bsphack
+ \begingroup\MakePrivateLetters\Describe@Env}
+\def\RestoreSpaces{\@nobreakfalse}
+
+\newcommand\FRmpar{\@ifstar{\@nobreaktrue\xFRmpar}{\xFRmpar}}
+
+\newcommand\xFRmpar[2]{\label{#2}\marginpar{\footnotesize
+ \raggedleft\advance\leftskip.3\hsize#1}}
+
+\providecommand\sectionname{разд.}
+\def\SpecialUsageIndex#1{}
+\def\SpecialEnvIndex#1{}
+\newcommand\seeIntro{\hyperref[sec:intro]{Intro}}
+
+\makeatother%^^A---------------------------------
+
+\OnlyDescription
+%\let\PrintChanges\relax
+\let\PrintIndex\relax
\EnableCrossrefs
-\RecordChanges
+%\RecordChanges
\begin{document}
\DocInput{floatrow-rus.tex}
\PrintChanges
@@ -173,9 +275,9 @@
%
% \ifx\pspicture\undefined\else\psset{unit=1pt}\fi
%
-% \def\fileversion{v0.1g}
-% \def\filedate{2005/07/15}
-% \title{Документация к пакету \pkg{floatrow}\thanks{Версия
+% \def\fileversion{v0.2a}
+% \def\filedate{2007/08/24}
+% \title{Документация к пакету \package{floatrow}\thanks{Версия
% документации \fileversion, датирована
% \filedate.}}
%
@@ -186,67 +288,300 @@
% \maketitle
%
% \begin{abstract}\openup-.5pt
-% Данный пакет создан как расширение или дополнение пакета \pkg{float}.
-% \pkg{floatrow} использует коды из пакетов \pkg{float}\footnote{Пакет \pkg{float},
+%^^A% This package was created as extension of the \package{float}
+%^^A% package. The \package{floatrow} package borrows core code from
+%^^A% the \package{float}\footnote{\package{float} package, version v1.3d dated
+%^^A% 2001/11/08, \copyright{} 1991-2000 Anselm Lingnau.} and
+%^^A% \package{rotfloat}\footnote{\package{rotfloat} package, version v1.2
+%^^A% dated 2004/01/04, \copyright{} 1995--2004 Axel
+%^^A% Sommerfeldt.} packages, so you \emph{must not} load these packages.
+% Данный пакет создан как расширение или дополнение пакета \package{float}.
+% \package{floatrow} использует коды из пакетов \package{float}\footnote{Пакет \package{float},
% версия v1.3d датирована 2001/11/08, \copyright{} 1991-2000
-% Anselm Lingnau.} и \pkg{rotfloat}\footnote{Пакет \pkg{rotfloat},
+% Anselm Lingnau.} и~\package{rotfloat}\footnote{Пакет \package{rotfloat},
% версия v1.2 датирована 2004/01/04, \copyright{} 1995--2004 Axel
-% Sommerfeldt.}, поэтому эти пакеты не должны загружаться.
-%
-% Пакет \pkg{float} обладает хорошим механизмом для создания (и простой модификации)
-% единообразного оформления для всех плавающих объектов (флотов)
-% без добавления повторяющихся команд в документации; к сожалению он работает
-% только с простыми комбинациями <<объект---подпись>>.
-%
-% Пакет \pkg{floatrow} расширяет этот механизм и позволяет:
+% Sommerfeldt.}, поэтому эти пакеты \emph{не должны} загружаться.
+%
+%^^A% The \package{float} package has a~good mechanism for the creation (and easy
+%^^A% modification) of common layout for all floats without
+%^^A% adding any repeated code in the document; besides, this package allows to
+%^^A% create new float type; it deals only
+%^^A% with alone (plain) combinations ``object (float contents)---caption''.
+%^^A% The \package{rotfloat}
+%^^A% package changes environments of rotated floats (\package{rotating} package)
+%^^A% to adapt them to \package{float}'s settings.
+% Пакет \package{float} обладает хорошим механизмом для создания (и~простой
+% модификации) единообразного оформления для всех плавающих объектов
+% (флотов) без добавления повторяющихся команд в~документации; кроме
+% этого пакет позволяет создать новый тип плавающего объекта; он работает
+% только с~простыми одиночными комбинациями
+% «объект (содержимое флота)\cdash--~подпись».
+% Пакет \package{rotfloat} адаптирует окружения развёрнутых плавающих объектов
+% (пакета \package{rotating}) под пакет \package{float}.
+%
+%^^A% Current package extends these possibilities and, at last, it allows:
+% Пакет \package{floatrow} расширяет эти возможности и, в~результате, поз\-воляет:
% \begin{itemize}\itemsep0pt\parskip0pt
-% \item%
-% изменять ширину флота;
-% \item%
-% задать всему флоту ширину, равную ширине объекта;
-% \item%
+% \item
+%^^A% usage of mechanism borrowed from \package{float} package for
+%^^A% creation of new float type;
+% использовать механизм, взятый из пакета \package{float}, для создания нового
+% типа плавающего объекта;
+% \item
+%^^A% to change width of float box, also
+%^^A% to set width for float box, which equals to the width of object;
+% изменить ширину бокса всего плавающего объекта,
+% а~также задать ширину равную ширине содержимого плавающего объекта;
+% \item
+%^^A% to put caption beside object;
% поместить подпись сбоку объекта;
-% \item%
+% \item
+%^^A% to put a few floats side by side on the row;
% поместить несколько флотов рядом;
% \item%
+%^^A% to put footnotes inside float box (using \env{minipage}-like mode);
+%^^A% and also put legend-like text;
% поместить сноски внутри плавающего объекта (используя режим,
% аналогичный \env{minipage}); поместить текст экспликации;
% \item%
-% создавать и изменять специальное оформление для каждого типа флотов
-% и различных размещений флота и его компонентов (расположенных на две
-% колонки или развёрнутых вертикально).
+%^^A% to create and/or modify special layout for each type of float and
+%^^A% for different positioning of float and its components, e.g.
+%^^A% two-column or rotated float.
+% создавать и/или изменять специальное оформление для каждого типа флотов
+% и~различных размещений флота и~его компонентов, например, расположенных на две
+% колонки или развёрнутых вертикально.
% \end{itemize}
%
-% Пакет \pkg{floatrow} объединён с пакетом \pkg{caption}
-% (версии 3.0 и выше). Также пакет \pkg{floatrow} (как
-% и пакет \pkg{caption}) использует механизм пакета \pkg{keyval}
-% ключ---опция для задания оформления.
+%^^A% The \package{floatrow} package is cooperated with \package{caption} package
+%^^A% (\textit{needs version} 3.0\textbf{q} \textit{and later}).
+%^^A% Also the \package{floatrow} package (like
+%^^A% \package{caption} one) uses \package{keyval} package mechanism for layout
+%^^A% settings.
+% Пакет \package{floatrow} объединён с~пакетом \package{caption}
+% (\textit{версия должна быть} 3.0\textbf{q} \textit{и~выше}).
+% Также пакет \package{floatrow} (как
+% и~пакет \package{caption}) использует механизм пакета \package{keyval}
+% ключ---опция для задания оформления флотов.
% \medskip
%
-% \emph{Терминология документации}:
-% \begin{description}\vskip-\lastskip\itemsep0pt\parskip0pt
-% \item[флот] или \textbf{плавающий объект} (float [box]) "---
-% может включать \emph{объект},
-% \emph{подпись} и \emph{дополнительный материал};
-% создаётся внутри окружений \env{figure} или \env{table} (\emph{простой флот}),
-% или командой |\floatbox|;
+% \begingroup
+% \slshape
+%^^A% I think I did my best to follow these ideas and I hope that someone
+%^^A% likes this idea: helps to maintain this idea anyway, or finds bugs
+%^^A% and absurdities in this package or documentation.
+% Я~делаю всё что могу для поддержки этого пакета и~надеюсь, что кто-то
+% поддержит эту идею и~поможет её развить дальше, даже если это будут
+% просто сообщения об ошибках в~пакете или документации.
+% \endgroup
+% \clearpage
%
-% \item[объект] (object) "--- таблица (\env{tabular}) или любая графика, являющаяся
-% содержимым таблицы (\env{figure}), рисунка (\env{table}) или другого типа
-% плавающего объекта;
%
-% \item[подпись] (caption) "--- подпись или табличный заголовок, заданный командой
+%^^A% \centerline{\textbf{Document Terminology}\nopagebreak\vspace{1ex}}
+% \centerline{\textbf{Терминология документации}\nopagebreak\vspace{1ex}}
+% \begin{description}\itemsep0pt\parskip0pt
+%^^A% \item[float]
+%^^A% could include \emph{object}, \emph{caption}, and
+%^^A% \emph{foot material}; \emph{float} is created by \env{figure} or
+%^^A% \env{table} environments (\emph{plain float}), or in |\floatbox|
+%^^A% command;
+% \item[флот]
+% или \textbf{плавающий объект} (float [box])
+% может включать \emph{объект},
+% \emph{подпись} и~\emph{дополнительный материал};
+% создаётся внутри окружений \env{figure} или \env{table} (\emph{простой флот}),
+% или командой |\floatbox| и~её модификациями;
+%
+%^^A% \item[float type]
+%^^A% means standard environments \env{figure} and \env{table},
+%^^A% also their subtypes, like e.g.~\env{wrapfigure} (\package{wrapfig} package),
+%^^A% \env{sidewaysfigure} (\package{rotating} and \package{rotfloat} packages),
+%^^A% \env{longtable} (\package{longtable} package) etc.;
+%^^A% command;
+% \item[тип флота] (float type)
+% означает как стандартные окружения \env{figure} или \env{table},
+% так и~их подвиды, например~\env{wrapfigure} (пакет \package{wrapfig}),
+% \env{sidewaysfigure} (пакеты \package{rotating} и~\package{rotfloat}),
+% \env{longtable} (\package{longtable}) и~др.;
+%
+%^^A% \item[object]
+%^^A% \env{tabular} or graphics, as contents of table
+%^^A% (\env{figure}) or figure (\env{table}) or other type of float;
+% \item[объект]
+% (object) табличный материал (например, \env{tabular}) или любая
+% графика, являющаяся содержимым таблицы (\env{table}), рисунка (\env{figure})
+% или другого типа плавающего объекта;
+%
+%^^A% \item[caption]text in |\caption|;
+% \item[подпись]
+% (caption) подпись или табличный заголовок, заданный командой
% |\caption|;
%
-% \item[дополнительный материал] (foot material) "--- экспликации и/или сноски внутри
+%^^A% \item[foot material]explications, legends and/or footnotes inside
+%^^A% \emph{float} box (|\footnote|/|\mpfootnotemark|/|\footnotetext|,
+%^^A% and |\floatfoot| macros).
+% \item[дополнительный материал]
+% (foot material) экспликации и/или сноски внутри
% \emph{флота} (|\footnote|/|\mpfootnotemark|/|\footnotetext| или |\floatfoot|).
% \end{description}
-%
% \end{abstract}
%
+% \begingroup\small
+%^^A% \vspace{2ex}\centerline{\textbf{Frequently Appeared Design}\nopagebreak}
+% \vspace{2ex}\centerline{\textbf{\TeX ническое редактирование}\nopagebreak}
+% \begin{multicols}{2}\raggedright\advance\rightskip1em
+% \makeatletter\let\item\@idxitem\ignorespaces\makeatother
+% \item{Оформление типов флотов (|\floatsetup|)}
+% \strut\pfill
+% \textsl{\sectionname}~\ref{sec:floatsetup}
+%
+% \item{Подпись}
+% \subitem{сверху (нумерованные таблицы, |\ttabbox|)}
+% \strut\pfill
+% \textsl{{\seeIntro}},~%^^A
+% \textsl{\sectionname}~\ref{sec:floatbox}%^^A;
+% %^^A\pageref{FAD:CaptionAbove},
+% %^^A\pageref{FAD:CaptionAboveTable},
+% %^^A\pageref{FAD:CaptionAboveTableII},
+% %^^A\pageref{FAD:CaptionAboveIII}
+%
+% \subitem{по ширине многостраничной таблицы \env{longtable}
+% (ключ~|LTcapwidth=|)}
+% \strut\pfill
+% \pageref{FAD:LTcapwidth}
+%
+% \subitem{по ширине объекта}
+% \emph{см}.~{флот, задание ширины по ширине объекта}{}
+%
+% \subitem{сбоку (нумерованные рисунки, |\fcapside|)}
+% \strut\pfill
+% \textsl{{\seeIntro}},~%^^A
+% \textsl{\sectionname}~\ref{sec:floatbox}%^^A;~
+% %^^A\pageref{FAD:BesideCaptionII},
+% %^^A\pageref{ssec:ffigbox:etc},
+% %^^A\pageref{fig:subfig:catsI},
+%
+% \item{Подфлот}\nopagebreak
+% \subitem{с~номером подфлота сбоку}
+% \strut\pfill
+% \pageref{FAD:sublabelbeside}
+%
+% \subitem{с~подподписью сверху}
+% \strut\pfill
+% \pageref{FAD:subcapabove}
+%
+% \item{Сноски внутри флота}
+% \strut\pfill
+% \textsl{\sectionname}~\ref{sec:floatfootnote}%^^A;
+% %^^A\pageref{FAD:FnoteInsideFloat}
+%
+%^^A%^^A% \subitem{текст сноски (|\footnotetext|)}
+%^^A%^^A% \strut\pfill
+%^^A%^^A% \textsl{\sectionname}~\ref{sec:floatfootnote};
+%^^A%^^A% \pageref{FAD:FnoteInsideFloat}
+%
+% \subitem{знак сноски (|\mpfootnotemark|)}
+% \strut\pfill
+% \pageref{FAD:FnoteInsideFloat}
+%
+% \item{Создание нового типа флотов (|\DeclareNewFloatType|)}
+% \strut\pfill
+% \textsl{\sectionname}~\ref{sec:newfloat}%^^A;
+% %^^A\pageref{FAD:newfloattype}
+%
+% \item{Флот}\nopagebreak
+% \subitem{бокс (|\floatbox|)}
+% \strut\pfill
+% \textsl{\sectionname}~\ref{sec:floatbox};
+%
+% \subsubitem{рисунок (|\ffigbox|)}
+% \strut\pfill
+% \textsl{{\seeIntro}},~%^^A
+% \textsl{\sectionname}~\ref{sec:floatbox};
+%
+% \subsubitem{таблица (|\ttabbox|)}
+% \strut\pfill
+% \textsl{{\seeIntro}},~%^^A
+% \textsl{\sectionname}~\ref{sec:floatbox};
+%
+% \subitem{в~оборку}
+% \strut\pfill
+% \textsl{\sectionname}~\ref{ssec:wrapfig}--\ref{ssec:picins}
+%
+% \subitem{задание ширины}\nopagebreak
+%^^A% \subsubitem{ключ |floatwidth=| и~др.}
+%^^A% \strut\pfill
+%^^A% \textsl{\sectionname}~\ref{sec:wd:object},
+%
+% \subsubitem{опция в~|\floatbox| и~др.}
+% \strut\pfill
+% \textsl{\sectionname}~\ref{sec:floatbox}%^^A;
+% %^^A\pageref{FAD:FBwidthI},
+% %^^A\pageref{FAD:FBwidthII}
+%
+% \subsubitem{по оставшемуся месту в~ряду
+% (опция |\Xhsize| (|\floatbox|))}
+% \strut\pfill
+% \pageref{FAD:floatfillspace}
+%
+% \subsubitem{по ширине объекта (опция |\FBwidth|
+% (|\floatbox|))\kern-1em\allowbreak}
+% \strut\pfill
+% \textsl{{\seeIntro}},~%^^A
+% \textsl{\sectionname}~\ref{sec:floatbox}%^^A;
+% %^^A\pageref{FAD:FBwidthI},
+% %^^A\pageref{FAD:FBwidth},
+% %^^A\pageref{FAD:FBwidthII}
+%
+% \subitem{развёрнутые (окр.~|sideways..|)\kern-1em\allowbreak}
+% \strut\pfill
+% \textsl{\sectionname}~\ref{ssec:rotating}%^^A--\ref{ssec:lscape}
+% \subsubitem{размещение на развороте}
+% \strut\pfill
+% \pageref{FAD:ContRotated}
+%
+% \subsubitem{пустой колонтитул (|\emptyfloatpage|)}
+% \strut\pfill
+% \pageref{FAD:emptyfloatpage}
+%
+% \subitem{ряд (окр. |floatrow|)}
+% \strut\pfill
+% \textsl{{\seeIntro}},~%^^A
+% \textsl{\sectionname}~\ref{sec:floatrow}%^^A;
+% %^^A\pageref{FAD:BesideFloat},
+% %^^A\pageref{ssec:app:besidestart}--\pageref{ssec:app:besidefinish}
+%
+% \subsubitem{флот занимает оставшееся место в~ряду}
+% \emph{см.}~{флот, задание ширины по оставшемуся месту в~ряду}
+%
+%^^A%^^A% \subsubitem{флоты одного вида в~одном ряду}
+%^^A%^^A% \strut\pfill
+%^^A%^^A% \pageref{FAD:floatrow}
+%
+% \subsubitem{флоты различных типов в~одном ряду}
+% \strut\pfill
+% \pageref{FAD:MixedRow},
+% \pageref{FAD:MixedRowII}%^^A%,
+% %^^A\pageref{FAD:Mixrow}
+%
+% \subitem{как в~стандартном \LaTeX'е (|\RawFloats|)}
+% \strut\pfill
+% \textsl{\sectionname}~\ref{sec:rawfloats}%^^A;
+% %^^A\pageref{FAD:PlainFloat},
+% %^^A\pageref{FAD:PlainFloatII}
+%
+% \subitem{\textbf{сюда!}, или флот «на якоре» (опция~\texttt{H})}
+% \strut\pfill
+% \textsl{\sectionname}~\ref{sec:floatborrowII}
+%
+% \item{Экспликации (|\floatfoot|)}
+% \strut\pfill
+% \textsl{\sectionname}~\ref{subsec:floatfoot}
+% \end{multicols}%
+% \endgroup
+%
% \clearpage
% \begingroup
-% \small
+% \small\openup-.5pt
% \tableofcontents
% \listoffigures
% \listoftables
@@ -254,22 +589,52 @@
% \clearpage
% \suppressfloats[t]
%
-% \section{Введение}
+%^^A% \section{Macros for Building Floats}
+% \section{Макрокоманды для построения флотов}
%
+%^^A% \subsection{Introduction}\label{sec:intro}
+% \subsection{Введение}\label{sec:intro}
+%
+%^^A% One of the first macros of package, created for float contents,
+%^^A% is a macro which builds contents of table environment with caption
+%^^A% above. The width of caption equals to the width of contents, e.g.
+%^^A% of tabular (see table~\ref{intro:table}).%^^A
+%^^A% \FRmpar{Caption above table object}{FAD:CaptionAbove}%^^A
+%^^A%^^A% \footnote{Table caption in current documentation use a~special layout,
+%^^A%^^A% popular in Russian typographic publications, look for
+%^^A%^^A% \texttt{flushrightlabel} key of \cs{captionsetup} in the preamble of
+%^^A%^^A% source file of this documentation and in sample files
+%^^A%^^A% ({\sectionname}~\ref{sec:samples}).}
% Одной из первых макрокоманд пакета, созданных для плавающего объекта (флота),
-% является команда, которая помещает содержимое таблицы с табличным заголовком
-% вверху. Ширина заголовка равна ширине содержимого, здесь "--- таблицы
-% (см. табл.~\ref{intro:table}).
-%\begin{verbatim}
-%\begin{table}
-%\ttabbox
-% {\caption{Таблица ...}\label{...}}
-% {\begin{tabular}...\end{tabular}}
-%\end{table}
-%\end{verbatim}
-% \begin{table}[h]
+% является команда, которая помещает содержимое таблицы с~табличным заголовком
+% вверху. Ширина заголовка равна ширине содержимого, здесь \cdash--- табличного
+% материала (см.~табл.~\ref{intro:table}).%^^A
+% \relax\FRmpar{Подпись (заголовок) над таблицей}{FAD:CaptionAbove}%^^A
+% \footnote{Табличный заголовок в~данной документации использует оформление,
+% популярное в~русской технической литературе.}
+%\begin{Quote}\openup-.65pt
+%\meta{preamble}
+% |\usepackage[|\hyperref[setup:font]{\texttt{font}}|=small,|%^^A
+% \hyperref[setup:captionskip]{\texttt{captionskip}}|=5pt,|%^^A
+% \hyperref[setup:objectset]{\texttt{objectset}}|=centering,|
+% | |\hyperref[setup:margins]{\texttt{margins}}|=centering,...]{floatrow}[2007/08/24]|
+% |\|\hyperref[sec:floatsetup]{\texttt{floatsetup}}|[table]{|%^^A
+% \hyperref[setup:style]{\texttt{style}}|=Plaintop}|
+% |\usepackage[font=small,labelfont=bf,labelsep=period,|
+% | justification=centerlast]{caption}[2007/04/11]|
+% |\DeclareCaptionLabelFormat{rightline}{\rightline{\bothIfFirst{#1}{ }#2}}|
+% |\captionsetup[table]{labelformat=rightline,textfont=bf,|
+% | labelfont={md,sl},labelsep=newline}|
+%\meta{preamble}
+%|\begin{table}|
+%|\|\hyperref[floatbox:ttabbox]{\texttt{ttabbox}}
+%| {\caption{A small table ...}\label{...}}|
+%| {\begin{tabular}...\end{tabular}}|
+%|\end{table}|
+%\end{Quote}
+% \begin{table}[H]\jot1.5pt
% \ttabbox
-% {\caption{Таблица с заголовком сверху}\label{intro:table}}
+% {\caption{Таблица с заголовком сверху (\cmd{\ttabbox})}\label{intro:table}}
% {\begin{tabular}{|c|c|c|}
% \hline
% \thead{First data} & \thead{Second data} & \thead{Third data} \\
@@ -280,383 +645,1679 @@
% \end{tabular}}
% \end{table}%^^A
%
-% Пара этой команде, создающая рисунки "---|\ffigbox| "---помещает
-% подрисуночную подпись снизу и ширина по умолчанию равна ширине основного
-% текста. Оформление, создаваемое по умолчанию командой |\ffigbox| такое же,
-% как в обычном окружении \env{figure}; эта макрокоманда будет
-% полезнее для помещения плавающих объектов рядом (см. например,
-% рис.~\ref{intro:leftfig} и~\ref{intro:rightfig})
-%
-% Третья макрокоманда "---|\fcapside| (рис.~\ref{intro:beside}) "---помещает
-% подрисуночную подпись рядом:
-%
-%\begin{verbatim}
-%\begin{figure}
-%\fcapside
-% {\caption[Подпись рядом]{Подпись рядом ...}\label{...}}
-% {...}
-%\end{figure}
-%\end{verbatim}
-% \begin{figure}[h]
+%^^A% The pair of this command, which creates figures---|\ffigbox|---puts
+%^^A% caption below contents and default width of caption equals
+%^^A% to the width of main text.
+% Пара этой команде, создающая рисунки \cdash--- |\ffigbox| \cdash--- помещает
+% подрисуночную подпись снизу и~её ширина по умолчанию равна ширине основного
+% текста или заданной ширине |\hsize|.
+%\begin{Quote}\openup-.65pt
+%|...|
+%|\begin{figure}|
+%|\|\hyperref[floatbox:ffigbox]{\texttt{ffigbox}}
+%| {\caption{A figure...}\label{...}}|
+%| {...}|\nopagebreak
+%|\end{figure}|
+%\end{Quote}
+%\begingroup
+% \begin{figure}[H]
+% \ffigbox
+% {\caption[Простой бокс рисунка (\cmd{\ffigbox})]{Простой бокс рисунка
+% с~длинной длинной длинной длинной длинной
+% длинной длинной длинной длинной многострочной подписью}\label{intro:figure}}
+% {\unitlength1.08\unitlength\input{Doll.picture}}
+% \end{figure}%^^A
+%\endgroup
+%^^A% The default
+%^^A% layout of |\ffigbox| (figure~\ref{intro:figure}) is similar to plain
+%^^A% \env{figure} environment. If you set option |[\FBwidth]|
+% Оформление, создаваемое по умолчанию командой |\ffigbox| такое же,
+% как в~обычном окружении \env{figure}. Но если задать опцию|[\FBwidth]|
+% \FRmpar{Ширина подписи равна ширине объекта}{FAD:FBwidthI}
+% как показано ниже:\par\RestoreSpaces
+%\begin{Quote}
+%|...|
+%|\begin{figure}|\nopagebreak
+%|\ffigbox[\|\hyperref[floatbox:FBwidth]{\texttt{FBwidth}}|]|
+%| {\caption{A figure}\label{...}}|
+%| {...}|
+%|\end{figure}|
+%\end{Quote}
+% \begin{figure}[H]
+% \ffigbox[\FBwidth]
+% {\caption[Простой бокс рисунка по ширине графики (\cmd{\ffigbox})]{Простой бокс рисунка
+% по ширине графики с~длинной длинной длинной
+% многострочной подписью}\label{intro:figure:FBwidth}}
+% {\unitlength1.87\unitlength\input{Horse.picture}}
+% \end{figure}%^^A
+%^^A% You get caption width equal to the width of picture
+%^^A% (see figure~\ref{intro:figure:FBwidth}).
+% Ширина подписи станет равной ширине графики
+% (см.~рис.~\ref{intro:figure:FBwidth}).
+%
+%^^A% The third macro---|\fcapside| (figure~\ref{intro:beside})---puts
+%^^A% caption beside:
+% Третья макрокоманда \cdash--- |\fcapside| (рис.~\ref{intro:beside}) \cdash--- помещает
+% подпись сбоку:
+%\begin{Quote}
+%\meta{preamble}
+% |\usepackage[...|\hyperref[setup:capbesidesep]{\texttt{capbesidesep}}|=quad,|%^^A
+% \hyperref[setup:facing]{\texttt{facing}}|=yes,|
+% | |\hyperref[setup:capbesideposition]{\texttt{capbesideposition}}|=inside,...]{floatrow}[2007/06/24]|
+%|...|
+%\meta{preamble}
+%|\begin{figure}|
+%|\|\hyperref[floatbox:fcapside]{\texttt{fcapside}}
+%| {\caption[...]{...}\label{...}}|
+%| {...}|
+%|\end{figure}|
+%\end{Quote}
+% \begin{figure}[H]
% \fcapside
% {\caption[Подпись рядом (ширина равна одной <<колонке>>)]{Подпись рядом,
% (ширина подписи равна ширине объекта) and more text
% and some more text and a bit more text and
-% a little more text and a little peace of text to fill
+% a little more text and a little piece of text to fill
% space}\label{intro:beside}}
-% {{\setlength\unitlength{4cm/58}\ifx\pspicture\undefined
-% \else\psset{unit=\unitlength}\fi
+% {{\setlength\unitlength{3.68cm/100}%^^A
+% \input{Bear.picture}}}
+% \end{figure}
+%^^A% The width of main text or predefined value of |\hsize| before |\fcapside| command,
+%^^A% by default, divided into two columns, their width equals to the half of current |\hsize|
+%^^A% (figure~\ref{intro:beside}) excluding float margins and
+%^^A% separation material between float and caption.
+%^^A% One column is occupied by object, another---by caption and foot material (explications
+%^^A% or legends and footnotes).
+% Ширина основного текста, или
+% предопределённая командой |\hsize| до задания |\fcapside| ширина по умолчанию делится
+% на две колонки (рис.~\ref{intro:beside}), исключая
+% поля вокруг бокса и~разделитель между объектом и~подписью. В~одну из колонок помещается рисунок,
+% в~другую \cdash--- подпись (а~также сноски и~экспликации).
+%
+%^^A% If you set the |[\FBwidth]| option:
+%^^A% \FRmpar{Caption's width equals to object}{FAD:FBwidthII}
+% И~если задать опцию |[\FBwidth]|:
+% \FRmpar{Ширина подписи равна ширине объекта}{FAD:FBwidthII}
+%\begin{Quote}
+%|...|
+%|\fcapside[\FBwidth]|
+%|...|
+%\end{Quote}
+% \begin{figure}[H]
+% \fcapside[\FBwidth]
+% {\caption[Подпись сбоку (занимает все свободное место от заданной ширины возле рисунка)]{Подпись сбоку
+% (подпись занимает всё оставшееся место рядом с~рисунком) and more text
+% and some more text and a bit more text and
+% a little more text and a little piece of text to fill
+% space}\label{intro:beside:FBwidth}}
+% {{\setlength\unitlength{3.68cm/100}%^^A
+% \input{Bear.picture}}}
+% \end{figure}
+%^^A% The graphic column width equals to the graphics and caption occupies the rest space
+%^^A% (see figure~\ref{intro:beside:FBwidth}).\medskip
+% Ширина <<колонки>> для графики равна её ширине, а~подпись занимает по ширине оставшееся место
+% (см.~рис.~\ref{intro:beside:FBwidth}).\medskip
+%
+%
+%^^A% \subsection{The Floatbox Macro}\label{sec:floatbox}
+% \subsection{Макрокоманда \cs{floatbox}}\label{sec:floatbox}
+%
+% \DescribeMacro{\floatbox}
+%^^A% This package offers macro, which creates necessary layout of float
+%^^A% object contents and caption (see also the introduction).
+%^^A% The main macro looks like:
+% Данный пакет предлагает команду, создающую
+% необходимое размещение элементов
+% флота (см. также Введение).
+% Она задаётся следующим образом:
+% \par\RestoreSpaces
+% \begin{Quote}
+% |\floatbox[|\meta{preamble}|]{|\meta{captype}|}[|^^A
+% \meta{width}|][|\meta{height}|][|\meta{vert pos}|]|
+% | {|\meta{caption}|}{|\meta{object}|}|\footnotemark
+% \end{Quote}%^^A
+%^^A% \footnotetext{The
+%^^A% order of mandatory arguments and their contents makes not
+%^^A% difference during building of float box. This macro
+%^^A% historically needs two mandatory arguments, but they could
+%^^A% be filled freely.}
+% \footnotetext{Порядок
+% обязательных аргументов и их содержимое не имеет значения
+% для построения флота. Эта макрокоманда исторически требует
+% два обязательных аргумента, но они могут быть заполнены как
+% угодно.}
+%^^A% where\label{floatboxsets}:
+% где\label{floatboxsets}:
+% \begin{description}\itemsep0pt
+%^^A% \item[\meta{preamble}]there could be |\capbeside|\label{floatbox:capbeside} command which
+%^^A% places caption beside float contents;
+%^^A% |\nocapbeside|\label{floatbox:nocapbeside}
+%^^A% (to put caption above/below, accordingly
+%^^A% to float type's style);
+%^^A% |\captop|\label{floatbox:captop}
+%^^A% (to put caption above);
+%^^A% or another systematic command
+%^^A% (even with usage of |\captionsetup|
+%^^A% and |\|\hyperref[setup:thisfloatsetup]{\texttt{thisfloatsetup}}
+%^^A% see examples in documentation and appendix).
+% \item[\meta{preamble}]здесь могут быть такие команды, как
+% |\capbeside|\label{floatbox:capbeside}, которая размещает подписи сбоку объекта;
+% |\nocapbeside|\label{floatbox:nocapbeside} (размещает подписи сверху/снизу, в~зависимости
+% от настроек стиля);
+% |\captop|\label{floatbox:captop} (размещает подписи сверху);
+% или другая повторяющаяся команда
+% (даже возможно использование |\captionsetup|
+% и~|\|\hyperref[setup:thisfloatsetup]{\texttt{thisfloatsetup}} "---
+% см. примеры в~документации и~приложении).
+%^^A% \item[\meta{captype}]the type of float this command created for;
+% \item[\meta{captype}]тип флота, для которого строится оформление;
+%^^A% \item[\meta{width}]the width of object---caption box
+%^^A% (in case of caption above or below object),
+%^^A% or width of object box (if caption stays beside object).
+%^^A% Empty width option, |[]|, and option |[\hsize]| mean the same.\par
+%^^A% The option |[\FBwidth]|\label{floatbox:FBwidth}%^^A
+%^^A% \FRmpar{Caption's width\\ equals to object}{FAD:FBwidthIII}
+%^^A% in~the \meta{width} argument
+%^^A% allows usage of natural width of float contents: \qquad for full float box in the case of caption
+%^^A% above/\allowbreak below; \qquad in~the case of beside caption natural width of float object expands to
+%^^A% object box only.\par
+%^^A% \emph{Note}. If you use the \verb|\FBwidth| command in the \meta{width}
+%^^A% optional argument, please be sure that object contents can be placed
+%^^A% in |\hbox| command (you only allowed to use |\vspace| (not |\vskip|!)
+%^^A% command at the very
+%^^A% beginning and very end of object contents for fine tuning
+%^^A% of vertical spaces and position of contents);
+% \item[\meta{width}]ширина флота целиком
+% (если подпись сверху или снизу объекта),
+% или ширина объекта (если подпись сбоку).
+% Пустая опция задания ширины, |[]|, и~опция |[\hsize]| \cdash--- одно и~то же.\par
+% Опция |[\FBwidth]|\label{floatbox:FBwidth}%^^A
+% \FRmpar{Ширина подписи\\ по ширине объекта}{FAD:FBwidthIII}
+% в~аргументе \meta{width}
+% позволяет использовать натуральную ширину объекта.\par
+% \emph{Замечание}. При использовании \verb|\FBwidth|
+% в~аргументе \meta{width}, вы должны быть уверены, что
+% содержимое объекта может быть помещено внутри |\hbox|
+% (вы можете воспользоваться командой |\vspace| (но не |\vskip|!) в~начале
+% и/или в~конце содержимого объекта для корректировки
+% вертикальных отбивок);
+%^^A% \item[\meta{height}]the height of object---caption box
+%^^A% (in case of caption above or below object),
+%^^A% or height of object box (if caption stays beside object);
+% \item[\meta{height}]высота флота
+% (если подпись сверху или снизу),
+% или высота объекта (если подпись сбоку);
+%^^A% \item[\meta{vert pos}]vertical alignment of object contents in
+%^^A% object's box in case of \meta{height} argument has larger value than
+%^^A% height of object contents, float placed inside \env{floatrow}.
+% \item[\meta{vert pos}]вертикальное выравнивание содержимого
+% объекта в~боксе в~случае, если аргумент \meta{height} имеет
+% б\'ольшую величину чем заданная высота объекта,
+% или флот помещён в~ряд в~окружении \env{floatrow}.
+%^^A% \item[\meta{caption}]text of caption and legends (you may use
+%^^A% |\floatfoot| command (see page~\pageref{subsec:floatfoot}); you
+%^^A% may also use |\footnote|/|\mpfootnotemark|/|\footnotetext| stuff
+%^^A% for footnotes inside float, or |\floatfoot| command;
+% \item[\meta{caption}]подпись и~экспликации (вы можете использовать
+% команду |\floatfoot| (см.~с.~\pageref{subsec:floatfoot});
+% вы можете использовать команды
+% |\footnote|/\allowbreak|\mpfootnotemark|/%^^A
+% \allowbreak|\footnotetext|
+% для сносок внутри флота, или команду |\floatfoot|;
+%^^A% \item[\meta{object}]Contents of float; you may use
+%^^A% |\footnote|/|\mpfootnotemark|/|\footnotetext| stuff or
+%^^A% |\floatfoot| command.
+% \item[\meta{object}]содержимое флота; вы также можете
+% использовать команды
+% |\footnote|/\allowbreak|\mpfootnotemark|/%^^A
+% \allowbreak|\footnotetext|
+% или |\floatfoot|.
+% \end{description}
+%
+%^^A% The commands |\ttabbox|, |\ffigbox|, and |\fcapside| abbreviate |\floatbox| command, which creates
+%^^A% float boxes:
+%^^A% \begin{itemize}\itemsep0pt\parskip0pt
+%^^A% \item[--] the |\ttabbox| command we can replace with the code\\
+%^^A% | \floatbox[\captop]{table}[\FBwidth]|;
+%^^A% \item[--] the |\ffigbox| one---with |\floatbox{figure}| (simplest definition); and
+%^^A% \item[--] the |\fcapside| one---with |\floatbox[\capbeside]{figure}|.
+%^^A% \end{itemize}%
+% Команды |\ttabbox|, |\ffigbox|, и~|\fcapside| являются сокращениями команды |\floatbox|, которая
+% создаёт различные комбинации объект---подпись:
+% \begin{itemize}\itemsep0pt\parskip0pt
+% \item[--] команду |\ttabbox| можно
+% заменить на \\|\floatbox[\captop]{table}[\FBwidth]|;
+% \item[--] |\ffigbox|---на
+% |\floatbox{figure}| (простейший вариант); и
+% \item[--] |\fcapside| \cdash--- на команду |\floatbox|\allowbreak|[\capbeside]{figure}|.
+% \end{itemize}%
+%
+%^^A% You see in figure~\ref{intro:figure:FBwidth} that you can change width
+%^^A% for |\ffigbox| command to get caption (and also full float box) width equal to the width
+%^^A% of object. Also you may create a new command based on |\floatbox| command
+%^^A% and set float box's width equal to object's,
+%^^A% see {\sectionname}~\ref{ssec:ffigbox:etc}.
+% Вы видите по рис.~\ref{intro:figure:FBwidth}, что можно изменить ширину
+% в~команде~|\ffigbox| так, что ширина подписи (а~заодно и~всего бокса флота) будет
+% равна ширине объекта. Можно создать собственную команду, на базе |\floatbox|,
+% где определить ширину блока по умолчанию равной ширине объекте,
+% см.~об этом {\sectionname}~\ref{ssec:ffigbox:etc}.
+%
+% \begingroup\allowprelistbreaks[-4]
+%^^A% The three examples of float placing. First simplest example:
+% Три примера размещения флотов. Первый простейший пример:
+% \par\RestoreSpaces
+%\begin{quote}\obeylines\parskip0pt
+%|\begin{figure}|\nopagebreak
+%|\floatbox{figure}[4cm]|
+%|{\caption{Простой пример ...}}%|
+%|\label{fig:WcatI}}|
+%|{\input{TheCat.picture}}|
+%|\end{figure}|
+%\end{quote}
+%^^A% created the picture in the figure~\ref{fig:WcatI}.\pagebreak[3]
+% создал картинку на рис.~\ref{fig:WcatI}. Ширина блока задана равной 4~см.
+% \begin{figure}[H]
+% \floatbox{figure}[4cm]
+% {\caption{Простой пример использования команды \cmd{\floatbox}}%
+% \label{fig:WcatI}}
+% {\unitlength1.28\unitlength\input{TheCat.picture}}
+% \end{figure}%
+% \endgroup
+%
+%^^A% The more preferable way for usage of |\floatbox| is to put table
+%^^A% caption \emph{above} table contents and set caption width equal
+%^^A% to table width.
+% Но более актуальный вариант использования команды |\floatbox|
+% \cdash--- поместить табличный заголовок \emph{над} таблицей и задать
+% ширину заголовка равной ширине
+% таблицы.
+% \par\RestoreSpaces
+%\begin{Quote}
+%|\begin{table}|\nopagebreak
+%|\floatbox[\captpop]{table}[\FBwidth]|
+%| {\caption{Simple tabular ...}\label{...}}|
+%| {\begin{tabular}{|l|c|c|}|
+%| ...}|
+%|\end{table}|
+%\end{Quote}
+% \DeleteShortVerb{\|}%
+% \begingroup
+% \floatsetup[table]{style=plain}
+% \begin{table}[H]
+% \floatbox[\captop]{table}[\FBwidth]
+% {\caption{Простая таблица в~\cmd{\floatbox} с~заголовком
+% сверху (задана команда \cmd{\captop} в~аргументе преамбулы)}\label{tab:tabII}}
+% {\begin{tabular}{|l|c|c|}
+% \hline
+% \thead{Column head} & \thead{Data I} & \thead{Data II} \\
+% \hline
+% First row & 1 & 2 \\
+% Second row & 3 & 4 \\
+% Third row & 6 & 8 \\
+% Fourth row & \llap{1}0 & \llap{1}6 \\
+% \hline
+% \end{tabular}}
+% \end{table}%
+% \endgroup
+% \MakeShortVerb{\|}%
+%^^A% as shown in table~\ref{tab:tabII}. To fit size of caption%^^A
+%^^A% \FRmpar{Caption has the object's width}{FAD:FBwidth}
+%^^A% (i.e full
+%^^A% float box) to size of \env{tabular} environment there was used
+%^^A% |\FBwidth| command in \meta{width} argument.
+% как показано в табл.~\ref{tab:tabII}. Для задания ширины%^^A
+% заголовка (или всего бокса
+% плавающего объекта) равной ширине окружения \env{tabular}
+% была использована команда |\FBwidth|
+% в аргументе \meta{width}.
+%
+%^^A% The next example shows \env{figure} environment with beside caption.
+%^^A% In this example \meta{preamble} argument consists of rather complex definition,
+%^^A% and |\FBwidth| in \meta{width} argument. The caption
+%^^A% occupies the rest space of float box's width, |\hsize| (in current
+%^^A% example the width float box equals to main text width---|\textwidth|).
+% Следующий пример показывает окружение \env{figure} где подпись
+% задана сбоку. В~этом примере используется сложное определение
+% в~аргументе \meta{preamble}, и~команда |\FBwidth|, в~аргументе
+% \meta{width}. Подпись занимает оставшееся место в~боксе
+% шириной |\hsize| (в~данном примере ширина бокса равна
+% ширине основного текста "---|\textwidth|).
+%
+% \par\RestoreSpaces
+%\begin{Quote}
+%|\begin{figure}|
+%|\floatbox[{\capbeside|
+%| \captionsetup[capbesidefigure]{format=break,labelsep=none,|
+%| justification=raggedleft}%|
+%| \|\hyperref[setup:thisfloatsetup]{\texttt{thisfloatsetup}}%^^A
+% |{|\hyperref[setup:capbesideposition]{\texttt{capbesideposition}}|=left}}]{figure}[\FBwidth]|
+%| {\caption[...]{...}\label{...}}|
+%| {...}|
+%|\end{figure}|
+%\end{Quote}
+% \begin{figure}[H]
+% \floatbox[{\capbeside
+% \captionsetup[capbesidefigure]{format=break,labelsep=none,
+% justification=raggedleft}%
+% \thisfloatsetup{capbesideposition=left}}]{figure}[\FBwidth]
+% {\caption[Подпись сбоку (пример со сложной преамбулой в~аргументе \cmd{\floatbox})]%^^A
+% {Подпись сбоку занимает оставшееся место
+% and more text and some more text and a bit more text and
+% a little more text and a little peace of text to fill
+% space}\label{fig:beside:mouse}}
+% {{\setlength\unitlength{4cm/58}%^^A
% \input{Mouse.picture}}}
% \end{figure}
+%^^A% Please note that complex preamble, with more than one command option must be placed in group.
+%^^A% (See {\sectionname}~\ref{sec:floatsetup} about settings for floats.)
+% Обратите внимание, что опция преамбулы содержащая более одной команды должна быть заключена в~группу.
+% (О создании настроек для флотов см.~{\sectionname}~\ref{sec:floatsetup})
+%
+% \RestoreSpaces
+%^^A% \subsubsection{Creation of Personal Commands for Float Boxes}\label{ssec:ffigbox:etc}
+% \subsubsection{Создание персональных команд для флотов}\label{ssec:ffigbox:etc}
+%
+%^^A% The usage of |\floatbox| command with options (which could be cumbersome) sometimes is rather complex.
+%^^A% The Introduction demonstrates commands-abbreviations of this commands.
+%^^A% You may define commands-abbreviations (or redefine existing) for your own purposes and
+%^^A% include there some additional style definitions and settings.
+% Использование команды |\floatbox| с~громоздкими опциями, в~свою очередь, тоже получается
+% громоздким. Во введении демонстрируются примеры с~командами"=сокращениями
+% данной команды. Вы можете определить собственные команды для
+% ваших целей и~определить там необходимые настройки.
+%
+%^^A% The definition of new float abbreviation looks like:
+% Определение пользовательской команды выглядит следующим образом:%^^A
+% \begin{quote}
+% |\newfloatcommand|\marg{command}%^^A\\\strut\qquad
+% \marg{captype}\oarg{preamble}\oarg{default width}
+% \end{quote}
+% где:
+% \begin{description}
+%^^A% \item[\meta{command}]the user's command name (without backslash);
+% \item[\meta{command}]команда пользователя (без обратного слэша);
+%^^A% \item[\meta{captype}]the name of float environment
+%^^A% this command is created for;
+% \item[\meta{captype}]тип флота, для которого создаётся команда;
+%^^A% \item[\meta{preamble}]
+%^^A% you may use commands, mentioned in page~\pageref{floatboxsets}
+%^^A% and other layout commands, like was shown in examples;
+%^^A% you may try to add any other regular command (e.g. |\captionsetup|
+%^^A% or |\thisfloatsetup| stuff);
+% \item[\meta{preamble}]
+% вы можете использовать команды, перечисленные на
+% с.~\pageref{floatboxsets}
+% и~другие команды оформления, как показано в~примерах;
+% вы можете попробовать использовать некоторые другие
+% повторяющиеся команды (например,
+% |\captionsetup| или |\thisfloatsetup|);
+%^^A% \item[\meta{default width}]the first reason of usage of this option is
+%^^A% to put |\FBwidth| command: \quad in case of
+%^^A% caption above or below object (there could be defined
+%^^A% |\nocapbeside| in \meta{preamble} option) this command defines width of
+%^^A% full float (object---caption) box; \quad in the case of caption
+%^^A% beside object (there must be defined |\capbeside| in \meta{preamble}
+%^^A% option) this command defines
+%^^A% to width of object (caption occupies the rest space).
+%^^A% You may put also any dimension like |6cm|
+%^^A% or |.75\textwidth| but usage of option by
+%^^A% this way is much less reasonable.
+% \item[\meta{default width}] основной повод использования этой опции \cdash---
+% задание команды |\FBwidth|: \qquad в~случае размещения
+% подписи сверху или снизу
+% (может быть определена |\nocapbeside| в~опции \meta{preamble})
+% команда определяет ширину всего флота
+% (блока объект\cdash--~подпись); \qquad в~случае подписи
+% сбоку (должна быть определена команда |\capbeside| в~\meta{preamble})
+% она определяет ширину объекта.
+% Можно задать и любую величину, типа |6cm|
+% или |.75\textwidth| но использование таких значений гораздо менее резонно.
+% \end{description}
%
-% Все три команды являются сокращениями команды |\floatbox|, которая
-% создаёт комбинации объект---подпись (см.
-% разд.~\ref{sec:floatbox}).
+%^^A% Let's repeat three already defined commands-abbreviations:\label{abbrcom}%^^A
+% Повторим определения следующих пользовательских команд:\label{abbrcom}
+% \begin{Quote}
+% |\newfloatcommand{ffigbox}{figure}[\nocapbeside]|\label{floatbox:ffigbox}\nopagebreak
+% |\newfloatcommand{fcapside}{figure}[\capbeside]|\label{floatbox:fcapside}\nopagebreak
+% |\newfloatcommand{ttabbox}{table}[\captop][\FBwidth]|\label{floatbox:ttabbox}
+% \end{Quote}
+%^^A% First two defined for figures and last one---for table. You may
+%^^A% redefine existing macros using |\renewfloatcommand| command (it uses
+%^^A% the same arguments as |\newfloatcommand| one).
+% Первые две определены для рисунков, а~последняя \cdash--- для таблицы.
+% Вы можете переопределить эти команды, используя команду
+% |\renewfloatcommand| (она использует те же
+% аргументы, как и~|\newfloatcommand|).\medskip
+%
+%^^A% Your defined commands you may use in following way (example for |\ffigbox|):
+%^^A% \begin{quote}
+% Созданные вами команды можно использовать следующим образом
+% (на примере |\ffigbox|):
+% \begin{Quote}
+% |\ffigbox|\oarg{width}\oarg{height}\oarg{vert pos}
+% \end{Quote}
+%^^A% first option, \oarg{width}, redefines the default width settings, which were
+%^^A% used during (re)definition of current command. The other two options
+%^^A% are analogous to the |\floatbox|'s ones (see page~\pageref{sec:floatbox}).
+% первая опция, \oarg{width}, отменяет значение ширины по умолчанию,
+% заданное при создании (или переопределении) данной команды. Две другие опции
+% аналогичны тем же опциям в~команде |\floatbox| (см.~с.~\pageref{sec:floatbox}).
+%
+% \par\RestoreSpaces
+%^^A% \subsection{Building Float Row}\label{sec:floatrow}
+% \subsection{Размещение флотов рядом}\label{sec:floatrow}
+%
+%^^A% If you need to put two or more floats of one type side by side,%^^A
+%^^A% \FRmpar{Float row: floats of one type side by side}{FAD:floatrow}
+%^^A% you may use \env{floatrow} environment.
+% Если вам нужно поместить два или более флотов рядом,%^^A
+% \FRmpar{Флоты одного типа рядом}{FAD:floatrow}
+% вы можете воспользоваться окружением \env{floatrow}.
+%
+% \par\RestoreSpaces
+%^^A% This environment looks like:
+% Это окружение выглядит следующим образом:
+% \begin{Quote}
+% |\begin{floatrow}[|\meta{number of beside floats}|]|\nopagebreak
+% |\floatbox...|\nopagebreak
+% |\floatbox...|\nopagebreak
+% |...|\nopagebreak
+% |\end{floatrow}|
+% \end{Quote}
+%
+%^^A% The \env{floatrow} environment allows to put floats side by side.
+%^^A% This environment creates necessary number of ``columns''
+%^^A% (usually two), where floats are placed. You may redefine the width of each float box,
+%^^A% e.g. the table boxes~\ref{tab:row:tabIII} and~\ref{tab:row:tabIV} have the width of their contents
+%^^A% (remember, the |[\FBwidth]| is default option of |\ttabbox|).
+% Окружение \env{floatrow} позволяет разместить флоты рядом.
+% Это окружение создаёт необходимое число <<колонок>>
+% (обычно две), где и~помещаются флоты. Вы можете определить ширину бокса для флота,
+% например, боксы таблиц~\ref{tab:row:tabIII} и~\ref{tab:row:tabIV} имеют ширину, равную ширине табличного материала
+% (напомним, опция |[\FBwidth]| является опцией по умолчанию в~команде |\ttabbox|).
+%
+%^^A% Please note that \emph{for each float box} inside \env{floatrow} you must use |\floatbox|, |\ffigbox|,
+%^^A% |\ttabbox| or your own command, created with |\newfloatcommand| macro:
+% Обратите внимание, что \emph{для каждого флота} внутри окружения \env{floatrow} должны
+% использоваться команды |\floatbox|, |\ffigbox|,
+% |\ttabbox| или ваша собственная команда, созданная с~помощью |\newfloatcommand|:
+%\begin{Quote}
+%\meta{preamble}
+%| \usepackage[...|\hyperref[setup:floatrowsep]{\texttt{floatrowsep}}|=qquad,...]{floatrow}|
+%| \|\hyperref[sec:floatsetup]{\texttt{floatsetup}}|[table]{|%^^A
+% \hyperref[setup:style]{\texttt{style}}|=Plaintop}|
+%\meta{preamble}
+%|\begin{figure}|
+%| \begin{table}|
+%| \ttabbox|
+%| {\caption{...}\label{...}}|
+%| {...}|
+%| |
+%| \ttabbox|
+%| {\caption{...}\label{...}}|
+%| {...}|
+%| \end{floatrow}|
+%|\end{table}|
+%\end{Quote}
+% \DeleteShortVerb{\|}%
+% \begin{table}[H]
+% \begin{floatrow}
+% \extrarowheight1pt
+% \ttabbox
+% {\caption[Первая таблица в~ряду, длинный заголовок]%^^A
+% {Первая таблица в~ряду с~длинным, длинным, длинным длиннющим заголовком и~выровненным по верху}%^^A
+% \label{tab:row:tabIII}}%^^A
+% {\begin{tabular}{|l|>{\phantom0}c|>{\phantom0}c|}
+% \hline
+% \multirowthead{2}[-1ex]{Left Column Head}
+% & \multicolumn{2}{c|}{\thead{Data}} \\
+% \cline{2-3}
+% & \multicolumn{1}{c|}{\thead{I}}
+% & \multicolumn{1}{c|}{\thead{II}}
+% \\\hline
+% First row & 1 & 2 \\
+% Second row & 3 & 4 \\
+% Third row & 6 & 8 \\
+% Fourth row & \llap{1}0 & \llap{1}6 \\
+% \hline
+% \end{tabular}}
%
-% Окружение \env{floatrow} позволяет поместить плавающие объекты рядом, как
-% рис.~\ref{intro:leftfig} и~\ref{intro:rightfig}. По умолчанию \env{floatrow}
-% создаёт необходимое число <<колонок>> (обычно две) где и помещает объекты:
-%\begin{verbatim}
-%\begin{figure}
-% \begin{floatrow}
-% \ffigbox
-% {...}{\caption{...}\label{...}}
-%
-% \ffigbox
-% {...}{\caption{...}\label{...}}
-% \end{floatrow}
-%\end{figure}
-%\end{verbatim}
-% \begin{figure}[h]
+% \ttabbox
+% {\caption{Вторая таблица в~ряду, заголовок выровнен по верху}\label{tab:row:tabIV}}%^^A
+% {\begin{tabular}{|l|c|c|c|}
+% \hline
+% \multirowthead{2}[-1ex]{Column Head}
+% & \multicolumn{3}{c|}{\thead{Data}} \\
+% \cline{2-4}
+% & \thead{I} & \thead{II} & \thead{III} \\
+% \hline
+% First row & 1 & 2 & \phantom01 \\
+% Second row & 3 & 4 & \phantom06 \\
+% Third row & 6 & 8 & 28 \\
+% \hline
+% \end{tabular}}
+% \end{floatrow}
+% \end{table}
+% \MakeShortVerb{\|}%
+%^^A% Since |\ttabbox| uses |\FBwidth| as default option, the caption width equals to tabular contents.
+% Поскольку |\ttabbox| использует команду |\FBwidth| как опцию по умолчанию,
+% ширина заголовка равна ширине таблицы.
+%
+%^^A% The next example with figures uses |[\FBwidth]| for the left float and |[\Xhsize]| for the right.
+% Следующий пример с~рисунками задаёт опцию |[\FBwidth]| для левого флота и~|[\Xhsize]| для правого.
+%\begin{Quote}
+%|...|\nopagebreak
+%|\begin{figure}|\nopagebreak
+%| \begin{floatrow}|\nopagebreak
+%| \ffigbox[\FBwidth]|
+%| {...}|
+%| {\caption{...}\label{...}}|
+%| |
+%| \ffigbox[\Xhsize]|%^^A
+% \FRmpar{Флоты рядом: флот занимает оставшееся место}{FAD:floatfillspace}
+%| {...}|
+%| {\caption{...}\label{...}}|
+%| \end{floatrow}|\nopagebreak
+%|\end{figure}|
+%\end{Quote}
+% \begin{figure}[H]
% \begin{floatrow}
-% \ffigbox
-% {\input{BlackDog.picture}}
-% {\caption{Рисунок слева в ряду}%
-% \label{intro:leftfig}}%
+% \ffigbox[\FBwidth]
+% {\caption{Левый рисунок в~ряду, ширина бокса равна ширине графики}%
+% \label{intro:leftfig:FBwidth}}%
+% {\unitlength1.12\unitlength\input{Bear.picture}}
%
+% \ffigbox[\Xhsize]
+% {\caption[Правый рисунок в~ряду, бокс занимает оставшееся место]{Рисунок в~ряду, с~правой стороны простого ряда
+% рисунков, бокс занимает всё оставшееся в~ряду}%^^A
+% \label{intro:rightfig:Xhsize}}
+% {\unitlength1.44\unitlength\input{Doll.picture}}
+% \end{floatrow}
+% \end{figure}%^^A
+%
+%^^A% \emph{Note}. Usually the command |\Xhsize| is used for the last float
+%^^A% box. But if you use \package{calc} package you may try to use |\Xhsize|
+%^^A% earlier, if the \emph{absolute} value of the width of float boxes to
+%^^A% the right in float row is known, or set something in \meta{width}
+%^^A% argument like |\Xhsize/2| and then |\Xhsize| for two last
+%^^A% |\floatbox|'es---the next example just uses it.
+% \emph{Замечание}. Обычно команда |\Xhsize| используется для
+% последнего флота в~ряду. Но
+% если вы используете пакет \package{calc} вы можете попытаться
+% использовать |\Xhsize| раньше, если известна
+% \emph{абсолютная} величина ширины флотов по правую сторону,
+% или использовать в~аргументе \meta{width} нечто вроде |\Xhsize/2|
+% а~затем |\Xhsize| для последних двух боксов в~|\floatbox|, что и~задано в~следующем примере.
+%
+%^^A% And here is more complex example. The first float (used |\ffigbox|) has default
+%^^A% width equal to ``column'' width, the next uses width of included
+%^^A% graphic (uses command |\FBwidth| in optional argument \meta{width}),
+%^^A% the last two occupy the rest horizontal space of page which was
+%^^A% counted with command |\Xhsize| and \package{calc} package.%^^A
+% И~теперь пример чуть посложнее. Первый флот (в~|\ffigbox|) имеет ширину
+% по умолчанию, равную <<колонке>>
+% ряда, следующий использует ширину включённой графики (использована
+% команда |\FBwidth| в~дополнительном аргументе \meta{width}),
+% а~два последних занимают оставшееся место в~ряду,
+% подсчитанное командой |\Xhsize| и~пакетом \package{calc}.%^^A
+% \par\RestoreSpaces
+%\begin{Quote}
+%\meta{preamble}
+% |\DeclareMarginSet{hangleft}{\setfloatmargins|
+% | {\hskip-\marginparwidth\hskip-\marginparsep}{\hfil}}|
+% |\floatsetup[|\hyperref[setup:widefigure]{\texttt{widefigure}}|]{|%^^A
+% \hyperref[setup:margins]{\texttt{margins}}|=hangleft}|
+%\meta{preamble}
+%|\begin{figure*}|
+%|\begin{floatrow}[4]|
+%| \ffigbox|
+%| {\caption{Beside figure~I...}...}|
+%| {...}|
+%| |
+%| \ffigbox[\FBwidth]|
+%| {\caption{Beside figure~II...}...}|
+%| {...}|
+%| |
+%| \ffigbox[\Xhsize]|
+%| {\caption{Beside figure~III...}...}|
+%| {...}|
+%|\end{floatrow}|
+%|\end{figure*}|
+%\end{Quote}
+% \floatsetup[widefloat]{margins=hangleft}
+% \begin{figure*}%
+% \begin{floatrow}[4]
% \ffigbox
-% {\caption{Рисунок расположенный справа, в простом ряду рисунков}%^^A
-% \label{fig:rotrow:FcatI}}
-% {\input{TheCat.picture}\label{intro:rightfig}}
+% {\caption{Первый рисунок в~ряду (\env{floatrow}), ширина <<колонки>>}%
+% \label{fig:row:Dog}}
+% {\input{TheDog.picture}}
+%
+% \ffigbox[\FBwidth]
+% {\caption{Второй рисунок в~ряду (\env{floatrow}), ширина графики}%
+% \label{fig:row:WcatI}}
+% {\input{TheCat.picture}}
+%
+% \ffigbox[\Xhsize/2]
+% {\caption{Третий рисунок в~ряду, занимает
+% половину оставшегося места}%
+% \label{fig:row:BcatI}}
+% {{\setlength\unitlength{\hsize/58}%^^A
+% {\input{Mouse.picture}}}}
+%
+% \ffigbox[\Xhsize]
+% {\caption{Четвёртый рисунок в~ряду,
+% занимает оставшееся место}%
+% \label{fig:row:mouseI}}
+% {\input{Cheese.picture}}
+% \end{floatrow}
+% \end{figure*}%
+%^^A% The result you see in the row of
+%^^A% figures~\ref{fig:row:WcatI}--\ref{fig:row:mouseI}. The vertical
+%^^A% alignment of floats lays on the bottom of upper part (here: objects)
+%^^A% of float and the top of lower part (captions).
+% Результат вы видите в~ряду
+% рисунков~\ref{fig:row:Dog}--\ref{fig:row:mouseI}. Вертикальное
+% выравнивание флотов лежит по нижней линии верхней части
+% (здесь: графики) и~верху нижней части (подписи).
+%
+% \RestoreSpaces
+%^^A% \subsubsection{Mixed Row}\label{sec:mixrow}
+% \subsubsection{Смешанные ряды}\label{sec:mixrow}
+%
+%^^A% The problem in mixed row is that you must put different types of float in
+%^^A% one float environment, which sets its own layout for included float
+%^^A% box(es). For creation of right layouts write
+%^^A% |\|\hyperref[setup:killfloatstyle]{\texttt{killfloatstyle}} command at the beginning of \env{floatrow}
+%^^A% environment or just before first ``foreign'' |\floatbox| macro (in
+%^^A% current example---before |\ttabbox|; the |\ffigbox| macro is
+%^^A% ``native'' for \env{figure} environment).
+% Проблема смешанного ряда заключается в~том, что нужно поместить разные
+% типы флотов в~одно окружение флота, которое задаёт своё оформление
+% для содержимого. Для создания верного оформления задайте команду
+% |\|\hyperref[setup:killfloatstyle]{\texttt{killfloatstyle}} в~начале окружения \env{floatrow}
+% или до первой <<чужой>> макрокоманды |\floatbox| (в~данном
+% примере "--- до |\ttabbox|; команда |\ffigbox| является
+% <<родной>> для окружения \env{figure}).
+%
+%^^A% Another problem is that figures usually have captions below
+%^^A% graphics, but tables could have caption \emph{above} their contents.
+%^^A% The alignment of all floats is similar: the bottom of upper part and
+%^^A% top of lower part. In this case if you want to put such beside figure
+%^^A% and table you'll get undesirable result. For such situations you may
+%^^A% use one of following commands:
+% Другая проблема состоит в~том, что подпись к~рисункам обычно
+% помещают снизу, а~табличный заголовок помещается сверху таблиц.
+% Выравнивание всех флотов одинаково: по нижней линии верхней части
+% и~по верхней "--- у~нижней. В~таком случае, если вы захотите
+% поместить такие рисунок и~таблицу,
+% вы получите не лучший вариант вёрстки. В~таких ситуациях
+% вы можете использовать одну из приведённых команд:
+%\begin{Quote}
+%|\CenterFloatBoxes|\label{floatbox:CenterFloatBoxes}
+%|\TopFloatBoxes|\label{floatbox:TopFloatBoxes}
+%|\BottomFloatBoxes|\label{floatbox:BottomFloatBoxes}
+%\end{Quote}
+%^^A% which align \emph{full} float boxes by center, top or bottom lines.
+%^^A% These macros were created by |\buildFBBOX| macro.
+%^^A% There is also |\PlainFloatBoxes|\label{floatbox:PlainFloatBoxes} which restores standard behavior of
+%^^A% |\floatbox|'es.
+% Которые выравнивают флоты \emph{целиком} по центральной линии,
+% по верху или по низу. Эти команды
+% были созданы командой |\buildFBBOX|\label{floatbox:buildFBBOX}. Существует
+% также команда |\PlainFloatBoxes|\label{floatbox:PlainFloatBoxes}, которая восстанавливает
+% <<поведение>> флотов внутри команд |\floatbox|.
+%
+%^^A% The usage of |\CenterFloatBoxes| and |\killfloatstyle| you'll see in
+%^^A% mixed float row with figure~\ref{fig:rowmixspec:WcatI} and
+%^^A% table~\ref{tab:rowmixspec:tabI}\label{mixrow}:
+% Использование |\CenterFloatBoxes| и~|\killfloatstyle| вы видите
+% в~смешанном ряду, состоящем из рис.~\ref{fig:rowmixspec:WcatI}
+% и~табл.~\ref{tab:rowmixspec:tabI}\label{mixrow}:
+%\begin{Quote}
+%|\begin{figure}\CenterFloatBoxes|\nopagebreak
+%|\begin{floatrow}|
+%| \ffigbox[\FBwidth]|
+%| ...|
+%| \killfloatstyle\ttabbox|
+%| ...|
+%\end{Quote}
+% \DeleteShortVerb{\|}%
+% \begingroup
+% \begin{figure}[H]\CenterFloatBoxes
+% \begin{floatrow}
+% \ffigbox[\FBwidth]
+% {\unitlength1.86\unitlength\input{Horse.picture}}
+% {\caption{Рисунок в~смешанном ряду}\label{fig:rowmixspec:WcatI}}%
+% \extrarowheight1pt
+% \ttabbox
+% {\caption{Таблица в~смешанном \hbox{ряду}}\label{tab:rowmixspec:tabI}}
+% {\tabcolsep5\tabcolsep\begin{tabular}{|c|c|}\hline A & B \\ C & D \\ \hline\end{tabular}}
+% \end{floatrow}
+% \end{figure}
+% \endgroup
+% \MakeShortVerb{\|}%
+% \par\RestoreSpaces
+%
+%^^A% \emph{Note.} Both figure and table boxes have got width equal to
+%^^A% contents of objects. The |\ffigbox| command has optional argument
+%^^A% |[\FBwidth]|, but |\ttabbox| have not any option---it uses
+%^^A% |[\FBwidth]| option as default (see definitions on page
+%^^A% \pageref{abbrcom}).\label{FAD:MixedRowII}
+% \emph{Замечание.} Как рисунок, так и~таблица имеют ширину, равную
+% содержимому объектов. Команда |\ffigbox| имеет дополнительный
+% аргумент |[\FBwidth]|, но у~команды |\ttabbox| нет никакой опции
+% "--- опция |[\FBwidth]| используется по умолчанию (см. определения
+% на с.~\pageref{abbrcom}).\label{FAD:MixedRowII}
+%
+%^^A% \subsection{Running Floats In The Raw \LaTeX\ mode}\label{sec:rawfloats}
+% \subsection{Плавающие объекты в~режиме стандартного \LaTeX'а}\label{sec:rawfloats}
+%
+%^^A% The\label{FAD:PlainFloat}
+%^^A% \package{floatrow} package redefines float environments for the case
+%^^A% of creation of common layout for all floats. This redefinition creates
+%^^A% some limitations for source document file, which were mentioned in
+%^^A% introduction. If you still need a raw behavior of float environment,
+%^^A% you may do that by one of three ways.
+% Пакет\label{FAD:PlainFloat}
+% \package{floatrow} переопределяет окружение флотов так, чтобы
+% на выходе получалось единообразное
+% оформление всех флотов. Это накладывает некоторые ограничения
+% на запись флота в~исходном файле, о~которых, в~частности,
+% говорилось во введении. Если вам всё
+% же нужно окружение, работающее как в~обычном \LaTeX'е
+% это можно сделать тремя способами.
+%
+%^^A% 1.\enskip If you want \LaTeX\ behavior for \emph{just for one environment},
+%^^A% input a |\RawFloats| command \emph{inside} environment:
+% 1.\enskip Если нужно, чтобы \emph{лишь одно окружение} работало как в~обычном
+% \LaTeX'е, задайте команду |\RawFloats| \emph{внутри} окружения:
+% \par\RestoreSpaces
+%\begin{Quote}\openup.5pt
+%|\begin{figure}\RawFloats|\nopagebreak
+%|\captionsetup[table]{position=top}|
+%|\begin{minipage}{0.45\textwidth}|
+%| \centering ...|
+%| \caption{...}\label{...}|
+%|\end{minipage}|
+%|\begin{minipage}{0.45\textwidth}|
+%| \captionof{table}{...}\label{...}|
+%| \centering ...|
+%|\end{minipage}|\nopagebreak
+%|\end{figure}|
+%\end{Quote}
+%^^A% And you'll get figure~\ref{Right:expect:fig}
+%^^A% and table~\ref{Right:expect:tab}\footnote{That could work correct if
+%^^A% you do not use any fancy float layout at least for one of floats.}.
+% и~вы получите рис.~\ref{Right:expect:fig}
+% и~табл.~\ref{Right:expect:tab}\footnote{Это будет работать,
+% если вы не используете необычного оформления.}.
+% \begin{figure}[H]\RawFloats
+% \captionsetup[table]{position=top}
+% \begin{minipage}{0.45\textwidth}
+% \centering {\unitlength1.86\unitlength\input{Horse.picture}}
+% \caption{Рисунок в~ряду в~режиме обычного \LaTeX'а}\label{Right:expect:fig}
+% \end{minipage}\quad\hfill
+% \killfloatstyle\begin{minipage}{0.45\textwidth}
+% \captionof{table}{Таблица в~ряду в~режиме обычного \LaTeX'а}\label{Right:expect:tab}
+% \centering\tabcolsep5\tabcolsep
+% \begin{tabular}{|c|c|}\hline A & B \\ C & D \\ \hline\end{tabular}
+% \end{minipage}
+% \end{figure}
+% \par\RestoreSpaces
+%^^A% Compare this example with example in the {\sectionname}~\ref{sec:mixrow} and the example below.
+% Сравните этот пример с~примером из {\sectionname}~\ref{sec:mixrow} и~следующим примером.
+%\begin{Quote}\openup.65pt
+%|\begin{figure}\RawFloats\CenterFloatBoxes|\nopagebreak
+%|\begin{floatrow}|
+%| \ffigbox[\FBwidth]|\nopagebreak
+%| {...}|\nopagebreak
+%| {\caption{...}\label{...}}|
+%| |
+%| \ttabbox|\nopagebreak
+%| {...}|\nopagebreak
+%| {\caption{...}\label{...}}|
+%|\end{floatrow}|\nopagebreak
+%|\end{figure}|
+%\end{Quote}
+% \begin{figure}[H]\RawFloats\CenterFloatBoxes
+% \begin{floatrow}
+% \ffigbox[\FBwidth]
+% {\unitlength1.86\unitlength\input{Horse.picture}}
+% {\caption{Рисунок в~ряду внутри команды \cmd{\floatbox} и~в~окружении \env{floatrow} в~режиме обычного \LaTeX'а}%^^A
+% \label{intro:leftfig:raw}}%
+%
+% \ttabbox
+% {\caption{Таблица в~ряду внутри \cmd{\floatbox} и~в~окружении \env{floatrow} в~режиме обычного \LaTeX'а}%^^A
+% \label{intro:righttab:raw}}
+% {\tabcolsep5\tabcolsep
+% \begin{tabular}{|c|c|}\hline A & B \\ C & D \\ \hline
+% \end{tabular}}
% \end{floatrow}
% \end{figure}%^^A
-% Обратите внимание, что внутри окружения \env{floatrow} вы должны использовать
-% макрокоманды |\ffigbox| или |\ttabbox| для каждого флота. (См. подробнее
-% о командах, используемых в примерах введения и о команде |\floatbox|
-% в разд.~\ref{sec:floatbox};
-% об окружении \env{floatrow} "--- в разд.~\ref{sec:floatrow}.)
%
-% \subsection{Это не допускается пакетом \pkg{floatrow}}
+%^^A% 2.\enskip Canceling of \package{floatrow}'s behavior of \emph{all floats of one type}
+%^^A% is set outside any float environment, this settings are better for
+%^^A% preamble. In this case the |\RawFloats| command needs optional
+%^^A% argument with name(s) of float type. You may set that by two ways:
+% Отмена установок пакета \package{floatrow} для \emph{всех флотов данного типа}
+% задаётся вне окружений флотов и~такие установки лучше задать
+% в~преамбуле. В~таком случае команда |\RawFloats| задаётся с~опцией
+% задающей названия типа флотов. Это можно задать двумя способами:
+% \par\RestoreSpaces
+% \begin{Quote}
+% |\RawFloats|\oarg{type,type,\ldots}\quad or\nopagebreak
+% |\RawFloats|\oarg{type}\oarg{subtype,subtype,\ldots}
+% \end{Quote}
+%^^A% So, if you set |\RawFloats[figure]|, that will return to all figures
+%^^A% in all subtype environments (\texttt{figure}, \texttt{figure*},
+%^^A% \texttt{sidewaysfigure}, etc.) plain \LaTeX{} behavior. If there is also a table,
+%^^A% |\RawFloats[figure,table]|, you also will set the same for all table
+%^^A% subtypes.
+% Итак, если вы зададите |\RawFloats[figure]|, это вернёт всем рисункам
+% во всех относящимся к~ним окружениях (\texttt{figure}, \texttt{figure*},
+% \texttt{sidewaysfigure} и~др.) установки \LaTeX{}. Если ещё добавить таблицы:
+% |\RawFloats[figure,table]|, вы также отмените установки \package{floatrow}
+% и~для всех окружений таблиц.
+%
+%^^A% The second way, with second optional argument, cancels \package{floatrow}'s
+%^^A% behavior for mentioned float ``subtype(s)'' of \emph{one} float type
+%^^A% in second optional argument you may use \texttt{float}, \texttt{widefloat},
+%^^A% \texttt{rotfloat}, \texttt{widerotfloat}---the meaning of this options
+%^^A% analogous to options of |\floatsetup| macro
+%^^A% (see {\sectionname}~\ref{sec:floatsetup}) but you may use here only options which
+%^^A% include ``float'' word\label{FAD:PlainFloatII}%^^A
+%^^A% %^^A(or short variants without ``float'', like
+%^^A% %^^A\texttt{rot} or \texttt{widerot})%^^A
+%^^A% .%^^A
+% Второй вариант, со второй опцией, отменяет установки \package{floatrow}
+% заданных в~ней окружений данного типа флота. Во второй опции
+% можно задать \texttt{float}, \texttt{widefloat},
+% \texttt{rotfloat}, \texttt{widerotfloat}---значение этих опций аналогично
+% опциям команды |\floatsetup|
+% (см. {\sectionname}~\ref{sec:floatsetup}) но в~данном случае можно использовать
+% опции только со словом «float»\label{FAD:PlainFloatII}%^^A
+% %^^A(or short variants without ``float'', like
+% %^^A\texttt{rot} or \texttt{widerot})%^^A
+% .%^^A
+%
+% \DescribeMacro{rawfloats}\label{setup:rawfloats}%^^A
+%^^A% This option stores the plain \LaTeX{} mode (i.e. stores usage of standard
+%^^A% \LaTeX{} float macros) for all standard and new
+%^^A% user defined float types. This option can be used only in
+%^^A% |\usepackage| line.
+% Данная опция сохраняет режим plain \LaTeX'а (т.\,е. использование
+% стандартных команд \LaTeX'а) для всех стандартных и~вновь созданных
+% типов флотов. Опция может использоваться только в~строке
+% |\usepackage|.
+%
+%^^A% The \env{floatrow} environment ({\sectionname}~\ref{sec:floatrow})
+%^^A% and commands of |\floatbox| stuff ({\sectionname}~\ref{sec:floatbox})
+%^^A% still work after |\RawFloats|' settings (see figure~\ref{intro:leftfig:raw}
+%^^A% and table~\ref{intro:righttab:raw})\label{FAD:MixedRow}%^^A
+% Окружение \env{floatrow} ({\sectionname}~\ref{sec:floatrow})
+% и~команды базирующиеся на |\floatbox| ({\sectionname}~\ref{sec:floatbox})
+% всё равно работают после задания команды |\RawFloats|
+% и~опции |rawfloats=| (рис.~\ref{intro:leftfig:raw}
+% и~табл.~\ref{intro:righttab:raw})\label{FAD:MixedRow}%^^A
+%
+% \RestoreSpaces
+%^^A% \subsection{Usage of Footnotes Inside Float Environment}
+% \subsection{Сноски внутри окружения
+% флота}\label{sec:floatfootnote}
%
-% Пакет \pkg{floatrow} создаёт некоторые особенности и ограничения
-% в построении плавающих объектов. Если вы запишете:
-%\begin{verbatim}
-%\begin{figure}
-%\caption{A figure caption}
-%\centering \input{Mouse.picture}
-%\end{figure}
-%\end{verbatim}
-% не ожидайте что получите подрисуночную подпись сверху рисунка. Если
-% вы хотите, например, поместить подрисуночные подписи сверху, вы должны
-% задать в преамбуле |\floatsetup[figure]{style=plaintop}| (см. также
-% разд.~\ref{sec:floatsetup} о механизме команды |\floatsetup|).
+%^^A% Sometimes table
+%^^A% or figure contents have material, which authors mark
+%^^A% and then write some explanation like footnotes. Current package has
+%^^A% mechanism which allows to put footnotes inside float environment, in
+%^^A% the same way as is in \env{minipage} environment.
+% Иногда таблица или рисунок может содержать
+% материал, который помечается а~снизу даётся объяснение в~виде сноски.
+% Пакет имеет механизм, позволяющий размещение сносок внутри окружения флота,
+% как это сделано в~окружении \env{minipage}.
+%
+%^^A% In the case of few elements have the same footnote, we cannot
+%^^A% use standard |\footnotemark|---|\footnotetext| combination, because
+%^^A% of |\footnotemark| in standard \LaTeX\ always creates the sign of main text footnote.
+%^^A% For these cases current package offers |\mpfootnotemark|
+%^^A% \FRmpar{Footnotemark inside float}{FAD:FnoteInsideFloat}
+%^^A% macro instead of |\footnotemark|%
+%^^A% \footnote{The same macro also is defined in \package{footmisc} package,
+%^^A% version 4.10, dated 2003/01/20.}.
+% В~тех случаях, когда несколько элементов
+% имеют одинаковую сноску, мы не можем воспользоваться стандартной
+% комбинацией |\footnotemark|---|\footnotetext|, потому что команда
+% |\footnotemark|
+% \FRmpar{Знак сноски внутри флота}{FAD:FnoteInsideFloat}
+% в~стандартном \LaTeX'е всегда создаёт знак для сноски основного текста.
+% Для этих случаев данный пакет предлагает макрокоманду
+% |\mpfootnotemark| вместо |\footnotemark|%%^^A
+% \footnote{Та же макрокоманда также определена в~пакете
+% \package{footmisc}, версия 4.10, датированная 2003/01/20.}.
+% \begin{Quote}\openup-.35pt%
+% \meta{preamble}
+% |\floatsetup{...,|\hyperref[setup:footnoterule]{\texttt{footnoterule}}|=limited,|%^^A
+% \hyperref[setup:footskip]{\texttt{footskip}}|=\skip\footins,...}|
+% \meta{preamble}
+% |\begin{table}|
+% |\ttabbox|
+% | {\caption{...}\label{...}}%|
+% \verb+ {\begin{tabular}{...}+
+% | \hline|
+% | First row & \phantom01 & 2\mpfootnotemark[1] \\|
+% | Second row & \phantom06\mpfootnotemark[1] & 4\mpfootnotemark[1] \\|
+% | ...|
+% | \hline|
+% | \end{tabular}%|
+% | \footnotetext[1]{Even numbers.}}|
+% |\end{table}|
+% \end{Quote}%
+% \DeleteShortVerb{\|}%
+% \begin{table}[H]\floatsetup{footnoterule=limited,footskip=\skip\footins}
+% \ttabbox
+% {\caption{Таблица со сноской}%^^A
+% \label{tab:floatfnote}}%^^A
+% {\extrarowheight1pt
+% \begin{tabular}{|l|c|c|}
+% \hline
+% \thead{Column head} & \thead{Data I} & \thead{Data II} \\
+% \hline
+% First row & \phantom01 & 2\mpfootnotemark[1] \\
+% Second row & \phantom06\mpfootnotemark[1] & 4\mpfootnotemark[1] \\
+% Third row & 28\mpfootnotemark[1] & 8\mpfootnotemark[1] \\
+% \hline
+% \end{tabular}%^^A
+% \footnotetext[1]{Even numbers.}}
+% \end{table}%
+% \MakeShortVerb{\|}%
%
-%^^A \begin{figure}
-%^^A \caption{A figure caption}\label{Wrong:expect}
-%^^A \centering \input{Mouse.picture}
-%^^A \end{figure}
%
-% Другой пример. Если вы поместите плавающие объекты следующим образом:
-%\begin{verbatim}
-%\begin{figure}
+%^^A% The |\floatbox| macro uses special own definition of footnote rule
+%^^A% (the \hyperref[setup:footnoterule]{\texttt{footnoterule}}|=| key) and skip before footnotes and
+%^^A% explications or legends (\hyperref[setup:footskip]{\texttt{footskip}}|=|). (See also
+%^^A% page~\pageref{sec:footnotestyle} for variants of footnote rule.)
+% Макрокоманда |\floatbox| использует собственное определение линейки для
+% сноски (ключ \hyperref[setup:footnoterule]{\texttt{footnoterule}}|=|) и~отбивку до сносок
+% и~экспликаций (ключ \hyperref[setup:footskip]{\texttt{footskip}}|=|). (См. также
+% с.~\pageref{sec:footnotestyle} о~вариантах линейки для сносок под флотами.)
+%
+% \RestoreSpaces
+%^^A% \subsubsection{The Legend-Like Macro}\label{subsec:floatfoot}
+% \subsubsection{Макрокоманда для экспликаций}\label{subsec:floatfoot}
+%
+%^^A% In the case of table or figure have some additional explanations
+%^^A% which could not put in caption contents and they are definitely not
+%^^A% a footnote you may use |\floatfoot|\label{FAD:Legend}
+%^^A% command. The |\floatfoot| is
+%^^A% build by usage of |\caption| stuff and uses caption's justification,
+%^^A% but star form (|\floatfoot*|) prints its contents as plain unindented
+%^^A% paragraph (see table~\ref{tab:floatfoot}).
+% Если таблица или рисунок имеют дополнительные объяснения
+% которые не должны быть в~подписи и~они не являются сноской
+% вы можете использовать команду |\floatfoot|\label{FAD:Legend}. Команда |\floatfoot|
+% использует механизм оформления команд |\caption| и~использует
+% выключку, заданную для текста подписей;
+% «звёздная» форма (|\floatfoot*|) печатает содержимое в~виде обычного
+% абзаца без отступа (см. табл.~\ref{tab:floatfoot}).
+%
+%^^A% For defining of explication font use \hyperref[setup:footfont]{\texttt{footfont=}} option
+%^^A% (page~\pageref{setup:footfont}) in |\floatsetup|. You may try to
+%^^A% define special settings for float foot using
+%^^A% \cmd{\captionsetup[floatfoot]} setup.
+% Для определения шрифта для экспликаций используйте соответствующую опцию
+% \hyperref[setup:footfont]{\texttt{footfont=}} (с.~\pageref{setup:footfont}) в~команде
+% |\floatsetup|. Вы можете задать
+% дополнительные настройки оформления задав командную
+% последовательность \cmd{\captionsetup[floatfoot]}.
+%\begin{Quote}\openup.5pt
+%|\begin{table}|
+%|\ttabbox|
+%| {\caption{...}\label{...}}|
+% \verb+ {\begin{tabular}{...}+
+%| ...|
+%| \end{tabular}%|
+%| \floatfoot*{`Data I' column ...}}|
+%|\end{table}|
+%\end{Quote}
+% \DeleteShortVerb{\|}%
+% \begin{table}[H]
+% \ttabbox
+% {\caption{Таблица с экспликацией}%^^A
+% \label{tab:floatfoot}}%^^A
+% {\extrarowheight1pt\tabcolsep2\tabcolsep
+% \begin{tabular}{|l|c|c|}
+% \hline
+% \thead{Column head} & \thead{Data I} & \thead{Data II} \\
+% \hline
+% First row & \phantom01 & 2 \\
+% Second row & \phantom06 & 4 \\
+% Third row & 28 & 8 \\
+% \hline
+% \end{tabular}%^^A
+% \floatfoot*{`Data I' column---numbers which equal to sum of all
+% their divisors; `Data II' column---$2^n$ values}}
+% \end{table}%
+% \MakeShortVerb{\|}%
+%
+%^^A% \emph{Notes.} 1)\enskip The \package{float} package defines additional
+%^^A% optional argument after main caption text, possibly for explications.
+%^^A% Since this possibility
+%^^A% didn't declared in user part of documentation the current version of
+%^^A% \package{caption} (3.0 and later), and also \package{float\-row} package,
+%^^A% doesn't support this possibility. You may use |\floatfoot| and
+%^^A% |\footnote|/\allowbreak|\footnotemark|/\allowbreak|\footnotetext| stuffs instead.
+% \emph{Замечания.} 1)\enskip Пакет \package{float} определяет
+% дополнительный аргумент после текста подписи. Поскольку эта
+% возможность не была документирована в~части документации для
+% пользователей текущая версия пакета \package{caption} (3.0 и~выше),
+% а~также пакет \package{floatrow}, не поддерживают эту возможность.
+% Используйте команду |\floatfoot| и~команды
+% |\footnote|/\allowbreak|\footnotemark|/\allowbreak|\footnotetext|.
+%
+%^^A% 2)\enskip If you use both |\floatfoot| command and |\footnote|
+%^^A% inside one float box, the |\floatfoot| appears above |\footnote|
+%^^A% contents.
+% 2)\enskip Если вы используете одновременно команды |\floatfoot|
+% и~|\footnote| внутри одного флота, содержимое команды |\floatfoot|
+% появится над |\footnote|.
+%
+%^^A% 3)\enskip Foot material (footnotes and text in floatfoot) can be placed
+%^^A% in several variants: at the very bottom of float box, below caption
+%^^A% (even if caption is above float object). See page \pageref{setup:footposition}
+%^^A% and sample file \file{frsample01.tex}. In case of caption beside
+%^^A% float object, footnotes and foot text always placed below caption.
+% 3)\enskip Сноски и~экспликации могут быть размещены несколькими
+% способами: в~самом низу флота, под подписью
+% (даже в~случае подписи сверху). См. с.~\pageref{setup:footposition}
+% и~файл примера \file{frsample01.tex}. В~случае подписи сбоку,
+% сноски и~экспликации всегда помещаются под подписью.
+%
+% \RestoreSpaces
+%^^A% \subsection{Fine Tuning of Vertical Spaces of Float}
+%^^A% \label{sec:FBabskips}
+% \subsection{Корректировка вертикальных отбивок
+% в~флоте}\label{sec:FBabskips}
+%
+%^^A% At the final variant of document you may need to correct vertical
+%^^A% spaces between float and main text, between float object and
+%^^A% caption.
+% В~заключительном варианте документа вам возможно понадобится
+% откорректировать вертикальные отбивки между флотом и~основным
+% текстом, между содержимым объекта и~подписью.
+%
+%^^A% To change space between float box and main text there you may use
+%^^A% two simple commands |\FBaskip| and |\FBbskip|. For example define
+% Изменить отбивки между флотом и~основным текстом можно,
+% используя две простые команды |\FBaskip| и~|\FBbskip|.
+% Например, определите
+% \begin{verse}
+% |\renewcommand\FBaskip{-4pt}|
+% \end{verse}
+%^^A% to move up float box up (or reduce space above) by 4pt. In current
+%^^A% document the |\FBaskip| command was necessary for moving up
+%^^A% some of wrapped figures.
+% чтобы передвинуть флот вверх (уменьшить отбивку сверху)
+% на 4pt. В~данном документе
+% команда |\FBaskip| понадобилась для корректировки
+% рисунков в~оборку.
+%
+%^^A% Use |\vspace| command for vertical space correction around float
+%^^A% object\footnote{The plain float environment allows usage of
+%^^A% \cmd{\vskip} command. But \cmd{\floatbox} stuff
+%^^A% (\cmd{\floatbox} itself, \cmd{\ffigbox} etc.) in case
+%^^A% of usage of the \cmd{\FBwidth} option, gets error message
+%^^A% when \cmd{\vskip} appears.}.
+% Для корректировки отбивок вокруг объекта
+% используйте |\vspace|\footnote{В~простом окружении флота можно
+% пользоваться и~командой \cmd{\vskip}. Но команды \cmd{\floatbox}
+% (сама \cmd{\floatbox}, \cmd{\ffigbox}\dots) в~случае использования
+% в~аргументе \meta{width} опции \cmd{\FBwidth}, выдадут сообщение
+% об ошибке если встретят команду \cmd{\vskip}.}.\par
+%
+% \RestoreSpaces
+%^^A% \subsection{Do not write that with \package{floatrow} package}
+% \subsection{Это не допускается пакетом \package{floatrow}}
+%
+%^^A% The \package{floatrow} package creates some features or limitations
+%^^A% of float layout building. If you'll write something like
+% Пакет \package{floatrow} создаёт некоторые особенности и~ограничения
+% в~построении плавающих объектов. Если вы запишете:
+%\begin{Quote}
+%\meta{preamble}
+%|\usepackage{floatrow}|
+%\meta{preamble}
+%|\begin{figure}|
+%| \caption{Табличный заголовок должен быть вверху, но это не так}|
+%| \centering \begin{tabular}{cc} A & B \\ C & D \end{tabular}|
+%|\end{figure}|
+%\end{Quote}
+%^^A% please do not expect that caption appears at the top of figure.
+% не ждите что подрисуночная подпись получится сверху рисунка.
+%
+% \begingroup\clearfloatsetup{table}
+% \begin{table}[H]
+% \caption{Табличный заголовок должен быть вверху, но это не так}\label{Wrong:expect}
+% \centering \begin{tabular}{cc} A & B \\ C & D \end{tabular}
+% \end{table}
+% \endgroup
+%
+%^^A% If you want, e.g. to put figure captions above its contents, you must
+%^^A% write in preamble |\floatsetup[figure]{style=plaintop}|
+%^^A% (see also
+%^^A% {\sectionname}~\ref{sec:floatsetup} about |\floatsetup| mechanism).
+% Если вы хотите, например, поместить подрисуночные подписи сверху, вы должны
+% задать в~преамбуле |\floatsetup[figure]{style=plaintop}|%^^A
+% (см.~также {\sectionname}~\ref{sec:floatsetup} о~механизме команды |\floatsetup|).
+%^^A% Another example. If you put beside floats by following way:
+% Другой пример. Если вы поместите плавающие объекты как в~примере:
+%\begin{Quote}
+%\meta{preamble}
+%|\usepackage{floatrow}|
+%\meta{preamble}
+%|\begin{figure}|\nopagebreak\parskip0pt
+%|\begin{minipage}{0.5\textwidth}|
+%| \centering ...|
+%| \caption{Пропавшая подрисуночная подпись, неверно заданный ряд}|
+%|\end{minipage}|
+%|\begin{minipage}{0.5\textwidth}|
+%| \captionof{table}{Табличный заголовок, неверно заданный ряд}}|
+%| \centering |
+%| \begin{tabular}{cc}|
+%| A & B \\ C & D |
+%| \end{tabular}|
+%|\end{minipage}|\nopagebreak
+%|\end{figure}|
+%\end{Quote}
+%^^A% you also won't get expected result. Use \env{floatrow}, like in
+%^^A% example with figures~\ref{intro:leftfig} and~\ref{intro:rightfig}.
+%^^A% Also you would need, e.g., |\CenterFloatBoxes| command just before
+%^^A% \env{floatrow} environment to get correct
+%^^A% vertical alignment (see page~\pageref{mixrow}
+%^^A% about mixed float rows).
+% вы также не получите ожидаемого результата.
+%\begin{figure}[H]
%\begin{minipage}{0.5\textwidth}
-%\centering \input{Mouse.picture}
-%\caption{A figure caption}
+%\centering \input{Horse.picture}
+%\caption{Пропавшая подрисуночная подпись, неверно заданный ряд}
%\end{minipage}
%\begin{minipage}{0.5\textwidth}
-%\captionof{table}{A table caption}
+%\captionof{table}{Табличный заголовок, неверно заданный ряд}
%\centering \begin{tabular}{cc} A & B \\ C & D \end{tabular}
%\end{minipage}
%\end{figure}
-%\end{verbatim}
-% вы также не получите ожидаемого результата. Чтобы получить верный результат,
-% используйте окружение \env{floatrow}, как в примере
-% с рис.~\ref{intro:leftfig} и~\ref{intro:rightfig}\footnote{См. также
-% с.~\pageref{mixrow} о размещении рядом флотов разных типов }.
+%^^A% Read back the {\sectionname}s~\ref{sec:mixrow} и~\ref{sec:rawfloats} and correct the error.
+% Вернитесь к~{\sectionname}~\ref{sec:mixrow} и~\ref{sec:rawfloats} чтобы исправить ошибку.
%
+% \clearpage
+%^^A% \section{Float Layout Settings}\label{sec:floatsetup}
% \section{Настройка оформления плавающих объектов}\label{sec:floatsetup}
%
-% Идея пакета \pkg{floatrow} заключается в том, чтобы избежать множества
-% повторяющихся команд внутри документа для создания желаемого оформления
-% плавающих объектов (которые к тому же снижают читаемость документа),
-% и упростить изменения, если вам нужно изменить оформление книги.
-% В этом случае вы уделяете внимание только \emph{разметке}
-% флотов и их содержанию.
-%
+%^^A% The idea of \package{floatrow} package is to avoid a lot of repeated code
+%^^A% inside document for creation of desired layout for floats (which also
+%^^A% lowers readability of document), and make layout modification easier
+%^^A% if you ought to change book layout. In this case you could think only
+%^^A% about \emph{markup} of floats and their contents.
+% Идея пакета \package{floatrow} состоит в~том, чтобы избежать множества
+% повторяющихся команд в~документе для оформления флотов
+% и~упростить возможные изменения, если понадобится изменить оформление книги.
+% В~результате вы уделяете внимание только \emph{разметке}
+% флотов и~их содержанию.
+%
+%^^A% The easy modification of common layout of all float of for one type of
+%^^A% float is possible because of the borrowed code from the \package{float}
+%^^A% package, which allows to modify layout of float boxes as a whole.
% Простота изменения общего оформления флотов одного типа возможна
-% благодаря коду, взятому из пакета \pkg{float}, который позволяет
+% благодаря коду, взятому из пакета \package{float}, который позволяет
% изменять целиком оформление плавающего объекта.
%
-% Единое оформление и изменение подписей флотов и настройки для каждого
-% типа флотов, поддерживается пакетом
-% \pkg{caption}, версии~3.x.
-%
-% Настройки оформления пакета \pkg{floatrow} построены аналогично пакету
-% \pkg{caption} и используют механизм |\floatsetup|\footnote{Некоторые имена
-% ключей и опций изменены после версии 0.1d, для упорядочения и создания более
+%^^A% The common layout and its modification for captions and special
+%^^A% settings for
+%^^A% each type of float supported by \package{caption} package, version~3.x.
+% Единое оформление и~изменение подписей флотов и~настройки для каждого
+% типа флотов, поддерживается пакетом \package{caption}, версии~3.x.
+%
+%^^A% The layout settings of \package{floatrow} package are built similarly
+%^^A% to \package{caption} ones and use |\floatsetup|\footnote{Some key and
+%^^A% option names were changed from version 0.1d, the reason was
+%^^A% to arrange and make names more memorable, and, sometimes, reduction
+%^^A% of their names (see {\sectionname}~\ref{sec:changed}).} mechanism which is
+%^^A% analog to |\captionsetup| one\footnote{Look also at \package{caption}
+%^^A% documentation (version 3.0 and later)}.
+% Настройки оформления пакета \package{floatrow} построены аналогично
+% \package{caption} и~используют механизм |\floatsetup|\footnote{Некоторые имена
+% ключей и~опций изменены после версии 0.1d, для упорядочения и~создания более
% запоминаемых названий, и, иногда, сокращения их имён
-% (см. разд.~\ref{sec:changed}).}, который аналогичен механизму
-% |\captionsetup|\footnote{См. также документацию пакета \pkg{caption}
-% (версии 3.0 и выше)}.
+% (см.~{\sectionname}~\ref{sec:changed}).}, аналогичный механизму
+% |\captionsetup|\footnote{См.~также документацию пакета \package{caption}
+% (версии~3.0 и~выше)}.
%
% \DescribeMacro{\floatsetup}
+%^^A% You may use layout settings stuff as \package{floatrow} option in
+%^^A% |\usepackage| line.
% Вы можете использовать настройки оформления флотов как опции пакета
-% \pkg{floatrow} в строке |\usepackage|.
-% \begin{quote}
-% |\usepackage[|\meta{options}|]{floatrow}|
-% \end{quote}
+% \package{floatrow} в~строке |\usepackage|.
+% \begin{Quote}
+% |\usepackage[|\meta{options}|]{floatrow}|\quad.
+% \end{Quote}
+%^^A% You may write
% Вы можете записать
-% \begin{quote}
-% |\usepackage[style=boxed,font=small]{floatrow}|
-% \end{quote}
+% \begin{Quote}
+% |\usepackage[style=boxed,font=small]{floatrow}|\quad.
+% \end{Quote}
+%^^A% The same result you get with
% Тот же результат вы получите при
-% \begin{quote}
-% |\floatsetup{style=boxed,font=small}|
-% \end{quote}
+% \begin{Quote}
+% |\floatsetup{style=boxed,font=small}|\quad.
+% \end{Quote}
+%^^A% The lines above declare \texttt{boxed} style and |\small| font for
+%^^A% float contents. These settings were loaded for \emph{all} float types.
% Строки выше определяют стиль \texttt{boxed} (рамка |\fbox| вокруг объекта)
-% и шрифт |\small| для содержимого
+% и~шрифт |\small| для содержимого
% объектов. Эти установки заданы для \emph{всех} типов плавающих объектов.
%
+%^^A% The |\floatsetup| command has following form:
% Команда |\floatsetup| имеет следующую форму задания:
-% \begin{quote}
-% |\floatsetup|\oarg{float type}\marg{options}
-% \end{quote}
-%
-% Для задания специальных настроек для плавающих объектов одного типа используется
-% дополнительный аргумент в котором указывается тип флота. Следующая команда
-% \begin{quote}
+% \begin{Quote}
+% |\floatsetup|\oarg{float type}\marg{options}\quad.
+% \end{Quote}
+%
+%^^A% For defining of a special style for float of one type use optional
+%^^A% argument with name of necessary float type. The following command
+% Для задания специальных настроек для флотов одного типа используется
+% опция, в~которой указывается его тип. Следующая команда
+% \begin{Quote}
% |\floatsetup[table]{style=Plaintop}|
-% \end{quote}
-% задаёт специальный стиль для таблиц (табличный заголовки помещаются над
-% объектами; если таблицы стоят рядом внутри окружения \env{floatrow},
-% табличные заголовки выравниваются по верхней строке)\footnote{Ключи,
-% используемые в специальной настройке для плавающих объектов одного
-% типа, всегда <<сильнее>> их синонимов, заданных в общей настройке. Другими
-% словами, если вы захотите, после приведённого примера переопределить стиль
-% для всех флотов,
-% с помощью \cmd{\floatsetup\{style={\normalfont \meta{option}}\}}
-% вы не измените оформления таблицы "--- используйте опять
-% \cmd{\floatsetup[table]}\allowbreak\texttt{\{style={\normalfont
-% \meta{option}}\}}.}.
-%
+% \end{Quote}
+%^^A% sets a special float style for tables: captions are placed above
+%^^A% float objects; in the case of beside floats inside \env{floatrow}
+%^^A% environment captions aligned by top line.%^^A
+%^^A% %^^A \footnote{The keys,
+%^^A% %^^A used in special settings for float of one type, are always
+%^^A% %^^A ``stronger'' than synonym keys in common setting. In other words,
+%^^A% %^^A if you want after example above to redefine float style for all
+%^^A% %^^A floats with \cmd{\floatsetup\{style={\normalfont \meta{option}}\}}
+%^^A% %^^A you won't change tables---use
+%^^A% %^^A \cmd{\floatsetup[table]}\allowbreak
+%^^A% %^^A \texttt{\{style={\normalfont \meta{option}}\}} again.}.
+% задаёт специальный стиль для таблиц: табличные заголовки помещаются
+% сверху; если таблицы стоят рядом внутри окружения \env{floatrow},
+% табличные заголовки выравниваются по верхней строке.%^^A
+% %^^A \footnote{Ключи,
+% %^^A используемые в~специальной настройке для плавающих объектов одного
+% %^^A типа, всегда <<сильнее>> их синонимов, заданных в~общей настройке. Другими
+% %^^A словами, если вы захотите, после приведённого примера переопределить стиль
+% %^^A для всех флотов,
+% %^^A с~помощью \cmd{\floatsetup\{style={\normalfont \meta{option}}\}}
+% %^^A вы не измените оформления таблицы "--- используйте опять
+% %^^A \cmd{\floatsetup[table]}\allowbreak\texttt{\{style={\normalfont
+% %^^A \meta{option}}\}}.}
+%
+%^^A% There are also special options of |\floatsetup| for settings for floats
+%^^A% in different positioning: two-column floats (starred environment, like
+%^^A% \env{figure*}, you may also use, for example, for wide floats) rotated
+%^^A% floats etc. The ``strength'' of options in the lists below decreases
+%^^A% from previous item to next one (examples based on \env{figure}
+%^^A% environment)\footnote{In the case of the boolean key \texttt{rawfloats=} is switched to \texttt{true},
+%^^A% the options below for float layout are canceled.}:
% Созданы также специальные опции команды |\floatsetup| для настройки флотов
-% с разными вариантами размещения:
-% для набора в две колонки (в одноколонной книге |*|-окружение, типа
+% с~разными вариантами размещения:
+% для набора в~две колонки (в~одноколонной книге «звёздное» окружение, типа
% \env{figure*}, можно использовать
% для вёрстки, например, широких рисунков) для флотов, развёрнутых
-% вертикально и других.
-% <<Сила>> приведённых ниже в перечнях опций убывает от предыдущего
-% к следующему пункту
-% (в качестве примера использовано окружение \env{figure}):
+% вертикально и~др.
+% <<Сила>> приведённых ниже в~перечнях опций убывает от предыдущего
+% к~следующему пункту
+% (как пример используется окружение \env{figure})\footnote{В~случае
+% если ключ \texttt{rawfloats=} задан как \texttt{true},
+% опции будут отменены.}:
% \begin{itemize}\label{stsetorder}\itemsep0pt\parskip0pt
-% \item Широкие флоты или флоты вразрез двух колонок
+% \item
+%^^A% Wide or two-column floats (e.g. \env{figure*},
+%^^A% you may load special
+%^^A% settings for starred environments even in one-column document):
+% Широкие флоты или флоты вразрез двух колонок
% (например, \env{figure*}, вы можете определить специальные настройки для
-% |*|-окружений и в одноколонном документе):
+% «звёздных» окружений и~в~одноколонном документе):
% \begin{itemize}
-% \item |\floatsetup[widefigure]|---самые <<сильные>> настройки;
+% \item
+%^^A% |\floatsetup[widefigure]|---the ``strongest'' settings;
+%^^A% if they absent, package uses settings from next item;
+% |\floatsetup[widefigure]|\label{setup:widefigure} "---самые <<сильные>> настройки;
% если они отсутствуют,
% пакет использует настройки из следующего пункта;
-% \item |\floatsetup[widefloat]|---эти настройки <<сильнее>> чем настройки
+% \item
+%^^A% |\floatsetup[widefloat]|\label{setup:widefloat}---these settings ``stronger''
+%^^A% than settings from next item (|\floatsetup[figure]|);
+%^^A% if they absent, package uses settings from next item;
+% |\floatsetup[widefloat]| "---эти настройки <<сильнее>> чем настройки
% из следующего пункта (|\floatsetup[figure]|); если они отсутствуют, пакет
% использует настройки из следующего пункта;
-% \item |\floatsetup[figure]|; если эти настройки отсутствуют, пакет
+% \item
+%^^A% |\floatsetup[figure]|;
+%^^A% if they absent, package uses settings from
+%^^A% optional argument in |\usepackage| line or |\floatsetup{...}|
+%^^A% command; if they absent---default package settings
+%^^A% (see page~\pageref{sec:default});
+% |\floatsetup[figure]|; если эти настройки отсутствуют, пакет
% использует настройки,
-% заданные в опции в строке |\usepackage| или как |\floatsetup{...}|;
-% если и эти установки отсутствуют "--- установки пакета
+% заданные в~опции в~строке |\usepackage| или как |\floatsetup{...}|;
+% если и~эти установки отсутствуют "--- установки пакета
% по умолчанию (см.~с.~\pageref{sec:default});
% \end{itemize}
-% \item Плавающие объекты в оборку (использующие окружение типа
-% \env{wrapfigure}):
+% \item
+%^^A% Wrapped floats (\env{wrapfigure}, used width \package{wrapfig} package):
+% Флоты в~оборку (окружение
+% \env{wrapfigure} пакета \package{wrapfig}):
% \begin{itemize}\itemsep0pt\parskip.5\parskip
-% \item |\floatsetup[wrapfigure]|;
-% \item |\floatsetup[wrapfloat]|;
+% \item |\floatsetup[wrapfigure]|\label{setup:wrapfigure};
+% \item |\floatsetup[wrapfloat]|\label{setup:wrapfloat};
% \item |\floatsetup[figure]|;
% \end{itemize}
-% \item Плавающие объекты развёрнутые вертикально (\env{sidewaysfigure}):
+% \item
+%^^A% Rotated floats (in environments, like \env{sidewaysfigure},
+%^^A% used width \package{rotating} package):
+% Флоты развёрнутые вертикально (\env{sidewaysfigure}
+% пакета \package{rotating}):
% \begin{itemize}\itemsep0pt\parskip.5\parskip
-% \item |\floatsetup[rotfigure]|;
-% \item |\floatsetup[rotfloat]|;
+% \item |\floatsetup[rotfigure]|\label{setup:rotfigure};
+% \item |\floatsetup[rotfloat]|\label{setup:rotfloat};
% \item |\floatsetup[figure]|;
% \end{itemize}
-% \item Развёрнутые плавающие объекты вразрез двух колонок
+% \item
+%^^A% Wide rotated floats
+%^^A% (\env{sidewaysfigure*})\footnote{The settings
+%^^A% for wide float (\texttt{widefloat}, \texttt{widefigure})
+%^^A% removed---use settings for \texttt{widerotfloat}
+%^^A% and---here---\texttt{widerotfigure}}:
+% Развёрнутые флоты вразрез двух колонок
% (\env{sidewaysfigure*})\footnote{Настройки
-% для флотов на две колонки (или широких в одноколонной вёрстке)
+% для флотов на две колонки (или широких в~одноколонной вёрстке)
% (\texttt{widefloat}, \texttt{widefigure}) удалены "--- используйте
% настройки для \texttt{widerotfloat} и "--- здесь
% "---\texttt{widerotfigure}}:
% \begin{itemize}\itemsep0pt\parskip.5\parskip
-% \item |\floatsetup[widerotfigure]|;
-% \item |\floatsetup[widerotfloat]|;
+% \item |\floatsetup[widerotfigure]|\label{setup:widerotfigure};
+% \item |\floatsetup[widerotfloat]|\label{setup:widerotfloat};
% \item |\floatsetup[rotfigure]|;
% \item |\floatsetup[rotfloat]|;
% \item |\floatsetup[figure]|;
% \end{itemize}
-% \item Плавающие объекты с подписями рядом:
+% \item
+%^^A% Floats with beside captions (settings in these options are limited, see below):
+% Флоты с~подписями сбоку (здесь есть ограничения, см.~ниже):
% \begin{itemize}\itemsep0pt
-% \item |\floatsetup[capbesidefigure]|;
-% \item |\floatsetup[capbesidefloat]|;
-% \item настройки окружений перечисленных выше, где помещён флот:
+% \item |\floatsetup[capbesidefigure]|\label{setup:capbesidefigure};
+% \item |\floatsetup[capbesidefloat]|\label{setup:capbesidefloat};
+% \item
+%^^A% setting of outer environments from previous items:
+%^^A% \env{sidewaysfigure*}, \env{sidewaysfigure}, and \env{figure*}.
+% настройки окружений перечисленных выше, где помещён флот:
% \env{sidewaysfigure*}, \env{sidewaysfigure}, и \env{figure*}.
% \end{itemize}
-% Обратите внимание, что ключ \texttt{style=} (см. начало следующего раздела)
-% отменяет настройку для размещения подписи сбоку.
% \end{itemize}
+%^^A% You can also create and change special settings for captions, using
+%^^A% the same \meta{float~type} options in |\captionsetup| stuff.
% Вы можете создать специальные настройки для подрисуночных подписей, используя
-% те же названия опций \meta{float~type} в команде |\captionsetup|.
+% те же названия опций \meta{float~type} в~команде |\captionsetup|.
%
-% Следующие несколько разделов описывают ключи, используемые командой |\floatsetup|.
+%^^A% The next few sections describe keys of |\floatsetup| macro.
+% Разделы ниже описывают ключи, используемые командой |\floatsetup|.
%
-% \subsection{Ключи Floatsetup}\label{sec:floatsetup}
+% \clearpage
+%^^A% \subsection{Floatsetup Keys}\label{sec:floatkeys}
+% \subsection{Ключи Floatsetup}\label{sec:floatkeys}
%
+%^^A% \subsubsection{Float Style}
% \subsubsection{Стиль плавающего объекта}
%
-% \DescribeMacro{style=}
-% Ключ \emph{float style} задаётся следующим образом:
-% \begin{quote}
-% |style=|\meta{float style name}\quad ,
-% \end{quote}
+% \DescribeMacro{style}\label{setup:style}%^^A
+%^^A% The \emph{float style} could include alignment of float contents, margins, boxes or lines,
+%^^A% if necessary, and other options.
+%^^A% The \emph{float style} is specified by following way:
+% Ключ \emph{float style} включает выравнивание содержимого объекта, поля (или материал на полях),
+% рамки или линейки и~некоторые опции, если необходимо. Опция \emph{float style} задаётся следующим образом:
+% \par\RestoreSpaces
+% \begin{Options}{style=float style name }
+% \item[style=\rmfamily\mdseries\meta{float style name}\ ,\quad]
+%^^A% the \meta{float style name} you may take from
+%^^A% table~\ref{tab:floatlayouts}.
% где \meta{float style name} вы можете взять из табл.~\ref{tab:floatlayouts}.
+% \item[...]
+%^^A% You may create your own options with |\DeclareFloatStyle| command,
+%^^A% see page~\pageref{ssec:declstyle}.
+% Вы можете создать свои опции с~помощью команды \\|\DeclareFloatStyle|,
+% см.~с.~\pageref{ssec:declstyle}.
+% \end{Options}
%
-%
-% Стиль для подписи, \texttt{ruled}, единственный из пакета \pkg{float},
-% который также предопределён в пакете \pkg{caption}. Для его использования,
+%^^A% As you may see in the table~\ref{tab:floatlayouts}, there are included all float styles
+%^^A% which emulate co-named ones from the \package{float} package.
+% Как вы видите, в~табл.~\ref{tab:floatlayouts} включены все стили, эмулирующие
+% соответствующие стили из пакета~\package{float}.
+%
+%^^A% Please note, that usage of \texttt{style=} key for floats with beside captions,
+%^^A% i.e.~using |\floatsetup| settings with options like, e.g.,
+%^^A% |[capbesidefigure]| or |[capbesidefloat]|
+%^^A% cancels settings for beside position of caption. Usually the floats with beside captions
+%^^A% can set different alignment of captions, so the radical changes for float layout
+%^^A% with beside caption in current version could get wrong results (see also
+%^^A% {\sectionname}~\ref{page:killfloatstyle} how to get different settings for floats with beside captions).\medskip
+% Обратите внимание, что использование ключа \texttt{style=} для флотов с~подписями сбоку, т.\,е.
+% использование настроек |\floatsetup| с~опциями типа
+% |[capbesidefigure]| или |[capbesidefloat]|
+% отменяет установки для подписей сбоку. Обычно для флотов с~подписями сбоку задаётся только другое выравнивание
+% текста подписи или оформление её метки (например задание её отдельной строкой), поэтому радикальные изменения для
+% подписи сбоку могут дать неверные результаты (см.~%^^A
+% {\sectionname}~\ref{page:killfloatstyle} для решения этой проблемы).\medskip
+%
+%^^A% The \package{caption} package uses its own settings and names for caption layout styles.
+%^^A% The caption's \texttt{ruled} style is the only one from \package{float}
+%^^A% package, which was predefined in \package{caption} package. To use it,
+%^^A% write
+% Пакет \package{caption} использует собственные настройки и~названия для стилей подписей.
+% Стиль для подписи, \texttt{ruled}, единственный из пакета \package{float},
+% который также предопределён в~пакете \package{caption}. Для его использования,
% запишите, например
% \begin{quote}
% |\captionsetup[figure]{style=ruled}|\quad .
% \end{quote}
%
-% \begin{sidewaystable}%[p]%
-% \extrarowheight1pt\tabcolsep.5\tabcolsep
-% \newcommand\leftcell[2][16.5mm]{\extrarowheight0pt\def\arraystretch{.75}
-% \hspace*{-\tabcolsep}\begin{tabular}[t]{>{\footnotesize
-% \ttfamily\noindent\vphantom{\small()\mpfootnotemark[1]}}p{#1}}#2\end{tabular}%
-% \hspace*{-\tabcolsep}\ignorespaces}
-% \emptyfloatpage
-% \begin{tabularx}\hsize{|@{}l@{}|@{}l@{}|X|}
+% \begingroup
+% \extrarowheight1pt\jot3pt\tabcolsep1.25\tabcolsep%
+% \newlengthtocommand\settowidth\Icolumn{\small\texttt{wshadowboxx}}
+% \newlengthtocommand\settowidth\IIcolumn{\small\texttt{framestyle=wshadowbox}}
+% \newlengthtocommand\setlength\IIIcolumn{\textwidth-\Icolumn-\IIcolumn
+% -6\tabcolsep}
+% \newcommand\leftcell[2][16.5mm]{%^^A%
+% \hspace*{-\tabcolsep}\begin{tabular}[t]{>{%
+% \noindent
+% \vphantom{\small()\mpfootnotemark[1]}}
+% p{\hsize}}
+% #2\unskip\botstrut\end{tabular}\hspace*{-\tabcolsep}%
+% }
+% \begin{longtable}{|>{\extrarowheight0pt\def\arraystretch{.75}\ttfamily}p{\Icolumn}
+% |>{\extrarowheight0pt\def\arraystretch{.75}\ttfamily}p{\IIcolumn}
+% |>{\parindent1em\topstrut}p{\IIIcolumn}<{\botstrut}|}
+%^^A% \caption{Float layout styles}\label{tab:floatlayouts}\\
+% \caption{Стили плавающих объектов}\label{tab:floatlayouts}\\
+% \hline
+% \hfil\thead{Style} &
+% \hfil\thead{\cmd{\floatsetup} keys} &
+% \hfil\thead{Description} \\
+% \hline
+% \endfirsthead
+%^^A% \caption{Float layout styles \textmd{(\emph{Continued})}}\label{tab:floatlayouts}\\
+% \caption[]{Стили плавающих объектов \textmd{(\emph{Продолжение})}}\\
+% \hline
+% \hfil\thead{Style} &
+% \hfil\thead{\cmd{\floatsetup} keys} &
+% \hfil\thead{Description} \\
+% \hline
+% \endhead
+%^^A% \caption{Float layout styles \textmd{(\emph{Finished})}}\label{tab:floatlayouts}\\
+% \caption[]{Стили плавающих объектов \textmd{(\emph{Окончание})}}\\
% \hline
-% \hfil\thead{Стиль} &
-% \hfil\thead{Ключи \cmd{\floatsetup}} &
-% \hfil\thead{Описание} \\
+% \hfil\thead{Style} &
+% \hfil\thead{\cmd{\floatsetup} keys} &
+% \hfil\thead{Description} \\
% \hline
-% \multicolumn{3}{|c|}{Определено в пакете \pkg{floatrow}}\\
-% \hline \leftcell{\texttt{plain}{\mpfootnotemark[1]}}
+% \endlasthead
+%^^A% \multicolumn{3}{r@{}}{\emph{Continued on next page}}
+% \multicolumn{3}{r@{}}{\emph{продолжение на следующей странице}}
+% \endfoot
+%^^A% \multicolumn{3}{r@{}}{\emph{Finished on next page}}
+% \multicolumn{3}{r@{}}{\emph{окончание на следующей странице}}
+% \endprelastfoot
+% \endlastfoot
+% \multicolumn{3}{|c|}{Определено в пакете \package{floatrow}}\\
+% \hline \leftcell{\texttt{plain}\label{setup:plain}{\mpfootnotemark[1]\mpfootnotemark[2]\mpfootnotemark[3]}}
% & \leftcell{\meta{none}}
-% &Стандартное оформление \LaTeX'а
+% &Стиль \texttt{plain} создаёт стандартное оформление \LaTeX'а. Подрисуночные подписи всегда снизу
+% \\\hline
% \\\hline
% \leftcell{\texttt{plaintop}{\mpfootnotemark[1]}
-% \\\hline\texttt{Plaintop}{\mpfootnotemark[2]}}
-% & \leftcell[50mm]{capposition=top\\\hline
+% \botstrut\\ \hline\topstrut\texttt{Plaintop}}
+% & \leftcell[50mm]{capposition=top\botstrut\\ \hline\topstrut
% capposition=TOP}
-% &То же что и стиль \texttt{plain} но помещает подпись сверху "---
+% &Стиль \texttt{plaintop} \cdash---то же что и~стиль \texttt{plain} но помещает подпись сверху "---
% аналог стиля из пакета
-% \pkg{float}. Стиль, записанный с прописной выравнивает подписи
-% у флотов, помещённых в окружение \env{floatrow}, по верхней строке
+% \package{float}.\par Стиль с~прописной, \texttt{Plaintop}, помещает
+% флоты рядом (в~окр.~\env{floatrow}) и~выравнивает подписи по верхней строке
+% (см.~пример на~с.~\pageref{tab:row:tabIII})
% \\\hline
-% \leftcell{\texttt{ruled}{\mpfootnotemark[1]}
-% \\ \\ \\\hline\texttt{Ruled}}
-% & \leftcell[50mm]{capposition=top,precode=thickrule,\\
-% midcode=rule,postcode=lowrule,\\
-% heightadjust=all\\\hline
-% style=ruled,capposition=TOP}
-% &Первый повторяет оформление одноимённого стиля из пакета \pkg{float}.
-% Стиль, записанный с прописной выравнивает подписи в окружении
-% \env{floatrow} по верхней строке
+% \leftcell{\texttt{ruled}\label{setup:ruled}{\mpfootnotemark[1]\mpfootnotemark[3]}
+% \\ \\ \\ \\ \botstrut\\ \hline\topstrut\texttt{Ruled}\smash{\mpfootnotemark[2]}}
+% & \leftcell[50mm]{capposition=top,\\ precode=thickrule,\\
+% midcode=rule,\\ postcode=lowrule,\\
+% heightadjust=all\botstrut\\ \hline\topstrut
+% style=ruled,\\ capposition=TOP}
+% &Первый стиль, \texttt{ruled}, повторяет оформление одноимённого стиля из пакета \package{float}.
+% Он создаёт толстую линию
+% над флотом, и~тонкие линии между подписью и~объектом и~снизу бокса флота.\par
+% Стиль с~прописной, |Ruled|, выравнивает подписи флотов, в~случае размещения их
+% рядом (в~окружении \env{floatrow}),
+% по верхней строке (см.~пример на~с.~\pageref{example:ruledcapposTOP})
% \\\hline
-% \leftcell{\texttt{boxed}\smash{\mpfootnotemark[1]\mpfootnotemark[2]}
-% \\ \\ \\\hline\texttt{Boxed}
-% \\\hline\texttt{BOXED}}
-% & \leftcell[50mm]{captionskip=2pt,framestyle=fbox,\\
-% heightadjust=object,\\framearound=object\\\hline
-% style=boxed,framefit=yes\\\hline
-% framestyle=fbox,framefit=yes,\\
-% heightadjust=all,framearound=all}
-% &Первый повторяет стиль пакета \pkg{float}:
-% ширина объекта равна \cmd{\hsize} или
-% предопределённой ширине бокса; рамка выступает по сторонам.
-% В форме с прописной буквы ширина рамки совпадает с
-% \cmd{\hsize} или заданной шириной; ширина объекта при этом уменьшается,
-% чтобы поместиться внутри рамки. Прописная форма создаёт рамку
-% которая равна \cmd{\hsize} или заданной ширине,
-% уже вокруг всего флота: подписи, объекта и возможных экспликаций.
+% \leftcell{\texttt{boxed}\smash{\mpfootnotemark[1]\mpfootnotemark[2]\mpfootnotemark[3]\mpfootnotemark[4]}
+% \\ \\ \\ \botstrut\\ \hline\topstrut\texttt{Boxed}\label{setup:Boxed}\smash{\mpfootnotemark[2]\mpfootnotemark[3]}
+% \\ \botstrut\\ \hline\topstrut\texttt{BOXED}\smash{\mpfootnotemark[2]}\mpfootnotemark[3]}
+% & \leftcell[50mm]{captionskip=2pt,\\framestyle=fbox,\\
+% heightadjust=object,\\framearound=object\botstrut\\ \hline\topstrut
+% style=boxed,\\ framefit=yes\botstrut\\ \hline\topstrut
+% framestyle=fbox,\\ framefit=yes,\\
+% heightadjust=all,\\ framearound=all}
+% &Первый, \texttt{boxed}, повторяет стиль пакета \package{float}:
+% ширина объекта равна |\textwidth|, предварительно заданной \cmd{\hsize} или
+% предопределённой ширине заданной внутри команды |\floatbox|;
+% рамка выступает по сторонам (см.~пример на~с.~\pageref{fig:setup:boxed}). Расстояние от текста до рамки
+% и~толщина рамки определяются параметрами \cmd{\fboxsep} и~\cmd{\fboxrule}
+% (значения по умолчанию \texttt{3\,pt} и~\texttt{.4\,pt} соответственно).\par
+% В~стиле с~прописной буквы, |Boxed|, ширина рамки совпадает
+% с~\cmd{\textwidth}, предварительно заданной \cmd{\hsize} или заданной шириной в~опции команды |\floatbox|;
+% ширина объекта при этом уменьшается,
+% чтобы поместиться внутри рамки (см.~пример на~с.~\pageref{fig:plain:MyBoxed}).\par
+% Прописная форма, |BOXED|, создаёт рамку
+% которая равна \cmd{\textwidth}, предварительно заданной \cmd{\hsize} или заданной шириной в~опции команды |\floatbox|
+% уже вокруг всех элементов бокса флота: подписи, объекта и~возможных экспликаций
+% (см.~пример на~с.~\pageref{fig:wrapfig:WcatII})
% \\\hline
-% \multicolumn{3}{|c|}{Определено в пакете \pkg{fr-fancy}.
-% Эти стили также требуют пакет \pkg{fancybox}.}\\
-% \hline \leftcell{\texttt{shadowbox}\smash{\mpfootnotemark[2]}
-% \\\hline\texttt{Shadowbox}
-% \\\hline\texttt{SHADOWBOX}}
-% & \leftcell[50mm]{style=boxed,framestyle=shadowbox\\ \hline
-% style=Boxed,framestyle=shadowbox\\ \hline
-% style=BOXED,framestyle=shadowbox}
+% \multicolumn{3}{|c|}{Определено в пакете \package{fr-fancy}.
+% Эти стили также требуют пакет \package{fancybox}.}\\
+% \hline \leftcell{\texttt{shadowbox}\smash{\mpfootnotemark[4]}
+% \\ \botstrut\\ \hline\topstrut\texttt{Shadowbox}
+% \\ \botstrut\\ \hline\topstrut\texttt{SHADOWBOX}}
+% & \leftcell[50mm]{style=boxed,\\framestyle=shadowbox\botstrut\\ \hline\topstrut
+% style=Boxed,\\framestyle=shadowbox\botstrut\\ \hline\topstrut
+% style=BOXED,\\framestyle=shadowbox}
% &То же, что и \texttt{boxed}, \texttt{Boxed} и \texttt{BOXED}
% соответственно. Рамка \cmd{\fbox} заменена на \cmd{\shadowbox}
-% из пакета \pkg{fancybox}.
+% из пакета \package{fancybox} (см.~пример на~с.~\pageref{fig:subfig:catsI}).
+% Помимо \cmd{\fboxsep} и~\cmd{\fboxrule}, здесь ещё задаётся параметр \cmd{\shadowsize} \cdash--- ширина тени
+% (по умолчанию равна 4\,pt).
% \\\hline
-% \leftcell{\texttt{doublebox}\smash{\mpfootnotemark[2]}
-% \\\hline\texttt{Doublebox}\\\hline\texttt{DOUBLEBOX}}
-% & \leftcell[50mm]{style=boxed,framestyle=doublebox\\\hline
-% style=Boxed,framestyle=doublebox\\\hline
-% style=BOXED,framestyle=doublebox}
+% \leftcell{\texttt{doublebox}\smash{\mpfootnotemark[4]}
+% \\ \botstrut\\ \hline\topstrut\texttt{Doublebox}\\
+% \botstrut\\ \hline\topstrut\texttt{DOUBLEBOX}}
+% & \leftcell[50mm]{style=boxed,\\ framestyle=doublebox\botstrut\\ \hline\topstrut
+% style=Boxed,\\ framestyle=doublebox\botstrut\\ \hline\topstrut
+% style=BOXED,\\ framestyle=doublebox}
% &То же, что и \texttt{boxed}, \texttt{Boxed} и \texttt{BOXED}
% соответственно. Рамка \cmd{\fbox} заменена на \cmd{\doublebox}
-% из пакета \pkg{fancybox}.
+% из пакета \package{fancybox}. Рамка определяется параметрами \cmd{\fboxsep} и~\cmd{\fboxrule}
% \\\hline
% \multicolumn{3}{|c|}{Дополнительный стиль. Он также требует пакет
-% \pkg{fancybox}.}\\\hline
-% \leftcell{\texttt{wshadowbox}\smash{\mpfootnotemark[2]}
-% \\\hline\texttt{Wshadowbox}
-% \\\hline\texttt{WSHADOWBOX}}
-% & \leftcell[50mm]{style=boxed,framestyle=wshadowbox\\\hline
-% style=Boxed,framestyle=wshadowbox\\\hline
-% style=BOXED,framestyle=wshadowbox}
-% &То же, что и \texttt{boxed}, \texttt{Boxed} и \texttt{BOXED}
+% \package{fancybox}.}\\\hline
+% \leftcell{\texttt{wshadowbox}\smash{\mpfootnotemark[4]}
+% \\ \botstrut\\ \hline\topstrut\texttt{Wshadowbox}
+% \\ \botstrut\\ \hline\topstrut\texttt{WSHADOWBOX}}
+% & \leftcell[50mm]{style=boxed,\\framestyle=wshadowbox\botstrut\\ \hline\topstrut
+% style=Boxed,\\framestyle=wshadowbox\botstrut\\ \hline\topstrut
+% style=BOXED,\\framestyle=wshadowbox}
+% &То же, что и~\texttt{boxed}, \texttt{Boxed} и~\texttt{BOXED}
% соответственно. Рамка \cmd{\fbox} заменена на \cmd{\wshadowbox},
% похожую на \cmd{\shadowbox} (но создаёт белую тень, или
-% края <<второй копии>>) из пакета \pkg{fancybox}.
+% края <<второй копии>>) из пакета \package{fancybox} (см.~пример на~с.~{fig:floatflt:WcatI}), для задания рамки
+% используются те же параметры, что и~в~стиле \texttt{wshadowbox}
% \\\hline
-% \end{tabularx}
-%
-% \caption{Стили плавающих объектов}\label{tab:floatlayouts}%
-%
-% \floatfoot{Если задан стиль флота с рамкой вокруг объекта, равной ширине
+%^^A% {\floatfoot*{When there is set float style with frame around object of
+%^^A% fitted to the text width (like \texttt{Boxed}, etc.), and
+%^^A% \cmd{\floatbox} macro uses \cmd{\FBwidth} command as \meta{width}
+%^^A% option, which sets box width equal to float object's width (see
+%^^A% page~\pageref{sec:floatbox}), the width of all float other elements
+%^^A% in this case enlarged to get width of framed object.\vspace{-3pt}\par
+%^^A% \rule{1in}{.4pt}\vspace{2pt}\parindent15pt
+% \noalign{\floatfoot*{Если задан стиль флота, где ширина рамки вокруг объекта, равна ширине
% основного текста или предопределённой ширине (как \texttt{Boxed}, etc.),
-% и в опции \meta{width} макрокоманды \cmd{\floatbox} определена команда
+% и~в~опции \meta{width} макрокоманды \cmd{\floatbox} определена команда
% \cmd{\FBwidth}, устанавливающая ширину всех элементов флота равной
% ширине объекта (см.~с.~\pageref{sec:floatbox}), ширина остальных элементов
-% флота в этом случае увеличивается, до ширины равной обрамлённому объекту.}
+% флота в~этом случае увеличивается, до ширины равной обведённому рамкой объекту.\vspace{-3pt}\par
+% \rule{1in}{.4pt}\vspace{2pt}\parindent15pt
%
-% \footnotetext[1]{Стили аналогичны предложенным пакетом \pkg{float}.}
-% \footnotetext[2]{При использовании этих стилей в окружении \env{floatrow}
+%^^A% \mpfootnotemark[1]{The styles co-named and analogous to \package{float} package style.}
+%^^A%
+%^^A% \mpfootnotemark[2]{This style used in the sample file \file{frsmaple01.tex}}
+%^^A%
+%^^A% \mpfootnotemark[3]{This style used in the sample file \file{frsmaple02.tex}}
+%^^A%
+%^^A% \mpfootnotemark[4]{During usage of these styles in
+%^^A% \env{floatrow} environment you ought to enlarge
+%^^A% space between floats, using key \texttt{floatrowsep}.}
+% \mpfootnotemark[1]{Стили аналогичны предложенным пакетом \package{float}.}
+%
+% \mpfootnotemark[2]{Этот стиль используется в~файле образцов \file{frsmaple01.tex}}
+%
+% \mpfootnotemark[3]{Этот стиль используется в~файле образцов \file{frsmaple02.tex}}
+%
+% \mpfootnotemark[4]{При использовании этих стилей в~окружении \env{floatrow}
% вам необходимо увеличить расстояние между флотами (переопределив
-% ключ \texttt{floatrowsep}).}
-% \end{sidewaystable}
-% \label{setup:start}
+% ключ \texttt{floatrowsep}).}}}
+% \end{longtable}
+%
+% \endgroup
%
-%^^A\pagebreak[4]
%
-% \subsubsection{Настройки шрифта}
%
-% \DescribeMacro{font=}
+% \RestoreSpaces
+%
+%^^A%\pagebreak[4]%^^A%protect clubs
+%
+%^^A% \subsubsection{Font settings}\label{setup:start}
+% \subsubsection{Настройки шрифта}\label{setup:start}
+%
+% \DescribeMacro{font=}\label{setup:font}%^^A
+%^^A% Defines font for float object contents. Option
+%^^A% analogous to |font| key in |\captionsetup| stuff.\nopagebreak
% Определяет шрифт для содержимого плавающего объекта. Опции аналогичны
% ключу \texttt{font=}
-% в команде |\captionsetup|.\nopagebreak
+% в~команде |\captionsetup|.\nopagebreak
%
+%^^A% Available font setting options:
% Существующие уже опции настройки шрифта:
%
% \begin{Options}{\OptionLabel}
% \item[scriptsize] {\scriptsize очень маленький размер}
-% \item[footnotesize] {\footnotesize размер, используемый сносками}
-% \item[small] {\small маленький размер, в русских изданиях
-% рекомендуется для плавающих объектов}
+% \item[footnotesize] {\footnotesize для сносок; \textit{используется в~сносках и~экспликациях}}
+% \item[small] {\small маленький размер; \textit{используется в~объектах флотов}}
% \item[normalsize] {\normalsize нормальный размер}
% \item[large] {\large большой размер}
% \item[Large] {\Large б\'ольший размер}
@@ -669,11 +2330,18 @@
% \item[md] {\mdseries нормальная насыщенность}
% \item[bf] {\bfseries полужирный шрифт}
%
-% \item[rm] {\rmfamily романский шрифт или шрифт с засечками}
+% \item[rm] {\rmfamily романский шрифт или шрифт с~засечками}
% \item[sf] {\sffamily рубленый шрифт}
% \item[tt] {\ttfamily шрифт пишущей машинки}
+%^^A% \item[...]
+%^^A% You may create your own options with |\DeclareFloatFont| command,
+%^^A% see page~\pageref{ssec:declfont}.
+% \item[...]
+% Вы можете создать свои определения с~помощью команды~|\DeclareFloatFont|,
+% см.~с.~\pageref{ssec:declfont}.
% \end{Options}
%
+%^^A% You may set font for float object like
% Вы можете определить шрифт для объекта как
% \begin{quote}
% |font=small|
@@ -683,46 +2351,132 @@
% |font={small,sf}|\quad .
% \end{quote}
%
-% \DescribeMacro{footfont=}\label{sec:setfloatfoot}%^^A
-% Определяет шрифт для экспликаций.
-% Эта макрокоманда использует механизм команды |\captionsetup| (поскольку
-% |\floatfoot| использует механизм пакета \pkg{caption}).
-% По умолчанию размер шрифта для экспликации эквивалентен
-% размеру сносок: |footfont=footnotesize|.
-%
-% \subsubsection{Размещение подписей и других элементов}
-%
-% \DescribeMacro{capposition=}
+% \addvspace\medskipamount\noindent
+% \DescribeMacro{footfont}\label{setup:footfont}%^^A
+%^^A% Defines font for legends or explications (defined by |\floatfoot| command.
+%^^A% see~\textsl{\sectionname}~\ref{subsec:floatfoot}). This macro
+%^^A% uses |\captionsetup| mechanism (because |\floatfoot| macro
+%^^A% uses \package{caption} mechanism). By default the font size
+%^^A% of float foot text equals to footnote text: |footfont=footnotesize|.
+% Определяет шрифт для экспликаций (задаваемые командой |\floatfoot|,
+% см.~\textsl{\sectionname}~\ref{subsec:floatfoot}).
+% Эта команда использует настройки, заданные командой |\captionsetup| (определение
+% |\floatfoot| базируется на командах из \package{caption}).
+% По умолчанию шрифт для экспликаций аналогичен
+% шрифту сносок: |footfont=footnotesize|.
+%
+% \RestoreSpaces
+%^^A% \subsubsection{Position of Caption and of Other Elements}
+% \subsubsection{Размещение подписей и~других элементов}
+%
+% \DescribeMacro{capposition}\label{setup:capposition}%^^A
+%^^A% Defines position of captions. It is similar to \texttt{position=}
+%^^A% key in \package{caption} package, but it has two additional
+%^^A% options\footnote{The option \texttt{auto} isn't used by
+%^^A% \texttt{capposition=}.}: \texttt{TOP}%^^A
+%^^A% \FRmpar{Caption above table object}{FAD:CaptionAboveTableII},
+%^^A% if you prefer to align captions
+%^^A% above objects, in the case of beside floats (in \env{floatrow}
+%^^A% environment), by the top line; and \texttt{beside} to put caption
+%^^A% beside object (this option could be more preferable in settings
+%^^A% for one environment, see about |\thisfloatsetup| on the
+%^^A% page~\pageref{thisfloatsetup}):
% Определяет расположение подписей. Ключ похож
-% на ключ \texttt{position=} пакета \pkg{caption}, но он имеет
+% на ключ \texttt{position=} пакета \package{caption}, но он имеет
% две дополнительные опции\footnote{Опция \texttt{auto} не используется ключом
-% \texttt{capposition=}.}: \texttt{TOP}, если вы предпочитаете выровнять подписи,
-% расположенные сверху объектов, при расположении флотов рядом
-% (в окружении \env{floatrow}),
-% по верхней строке; и \texttt{beside} для размещения подписи
+% \texttt{capposition=}.}: \qquad\texttt{TOP},%^^A
+% \FRmpar{Подпись над таблицей}{FAD:CaptionAboveTableII}
+% если вы хотите выровнять подписи,
+% расположенные сверху объектов, расположенных в~одном ряду
+% (окружение \env{floatrow}),
+% по верхней строке; \qquad и~\texttt{beside} для размещения подписи
% сбоку от объекта (эта опция
-% может быть более предпочтительна для настроек отдельного окружения, см. о команде
-% |\thisfloatsetup| на с.~\pageref{thisfloatsetup}):
+% может быть более предпочтительна для настроек отдельного окружения флота, см. о~команде
+% |\thisfloatsetup| на~с.~\pageref{thisfloatsetup}):
+% \par\RestoreSpaces
% \begin{Options}{\OptionLabel}
-% \item[top] подпись сверху объекта (соответствует команде |\captop|);
-% \item[TOP] подпись сверху объекта и при размещении флотов рядом
-% (в окружении \env{floatrow}) подписи выравниваются
-% по верхней строке (соответствует команде |\CAPTOP|).
-% Например, стиль \texttt{Plaintop} является вариантом стиля \texttt{plaintop}
+%^^A% \item[top] caption above object (or |\captop| command,
+%^^A% for |\floatbox|'s option, see below);
+% \item[top] подписи сверху объекта;
+%^^A% \item[TOP] caption above object and also aligned by top line in float
+%^^A% row (or |\CAPTOP| command).
+%^^A% For example the \texttt{Plaintop} style is the variant of
+%^^A% \texttt{plaintop} where used |capposition=TOP| settings,
+%^^A% see tables~\ref{tab:row:tabIII}--\ref{tab:row:tabIV};
+% \item[TOP] подписи сверху объекта и~при размещении флотов рядом
+% (\env{floatrow}) они выравниваются
+% по верху.
+% Так, стиль \texttt{Plaintop} \cdash--- вариант стиля \texttt{plaintop}
% где определена |capposition=TOP|,
-% см. табл.~\ref{tab:row:tabIII}--\ref{tab:row:tabIV};
-% \item[bottom] подпись снизу объекта (соответствует команде |\capbot|);
-% \item[beside] подпись сбоку объекта (соответствует команде |\capbeside|).
+% см. табл.~\ref{tab:row:tabIII:CAPTOP}--\ref{tab:row:tabIV:CAPTOP};
+%^^A% \item[bottom] caption below object (or |\capbot| command);
+% \item[bottom] подпись снизу объекта;
+%^^A% \item[beside] caption beside object (equals to |\capbeside|
+%^^A% command).%^^A
+% \item[beside] подпись сбоку объекта.%^^A
+% %^^A\FRmpar{Подпись сбоку}{FAD:BesideCaptionII}
% \end{Options}
%
+% \begin{Quote}
+% |\floatsetup[table]{|\hyperref[setup:style]{\texttt{style}}%^^A
+% |=plain,capposition=top}%|${}\equiv\texttt{style=plaintop}$
+% \end{Quote}
% \DeleteShortVerb{\|}%
-% \begin{table}[h]
-% \begin{floatrow}
+% \begingroup
+% \floatsetup[table]{style=plain,capposition=top}
+% \begin{table}[H]
+% \begin{floatrow}\tabcolsep2\tabcolsep
+% \extrarowheight1pt
+% \ttabbox
+% {\caption[Таблица~I с длинным заголовком]%^^A
+% {Таблица~I в~ряду с~длинным, длинным, длинным заголовком}\label{tab:row:tabIII:captop}}%^^A
+% {\begin{tabular}{|l|>{\phantom0}c|>{\phantom0}c|}
+% \hline
+% \multirowthead{2}[-1ex]{Left Column Head}
+% & \multicolumn{2}{c|}{\thead{Data}} \\
+% \cline{2-3}
+% & \multicolumn{1}{c|}{\thead{I}}
+% & \multicolumn{1}{c|}{\thead{II}}
+% \\\hline
+% First row & 1 & 2 \\
+% Second row & 3 & 4 \\
+% Third row & 6 & 8 \\
+% Fourth row & \llap{1}0 & \llap{1}6 \\
+% \hline
+% \end{tabular}}
+%
+% \ttabbox
+% {\caption{Таблица~II в ряду}\label{tab:row:tabIV:captop}}%^^A
+% {\begin{tabular}{|l|c|c|c|}
+% \hline
+% \multirowthead{2}[-1ex]{Column Head}
+% & \multicolumn{3}{c|}{Data} \\
+% \cline{2-4}
+% & \thead{I} & \thead{II} & \thead{III} \\
+% \hline
+% First row & 1 & 2 & \phantom01 \\
+% Second row & 3 & 4 & \phantom06 \\
+% Third row & 6 & 8 & 28 \\
+% \hline
+% \end{tabular}}
+% \end{floatrow}
+% \end{table}
+% \endgroup
+% \MakeShortVerb{\|}%
+%
+% \begin{Quote}
+% |\floatsetup[table]{|\hyperref[setup:style]{\texttt{style}}|=plain,capposition=TOP}%|${}\equiv\texttt{style=Plaintop}$
+% \end{Quote}
+% \DeleteShortVerb{\|}%
+% \begingroup
+% \floatsetup[table]{style=plain,capposition=TOP}
+% \begin{table}[H]
+% \begin{floatrow}\tabcolsep2\tabcolsep
% \extrarowheight1pt
% \ttabbox
-% {\caption[Длинный заголовок таблицы~I]%^^A
-% {Таблица~I в ряду с длинным, длинным, длинным заголовком,
-% выровненным по верхней строке}\label{tab:row:tabIII}}%^^A
+% {\caption[Таблица~I с длинным заголовком, выровненным по верху]%^^A
+% {Таблица~I в~ряду с~длинным, длинным, длинным заголовком,
+% выровненным по верхней строке}\label{tab:row:tabIII:CAPTOP}}%^^A
% {\begin{tabular}{|l|>{\phantom0}c|>{\phantom0}c|}
% \hline
% \multirowthead{2}[-1ex]{Left Column Head}
@@ -739,8 +2493,7 @@
% \end{tabular}}
%
% \ttabbox
-% {\caption{Таблица~II в ряду с заголовком, выровненным по верхней
-% строке}\label{tab:row:tabIV}}%^^A
+% {\caption{Таблица~II в ряду с заголовком, выровненным по верху}\label{tab:row:tabIV:CAPTOP}}%^^A
% {\begin{tabular}{|l|c|c|c|}
% \hline
% \multirowthead{2}[-1ex]{Column Head}
@@ -755,413 +2508,872 @@
% \end{tabular}}
% \end{floatrow}
% \end{table}
+% \endgroup
% \MakeShortVerb{\|}%
%
+%^^A% \emph{Note}. The option \texttt{TOP} uses |\label|---|\ref|
+%^^A% mechanism, so to get necessary result with it you must run \LaTeX{}
+%^^A% twice (when you make changes in contents which could change number
+%^^A% of lines you get correct result also on the second run).
% \emph{Замечание}. Опция \texttt{TOP} использует механизм |\label|---|\ref|,
-% поэтому, чтобы получить нужный результат, нужно дважды обработать текст \LaTeX'ом
-% (если вы внесли изменения, которые изменили количество строк вы также
-% получите результат после второй обработки).
+% поэтому нужный результат получится после второй обработки \LaTeX'а
+% (изменения, которые изменили количество строк также требуют
+% двойной обработки).
%
-% \DescribeMacro{capbesideposition=}
-% Определяет вертикальное и горизонтальное расположение подписи рядом с объектом.
-% Для горизонтального расположения определены четыре опции:
+% \medskip\noindent
+% \DescribeMacro{capbesideposition}\label{setup:capbesideposition}%^^A
+%^^A% Defines position of beside captions: vertical and horizontal.
+%^^A% For horizontal position there are defined four options:
+% Определяет вертикальное и~горизонтальное расположение подписи рядом с~объектом.
+% Для горизонтального расположения определены следующие четыре опции:
+% \par\RestoreSpaces
% \begin{Options}{\OptionLabel}
% \item[left]
-% подпись помещается с левой стороны от объекта;
+%^^A% caption is printed to the left side of object;
+% подпись помещается с~левой стороны от объекта;
% \item[right]
-% подпись помещается с правой стороны от объекта;
+%^^A% caption is printed to the right side of object;
+% подпись помещается с~правой стороны от объекта;
% \item[inside]
+%^^A% caption is printed in binding side of page if |twoside| option
+%^^A% switched on in document class;
% подпись помещается со стороны корешкового поля, если включена опция |twoside|
-% в классе документа;
+% в~классе документа;
% \item[outside]
+%^^A% least popular option: caption printed in
+%^^A% outer side of page if |twoside| option switched on
+%^^A% in document class.
% менее популярная опция: подпись помещается со стороны внешнего поля,
% если опция |twoside| включена.
% \end{Options}
%
+%^^A% For vertical position there are defined three options
% Для вертикального расположения определены три опции
% \begin{Options}{\OptionLabel}\samepage
% \item[top]
+%^^A% caption aligned to the top of object;
% подпись выравнивается по верху объекта;
% \item[bottom]
+%^^A% caption aligned to the bottom of object;
% подпись выравнивается по низу объекта;
% \item[center]
+%^^A% caption aligned to the center of float contents.
% подпись и объекта выравниваются по средней линии.
% \end{Options}
+%^^A% You may define position of beside caption by following:
% Вы можете определить расположение подписи рядом следующим образом:
% \begin{quote}
% |capbesideposition={top,outside}|\quad.
% \end{quote}
+%^^A% See examples in file \file{frsample02.tex} with all variants of
+%^^A% position of beside captions.
+% См.~примеры в~файле \file{frsample02.tex} со всеми возможными вариантами
+% размещения подписей сбоку.
%
-% \noindent
-% \DescribeMacro{capbesidewidth=}
-% Определяет ширину подписи рядом (эта опция может быть более предпочтительна для
-% настройки отдельного окружения, см. о команде |\thisfloatsetup| на
-% с.~\pageref{thisfloatsetup}). Вы можете задать:
+% \medskip\noindent
+% \DescribeMacro{capbesidewidth}\label{setup:capbesidewidth}%^^A
+%^^A% Defines width of beside caption (this option could be more preferable
+%^^A% in settings for one environment, see about |\thisfloatsetup| on the
+%^^A% page~\pageref{thisfloatsetup}). You may set:
+% Определяет ширину подписи сбоку. Эта опция более предпочтительна для
+% отдельного окружения, см.~о~команде |\thisfloatsetup| на
+% с.~\pageref{thisfloatsetup}. Можно задать:
+% \par\RestoreSpaces
% \begin{quote}
% |capbesidewidth=4cm|\quad.
% \end{quote}
-% Если вы напишете \texttt{capbesidewidth=none} или
+%^^A% If you'll write \texttt{capbesidewidth=none} or
+%^^A% \texttt{capbesidewidth=sidefill} (this is default key setting), the
+%^^A% width of caption will be counted by usual way, accordingly
+%^^A% to float width (i.e. occupies the rest width of float box, see
+%^^A% figure~\ref{fig:beside:mouse} on the page~\pageref{fig:beside:mouse}).
+% Если вы зададите \texttt{capbesidewidth=none} или
% \texttt{capbesidewidth=sidefill}
-% (это настройка по умолчанию), ширина подписи будет рассчитана
-% относительно ширины объекта (то есть займет остальное пространство
-% в боксе, см. рис.~\ref{fig:beside:mouse} на с.~\pageref{fig:beside:mouse}).
+% (настройка по умолчанию), ширина подписи будет рассчитана
+% относительно ширины объекта (т.\,е. займёт остальное пространство
+% в~боксе, см.~рис.~\ref{intro:beside:FBwidth} на с.~\pageref{intro:beside:FBwidth}).
%
-% \noindent
-% \DescribeMacro{capbesideframe=}
+% \medskip\noindent
+% \DescribeMacro{capbesideframe}\label{setup:capbesideframe}%^^A
+%^^A% This boolean key declares whether beside caption stays near framed object
+%^^A% (\texttt{capbesideframe=yes}) in this case caption lines aligned by top
+%^^A% or bottom of frame; otherwise caption lines will be aligned with top or
+%^^A% bottom of framed object's \emph{contents} (\texttt{capbesideframe=no}).
% Этот ключ (работает как булев параметр) декларирует, размещена ли подпись рядом
-% с объектом, заключённым в рамку (\texttt{capbesideframe=yes}): в этом случае
+% с~объектом, заключённым в~рамку (\texttt{capbesideframe=yes}): в~этом случае
% строки подписи будут выравнивается по верху или низу рамки;
-% в противном случае верх или низ
-% \emph{содержимого} объекта в рамке будет выровнено со строками
-% подписи (\texttt{capbesideframe=no}).
+% в~противном случае со строками
+% подписи будут выровнены верх или низ
+% \emph{содержимого} объекта (\texttt{capbesideframe=no}).
+%^^A% This key was switched on in the example on the page~\pageref{fig:subfig:catsI}.
+% Данный ключ включён в~примере на~с.~\pageref{fig:subfig:catsI}.
+% \newcommand\TEXTBOX[1][]{\par
+% Here goes first line of text \text\par
+% There goes second line of text#1\par
+% Thence goes third line of text \text\par
+% Hence goes fourth line of text}
+% \def\text{{\mdseries And more text and some more text and a bit more text and
+% a little more text and a little piece of text to fill space}}
+%\begingroup
+% \begin{Quote}\openup.5pt
+% \meta{preamble}
+% |\floatsetup[figure]{|\hyperref[setup:style]{\texttt{style}}|=Boxed,|%^^A
+% \hyperref[setup:frameset]{\texttt{frameset}}|={\fboxsep8pt},|
+% | |\hyperref[setup:objectset]{\texttt{objectset}}|=justified,|%^^A
+% |capbesideframe=no,capbesideposition={right,top}}|
+% |\captionsetup[figure]{...,strut=no}|
+% \meta{preamble}
+% |\|\hyperref[setup:thisfloatsetup]{\texttt{thisfloatsetup}}%^^A
+% |{|\hyperref[setup:capposition]{\texttt{capposition}}|=beside,|
+% | |\hyperref[setup:floatwidth]{\texttt{floatwidth}}|=sidefil,|%^^A
+% \hyperref[setup:capbesidewidth]{\texttt{capbesidewidth}}|=4cm}|
+% |\begin{figure}|
+% |\fcapside|
+% | {...}|
+% | {\caption{...}\label{...}}|
+% |\end{figure}|
+% \end{Quote}%
+% \floatsetup[figure]{style=Boxed,frameset={\fboxsep8pt},capbesideframe=no,objectset=justified,
+% capbesideposition={right,top},footnoterule=limited}
+% \captionsetup[figure]{strut=no}
+% \thisfloatsetup{capposition=beside,floatwidth=sidefil,capbesidewidth=4cm}
+% \begin{figure}[H]
+% {\TEXTBOX}
+% {\caption{Подпись сбоку объекта в~рамке, выровнена по верху содержимого объекта}%%^^A
+% \label{capbesideframeI}}%
+% \end{figure}
+% \begin{Quote}\openup.5pt
+% |\|\hyperref[setup:thisfloatsetup]{\texttt{thisfloatsetup}}%^^A
+% |{|\hyperref[setup:capposition]{\texttt{capposition}}|=beside,|
+% | |\hyperref[setup:floatwidth]{\texttt{floatwidth}}|=9cm,|%^^A
+% \hyperref[setup:capbesidewidth]{\texttt{capbesidewidth}}|=sidefil}|
+% \end{Quote}%
+% \thisfloatsetup{capposition=beside,floatwidth=9cm,capbesidewidth=sidefil}
+% \captionsetup{strut=no}
+% \begin{figure}[H]
+% {\TEXTBOX}
+% {\caption{Подпись сбоку объекта в~рамке, выровнена по верху рамки}%
+% \label{row:text:I}}%
+% \end{figure}
+%\endgroup
+%
+%^^A% \emph{Floatrow note.} For examples above was also used |\captionsetup{strut=no}| sentence,
+%^^A% which cancels struts at the beginning and end of caption (|\strut|: the rules with height
+%^^A% and depth, which are set accordingly to current |\baselineskip|).
+% \noindent\emph{Замечание \textsf{floatrow}}.
+% Для примеров выше также был задан специальный ключ |\captionsetup{strut=no}|, который
+% отменяет <<распорки>> вначале и~в~конце подрисуночной подписи (|\strut|: специальные невидимые линейки,
+% высота и~ширина которых изменяется в~зависимости от заданного в~данный момент интерлиньяжа, |\baselineskip|).
+%
%
% \penalty-5000
-% \subsubsection{Определение расположения экспликаций (и сносок)}
+% \RestoreSpaces
+%^^A% \subsubsection{Defining Float Foot Position (Legends and Footnotes)}%
+% \subsubsection{Определение расположения экспликаций (и~сносок)}
% \label{sec:footposition}
%
-% \DescribeMacro{footposition=}\label{foot:pos}%^^A
-% Определяет расположение содержимого команд |\footnote| и |\floatfoot| внутри
-% бокса плавающего объекта с подписями сверху/снизу.
+% \DescribeMacro{footposition}\label{setup:footposition}%^^A
+%^^A% Defines position of |\footnote|'s and |\floatfoot|'s in float box
+%^^A% with above/below captions.
+% Определяет расположение содержимого команд |\footnote| и~|\floatfoot| внутри
+% бокса плавающего объекта с~подписями сверху/снизу.
% \begin{Options}{\OptionLabel}
+% \par\RestoreSpaces
% \item[default]
-% если подпись сверху, экспликации и сноски помещаются под объектом;
-% в противном случае
-% "--- под подписью;
+%^^A% if caption above float object foot material is placed below float
+%^^A% object otherwise---below caption;
+% если подпись сверху, экспликации и~сноски помещаются под объектом;
+% в~противном случае "--- под подписью;
% \item[caption]
+%^^A% always placed below caption;
% всегда помещаются под подписью;
% \item[bottom]
+%^^A% always placed at the bottom of float box.
% всегда помещаются внизу бокса.
% \end{Options}
-% См. примеры в файле \file{frsample01.tex}. В случае подписи стоящей сбоку,
-% сноски и экспликации всегда помещаются под подписью.
+%^^A% See examples in file \file{frsample01.tex}. In the case of caption
+%^^A% beside float object, footnotes and foot text always placed below
+%^^A% caption.
+% См.~примеры в~файле \file{frsample01.tex}. В~случае подписи стоящей сбоку,
+% сноски и~экспликации всегда помещаются под подписью.
%
+%^^A% \subsubsection{Defining Vertical Alignment}\label{sec:heightadjust}
% \subsubsection{Определение вертикального выравнивания}\label{sec:heightadjust}
%
-% \DescribeMacro{heightadjust=}
-% Определяет будет ли использоваться в ряду (\env{floatrow}) максимальная
+% \DescribeMacro{heightadjust}\label{setup:heightadjust}%^^A
+%^^A% Defines whether the common maximum height of objects
+%^^A% or/and captions in \env{floatrow} will be used. It has
+%^^A% following options
+% Определяет будет ли использоваться в~ряду (\env{floatrow}) максимальная
% высота объекта
-% и/или подписи в качестве общей. ключ имеет следующие опции
+% и/или подписи в~качестве общей. ключ имеет следующие опции
+% \par\RestoreSpaces
% \begin{Options}{\OptionLabel}\samepage
% \item[all]
+%^^A% adjust both caption and object heights (e.g. for styles
+%^^A% \texttt{Ruled} and \texttt{BOXED});
% выровнять высоты объектов и подписей по максимальной
% высоте (например, используется стилями \texttt{Ruled} и \texttt{BOXED});
% \item[caption]
+%^^A% adjust caption heights (e.g. for styles \texttt{Plaintop});
% выровнять высоты подписей по максимальной высоте
% (используется стилем \texttt{Plaintop});
% \item[object]
+%^^A% adjust object heights (e.g. for styles \texttt{Boxed});
% выровнять высоты объектов по максимальной высоте
% (используется стилем \texttt{Boxed});
% \item[none]
+%^^A% nothing to be adjusted;
% никакие высоты не изменяются (используется стилем \texttt{plain});
% \item[nocaption]
+%^^A% no adjusting for captions;
% высоты подписей не изменяются;
% \item[noobject]
+%^^A% no adjusting for objects;
% высоты объектов не изменяются;
% \end{Options}
+%^^A% You may define height adjustment even as followed:
% Вы можете определить, как делать общие высоты, даже так:
% \begin{quote}
% |heightadjust={caption,noobject}|\quad.
% \end{quote}
%
-% \noindent
-% \DescribeMacro{valign=}
-% Определяет вертикальное выравнивание объектов в ряду
+% \addvspace\medskipamount\noindent
+% \DescribeMacro{valign}\label{setup:valign}%^^A
+%^^A% Defines vertical alignment of
+%^^A% float objects in \env{floatrow} if |heightadjust=all| or
+%^^A% |heightadjust=object|, or |\floatbox| stuff uses \meta{height}
+%^^A% argument with value, which differs from the height of object.
+%^^A% The options of this key analogous to vertical
+%^^A% alignment option in \env{minipage} environment and |\parbox|
+%^^A% command. Default option is |c| (centered vertical alignment).
+% Определяет вертикальное выравнивание объектов в~ряду
% (\env{floatrow}) если задан ключ |heightadjust=all| или
-% |heightadjust=object| или в командах |\floatbox| используется
+% |heightadjust=object| или в~командах |\floatbox| используется
% аргумент \meta{height}
-% с величиной б\'ольшей высоты объекта. Опции этого ключа аналогичны
+% с~величиной б\'ольшей высоты объекта. Опции этого ключа аналогичны
% опции вертикального
-% выравнивания в окружении \env{minipage} и команде |\parbox|.
+% выравнивания в~окружении \env{minipage} и~команде |\parbox|.
% Опция по умолчанию: |c|
% (центрированное вертикальное выравнивание).
-% \begin{Options}{\OptionLabel}\samepage
+% \par\RestoreSpaces
+% \begin{Options}{cc}\samepage
% \item[t]
+%^^A% aligns objects by top line;
% выравнивает объекты по верхней линии;
% \item[c]
+%^^A% aligns objects by center line;
% выравнивает объекты по средней линии;
% \item[b]
+%^^A% aligns objects by bottom line;
% выравнивает объекты по нижней линии;
% \item[s]
+%^^A% stretches objects by full height (if it is possible).
% растягивает объекты на всю высоту (если возможно).
% \end{Options}
%
+%^^A% The settings |heightadjust=object,valign=c| were used
+%^^A% in the example with figures \ref{intro:leftfig:valigned}
+%^^A% and \ref{intro:rightfig:valigned}. (Please look at the width options of |\ffigbox| commands:
+%^^A% you may set the widths in this way with \package{calc} package.)
+% Настройки |heightadjust=object,valign=c| использованы
+% в~примере с~рисунками \ref{intro:leftfig:valigned}
+% и~\ref{intro:rightfig:valigned}. (Посмотрите на задание ширины в~командах |\ffigbox|:
+% такое задание ширины можно использовать при загруженном пакете \package{calc}.)
+%\begin{Quote}%
+%\meta{preamble}\nopagebreak
+%|\floatsetup{...,heightadjust=object,valign=c,...}|\nopagebreak
+%\meta{preamble}
+% |\begin{figure}|
+% |\begin{floatrow}|
+% | \ffigbox[\FBwidth+2cm]|
+% | {...}|
+% | {\caption{Левый ...}\label{...}}%|
+%| |
+% | \ffigbox[\FBwidth+2cm]|
+% | {\caption{Рисунок ...}\label{...}}|
+% | {...}|
+% |\end{floatrow}|
+% |\end{figure}|
+%\end{Quote}%
+% \begin{figure}[h!]\floatsetup{heightadjust=object,valign=c}\killfloatstyle
+% \begin{floatrow}
+% \ffigbox[\FBwidth+2cm]
+% {\input{BlackCat.picture}}
+% {\caption{Левый рисунок в~ряду использует вертикальное выравнивание по \hbox{центру}}%^^A
+% \label{intro:leftfig:valigned}}%
+%
+% \ffigbox[\FBwidth+2cm]
+% {\caption{Рисунок рядом тоже использует вертикальное выравнивание по \hbox{центру}}%^^A
+% \label{intro:rightfig:valigned}}
+% {\unitlength1.25\unitlength\input{Cat.picture}}
+% \end{floatrow}
+% \end{figure}%^^A
+%
+%^^A% \subsubsection{Facing Layout}
% \subsubsection{Оформление для разворотов}
%
-% \DescribeMacro{facing=}
+% \DescribeMacro{facing}\label{setup:facing}%^^A
+%^^A% This key defines whether facing layout used
+%^^A% for floats. This key works if |twoside| option switched on in
+%^^A% document class.
% Этот ключ определяет будет ли использоваться оформление флотов
-% для разворотов (зеркальное
-% отображение чётных и нечётных полос).
-% Этот ключ работает, если включена опция |twoside| в классе документа.
-%
-% \subsubsection{Определение полей вокруг флотов и настройка
+% для разворотов (различное
+% оформление чётных и нечётных полос).
+% Этот ключ работает, если включена опция |twoside| в~классе документа.
+%
+%^^A% The most popular usage of |facing| key is in the case, when beside captions are placed to the inner sides
+%^^A% of pages. The figures~\ref{intro:beside} and~\ref{intro:beside:FBwidth} at beginning of the document
+%^^A% illustrate these options---%^^A
+%^^A% \texttt{facing=yes,\allowbreak capbesideposition=inside}.
+% Наиболее популярное использование ключа |facing|: размещение подрисуночных подписей сбоку к~корешку.
+% Рисунки~\ref{intro:beside} и~\ref{intro:beside:FBwidth}
+% иллюстрируют применение этой опции \cdash---
+% \texttt{facing=yes,\allowbreak capbesideposition=inside}.
+%
+%
+% \RestoreSpaces
+%^^A% \subsubsection{Defining Float Margins and Object Settings}
+% \subsubsection{Поля вокруг флотов и~настройка
% для содержимого объекта}\label{sec:set:box}
%
-% \DescribeMacro{margins=}
-% Определяет поля для отдельных флотов с подписями сверху/снизу,
-% для отдельных флотов с подписями сбоку, и для окружения
+% \DescribeMacro{margins}\label{setup:margins}%^^A
+%^^A% Defines margins of alone float boxes with
+%^^A% captions above/below, of float boxes with beside captions, and of
+%^^A% \env{floatrow} environments. It has following three predefined
+%^^A% options:
+% Определяет поля для отдельных флотов с~подписями сверху/снизу,
+% для отдельных флотов с~подписями сбоку, и~для окружения
% \env{floatrow}. Ключ уже имеет три предопределённые опции:
+% \par\RestoreSpaces
% \begin{Options}{\OptionLabel}
% \item[centering]
+%^^A% float box centered;
% плавающий объект центрируется;
% \item[raggedright]
+%^^A% float box flushed to the left;
% плавающий объект выключается влево;
% \item[raggedleft]
+%^^A% float box flushed to the right.
% плавающий объект выключается вправо.
+% \item[...]
+%^^A% You may create your own alignment settings with \\|\DeclareMarginSet| command, see
+%^^A% page~\pageref{ssec:decl:marg}.
+% Вы можете задать специальное выравнивание с~помощью команды~|\DeclareMarginSet|,
+% см.~с.~\pageref{ssec:decl:marg}.
% \end{Options}
-% Вы можете задать специальное выравнивание, см.~с.~\pageref{ssec:decl:marg}.
%
% \noindent
-% \DescribeMacro{objectset=}\DescribeMacro{justification=}
+% \DescribeMacro{objectset}\DescribeMacro{justification}\label{setup:objectset}%^^A
+%^^A% Defines justification of float object
+%^^A% (float contents). Predefined options are similar to
+%^^A% \texttt{justification=} key in |\captionsetup|.
% Определяет выключку содержимого объекта.
-% Предопределённые опции те же, что и для ключа
+% Предопределённые опции те же, что и~для ключа
% \texttt{justification=} команды |\captionsetup|.
+% \par\RestoreSpaces
% \begin{Options}{\OptionLabel}
% \item[justified]
-% Печатает текст объекта как обычный абзац. (Задано по умолчанию.)
+%^^A% Blocks (in the case of a~picture or text box)
+%^^A% moved to the left, the object text aligned as a normal paragraph (without paragraph
+%^^A% indentation). (This is the default.)
+% Блоки (рисунки или бокс с~текстом) сдвигаются влево,
+% текст объекта печатается как обычный абзац, но без отступа. (Задано по умолчанию.)
%
% \item[centering]
-% Строки объекта центрируются.
+%^^A% Each line of the object text will be centered.
+% Блоки и строки текста объекта центрируются.
%
% \item[raggedright]
-% Строки объекта выключаются влево.
+%^^A% Each line of the object text will be moved to the left margin.
+% Блоки и строки текста объекта выключаются влево.
%
% \item[RaggedRight]
-% Строки объекта также выключаются влево.
-% Но в этом случае используется команда |\RaggedRight| пакета \pkg{ragged2e}.
-% Разница заключается в том, что задействован алгоритм переносов внутри текста.
+%^^A% As in previous item, each line of the object text will be moved to the
+%^^A% left margin, too.
+%^^A% But this time the command |\RaggedRight| of the \package{ragged2e} package
+%^^A% will be used to achieve this. This difference is that this time
+%^^A% the word breaking algorithm of \TeX\ will work inside the object text.
+% Как и~в~предыдущем пункте, блоки и строки текста объекта также выключаются влево.
+% Но в~этом случае используется команда |\RaggedRight| пакета \package{ragged2e}.
+% Разница состоит в~том, что задействован алгоритм переносов внутри текста
+% как в plain~\TeX'е.
%
% \item[raggedleft]
-% Строки выключаются вправо.
+%^^A% Each line of the object text will be moved to the right margin.
+% Блоки и строки выключаются вправо.
%
% \item[RaggedLeft]
+%^^A% Analogous to |RaggedRight|.
% Аналогична |RaggedRight|.
%
+% \item[...]
+%^^A% You may also create your own settings with |\DeclareObjectSet| command (see
+%^^A% page~\pageref{ssec:decl:rule})
+% Вы можете задать свои собственные настройки с~помощью команды~|\DeclareObjectSet|
+% (см.~с.~\pageref{ssec:decl:rule})
% \end{Options}
-% Вы можете задать свои собственные настройки (см.~с.~\pageref{ssec:decl:rule})
+%
+% \RestoreSpaces
+%^^A% \subsubsection{Defining Width of Object}\label{sec:wd:object}
+% \subsubsection{Определение ширины объекта, содержимого флота}\label{sec:wd:object}
%
% \noindent
-% \DescribeMacro{floatwidth=}
-% Вы можете использовать этот ключ для переопределения ширины флотов. Можно задать
-% \begin{quote}
-% |floatwidth=.6\hsize|
-% \end{quote}
+% \DescribeMacro{floatwidth}\label{setup:floatwidth}%^^A
+%^^A% It is used for redefinition of width of objects.
+%^^A% This key, similar to |captionwidth=|, page~\pageref{setup:capbesidewidth},
+%^^A% could be used at first
+%^^A% for settings of one float environment:
+% Используется для переопределения ширины объектов, содержимого флотов.
+% Этот ключ, как и~|captionwidth=|, см.~с.~\pageref{setup:capbesidewidth},
+% в~первую очередь предназначен для
+% настроек одного окружения:
+% \par\RestoreSpaces
+% \begin{Quote}
+% |floatwidth=.3\hsize|
+% \end{Quote}
% или
-% \begin{quote}
+% \begin{Quote}
% |floatwidth=7cm|
-% \end{quote}
-% Этот ключ удобно использовать в настройке для отдельного окружения
-% (см. о команде |\thisfloatsetup| на с.~\pageref{thisfloatsetup}).
+% \end{Quote}
+%^^A% (see page~\pageref{thisfloatsetup} about settings for current float environment and |\thisfloatsetup|).\pagebreak[1]
+% (см.~о~настройках для конкретного окружения флота и~о~команде |\thisfloatsetup|
+% на~с.~\pageref{thisfloatsetup}).
%
-% Если вы используете опцию \texttt{floatwidth=sidefill} для флотов с подписью
-% сбоку (в случае если в \texttt{capbesidewidth=} задано абсолютное значение
-% ширины, как \texttt{4cm}) объект (вместо подписи) займет остальное
-% пространство в боксе (см. приложение, рис.~\ref{fig:capbeside:trick} на
-% с.~\pageref{fig:capbeside:trick})
+% \begingroup
+% \begin{Quote}\openup-.65pt
+% \meta{preamble}\nopagebreak
+% |\floatsetup[figure]{|\hyperref[setup:capposition]{\texttt{capposition}}|=bottom}|\nopagebreak
+% \meta{preamble}
+% |\|\hyperref[setup:thisfloatsetup]{\texttt{thisfloatsetup}}%^^A
+% |[figure]{floatwidth=.3\hsize,capposition=bottom}|\nopagebreak
+% |\begin{figure}|
+% | \includegraphics[width=\hsize]{Bear}|
+% | \caption{...}\label{...}|
+% |\end{figure}|
+% \end{Quote}%
+%
+% \floatsetup[figure]{capposition=bottom}
+% \thisfloatsetup{floatwidth=.3\hsize}
+% \begin{figure}[H]
+% \setlength\unitlength{\hsize/100}\input{Bear.picture}%^^A
+% \caption{Рисунок с~шириной \texttt{floatwidth=0.3}\cmd{\hsize}}%
+% \label{fig:rot}
+% \end{figure}%
+% \endgroup
%
-% \subsubsection{Определение разделителей в боксах флотов}\label{sec:set:sep}
+% \begingroup
+% \begin{Quote}%
+% |\|\hyperref[setup:thisfloatsetup]{\texttt{thisfloatsetup}}%^^A
+% |{floatwidth=.3\hsize,|\hyperref[setup:capbesidewidth]{\texttt{capbesidewidth}}|=sidefil,|
+% | capposition=beside}|
+% \end{Quote}%
+%
+% \floatsetup[figure]{floatwidth=.3\hsize,capbesidewidth=sidefil,
+% capposition=beside}
+% \begin{figure}[H]
+% \setlength\unitlength{\hsize/100}\input{Bear.picture}%^^A
+% \caption{Подпись сбоку рисунка шириной \texttt{floatwidth=0.3}\cmd{\hsize}}%^^A
+% \label{fig:bear}
+% \end{figure}%
+% \endgroup
%
-% \noindent
-% \DescribeMacro{floatrowsep=}
-% Задаёт разделительный материал между флотами рядом
-% (заданных командой |\floatbox| и её
-% производными, см.~с.~\pageref{sec:floatbox}) внутри окружения \env{floatrow}
-% (см.~с.~\pageref{sec:floatrow}).
+%^^A% If you use option \texttt{floatwidth=sidefill} for objects with beside
+%^^A% captions (in the case of key \texttt{capbesidewidth=},
+%^^A% \DescribeMacro{capbesidewidth}\label{setup:capbesidewidth}%^^A
+%^^A% page~\ref{setup:capbesidewidth}, uses absolute
+%^^A% value, like \texttt{capbesidewidth=4cm}) the object (instead of caption)
+%^^A% occupies the rest space of float box (see appendix,
+%^^A% figure~\ref{fig:capbeside:trick} on the page~\pageref{fig:capbeside:trick})
+% Если вы используете опцию \texttt{floatwidth=sidefill} для флотов с~подписью
+% сбоку (в~случае если в~\texttt{capbesidewidth=},
+% \DescribeMacro{capbesidewidth}%^^A
+% задано абсолютное значение
+% ширины, например, \texttt{capbesidewidth=4cm}) содержимому объекта (вместо подписи) будет отведено остальное
+% пространство в~боксе (см. также рис.~\ref{capbesideframeI} на~с.~\pageref{capbesideframeI}
+% приложение, рис.~\ref{fig:capbeside:trick} на
+% с.~\pageref{fig:capbeside:trick})
%
-% \noindent
-% \DescribeMacro{capbesidesep=}
-% Задаёт разделительный материал между объектом и подписью сбоку.
+% \RestoreSpaces
+%^^A% \subsubsection{Defining Float Separators}\label{sec:set:sep}
+% \subsubsection{Определение разделителей в~боксах флотов}\label{sec:set:sep}
%
+% \noindent
+% \DescribeMacro{floatrowsep}\label{setup:floatrowsep}%^^A
+%^^A% Sets separation material between beside float boxes (defined
+%^^A% by |\floatbox| macro etc., see page~\pageref{sec:floatbox})
+%^^A% inside \env{floatrow} environment (see page~\pageref{sec:floatrow}).
+% Задаёт разделительный материал между плавающими объектами в~одном ряду,
+% внутри окружения \env{floatrow}, (см.~с.~\pageref{sec:floatrow}).
+%
+% \addvspace\smallskipamount\noindent
+% \DescribeMacro{capbesidesep}\label{setup:capbesidesep}%^^A
+%^^A% Sets separation material between object and beside caption.
+% Задаёт разделительный материал между объектом и~подписью сбоку.
+%
+% \RestoreSpaces
+%^^A% Both key settings work similarly to |labelsep=| key
+%^^A% from |\captionsetup|.
% Настройки обоих ключей работают аналогично настройкам ключа |labelsep=|
% в команде |\captionsetup|.
-%
+%%^^A
+%^^A% They use following predefined options:
% Они используют следующие предопределённые опции:
% \begin{Options}{\OptionLabel}
% \item[columnsep]
+%^^A% horizontal skip${}={}$|\columnsep|;
% горизонтальная отбивка${}={}$|\columnsep| (межколонник при двух-
-% и многоколонном наборе);
+% и~многоколонном наборе);
% \item[quad]
+%^^A% horizontal skip${}={}1$\,em;
% горизонтальная отбивка${}={}1$\,em (одна кегельная);
% \item[qquad]
+%^^A% horizontal skip${}={}2$\,em;
% горизонтальная отбивка${}={}2$\,em (две кегельные);
% \item[hfil]
-% горизонтальная отбивка${}={}1$\,fil (растяжимая длина |\hfil|);
+%^^A% horizontal skip${}={}1$\,fil (like |\hfil|);
+% горизонтальная отбивка${}={}1$\,fil (то же, что и~|\hfil|);
% \item[hfill]
-% горизонтальная отбивка${}={}1$\,fill (ещё более растяжимая длина |\hfill|);
+%^^A% horizontal skip${}={}1$\,fill (like |\hfill|);
+% горизонтальная отбивка${}={}1$\,fill (то же, что и~|\hfill|);
% \item[none]
+%^^A% empty separator.
% пустой разделитель.
+% \item[...]
+%^^A% You may also create your own settings with\\ |\DeclareFloatSeparators| command (see
+%^^A% page~\pageref{setup:DeclareFloatSeparators})
+% Вы можете задать свои установки с~помощью команды~\\|\DeclareFloatSeparators|
+% (см.~с.~\pageref{setup:DeclareFloatSeparators})
% \end{Options}
+%^^A% This documentation uses settings |floatrowsep=qquad,capbesidesep=quad|.
+% Данная документация использует настройки |floatrowsep=qquad,| для флотов рядом и~|capbesidesep=quad|
+% для флотов с~подписью сбоку.
%
+%^^A% \subsubsection{Defining Float Rules/Skips}\label{sec:set:rule}
% \subsubsection{Определение вертикальных отбивок или линеек}\label{sec:set:rule}
%
-% \DescribeMacro{precode=}
-% Определяет отбивку, линейку или другой подобный материал сверху флота.
-%
-% \noindent
-% \DescribeMacro{rowprecode=}
-% Определяет отбивку, линейку или другой подобный материал
-% сверху отдельного флота и, при
-% размещении флотов рядом в окружении \env{floatrow}, сверху ряда флотов.
+% \DescribeMacro{precode}\label{setup:precode}%^^A
+%^^A% Defines skip, rule or other analogous code above float box.
+% Определяет отбивку, линейку или аналогичный материал сверху флота.
+%
+% \addvspace\smallskipamount\noindent
+% \DescribeMacro{rowprecode}\label{setup:rowprecode}%^^A
+%^^A% Defines skip, rule or other analogous code above alone float box,
+%^^A% or, in the case of beside floats inside \env{floatrow} environment,
+%^^A% above float row (see page~\pageref{fig:rotrow:WcatI}).
+% Определяет отбивку, линейку или аналогичный материал
+% сверху отдельного флота или сверху ряда флотов в~окружении \env{floatrow}.
% (см.~с.~\pageref{fig:rotrow:WcatI}).
%
-% \noindent
-% \DescribeMacro{midcode=}
-% Определяет отбивку, линейку или другой подобный материал
-% между подписью сверху/снизу и объектом.
-%
-% \noindent
-% \DescribeMacro{postcode=}
-% Определяет отбивку, линейку или другой подобный материал снизу флота.
-%
-% \noindent
-% \DescribeMacro{rowpostcode=}
-% Определяет отбивку, линейку или другой подобный материал снизу
-% отдельного флота и, при
-% размещении флотов рядом в окружении \env{floatrow},
-% снизу ряда флотов (см.~с.~\pageref{fig:rotrow:WcatI}).
-%
+% \addvspace\smallskipamount\noindent
+% \DescribeMacro{midcode}\label{setup:midcode}%^^A
+%^^A% Defines skip, rule or other analogous code between
+%^^A% caption above/below and float object.
+% Определяет отбивку, линейку или аналогичный материал
+% между подписью сверху/снизу и~объектом.
+%
+% \addvspace\smallskipamount\noindent
+% \DescribeMacro{postcode}\label{setup:postcode}%^^A
+%^^A% Defines skip, rule or other analogous code below float box.
+% Определяет отбивку, линейку или аналогичный материал снизу флота.
+%
+% \addvspace\smallskipamount\noindent
+% \DescribeMacro{rowpostcode}\label{setup:rowpostcode}%^^A
+%^^A% Defines skip, rule or other analogous code below alone float box, or,
+%^^A% in the case of beside floats inside \env{floatrow} environment,
+%^^A% below float row (see page~\pageref{fig:rotrow:WcatI}).
+% Определяет отбивку, линейку или аналогичный материал снизу
+% отдельного флота или
+% снизу ряда флотов в~окружении \env{floatrow} (см.~с.~\pageref{fig:rotrow:WcatI}).
+%
+%^^A% For all these keys there are predefined following options (settings
+%^^A% were taken from styles created in \package{float} package):
% Для всех этих ключей предопределены следующие опции (настройки
-% взяты из стилей, созданных пакетом \pkg{float}):
+% взяты из стилей, созданных пакетом \package{float}):
% \begin{Options}{\OptionLabel}\makeatletter\@itempenalty10000\makeatother
% \item[none]
+%^^A% absent code;
% отбивка отсутствует;
% \item[thickrule]
-% толстая линия (.8pt) с отбивкой снизу в 2pt "--- верхняя линейка
+%^^A% thick rule (.8pt) with 2pt vertical skip below---rule above float box
+%^^A% in \texttt{ruled} style;
+% толстая линия (.8pt) с~отбивкой снизу в~2pt "--- верхняя линейка
% над флотов в стиле \texttt{ruled};
% \item[rule]
-% линейка обычной толщины (.4pt), с отбивками сверху и снизу
-% в 2pt "---средняя линейка в стиле \texttt{ruled};
+%^^A% rule of default thickness (.4pt), with 2pt vertical skips above and
+%^^A% below---middle rule in \texttt{ruled} style;
+% линейка обычной толщины (.4pt), с~отбивками сверху и~снизу
+% в~2pt "---средняя линейка в~стиле \texttt{ruled};
% \item[lowrule]
-% линейка обычной толщины (.4pt), с отбивкой сверху в
-% 2pt "--- нижняя линейка в стиле \texttt{ruled};
+%^^A% rule of default thickness (.4pt), with 2pt vertical skip above---rule
+%^^A% below float box in \texttt{ruled} style;
+% линейка обычной толщины (.4pt), с~отбивкой сверху
+% в~2pt "--- нижняя линейка в~стиле \texttt{ruled};
% \item[captionskip]
-% вертикальная отбивка равная величине, заданной в ключе |captionskip=|.
+%^^A% vertical skip equal to value, defined in |captionskip=| key.
+% вертикальная отбивка, задаваемая в~ключе |captionskip=|.
+% \item[...]
+%^^A% You may create your own options with |\DeclareFloatVCode| command,
+%^^A% see page~\pageref{ssec:decl:rule}.
+% Вы можете задать свои установки с~помощью команды~\\|\DeclareFloatVCode|,
+% см.~с.~\pageref{ssec:decl:rule}.
% \end{Options}
-% Вы можете задать свои опции, см.~с.~\pageref{ssec:decl:rule}.
%
+%^^A% \subsubsection{Defining Float Frames}
% \subsubsection{Задание рамок для флотов}
%
-% \DescribeMacro{framestyle=}
+% \DescribeMacro{framestyle}\label{setup:framestyle}%^^A
+%^^A% Defines type of frame; the
+%^^A% \package{floatrow} package offers only one type of frame:
% Определяет тип рамки; пакет
-% \pkg{floatrow} предлагает только один вид рамки:
+% \package{floatrow} предлагает только один вид рамки:
+% \par\RestoreSpaces
% \begin{Options}{\OptionLabel}
% \item[fbox]
% стандартная рамка.
% \end{Options}
+%^^A% There are options for additional frames, offered by \package{fr-fancy}
+%^^A% package, installed with \env{floatrow}:
% Далее идут опции для задания дополнительных вариантов рамок,
-% предлагаемых пакетом \pkg{fr-fancy},
-% который инсталлируется вместе с \pkg{floatrow}:
+% предлагаемых пакетом \package{fr-fancy},
+% который инсталлируется вместе с~\package{floatrow}:
% \begin{Options}{\OptionLabel}
% \item[colorbox]
-% цветная рамка, для неё нужен пакет \pkg{color};
+%^^A% colored frame, needs also \package{color} package;
+%^^A% if not defined, there is used |\fbox|;
+% цветная рамка, для неё нужен пакет \package{color};
% если эта рамка не определена, используется обычная |\fbox|;
% \item[doublebox]
-% двойная рамка, для неё нужен пакет \pkg{fancybox};
+%^^A% double frame, needs also \package{fancybox} package;
+% двойная рамка, для неё нужен пакет \package{fancybox};
% \item[shadowbox]
-% рамка с тенью, для неё нужен пакет \pkg{fancybox};
+%^^A% frame with shadow, needs also \package{fancybox} package;
+% рамка с~тенью, для неё нужен пакет \package{fancybox};
% \item[wshadowbox]
-% изменённая рамка \texttt{shadowbox} (с <<белой тенью>>),
-% для неё нужен пакет \pkg{fancybox};
-% \end{Options}
-%
-% \noindent
-% \DescribeMacro{framearound=}
-% Задаёт элемент флота, вокруг которого нужно создать рамку:
-% \begin{Options}{\OptionLabel}
-% \item[object]
-% только содержимое объекта;
-% \item[all]
-% флот полностью, включая объект, подпись и дополнительный материал.
+%^^A% modified \texttt{shadowbox} frame (frame with ``white shadow''),
+%^^A% needs also \package{fancybox} package;
+% изменённая рамка \texttt{shadowbox} (с~<<белой тенью>>),
+% для неё нужен пакет \package{fancybox};
% \end{Options}
%
-% \noindent
-% \DescribeMacro{framefit=}
-% Переключатель (работает как булев параметр) который определяет
-% нужно ли ширину рамки делать равной ширине
-% текста |\hsize| или предопределённой ширине (\texttt{framefit=yes}),
-% объект в этом случае
-% сужается; или рамка выступает в обе стороны и,
-% в этом случае ширина объекта равна |\hsize|
-% или предопределённой ширине (\texttt{framefit=no})
-%
-% \noindent
-% \DescribeMacro{frameset=}
+% \addvspace\medskipamount\noindent
+% \DescribeMacro{frameset}\label{setup:frameset}%^^A
+%^^A% The parameters for chosen frame; there are no options
+%^^A% for this key, just write something like:
% Параметры выбранной рамки; для этого ключа нет предопределённых опций,
% он определяется следующим образом:
+% \par\RestoreSpaces
% \begin{quote}
% |frameset={\fboxrule1pt\fboxsep12pt}|\quad.
% \end{quote}
%
-% \noindent
-% \DescribeMacro{colorframeset=}
-% Ключ предлагается пакетом \pkg{fr-fancy}: определяет
-% цветную рамку (по умолчанию это обычная |\fbox|).
-% В текущей версии вы можете использовать только команду |\fcolorbox|
-% для цветной рамки. Вы
-% можете определить цветную рамку следующим образом:
+% \addvspace\medskipamount\noindent
+% \DescribeMacro{framearound}\label{setup:framearound}%^^A
+%^^A% Declares element of float box to be framed:
+% Задаёт элемент флота, вокруг которого нужно создать рамку:
+% \par\RestoreSpaces
+% \begin{Options}{RaggedRigh}
+% \item[object]
+%^^A% float object contents;
+% только содержимое объекта;
+% \item[all]
+%^^A% full float box including object, caption, and any foot text.
+% весь бокс флота, включая объект, подпись, сноски/экспликации.
+% \end{Options}
+%
+% \addvspace\medskipamount\noindent
+% \DescribeMacro{framefit}\label{setup:framefit}%^^A
+%^^A% Boolean which sets whether the \textit{frame width} will
+%^^A% be equal to current |\hsize| or predefined width of
+%^^A% float box (\texttt{framefit=yes}), in this case object size reduced
+%^^A% see~page~\pageref{fig:plain:MyBoxed} (all boxed figures in current
+%^^A% documentation use true value of this key);
+%^^A% or the frame climbs out in the left and
+%^^A% right sides, and \textit{width of object} has current
+%^^A% |\hsize| or predefined width of float box (\texttt{framefit=no}).
+% Переключатель (булев параметр) определяет,
+% нужно ли ширину рамки делать равной ширине
+% текста или предопределённой ширине |\hsize| (\texttt{framefit=yes}),
+% объект в~этом случае
+% сужается, (см.~пример на с.~\pageref{fig:plain:MyBoxed}
+% и~все рисунки в~рамке в~данной документации);
+% или рамка выступает в~обе стороны и
+% в~этом случае ширина объекта равна |\hsize|
+% или предопределённой ширине (\texttt{framefit=no}).
+% \begingroup
+% \begin{Quote}\openup.5pt
+% |\floatsetup[figure]{framestyle=fbox,|\hyperref[setup:heightadjust]{\texttt{heightadjust}}|=object,|
+% | framearound=object,frameset={\fboxrule1pt\fboxsep10pt},|
+% | framefit=no}%|$\approx\texttt{style=boxed}$
+% |\begin{figure}|
+% |\ffigbox[4cm]|
+% | {...}{\caption{...}}|
+% |\end{figure}|
+% \end{Quote}%
+% \floatsetup[figure]{framestyle=fbox,heightadjust=object,
+% framearound=object,frameset={\fboxrule1pt\fboxsep10pt},framefit=no}%^^A$\equiv\texttt{style=boxed}$
+% \begin{figure}[H]%
+% \ffigbox[4cm]
+% {\unitlength1.44\unitlength\input{Cat.picture}}{\caption[Рамка вокруг графики выступает за края]{Рамка вокруг содержимого
+% объекта выступает за края бокса \hbox{флота}}\label{fig:setup:boxed}}
+% \end{figure}%
+% \begin{Quote}\openup.5pt
+% |\floatsetup[figure]{...,framefit=yes}%|$\approx\texttt{style=Boxed}$
+% |\begin{figure}|%
+% |\ffigbox[4cm]|
+% | {...}{\caption{...}}|\nopagebreak
+% |\end{figure}|%
+% \end{Quote}%
+% \floatsetup[figure]{framestyle=fbox,heightadjust=object,
+% framearound=object,frameset={\fboxrule1pt\fboxsep10pt},framefit=yes}%%^^A$\equiv\texttt{style=Boxed}$
+% \begin{figure}[H]%
+% \ffigbox[4cm]
+% {\unitlength1.4\unitlength\input{Cat.picture}}{\caption[Ширина рамки равна ширине бокса]{Ширина рамки равна
+% ширине бокса (здесь: ширине подрисуночной подписи)}}
+% \end{figure}%
+% \endgroup
+%
+% \addvspace\medskipamount\noindent
+% \DescribeMacro{colorframeset}\label{setup:colorframeset}%^^A
+%^^A% Offered by \package{fr-fancy} package\footnote{Use
+%^^A% \texttt{fancyboxes=yes} option in \cmd{\usepackage} line.}: defines
+%^^A% concrete color box (default is standard |\fbox|).
+%^^A% In current version you may use only |\fcolorbox| as color box. You
+%^^A% may define your color box like
+% Ключ предлагается пакетом \package{fr-fancy}\footnote{Для его загрузки нужно задать
+% ключ \texttt{fancyboxes=yes} в~строке \cmd{\usepackage}, а~также необходимо
+% загрузить пакет \package{color}.}: определяет
+% цветную рамку (по умолчанию это команда |\fbox|).
+% Для цветной рамки используется
+% команда |\fcolorbox|.
+% Её можно определить следующим образом:
+% \par\RestoreSpaces
% \begin{quote}
% |colorframeset={\fcolorbox{white}{yellow}}|\quad.
% \end{quote}
%
-% \subsubsection{Определение отбивок}
+%^^A% \subsubsection{Defining Float Skips}
+% \subsubsection{Определение отбивок внутри флота}
%
-% \DescribeMacro{captionskip=}
-% Определяет размер вертикальной отбивки между подписью и объектом
+% \DescribeMacro{captionskip}\label{setup:captionskip}%^^A
+%^^A% Defines vertical space between caption and float object
+%^^A% in case of |midcode| key defined as |midcode=captionskip|;
+%^^A% or in case of usage of float styles (\texttt{style=}
+%^^A% key) \texttt{plain}, \texttt{plaintop} or \texttt{Plaintop}:
+% Определяет размер вертикальной отбивки между подписью и~объектом
% если ключ |midcode| определён как
-% |midcode=captionskip|; или в случае использования стилей (ключ \texttt{style=})
+% |midcode=captionskip|; или в~случае использования стилей (ключ \texttt{style=})
% \texttt{plain}, \texttt{plaintop} или \texttt{Plaintop}, пример:
-% \begin{quote}
+% \par\RestoreSpaces
+% \begin{Quote}
% |captionskip=10pt|\quad.
-% \end{quote}
-%
-% \noindent
-% \DescribeMacro{footskip=}
-% Определяет вертикальную отбивку до сносок и экспликаций.
-% \begin{quote}
+% \end{Quote}
+%^^A% The settings above are default.
+%^^A% The settings of current documentation: |captionskip=5pt|.
+% Установки отбивки выше используются по умолчанию.
+% Установки, используемые данной документацией: |captionskip=5pt|.
+%
+% \addvspace\medskipamount\noindent
+% \DescribeMacro{footskip}\label{setup:footskip}%^^A
+%^^A% Defines vertical space before foot material and footnotes.
+% Определяет вертикальную отбивку до сносок и~экспликаций.
+% \par\RestoreSpaces
+% \begin{Quote}
% |footskip=4pt|\quad,
-% \end{quote}
-% or
-% \begin{quote}
+% \end{Quote}
+% или
+% \begin{Quote}
% |footskip=\skip\footins|\quad.
-% \end{quote}
+% \end{Quote}
%
+%^^A% \subsubsection{Defining Float Footnote Rule's Style}
% \subsubsection{Задание стиля для линейки над сноской}\label{sec:footnotestyle}
%
-% \DescribeMacro{footnoterule=}
+% \DescribeMacro{footnoterule}\label{setup:footnoterule}%^^A
+%^^A% Defines type of footnote rule for footnotes inside float environment.
% Определяет тип линейки над сноской внутри бокса плавающего элемента.
+% \par\RestoreSpaces
% \begin{Options}{\OptionLabel}
% \item[normal]
-% стандартное определение \LaTeX'а, используемое в окружении
-% \env{minipage}, ширина её равна
-% 0.4 текущей ширины текста (|\columnwidth|);
+%^^A% standard \LaTeX{} definition, used in \env{minipage} environments, the
+%^^A% width of it equals to 0.4 of current with of text (|\columnwidth|);
+% стандартное определение \LaTeX'а,
+% ширина линейки составляет
+% 0.4 от ширины текста (|\columnwidth|);
% \item[limited]
+%^^A% like previous one but max width of footnote rule equals to the value
+%^^A% defined by |\frulemax| command, like:
% аналогична предыдущей, но максимальная ширина сноски равна
-% величине определённой в
-% команде |\frulemax|, следующим образом:
+% величине определённой
+% в~команде |\frulemax|:
% \begin{quote}
% |\renewcommand\frulemax{1in}|
% \end{quote}
% \item[fullsize]
+%^^A% rule to full current text width.
% линейка на всю ширину текста.
% \item[none]
+%^^A% Absent rule.
% нет линейки.
+% \item[...]
+%^^A% You may create your own options with |\DeclareFloatFootnoterule| command,
+%^^A% see page~\pageref{ssec:fnoterule}.
+% Вы можете создать собственные настройки с~помощью команды~|\DeclareFloatFootnoterule|,
+% см.~с.~\pageref{ssec:fnoterule}.
% \end{Options}
%
% \label{setup:end}
%
% %^^A ???needed?
+%^^A% \subsubsection{Loading Style for Fancy Boxes}
% \subsubsection{Загрузка пакета для необычных рамок}
%
-% \DescribeMacro{fancyboxes=}
+% \DescribeMacro{fancyboxes}\label{setup:fancyboxes}%^^A
+%^^A% This boolean key loads \package{fr-fancy} package. This key you may use
+%^^A% only in optional argument in |\usepackage| line.
% Переключатель (работает как булев параметр) загружает пакет
-% \pkg{fr-fancy}. Этот ключ можно использовать
-% только в дополнительном аргументе строки |\usepackage|.
+% \package{fr-fancy}. Этот ключ можно использовать
+% только в~опции строки |\usepackage|.
+%
+% \RestoreSpaces
+%^^A% \subsubsection{Managing Floats with \texttt{[H]} placement option}
+% \subsubsection{Управление флотами с~опцией~\texttt{[H]}}
+%
+% \DescribeMacro{doublefloataswide}\label{setup:doublefloataswide}%^^A
+%^^A% This boolean key redefines starred float in onecolumn layout
+%^^A% like non-starred ones. (In this case the \texttt{[H]} option works
+%^^A% in starred environments also; layout settings from |\floatsetup|
+%^^A% as \texttt{widefloat} are not cancelled.)
+% Данный переключатель делает \LaTeX'овское поведение «звёздных»
+% окружений флотов в~одноколонном макете аналогичным «незвёздным».
+% (В~этом случае опция \texttt{[H]} может действовать и~на «звёздные» окружения; при
+% этом действие опций оформления|\floatsetup| типа \texttt{widefloat} не отменяется.)
%
+% \medskip\noindent
+% \DescribeMacro{floatHaslist}%^^A
+%^^A% This boolean key adds values of penalties before and after
+%^^A% this ``anchored'' float like in the list environment and cancels
+%^^A% paragraph indentation, if no blank line appears after environment
+%^^A% (see also section~\pageref{sec:listpen}).
+% Данный переключатель значения штрафов (penalties) до и~после
+% флотов «на якоре» равные штрафам в~окружениях перечней и~отменяет
+% абзацный отступ, если после окружения флота нет пустой строки
+% (см.~также {\sectionname}~\pageref{sec:listpen}).
+%
+% \RestoreSpaces
+%^^A% \subsection{Settings for Current Float Environment}
% \subsection{Настройки для одного флота}
%
-% \DescribeMacro{\thisfloatsetup}\label{thisfloatsetup}%^^A
-% Вы можете задать некоторые настройки только для одного флота
-% перед необходимым окружением. Команда |\thisfloatsetup| может
-% включать в себя те же ключи и опции как и |\floatsetup|. Она содержит
+% \DescribeMacro{\thisfloatsetup}\label{thisfloatsetup}\label{setup:thisfloatsetup}%^^A
+%^^A% You may define some settings only for one float just
+%^^A% before necessary environment. Command |\thisfloatsetup| could
+%^^A% contain the same keys and options as in |\floatsetup|. It has
+%^^A% only mandatory argument\footnote{The \cmd{\thisfloatsetup} defined
+%^^A% as abbreviation of \cmd{\floatsetup[tmpset]} command.}.\par\strut
+%^^A% \par\kern-\baselineskip
+% Можно задать некоторые настройки только для одного флота
+% перед необходимым окружением. Команда |\thisfloatsetup|
+% включает в~себя те же ключи и~опции, что и~|\floatsetup|, но использует
% только обязательный аргумент\footnote{Команда \cmd{\thisfloatsetup} определена
% как аббревиатура \cmd{\floatsetup[tmpset]}.}.\par\strut\par\kern-\baselineskip
%
@@ -1171,26 +3383,75 @@
%^^A keys \texttt{captionwidth=}
%^^A \texttt{floatwidth} do not used usually in |\floatsetup| stuff.
%
-% \subsection{<<Очистка>> предыдущих настроек для определённого
+% \RestoreSpaces
+%^^A% \subsection{Clearing of Previous Float Type Settings}
+% \subsection{Отмена настроек для определённого
% типа плавающих объектов}
%
-% \DescribeMacro{\clearfloatsetup}
+% \DescribeMacro{\clearfloatsetup}\label{setup:clearfloatsetup}%^^A
+%^^A% If you want to get rid of parameters marked
+%^^A% for an automatic use within a particular environment
+%^^A% you can use the command\footnote{See also documentation
+%^^A% of \package{caption} package about \cmd{\clearcaptionsetup} command}:
% Если вы хотите отменить параметры, определённые для
-% использования в определённом окружении
-% вы можете использовать команду\footnote{См. также в документации пакета
-% \pkg{caption} о команду \cmd{\clearcaptionsetup}}:
+% использования в~окружении определённого типа
+% вы можете использовать команду\footnote{Сделана как «сопровождение»
+% команде \cs{clearcaptionsetup}, см.~также документацию пакета
+% \package{caption} о~команду \cmd{\clearcaptionsetup}}:
+% \par\RestoreSpaces
% \begin{quote}
-% |\clearfloatsetup|\marg{Typ}\quad.
+% |\clearfloatsetup|\marg{float type}\quad.
% \end{quote}
+%^^A% where \marg{float type}---types as \texttt{figure}, \texttt{widefloat} etc.
+% где \marg{float type} \cdash--- тип флота, например, \texttt{figure},
+% \texttt{widefloat} и~т.\,д.
%
% %^^A !!!for footnotes!
% %^^A \newpage
%
+%^^A% \subsection{Temporary Clearing of All Float Settings}\label{page:killfloatstyle}
+% \subsection{Временная очистка всех установок для флотов}\label{page:killfloatstyle}
+%
+% \DescribeMacro{\killfloatstyle}\label{setup:killfloatstyle}%^^A
+%^^A% In some cases like mixed rows of floats where figure stays beside table
+%^^A% you need to cancel layout of ``foreign'' float (see page~\pageref{mixrow}).
+%^^A% The |\killfloatstyle| command is used before any
+%^^A% command of |\floatbox| stuff (see {\sectionname}~\ref{sec:floatbox}).
+%^^A% This command will be useful for layout with beside captions in the cases
+%^^A% of usage of quite different styles for, e.g. |[figure]| option of
+%^^A% floatsetup with \texttt{style=plain} and
+%^^A% |[cabesidefigure]| with \texttt{style=boxed}.
+%^^A% In this case you may define your command, based on predefined
+%^^A% |\fcapside|:
+% Первый случай, когда нужна эта команда \cdash--- рисунок нужно поместить рядом с~таблицей
+% и~нужно отключить настройки «чужого» флота (см.с.~\pageref{mixrow}).
+% Команда |\killfloatstyle| используется до
+% команды, созданной на базе |\floatbox|, (см.~{\sectionname}~\ref{sec:floatbox}).
+% Другой случай \cdash--- макет флота с~подписями сбоку
+% имеет сильно отличающиеся настройки от других подтипов: опция |[figure]|
+% команды |\floatsetup| задана как \texttt{style=plain},
+% а~|[cabesidefigure]| \cdash--- как \texttt{style=boxed}.
+% Для~этих случаев можно определить новую команду, например, на основе
+% |\fcapside|:
+% \par\RestoreSpaces
+% \begin{quote}
+% |\newcommand\myfcapside{\killfloatstyle|\\
+% | \floatsetup[figure]{style=Boxed}\fcapside}|\quad.
+% \end{quote}
+% Опция |[figure]| необходима, если определены установки с~такой опцией
+% в~преамбуле.
+%
+% %^^A !!!for footnotes!
+% %^^A \newpage
+%
+%^^A% \subsection{The Default Float Type Settings}\label{sec:default}
% \subsection{Установки для флотов заданные по умолчанию}\label{sec:default}
%
-% Следующие ключи и опции включаются, при загрузке пакета \pkg{floatrow}.
+%^^A% The following keys and options are switched on when \package{floatrow}
+%^^A% package loaded. They equal to \texttt{plain} style:
+% Следующие ключи и~опции включаются, при загрузке пакета \package{floatrow}.
% Они эквивалентны стилю \texttt{plain}:
-% \begin{Options}{\OptionLabel}
+% \begin{Options}{\OptionLabel}\openup-.5pt
% \item[font=normalsize]
% \item[footfont=footnotesize]
% \item[capposition=bottom]
@@ -1211,30 +3472,36 @@
% \item[captionskip=10pt]
% \end{Options}
%
+%^^A% \subsection{Defining new options}
+% \subsection{Определение новых опций (Делаем сами!)}
%
-% \subsection{Определение новых опций}
+%^^A% In the next few sections goes a small list of commands, which
+%^^A% define key options for |\floatsetup|.
+% В~следующих разделах перечисляются команды, которые определяют опции
+% ключей команды |\floatsetup|.
%
-% В следующих разделах перечисляются команды, которые определяют опции
-% ключей команды |\floatsetup|. Примеры опций взяты, как правило,
-% из определений опций пакета \pkg{floatrow}.
+%^^A% \subsubsection{Float Style (\texttt{style=})}\label{ssec:declstyle}
+% \subsubsection{Опция стиля флота (\texttt{style=})}\label{ssec:declstyle}
%
-% \subsubsection{Стиль флота}
-%
-% \DescribeMacro{\DeclareFloatStyle}
+% \DescribeMacro{\DeclareFloatStyle}\label{setup:DeclareFloatStyle}%^^A
+%^^A% Defines new float style. Example shows definition of new float
+%^^A% style \texttt{MyBoxed}. The figures~\ref{fig:plain:MyBoxed}, and
+%^^A% some others in current documentation show result.
% Определяет новый стиль. Пример демонстрирует задание нового стиля
-% \texttt{MyBoxed}. Рисунок~\ref{fig:plain:MyBoxed}, и
-% некоторые другие в данной документации показывают результат.
-%\begin{verbatim}
-%\DeclareFloatStyle{MyBoxed}{style=Boxed,captionskip=5pt,
-% frameset={\fboxrule1pt\fboxsep12pt}}
-%\floatsetup[figure]{style=MyBoxed}
-%\end{verbatim}
+% \texttt{MyBoxed}. Рисунок~\ref{fig:plain:MyBoxed},
+% и~некоторые другие в~данной документации демонстрируют результат.
+% \par\RestoreSpaces
+%\begin{Quote}
+%|\DeclareFloatStyle{MyBoxed}{|\hyperref[setup:style]{style}|=Boxed,|\hyperref[setup:captionskip]{captionskip}|=5pt,|
+%| |\hyperref[setup:frameset]{frameset}|={\fboxrule1pt\fboxsep12pt}}|
+%|\floatsetup[figure]{style=MyBoxed}|
+%\end{Quote}
%
% \begingroup
%
% \floatsetup[figure]{style=MyBoxed}
-% \begin{figure}[!t]
-% {\input{BlackCat.picture}}%
+% \begin{figure}[H]
+% {\unitlength1.44\unitlength\input{Horse.picture}}%
% \caption{%^^A
% Простой рисунок в стиле \texttt{MyBoxed}}%
% \label{fig:plain:MyBoxed}%
@@ -1242,199 +3509,440 @@
% more and more text inside macro \cmd{\floatfoot}}%
% \end{figure}
%
+%^^A% The same result you get with:
% Тот же результат вы можете получить:
-%\begin{verbatim}
-%\floatsetup[figure]{style=Boxed,captionskip=5pt,
-% frameset={\fboxsep12pt\fboxrule1pt}}
-%\end{verbatim}
+% \par\RestoreSpaces
+%\begin{Quote}\openup-.65pt
+%|\floatsetup[figure]{style=Boxed,captionskip=5pt,|
+%| frameset={\fboxsep12pt\fboxrule1pt}}|
+%\end{Quote}
% \endgroup
%
-% \subsubsection{Определение новых линеек или отбивок}\label{ssec:decl:rule}
+%^^A% \subsubsection{Defining Float Rules/Skips}\label{ssec:decl:rule}
+% \subsubsection{Опция задания линеек или отбивок (\texttt{precode=} и~др.)}
+% \label{ssec:decl:rule}
%
-% \DescribeMacro{\DeclareFloatVCode}
+% \DescribeMacro{\DeclareFloatVCode}\label{setup:DeclareFloatVCode}%^^A
+%^^A% This command defines the skip, rule or other analogous code above
+%^^A% and below full float box and between caption above/below and
+%^^A% object. The defined option you may use in \texttt{rowprecode},
+%^^A% \texttt{precode}, \texttt{midcode}, \texttt{postcode}, and
+%^^A% \texttt{rowpostcode} keys.
% Эта команда создаёт определение отбивки, линейки или другого подобного материала
-% сверху и снизу всего бокса объект---подпись и между
-% подписью сверху/снизу и объектом.
-% Созданную опцию вы можете использовать в ключах \texttt{rowprecode},
-% \texttt{precode}, \texttt{midcode}, \texttt{postcode} и
-% \texttt{rowpostcode}.
-% \begin{quote}
-% |\DeclareFloatVCode{thickrule}{\hrule height.8ptdepth0pt%|\\
-% \strut\qquad|\kern2pt}|
-% \end{quote}
+% сверху и~снизу всего бокса объект---подпись и~между
+% подписью сверху/снизу и~объектом.
+% Созданную опцию вы можете использовать в~ключах \texttt{rowprecode},
+% \texttt{precode}, \texttt{midcode}, \texttt{postcode}
+% и~\texttt{rowpostcode}.
+% \par\RestoreSpaces
+% \begin{Quote}\openup.5pt
+% \meta{preamble}
+% |\DeclareFloatVCode{grayruleabove}%|
+% | {{\color{gray}\hrule height2.8ptdepth0pt\vskip4pt}}|
+% |\DeclareFloatVCode{grayrulebelow}%|
+% | {{\color{gray}\vskip4pt\hrule height2.8ptdepth0pt}}|
+% |\floatsetup{...,|
+% | |\hyperref[setup:rowprecode]{rowprecode}|=grayruleabove,|%^^A
+% \hyperref[setup:rowpostcode]{rowpostcode}|=grayrulebelow}|
+% \meta{preamble}
+% |\begin{figure}|
+% |\begin{floatrow}|
+% | \ffigbox|
+% | {...}{\caption{The left ...}\label{...}}%|
+%| |
+% | \ffigbox|\nopagebreak
+% | {...}{\caption{The beside ...}\label{...}}|
+% | \end{floatrow}|\nopagebreak
+% |\end{figure}|
+%| |
+%| |
+% |\begin{figure}|
+% | ...|
+% | \caption{The figure ...}\label{...}%|
+% |\end{figure}|
+% \end{Quote}
+% \begin{figure}[H]\floatsetup{heightadjust=object,valign=c,rowprecode=grayruleabove,
+% rowpostcode=grayrulebelow}\killfloatstyle
+% \begin{floatrow}
+% \ffigbox
+% {\unitlength.65\unitlength\input{BlackCat.picture}}
+% {\caption{Левый рисунок в~ряду с~заданными линейками сверху и~снизу, заданными для ряда}%
+% \label{intro:leftfig:row}}%
+%
+% \ffigbox
+% {\caption{Правый рисунок в~ряду с~заданными линейками сверху и~снизу, заданными для ряда}%^^A
+% \label{intro:rightfig:row}}
+% {\unitlength.85\unitlength\input{Cat.picture}}
+% \end{floatrow}
+% \end{figure}%^^A
+% \begin{figure}[H]\floatsetup{heightadjust=object,valign=c,rowprecode=grayruleabove,
+% rowpostcode=grayrulebelow}\killfloatstyle
+% \ffigbox
+% {\caption{Отдельный рисунок с~линейками сверху и~снизу, заданными для ряда}%^^A
+% \label{intro:alone:row}}
+% {\unitlength.85\unitlength\input{TheCat.picture}}
+% \end{figure}%^^A
+% \begin{Quote}\openup-.65pt
+% \meta{preamble}\nopagebreak
+% |...|\nopagebreak
+% |\floatsetup{...,|\hyperref[setup:precode]{precode}|=grayruleabove,|
+% | |\hyperref[setup:postcode]{postcode}|=grayrulebelow}|
+% \meta{preamble}
+% |...|
+% \end{Quote}
+% \begin{figure}[H]\floatsetup{heightadjust=object,valign=c,
+% precode=grayruleabove,postcode=grayrulebelow}\killfloatstyle
+% \begin{floatrow}
+% \ffigbox
+% {\unitlength.65\unitlength\input{BlackCat.picture}}
+% {\caption{Левый рисунок в~ряду с~линейками сверху и~снизу рисунка, заданными для бокса флота}%
+% \label{intro:leftfig:box}}%
+%
+% \ffigbox
+% {\caption{Правый рисунок в~ряду с~линейками сверху и~снизу рисунка, заданными для бокса флота}%^^A
+% \label{intro:rightfig:box}}
+% {\unitlength.85\unitlength\input{Cat.picture}}
+% \end{floatrow}%
+% \end{figure}\kern-\lastskip%^^A
+% \begin{figure}[H]\floatsetup{heightadjust=object,valign=c,
+% precode=grayruleabove,postcode=grayrulebelow}\killfloatstyle
+% \ffigbox
+% {\caption{Отдельный рисунок с~линейками сверху и~снизу рисунка, заданными для бокса флота}%^^A
+% \label{intro:alone:box}}
+% {\unitlength.85\unitlength\input{TheCat.picture}}
+% \end{figure}%^^A
%
-% \subsubsection{Определение выключки содержимого объекта}\label{ssec:decl:marg}
+% \RestoreSpaces
+%^^A% \subsubsection{Object Justification Option (\texttt{objectset=})}\label{ssec:decl:oset}
+% \subsubsection{Опция выключки содержимого объекта (\texttt{objectset=})}
+% \label{ssec:decl:oset}
%
-% \DescribeMacro{\DeclareObjectSet}
+% \DescribeMacro{\DeclareObjectSet}\label{setup:DeclareObjectSet}%^^A
+%^^A% You may define justification for \texttt{objectset=} key like\nopagebreak:
% Вы можете определить свою опцию выключки для ключа \texttt{objectset=}
-% следующим образом:
-% \begin{quote}
+% так:
+% \par\RestoreSpaces
+% \begin{Quote}
% |\DeclareObjectSet{centering}{\centering}|
-% \end{quote}
-% В определении опции вы можете попробовать задать и другие повторяющие команды,
+% \end{Quote}
+%^^A% In option's definition you may try to include any regular commands
+%^^A% which you need to put before each object contents in float
+%^^A% environment\footnote{You may also use key options declared by
+%^^A% \cmd{\DeclareCaptionJustification} command of \package{caption} package
+%^^A% as options for \texttt{objectset=} key.}.\par
+%^^A% \strut\par\kern-\baselineskip
+% В~определении опции вы можете попробовать задать и~другие повторяющие команды,
% которые вам нужны при оформлении содержимого
% объекта\footnote{Вы можете использовать
% опции ключей, заданные \cmd{\DeclareCaptionJustification} "---
-% командой из пакета \pkg{caption},
+% командой из пакета \package{caption},
% как опции ключа \texttt{objectset=}.}.\par\strut\par\kern-\baselineskip
%
-% \subsubsection{Определение выключки (и другого материала)
-% для всего бокса флота}\label{ssec:decl:marg}
+%^^A% \subsubsection{Option for Float Box Alignment/Settings (\texttt{margins=})}
+% \subsubsection{Определение выключки/настроек
+% для бокса флота (\texttt{margins=})}\label{ssec:decl:marg}
%
-% \DescribeMacro{\DeclareMarginSet}\label{fsetup:besmarg}%^^A
+% \DescribeMacro{\DeclareMarginSet}\label{setup:DeclareMarginSet}%^^A
+%^^A% You may define box alignment for float box (\texttt{margins=} key) like:
% Вы можете определить выключку всего бокса (ключ \texttt{margins=})
-% следующим образом:
-% \begin{quote}
-% |\DeclareMarginSet{center}{%|\\
+% так:
+% \par\RestoreSpaces
+% \begin{Quote}
+% |\DeclareMarginSet{center}{%|
% | \setfloatmargins{\hfil}{\hfil}}|
-% \end{quote}
+% \end{Quote}
+%^^A% or like (see also sample files)
% или (см. также файлы примеров);
-% \begin{quote}
-% |\DeclareMarginSet{outside}{%|\\
+% \begin{Quote}
+% |\DeclareMarginSet{outside}{%|
% | \setfloatmargins*{\hfil}{}}|
-% \end{quote}
+% \end{Quote}
%
+%^^A% Non-starred form of |\setfloatmargins| defines left and right
+%^^A% margin.
% Команда |\setfloatmargins| определяет левое и правое поля.
% \begin{quote}
% |\setfloatmargins{|\meta{left margin}|}{|\meta{right margin}|}|
% \end{quote}
%
-% |*|-форма команды, |\setfloatmargins*|, определяет оформление
-% для разворота: внутреннее и внешнее поля.
+%^^A% Starred form, |\setfloatmargins*|, defines facing layout: inside and
+%^^A% outside margin.
+% «Звёздная» форма команды, |\setfloatmargins*|, определяет оформление
+% для разворота: внутреннее и~внешнее поля.
% \begin{quote}
% |\setfloatmargins*{|\meta{inside margin}|}{|\meta{outside margin}|}|
% \end{quote}
%
+%^^A% You may set even much more complex definition:
% Вы можете сделать ещё более сложное определение:
-% \begin{quote}\leftmargin0pt
+% \begin{Quote}\leftmargin0pt
% |\DeclareObjectSet{facingrule}{%|
-% |\setfloatmargins*{%|\\
-% | \floatfacing{\hskip-12pt\vrule width4pt\hskip8pt\hfill}%|\\
+% |\setfloatmargins*{%|
+% | \floatfacing{\hskip-12pt\vrule width4pt\hskip8pt\hfill}%|
% | {\hfill\hskip8pt\vrule width4pt\hskip-12pt}}{}}|
-% \end{quote}
+% \end{Quote}
+%^^A% the |\floatfacing| defines following
% Команда |\floatfacing| определяет следующее
% \begin{quote}
% |\floatfacing{|\meta{odd page definition}|}{|\meta{even page definition}|}|
% \end{quote}
-% Эта макрокоманда также имеет |*|-форму |\floatfacing*|,
-% которой вы можете воспользоваться в опциях ключей для команды |\captionsetup|.
+%^^A% This macro has also starred form |\floatfacing*|,
+%^^A% which you can use in key options for |\captionsetup| stuff.
+% Эта макрокоманда также имеет «звёздную» форму |\floatfacing*|,
+% которой вы можете воспользоваться в~опциях ключей для команды |\captionsetup|.
%
+%^^A% The |\setfloatmargins| consists of three macros which set margins
+%^^A% for three main variants of float positions:
% Команда |\setfloatmargins| состоит из трёх макрокоманд, которые определяют
-% поля (выключку и другой материал) для трёх вариантов расположения флота:
+% поля (выключку и~другой материал) для трёх вариантов расположения флота:
% \begin{Options}{\OptionLabel}
+%^^A% \item[\cmd{\floatboxmargins}]sets left/right margins around alone
+%^^A% float box;
% \item[\cmd{\floatboxmargins}]задаёт левое/правое поля для отдельного флота;
+%^^A% \item[\cmd{\floatrowmargins}]sets left/right margins around
+%^^A% \env{floatrow} environment;
% \item[\cmd{\floatrowmargins}]задаёт левое/правое поля для
-% флотов рядом в окружении \env{floatrow};
+% флотов рядом в~окружении \env{floatrow};
+%^^A% \item[\cmd{\floatcapbesidemargins}]sets left/right margins around
+%^^A% alone float box with beside caption.
% \item[\cmd{\floatcapbesidemargins}]задаёт левое/правое
-% поля для отдельного флота с подписью сбоку.
+% поля для отдельного флота с~подписью сбоку.
% \end{Options}
-% Грамматика использования этих трёх команд такая же как и у
-% |\setfloatmargins|. Настройки, использующие команду |\floatfacing|
+%^^A% The grammar for using three mentioned commands is similar to
+%^^A% |\setfloatmargins|. The settings which use |\floatfacing| command
+%^^A% work only in the case when key \texttt{facing=yes} used.
+% Грамматика использования этих трёх команд такая же как
+% и~у~|\setfloatmargins|. Настройки, использующие команду |\floatfacing|
% будут работать если включён ключ \texttt{facing=yes}.
%
-% \emph{Замечание}. Пакет \pkg{floatrow} задаёт некоторые настройки
+%^^A% \emph{Notes}. 1)\enskip The \package{floatrow} expands some settings of table layout
+%^^A% to the \env{longtable} environment, so you may set |\LTleft| and
+%^^A% |\LTright| parameters inside |\setfloatmargins| command. For example,
+%^^A% \texttt{centering} option was defined like:
+% \emph{Замечания}. 1)\enskip Пакет \package{floatrow} задаёт некоторые настройки
% оформления таблиц для окружения \env{longtable},
-% поэтому вы можете задать параметры |\LTleft| и |\LTright|
-% в команде |\DeclareMarginSet|.
+% поэтому вы можете задать параметры |\LTleft| и~|\LTright|
+% в~команде |\DeclareMarginSet|.
% Например, опция \texttt{centering} была определена следующим образом:
% \begin{quote}
% |\DeclareMarginSet{centering}{\setfloatmargins{\hfill}{\hfill}%|\\
% | \LTleft=\fill \LTright=\fill}|
% \end{quote}
-%
-% \subsubsection{Определение разделителей флотов}
-%
-% \DescribeMacro{\DeclareFloatSeparators}\label{decl:sep}%^^A
-% Вы можете определить разделитель между флотами рядом (в окружении \env{floatrow})
-% или между флотом и подписью сбоку, пример разделителя:
-% \begin{quote}
+%^^A% 2)\enskip The font settings loaded in |\floatsetup|
+%^^A% in \env{longtable} environment expand to captions.
+%^^A% In this case, when you write something like
+% 2)\enskip Установки шрифта, заданные в~команде~|\floatsetup|
+% в~окружении \env{longtable} распространяются и~на подписи.
+% В~этом случае, когда вы задаёте, что-то типа
+% \begin{Quote}
+% |\floatsetup{font={sf,scriptsize,it}...|
+% \end{Quote}
+% или
+% \begin{Quote}
+% |\floatsetup[longtable]{font={sf,scriptsize,it}...|
+% \end{Quote}
+%^^A% for floats (or for [long]tables only), you ought to restore correct
+%^^A% font size, family, shape (here) and series for caption contents and write\footnote
+%^^A% {The version 3.1 of \package{caption} package will correct that.}:
+% для объектов (или только в~опции [longtable] команды~|\floatsetup|),
+% нужно вернуть нужные
+% размер, семейство, начертание (в~данном случае) и~насыщенность шрифта, хотя бы так\footnote
+% {Версия 3.1 пакета \package{caption} это исправляет.}:
+% \begin{Quote}
+% |\captionsetup{font={rm,small,up}...|
+% \end{Quote}
+% или
+% \begin{Quote}
+% |\captionsetup[longtable]{font={rm,small,up}...|
+% \end{Quote}
+%
+%^^A% \subsubsection{Float Separators Options (\texttt{floatrowsep=}, \texttt{capbesidesep=})}
+% \subsubsection{Опции разделителей флотов (\texttt{floatrowsep=}, \texttt{capbesidesep=})}
+%
+% \DescribeMacro{\DeclareFloatSeparators}\label{setup:DeclareFloatSeparators}%^^A
+%^^A% You may to define separator
+%^^A% between float boxes, or float object and beside caption, for example:
+% Вы можете определить разделитель между флотами рядом (в~окружении \env{floatrow})
+% или между флотом и~подписью сбоку, пример разделителя:
+% \par\RestoreSpaces
+% \begin{Quote}
% |\DeclareFloatSeparators{columnsep}{\hskip\columnsep}|
-% \end{quote}
-% или более сложный, с использованием пакета \pkg{color} и
-% макрокоманды |\floatfacing|
+% \end{Quote}
+%^^A% or more complex, using \package{color} package, and |\floatfacing| macro
+%^^A% (do not forget the \texttt{facing=yes} key):
+% или более сложный, с~использованием пакета \package{color}
+% и~макрокоманды |\floatfacing|
% (не забудьте также ключ \texttt{facing=yes}):
-% \begin{quote}
-% |\DeclareFloatSeparators{colorsep}%|\\
-% | {\begingroup\color{blue}%|\\
-% | \floatfacing{\hskip14pt\vrule width1.8pt\hskip2pt}%|\\
-% | {\hskip2pt\vrule width1.8pt\hskip14pt}%|\\
-% | \endgroup}|
-% \end{quote}
-%
-% Вы можете использовать заданные опции в ключах \texttt{floatrowsep=} и
-% \texttt{capbesidesep=}\footnote{Вы можете воспользоваться опциями, заданными
-% \cmd{\DeclareCaptionLabelSeparator} "--- командой из \pkg{caption}.}.\par
+%^^A% You may use defined option by both \texttt{floatrowsep=} and
+%^^A% \texttt{capbesidesep=} keys\footnote{You may use key options declared
+%^^A% by \cmd{\DeclareCaptionLabelSeparator} command.}.\par\strut\par
+%^^A% \kern-\baselineskip
+% Вы можете использовать заданные опции в~ключах \texttt{floatrowsep=}
+% и~\texttt{capbesidesep=}\footnote{Вы можете воспользоваться опциями, заданными
+% \cmd{\DeclareCaptionLabelSeparator} "--- командой из \package{caption}.}.\par
% \strut\par\kern-\baselineskip
%
-% \subsubsection{Шрифт содержимого объекта}
+% \begin{Quote}
+% \meta{preamble}
+% |\DeclareObjectSet{colorred}{\parskip2pt\parindent15pt\color{red}}|
+% |\DeclareMarginSet{hangleft}%|
+% | {\setfloatmargins|
+% | {\hskip-\marginparwidth\hskip-\marginparsep}{\hfil}}|
+% |\DeclareFloatSeparators{colorsep}%|
+% | {\begingroup\color{blue}%|
+% | \floatfacing{\hskip6pt\vrule width4.8pt\hskip6pt}%|
+% | {\hskip6pt\vrule width4.8pt\hskip6pt}%|
+% | \endgroup}|
+% |\floatsetup[|\hyperref[setup:widefigure]{\texttt{widefigure}}|]{|%^^A
+% \hyperref[setup:margins]{\texttt{margins}}|=hangleft,|%^^A
+% \hyperref[setup:capbesidesep]{\texttt{capbesidesep}}|=colorsep,|
+% \hyperref[setup:objectset]{\texttt{objextset}}|=colorred,|
+% | |\hyperref[setup:floatwidth]{\texttt{floatwidth}}|=\textwidth,|%^^A
+% \hyperref[setup:facing]{\texttt{facing}}|=yes}|
+% |\captionsetup[figure]{justification=justified,|
+% | labelfont={magenta,bf},textfont=green,labelsep=newline}|
+% \meta{preamble}
+% |\begin{figure*}|\nopagebreak
+% |...|\nopagebreak
+% |\end{figure*}|
+% \end{Quote}
+% \begingroup
+% \floatsetup[widefigure]{margins=hangleft,capbesidesep=colorsep,objectset=colorred,
+% floatwidth=\textwidth,facing=yes,capposition=beside,capbesideposition=left}
+% \captionsetup[figure]{justification=justified,
+% labelfont={magenta,bf},textfont=green,labelsep=newline}
+% \begin{figure*}[H]%
+% {\TEXTBOX}{\caption[Разноцветные рисунок и~подпись сбоку]{Разноцветные рисунок и~подпись. And A bit more text, and some more text}}
+% \end{figure*}%
+% \endgroup
+%
+%^^A% \subsubsection{Float font}\label{ssec:declfont}
+% \subsubsection{Опция шрифта содержимого объекта (\texttt{font=})}\label{ssec:declfont}
%
-% \DescribeMacro{\DeclareFloatFont}
+% \DescribeMacro{\DeclareFloatFont}\label{setup:DeclareFloatFont}%^^A
+%^^A% With this macro you may define new option
+%^^A% for font (\texttt{font=} key) of float contents. This macro works
+%^^A% like |\DeclareCaptionFont| in \package{caption} package. (You may also
+%^^A% use key options declared by |\DeclareCaptionFont| command.)\par
% Этой макрокомандой вы можете определить новую опцию
% для шрифта (ключ \texttt{font=}) содержимого объекта. Эта макрокоманда работает
-% также как |\DeclareCaptionFont| из пакета \pkg{caption}. (Вы можете также
-% воспользоваться опциями, заданными в команде |\DeclareCaptionFont|.)
-%
-% \subsubsection{Определение линейки для сносок}
-%
-% \DescribeMacro{\DeclareFloatFootnoterule}
+% также как |\DeclareCaptionFont| из пакета \package{caption}. (Вы можете также
+% воспользоваться опциями, заданными в~команде |\DeclareCaptionFont|.)
+%
+%^^A% To get red color for text in the example above, you may define the red color by following way:
+% Чтобы получить текст красного цвета в~примере выше, определите красный цвет:
+% \begin{Quote}%
+% |\DeclareFloatFont{red}{\color{red}}|
+% \end{Quote}%
+% а~затем задайте его в~команде |\floatsetup|
+% \begin{Quote}%
+% |\floatsetup[figure]{font={small,red},...}|\quad.
+% \end{Quote}%
+%
+% \RestoreSpaces
+%^^A% \subsubsection{Option for Float Footnote Rule's Style}\label{ssec:fnoterule}
+% \subsubsection{Опция линейки для сносок (\texttt{footnoterule=})}\label{ssec:fnoterule}
+%
+% \DescribeMacro{\DeclareFloatFootnoterule}\label{setup:DeclareFloatFootnoterule}%^^A
+%^^A% You may define new footnoterule (\texttt{footnoterule=} key) like:
% Вы можете определить новую линейку для сноски (ключ \texttt{footnoterule=})
% следующим образом:
-% \begin{quote}
-% |\DeclareFloatFootnoterule{fullsize}{%|\\
-% | \kern-3\p@|\\
-% | \hrule \@width\hsize\kern 2.6\p@}|
-% \end{quote}
+% \par\RestoreSpaces
+% \begin{Quote}
+% |\DeclareFloatFootnoterule{limited}{\kern-3pt|
+% | \@tempdima.4\columnwidth|
+% | \ifdim\@tempdima>\frulemax\@tempdima=\frulemax\fi|
+% | \hrule width\@tempdima\kern2.6pt}|
+% \end{Quote}
+%^^A% Remember, that summary vertical height for footnote rule must be
+%^^A% equal to~0pt.
% Помните, что суммарный вертикальный пробел для линейки должен составлять~0pt.
-%\newpage
-% \section{Создание нового типа плавающих объектов (флотов)}
%
-% \DescribeMacro{\DeclareNewFloatType}
+%\clearpage
+%^^A% \section{Creation of New Float Type}\label{sec:newfloat}
+% \section{Создание нового типа плавающих объектов (флотов)}\label{sec:newfloat}
+%
+% \DescribeMacro{\DeclareNewFloatType}\label{setup:DeclareNewFloatType}%^^A
+%^^A% For creation of new float type there was created
+%^^A% |\DeclareNewFloatType|\label{FAD:newfloattype}
+%^^A% command which also uses
+%^^A% \meta{key}${}=\nobreak {}$\meta{value} mechanism:
% Для создания нового типа флотов создана команда
-% |\DeclareNewFloatType|, которая также использует механизм
+% |\DeclareNewFloatType|\label{FAD:newfloattype},
+% которая также использует механизм
% \meta{key}${}=\nobreak {}$\meta{value}:
+% \par\RestoreSpaces
% \begin{quote}
% |\DeclareNewFloatType{|\meta{type}|}{|\meta{options}|}|
% \end{quote}
+%^^A% The \meta{type} argument includes the new float environment name.\\
+%^^A% The \meta{options} could include following keys:
% Аргумент \meta{type} включает имя нового окружения флота.\\
% Аргумент \meta{options} может включать следующие ключи:
%
% \noindent
-% \DescribeMacro{placement=}
+% \DescribeMacro{placement}\label{setup:placement}%^^A
+%^^A% The option of this key could have any combination of letters
+%^^A% \texttt{t}, \texttt{b}, \texttt{h}, and \texttt{p}, which
+%^^A% define placement of current float type on the page in
+%^^A% the case float environment has no any option argument.
+%^^A% (As default is declared \texttt{placement=tbp}.)
% (размещение) опцией этого ключа может быть любая комбинация букв
-% \texttt{t}, \texttt{b}, \texttt{h}, и \texttt{p}, которые
+% \texttt{t}, \texttt{b}, \texttt{h}, и~\texttt{p}, которые
% определяют размещение данного типа флотов на странице
-% в случае, если не используется дополнительный аргумент в окружении.
+% в~случае, если не используется дополнительный аргумент в~окружении.
% (По умолчанию определено \texttt{placement=tbp}.)
%
% \noindent
-% \DescribeMacro{name=}
-% Определяет имя флота в нумерационном заголовке подписи.
+% \DescribeMacro{name}\label{setup:name}%^^A
+%^^A% Defines the name of environment in the caption
+%^^A% label. (As default for caption label is declared the
+%^^A% name of environment.)
+% Определяет имя флота в~нумерационном заголовке подписи.
% (По умолчанию для нумерационного заголовка используется имя окружения.)
%
% \noindent
-% \DescribeMacro{fileext=}
+% \DescribeMacro{fileext}\label{setup:fileext}%^^A
+%^^A% Defines the file extension from which
+%^^A% gathered list of floats. (As default, new captions
+%^^A% are gathered in \texttt{lox}-file). This option is required in the case of
+%^^A% creation of a~separate float lists.
% Определяет расширение файла, где будет собираться список флотов.
-% (По умолчанию, подписи собираются в файле с расширением \texttt{lox}).
+% (По умолчанию, подписи собираются в~файле с~расширением \texttt{lox}).
+% Если предполагается создание отдельных списков флотов, задание нового
+% расширения с~помощью этой опции обязательно.
%
% \noindent
-% \DescribeMacro{within=}
+% \DescribeMacro{within}\label{setup:within}%^^A
+%^^A% Declares the section head of document, by which
+%^^A% current float resets its numbering to zero. If this key absent,
+%^^A% float increases during whole documentation.
% Определяет раздел, внутри которого будет производиться перенумерация.
% Если ключ отсутствует, задаётся сквозная нумерация по всему документу.
%
% \noindent
-% \DescribeMacro{relatedcapstyle=}
-% В пакете \pkg{float} команды \cmd{\newfloat}/\cmd{\restylefloat}
-% присоединяют специальный стиль подписи, связанный с данным стилем флота (см.
-% разд.~\ref{sec:floatst}). Если вы используете механизм |\DeclareNewFloatType|,
-% и имеется (вы создали с помощью |\captionsetup|) одноимённый, связанный,
-% стиль подписи, вы можете присоединить этот стиль с помощью ключа
+% \DescribeMacro{relatedcapstyle}\label{setup:relatedcapstyle}%^^A
+%^^A% In \package{float} package the non-starred
+%^^A% \cmd{\newfloat}/\cmd{\restylefloat} macros attach related
+%^^A% caption style for float styles (see {\sectionname}~\ref{sec:floatst}).
+%^^A% If you use |\DeclareNewFloatType| mechanism and exists (you created
+%^^A% it by |\captionsetup|) co-named, i.e. related, caption style
+%^^A% you may attach this style with key \texttt{relatedcapstyle=yes}.
+% В~пакете \package{float} команды \cmd{\newfloat}/\cmd{\restylefloat}
+% присоединяют специальный стиль подписи, связанный с~данным стилем флота
+% (см.~{\sectionname}~\ref{sec:floatst}). Если вы используете механизм |\DeclareNewFloatType|,
+% и~имеется (вы создали с~помощью |\captionsetup|) одноимённый, связанный,
+% стиль подписи, вы можете присоединить этот стиль с~помощью ключа
% \texttt{relatedcapstyle=yes}.
% %^^A \begin{quote}
% %^^A |\captionsetup[figure]{style=ruled}|
% %^^A \end{quote}
%
+%^^A% The |\DeclareNewFloatType| was used for defining of \env{Example}
+%^^A% environment (see page \pageref{exa1.1}). It consists of following
+%^^A% code:
% Команда |\DeclareNewFloatType| была использована для определения окружения
-% \env{Example} (см. с.~\pageref{exa1.1}). Она была задана следующим образом:
+% \env{Example} (см.~с.~\pageref{exa1.1}). Она была задана следующим образом:
% \begin{quote}
% |\DeclareNewFloatType{Example}%|\\
% | {placement=t,within=section,fileext=lox,|\\
@@ -1442,257 +3950,231 @@
% \end{quote}
% Для русской документации пришлось в примере добавить ключ \texttt{name=}.
%
-% \section{Заимствованный код}
+%^^A% \subsection{How to change \cmd{\newfloat} with
+%^^A% \cmd{\DeclareNewFloatType}}\label{sec:oldtonew}
+% \subsection{Как заменить \cmd{\newfloat} на
+% \cmd{\DeclareNewFloatType}}\label{sec:oldtonew}
+%
+%^^A% The |\newfloat| command takes three required and
+%^^A% one optional argument:
+% Команда |\newfloat| использует три обязательных
+% и~один дополнительный аргумент:
+% \begin{Quote}
+% |\newfloat|\marg{type}^^A
+% \marg{placement}\marg{ext}\oarg{within}
+% \end{Quote}
+%^^A% which could be replaced with
+% что можно заменить на:
+% \begin{Quote}
+% |\DeclareNewFloatType|\marg{type}|%|\\
+% | {placement=|\meta{placement}|,fileext=|\marg{ext}|,widthin=|\oarg{within}|}|
+% \end{Quote}
%
-% \subsection{Пакет \pkg{float}: совместимость}\label{sec:floatst}
+% \clearpage
+% %^^A\section{Borrowed code}\label{sec:borrow}
+% \section{Заимствованный код}\label{sec:borrow}
%
-% Пакет \pkg{floatrow} включает некоторые макрокоманды пакета \pkg{float} (версии
-% v1.3d, датированной 2001/11/08)
-% с необходимыми изменениями. Если вы загрузили пакет \pkg{float}
-% до \pkg{floatrow} выдаётся сообщение об ошибке.
+%^^A% \subsection{\package{float} Package: Compatibility}\label{sec:floatst}
+% \subsection{Пакет \package{float}: совместимость}\label{sec:floatst}
%
+%^^A% The \package{floatrow} package includes some macros of \package{float}
+%^^A% (version v1.3d, dated 2001/11/08)
+%^^A% with necessary modifications. In the case of loaded \package{float}
+%^^A% package before \package{floatrow} you'll get error message.
+% Пакет \package{floatrow} включает некоторые макрокоманды пакета \package{float} (версии
+% v1.3d, датированной 2001/11/08)
+% с~необходимыми изменениями. Если вы загрузили пакет \package{float}
+% до \package{floatrow} выдаётся сообщение об ошибке.
+%
+%^^A% \emph{Note}.
+%^^A% In the case of some packages
+%^^A% could call \package{float} package\footnote{I'm aware about \package{algorithm}
+%^^A% package.} the \package{floatrow} package loads code which emulates
+%^^A% already loaded \package{float} package v1.3, so next requests for
+%^^A% \package{float} are ignored. This will help to avoid strange error messages
+%^^A% in the case of these packages loaded \emph{after} \package{floatrow}.
+%^^A% Please note that packages, which load \package{float} must be loaded
+%^^A% \emph{after} \package{floatrow}.
% \emph{Замечание}.
% Поскольку некоторые пакеты могут вызывать
-% пакет \pkg{float}\footnote{Мне известен пакет \pkg{algorithm}.}
-% пакет \pkg{floatrow} вводит некоторый код, который эмулирует
-% уже загруженный пакет \pkg{float} v1.3 и последующие запросы пакета игнорируются.
+% пакет \package{float}\footnote{Мне известен пакет \package{algorithm}.}
+% пакет \package{floatrow} вводит код, эмулирующий
+% загрузку пакета \package{float} v1.3 и~последующие запросы пакета игнорируются.
% Это поможет избежать сообщений об ошибках,
-% если эти пакеты загружены \emph{после} \pkg{floatrow}.
-% Обратите внимание, что пакеты, загружающие пакет \pkg{float}, должны быть
-% загружены \emph{после} \pkg{floatrow}.
-%
-% Я надеюсь что старые документы будут работать с \pkg{floatrow}. Первое
-% ограничение или особенность "--- если вы не использовали команд |\restylefloat|
-% "--- все рисунки и таблицы будут выводиться в стиле \texttt{plain}
-% с подписями снизу. Другое ограничение "--- вы должны перенести все команды
-% |\newfloat|, |\floatstyle| и |\restylefloat| в преамбулу,
-% до команды |\begin{document}|. Команды |\newfloat|, |\floatstyle| и
-% |\restylefloat| устаревшие, хотя и поддерживаются\footnote{Всё же лучше заменить
+% если эти пакеты загружены \emph{после} \package{floatrow}.
+% Обратите внимание, что пакеты, загружающие пакет \package{float}, должны быть
+% загружены \emph{после} \package{floatrow}.
+%
+%^^A% I hope that old documents could work with \package{floatrow}. The first
+%^^A% limitation or feature is---if you didn't use any |\restylefloat|
+%^^A% command---all figures and tables appear in \texttt{plain} float style
+%^^A% with bottomed captions. Another limitation---you ought to put all
+%^^A% |\newfloat| and |\floatstyle| and |\restylefloat| commands in
+%^^A% preamble, before |\begin{document}|. The commands |\restylefloat|,
+%^^A% |\newfloat| and |\floatstyle| are obsolete but
+%^^A% supported\footnote{The better
+%^^A% way is to use \cmd{\floatsetup} macros. The \package{floatrow} package
+%^^A% supports obsolete macros but there is no guarantee.}. See also
+%^^A% section~\ref{float-obs} about translation of these commands
+%^^A% into |\floatsetup| command.
+% Надеюсь что старые документы будут работать с~\package{floatrow}. Первое
+% ограничение/особенность "--- если команды |\restylefloat| не заданы
+% "--- все рисунки и~таблицы выведутся в~стиле \texttt{plain}
+% с~подписями снизу. Другое ограничение "--- нужно перенести все команды
+% |\newfloat|, |\floatstyle| и~|\restylefloat| в~преамбулу,
+% до команды |\begin{document}|. Команды |\newfloat|, |\floatstyle|
+% и~|\restylefloat| устаревшие, хотя и~поддерживаются\footnote{Всё же лучше заменить
% их на команды \cmd{\floatsetup},
-% Пакет \pkg{floatrow} поддерживает старые команды, но не даёт гарантии.}.
-% См. также разд.~\ref{float-obs} о том как переводятся эти команды в команду
-% |\floatsetup|.
-%
-% Разделы, помеченные текстом <<[\pkg{float}]>>, были заимствованы из
+% Пакет \package{floatrow} поддерживает старые команды, но не даёт гарантии.
+% См.~также {\sectionname}~\ref{float-obs} о~том как переводятся эти команды в~команду
+% \cmd{\floatsetup}.}.
+%
+%^^A% Sections, signed with ``[\package{float}]'' were borrowed from
+%^^A% \package{float}'s documentation. The section about commands which
+%^^A% describes setting commands of \package{float} package was moved
+%^^A% in the section~\ref{sec:changed}
+%^^A% (subsection~\ref{sec:floatborrowI}, ``The User Interface---New
+%^^A% Floats [\package{float}]'').
+% Разделы, помеченные «[\package{float}]», заимствованы из
% документации пакета
-% \pkg{float}\footnote{Настоятельно рекомендуется читать эти разделы в оригинале.
-% За корректность перевода не ручаюсь.}.
-%
-% \subsubsection{Интерфейс пользователя "--- новые плавающие объекты
-% (флоты) [\pkg{float}]}\label{sec:floatborrowI}
-%
-% \DescribeMacro{\newfloat}
-% Самой важной командой в пакете \pkg{float}
-% является команда |\newfloat|\footnote{Она дублируется командой
-% \cmd{\DeclareNewFloatType}.}.
-% Она сделана по образцу
-% |\newtheorem|. Команда |\newfloat| имеет три основных и один дополнительный
-% аргумент; форма задания:
-% \begin{quote}
-% \hspace*{\MacroIndent}|\newfloat{|\meta{type}|}{|^^A
-% \meta{placement}|}{|\meta{ext}|}[|\meta{within}{\tt]}
-% \end{quote}
-% \begin{itemize}
-% \item \marg{type} задаёт тип нового класса флотов, таких как
-% \texttt{program} (программа) или \texttt{algorithm} (алгоритм).
-% Определив эти слова в аргументе
-% |\newfloat|, вы можете задать команды, как |\begin{program}|
-% или |\end{algorithm*}|.
-% \item \marg{placement} задаёт размещение по умолчанию
-% для данного класса флотов. Параметры те же самые,
-% что и в стандартном \LaTeX'е, например, \texttt{t}, \texttt{b},
-% \texttt{p} и \texttt{h} для `top' (вверху), `bottom' (внизу),
-% `page' (отдельная страницы) и `here' (здесь),
-% соответственно.
-% \item \marg{ext}. Когда \LaTeX\ записывает подписи во вспомогательный файл
-% для списка рисунков (или любого другого флота), он использует
-% имя рабочего файла (документа)
-% с расширением \marg{ext} как имя файла.
-% \item \oarg{within}. Наконец, дополнительный
-% аргумент \meta{within} определяет будут ли плавающие объекты
-% данного класса нумероваться
-% внутри указанного раздела документа. Например,
-% если \oarg{within}${}={}$\texttt{chapter}, флоты будут перенумеровываться
-% по главам. (В стандартном \LaTeX'е, это задано для рисунков и таблиц
-% в классах документов \cls{report} и \cls{book}.) Как
-% пример, программа~\ref{prog1.1} была создана командной последовательностью
-% похожей на продемонстрированную в следующем
-% примере\footnote{Настройки для этого окружения примера
-% были созданы командой \cmd{\DeclareNewFloatType}.}.
-% \end{itemize}
-% \emph{Floatrow замечание.}
-% Также создана команда-пара |\newfloat*|, которая работает аналогично команде
-% |\restylefloat*| (см. ниже).
-% \begin{Program}
-%\begin{verbatim}
-%#include <stdio.h>
-%
-%int main(int argc, char **argv) {
-% int i;
-% for (i = 0; i < argc; ++i)
-% printf("argv[%d] = %s\n", i, argv[i]);
-% return 0;
-%}
-%\end{verbatim}
-% \caption{Первая программа. Она ничего не делает в пакете,
-% просто включена в него как пример.
-% Обратите внимание на стиль \texttt{ruled}%
-% \label{prog1.1}}
-% \end{Program}
-% \begin{Example}[H]
-% \begin{verse}
-% |\floatstyle{ruled}|\\
-% |\newfloat{Program}{tbp}{lop}[section]|\\
-% |\floatname{Program}{\CYRP\cyrr\cyro\cyrg\cyrr\cyra\cyrm\cyrm\cyra}|\\
-% \dots\ loads o' stuff \dots\\
-% |\begin{Program}|\\
-% |\begin{verbatim}|\\
-% \dots\ program text \dots\\
-% |\end{verbatim}|\\
-% |\caption{|\dots\ caption \dots|}|\\
-% |\end{Program}|
-% \end{verse}
-% \caption{Это ещё один простенький плавающий пример. Исключая
-% то, что он плавает, так как использует параметр {\tt[H]}, чтобы
-% появиться \textbf{Здесь}. (Обратите внимание, что в примере
-% настроек программы определено
-% имя флота для нумерационного заголовка подписи.)}\label{exa1.1}
-% \end{Example}
-%
-% \DescribeMacro{\floatstyle}
-% Команда |\floatstyle| определяет стиль флота по
-% умолчанию. Этот стиль будет использоваться для всех типов флотов
-% которые впоследствии будут определены в команде |\newfloat|, до появления другой
-% команды |\floatstyle|. Команда |\floatstyle| имеет один аргумент,
-% имя стиля флота. Например,
-% |\floatstyle{ruled}|. Указание названия несуществующего стиля приведёт к ошибке.
-%
-% \DescribeMacro{\floatname}
-% Команда |\floatname| позволяет вам определить
-% \emph{имя флота}, которое \LaTeX\ использует в подписи флота,
-% например, `Figure' для окружения рисунков и тому подобное. Например,
-% |\floatname{program}{Program}| (или |\floatname|\nobreak
-% \hfil|{Program}|\allowbreak\hfil
-% |{\CYRP\cyrr\cyro\cyrg\cyrr\cyra\cyrm\cyrm\cyra}|).\allowbreak{}
-% Команда |\newfloat| определяет
-% имя флота по аргументу определяющему имя окружения (\meta{type}) если не было
-% определено другого имени до этого.
-%
-% \DescribeMacro{\floatplacement}
-% Команда |\floatplacement| переопределяет
-% размещения флота по умолчанию для данного класса флотов. Например,
-% |\floatplacement{figure}{tp}|.
-%
-% \DescribeMacro{\restylefloat}\nopagebreak
-% Команда |\restylefloat| необходима для
-% изменения стиля для стандартных типов флотов
-% \texttt{figure} и \texttt{table}. Так как они не определяются
-% через команду |\newfloat|, они не имеют стиля, связанного с ними.
-% Поэтому вы должны задать, например,
-% \begin{quote}
-% \hspace*{\MacroIndent}|\floatstyle{ruled}|\\
-% \hspace*{\MacroIndent}|\restylefloat{table}|
-% \end{quote}
-% чтобы получить таблицы в стиле \texttt{ruled}. Команда также позволяет
-% изменить стиль флота, определённого командой |\newfloat|, хотя
-% это, по типографским правилам, не лучшая идея. См.
-% табл.~\ref{table1} для примера\footnote{В пакете \pkg{float}
-% создан специальный стиль подписи с полужирным нумерационным заголовком
-% для стиля \texttt{boxed}.
-% Обратите внимание, что стили флота \texttt{plain} и \texttt{boxed}
-% не имеют специальных настроек в пакете \pkg{caption} 3.x.
-% Для эмуляции стиля \texttt{boxed} из документации пакета \pkg{float} были:
-% отменены все специальные установки для таблиц, и восстановлено двоеточие
-% как разделитель после нумерационного заголовка.}. Существует
-% команда |\restylefloat*|,
-% которая переопределяет стиль флота, но не затрагивает стиля подписи.
-% В этом случае пользователь сам отвечает за создание оформления подписей.
-% \DeleteShortVerb{\|}
-% %^^AEmulation of float's documentation settings
-% %^^A\floatstyle{boxed}
-% %^^A\restylefloat{table}
-% \begingroup
-% \clearcaptionsetup{table}
-% \captionsetup{labelsep=default,labelfont=bf}
-% \floatsetup[table]{style=boxed}
-% \begin{table} \def\B#1{$\displaystyle{n\choose#1}$}
-% \begin{center} \begin{tabular}{c|cccccccc}
-% $n$&\B0&\B1&\B2&\B3&\B4&\B5&\B6&\B7\\ \hline
-% 0 & 1\\
-% 1 & 1&1\\
-% 2 & 1&2&1\\
-% 3 & 1&3&3&1\\
-% 4 & 1&4&6&4&1\\
-% 5 & 1&5&10&10&5&1\\
-% 6 & 1&6&15&20&15&6&1\\
-% 7 & 1&7&21&35&35&21&7&1
-% \end{tabular} \end{center}
-% \caption{Треугольник Паскаля. Это переоформленное окружение
-% \LaTeX'а \texttt{table}.%^^A
-% \label{table1}}
-% \end{table}
-% \endgroup
-% \MakeShortVerb{\|}
-%
-% \subsubsection{Как макрокоманды из пакета \pkg{float}
-% работают в \pkg{floatrow}}\label{float-obs}
-%
-% Комбинация команды |\floatstyle|\marg{style} и любой из
+% \package{float}\footnote{Настоятельно рекомендуется читать эти разделы
+% в~английском варианте документации.
+% За корректность перевода не ручаюсь.}. Раздел, описывающий команды
+% настроек флотов и~создания нового типа флотов перемещён в~конец,
+% в~разд.~\ref{sec:changed} (подраздел~\ref{sec:floatborrowI},
+% «Интерфейс пользователя \cdash--- новые плавающие объекты»)
+%
+%
+% \RestoreSpaces
+%^^A% \subsubsection{How macros from \package{float} package
+%^^A% work in \package{floatrow}}\label{float-obs}
+% \subsubsection{Как макрокоманды из пакета \package{float}
+% работают в~\package{floatrow}}\label{float-obs}
+%
+%^^A% The combination of |\floatstyle|\marg{style} and any of
+%^^A% \cmd{\newfloat}\marg{float} or
+%^^A% \cmd{\restylefloat}\marg{float} commands in \package{floatrow} package
+%^^A% set float layout in the way:
+% Комбинация команды |\floatstyle|\marg{style} и~любой из
% \cmd{\newfloat}\marg{float} или
-% \cmd{\restylefloat}\marg{float} означает в пакете \pkg{floatrow}
-% определение стиля флота следующим образом:
-% \begin{quote}
+% \cmd{\restylefloat}\marg{float} превращается в~пакете \package{floatrow}
+% в~настройки \hbox{вида}:
+% \begin{Quote}
% |\floatsetup|\oarg{float}|{style=|\meta{style}|}|
-% \end{quote}
-% Обратите внимание, что одноимённые ключи из |\floatsetup|\oarg{float}|{...}|
-% перепишут настройки из общей команды |\floatsetup{...}|. Это означает,
-% если вы задали оформление, используя эти устаревшие команды, дальнейшую
-% настройку оформления вы должны делать с помощью |\floatsetup|\oarg{float}|{...}|.
-%
+% \end{Quote}
+%^^A% Please note that there is used |\floatsetup|\oarg{float}|{...}|
+%^^A% but not |\floatsetup{...}|.
+% Обратите внимание, что используются настройки |\floatsetup|\oarg{float}|{...}|,
+% а~не просто |\floatsetup{...}|.
+%
+%^^A% The |\floatname| command replaces the |name=| key of |\DeclareNewFlotaType|
+%^^A% command. The |\floatplacement|---|placement=| key.
+% Команда |\floatname| заменяется на ключ |name=| в~установках команды |\DeclareNewFlotaType|,
+% а~|\floatplacement| \cdash--- ключ |placement=|.
+%
+%^^A% \subsubsection{Printing of Float List [\package{float}]}
+%^^A% \label{sec:floatborrowIa}
% \subsubsection{Печать списка плавающих объектов (флотов)
-% [\pkg{float}]}\label{sec:floatborrowIa}
+% [\package{float}]}\label{sec:floatborrowIa}
%
% \nobreak\DescribeMacro{\listof}
% \nopagebreak
+%^^A% The |\listof| command produces a list of all the floats
+%^^A% of a given class. Its syntax~is\\[2pt]
% Команда |\listof| создаёт список всех флотов данного
-% класса. Её синтаксис\\[2pt]
-% \hspace*{\MacroIndent}|\listof{|\meta{type}|}{|\meta{title}^^A
-% |}|\\[2pt]
+% класса. Её синтаксис
+% \par\RestoreSpaces
+% \begin{quote}
+% \hspace*{\MacroIndent}|\listof{|\meta{type}|}{|\meta{title}|}|^^A
+% \end{quote}
+%^^A% \meta{type} is the float type given in the |\newfloat| command.
+%^^A% \meta{title} is used for the title of the list as well as the
+%^^A% headings if the current page style includes them. Otherwise, the
+%^^A% |\listof| command is analogous to the built-in \LaTeX\ commands
+%^^A% |\listoffigures| and |\listoftables|.
% \meta{type} это тип флота, заданный командой |\newfloat|.
-% \meta{title} задаёт заголовок списка флотов и колонтитулы
-% если стиль страницы задаёт их. В противном случае, команда
+% \meta{title} задаёт заголовок списка флотов и~колонтитулы
+% если стиль страницы задаёт их. В~противном случае, команда
% |\listof| работает аналогично встроенным командам \LaTeX'а
-% |\listoffigures| и |\listoftables|.
-%
-% \subsubsection{Пользовательский интерфейс "--- указатель
-% размещения флота \texttt{[H]} [\pkg{float}]}\label{sec:floatborrowII}
-%
-% Многие находят набор указателей размещения флотов в \LaTeX'е
-% ограниченным. Commonly Uttered Complaint (CUC) призвала найти путь
-% поместить флот точно в то место, где он появляется в исходном файле,
-% иными словами не делать плавающим его вообще. С первого взгляда указатель
+% |\listoffigures| и~|\listoftables|.
+%
+%^^A% \noindent\emph{Floatrow note}.
+%^^A% Please remember that for each float type list
+%^^A% you must set file extension where the entries of each float type gathered.
+%^^A% Use key \texttt{fileext=...} in |\DeclareNewFloatType|.
+%^^A% If two or more float types will have the same file
+%^^A% for list of floats, you will get all floats in the
+%^^A% first appeared |\listof|, and all next will be empty.
+% \noindent\emph{Замечание \textsf{floatrow}}.
+% Помните, что для каждого списка флотов
+% нужно задать расширение файла, где будут собираться вхождения этого флота.
+% Используйте ключ \texttt{fileext=...} в~команде~|\DeclareNewFloatType|.
+% Если два или более типов флотов будут иметь один файл (заданное расширение)
+% списка флотов, все флоты соберутся в~первом
+% списке |\listof|, оставив остальные пустыми.
+%
+%^^A% \subsubsection{The User Interface---\texttt{[H]}
+%^^A% Placement Specifier [\package{float}]}\label{sec:floatborrowII}
+% \subsubsection{Интерфейс пользователя "--- указатель
+% размещения \texttt{[H]} [\package{float}]}\label{sec:floatborrowII}
+%
+%^^A% Many%^^A
+%^^A% \FRmpar{Anchored float}{FAD:AnchoredFloat}
+%^^A% people find \LaTeX's float placement specifiers too
+%^^A% restrictive. A Commonly Uttered Complaint (CUC) calls for a way to
+%^^A% place a float exactly at the spot where it occurs in the input file,
+%^^A% i.e., to \emph{not} have it float at all. It seems that the
+%^^A% \texttt{[h]} specifier should do that, but in fact it only suggests
+%^^A% to \LaTeX\ something along the lines of ``put the float here if it's
+%^^A% OK with you''. As it turns out, \LaTeX\ hardly ever feels inclined
+%^^A% to actually do that. This situation can be improved by judicious
+%^^A% manipulation of float style parameters.
+% Многие%^^A%
+% \FRmpar{Флот «на якоре»}{FAD:AnchoredFloat}
+% находят набор указателей размещения флотов в~\LaTeX'е
+% ограниченным. Общество \textit{Commonly Uttered Complaint} (CUC) призвало найти путь
+% поместить флот точно в~то место, где он появляется в~исходном файле,
+% иными словами не делать плавающим его вообще. С~первого взгляда указатель
% \texttt{[h]} должен делать это, но фактически он только предлагает
-% \LaTeX'у <<поместить здесь если получится>>.
-% На самом деле \LaTeX\ едва склонен в действительности
+% \LaTeX'у~<<поместить здесь если получится>>.
+% На самом деле \LaTeX\ едва склонен в~действительности
% делать это. (Эта ситуация может быть исправлена только хитроумными
% манипуляциями параметров флота.)
%
+% \RestoreSpaces
+%^^A% The same effect can be achieved by changing the actual method of
+%^^A% placing floats. David Carlisle's \package{here} option introduces a new
+%^^A% float placement specifier, namely \texttt{[H]}, which, when added to
+%^^A% a float, tells \LaTeX\ to ``put it HERE, period''. If there isn't
+%^^A% enough space left on the page, the float is carried over to the next
+%^^A% page together with whatever follows, even though there might still
+%^^A% be room left for some of that. This style option provides the
+%^^A% \texttt{[H]} specifier for newly defined classes of floats as well
+%^^A% as the predefined \texttt{figure}s and \texttt{table}s, thereby
+%^^A% superseding \package{here}. David suggests that the \package{here} option be
+%^^A% withdrawn from the archives in due course.
% Тот же эффект может быть достигнут изменением метода
-% размещения флотов. Опция \pkg{here} (David Carlisle) предлагает
+% размещения флотов. Опция \package{here} (David Carlisle) предлагает
% новый указатель размещения флота, названный \texttt{[H]},
-% который, при добавлении в опции флота,
-% говорит \LaTeX'у <<поставить ЗДЕСЬ, точка>>. Если места на
+% который, при добавлении в~опции флота,
+% говорит \LaTeX'у~<<поставить СЮДА, точка>>. Если места на
% странице недостаточно, флот переносится на другую страницу
-% вместе с последующим текстом, даже в случае, если этот текст
+% вместе с~последующим текстом, даже в~случае, если этот текст
% мог бы там разместиться. Пакет поддерживает эту опцию, указатель
-% \texttt{[H]}, как для новых классов флотов так и для
-% предопределённых \texttt{figure} и \texttt{table}, вместо
-% \pkg{here}. David предполагает, что пакет \pkg{here}
+% \texttt{[H]}, как для новых классов флотов так и~для
+% предопределённых \texttt{figure} и~\texttt{table}, вместо
+% \package{here}. David предполагает, что пакет \package{here}
% может быть со временем удалён из архивов.
%
-% Указатель {\tt[H]} может быть просто добавлен к флоту
+%^^A% The {\tt[H]} specifier may simply be added to the float as an
+%^^A% optional argument, like all the other specifiers. It may \emph{not}
+%^^A% be used in conjunction with any other placement specifiers, so
+%^^A% {\tt[Hhtbp]} is illegal. Neither may it be used as the default
+%^^A% placement specifier for a whole class of floats. The following table
+%^^A% is defined like this:
+% Указатель {\tt[H]} может быть просто добавлен к~флоту
% как опция, как другие указатели. Он \emph{не}
-% может быть использован совместно с другими указателями, поэтому
+% может быть использован совместно с~другими указателями, поэтому
% {\tt[Hhtbp]} неверно. Также он не может быть использован как
% параметр по умолчанию для класса флотов. Следующая таблица
% определена следующим образом:
@@ -1703,14 +4185,22 @@
% \dots\ more stuff \dots\\
% |\end{tabular}|
% \end{verse}
+%^^A% (It seems that I have to add some extraneous chatter here just so
+%^^A% that the float actually comes out right in the middle of a printed
+%^^A% page. When I \LaTeX ed the documentation\footnote{For \package{float}
+%^^A% package.} just now it turned out that there was a page break that
+%^^A% fell exactly between the ``So now'' line and the float. This
+%^^A% wouldn't Prove Anything. Bother.) So now we have the following float
+%^^A% placement specifiers:
% (Кажется мне пришлось добавить здесь немного ненужной болтовни
% чтобы флот был помещён точно посередине страницы.
% Когда документация обрабатывалась
-% \LaTeX'ом\footnote{Пакета \pkg{float}.}
+% \LaTeX'ом\footnote{Пакета \package{float}.}
% обнаружилось что разрыв страницы приходится между строкой
-% <<Итак теперь>> и флотом. Это ничего не доказывает.
-% Bother.) Итак теперь мы имеем следующие указатели размещения
-% флота:
+% <<Итак теперь>> и~флотом. Это ничего не доказывает.
+% Итак теперь мы имеем следующие указатели размещения
+% флота:\nopagebreak
+% \par\RestoreSpaces
% \begin{table}[H]
% \begin{tabular}{cl}
% \tt t & вверх полосы\\
@@ -1722,596 +4212,311 @@
% ^^A\caption{Could it be that this just needs a caption?}
% \end{table}
%
+%^^A% \emph{Floatrow note}. Please don't mix meaning of
+%^^A% \texttt{[H]} and \texttt{[h]} options.
+%^^A% Float with \texttt{[h]} and \texttt{[!h]} option, if succeed, appears
+%^^A% \emph{after completing line} of text,
+%^^A% where it was appeared in the source file. That could be visible if you
+%^^A% put float environment at the middle of paragraph.
+% \emph{Замечание \textsf{floatrow}}. Не путайте значение опций
+% \texttt{[H]} и~\texttt{[h]}.
+% Опции~\texttt{[h]} или~\texttt{[!h]}, если выполняются, помещают флот
+% \emph{после того, как завершена строка} текста,
+% где появилось окружение в~исходном файле. Это легко увидеть, если
+% вы поместите окружение флота внутри абзаца.
+%
+%^^A% The [H] option places float just \emph{in the point} where it appeared
+%^^A% in the source file, it is used (\emph{but this method for floats strongly
+%^^A% not recommended}!), for floats after text like ``\dots{}shown in this
+%^^A% \textbf{figure:}'', i.e. the \texttt{[H]} floats continue current
+%^^A% paragraph.
+% Опция~[H] помещает флот \emph{в~точке} где
+% окружение появилось в~исходном файле,
+% это используется (\emph{такие вещи в~книгах настоятельно
+% не рекомендуются}!) для «флотов» после текста типа «\dots{}показано на этом
+% \textbf{рисунке:}», т.\,е. флоты с~опцией~\texttt{[H]} фактически продолжают
+% данный абзац.
+% \RestoreSpaces
+%
+%^^A% \subsubsection{The {[H]}
+%^^A% Placement Specifier---Managing of Page Breaks}\label{sec:listpen}
% \subsubsection{Опция {[H]}
% "--- настройка разрывов на страницы}\label{sec:listpen}
%
+%^^A% During usage of |[H]| option I found that it is necessary
+%^^A% to set common penalties before and after ``anchored'' floats.
% При использовании опции |[H]| мне понадобилось задать
-% общие запреты на разрывы до и после <<привязанных>> флотов.
-%
-% В одной книге запреты на разрывы на страницы вокруг таких
-% флотов и вокруг перечней должны быть одинаковыми.
-%
+% общие запреты на разрывы до и~после флотов «на якоре».
+%
+%^^A% The rules for page breaking around such floats similar to
+%^^A% page breaking of lists in the book.
+% В~одной книге запреты на разрывы на страницы вокруг таких
+% флотов и~вокруг перечней могут быть одинаковыми.
+%
+%^^A% To follow the idea of |\allowdisplaybreaks| command from
+%^^A% \package{amsmath} package there is created a \emph{beta-temp}\footnote{I
+%^^A% hope that such support sooner or later could appear in
+%^^A% \package{paralist} package and think it is better to follow
+%^^A% grammar of master-package for similar situations.} version
+%^^A% of \package{listpen} package, which offers following commands:
% Используя идею команды |\allowdisplaybreaks| из пакета
-% \pkg{amsmath} создан небольшой (beta-temp) пакет
-% \pkg{listpen}, который предлагает следующие команды:
+% \package{amsmath} создан небольшой (beta-temp) пакет
+% \package{listpen}\footnote{Я~надеюсь
+% что подобная поддержка рано или поздно появится в~пакете
+% \package{paralist} и~считаю, что лучше следовать грамматике
+% этого пакет для таких ситуаций.},
+% который предлагает \hbox{команды}:
% \begin{Options}{\OptionLabel}
+%^^A% \item[\cmd{\allowprelistbreaks}]sets penalty before lists
+%^^A% (and also ``anchored'' floats);
% \item[\cmd{\allowprelistbreaks}]устанавливает разрывы до перечней
-% (а также привязанных флотов);
+% (а~также флотов «на якоре»);
+%^^A% \item[\cmd{\allowpostlistbreaks}]sets penalty after lists;
% \item[\cmd{\allowpostlistbreaks}]устанавливает разрывы
-% после перечней (привязанных флотов);
+% после перечней (флотов «на якоре»);
+%^^A% \item[\cmd{\allowitembreaks}]sets penalty between list items.
% \item[\cmd{\allowitembreaks}]устанавливает разрывы между
-% пунктами перечня.
+% пунктами перечня (флотам, естественно, это не нужно!).
% \end{Options}
+%^^A% All they set globally, inside group or inside
+%^^A% environments. These penalties are set accordingly to digits
+%^^A% from |[-4]| (never break) to |[4]| (always break). The positive
+%^^A% values of optional argument in these commands analogous to values
+%^^A% of optional arguments in |\pagebreak| command. The negative
+%^^A% ones---to optional arguments |[1]|--|[4]| in |\nopagebreak| command.
+%^^A% The default value of all three commands is |[-1]| which equal
+%^^A% to settings of standard \LaTeX{} classes: \cls{book}, \cls{article}
+%^^A% etc. (|[-1]| option equal to |-\@lowpenalty| value).
% Все эти команды задают глобально, внутри группы или
% окружения разрывы, задаваемые цифрами
% от |[-4]| (нет разрыва) до |[4]| (всегда разрыв). Положительные
% значения опций команд аналогичны значениям опций
% команды |\pagebreak|. Отрицательные соответствуют
-% опциям |[1]|--|[4]| в команде |\nopagebreak|.
-% Значение по умолчанию для всех трёх команд |[-1]|, что
-% равно установкам стандартных классов \LaTeX'а: \cls{book}, \cls{article}
-% и других (|[-1]| соответствует значению |-\@lowpenalty|).
-%
-% \subsection{Пакет \pkg{rotfloat}}
-%
-% Код пакета \pkg{rotfloat} был также позаимствован
-% пакетом \pkg{floatrow}.
-% Если пакет \pkg{rotfloat} был загружен до \pkg{floatrow},
-% вы получите сообщение об ошибке.
-%
-% Пакет \pkg{floatrow} вводит код, который эмулирует уже загруженный
-% пакет \pkg{rotfloat} и последующая его загрузка игнорируется.
-% Пакет \pkg{rotfloat} построен таким образом, что может быть
-% загружен в одной строке \verb|\usepackage| вместе с
-% пакетом \pkg{rotating}, который может иметь опции. Необходимо
-% также удалить пакет \pkg{rotfloat} из строки \verb|\usepackage|,
-% где задан пакет \pkg{rotating} с опциями: в противном случае
-% вы получите сообщение об ошибке со словами `option clash'.
-%
-% \section{Макрокоманды для построения флотов}
-%
-% \subsection{Макрокоманда Floatbox}\label{sec:floatbox}
-%
-% Данный пакет предлагает макрокоманду, которая создаёт
-% необходимое размещение компонентов
-% содержимого и подписи плавающего объекта (см. также введение).
-% Эта макрокоманда выглядит следующим образом:
+% опциям |[1]|--|[4]| в~команде |\nopagebreak|.
+% Значение по умолчанию равно |[-1]|, что
+% равно установкам стандартных классов \LaTeX'а
+% (|[-1]| соответствует значению |-\@lowpenalty|).
+%
+% \DescribeMacro{floatHaslist}\label{setup:floatHaslist}%^^A
+%^^A% This is the late attempts of backwards compatibility. The key, if true,
+%^^A% uses list penalties, otherwise anchored float works like
+%^^A% defined in \package{float} package and in \package{floatrow}'s version 0.0g
+%^^A% and earlier. (I hope there could not much difference,
+%^^A% unless you redefined penalties of lists.)
+% Здесь описана запоздавшая попытка обратной совместимости.
+% Ключ, в~значении \texttt{true},
+% использует штрафы (penalties) задаваемые для перечней,
+% в~противном случае флот «на якоре»
+% и~работает как в~пакете~\package{float} и~версии~0.0g пакета~\package{floatrow}
+% и~старше. (Надеюсь большой разницы не будет,
+% только если штрафы для перечней не переопределялись.)
+%
+%^^A% Also (added in version 0.1k with current key):
+%^^A% since list environments do \emph{not make indentation} in following
+%^^A% paragraph, in the case of \emph{no blank} line after environment,
+%^^A% the ``anchored'' float environment does
+%^^A% the same, if this option is true. Default value of \texttt{floatHaslist}
+%^^A% is \texttt{false}
+%^^A% (for backward compatibility with previous version 0.1j).
+% Также (добавлено в~версии 0.1k наряду с~данным ключом):
+% поскольку после перечня \emph{не делается абзацного отступа} в~тексте
+% в~случае, если \emph{не задана пустая строка} после окружения,
+% флот «на якоре» делает то же самое,
+% если включена опция. По умолчанию опция \texttt{floatHaslist} отключена (\texttt{false})
+% (для обратной совместимости с~предыдущей версией~0.1j).
+%
+% \DescribeMacro{\floatHpenalties}\label{setup:floatHpenalties}%^^A
+%^^A% This macro, defined with |\renewcommand| can include settings for
+%^^A% list penalties around anchored float. If you define
+% Это макро, определённое с~помощью |\renewcommand| может содержать установки
+% штрафов вокруг перечней вокруг флота «на якоре». Если вы определите в~преамбуле документа
+% \RestoreSpaces\begin{Quote}
+% |\renewcommand\floatHpenalties{\@beginparpenalty\@M}|
+% \end{Quote}
+%^^A% or, with \package{listpen} package
+% или, с~пакетом \package{listpen},\allowpostlistbreaks[-4]
% \begin{quote}
-% |\floatbox[|\meta{preamble}|]{|\meta{captype}|}[|^^A
-% \meta{width}|][|\meta{height}|][|\meta{vert pos}|]|\\
-% | {|\meta{caption}|}{|\meta{object}|}|\footnote{Порядок
-% обязательных аргументов и их содержимое не имеет значения
-% для построения флота. Эта макрокоманда исторически требует
-% два обязательных аргумента, но они могут быть заполнены как
-% угодно.}
+% |\renewcommand\floatHpenalties{\allowprelistbreaks[-4]}|\quad,
% \end{quote}
-% где\label{floatboxsets}:
-% \begin{description}\itemsep0pt
-% \item[\meta{preamble}]здесь могут быть такие команды, как
-% |\capbeside|, которая размещает подписи сбоку объекта;
-% |\nocapbeside| (размещает подписи сверху/снизу, в зависимости
-% от настроек стиля); или другая повторяющаяся команда
-% (даже возможно использование |\captionsetup| и
-% |\thisfloatsetup| "--- см. примеры в документации и приложении).
-% \item[\meta{captype}]тип флота, для которого строится оформление;
-% \item[\meta{width}]ширина флота
-% (если подпись сверху или снизу объекта),
-% или ширина объекта (если подпись сбоку).
-% Команда |\FBwidth| в аргументе \meta{width}
-% позволяет использовать натуральную ширину объекта.\par
-% \emph{Замечание}. Если вы используете \verb|\FBwidth| в
-% аргументе \meta{width}, вы должны быть уверены, что
-% содержимое объекта может быть помещено внутри |\hbox|
-% (вы можете воспользоваться командой |\vspace| в начале
-% и/или в конце содержимого объекта для корректировки
-% вертикальных отбивок);
-% \item[\meta{height}]высота флота
-% (если подпись сверху или снизу),
-% или высота объекта (если подпись сбоку);
-% \item[\meta{vert pos}]вертикальное выравнивание содержимого
-% объекта в боксе в случае, если аргумент \meta{height} имеет
-% б\'ольшую величину чем заданная высота объекта,
-% или флот помещён в ряд в окружении \env{floatrow}.
-% \item[\meta{caption}]подпись и экспликации (вы можете использовать
-% команду |\floatfoot| (см.~с.~\pageref{subsec:floatfoot});
-% вы можете использовать команды
-% |\footnote|/\allowbreak|\mpfootnotemark|/%^^A
-% \allowbreak|\footnotetext|
-% для сносок внутри флота, или команду |\floatfoot|;
-% \item[\meta{object}]содержимое флота; вы также можете
-% использовать команды
-% |\footnote|/\allowbreak|\mpfootnotemark|/%^^A
-% \allowbreak|\footnotetext|
-% или |\floatfoot|.
-% \end{description}
-%
-% \begingroup
-% Первый простейший пример:
-%\begin{verbatim}
-%\begin{figure}
-%\floatbox{figure}[4cm]
-%{\caption{Простой пример ...}}%
-%\label{fig:WcatI}}
-%{\input{TheCat.picture}}
-%\end{figure}
-%\end{verbatim}
-% создал картинку на рис.~\ref{fig:WcatI}.\pagebreak[3]
-% \begin{figure}
-% \floatbox{figure}[4cm]
-% {\caption{Простой пример использования команды \cmd{\floatbox}}%
-% \label{fig:WcatI}}
-% {\unitlength1.28\unitlength\input{TheCat.picture}}
-% \end{figure}%
-% \endgroup
-%
-% Но более актуальный вариант использования команды |\floatbox|
-% "--- поместить табличный заголовок \emph{над} таблицей и задать
-% ширину заголовка равной ширине
-% таблицы. Расположение заголовка определяется в преамбуле документа
-% командой |\floatsetup[table]{style=Plaintop}|
-%\begin{verbatim}
-%\begin{table}
-%\floatbox{table}[\FBwidth] {\caption{Simple tabular in
-%\cmd{\floatbox}
-% with caption above}\label{tab:tabII}}
-%{\begin{tabular}{|l|c|c|}
-% \hline
-% Column head & Data I & Data II \\
-% \hline
-% First row & 1 & 2 \\
-%...
-% \hline
-%\end{tabular}}
-%\end{table}
-%\end{verbatim}
-% \DeleteShortVerb{\|}%
-% \begin{table}
-% \floatbox{table}[\FBwidth]
-% {\caption{Простая таблица с заголовком
-% сверху}\label{tab:tabII}}
-% {\begin{tabular}{|l|c|c|}
-% \hline
-% \thead{Column head} & \thead{Data I} & \thead{Data II} \\
-% \hline
-% First row & 1 & 2 \\
-% Second row & 3 & 4 \\
-% Third row & 6 & 8 \\
-% Fourth row & \llap{1}0 & \llap{1}6 \\
-% \hline
-% \end{tabular}}
-% \end{table}%
-% \MakeShortVerb{\|}%
-% как показано в табл.~\ref{tab:tabII}. Для задания ширины
-% заголовка (или всего бокса
-% плавающего объекта) равной ширине окружения \env{tabular}
-% была использована команда |\FBwidth|
-% в аргументе \meta{width}.
-%
-% Следующий пример показывает окружение \env{figure} где подпись
-% задана сбоку. В этом примере используются команды |\capbeside|,
-% в аргументе \meta{preamble}, и |\FBwidth|, в аргументе
-% \meta{width}. Подпись занимает оставшееся место в боксе
-% шириной |\hsize| (в данном примере ширина бокса равна
-% ширине основного текста "---|\textwidth|).
-%
-%\begin{verbatim}
-%\begin{figure}
-%\floatbox[\capbeside]{figure}[\FBwidth]
-% {\caption[Beside caption]{Beside caption ...}\label{...}}
-% {...}
-%\end{figure}
-%\end{verbatim}
-% \begin{figure}[h]
-% \floatbox[\capbeside]{figure}[\FBwidth]
-% {\caption[Подпись сбоку]{Подпись сбоку and more text
-% and some more text and a bit more text and
-% a little more text and a little peace of text to fill
-% space}\label{fig:beside:mouse}}
-% {{\setlength\unitlength{4cm/58}\ifx\pspicture\undefined
-% \else\psset{unit=\unitlength}\fi
-% \input{Mouse.picture}}}
-% \end{figure}
-%
-% Ширина подписи сбоку и объекта по умолчанию равна одной
-% <<колонке>>, иными словами половине ширины текущего значения
-% |\hsize| (рис.~\ref{intro:beside}) исключая
-% поля вокруг бокса и разделитель между объектом и подписью.
-% (См. также другие примеры с подписью сбоку в приложении,
-% с.~\pageref{fig:Idog:w}.)
-%
-% \subsubsection{Пользовательские команды для флотов}
-%
-% Использование команды |\floatbox| иногда получается очень
-% сложным. Вы можете определить пользовательские команды для
-% ваших целей и определить там необходимые настройки.
-%
-% Определение пользовательской команды выглядит следующим образом:
-% \begin{quote}
-% |\newfloatcommand|\marg{command}%^^A\\\strut\qquad
-% \marg{captype}\oarg{preamble}\oarg{default width}
-% \end{quote}
-% где:
-% \begin{description}
-% \item[\meta{command}]команда пользователя (без обратного слэша);
-% \item[\meta{captype}]тип флота, для которого создаётся команда;
-% \item[\meta{preamble}]
-% вы можете использовать команды, перечисленные на
-% с.~\pageref{floatboxsets}
-% и другие команды оформления, как показано в примерах;
-% вы можете попробовать использовать некоторые другие
-% повторяющиеся команды (например,
-% |\captionsetup| или |\thisfloatsetup|);
-% \item[\meta{default width}]здесь вы можете определить любую
-% величину, типа |6cm|
-% или |.75\textwidth|\footnote{Есть также возможность установить
-% постоянную ширину
-% для данного типа флота, используя ключ \texttt{floatwidth=}
-% в команде \cmd{\floatsetup}.}; если вы зададите команду
-% |\FBwidth| ширина флота (если подпись сверху или снизу
-% "--- должна быть определена |\nocapbeside|
-% в \meta{preamble}) или ширина объекта (если подпись
-% стоит сбоку "--- команда |\capbeside| в \meta{preamble}) будет
-% равна ширине содержимого плавающего объекта.
-% \end{description}
-%
-% Уже определены следующие пользовательские команды:\label{abbrcom}
-% \begin{quote}
-% |\newfloatcommand{ffigbox}{figure}[\nocapbeside]|\\*
-% |\newfloatcommand{fcapside}{figure}[\capbeside]|\\*
-% |\newfloatcommand{ttabbox}{table}[\captop][\FBwidth]|
-% \end{quote}
-% Первые две определены для рисунков, а последняя "--- для таблицы.
-% Вы можете переопределить эти команды, используя команду
-% |\renewfloatcommand| (она использует те же
-% аргументы, как и |\newfloatcommand|).
-%
-%
-% \subsection{Помещение флотов рядом}\label{sec:floatrow}
-%
-% Если вам нужно поместить два или более флотов рядом, вы
-% можете воспользоваться окружением \env{floatrow}.
-%
-% Это окружение выглядит следующим образом:
-% \begin{quote}
-% |\begin{floatrow}[|\meta{number of beside floats}|]|\\
-% |\floatbox...|\\
-% |...|\\
-% |\floatbox...|\\
-% |...|\\
-% |\end{floatrow}|
-% \end{quote}
-%
-% И теперь пример. Первый флот (в |\ffigbox|) имеет ширину
-% по умолчанию, равную <<колонке>>
-% ряда, следующий использует ширину включённой графики (использована
-% команда |\FBwidth| в дополнительном аргументе \meta{width}),
-% третий занимает оставшееся место в ряду
-% которое подсчитывается командой |\Xhsize|.
-%
-% \emph{Замечание}. Обычно команда |\Xhsize| используется для
-% последнего флота в ряду. Но
-% если вы используете пакет \pkg{calc} вы можете попытаться
-% использовать |\Xhsize| раньше, если известна
-% \emph{абсолютная} величина ширины флотов по правую сторону,
-% или использовать в аргументе \meta{width} нечто вроде |\Xhsize/2|
-% а затем |\Xhsize| для последних двух боксов в |\floatbox|,
-% см. также примеры \file{frsample10}--\file{frsample12},
-% и файл \file{fr-sample.tex}.
-%\begin{verbatim}
-%\begin{floatrow}[3]
-%\ffigbox
-%{\caption{Рисунок рядом~I...}...}
-%{...}
-%
-%\ffigbox[\FBwidth]
-%{\caption{Рисунок рядом~II...}...}
-%{...}
-%
-%\ffigbox[\Xhsize]
-%{\caption{Рисунок рядом~III...}...}
-%{...}
-%\end{floatrow}
-%\end{figure}
-%\end{verbatim}
-% \begin{figure}
-% \begin{floatrow}[3]
-% \ffigbox
-% {\caption{Рисунок рядом~I, ширина <<колонки>>}%
-% \label{fig:row:WcatI}}
-% {\unitlength1.25\unitlength\ifx\pspicture\undefined
-% \else\psset{unit=\unitlength}\fi
-% \input{TheCat.picture}}
-%
-% \ffigbox[\FBwidth]
-% {\caption{Рисунок рядом~II в окружении \env{floatrow},
-% ширина бокса равна ширине графики}\label{fig:row:BcatI}}
-% {\unitlength1.25\unitlength\ifx\pspicture\undefined
-% \else\psset{unit=\unitlength}\fi
-% \input{TheBlackCat.picture}}
-%
-% \ffigbox[\Xhsize]
-% {\caption{Рисунок рядом~III в \env{floatrow},
-% занимает остальное место в ряду}%
-% \label{fig:row:mouseI}}
-% {{\setlength\unitlength{\hsize/58}\ifx\pspicture\undefined
-% \else\psset{unit=\unitlength}\fi
-% \input{Mouse.picture}}}
-% \end{floatrow}
-% \end{figure}%
-% Результат вы видите в ряду
-% рисунков~\ref{fig:row:WcatI}--\ref{fig:row:mouseI}. Вертикальное
-% выравнивание флотов лежит по нижней линии верхней части
-% (здесь: графики) и верху нижней части (подписи).
-%
-% \subsection{Сноски внутри окружения
-% флота}\label{sec:floatfootnote}
-%
-% Иногда таблица или рисунок может содержать материал, который
-% помечается а снизу даётся объяснение в виде сноски. Пакет имеет
-% механизм, позволяющий размещение сносок внутри окружения флота,
-% как это сделано в окружении \env{minipage}.
-%
-% В тех случаях, когда несколько элементов
-% имеют одинаковую сноску, мы не можем воспользоваться стандартной
-% комбинацией |\footnotemark|---|\footnotetext|, потому что команда
-% |\footnotemark| создаёт знак для сноски основного текста.
-% Для этих случаев данный пакет предлагает макрокоманду
-% |\mpfootnotemark| вместо |\footnotemark|%
-% \footnote{Та же макрокоманда также определена в пакете
-% \pkg{footmisc}, версия 4.10, датированная 2003/01/20.}.
-%
-% Макрокоманда |\floatbox| использует определение линейки для
-% сноски (команда |\FBfootnoterule|) и отбивку до сносок и
-% экспликаций (ключ |footskip=|). (См. также
-% с.~\pageref{sec:footnotestyle} о вариантах линейки для сносок.)
-%
-% \subsection{Макрокоманда для экспликаций}\label{subsec:floatfoot}
-%
-% Если таблица или рисунок имеют дополнительные объяснения
-% которые не должны быть в подписи и они не являются сноской
-% вы можете использовать команду |\floatfoot|. Команда |\floatfoot|
-% использует механизм оформления команд |\caption| и использует
-% выключку, заданную для подписей;
-% |*|-форма (|\floatfoot*|) печатает содержимое в виде обычного
-% абзаца без отступа (см. табл.~\ref{tab:floatfoot}).
-%
-% Для определения шрифта для экспликаций используйте ключ
-% \texttt{footfont=} (с.~\pageref{sec:setfloatfoot}) в команде
-% |\floatsetup|. Вы можете задать
-% дополнительные настройки оформления задав командную
-% последовательность \cmd{\captionsetup[floatfoot]}.
-%\begin{verbatim}
-%\begin{table}
-%\ttabbox
-%{\caption{Таблица с экспликацией}%
-%\label{tab:floatfoot}}
-%{\extrarowheight1pt
-% \tabcolsep2\tabcolsep
-% \begin{tabular}{|l|c|c|}
-% \hline
-% ...
-% \end{tabular}%
-% \floatfoot*{`Data I' column ...}}
-%\end{table}
-%\end{verbatim}
-% \DeleteShortVerb{\|}%
-% \begin{table}
-% \ttabbox
-% {\caption{Таблица с экспликацией}%^^A
-% \label{tab:floatfoot}}%^^A
-% {\extrarowheight1pt\tabcolsep2\tabcolsep
-% \begin{tabular}{|l|c|c|}
-% \hline
-% \thead{Column head} & \thead{Data I} & \thead{Data II} \\
-% \hline
-% First row & \phantom01 & 2 \\
-% Second row & \phantom06 & 4 \\
-% Third row & 28 & 8 \\
-% \hline
-% \end{tabular}%^^A
-% \floatfoot*{`Data I' column---numbers which equal to sum of all
-% their divisors; `Data II' column---$2^n$ values}}
-% \end{table}%
-% \MakeShortVerb{\|}%
-%
-% \emph{Замечания.} 1)\enskip Пакет \pkg{float} определяет
-% дополнительный аргумент после текста подписи. Поскольку эта
-% возможность не была документирована в части документации для
-% пользователей текущая версия пакета \pkg{caption} (3.0 и выше),
-% а также пакет \pkg{floatrow}, не поддерживают эту возможность.
-% Используйте команду |\floatfoot| и команды
-% |\footnote|/|\footnotemark|/|\footnotetext|.
-%
-% 2)\enskip Если вы используете одновременно команды |\floatfoot|
-% и |\footnote| внутри одного флота, содержимое команды |\floatfoot|
-% появится над |\footnote|.
-%
-% 3)\enskip Сноски и экспликации могут быть размещены несколькими
-% способами: в самом низу флота, под подписью
-% (даже в случае подписи сверху). См. с.~\pageref{foot:pos}
-% и файл примера \file{frsample01.tex}. В случае подписи сбоку,
-% сноски и экспликации всегда помещаются под подписью.
-%
-%
-% \subsection{Корректировка вертикальных отбивок
-% в флоте}\label{sec:FBabskips}
-%
-% В заключительном варианте документа вам возможно понадобится
-% откорректировать вертикальные отбивки между флотом и основным
-% текстом, между содержимым объекта и подписью.
-%
-% Для изменения отбивок между флотом и основным текстом вы можете
-% использовать две простые команды |\FBaskip| и |\FBbskip|.
-% Например, определите
-% \begin{verse}
-% |\renewcommand\FBaskip{-4pt}|
-% \end{verse}
-% чтобы передвинуть флот вверх (или уменьшить отбивку сверху)
-% на 4pt. В данном документе
-% команда |\FBaskip| понадобилась для корректировки положения
-% некоторых рисунков в оборку.
-%
-% Используйте команду |\vspace| для корректировки отбивок вокруг
-% содержимого объекта\footnote{В простом окружении флота можно
-% пользоваться и командой \cmd{\vskip}. Но команды \cmd{\floatbox}
-% (сама \cmd{\floatbox}, \cmd{\ffigbox}\dots) в случае использования
-% в аргументе \meta{width} опции \cmd{\FBwidth}, выдадут сообщение
-% об ошибке если встретят команду \cmd{\vskip}.}.
-%
-% \subsection{Плавающие объекты как в обычном \LaTeX'е}
-%
-% Пакет \pkg{floatrow} переопределяет окружение флотов так, чтобы
-% на выходе получалось единообразное
-% оформление всех флотов. Это накладывает некоторые ограничения
-% на запись флота в исходном файле, о которых, в частности,
-% говорилось во введении. Если вам всё
-% же нужно окружение, работающее как в обычном \LaTeX'е
-% поместите команду |\RawFloats| \emph{внутри} окружения:
-%\begin{verbatim}
-%\begingroup
-%\captionsetup[table]{position=top}
-%\begin{figure}\RawFloats
-%\begin{minipage}{0.45\textwidth}
-%\centering ...
-%\caption{...}\label{...}
-%\end{minipage}
-%\begin{minipage}{0.45\textwidth}
-%\captionof{table}{...}\label{...}
-%\centering ...
-%\end{minipage}
-%\end{figure}
-%\endgroup
-%\end{verbatim}
-% и вы получите рис.~\ref{Right:expect:fig}
-% и табл.~\ref{Right:expect:tab}\footnote{Это будет работать,
-% если вы не используете необычного оформления.}.
-% \begingroup
-% \captionsetup[table]{position=top}
-% \begin{figure}\RawFloats
-% \begin{minipage}{0.45\textwidth}
-% \centering \input{Mouse.picture}
-% \caption{Подрисуночная подпись в обычном \LaTeX'е}%
-% \label{Right:expect:fig}
-% \end{minipage}
-% \begin{minipage}{0.45\textwidth}
-% \captionof{table}{Табличный заголовок в обычном
-% \LaTeX'е}\label{Right:expect:tab}
-% \centering\tabcolsep3\tabcolsep
-% \begin{tabular}{|c|c|} A & B \\ C & D \end{tabular}
-% \end{minipage}
-% \end{figure}
-% \endgroup
-%
-% Из приведённого ниже примера видно, что окружение \env{floatrow}
-% и команды |\floatbox| всё равно
-% работают после |\RawFloats| (рис.~\ref{intro:leftfig:raw}
-% и табл.~\ref{intro:righttab:raw})
-%\begin{verbatim}
-%\begin{figure}\RawFloats\CenterFloatBoxes
-% \begin{floatrow}
-% \floatbox{figure}
-% {...}{\caption{...}\label{...}}
-%
-% \floatbox{table}[\FBwidth]
-% {...}{\caption{...}\label{...}}
-% \end{floatrow}
-%\end{figure}
-%\end{verbatim}
-% \begin{figure}\RawFloats\CenterFloatBoxes
-% \begin{floatrow}
-% \floatbox{figure}
-% {\input{Mouse.picture}}
-% {\caption{Подрисуночная подпись внутри \cmd{\floatbox} в обычном
-% \LaTeX'е}\label{intro:leftfig:raw}}%
-%
-% \floatbox{table}[\FBwidth]
-% {\caption{Табличный заголовок внутри \cmd{\floatbox}
-% в обычном \LaTeX'е}\label{intro:righttab:raw}}
-% {\tabcolsep3\tabcolsep\begin{tabular}{|c|c|} A & B \\ C & D
-% \end{tabular}}
-% \end{floatrow}
-% \end{figure}%^^A
-% См. также с.~\pageref{mixrow} о том как задать и выровнять
-% различные типы флотов как рис.~\ref{intro:leftfig:raw} и
-% табл.~\ref{intro:righttab:raw} в одном ряду
-% (окружении \env{floatrow}).
+%^^A% you'll never get page breaks before anchored float.
+%^^A% \subsection{Пакет \package{rotfloat}}
+% вы запретите разрыв до флота «на якоре».
+%
+% \allowpostlistbreaks\medskip\noindent
+% \DescribeMacro{\RestoreSpaces}
+%^^A% The external version of abbreviation of internal command |\@nobreakfalse|.
+%^^A% It switches off |\if@nobreak| flag.
+%^^A% The main (and most visible) usage of this flag---managing of
+%^^A% vertical spaces between two sectioning commands (it cancels the space before for next
+%^^A% section command of the pair); spaces before list environments (cancels the space
+%^^A% before list just after sectioning command) and other similar cases.
+% Добавлена ещё одна простая команда, пользовательский вариант внутренней
+% команды |\@nobreakfalse|.
+% Команда отключает флаг |\if@nobreak|.
+% Основное (и~самое заметное) действие этого флага \cdash--- управление
+% вертикальными отбивками между двумя элементами рубрикации (он отменяет отбивку сверху
+% для следующего из двух стоящих подряд заголовков);
+% отбивки до окружений перечней (отменяет отбивку
+% до перечня сразу после заголовка) и~в~других подобных ситуациях.
+%
+%^^A% Usually this flag turned off at the next paragraph (or |\par| command),
+%^^A% but in some cases this turn off cannot be happen in necessary point.
+%^^A% The |\RestoreSpaces| command would help.
+% По правилам этот флаг отключается в~начале следующего абзаца (или командой |\par|),
+% но в~некоторых случаях этого не происходит в~нужный момент.
+% Команда |\RestoreSpaces| в~этих случаях должна помочь.
+%
+%^^A% \subsection{The \package{rotfloat} Package}
+% \subsection{Пакет \package{rotfloat}}
+%
+%^^A% Code of \package{rotfloat} package was also borrowed by \package{floatrow}
+%^^A% package. In the case of loaded \package{rotfloat} package before
+%^^A% \package{floatrow} you will get error message.
+% Код пакета \package{rotfloat} был также позаимствован
+% пакетом \package{floatrow}.
+% Если пакет \package{rotfloat} был загружен до \package{floatrow},
+% вы получите сообщение об ошибке.
%
+%^^A% The \package{floatrow} package loads code which pretends that
+%^^A% \package{rotfloat} already loaded, so next loads are ignored.
+%^^A% The \package{rotfloat} allowed in the |\usepackage|
+%^^A% line with \package{rotating} package, which could have options. It is
+%^^A% necessary to delete \package{rotfloat} package from |\usepackage| line
+%^^A% where also \package{rotating} package loaded with options: otherwise
+%^^A% you may get `option clash' error message.
+% Пакет \package{floatrow} вводит код, который эмулирует уже загруженный
+% пакет \package{rotfloat} и~последующая его загрузка игнорируется.
+% Пакет \package{rotfloat} построен таким образом, что может быть
+% загружен в~одной строке \verb|\usepackage| вместе
+% с~пакетом \package{rotating}, который может иметь опции. Необходимо
+% также удалить пакет \package{rotfloat} из строки \verb|\usepackage|,
+% где задан пакет \package{rotating} с~опциями: в~противном случае
+% вы получите сообщение об ошибке со словами `option clash'.
%
+% \clearpage
+%\newpage
% \section{Тандемы стилей}
%
-% Несколько следующих разделов показывают примеры и объясняют
-% некоторые замеченные особенности с использованием пакета
-% \pkg{floatrow} вместе с другими пакетами. Это не полный
-% список таких пакетов. Возможно совмещение и с другими версиями
-% указанных пакетов, и с неуказанными пакетами тоже.
-%
-% \subsection{Пакет \pkg{caption}}
-%
-% Тестировалось с версиями v3.0a--v3.0i.
-%
-% Пакет \pkg{caption} обладает сильным механизмом создания
-% оформления подписей, поэтому \pkg{floatrow} адресует создание
-% новых стилей для подписей этому пакету (см. документацию для
-% пакета \pkg{caption}).
-%
-% Пакет \pkg{floatrow} добавляет возможность создать варианты
-% оформления подписей для флотов с различным размещением (например
+%^^A% The next few sections show examples and explain some noticed
+%^^A% features with usage of \package{floatrow} and another package. There is not
+%^^A% the full list of style compatibilities. You may succeed with other
+%^^A% versions of mentioned packages, and maybe with not mentioned
+%^^A% packages too.
+% Несколько следующих разделов показывают примеры и~объясняют
+% некоторые замеченные особенности с~использованием пакета
+% \package{floatrow} вместе с~другими пакетами. Это не полный
+% список таких пакетов. Возможна совместимость и~с~другими версиями
+% указанных пакетов, и~с~неуказанными пакетами тоже.
+%
+%^^A% \subsection{The \package{caption} Package}\label{ssec:caption}
+% \subsection{Пакет \package{caption}}
+%
+%^^A% Tested (and compatible) with version v3.0q.
+% Тестировалось (и~совместимо) с~версией v3.0q.
+%
+%^^A% The \package{caption} package has strong mechanism of creating of
+%^^A% caption layout, so \package{floatrow} addresses the creation of new
+%^^A% caption styles to this package (see documentation for \package{caption}
+%^^A% package).
+% Пакет \package{caption} обладает сильным механизмом создания
+% оформления подписей, поэтому \package{floatrow} адресует создание
+% новых стилей для подписей этому пакету (см.~документацию для
+% пакета \package{caption}).
+%
+%^^A% The \package{floatrow} adds possibility to create a variations of captions
+%^^A% for floats in different positions or layouts (e.g. like wide or
+%^^A% two-column floats or rotated floats) using optional argument of
+%^^A% |\captionsetup|.
+% Пакет \package{floatrow} добавляет возможность создать варианты
+% оформления подписей для флотов с~различным размещением (например
% для флотов вразрез двух колонок или широких флотов,
% или развёрнутых вертикально флотов) за счёт использования
-% дополнительного аргумента в команде
+% дополнительного аргумента в~команде
% |\captionsetup|.
%
+%^^A% For example you want to create special caption layout for wide or
+%^^A% two-column floats. In this case you may use
% Например вы желаете создать специальное оформление для подписи
% под широким флотом или
-% флотом вразрез двух колонок. В этом случае вы можете использовать
+% флотом вразрез двух колонок. В~этом случае вы можете использовать
% \begin{quote}
% |\captionsetup[widefloat]|\marg{options}
% \end{quote}
+%^^A% or for wide or two-column figures:
% или, для широких или рисунков вразрез двух колонок:
% \begin{quote}
% |\captionsetup[widefigure]|\marg{options}
% \end{quote}
-% Приоритет опций в команде |\captionsetup| такой же, как в опциях
-% команды |\floatsetup|. В приведённых примерах настройки
+%^^A% The priority of |\captionsetup| optional arguments is similar to
+%^^A% |\floatsetup| ones. In current examples |\captionsetup[widefigure]|
+%^^A% will be stronger than |\captionsetup[widefloat]|. The priority
+%^^A% and usage of ``\meta{float subtypes}'' in optional arguments
+%^^A% see on the page~\pageref{stsetorder}\label{cap:beside:order}).
+% Приоритет опций в~команде |\captionsetup| такой же, как в~опциях
+% команды |\floatsetup|. В~приведённых примерах настройки
% |\captionsetup[widefigure]| будут <<сильнее>>, чем
-% |\captionsetup[widefloat]|. Приоритет и использование
-% <<\meta{float subtype}>> в дополнительных аргументах
-% см. на с.~\pageref{stsetorder}\label{cap:beside:order}.
+% |\captionsetup[widefloat]|. Приоритет и~использование
+% <<\meta{float subtype}>> в~дополнительных аргументах
+% см.~на с.~\pageref{stsetorder}\label{cap:beside:order}.
+%
%
%
-% \subsection{Пакет \pkg{subfig}}
%
-% Тестировалось с версиями 1.2, датированной 2003/12/20 и 1.3
-% датированной 2005/06/28.\nopagebreak
%
-% Пример с \cmd{\subfloat}'ами (табл.~\ref{tab:tabIII}).
-% Команда настройки оформления в преамбуле,
-% |\floatsetup[table]{style=Plaintop}|, включает
+%
+%^^A% \subsection{The \package{subfig} Package}\label{ssec:subfig}
+% \subsection{Пакет \package{subfig}}\label{ssec:subfig}
+%
+%^^A% Tested (and compatible) with version 1.3,
+%^^A% dated 2005/06/28. For the \package{subfig} package there are additional
+%^^A% macros in \package{floatrow} which create of row of subfloats;
+%^^A% put subcaption label beside contents of subfloat; put alone
+%^^A% subcaption label.
+% Тестировалось (и~совместимо) с~версией~1.3
+% датированной 2005/06/28. В~пакете \package{floatrow} добавлены
+% макрокоманды для размещения частей флота рядом; помещения
+% номера подподписи сбоку; задания номера подподписи
+% отдельно.
+%
+%^^A% \subsubsection{Additions in \package{floatrow}}
+%^^A% \label{ssec:sidelabelsubfloat}
+% \subsubsection{Добавления в~пакете \package{floatrow}}
+% \label{ssec:sidelabelsubfloat}
+%
+%^^A% The example with \cmd{\subfloat}'s (table~\ref{tab:tabIII}). The
+%^^A% setting command in preamble |\floatsetup[table]{style=Plaintop}|%^^A
+%^^A% \FRmpar{Subcaption above subtable}{FAD:subcapabove}
+%^^A% includes also settings for subcaption positions used with
+%^^A% \package{subfloat} package (like |\captionsetup[table]{position=top}| in
+%^^A% \package{caption} package):
+% Пример с~\cmd{\subfloat}'ами (табл.~\ref{tab:tabIII}).
+% Команда настройки оформления в~преамбуле,
+% |\floatsetup[table]{style=Plaintop}|,%^^A
+% \FRmpar{Подподпись над частью таблицы}{FAD:subcapabove}
+% включает
% также настройки для положения подподписей, задаваемых пакетом
-% \pkg{subfloat} (аналогично |\captionsetup[table]{position=top}| в
-% пакете \pkg{caption}):
-%\begin{verbatim}
-%\begin{table}\extrarowheight1pt
-% \floatbox{table}[\FBwidth]
-% {\caption{Two ...}\label{...}}
-% {\begin{subfloatrow}
-% \subfloat[First table]
-% {\begin{tabular}{|l|c|c|}
-% ...
-% \end{tabular}}
-% \subfloat[Second table]
-% {\begin{tabular}{|l|c|c|}
-% ...
-% \end{tabular}%
-% \end{subfloatrow}}}
-%\end{table}
-%\end{verbatim}
+% \package{subfloat} (аналогично |\captionsetup[table]{position=top}|
+% в~пакете \package{caption}):
+%\begin{Quote}\obeylines\parskip-.15pt
+%|\begin{table}\extrarowheight1pt|\nopagebreak
+%| \floatbox{table}[\FBwidth]|
+%| {\caption{Two ...}\label{...}}|
+%| {\begin{subfloatrow}|
+%| \subfloat[First table]|
+%\verb+ {\begin{tabular}{|l|c|c|}+
+%| ...\end{tabular}}|
+%| \subfloat[Second table...]|
+%\verb+ {\begin{tabular}{|l|c|c|}+
+%| ...\end{tabular}%|
+%| \end{subfloatrow}}}|
+%|\end{table}|
+%\end{Quote}
% \DeleteShortVerb{\|}%
% \captionsetup[subtable]{textfont=md}
-% \begin{table}[h]\extrarowheight1pt
+% \begin{table}[h]\extrarowheight1pt\tabcolsep1.5\tabcolsep
% \floatbox{table}[\FBwidth]
% {\caption{Две подтаблицы (\cmd{\subtable})
-% (созданные с пакетом \pkg{subfig})}\label{tab:tabIII}}
+% (созданные с пакетом \package{subfig})}\label{tab:tabIII}}
% {\begin{subfloatrow}
% \subfloat[Первая подтаблица]
% {\begin{tabular}{|l|>{\phantom0}c|>{\phantom0}c|}
@@ -2329,7 +4534,7 @@
% \hline
% \end{tabular}}
%
-% \subfloat[Вторая подтаблица with long long long subcaption]
+% \subfloat[Вторая подтаблица с~длинным длинным заголовком]
% {\begin{tabular}{|l|c|c|}
% \hline
% \multirowthead{2}[-1ex]{Column Head}
@@ -2348,85 +4553,378 @@
% \end{table}%
% \MakeShortVerb{\|}%
%
-% \emph{Замечание.} В данном примере было использовано окружение
-% \env{subfloatrow}. Это упрощённый вариант окружения
+%^^A% The \env{subfloatrow} is simplified \env{floatrow} environment, which
+%^^A% expands vertical alignment of float contents to subfloats and
+%^^A% puts horizontal separator, defined by \texttt{subfloatrowsep=}
+%^^A% key. This key and uses the same options
+%^^A% as \texttt{floatrowsep=} and \texttt{capbesidesep=} keys (options of
+%^^A% these keys defined by |\DeclareFloatSeparators| command,
+%^^A% page~\pageref{setup:DeclareFloatSeparators}).
+% Окружение \env{subfloatrow} \cdash--- это упрощённый вариант окружения
% \env{floatrow}, который распространяет вертикальное выравнивание
-% содержимого объектов и подписей, а между подфлотами
+% содержимого объектов и~подписей, а~между подфлотами
% создаёт разделитель, заданный ключом \texttt{subfloatrowsep=}.
-% Этот ключ использует те же опции, что и ключи
-% \texttt{floatrowsep=} и \texttt{capbesidesep=} (опции этих ключей
+% Этот ключ использует те же опции, что и~ключи
+% \texttt{floatrowsep=} и~\texttt{capbesidesep=} (опции этих ключей
% задаются командой |\DeclareFloatSeparators|,
-% с.~\pageref{decl:sep}).
+% с.~\pageref{setup:DeclareFloatSeparators}).
%
%^^A To use \env{subfloatrow} environment load
-%^^A \pkg{fr-subfig}\footnote{This package could have only beta-status,
-%^^A because of it redefines two macros of \pkg{subfig} package for
+%^^A \package{fr-subfig}\footnote{This package could have only beta-status,
+%^^A because of it redefines two macros of \package{subfig} package for
%^^A creation of subcaption and subfloat boxes.} package installed
-%^^A together with \pkg{floatrow}.\pagebreak[3]
-%
-% См. примеры с окружениями \env{subfloatrow} в файлах примеров
-% \file{frsample03.tex}, \file{frsample05.tex}; а также
+%^^A together with \package{floatrow}.\pagebreak[3]
+%
+%^^A% See examples with \env{subfloatrow} environment in sample files
+%^^A% \file{frsample03.tex}, \file{frsample05.tex}; and also
+%^^A% \file{frsample10.tex}--\file{frsample12.tex} where aligned contents
+%^^A% of beside subfloats are used in different layouts.)
+% См. примеры с~окружениями \env{subfloatrow} в~файлах примеров
+% \file{frsample03.tex}, \file{frsample05.tex}; а~также
% \file{frsample10.tex}--\file{frsample12.tex} где подфлоты
-% даны в различных оформлениях и размещениях.)
-%
-% Следующий пример с подписью сбоку
-% (рис.~\ref{fig:subfig:catsI}).%^^A
-% \footnote{В версии 1.2 подобъекты рядом, один из которых помещён в
-% \cmd{\fbox}, а другой "--- нет (как
-% рис.~\ref{fig:subfig:catsI}), и в других подобных ситуациях
-% могут дать невыровненные по низу (верху)
-% подподписи. В данном примере (когда загружен пакет
-% \pkg{pstricks}) при использовании версии
-% 1.2 пришлось задать следующие строки для
-% подрисунка~\ref{subfig:b}:\\[2ex]\ttfamily
-% \cmd{\raisebox}\{\cmd{\depth}\}\{\cmd{\input}\{\texttt{TheBlackCat.picture}\}\}}
-%\begin{verbatim}
-%\floatsetup{style=Shadowbox,capbesidesep=columnsep,
-% capbesideframe=yes,capbesideposition={top,inside}}
-%\fcapside[\FBwidth]
-%{\begin{subfloatrow}
-% \subfloat[White ...]{...}
-% \subfloat[Black ...]{...}
-%\end{subfloatrow}}
-%{\caption{...}}
-%\end{verbatim}
-% \floatsetup[figure]{style=Shadowbox,capbesidesep=columnsep,capbesideframe=yes,
-% capbesideposition={top,inside}}
+% даны в~различных оформлениях и~размещениях.)
+%
+%^^A% The next goes example with beside caption (see
+%^^A% figure~\ref{fig:subfig:catsI}).%^^A
+%^^A%^^A% \footnote{In version 1.2 the beside boxed and non-boxed subfloat
+%^^A%^^A% contents (like in figure~\ref{fig:subfig:catsI}) could not get aligned
+%^^A%^^A% bottom (top) subcaptions. In this example I ought to use following
+%^^A%^^A% lines for subfigure~\ref{subfig:b}, when \package{pstricks} package is
+%^^A%^^A% loaded:\\[2ex]\ttfamily
+% Следующим идёт пример рисунка с~подписью сбоку (рис.~\ref{fig:subfig:catsI}).%^^A
+%^^A% \footnote{В~версии 1.2 подобъекты рядом, один из которых помещён
+%^^A% \cmd{\fbox}, а~другой \cdash--- нет (как
+%^^A% в~рис.~\ref{fig:subfig:catsI}), и~в~других подобных ситуациях
+%^^A% могут дать невыровненные по низу (верху)
+%^^A% подподписи. В~данном примере (когда загружен пакет
+%^^A% \package{pstricks}) при использовании версии~1.2
+%^^A% пришлось задать следующие строки для
+%^^A% подрисунка~\ref{subfig:b}:\\[2ex]\ttfamily
+%^^A% \cmd{\raisebox}\{\cmd{\depth}\}\{\cmd{\input}\{\texttt{Cat.picture}\}\}}
+%\begin{Quote}
+%\meta{preamble}\nopagebreak
+%|\floatsetup[figure]{|\hyperref[setup:style]{\texttt{style}}|=Shadowbox,|%^^A
+% \hyperref[setup:capbesidesep]{\texttt{capbesidesep}}|=columnsep,|
+%| |\hyperref[setup:capbesideframe]{\texttt{capbesideframe}}|=yes,|%^^A
+% \hyperref[setup:capbesideposition]{\texttt{capbesideposition}}|={left,top}}|
+%|\floatsetup[subfigure]{|\hyperref[setup:style]{\texttt{style}}|=plain}|
+%|\DeclareCaptionLabelFormat{list}{\bothIfFirst{#1}{ }#2)}|
+%|\captionsetup[subfigure]{labelformat=list,justification=centerlast,|
+%| strut=no}|\nopagebreak
+%\meta{preamble}
+%|\fcapside[\FBwidth]|
+%| {\begin{subfloatrow}|
+%| \subfloat[...\label{...}]{...}|
+%| \subfloat[...\label{...}]{...}%|
+%| \end{subfloatrow}}|
+%|{\caption{...}}|
+%\end{Quote}
+% \floatsetup[figure]{style=Shadowbox,capbesidesep=columnsep,
+% capbesideframe=yes,capbesideposition={left,top}}
+% \floatsetup[subfigure]{style=plain}
+% \captionsetup[subfigure]{labelformat=list,justification=centerlast,strut=no}
% \begin{figure}[h]
% \fcapside[\FBwidth]
% {\begin{subfloatrow}
-% \subfloat[Белая кошка\label{subfig:w}]{\input{TheCat.picture}}
+% \subfloat[Кот\label{subfig:w}]{\unitlength.99\unitlength\input{Cat.picture}}
%
-% \subfloat[Чёрный кот\label{subfig:b}]%^^A
-% {\input{TheBlackCat.picture}}%
+% \subfloat[Другой кот\label{subfig:b}]%^^A
+% {\unitlength.9\unitlength\input{TheCat.picture}}%
% \end{subfloatrow}}
-% {\caption{Подпись сбоку выровненная по верху, оформление флота в
-% стиле \texttt{Shadowbox}}\label{fig:subfig:catsI}}
+% {\caption[Ряд подфлотов]{Подпись сбоку
+% выровнена по верху; стиль оформления флота
+% \texttt{Shadowbox}. Помещены две части рисунка:
+% \protect\ref{subfig:w} и~\protect\ref{subfig:b}}\label{fig:subfig:catsI}}
% \end{figure}
%
+% \DescribeMacro{\sidesubfloat}
+%^^A% Another addition in \package{floatrow} for subfloats is command,%^^A
+%^^A% \FRmpar{Subcaption beside subfloat}{FAD:sublabelbeside}
+%^^A% which puts subcaption label beside subfloat. The subcaption label always
+%^^A% appears on the left side. The key |subcapbesideposition=|
+%^^A% \DescribeMacro{subcapbesideposition}\label{setup:subcapbesideposition}%^^A
+%^^A% sets vertical alignment of beside subcaption and subfloat.
+%^^A% The options analogous to options for |capbesideposition=| key:
+% Ещё одно определение \package{floatrow} для подфлотов \cdash--- команда,%^^A
+% \FRmpar{Метка подподписи сбоку подфлота}{FAD:sublabelbeside}
+% которая помещает метку подподписи сбоку подфлота. Метка подподписи
+% всегда располагается слева от подфлота. Ключ |subcapbesideposition=|
+% \DescribeMacro{subcapbesideposition}\label{setup:subcapbesideposition}%^^A
+% определяет взаимное вертикальное выравнивание метки и~подфлота.
+% Название опций аналогично опциям вертикального выравнивания в~ключе
+% |capbesideposition=|:%^^A
+% \par\RestoreSpaces
+% \begin{Options}{\OptionLabel}\samepage
+% \item[top]
+%^^A% subcaption label aligned to the top of object;
+% метка выровнена по верху объекта;
+% \item[bottom]
+%^^A% subcaption label aligned to the bottom of object;
+% метка по середине объекта;
+% \item[center]
+%^^A% subcaption label aligned to the center of float contents.
+% метка по низу объекта (задана по умолчанию).
+% \end{Options}
%
-% \vfil\pagebreak[4]
-% \subsection{Пакет \pkg{wrapfig}}
+%^^A% The figure~\ref{fig:subfig:catsII} shows layout with subfloat labels beside.
+% Рисунок~\ref{fig:subfig:catsII} демонстрирует оформление с~метками частей рисунка слева.
+% \begingroup
+% \begin{Quote}%
+%\meta{preamble}\nopagebreak
+%|...|
+%|\floatsetup[figure]{|\hyperref[setup:style]{\texttt{style}}|=plain,|%^^A
+% \hyperref[setup:subcapbesideposition]{\texttt{subcapbesideposition}}|=top}|
+%\meta{preamble}
+% |\begin{figure}[H]|
+% | \ffigbox[\FBwidth]|
+% | {\begin{subfloatrow}|
+% | \sidesubfloat[]{...\label{...}}%|
+% | |
+% | \sidesubfloat[]{...\label{...}}%|
+% | \end{subfloatrow}}|
+% |{\caption[...]{...}\label{...}}|
+% |\end{figure}|
+% \end{Quote}
+% \floatsetup[figure]{style=plain,subcapbesideposition=top}
+% \begin{figure}[h]
+% \ffigbox[\FBwidth]
+% {\begin{subfloatrow}
+% \sidesubfloat[]{%
+% {\unitlength.9\unitlength\input{Cat.picture}\label{subfig:wI}}}
+%
+% \sidesubfloat[]{\unitlength.9\unitlength\input{TheCat.picture}\label{subfig:bI}}%
+% \end{subfloatrow}}
+% {\caption[Ряд подфлотов (метки сбоку)]{Подпись сбоку выровнена по средней линии.
+% Помещены две части рисунка:
+% \protect\ref{subfig:wI} и~\protect\ref{subfig:bI}}\label{fig:subfig:catsII}}
+% \end{figure}
+% \endgroup
+%
+% \DescribeMacro{\subfloatlabel}
+%^^A% There are cases when usage of something like |\subfloat[]\label{..}}}|
+%^^A% is needed. The first case shows the figure~\ref{fig:subfig:catsIII}---the
+%^^A% funny picture environment where subfloat labels were |\put|
+%^^A% as a part of subfigures.
+%^^A% Other---when you use mechanism of \package{psfrag} package and replace text entries
+%^^A% from PostScript file with \LaTeX{} ones. Unfortunately, the \package{subfig} package
+%^^A% creates unnecessary spaces around alone subfloat label in the
+%^^A% |\subfloat[]\label{..}}}| combination. The \package{fr-subfig} tries to fix this problem.
+% Иногда бывает нужна комбинация |\subfloat[]{\label{..}}|.
+% Первый случай демонстрирует рис.~\ref{fig:subfig:catsIII} \cdash--- забавное
+% окружение \env{picture}, где метки подфлота помещены командой |\put|,
+% внутри рисунка.
+% Другой случай \cdash--- использование пакета \package{psfrag} для замены текста
+% PostScript-файлов на \LaTeX'овский. К~сожалению, при задании |\subfloat[]{\label{..}}|
+% пакет \package{subfig} создаёт ненужные отбивки
+% вокруг метки подфлота. Пакет \package{fr-subfig} пытается решить проблему.
+%
+%^^A% This command based on |\subfloat[]\label{..}}}| sentence and
+%^^A% puts alone subcaption label with necessary number. The full variant
+%^^A% of |\subfloatlabel|
+% Данная команда базируется на комбинации |\subfloat[]{\label{..}}|
+% и~помещает метку части рисунка с~нужным номером. Полный вариант
+% команды |\subfloatlabel|:
+% \par\RestoreSpaces
+% \begin{quote}
+% |\subfloatlabel|\oarg{subfloat number}\oarg{label entry}
+% \end{quote}
+% является сокращением следующего кода:
+% \begin{Quote}
+% |\setcounter|\marg{sub{\upshape\texttt{\char`\\@captype}}}\marg{subfloat number-1}\\
+% |\subfloat[]{\label{|\meta{label entry}|}}|
+% \end{Quote}
%
% \begingroup
-% \def\FBaskip{-14pt}
+% \begin{Quote}%
+%\meta{preamble}\nopagebreak
+%|...|
+%|\floatsetup[figure]{|\hyperref[setup:style]{\texttt{style}}|=plain}|
+%|\DeclareCaptionListOfFormat{comma-separated}{#1,\,#2}|
+%|\captionsetup[subfigure]{listofformat=comma-separated}|
+% |\begin{figure}[h]|
+% |\fcapside[\FBwidth]|
+% | {\unitlength2\unitlength\fboxsep-.4pt|
+% | \begin{picture}(90,30)(0,0)|
+% | \put(0,0){\framebox(40,30)[bl]{}}|
+%|...|
+%\meta{preamble}
+% \end{Quote}
+% \floatsetup[figure]{style=plain}
+% \captionsetup[subfigure]{listofformat=comma-separated}
+% \begin{figure}[h]
+% \fcapside[\FBwidth]
+% {\unitlength2\unitlength\fboxsep-.4pt
+% \begin{picture}(90,30)(0,0)
+% \put(0,0){\framebox(40,30)[bl]{}}
+% \put(2,2){\makebox(0,0)[bl]{\subfloat[]{\label{subfig:wII}}}}
+% \put(0,0){
+% \put(6,18){\put(0,0){\line(2,3){5}}
+% \put(10,0){\line(-2,3){5}}}
+% \put(24,18){\put(0,0){\line(2,3){5}}
+% \put(10,0){\line(-2,3){5}}}}
+%
+% \put(50,0){\framebox(40,30)[bl]{}}
+% \put(52,2){\makebox(0,0)[bl]{\subfloatlabel[3][subfig:bII]{}%^^A
+% }}%^^A\label{}
+% \put(50,0){
+% \put(8,10){\put(4.5,4.5){\circle{9}}
+% \put(4.5,0){\line(0,1){9}}}
+% \put(23,10){\put(4.5,4.5){\circle{9}}
+% \put(4.5,0){\line(0,1){9}}}}
+% \end{picture}}
+% {\caption[Графика с~метками частей рисунка]{%^^A
+% Нарисованы два простых рисунка.
+% На первом \protect\cdash--- кошачьи уши (\protect\subref{subfig:wII}), помеченные как
+% \cs{subfloat}\texttt{[]\char`\{\char`\}};
+% а~\cs{subfloatlabel}\texttt{[3][subfig:bII]} помечает кошачьи глаза на втором
+% (\protect\subref{subfig:bII})}%^^A
+% \label{fig:subfig:catsIII}}
+% \end{figure}
+%^^A% Please look at the definition of reference to the subfigure, key |listofformat=|.
+%^^A% This format is used, in particular, by |\subref| command: the |\subref{subfig:bII}| gives
+%^^A% reference to the subfigure \subref{subfig:bII}.
+% Обратите внимание на определение формата ссылки на подрисунок, заданный ключом |listofformat=|.
+% Данный формат используется, в~частности, командой |\subref|: |\subref{subfig:bII}| выдал ссылку
+% на часть рисунка \subref{subfig:bII}.
+% \endgroup
+%
+%
+% \clearpage
+% \par\RestoreSpaces
+%^^A% \subsection{The \package{longtable} Package}\label{ssec:longtable}
+% \subsection{Пакет \package{longtable}}\label{ssec:longtable}
+%
+%^^A% Tested with version v4.11, dated 2004/02/01.
+% Тестировалось с~версией v4.11, датированной 2004/02/01.
+% В~русских публикациях
+% рекомендуется использовать версию не ниже указанной.
+%
+%^^A% \subsubsection{Additions in \package{floatrow}}
+%^^A% \label{ssec:LTcapwidth}
+% \subsubsection{Добавления в~пакете \package{floatrow}}
+% \label{ssec:LTcapwidth}
+%
+%^^A% There was added a patch to the |\LT@array| macro (\package{longtable}
+%^^A% package)\footnote{Thanks to A. Sommerfeldt for help to make this
+%^^A% code compact.}: this patch adds the same font settings
+%^^A% as for \env{table} environments, and adds code which helps
+%^^A% to get width of \env{longtable} caption equal to the
+%^^A% width of table. For settings of caption width there was created a key.
+% Был добавлен код в~макрокоманду |\LT@array| пакета
+% \package{longtable}\footnote{Спасибо
+% A.\,Sommerfeldt за помощь в~создании компактного кода.}:
+% этот код задаёт настройки того
+% же шрифта, что и~в~таблицах в~окружении \env{table},
+% а~также возможность задать ширину
+% табличного заголовка в~окружении \env{longtable} равной ширине
+% таблицы. Для задания ширины
+% табличного заголовка задан ключ.
+%
+% \DescribeMacro{LTcapwidth}\label{setup:LTcapwidth}%^^A
+% \FRmpar{Ширина подписи по ширине таблицы longtable}{FAD:LTcapwidth}
+%^^A% This key could have any value, like |5cm| or |\hsize|. In this cases this
+%^^A% key does work of |\LTcapwidth| command. If you'll write
+%^^A% \texttt{LTcapwidth=table} or \texttt{LTcapwidth=contents}, you will get
+%^^A% caption width equal to the width of table. In this case settings for
+%^^A% width of caption use information from \texttt{aux}-file, so you'll get
+%^^A% correct caption width at the time when the width of full table become
+%^^A% stable.
+% Этот ключ может иметь любое значение типа |5cm| или |\textwidth| \cdash--- в~этом
+% случае он дублирует команду |\LTcapwidth|.
+% Если же вы зададите \texttt{LTcapwidth=table} или
+% \texttt{LTcapwidth=contents},
+% ширина табличного заголовка будет равна ширине таблицы. Настройка
+% ширины табличного заголовка в~этом случае производится
+% по информации из \texttt{aux}-файла,
+% поэтому вы получите правильный результат только тогда,
+% когда ширина всей таблицы будет стабильной.
+%
+%^^A% The \env{longtable} environment uses layout settings from
+%^^A% |\floatsetup[table]| and |\floatsetup[longtable]| macros.
+%^^A% The |\floatsetup[longtable]| will be ``strongest'' in this pair.
+% Окружение \env{longtable} использует настройки,
+% заданные в~опциях команды |\floatsetup[table]|
+% и~|\floatsetup[longtable]|. Последние настройки, |\floatsetup[longtable]|,
+% будет <<сильнейшими>> в~этой паре.\medskip
+%
+%^^A% \emph{The addition with version 0.1k}. There is added a
+%^^A% \textrm{beta-temp}\footnote{Again, like with \package{listpen} package, I
+%^^A% hope that such support sooner or later could appear in
+%^^A% \package{longtable} and think it is better to follow
+%^^A% grammar of master-package for similar situations.} package
+%^^A% with simple additions, which allow creation of special head for last
+%^^A% page of longtable environment and special foot for pages before last.
+% \emph{Добавление в~версии~0.1k}. Добавлен
+% \textrm{beta-temp}\footnote{Опять, как и~с~пакетом~\package{listpen},
+% я~надеюсь что подобная поддержка рано или поздно появится в~самом пакете
+% \package{longtable} и~думаю, что лучше использовать названия
+% аналогичные «мастер»-пакету.} пакет
+% с~простыми добавлениями, которые позволяют создание специальной шапки
+% для последней страницы таблицы \texttt{longtable} и~специального подвала
+% для предпоследней.
+%
+% \DescribeMacro{\endlasthead}
+% \DescribeMacro{\endprelastfoot}
+%^^A%%^^A The command |\LTlastpage| defined by hand tells to \package{longtable}'s
+%^^A%%^^A redefined macro the number of pages in longtable environment.
+%^^A% The |\FBendlasthead| command defined for last head of longtable; the
+%^^A% |\FBendprelastfoot| command defined for foot on the page before last.
+%^^A% The syntax analogous as for commands |\endhead|, |\endfirsthead| etc.
+%^^A% (See examples and additional explanation in the sample file
+%^^A% \texttt{sample-longtable.tex} file.)
+%^^A% Команда |\FBLTlastpage| определяется вручную, и~задаёт для изменённой
+%^^A% команды \package{longtable} число страниц занятых окружением \texttt{longtable}.
+% Команда |\endlasthead| определяет последнюю шапку для \texttt{longtable};
+% команда |\endprelastfoot| определяет подвал для предпоследней страницы.
+% Синтаксис определения аналогичен командам |\endhead|, |\endfirsthead| и~т.\,д.
+% (См.~примеры и~дополнительные разъяснения в~файле \texttt{sample-longtable.tex}
+% приложенном к~данному пакету.)
+%
+%^^A% \DescribeMacro{\floatfoot}
+%^^A% The footnote stuff inside \env{longtable} works like in main
+%^^A% text and put text of footnotes
+%^^A% at the bottom of page\footnote{See also \env{longtable} documentation.}.
+%^^A% The command for legends or explications, |\floatfoot|, in current version
+%^^A% inside \env{longtable} has emulation mode, and needs stuff,
+%^^A% similar to |\multicolumn|\meta{n}\allowbreak|{@{}p{\textwidth}@{}}|\allowbreak
+%^^A% |{\floatfoot{..}}|. Since default font definition for explications (|\floatfoot|) also
+%^^A% set to |\footnotesize|, like for footnotes, you may put footnotes-emulations at this
+%^^A% explication block, using |\mpfootnotemark| commands.
+% Механизм создания сносок внутри окружения \env{longtable} работает как
+% в~основном тексте и~помещает текст сносок
+% вниз полосы\footnote{См.~также документацию к~пакету \package{longtable}.}.
+% Команда экспликации, |\floatfoot|, внутри окружения \env{longtable} в~данной версии
+% эмулируется и~для размещения экспликаций требуется код
+% типа |\noalign{\floatfoot{...}}|. Кроме того, поскольку для экспликации по умолчанию задан
+% шрифт |\footnotesize|, как и~для сносок, можно создать эмуляцию сносок
+% в~таблице и~блоке экспликаций, используя команды |\mpfootnotemark|.
+%
+%
+% \clearpage
+%^^A% \subsection{The \package{wrapfig} Package}\label{ssec:wrapfig}
+% \subsection{Пакет \package{wrapfig}}\label{ssec:wrapfig}
+%
+% \begingroup
+% \def\FBaskip{-12pt}
% \floatsetup[figure]{style=ruled,relatedcapstyle=yes,footposition=caption}
-% \begin{wrapfigure}[13]{O}{48mm}
+% \begin{wrapfigure}[10]{O}{42mm}
%^^A \ffigbox[40mm]
-% {\caption{Простой рисунок в оборку (пакет \pkg{wrapfig})}%
+% {\caption{Простой рисунок в оборку (пакет \package{wrapfig})}%
% \floatfoot{Обычный рисунок может не получиться в версии
% 3.3}\label{fig:wrapfig:WcatI}}
-% {\unitlength1.728\unitlength\ifx\pspicture\undefined
-% \else\psset{unit=\unitlength}\fi
+% {\unitlength1.095\unitlength
% \input{TheCat.picture}}
% \end{wrapfigure}
%
-% Тестировано с версией 3.3 датированной 1999/10/12
-% (стиль из группы пакетов \pkg{ltxmisc})
-% и версией 3.6 датированной 2003/01/31 (отдельный пакет).
+%^^A% Tested with version 3.3 dated 1999/10/12 (style from \package{ltxmisc}
+%^^A% bundle) and 3.6 dated 2003/01/31 (the separate \LaTeX\ package).
+% Тестировано с~версией 3.3 датированной 1999/10/12
+% (стиль из группы пакетов \package{ltxmisc})
+% и~версией 3.6 датированной 2003/01/31 (отдельный пакет).
%
+%^^A% Options for environment (text borrowed from package comments):
% Аргументы при задании окружения (текст взят из комментариев
-% к пакету):
+% к~пакету):
% \begin{quote}
% |\begin{wrapfigure}%|\\*
% \strut\quad\oarg{number}\marg{placement}|%|\\*
@@ -2434,16 +4932,24 @@
% |...|\\*
% |\end{wrapfigure}|
% \end{quote}
-% \meta{Placement} это может быть \texttt{r}, \texttt{l},
+%^^A% \meta{Placement} is one of \texttt{r}, \texttt{l}, \texttt{i},
+%^^A% \texttt{o}, \texttt{R}, \texttt{L}, \texttt{I}, \texttt{O}, for
+%^^A% right, left, inside, outside. Lowercase letters set unfloated
+%^^A% positioning, uppercase---floated variant. The figure sticks into
+%^^A% the margin by \meta{overhang}, if given, or by the length
+%^^A% |\wrapoverhang|, which is normally zero. The \meta{number} of
+%^^A% wrapped text lines is normally calculated from the height of the
+%^^A% figure, but may be specified manually, e.g.
+% \meta{Placement} \cdash--- \texttt{r}, \texttt{l},
% \texttt{i}, \texttt{o}, \texttt{R}, \texttt{L}, \texttt{I},
-% \texttt{O}, для расположения справа, слева, к внутреннему полю, к
-% внешнему полю. Строчные буквы задают неплавающее размещение,
-% прописные "--- плавающий вариант. Рисунок может выступать
-% в поле на величину \meta{overhang}, если она задана,
-% или на величину заданную в параметре |\wrapoverhang|,
-% который обычно равен нулю. Параметр \meta{number} задаёт число
-% строк в оборку, которое обычно рассчитывается автоматически из
-% высоты рисунка, но может быть задан и вручную, например
+% \texttt{O}, для расположения справа, слева, к~внутреннему или
+% внешнему полю. Строчные буквы задают неплавающие варианты,
+% прописные \cdash--- плавающие. Рисунок может выступать
+% в~поле на величину \meta{overhang}, если опция задана,
+% выступ можно задать через параметр |\wrapoverhang|,
+% обычно равный нулю. Параметр \meta{number} задаёт число
+% строк в~оборку, которое обычно рассчитывается автоматически из
+% высоты рисунка, но может быть задан и~вручную:
% \begin{quote}
% |\begin{wrapfigure}[10]{r}[34pt]{5cm}|\\* \meta{figure}\\*
% |\end{wrapfigure}|
@@ -2452,205 +4958,281 @@
%
% \begingroup
% \def\FBaskip{-14pt}
-% \floatsetup[figure]{style=BOXED,frameset={\fboxsep9pt}}
-% \begin{wrapfigure}{O}{0mm}
-% \ffigbox[48mm]
-% {\par{\setlength\unitlength{\hsize/64}\ifx\pspicture\undefined
-% \else\psset{unit=\unitlength}\fi
-% \input{TheCat.picture}}}
-% {\caption{Рисунок в оборку с командой \cmd{\ffigbox}
-% (пакет \pkg{wrapfig})}%
+% \floatsetup[figure]{style=BOXED,frameset={\fboxsep6pt}}
+% \begin{wrapfigure}[11]{o}{0mm}
+% \ffigbox[40mm]
+% {\par{\setlength\unitlength{.7\hsize/48}%^^A
+% \input{Cat.picture}}}
+% {\caption{Рисунок в~оборку с~командой \cmd{\ffigbox}
+% (пакет \package{wrapfig})}%
% \label{fig:wrapfig:WcatII}}
% \end{wrapfigure}
%
-% \emph{Замечание Floatrow.}
-% Для рисунка, помещённого в окружение \env{wrap...} вы должны
-% задать ширину в обязательном аргументе. Если вы зададите
-% |0mm| как аргумент \marg{width of figure}, пакет \pkg{wrapfig}
-% рассчитает ширину по натуральной ширине содержимого объекта.
-%
-% Иногда над (под) флотом в окружении \env{wrap...} может появиться
-% нежелательный пробел. Для корректировки вертикальной отбивки
-% используйте определение команд |\FBaskip| и
-% |\FBbskip| (см. разд.~\ref{sec:FBabskips}).
-%
-% \emph{Специальные настройки}.
-%
+%^^A% \emph{Floatrow note.}
+%^^A% For figure, placed in \env{wrap...} environment you must set width
+%^^A% in mandatory argument. If you'll write \texttt{0mm} as \marg{width
+%^^A% of figure} argument, \package{wrapfig} package will count natural width
+%^^A% of float contents.
+% \emph{Замечание \textsf{floatrow}.}
+% Для рисунка, помещённого в~окружение \env{wrap...} вы должны
+% задать ширину в~обязательном аргументе. Если вы зададите
+% |0mm| как аргумент \marg{width of figure}, пакет \package{wrapfig}
+% рассчитает ширину по ширине объекта.
+%
+%^^A% Sometimes above (below) float box in \env{wrap...} environment
+%^^A% appears unwanted space. To correct vertical position, use |\FBaskip|
+%^^A% (|\FBbskip|) commands (see {\sectionname}~\ref{sec:FBabskips}).
+% Иногда над (под) флотом в~окружении \env{wrap...} может появиться
+% ненужный пробел. Для корректировки вертикальной отбивки
+% используйте команды |\FBaskip|
+% и~|\FBbskip| ({\sectionname}~\ref{sec:FBabskips}).\pagebreak[3]
+%
+%^^A% \emph{Special settings}.
+% \emph{Специальные настройки}.\par\penalty10000
+%
+%^^A% You may create settings for \env{wrap...} environment, there are
+%^^A% following priorities
+%^^A% (Please note that you can load also special caption settings with
+%^^A% |\captionsetup| stuff.):
% Вы можете создать настройки для окружения \env{wrap...}, здесь
% существуют следующие приоритеты
-% (обратите внимание, что вы можете задать и специальные настройки
-% оформления подписей в команде |\captionsetup|.):
+% (обратите внимание, что вы можете задать и~специальные настройки
+% оформления подписей в~команде |\captionsetup|.):
% \begin{itemize}\itemsep0pt
+%^^A% \item %
+%^^A% if exists |\floatsetup[wrap|\meta{captype}|]{...}|
+%^^A% \package{floatrow} uses these settings---they are the ``strongest''
+%^^A% settings; if they absent---uses settings of next item;
% \item %
% если существуют настройки
% |\floatsetup[wrap|\meta{captype}|]{...}|
-% \pkg{floatrow} использует эти настройки "--- они <<сильнейшие>>
+% \package{floatrow} использует эти настройки "--- они <<сильнейшие>>
% настройки; если они отсутствуют "--- использует настройки из
% следующего пункта;
%^^A \end{itemize}
%
%^^A \begin{itemize}
+%^^A% \item
+%^^A% if exists |\floatsetup[wrapfloat]{...}|
+%^^A% \package{floatrow} uses these settings---these settings ``stronger''
+%^^A% than next ones; if they absent---settings of current
+%^^A% float\\[\medskipamount]
+%^^A% |\floatsetup[|\meta{captype}|]{...}|\,;\\[\medskipamount]
+%^^A% if they absent---uses default settings
+%^^A% (|\floatsetup{...}| or package settings).
% \item
% если существуют настройки |\floatsetup[wrapfloat]{...}|
-% \pkg{floatrow} использует эти настройки "--- эти настройки
+% \package{floatrow} использует эти настройки "--- эти настройки
% <<сильнее>> чем следующие; если они
-% отсутствуют "--- настройки данного типа флотов\\[\medskipamount]
-% |\floatsetup[|\meta{captype}|]{...}|\,;\\[\medskipamount]
-% если и они отсутствуют "--- настройки по умолчанию
+% отсутствуют "--- настройки данного типа флотов
+% \begin{quote}
+% |\floatsetup[|\meta{captype}|]{...}|\,;
+% \end{quote}
+% если и~они отсутствуют "--- настройки по умолчанию
% (|\floatsetup{...}| или настройки пакета).
% \end{itemize}
%
-%
-% \emph{Обнаруженные ограничения}.
-%
-% Использование простого окружения в версии 3.3 не
-% даст правильного результата с текущей версией \pkg{floatrow}
-% "---используйте |\floatbox|.
-% Версия 3.6 позволяет использование простых окружений
-% \env{wrap...} со стилями \texttt{plain} (или
-% \texttt{ruled}), но
-% стили с рамками, как \texttt{Boxed} (где текст внутри рамки
-% изменяет свою ширину под рамку, ширина которой равна
-% текущему значению |\hsize|)
-% может работать только с командой |\floatbox|, в противном
-% случае вы получите некорректное
-% оформление и ширину флота.
+%\pagebreak[2]
+%^^A% \emph{Founded limitations}.
+% \emph{Обнаруженные ограничения}.\nopagebreak
+%
+%^^A% The usage of plain float environment in version 3.3 will
+%^^A% not succeed with current version of \package{floatrow}---use |\floatbox|
+%^^A% stuff. The version 3.6 allows usage of plain \env{wrap...}
+%^^A% environment with \texttt{plain} (or \texttt{ruled}) styles, but
+%^^A% the framed styles, like \texttt{Boxed} (where text inside frames
+%^^A% changes its |\hsize| to fit frames, fitted to defined |\hsize|)
+%^^A% could work only with |\floatbox| macro, otherwise you'll get
+%^^A% incorrect widths and layout.
+%^^A% \endgroup
+% В~версии 3.3 нужно использовать команды |\floatbox|.
+% В~версии 3.6 можно создавать простые окружения
+% \env{wrap...} со стилями \hyperref[setup:plain]{\texttt{plain}} (или
+% \hyperref[setup:ruled]{\texttt{ruled}}), но флоты
+% со стилем типа \hyperref[setup:Boxed]{\texttt{Boxed}} (где текст объекта
+% сужается под рамку) тоже
+% нужно помещать в~|\floatbox|, иначе
+% создастся неверная вёрстка.
% \endgroup
%
% \begingroup
% \floatsetup[figure]{style=WSHADOWBOX,captionskip=8pt}
-% \subsection{Пакет \pkg{floatflt}}
+%^^A% \subsection{The \package{floatflt} package}\label{ssec:floatflt}
+% \subsection{Пакет \package{floatflt}}\label{ssec:floatflt}
%
-% \begin{floatingfigure}[v]{54mm}\def\FBaskip{-2.5pt}
-% \ffigbox[54mm]
-% {\setlength\unitlength{.85\hsize/60}\ifx\pspicture\undefined
-% \else\psset{unit=\unitlength}\fi
+% \begin{floatingfigure}[v]{44mm}\def\FBaskip{-2.5pt}
+% \ffigbox[44mm]
+% {\setlength\unitlength{.85\hsize/60}%%^^A
% \input{BlackDog.picture}}
% {\caption{\hyphenpenalty-100\pretolerance-1%
-% Рисунок в оборку внутри окружения \env{floating\-figure}
-% (\pkg{floatflt})}\label{fig:floatflt:WcatI}}
+% Рисунок в оборку внутри \env{floating\-figure}
+% (\package{floatflt})}\label{fig:floatflt:WcatI}}
% \end{floatingfigure}%\FBbuildtrue
%
-% \noindent Тестировалось с версией v.1.3,
+%^^A% \noindent Tested with version v\kern-1pt.1.3 dated
+%^^A% 1996/02/27\kern-1pt.
+% \noindent Тестировалось с~версией v.1.3,
% 1996/02/27.
%
-% \emph{Обнаруженные ограничения} 1)\enskip У данного пакета нет
+%^^A% \emph{Founded limitations} 1)\enskip There is not support for
+%^^A% creation of new \env{floating...} environment. Since \env{floatflt}
+%^^A% environments need usage of |\floatbox| in any case, you can use
+%^^A% either \env{floatingfigure} or \env{floatingtable} and put
+%^^A% necessary float type in |\floatbox| argument (or use necessary
+%^^A% macro-abbreviation).
+% \emph{Обнаруженные ограничения} 1)\enskip У~пакета нет
% поддержки для создания нового окружения \env{floating...}.
% Но поскольку окружение \env{floatflt}
-% требует использование команд |\floatbox| в любом случае, вы
-% можете использовать как \env{floatingfigure} так и
-% \env{floatingtable} и задавать необходимый
-% тип флота в аргументе команды |\floatbox| (или использовать
-% соответствующую пользовательскую команду, типа |\ffigbox|).
+% требует использование команд |\floatbox| в~любом случае, вы
+% можете использовать как команду \env{floatingfigure} так
+% и~\env{floatingtable} и~задавать необходимый
+% тип флота в~аргументе команды |\floatbox| (или использовать
+% пользовательскую команду, типа |\ffigbox|).
%
%
+%^^A% The next limitations could not tied with \package{floatrow} package.
% Следующие ограничения могут быть не связаны с пакетом
-% \pkg{floatrow}.
+% \package{floatrow}.
%
+%^^A% 2)\enskip If you put \env{floatingfigure} environment just after
+%^^A% |\...section| command you need (if you do not indentation after
+%^^A% heads) to put |\noindent| for the first paragraph.
% 2)\enskip Если вы поместите окружение \env{floatingfigure} сразу
% после команд |\...section| вы должны (если вы не задаёте абзацного
-% отступа после заголовков) поставить |\noindent| в первом абзаце.
+% отступа после заголовков) поставить |\noindent| в~первом абзаце.
%
+%^^A% 3)\enskip The \env{floatflt} environments could fail with list
+%^^A% environments.
% 3)\enskip Окружения \env{floatflt} могут дать неверный результат
-% с окружениями перечней (\env{list}).
+% с~окружениями перечней (\env{list}).
%
+%^^A% 4)\enskip To get correct space before next |\...section| head you
+%^^A% may need to put following commands
+%^^A% |\makeatletter\@nobreakfalse\makeatother| (as was made in just
+%^^A% before next section).
% 4)\enskip Чтобы получить корректную отбивку перед заголовком
% следующего раздела |\...section| вам
% может быть придётся задать следующие команды;
% |\makeatletter\@nobreakfalse\makeatother| (как было сделано
-% в английской документации перед следующим разделом).
+% в~английской документации перед следующим разделом).
%
-% \makeatletter\@nobreakfalse\makeatother
+% \par\RestoreSpaces
%
-% \penalty-10000
+% %^^A\newpage
%
-% \subsection{Пакет \pkg{picins}}
+%^^A% \subsection{The \package{picins} Package}\label{ssec:picins}
+% \subsection{Пакет \package{picins}}\label{ssec:picins}
%
% \floatsetup[figure]{style=ruled}
%
% \parpic[l]{{%\def\floatrowsep{}\let\FBiffloatrow\iftrue
-% \def\FBbskip{12pt}
+% \def\FBaskip{6pt}\def\FBbskip{12pt}
% \ffigbox[42mm]
-% {{\setlength\unitlength{18mm/61}\ifx\pspicture\undefined
-% \else\psset{unit=\unitlength}\fi
-% \input{BlackCat.picture}}}
+% {{\setlength\unitlength{12mm/61}%^^A
+% \input{TheDog.picture}}}
% {\caption{Рисунок в оборку (\cmd{\parpic});
-% \cmd{\floatbox}
-% с опцией \cmd{\FBwidth}}\label{fig:parpic:BcatI}}%
+% \cmd{\floatbox}}\label{fig:parpic:BcatI}}%
% }}
%
+%^^A% \noindent Tested with version v\,3.0 dated 1999/10/12.
% \noindent Тестировано с версией v\,3.0, 1999/10/12.
%
+%^^A% This package produces pictures inside paragraph. This package
+%^^A% supports usage of captions with command |\piccaption|. It also allows
+%^^A% the \package{caption} package settings.
% Этот пакет создаёт рисунки внутри абзаца. Он предлагает
-% использование подписей с помощью команд |\piccaption|.
+% использование подписей с~помощью команд |\piccaption|.
% Также он поддерживает настройки
-% пакета \pkg{caption}.
+% пакета \package{caption}.
%
-% В макрокоманде \cmd{\parpic} можно использовать макрокоманду
+%^^A% The \cmd{\parpic} macro usually allows usage of |\floatbox| macro
+%^^A% inside of its mandatory argument.
+% В~макрокоманде \cmd{\parpic} можно использовать макрокоманду
% |\floatbox| внутри обязательного
% аргумента.
%
%^^A \emph{Founded limitations}.\nopagebreak
%
%^^A 1)\enskip In |\parpic| argument you ought to put before |\floatbox|
-%^^A following commands:\\[\medskipamount]
-%^^A |\def\floatrowsep{}|\allowbreak|\let\FBiffloatrow\iftrue|\\[\medskipamount]
+%^^A following commands:
+%^^A \begin{Quote}%
+%^^A |\def\floatrowsep{}|\allowbreak
+%^^A |\let\FBiffloatrow\iftrue|
+%^^A \end{Quote}%
%^^A to get correct layout.
%
-% Следующие ограничения могут быть не связаны с пакетом \pkg{floatrow}.
+%^^A% The next limitations could not tied with \package{floatrow} package.
+% Следующие ограничения могут быть не связаны с~пакетом \package{floatrow}.
%
%^^A \floatsetup[figure]{style=DOUBLEBOX}
%
%^^A \parpic[r]{{%\def\floatrowsep{}\let\FBiffloatrow\iftrue
%^^A \hsize36mm
%^^A \ffigbox[\hsize]
-%^^A {{\setlength\unitlength{16mm/61}\ifx\pspicture\undefined
-%^^A \else\psset{unit=\unitlength}\fi
+%^^A {{\setlength\unitlength{16mm/61}%^^A
%^^A \input{BlackCat.picture}}}
%^^A {\caption{Wrapped figure (\cmd{\parpic})}\label{fig:parpic:BcatII}}%
%^^A }}
%
+%^^A% 1)\enskip If you put \cmd{\parpic} just after |\...section| command
+%^^A% you need (if you do not indentation after heads) to put |\noindent|
+%^^A% for the first paragraph.
% 1)\enskip Если вы задаёте \cmd{\parpic} сразу после команды |\...section|
% вам придётся (если вы отменяете абзацный отступ после заголовков)
% задать команду |\noindent|
% для первого абзаца.
%
+%^^A% 2)\enskip You may try to use \cmd{\parpic} inside list environment,
+%^^A% but in some cases usage of \cmd{\parpic} in
+%^^A% the list gets bad or wrong layout.
% 2)\enskip Вы можете попытаться использовать \cmd{\parpic} внутри
% окружения перечня,
-% но в некоторых случаях использование \cmd{\parpic} в окружении
+% но в~некоторых случаях использование \cmd{\parpic} в~окружении
% перечня может дать неверный результат.
%
+%^^A% 3)\enskip This package has not options \meta{outside} or
+%^^A% \meta{inside}, like previous two packages (the option |[o]| means
+%^^A% oval box around picture), so you ought to set horizontal position
+%^^A% manually.
% 3)\enskip Этот пакет не имеет опции \meta{outside} или
% \meta{inside}, как предыдущие два пакета (опция |[o]| означает
% овальную рамку вокруг картинки), поэтому вы должны задавать
% горизонтальное расположение
-% вручную.
+% вручную. Или определить несложное условие, используя флаг |\ifodd|.
%
% \endgroup
%
-% \subsection{Пакет \pkg{rotating} и окружение
-% \env{sideways\ldots}}
+%^^A% \subsection{The \package{rotating} Package and \env{sideways\ldots}
+%^^A% Environment}\label{ssec:rotating}
+% \subsection{Пакет \package{rotating} и~окружение
+% \env{sideways\ldots}}\label{ssec:rotating}
%
+%^^A% Tested with version v2.13 dated Sep. 1992.
% Тестировано с версией v2.13 датированной Sep. 1992.
%
-% Далее идёт пример (рис.~\ref{fig:rot}) с развёрнутым вертикально
+%^^A% There is example (figure~\ref{fig:rot}) with rotated float, using
+%^^A% \env{sidewaysfigure}.
+% Далее идёт пример (рис.~\ref{fig:rot}) с~развёрнутым вертикально
% флотом, использующим окружение
% \env{sidewaysfigure}.
-%\begin{verbatim}
-%\floatsetup[figure]{style=WSHADOWBOX}
-%\begin{sidewaysfigure}\emptyfloatpage
-%\ffigbox[\FBwidth]
-%{\includegraphics[width=4in]{pslearn.eps}}
-%{\caption{Figure inside \env{sidewaysfigure} environment}%
-%\label{fig:rot}}
-%\end{sidewaysfigure}%
-%\end{verbatim}
-% \floatsetup[figure]{style=WSHADOWBOX}
+%\begin{Quote}\openup-.5pt
+%\meta{preamble}
+%|\floatsetup[|\hyperref[setup:rotfigure]{\texttt{rotfigure}}|]{|%^^A
+% \hyperref[setup:style]{\texttt{style}}|=WSHADOWBOX}|
+%\meta{preamble}
+%|\begin{sidewaysfigure}\emptyfloatpage|
+%|\ffigbox[\FBwidth]|
+%| {...}|
+%| {\caption{Figure ...}%|
+%| \label{...}}|
+%|\end{sidewaysfigure}%|
+%\end{Quote}
+% \floatsetup[rotfigure]{style=WSHADOWBOX}
% \begin{sidewaysfigure}\emptyfloatpage
% \ffigbox[\FBwidth] {\includegraphics[width=4in]{pslearn}}
% {\caption{Рисунок развёрнутый вертикально внутри окружения
% \env{sidewaysfigure}}%
-% \label{fig:rot}}
+% \label{fig:rot:ii}}
% \end{sidewaysfigure}%
% %^^A For rotating floats on right side (like in
% %^^A current documentation) put in preamble
@@ -2659,49 +5241,78 @@
% %^^A \end{quote}
%
%
+%^^A% \emph{Special settings}.\nopagebreak
% \emph{Специальные настройки}.\nopagebreak
%
+%^^A% You may create special settings for all rotated floats, which use
+%^^A% \env{sideways...} environment (see page \pageref{stsetorder}).
% Вы можете создать специальные настройки для всех флотов,
% развёрнутых вертикально, которые используют
% окружение \env{sideways...} (см.~с.~\pageref{stsetorder}).
%
+%^^A% For one-column rotated float
% Для одноколонного флота
-% \begin{itemize}
+% \par\RestoreSpaces
+% \begin{itemize}\itemsep0pt\parskip0pt
+%^^A% \item %
+%^^A% if exists |\floatsetup[rot|\meta{captype}|]{...}|
+%^^A% package uses these settings---the ``strongest'' settings; if they
+%^^A% absent---uses settings from next item;
% \item %
% если существуют настройки
% |\floatsetup[rot|\meta{captype}|]{...}|
% пакет использует эти настройки "--- <<сильнейшие>> настройки;
% если они отсутствуют "---
% используются настройки из следующего пункта;
+%^^A% \item
+%^^A% if exists |\floatsetup[rotfloat]{...}|
+%^^A% package uses these settings---these settings ``stronger'' than next
+%^^A% ones; if they absent---settings for current float
+%^^A% (|\floatsetup[|\meta{captype}|]{...}|);
+%^^A% if they absent---uses default settings
+%^^A% (|\floatsetup{...}| or package settings).
% \item
% если существуют настройки |\floatsetup[rotfloat]{...}|
% пакет использует эти настройки "--- эти настройки <<сильнее>> чем
-% следующие; если они отсутствуют "--- настройки для данного типа
+% следующие; если они отсутствуют "--- настройки для
% флота (|\floatsetup[|\meta{captype}|]{...}|);
-% если и они отсутствуют "--- используются настройки по умолчанию
-% в команде (|\floatsetup{...}| или настройки пакета).
+% если и~они отсутствуют "--- используются настройки по умолчанию
+% в~команде (|\floatsetup{...}| или настройки пакета).
% \end{itemize}
%
-% Для флота вразрез двух колонок или широкого флота (|*|-окружение)
-% \begin{itemize}
+%^^A% For two-column or wide rotated float (starred environment)
+% Для флота вразрез двух колонок или широкого флота («звёздное» окружение)
+% \begin{itemize}\itemsep0pt\parskip0pt
% \item %
+%^^A% if exists |\floatsetup[widerot|\meta{captype}|]{...}|
+%^^A% package uses these settings---the ``strongest'' settings;
+%^^A% if they absent---uses settings of next item;
% если существуют настройки
% |\floatsetup[widerot|\meta{captype}|]{...}|
% пакет использует эти настройки "--- <<сильнейшие>> настройкиt;
% если они отсутствуют "---используются настройки из следующего
% пункта;
% \item %
+%^^A% if exists |\floatsetup[widerotfloat]{...}| package
+%^^A% uses these settings---these settings ``stronger'' than settings
+%^^A% in next item; if they absent---uses settings of next item;
% если существуют настройки |\floatsetup[widerotfloat]{...}|
% пакет использует эти настройки "--- эти настройки <<сильнее>>
% чем следующие; если они отсутствуют
% "--- используются настройки из следующего пункта;
% \item %
+%^^A% if exists |\floatsetup[rot|\meta{captype}|]{...}| package
+%^^A% uses these settings---these settings ``stronger'' than settings
+%^^A% in next item; if they absent---uses settings of next item;
% если существуют настройки
% |\floatsetup[rot|\meta{captype}|]{...}|
% пакет использует эти настройки "---эти настройки <<сильнее>>
% чем следующие; если они отсутствуют
% "---используются настройки из следующего пункта;
% \item %
+%^^A% if exists |\floatsetup[rotfloat]{...}|
+%^^A% package uses these settings---these settings ``stronger'' than next
+%^^A% ones;
% если существуют настройки |\floatsetup[rotfloat]{...}|
% пакет использует эти настройки "---эти настройки <<сильнее>>
% чем следующие;
@@ -2713,178 +5324,226 @@
% %^^A \item %
% %^^A if exists |\floatsetup[widefloat]{...}|
% %^^A package uses these settings;
-% если они отсутствуют "--- настройки для данного типа флота
+%^^A% if they absent---uses settings for current float
+%^^A% (|\floatsetup|\marg{captype}|{...}|);
+%^^A% if they absent---uses default settings
+%^^A% (|\floatsetup{...}| or package settings).
+% если они отсутствуют "--- настройки для флота
% (|\floatsetup|\marg{captype}|{...}|);
-% если и они отсутствуют "--- используются настройки по умолчанию
-% в команде (|\floatsetup{...}| или настройки пакета).
+% если и~они отсутствуют "--- используются настройки по умолчанию
+% в~команде (|\floatsetup{...}| или настройки пакета).
% \end{itemize}
-%
+%\enlargethispage{\baselineskip}
+%^^A% \emph{Notes}.\nopagebreak
% \emph{Замечания}.\nopagebreak
%
-% 1)\enskip Если вы помещаете два продолжающихся флота, развёрнутых
-% вертикально, на развороте, лучше будет их собрать у корешкового
-% поля. Для этого вы можете определить\footnote{Если пакет
-% \pkg{rotating} использует опцию |[figuresright]|, см. также
+%^^A% 1)\enskip If you place two continued rotated floats%^^A
+%^^A% \FRmpar{Continued rotated floats}{FAD:ContRotated} on facing pages,
+%^^A% the better way is to gather them to binder margin. For this reason you
+%^^A% may define\footnote{In case of \package{rotating} package has |[figuresright]|
+%^^A% option, see also files \file{frsample10.tex}--\file{frsample12.tex}
+%^^A% and code in \file{fr-sample.tex}.} before first float
+% 1)\enskip Если вы помещаете два продолжающихся флота,%^^A
+% \FRmpar{Продолжающиеся развёрнутые флоты на развороте}{FAD:ContRotated}
+% развёрнутых вертикально, на развороте, лучше будет их собрать
+% у~корешкового поля. Для этого вы можете определить\footnote{Если пакет
+% \package{rotating} использует опцию |[figuresright]|, см.~также
% файлы примеров \file{frsample10.tex}--\file{frsample12.tex}
-% и код файла \file{fr-sample.tex}.} до первого флота
-% \begin{quote}
+% и~код файла \file{fr-sample.tex}.} до первого флота\allowpostlistbreaks[2]
+% \par\RestoreSpaces
+% \begin{Quote}
% |\buildFBBOX{\vbox to\rottextwidth\bgroup\vss}{\egroup}|
-% \end{quote}
-% а перед вторым
-% \begin{quote}
+% \end{Quote}
+%^^A% and before second one
+% а~перед вторым
+% \begin{Quote}
% |\buildFBBOX{\vbox to\rottextwidth\bgroup}{\vss\egroup}|
-% \end{quote}
+% \end{Quote}
% \medskip
+%^^A% The |\rottextwidth| dimension---here is saved |\textwidth| of
+%^^A% document---the |\columnwidth| and |\textwidth| inside
+%^^A% \texttt{sideways...} environment are redefined and equal to
+%^^A% |\textheight|.
% Величина |\rottextwidth| "---здесь сохранённое значение
% |\textwidth| документа "--- параметры |\columnwidth|
-% и |\textwidth| внутри окружения \texttt{sideways...} равны
+% и~|\textwidth| внутри окружения \texttt{sideways...} равны
% |\textheight|.
%
-% 2)\enskip В данном примере вы можете видеть команду
-% |\emptyfloatpage|. Эта команда предлагается
-% пакетом \pkg{floatpagestyle}, (инсталлируемым
-% вместе с пакетом \pkg{floatrow}). Макрокоманда
+%^^A% 2)\enskip In current example you may see command |\emptyfloatpage|.%^^A
+%^^A% \FRmpar{Empty page style for rotated floats}{FAD:emptyfloatpage}
+%^^A% It is offered by \package{floatpagestyle} package, (installed with
+%^^A% \package{floatrow} package). Macro |\emptyfloatpage| is abbreviation of
+%^^A% |\floatpagestyle{empty}|. The last macro redefines page style for
+%^^A% the page where \emph{current} float environment appears.
+% 2)\enskip В~данном примере вы можете видеть команду |\emptyfloatpage|.%^^A
+% \FRmpar{Пустой колонтитул для развёрнутых флотов}{FAD:emptyfloatpage}
+% Эта команда предлагается
+% пакетом \package{floatpagestyle}, (инсталлируемым
+% вместе с~пакетом \package{floatrow}). Макрокоманда
% |\emptyfloatpage| является сокращением команды
% |\floatpagestyle{empty}|. Последняя макрокоманда переопределяет
% стиль страницы когда появляется на ней данное окружение флота.
%
-% Версия 0.1h добавляет дополнительный код к макрокоманде
-% |\@outputpage| из ядра \LaTeX'а и я надеюсь что это будет
+%^^A% The version 0.1h patches the core \LaTeX{} macro
+%^^A% |\@outputpage|\footnote{At the start of document
+%^^A% \package{floatpagestyle} package puts additional code at the very beginning
+%^^A% of this output routine.}
+%^^A% and I hope that it could work.\footnote{If you know more honest
+%^^A% way to get the same result---the redefinition of \emph{alone}
+%^^A% \emph{float} page style (in the case when this page can \emph{float}
+%^^A% inside document)---please let me know.} Since this package uses
+%^^A% |\label|---|\ref| mechanism, the |\floatpagestyle| command works
+%^^A% after \emph{second} \LaTeX{} run.
+% Версия 0.1h только добавляет дополнительный код к~макрокоманде
+% |\@outputpage| из ядра \LaTeX'а и~я~надеюсь что это будет
% работать.\footnote{Если вам известен более честный путь
-% получить тот же результат "--- переопределение
-% стиля отдельной страницы с плавающим флотом (учитывая, что и она
+% получить тот же результат \cdash--- переопределение
+% стиля отдельной страницы с~плавающим флотом (учитывая, что и~она
% сама может плавать по документу) "--- дайте, пожалуйста, знать.}
-% Поскольку пакет \pkg{floatpagestyle} использует
+% Поскольку пакет \package{floatpagestyle} использует
% механизм |\label|---|\ref|, команда |\floatpagestyle| даёт
-% результат после \emph{второй} (и более) обработок \LaTeX'ом.
+% результат после \emph{второй} (и~более) обработок \LaTeX'ом.
%
-% \subsection{Пакет \pkg{lscape} и окружение \env{landscape}}
+% \RestoreSpaces
+%^^A% \subsection{The \package{lscape} Package and \env{landscape}
+%^^A% Environment}\label{ssec:lscape}
+% \subsection{Пакет \package{lscape} и окружение \env{landscape}}\label{ssec:lscape}
%
-% Тестировалось с версией v3.0a датированной
+%^^A% Tested with version v3.0a dated 1999/02/16.\nopagebreak
+% Тестировалось с~версией v3.0a датированной
% 1999/02/16.\nopagebreak
%
%\ifx\landscape\undefined\else
% \ifx\landscape\relax\else
+%^^A% The example with usage of \env{landscape} environment from
+%^^A% \package{lscape} package on the page~\pageref{fig:rotrow:WcatI}, figures
+%^^A% \ref{fig:rotrow:WcatI}--\ref{fig:rotrow:FcatI}):
% Пример с использованием окружения \env{landscape} из пакета
-% \pkg{lscape} на с.~\pageref{fig:rotrow:WcatI},
+% \package{lscape} на с.~\pageref{fig:rotrow:WcatI},
% рис.\ref{fig:rotrow:WcatI}--\ref{fig:rotrow:FcatI}):
-%\begin{verbatim}
-%\DeclareFloatVCode{lowthickrule}{\kern2pt\hrule height.8ptdepth0pt}
-%\floatsetup[figure]{style=ruled,rowprecode=thickrule,
-% rowpostcode=lowthickrule,capposition=TOP}
-%\begin{landscape}
-%\begin{figure}\emptyfloatpage
-%...
-%\end{verbatim}
+% \par\RestoreSpaces
+%\begin{Quote}
+%\meta{preamble}
+%|\DeclareFloatVCode{lowthickrule}{\kern2pt\rule{\hsize}{.8pt}}|
+%|\floatsetup[figure]{|\hyperref[setup:style]{\texttt{style}}|=ruled,|%^^A
+% \hyperref[setup:rowprecode]{\texttt{rowprecode}}|=thickrule,|
+%| |\hyperref[setup:rowpostcode]{\texttt{rowpostcode}}|=lowthickrule,|%^^A
+% \hyperref[setup:capposition]{\texttt{capposition}}|=TOP}|
+%\meta{preamble}
+%|\begin{landscape}|
+%|\begin{figure}\emptyfloatpage|
+%|...|
+%\end{Quote}
+%^^A% |\floatsetup| code sets \texttt{ruled} float style,
+%^^A% then settings for above and below material are redefined:
+%^^A% \texttt{rowprecode=} and \texttt{rowpostcode=} keys define thick
+%^^A% rules but for floatrow as whole (the `individual' |\hrule|'s
+%^^A% above/below float boxes absent).
% Команда |\floatsetup| определяет стиль флота \texttt{ruled},
-% затем настройки для материала сверху и снизу переопределены:
-% ключи \texttt{rowprecode=} и \texttt{rowpostcode=} определяют
+% затем настройки для материала сверху и~снизу переопределены:
+% ключи \texttt{rowprecode=} и~\texttt{rowpostcode=} определяют
% толстые линейки для всего ряда рисунков (<<индивидуальные>>
-% линейки сверху/снизу в ряду отменены).
+% линейки сверху/снизу в~ряду отменены).
%\fi\fi
%
-%
+%^^A% The \env{landscape} environment creates a new page. It would be
+%^^A% useful to start new section of document, e.g., appendix. (In current
+%^^A% document it was placed just before appendix)
% Окружение \env{landscape} создаёт новую страницу. Оно полезно для
-% задания нового раздела документа, например, приложения. (В данном
+% разворота целиком нового раздела документа, например, приложения. (В~данном
% документе окружение было помещено перед приложением)
%
%^^A \emph{Founded limitations}.\nopagebreak
%^^A The tested version works incorrect (does not rotates contents)
-%^^A with \pkg{hypcap} package.
+%^^A with \package{hypcap} package.
%
-% \subsection{Пакет \pkg{listings}}
+%^^A% \subsection{The \package{listings} Package}\label{ssec:listings}
+% \subsection{Пакет \package{listings}}\label{ssec:listings}
%
-% Тестировалось с версией v1.3 датированной 2004/09/07.\nopagebreak
+%^^A% Tested with version v1.3 dated 2004/09/07.\nopagebreak
+% Тестировалось с~версией v1.3 датированной 2004/09/07.\nopagebreak
%
+%^^A% This package has its strong layout mechanism for creation for floating
+%^^A% algorithms itself. The usage of |\lstset| command and \package{caption}
+%^^A% package settings gives you necessary result\footnote{Please note and read
+%^^A% \package{caption} documentation: the co-operation of \package{caption}3.x and
+%^^A% \package{listings} succeeds with version of last one not older than 1.2.}
+%^^A% for algorithm type of float.
% Этот пакет имеет свой сильный механизм создания плавающих
-% алгоритмов. Использование команды |\lstset| и настроек пакета
-% \pkg{caption} даст нужный результат оформления\footnote{Обратите
-% внимание и прочтите документацию
-% \pkg{caption}: кооперация пакета \pkg{caption}3.x
-% и \pkg{listings} будет успешной только с версией
+% алгоритмов. Использование команды |\lstset| и~настроек пакета
+% \package{caption} даст нужный результат оформления\footnote{Обратите
+% внимание и~прочтите документацию
+% \package{caption}: кооперация пакета \package{caption}3.x
+% и~\package{listings} будет успешной только с~версией
% последнего не ниже 1.2.} для флотов типа алгоритмов.
%
-%\iffalse
-% В случаях появления листингов внутри других окружений,
-% например, внутри окружения \env{figure} со стилями использующими
-% рамки, типа \texttt{Boxed} и \texttt{BOXED}
-% и при предопределённой шириной флота, вы должны задать:
-% \begin{quote}
-% |\lstset{linewidth=\hsize}|
-% \end{quote}
-% в преамбуле, или прямо перед окружением \env{lstlisting}.
-% Или в дополнительном аргументе
-% окружения \env{lstlisting} "---здесь вы должны определить
-% ширину следующим образом:
-% \begin{quote}
-% |\begin{lstlisting}[linewidth=\hsize]|
-% \end{quote}
-%\fi
-%
-% В случаях появления листингов внутри других окружений, которые
-% оформляются пакетом \pkg{floatrow}, ограничение заключается
-% в том, что вы не можете поместить окружение \env{lstlisting}
+%^^A% For the cases of appearance of listings inside of other float
+%^^A% environments, which get settings from \package{floatrow}package,
+%^^A% there is a limitation: you can't put \env{lstlisting} inside
+%^^A% |\floatbox| contents.
+% В~случаях появления листингов внутри других окружений, которые
+% оформляются пакетом \package{floatrow}, ограничение заключается
+% в~том, что вы не можете поместить окружение \env{lstlisting}
% внутрь команды |\floatbox|.
%
-% \subsection{Пакет \pkg{longtable}}
-%
-% Был добавлен код в макрокоманду |\LT@array| из пакета
-% \pkg{longtable}\footnote{Спасибо
-% A. Sommerfeldt за помощь в создании компактного кода.}:
-% этот код задаёт настройки того
-% же шрифта, что и в таблицах в окружении \env{table},
-% а также при возможность задать ширину
-% табличного заголовка в окружении \env{longtable} равной ширине
-% таблицы. Для задания ширины
-% табличного заголовка задан ключ.
-%
-% \DescribeMacro{LTcapwidth=}
-% Этот ключ может иметь любое значение типа |5cm| или |\textwidth|.
-% Если же вы зададите \texttt{LTcapwidth=table} или
-% \texttt{LTcapwidth=contents},
-% ширина табличного заголовка будет равна ширине таблицы. Настройка
-% ширины табличного заголовка в этом случае производится
-% по информации из \texttt{aux}-файла,
-% поэтому вы получите правильный результат только тогда,
-% когда ширина всей таблицы будет
-% стабильной.
-%
-% Окружение \env{longtable} использует настройки,
-% заданные в командах |\floatsetup[table]|
-% и |\floatsetup[longtable]|. Настройки из |\floatsetup[longtable]|
-% будет <<сильнейшими>>
-% в этой паре.
-%
-% \subsection{Пакеты \pkg{hyperref} и \pkg{hypcap}}
+%^^A% \subsection{The \package{hyperref} and \package{hypcap} Packages}
+% \subsection{Пакеты \package{hyperref} и \package{hypcap}}
%
-% Тестированы версии v6.74i (\pkg{hyperref}) и v1.3 (\pkg{hypcap}).
+%^^A% There were tested versions v6.74i (\package{hyperref})
+%^^A% and v1.3 (\package{hypcap}).
+% Тестированы версии v6.74i (\package{hyperref}) и v1.3 (\package{hypcap}).
%
-% Пакет \pkg{floatrow} пытается не распространять свой
-% код на команды |\caption|. Я надеюсь что окружения, поддерживаемые
-% пакетом \pkg{floatrow} не навредят тандему пакетов
-% \pkg{caption}---\pkg{hyperref}/\pkg{hypcap}.
+%^^A% The \package{floatrow} tries not to expand its code to |\caption| stuff.
+%^^A% I hope that environments supported by \package{floatrow} won't
+%^^A% make harm to \package{caption}---\package{hyperref}/\package{hypcap} tandem.
+% Пакет \package{floatrow} пытается не распространять свой
+% код на команды |\caption|. Я~надеюсь что окружения, поддерживаемые
+% пакетом \package{floatrow} не навредят тандему пакетов
+% \package{caption}---\package{hyperref}/\package{hypcap}.
%
+%^^A% \subsection{The Incompatibilities}
% \subsection{Несовместимости}
%
-% Несовместимости в первую очередь совпадают с несовместимостями
-% пакета \pkg{caption} 3.x:
-% \begin{quote}
-% \pkg{ccaption}, \pkg{hvfloat}, \pkg{nonfloat}
-% \end{quote}
-%
-% Известная несовместимость пакета \pkg{floatrow} "--- это пакет
-% \pkg{sidecap}\footnote{Несмотря на это я пыталась получить
+%^^A% The incompatibilities at first could follow the incompatibilities of
+%^^A% \package{caption} 3.x package:
+% Несовместимости в~первую очередь совпадают с~несовместимостями
+% пакета \package{caption} 3.x:
+% \begin{Quote}
+% \package{ccaption}, \package{hvfloat}, \package{nonfloat}, \package{captcont}, \package{ccaption},
+% \package{ftcapt}, (\package{hvfloat}), \package{multicap}, \package{topcapt}, \package{nonfloat}
+% \end{Quote}
+%
+%^^A% The known incompatibilities of \package{floatrow} package itself:
+%^^A% \quad 1)\nobreak\enskip \package{sidecap} package\footnote{Despite that
+%^^A% I'm trying to follow all offered layouts of this package. Great thanks
+%^^A% for Rolf Niepraschk and Hubert G\"{a}\ss{}lein for package with
+%^^A% rich implementation of such float
+%^^A% layouts.}: the \package{floatrow} package doesn't expands its
+%^^A% layouts to \env{SCfigure} and \env{SCtable} environments.
+%^^A% \quad 2)\nobreak\enskip \package{ctable} package; if you used to use
+%^^A% \package{ctable}'s tools, e.g. for tables, please set |\RawFloats[table]|
+%^^A% in the preamble, and remember that commands like |\ttabbox| won't
+%^^A% loose its strength (see also {\sectionname}~\ref{sec:rawfloats}).
+% Известные несовместимости пакета \package{floatrow} \quad 1)\nobreak\enskip это пакет
+% \package{sidecap}\footnote{Несмотря на это я~пыталась получить
% все предложенные этим пакетом оформления размещения подписей
-% сбоку. Большое спасибо Rolf Niepraschk и Hubert G\"{a}\ss{}lein
-% за пакет в котором дана полная гамма таких оформлений.}:
-% пакет \pkg{floatrow} не распространяет
-% своё оформление на окружения \env{SCfigure} и \env{SCtable}.
+% сбоку. Большое спасибо Rolf Niepraschk и~Hubert G\"{a}\ss{}lein
+% за пакет в~котором дана полная гамма таких оформлений.}:
+% пакет \package{floatrow} не распространяет
+% своё оформление на окружения \env{SCfigure} и~\env{SCtable}.
+% \quad 2)\nobreak\enskip пакет~\package{ctable}; если вы привыкли использовать
+% инструменты \package{ctable}, например. для таблиц, задайте |\RawFloats[table]|
+% в~преамбуле, и~помните, что команды типа |\ttabbox| не
+% теряют своей силы (см.~также {\sectionname}~\ref{sec:rawfloats}).
%
% \addtocontents{toc}{\string\pagebreak[3]}
+%^^A% \section{Limitations}
% \section{Ограничения}
%
+%^^A% There are known limitations, which were found during usage of
+%^^A% \package{floatrow}:
% Здесь даны ограничения, которые были обнаружены при пользовании
-% пакетом \pkg{floatrow}:
+% пакетом \package{floatrow}:
% \begin{itemize}
% %^^A \item %
% %^^A Limitations for boxed and ruled styles in beside floats:
@@ -2894,93 +5553,145 @@
% %^^A added \texttt{minipage} could get wrong layout (vertical
% %^^A alignment). But, as I found, you may use a few
% %^^A \texttt{minipage}s in object without harm.
+%^^A% \item %
+%^^A% You cannot use |\floatbox| stuff for floats with \texttt{verbatim}
+%^^A% environment and/or |\verb|.
% \item %
% Вы не можете использовать команды типа |\floatbox| для флотов
-% с окружением \texttt{verbatim} или командой |\verb|.
+% с~окружением \texttt{verbatim} или командой |\verb|.
% \item %
+%^^A% This limitation was mentioned above: some tools of the package use
+%^^A% |\label|---|\ref| mechanism, thus, if you use float layout which
+%^^A% demands common height of objects and/or captions in float row,
+%^^A% you'll get correct result after second or more runs. If you change
+%^^A% contents of float which change its height you must run \LaTeX{}
+%^^A% twice or more times too.
% Это ограничение упоминалось выше: пакет использует механизм
% |\label|---|\ref|, поэтому, если вы используете оформление,
% которое требует задания общей высоты для объектов и/или подписей
-% в ряду флотов, вы получите верный результат только после второй
-% (и более) обработки. Если вы измените содержимое так,
+% в~ряду флотов, вы получите верный результат только после второй
+% (и~более) обработки. Если вы измените содержимое так,
% что изменяется высота объекта/подписи вы также должны
-% обработать \LaTeX'ом дважды и более раз.
+% обработать \LaTeX'ом дважды и~более раз.
%
-% Подписи сбоку и другое оформление для разворотов также даст верный
-% результат только после второй (и более) обработки \LaTeX'ом.
+%^^A% Beside captions and other facing layout will appears correctly only
+%^^A% after second \LaTeX's run (sometimes you need to run more times).
+% Подписи сбоку и~другое оформление для разворотов также даст верный
+% результат только после второй (и~более) обработки \LaTeX'ом.
% \item %
-% Версия 3.0a (и выше) пакета \pkg{caption} и пакет
-% \pkg{floatrow} не поддерживают дополнительный аргумент
+%^^A% The version 3.0a (and newer) of \package{caption} package and
+%^^A% \package{floatrow} package do not support optional argument \emph{after}
+%^^A% caption ``title''. You may use |\floatfoot|
+%^^A% macro after main caption argument.
+% Версия 3.0a (и~выше) пакета \package{caption} и~пакет
+% \package{floatrow} не поддерживают дополнительный аргумент
% \emph{после} текста подписи. Вы можете использовать команду
% |\floatfoot| вместо этого.
% \item %
+%^^A% Do not use |\FBwidth| option for complex float contents (which you
+%^^A% could not put inside |\hbox|). (But you allowed to use |\vspace|
+%^^A% macro at the very end/very beginning of object contents for fine
+%^^A% vertical tuning.)
% Не используйте команду |\FBwidth| для сложного содержимого флота
% (которое вы не можете поместить внутри |\hbox|). (Но вы можете
-% использовать команды |\vspace| в самом начале или в
-% самом конце содержимого объекта для корректировки отбивок.)
+% использовать команды |\vspace| в~самом начале или
+% в~самом конце содержимого объекта для корректировки отбивок.)
% \item %
-% Внутри окружения \env{floatrow} возможны пробелы (и даже
+%^^A% The \texttt{floatrow} environment allows spaces (and even empty
+%^^A% lines, which sometimes create better and correct result!) between
+%^^A% |\floatbox|'es, but if you add some code between them you
+%^^A% must put |%| after this command.
+% Внутри окружения \env{floatrow} возможны пробелы (и~даже
% пустые строки, что даёт иногда более корректный результат!) между
% командами |\floatbox|, но если вы добавите код между флотами, вы
% должны поставить знак процента |%| после такой команды.
% \item %
-% Это общее правило "--- будьте внимательны с пробелами в конце
-% строк внутри окружения флота (см. документ
+%^^A% This is common rule---be careful with spaces at the end of lines
+%^^A% inside float contents (see \texttt{CTAN:/info/epslatex.ps} for more
+%^^A% explanations).
+% Это общее правило "--- будьте внимательны с~пробелами в~конце
+% строк внутри окружения флота (см.~документ
% \texttt{CTAN:/info/epslatex.ps} для
% дополнительной информации).
%
+%^^A% When you build plain float environment the better way is to separate
+%^^A% |\caption| and object contents (and also
+%^^A% |\floatfoot|/|\footnotetext| contents) each by empty lines or (if
+%^^A% not empty lines) end each part (and arguments of mentioned commands)
+%^^A% by percent sign. In this case you'll avoid unwanted spaces/lines at
+%^^A% the end of contents of each part, or wrong justification of float
+%^^A% components.
% Когда вы строите простое окружение (без |\floatbox|) лучше всего
-% разделить |\caption| и содержимое объекта (а заодно и содержимое
+% разделить |\caption| и~содержимое объекта (а~заодно и~содержимое
% |\floatfoot|/|\footnotetext|) каждое пустой строкой или (если не
-% пустые строки) завершить каждую часть (и аргументы указанных
-% команд) знаком процента. В этом случае вы избежите ненужных
-% пробелов и пустых строк в конце каждой из частей, или неверную
+% пустые строки) завершить каждую часть (и~аргументы указанных
+% команд) знаком процента. В~этом случае вы избежите ненужных
+% пробелов и~пустых строк в~конце каждой из частей, или неверную
% выключку содержимого объекта.
% %^^A \item %
% %^^A Usage of fancy boxes \texttt{shadowbox} and
% %^^A \texttt{wshadowbox} could get wrong layout with
% %^^A beside captions.
% \item Если вы используете внутри команды |\floatbox| окружения
-% \env{tabularx} или \env{tabular*} (или им подобные) с командой
+% \env{tabularx} или \env{tabular*} (или им подобные) с~командой
% |\hsize| внутри аргумента \meta{width}, вы должны повторить
-% аргумент |\hsize| в аргументе \meta{width} команды |\floatbox|.
-%
+% аргумент |\hsize| в~аргументе \meta{width} команды |\floatbox|.
+%
+%^^A% If you want to set width of \env{tabularx} or \env{tabular*}
+%^^A% environments (or any other) like |.8\hsize| (or |1.2\hsize|) and
+%^^A% these environments placed inside any |\floatbox| macro, load
+%^^A% |.8\hsize| in \meta{width} argument of |\floatbox| macro, and in
+%^^A% \meta{width} argument of \env{tabularx} or \env{tabular*} load only
+%^^A% |\hsize| macro (see also sample file \file{frsample03.tex}).
% Если вы хотите задать ширину окружения \env{tabularx} или
-% \env{tabular*} (или другого) как |.8\hsize| (или |1.2\hsize|) и
-% эти окружения помещены внутри команды |\floatbox|, поместите
-% |.8\hsize| в аргумент \meta{width} макрокоманды |\floatbox| (или
-% другой), а в аргументе \meta{width} команды \env{tabularx} или
+% \env{tabular*} (или другого) как |.8\hsize| (или |1.2\hsize|)
+% и~эти окружения помещены внутри команды |\floatbox|, поместите
+% |.8\hsize| в~аргумент \meta{width} макрокоманды |\floatbox| (или
+% другой), а~в~аргументе \meta{width} команды \env{tabularx} или
% \env{tabular*} поставьте только
% |\hsize| (см. также код файла \file{frsample03.tex}).
%
-% В иных случаях (особенно при использовании необычных оформлений)
+%^^A% In other cases (especially in fancy layout or settings) be careful
+%^^A% with usage of |\hsize| as \meta{width} option of |\floatbox|.
+% В~иных случаях (особенно при использовании необычных оформлений)
% будьте внимательны при использовании
% |\hsize| как опции \meta{width} команды |\floatbox|.
% \end{itemize}
%
% \addtocontents{toc}{\string\nopagebreak}
%
+%^^A% \section{Acknowledgements}
% \section{Благодарности}
%
-% Спасибо Steven Cochran и Axel Sommerfeldt за советы и поддержку.
+%^^A% Thanks for Steven Cochran and Axel Sommerfeldt for all their advices
+%^^A% and spirit. Special thanks for Axel for the patient answering, code, and
+%^^A% help in \emph{all} my questions and problems in \package{floatrow} package.
+% Спасибо Steven Cochran и~Axel Sommerfeldt за советы и~поддержку.
% Особая благодарность Axel Sommerfeldt за терпеливые ответы, код,
-% и помощь во \emph{всех} вопросах и проблемах в пакете
-% \pkg{floatrow}.
+% и~помощь во \emph{всех} вопросах и~проблемах в~пакете
+% \package{floatrow}.
%
% \medskip\noindent
+%^^A% Thanks for \emph{all} involuntary (\La)\TeX{} teachers, who teaches
+%^^A% me with their program code all these years.
% Спасибо \emph{всем} невольным учителям по (\La)\TeX'у, кто обучал
% меня программному коду всё время.
%
% \medskip\noindent
+%^^A% Thanks for Keith Reckdahl, author of \file{epslatex}, which
+%^^A% documentation, at last, encouraged me to create the CTAN version of
+%^^A% this package.
% Спасибо Keith Reckdahl, автору документации \file{epslatex},
-% которая, в конце концов, дала отвагу поместить создать версию
+% которая, в~конце концов, дала отвагу поместить создать версию
% пакета для CTAN.
%
% \medskip\noindent
+%^^A% \emph{Thanks for \emph{all} authors of second edition of \LaTeX{}
+%^^A% Companion for this book.}
% \emph{Спасибо \emph{всем} авторам второго издания \LaTeX{}
% Companion за эту книгу.}
%
-%\ifx\landscape\undefined\else
+%\ifx\landscape\undefined\else\begingroup
% \ifx\landscape\relax\else
% \clearfloatsetup{figure}
% \floatsetup[figure]{style=ruled,rowprecode=thickrule,
@@ -2992,154 +5703,76 @@
%
% \begin{figure}\emptyfloatpage
%
-% \begin{floatrow}[4]
+% \begin{floatrow}[4]\label{example:ruledcapposTOP}%^^A
% \ffigbox[][][t]
% {{\input{TheCat.picture}}%^^A
% \footnotetext[1]{Картинка
% нарисована макрокомандой
% \cmd{\qbezier}}}%
-% {\caption[Рисунок рядом~I, внизу бокса объекта]%
+% {\caption[Рисунок в~ряду~I, внизу бокса объекта]%
% {Рисунок рядом~I, внизу бокса объекта\protect\mpfootnotemark}%
% \label{fig:rotrow:WcatI}}%
%
% \floatbox{figure}[2\FBwidth][][b]
-% {\caption{Рисунок рядом~II, вверху бокса объекта}%
+% {\caption{Рисунок в~ряду~II, вверху бокса объекта}%
% \label{fig:rotrow:BcatI}%
% \floatfoot{Всё нарисовано макрокомандами \cmd{\qbezier} и двумя
% вертикальными линиями}}%
% {\input{BlackCat.picture}}%
%
% \ffigbox[\FBwidth]
-% {{\unitlength2.5\unitlength\ifx\pspicture\undefined
-% \else\psset{unit=\unitlength}\fi
-% \input{Mouse.picture}}\footnote[2]
+% {{\unitlength2.5\unitlength
+% \input{Cat.picture}}\footnote[2]
% {Гляньте на чудную сноску!}}
-% {\caption{Рисунок рядом~III, в центре бокса объекта}%
+% {\caption{Рисунок в~ряду~III, в центре бокса объекта}%
% \label{fig:rotrow:mouseI}\floatfoot{Изображение мыши}}%
%
% \floatbox{figure}[\Xhsize][\Mylen]
-% {\caption{Рисунок рядом~IV}\label{fig:rotrow:FcatI}}
+% {\caption{Рисунок в~ряду~IV}\label{fig:rotrow:FcatI}}
% {\Resizebox\hsize\vsize{35}{136}{\input{BlackCat2.picture}}}
% \end{floatrow}
%
% \end{figure}
%
% \end{landscape}
-%\fi\fi
+%\endgroup\fi\fi
%
% \clearpage
% \suppressfloats[t]
+%^^A% \section{Appendix}
% \section{Приложение}
%
% \subsection{Miscellaneous}
%
-% \subsubsection{Смешанные ряды}
-%
-% \floatsetup[figure]{style=Boxed,midcode=captionskip,
-% frameset={\fboxsep12pt\fboxrule1pt}}
-% Иногда автор (или дизайнер) желает поместить разные типы флотов,
-% например, таблицу и рисунок рядом в одном ряду. Такая ситуация
-% создаёт некоторые проблемы.
-%
-% Первая проблема заключается в том, что вы должны поместить разные
-% типы флотов в одно окружение флота, которое задаёт своё оформление
-% для содержимого. Для создания верного оформления задайте команду
-% |\killfloatstyle| в начале окружения \env{floatrow}
-% или до первой <<чужой>> макрокоманды |\floatbox| (в данном
-% примере "--- до |\ttabbox|; команда |\ffigbox| является
-% <<родной>> для окружения \env{figure}).
-%
-% Следующая проблема состоит в том, что подпись к рисункам обычно
-% помещают снизу, а табличный заголовок помещается сверху таблиц.
-% Выравнивание всех флотов одинаково: по нижней линии верхней части и
-% по верхней "--- у нижней. В таком случае, если вы захотите
-% поместить такие рисунок и таблицу,
-% вы получите не лучший вариант вёрстки. В таких ситуациях
-% вы можете использовать одну из приведённых команд:
-%\begin{verbatim}
-%\CenterFloatBoxes
-%\TopFloatBoxes
-%\BottomFloatBoxes
-%\end{verbatim}
-% Которые выравнивают флоты \emph{целиком} по центральной линии,
-% по верху или по низу. Эти команды
-% были созданы командой |\buildFBBOX|. Существует
-% также команда |\PlainFloatBoxes|, которая восстанавливает
-% <<поведение>> флотов внутри команд |\floatbox|.
-%
-% Использование |\CenterFloatBoxes| и |\killfloatstyle| вы видите
-% в смешанном ряду, состоящем из рис.~\ref{fig:rowmixspec:WcatI} и
-% табл.~\ref{tab:rowmixspec:tabI}\label{mixrow}:
-% \DeleteShortVerb{\|}%
-% \begin{figure}
-% \begin{floatrow}
-% \CenterFloatBoxes \killfloatstyle
-% \ffigbox[\FBwidth]
-% {{\unitlength1.15\unitlength\ifx\pspicture\undefined
-% \else\psset{unit=\unitlength}\fi
-% \input{TheCat.picture}}}
-% {\caption{Рисунок (\texttt{Boxed} style) рядом с таблицей
-% (центрирован вертикально)}\label{fig:rowmixspec:WcatI}}%
-% \extrarowheight1pt
-% \ttabbox
-% {\caption{Таблица рядом с рисунком в стиле \texttt{Boxed}
-% (центрирована вертикально)}\label{tab:rowmixspec:tabI}}
-% {\begin{tabular}{|l|c|c|c|}
-% \hline
-% \multirowthead{2}[-1ex]{Column Head}
-% & \multicolumn{3}{c|}{\thead{Data}} \\
-% \cline{2-4}
-% & \thead{I}
-% & \thead{II}
-% & \thead{III} \\
-% \hline
-% First row & 1 & 2 & \phantom01 \\
-% Second row & 3 & 4 & \phantom06 \\
-% Third row & 6 & 8 & 28 \\
-% \hline
-% \end{tabular}}
-% \end{floatrow}
-% \end{figure}
-% \MakeShortVerb{\|}%
-%\begin{verbatim}
-%\begin{figure}
-%\begin{floatrow}
-%\CenterFloatBoxes\killfloatstyle
-%\ffigbox[\FBwidth]
-% ...
-%\ttabbox
-% ...
-%\end{verbatim}
-%
-% \emph{Замечание.} Как рисунок, так и таблица имеют ширину, равную
-% содержимому объектов. Команда |\ffigbox| имеет дополнительный
-% аргумент |[\FBwidth]|, но у команды |\ttabbox| нет никакой опции
-% "--- опция |[\FBwidth]| используется по умолчанию (см. определения
-% на с.~\pageref{abbrcom}).
-%
-%
-% \subsubsection{Использование команд Captionsetup и Thisfloatsetup
-% внутри дополнительного аргумента команды Floatbox}
-%
-% Пример рисунков рядом (рис.~\ref{floatbox:FR:lfig} и
-% \ref{floatbox:FR:fig}). В примере были использованы
+%^^A% \subsubsection{Usage of Captionsetup
+%^^A% Inside Floatbox Stuff}\label{ssec:app:besidestart}
+% \subsubsection{Captionsetup и~Thisfloatsetup
+% в~опции команды Floatbox}\label{ssec:app:besidestart}
+%
+%^^A% Example of figures in row (figures~\ref{floatbox:FR:lfig} and
+%^^A% \ref{floatbox:FR:fig}). There were used predefined float commands
+%^^A% |\fcapsideleft| and |\fcapsideright| with added |\captionsetup| and
+%^^A% |\thisfloatsetup|:
+% Пример рисунков рядом (рис.~\ref{floatbox:FR:lfig}
+% и~\ref{floatbox:FR:fig}). В~примере были использованы
% предопределённые команды
-% постройки флотов |\fcapsideleft| и |\fcapsideright|, в которых
-% добавлены команды |\captionsetup| и |\thisfloatsetup|:
-%\begin{verbatim}
-%\newfloatcommand{fcapsideleft}{figure}[{\capbeside
-% \captionsetup[capbesidefigure]{format=break,labelsep=none,
-% justification=raggedleft}%
-% \thisfloatsetup{capbesideposition=left}}]%
-% [\FBwidth]
-%\newfloatcommand{fcapsideright}{figure}[{\capbeside
-% \captionsetup[capbesidefigure]{format=break,labelsep=none,
-% justification=raggedright}%
-% \thisfloatsetup{capbesideposition=right}}]%
-% [\FBwidth]
-%\end{verbatim}
+% постройки флотов |\fcapsideleft| и~|\fcapsideright|, в~которых
+% добавлены команды |\captionsetup| и~|\thisfloatsetup|:
+%\begin{Quote}
+%|\newfloatcommand{fcapsideleft}{figure}[{\capbeside|
+%| \captionsetup[capbesidefigure]{format=break,labelsep=none,|
+%| justification=raggedleft}%|
+%| \thisfloatsetup{capbesideposition=left}}]%|
+%| [\FBwidth]|
+%|\newfloatcommand{fcapsideright}{figure}[{\capbeside|
+%| \captionsetup[capbesidefigure]{format=break,labelsep=none,|
+%| justification=raggedright}%|
+%| \thisfloatsetup{capbesideposition=right}}]%|
+%| [\FBwidth]|
+%\end{Quote}
%
-% \clearfloatsetup{figure} \floatsetup[figure]
+% \clearfloatsetup{figure}
+% \floatsetup[figure]
% {style=Boxed,capposition=beside,objectset=centering,
% floatwidth=\columnwidth,capbesidewidth=5.75cc,
% capbesidesep=cicero,margins=centering,
@@ -3148,102 +5781,132 @@
% \begin{figure}[b!]
% \begin{floatrow}
% \fcapsideleft
-% {\unitlength1.44\unitlength\ifx\pspicture\undefined
-% \else\psset{unit=\unitlength}\fi
-% \input{TheCat.picture}}
-% {\caption{%^^A
+% {\unitlength1.44\unitlength
+% \input{Cat.picture}}
+% {\caption[Флот в~ряду с~подписью сбоку (бокс графики по её ширине)]{%^^A
% Флот (\cmd{\fcapsideleft}) бокс для объекта
% имеет ширину включённой графики}\label{floatbox:FR:lfig}}%
% \hsize\Xhsize \fcapsideright[\hsize]
-% {\setlength\unitlength{\hsize/61}\ifx\pspicture\undefined
-% \else\psset{unit=\unitlength}\fi
+% {\setlength\unitlength{\hsize/61}%%^^A
% \input{BlackCat.picture}}%
-% {\caption{%^^A
+% {\caption[Флот в~ряду с~подписью сбоку (занимает оставшееся место)]{%^^A
% Флот (\cmd{\fcapsideright})
% ширина всего флота занимает оставшееся пространство в ряду}%^^A
% \label{floatbox:FR:fig}}%
% \end{floatrow}%
% \end{figure}%
% Формат подписи \texttt{break} был определён следующим образом:
-%\begin{verbatim}
-%\DeclareCaptionFormat{break}{#1#2\par#3\par}
-%\end{verbatim}
+%\begin{Quote}
+%|\DeclareCaptionFormat{break}{#1#2\par#3\par}|
+%\end{Quote}
%
+%^^A% For these figures created following \verb|\floatsetup| settings:
% Для этих рисунков были заданы следующие настройки в команде \verb|\floatsetup|:
-%\begin{verbatim}
-%\floatsetup[figure]
-% {style=Boxed,capposition=beside,
-% objectset=centering,floatwidth=\columnwidth,
-% capbesidewidth=5.75cc,capbesidesep=cicero,margins=centering,
-% capbesideframe=yes,floatwidth=sidefil}
-%\end{verbatim}
+%\begin{Quote}
+%|\floatsetup[figure]|
+%| {style=Boxed,capposition=beside,|
+%| objectset=centering,floatwidth=\columnwidth,|
+%| capbesidewidth=5.75cc,capbesidesep=cicero,margins=centering,|
+%| capbesideframe=yes,floatwidth=sidefil}|
+%\end{Quote}
+%^^A% The key \texttt{floatwidth=sidefill} means that in the case of
+%^^A% caption has predefined width, object occupies the rest space of
+%^^A% \verb|\hsize| (in the case of no \meta{width} option used, or used
+%^^A% \verb|\hsize| option).
% Ключ \texttt{floatwidth=sidefill} означает, что в случае заданной
% ширины для подписи сбоку, объект занимает остальное место
% \verb|\hsize| (если не задана опция \meta{width}, или используется
% опция \verb|\hsize|).
%
+%^^A% Left figure uses width of graphics, left one occupies the rest of
+%^^A% float row---for this reason just before \verb|\fcapsideright|
+%^^A% command was written tricky setting:
% Правый рисунок использует ширину графики, левый занимает
-% остальное место в ряду "--- для этого перед командой
-% \verb|\fcapsideright| была задана команда:
-%\begin{verbatim}
-%\hsize\Xhsize
-%\end{verbatim}
-% которая, в случае подписи сбоку определяет ширину всего флота.
-%
-% В качестве опции ширины по умолчанию, \meta{width}, в командах
-% \verb|\fcapsideleft| и \verb|\fcapsideright| задана команда
+% остальное место в~ряду "--- для этого перед командой
+% \verb|\fcapsideright| была задана команда:\allowpostlistbreaks[-4]
+%\begin{Quote}
+%|\hsize\Xhsize|
+%\end{Quote}
+%^^A% which, in case of caption placed beside float object defines width
+%^^A% of full float box.
+% которая, в случае подписи сбоку определяет ширину всего флота.\allowpostlistbreaks
+%
+%^^A% The default \meta{width} option of \verb|\fcapsideleft| and
+%^^A% \verb|\fcapsideright| commands is \verb|\FBwidth|, so for
+%^^A% figure~\ref{floatbox:FR:fig} on the right (created by
+%^^A% \verb|\fcapsideright| command) in the \meta{width} option was set
+%^^A% \verb|\hsize| command to fill the rest space of float row.
+% В~качестве опции ширины по умолчанию, \meta{width}, в~командах
+% \verb|\fcapsideleft| и~\verb|\fcapsideright| задана команда
% \verb|\FBwidth|, поэтому для рисунка~\ref{floatbox:FR:fig}
-% справа (созданном командой \verb|\fcapsideright|) в опции
+% справа (созданном командой \verb|\fcapsideright|) в~опции
% \meta{width} задана команда
-% \verb|\hsize|, чтобы заполнить остальное пространство в ряду.
+% \verb|\hsize|, чтобы заполнить остальное пространство в~ряду.
%
-% Поскольку в стиле флота ключ \texttt{heightadjust=object}
-% (заданный в определения стиля \texttt{Boxed}), оба объекта
+%^^A% Since in float style the key \texttt{heightadjust=object} (included
+%^^A% in definition of \texttt{Boxed} style), both objects have the same
+%^^A% height.
+% Поскольку в~стиле флота ключ \texttt{heightadjust=object}
+% (заданный в~определения стиля \texttt{Boxed}), оба объекта
% имеют одинаковую высоту.
%
+%^^A% \subsubsection{Predefined Beside Caption Width}
% \subsubsection{Предопределённая ширина подписи сбоку}
%
+%^^A% This example includes |\useFCwidth| command, which switches on usage
+%^^A% of previously defined caption width with \texttt{capbesidewidth=} key
+%^^A% (in command |\thisfloatsetup| before |\floatbox| macro) or, if you
+%^^A% didn't set caption width (like in current example), macro counts natural
+%^^A% width of caption contents (see figure~\ref{fig:Idog:w}\footnote{Inside
+%^^A% \cmd{\floatbox} you may not set predefined width of caption, but remember
+%^^A% that you \emph{must} define width of caption in case of usage of plain
+%^^A% float environment.}). The object---caption box in this case aligned
+%^^A% using alignment settings from |margins| key (its options defined
+%^^A% by |\setfloatmargins| or |\floatcapbesidemargins| macro). In this
+%^^A% documentation they are centered (see page~\\pageref{setup:DeclareMarginSet}).
% Этот пример включает команду |\useFCwidth|, которая включает
-% предварительно определённую ширину подписи с заданным значением
+% предварительно определённую ширину подписи с~заданным значением
% ключа \texttt{capbesidewidth=}
-% в команде |\thisfloatsetup| до команды |\floatbox|) или, если
+% в~команде |\thisfloatsetup| до команды |\floatbox|) или, если
% вы не определили ширину подписи
-% (как в данном примере), рассчитывается натуральная ширина подписи
+% (как в~данном примере), рассчитывается натуральная ширина подписи
% (см. рис.~\ref{fig:Idog:w}\footnote{Внутри команды \cmd{\floatbox}
% не обязательно определять ширину подписи заранее, но помните, что
% ширину подписи \emph{нужно} определить, если это простое окружение
-% флота.}). Флот в этом случае выровнен горизонтально с
-% использованием настроек выравнивания, взятых из ключа
+% флота.}). Флот в~этом случае выровнен горизонтально
+% с~использованием настроек выравнивания, взятых из ключа
% \texttt{margins=} (опции определяются командами
-% |\setfloatmargins| или |\floatcapbesidemargins|). В этой
+% |\setfloatmargins| или |\floatcapbesidemargins|). В~этой
% документации задано центрирование (см.
-% с.~\pageref{fsetup:besmarg}).
-%\begin{verbatim}
-%\begin{figure}
-%\floatbox[\capbeside\useFCwidth]{figure}[\FBwidth]
-% ...
-%\end{figure}
-%\end{verbatim}
-% \clearfloatsetup{figure} \floatsetup[figure]{style=plain}
+% с.~\pageref{setup:DeclareMarginSet}).
+%\begin{Quote}
+%\meta{preamble}
+%|\floatsetup[figure]{style=plain}|
+%\meta{preamble}
+%|\begin{figure}|
+%|\floatbox[\capbeside\useFCwidth]{figure}[\FBwidth]|
+%| ...|
+%|\end{figure}|
+%\end{Quote}
+% \clearfloatsetup{figure}
+% \floatsetup[figure]{style=plain}
%
-% \begin{figure}[h]
+% \begin{figure}[H]
% \floatbox[\capbeside\useFCwidth]{figure}[\FBwidth]
% {\caption[Подпись сбоку
% бокс которой равен тексту подписи]{Подпись
% сбоку}\label{fig:Idog:w}}
-% {{\setlength\unitlength{{4cm}/60}\ifx\pspicture\undefined
-% \else\psset{unit=\unitlength}\fi
+% {{\setlength\unitlength{{4cm}/60}%^^A
% \input{BlackDog.picture}}}
% \end{figure}%
%
-% Настройки данного флота:
-%\begin{verbatim}
-%\floatsetup[figure]{style=plain}
-%\end{verbatim}
%
-% \subsubsection{Предопределённая ширина подписи и остальное
+%^^A% \subsubsection{Predefined Beside Caption Width with
+%^^A% The Rest Space for Object}\label{FAD:RestSpaceforObject}
+% \subsubsection{Предопределённая ширина подписи и~остальное
% "--- для объекта}
%
+%^^A% The figure \ref{fig:capbeside:trick} uses following float style:%^^A
% Рисунок \ref{fig:capbeside:trick} использует следующий стиль
% флота:%^^A
%^^A \footnote{There are also addition settings for captions:
@@ -3251,25 +5914,25 @@
%^^A \texttt{\{format=default,}\allowbreak
%^^A \texttt{labelsep=none\}}
%^^A which is necessary for current documentation: the
-%^^A \pkg{hyperref} creates unwanted result with empty argument
+%^^A \package{hyperref} creates unwanted result with empty argument
%^^A of caption title. The same settings used for
%^^A figures~\ref{floatrow:pre:figI} and
%^^A \ref{floatrow:pre:figII}}
-%\begin{verbatim}
-%\floatsetup[figure]
-% {style=Boxed,capposition=beside,objectset=centering,
-% floatwidth=\columnwidth,capbesidewidth=\Mylen,
-% capbesideposition=left,capbesidesep=cicero,
-% margins=centering,capbesideframe=yes,
-% floatwidth=sidefil}
-%\end{verbatim}
+%\begin{Quote}
+%\meta{preamble}
+%|\renewlengthtocommand\settowidth\Mylen{\captionfont\captionlabelfont|
+%| \figurename\ \thefigure}|
+%\meta{preamble}
+%|\floatsetup[figure]|
+%| {style=Boxed,capposition=beside,objectset=centering,|
+%| floatwidth=\columnwidth,capbesidewidth=\Mylen,|
+%| capbesideposition=left,capbesidesep=cicero,|
+%| margins=centering,capbesideframe=yes,|
+%| floatwidth=sidefil}|
+%\end{Quote}
+%^^A% The \verb|\Mylen| dimension was defined as width of caption label.
% Величина \verb|\Mylen| была определена как ширина нумерационного
-% заголовка подписи:
-%\begin{verbatim}
-%\newdimen\Mylen
-%\settowidth\Mylen{\captionfont\captionlabelfont
-% \figurename\ \thefigure}
-%\end{verbatim}
+% заголовка подписи.
%
% \clearfloatsetup{figure}
% \floatsetup[figure]
@@ -3277,42 +5940,49 @@
% floatwidth=\columnwidth,capbesidewidth=\Mylen,
% capbesideposition=left,capbesidesep=cicero,
% margins=centering,capbesideframe=yes,floatwidth=sidefil}
-% \newdimen\Mylen\settowidth\Mylen{\captionfont\captionlabelfont\figurename\
+% \renewlengthtocommand\settowidth\Mylen{\captionfont\captionlabelfont\figurename\
% \thefigure}
%
-% \begin{figure}
+%\begingroup
+% \begin{figure}[H]
%^^A \captionsetup[capbesidefigure]{format=default,labelsep=none}
% \fcapside
-% {\unitlength1.1\unitlength\ifx\pspicture\undefined
-% \else\psset{unit=\unitlength}\fi
-% \input{TheCat.picture}}
-% {\caption{}\label{fig:capbeside:trick}}
+% {\unitlength1.1\unitlength
+% \input{Horse.picture}}
+% {\caption[Бокс подрисуночной подписи равен ширине её содержимого (здесь: её метки)]{}\label{fig:capbeside:trick}}
% \end{figure}%
+%\endgroup
%
%
-% \subsubsection{Подпись рядом с отцентрированным объектом}
+%^^A% \subsubsection{Caption Beside with Centered Object}\label{FAD:CapandCenterObj}
+% \subsubsection{Подпись рядом с~отцентрированным на всю ширину объектом}\label{FAD:CapandCenterObj}
%
+%^^A% The figure \ref{fig:plain:trick} uses tricky float style:
% Рисунок \ref{fig:plain:trick} использует хитроумный вариант
% оформления:
-%\begin{verbatim}
-%\floatsetup[figure]
-% {style=plain,capposition=beside,objectset=centering,
-% floatwidth=\columnwidth,capbesidewidth=6cc,
-% capbesideposition=left,capbesidesep=mcapwidth,
-% margins=centering,capbesideframe=yes,
-% floatwidth=sidefil}
-%\end{verbatim}
-% опция \texttt{mcapwidth} задаёт отрицательную отбивку, равную
-% ширине подписи:
-%\begin{verbatim}
-%\DeclareFloatSeparators{mcapwidth}{\hskip-\FCwidth}
-%\end{verbatim}
-% В этом случае все рисунки с подписями сбоку будут центрированы
+%\begin{Quote}
+%\meta{preamble}
+%|\DeclareFloatSeparators{mcapwidth}{\hskip-\FCwidth}|
+%\meta{preamble}
+%|\floatsetup[figure]|
+%| {style=plain,capposition=beside,objectset=centering,|
+%| floatwidth=\columnwidth,capbesidewidth=6cc,|
+%| capbesideposition=left,capbesidesep=mcapwidth,|
+%| margins=centering,capbesideframe=yes,|
+%| floatwidth=sidefil}|
+%\end{Quote}
+%^^A% the \texttt{mcapwidth} option is a negative skip equal to caption
+%^^A% width:
+%^^A% I this case all figures with beside captions centered accordingly to
+%^^A% text \verb|\hsize|. Usage of such float layout supposes that all
+%^^A% float objects are narrower than |\textwidth| by at least 2~caption
+%^^A% widths.
+% В~этом случае все рисунки с~подписями сбоку будут центрированы
% относительно текущей величине \verb|\hsize|. Использование такого
% оформления флота предполагает что все объекты флота \'уже чем
% |\textwidth|, как минимум на 2~ширины подписи.
%
-% \clearfloatsetup{figure} \floatsetup[figure]
+% \clearfloatsetup{figure}\floatsetup[figure]
% {style=plain,capposition=beside,objectset=centering,
% floatwidth=\columnwidth,capbesidewidth=6cc,
% capbesideposition=left,capbesidesep=mcapwidth,
@@ -3320,124 +5990,148 @@
% \begingroup
% \captionsetup[capbesidefigure]{format=break,labelsep=none,
% justification=raggedright}
-% \begin{figure}
-% \unitlength1.1\unitlength\ifx\pspicture\undefined
-% \else\psset{unit=\unitlength}\fi
-% \input{TheCat.picture}
-% \caption{%^^A
-% Обычный рисунок}\label{fig:plain:trick}
+% \begin{figure}[H]
+% \unitlength1.1\unitlength
+% \input{Doll.picture}
+% \caption[Просто рисунок, ширина (\texttt{=6сс}) подписи <<скрыта>>, рисунок центрируется на весь формат]{%^^A
+% Просто рисунок}\label{fig:plain:trick}
% \end{figure}%
% \endgroup
%
-% Здесь также временно, в группе, заменены настройки для
-% подрисуночной подписи~\ref{fig:plain:trick}:
-%\begin{verbatim}
-%\captionsetup[capbesidefigure]{format=break,labelsep=none,
-% justification=raggedright}
-%\end{verbatim}
-%
-% \subsubsection{Определение ширины для блока подпись сбоку---объект
-% в окружении \env{floatrow}}
-%
-% Ряд с предопределёнными ширинами для боксов подпись
-% сбоку---объект (рис.~\ref{floatrow:pre:figI} и
-% \ref{floatrow:pre:figII}): просто определите перед командами
+%^^A% There were also temporarily, in group, changed settings for caption
+%^^A% in figure~\ref{fig:plain:trick}:\label{ssec:app:besidefinish}
+% Здесь также временно, в~группе, заменены настройки для
+% подрисуночной подписи~\ref{fig:plain:trick}:\label{ssec:app:besidefinish}
+% \par\RestoreSpaces
+%\begin{Quote}
+%|\captionsetup[capbesidefigure]{format=break,labelsep=none,|
+%| justification=raggedright}|
+%\end{Quote}
+%
+%^^A% \subsubsection{Width Definition for Beside
+%^^A% Caption---Object Box in Float Row}
+% \subsubsection{Ширина для блока подпись сбоку---объект
+% внутри \env{floatrow}}
+%
+%^^A% The float row with predefined width of beside object---caption
+%^^A% boxes (figures~\ref{floatrow:pre:figI} and
+%^^A% \ref{floatrow:pre:figII}): just define before \verb|\fcapside|
+%^^A% command something like
+% Ряд с~предопределёнными ширинами для боксов подпись
+% сбоку---объект (рис.~\ref{floatrow:pre:figI}
+% и~\ref{floatrow:pre:figII}): просто определите перед командами
% \verb|\fcapside| что-то типа
-%\begin{verbatim}
-%\setlength\hsize{1.098\hsize}%
-%\end{verbatim}
+%\begin{Quote}
+%|\setlength\hsize{1.2\hsize}%|
+%\end{Quote}
+%^^A% as was defined for first figure, or
% как было определено для первого рисунка, или
-%\begin{verbatim}
-%\setlength\hsize\Xhsize
-%\end{verbatim}
+%\begin{Quote}
+%|\setlength\hsize\Xhsize|
+%\end{Quote}
+%^^A% before second (here is clear that you can set
+%^^A% |\setlength\hsize{.8\hsize}|).
% перед вторым (здесь видно, что можно задать и
-% |\setlength\hsize{.902\hsize}|).
-%
-% В начале окружения \env{floatrow} была задана команда
-% \verb|\useFCwidth| которая включает механизм использования и
-% расчёта ширины подписи сбоку и, поскольку используются
+% |\setlength\hsize{.8\hsize}|).
+%
+%^^A% Since there were used \verb|\fcapside| commands at the beginning of
+%^^A% \env{floatrow} environment the \verb|\FCwidth| command was defined
+%^^A% as \verb|\relax|---in this case the width of caption equals to the
+%^^A% width of their contents.
+% В~начале окружения \env{floatrow} была задана команда
+% \verb|\useFCwidth| которая включает механизм использования
+% и~расчёта ширины подписи сбоку и, поскольку используются
% команды \verb|\fcapside|, ширину подписей можно не определять
% (ключ \texttt{capbesidewidth=} не задан), поэтому ширина боксов
% подписей будет равна их содержимому.
%
+%\begingroup
% \clearfloatsetup{figure}
% \floatsetup[figure]
% {style=plain,capposition=beside,objectset=centering,
% capbesideposition=left,capbesidesep=enskip,
% margins=centering,capbesideframe=yes,floatwidth=sidefil}
-% \begin{figure}[h]\useFCwidth
+% \begin{figure}[H]\useFCwidth
%^^A \captionsetup[capbesidefigure]{format=default,labelsep=none}
% \begin{floatrow}
-% \setlength\hsize{1.098\hsize}%
+% \setlength\hsize{1.2\hsize}%
% \fcapside
-% {\setlength\unitlength{\hsize/64}\ifx\pspicture\undefined
-% \else\psset{unit=\unitlength}\fi
-% \input{TheCat.picture}}
-% {\caption{%^^A
+% {\setlength\unitlength{\hsize/100}%^^A
+% \input{Bear.picture}}
+% {\caption[Левый рисунок в~ряду с~подписью сбоку]{%^^A
% }\label{floatrow:pre:figI}}
% \setlength\hsize\Xhsize
% \fcapside
-% {\setlength\unitlength{\hsize/58}\ifx\pspicture\undefined
-% \else\psset{unit=\unitlength}\fi
-% \input{Mouse.picture}}
-% {\caption{%^^A
+% {\setlength\unitlength{\hsize/44}%^^A
+% \input{Doll.picture}}
+% {\caption[Правый рисунок в~ряду с~подписью сбоку]{%^^A
% }\label{floatrow:pre:figII}}
% \end{floatrow}%
% \end{figure}%
+%\endgroup
+%^^A% There was used following setup for figures:
% Были использованы следующие настройки для рисунков:
-%\begin{verbatim}
-%\floatsetup[figure]
-% {style=plain,capposition=beside,objectset=centering,
-% capbesideposition=left,capbesidesep=enskip,
-% margins=centering,capbesideframe=yes,floatwidth=sidefil}
-%\end{verbatim}
-%
-% \subsubsection{Флот с подписью сверху/снизу и флот
-% с подписью сбоку в одном ряду}
-%
-% В ряду совмещены бокс объект---подпись сбоку и бокс с
-% объект---подпись снизу (рис.~\ref{flrow:mix:figI} и
-% \ref{flrow:mix:figII}). Здесь приходится опять использовать
+%\begin{Quote}
+%|\floatsetup[figure]|
+%| {style=plain,capposition=beside,objectset=centering,|
+%| capbesideposition=left,capbesidesep=enskip,|
+%| margins=centering,capbesideframe=yes,floatwidth=sidefil}|
+%\end{Quote}
+%
+%^^A% \subsubsection{Caption Above/Below Float and Caption Beside Float at
+%^^A% The One Float Row}\label{FAD:CapBesideandBelow}
+% \subsubsection{Подпись сверху/снизу
+% и~подпись сбоку в~одном ряду}\label{FAD:CapBesideandBelow}
+%
+%^^A% The float row with object and beside caption combined with object
+%^^A% and caption below (figures~\ref{flrow:mix:figI} and
+%^^A% \ref{flrow:mix:figII}). There we ought to use
+%^^A% \verb|\TopFloatBoxes|, \verb|\CenterFloatBoxes|, or
+%^^A% |\BottomFloatBoxes| commands to get correct layout---since the
+%^^A% \meta{height} argument in both float boxes defined as \texttt{4cm}
+%^^A% you may use each of these three commands. Unfortunately you must set
+%^^A% height of such beside floats by hand. The lines which create
+%^^A% described float row:
+% В~ряду совмещены бокс объект---подпись сбоку и~бокс
+% объект---подпись снизу (рис.~\ref{flrow:mix:figI}
+% и~\ref{flrow:mix:figII}). Здесь приходится опять использовать
% команды \verb|\TopFloatBoxes|, \verb|\CenterFloatBoxes|, или
% |\BottomFloatBoxes|, чтобы получить нужную вёрстку "--- поскольку
-% аргумент \meta{height} в обоих флотах определён как \texttt{4cm}
-% вы можете использовать любую из этих трёх команд. К сожалению вам
+% аргумент \meta{height} в~обоих флотах определён как \texttt{4cm}
+% вы можете использовать любую из этих трёх команд. К~сожалению вам
% приходится задать высоту таких флотов рядом вручную. Строки,
% которые создают описанный выше ряд флотов:
-%\begin{verbatim}
-%\begin{figure}\CenterFloatBoxes
-%\begin{floatrow}
-%\hsize1.098\hsize
-% \fcapside[\FBwidth][4cm]
-% ...
-%
-% \ffigbox[\Xhsize][4cm]
-% ...
-%\end{floatrow}%
-%\end{figure}
-%\end{verbatim}
+%\begin{Quote}
+%|\begin{figure}\CenterFloatBoxes|
+%|\begin{floatrow}|
+%|\hsize1.098\hsize|
+%| \fcapside[\FBwidth][4cm]|
+%| ...|
+%| |
+%| \ffigbox[\Xhsize][4cm]|
+%| ...|
+%|\end{floatrow}%|
+%|\end{figure}|
+%\end{Quote}
%
% \clearfloatsetup{figure}
% \floatsetup[figure]
-% {style=Boxed,frameset={\fboxsep6pt},
-% captionskip=5pt,capposition=bottom,
-% objectset=centering,capbesidewidth=none,
-% capbesideposition=inside,
+% {style=Boxed,frameset={\fboxsep6pt},captionskip=5pt,capposition=bottom,
+% objectset=centering,capbesidewidth=none,capbesideposition=inside,
% capbesidesep=enskip,margins=centering,capbesideframe=yes}
%
-% \begin{figure}\CenterFloatBoxes
+% \begin{figure}[H]\CenterFloatBoxes
% \begin{floatrow}
% \hsize1.098\hsize \fcapside[\FBwidth][4cm]
-% {\unitlength1.44\unitlength\ifx\pspicture\undefined
-% \else\psset{unit=\unitlength}\fi
-% \input{TheCat.picture}}
-% {\caption{%^^A
+% {\unitlength1.44\unitlength
+% \input{Cat.picture}}
+% {\caption[Флот \cmd{\fcapside} в ряду с
+% флотом \cmd{\ffigbox}]{%^^A
% Флот (\cmd{\fcapside}) с подписью сбоку в ряду с
-% флотом с подписью снизу}\label{flrow:mix:figI}}%
+% флотом с подписью \hbox{снизу}}\label{flrow:mix:figI}}%
%
% \ffigbox[\Xhsize][4cm]
-% {\unitlength1.44\unitlength\ifx\pspicture\undefined
-% \else\psset{unit=\unitlength}\fi
+% {\unitlength1.44\unitlength
% \input{BlackDog.picture}}
% {\caption{%^^A
% Флот (\cmd{\ffigbox}), занимает оставшееся в ряду
@@ -3445,127 +6139,146 @@
% \end{floatrow}%
% \end{figure}
%
+%^^A% The ``mirror layout'' (but not identical) looks like:
% <<Зеркальная вёрстка>> (но не идентичная) выглядит так:
-%\begin{verbatim}
-%\begin{figure}\CenterFloatBoxes
-%\begin{floatrow}
-% \ffigbox[1.2\FBwidth][4cm]
-% ...
-%
-% \hsize\Xhsize
-% \fcapside[\FBwidth][4cm]
-% ...
-%\end{floatrow}%
-%\end{figure}
-%\end{verbatim}
-%
-% \begin{figure}\CenterFloatBoxes
+% \par\RestoreSpaces
+%\begin{Quote}
+%|\begin{figure}\CenterFloatBoxes|\nopagebreak
+%|\begin{floatrow}|
+%| \ffigbox[1.2\FBwidth][4cm]|
+%| ...|
+%| |
+%| \hsize\Xhsize|
+%| \fcapside[\FBwidth][4cm]|
+%| ...|
+%|\end{floatrow}%|
+%|\end{figure}|
+%\end{Quote}
+%
+% \begin{figure}[H]\CenterFloatBoxes
% \begin{floatrow}
% \ffigbox[1.2\FBwidth][4cm]
-% {\unitlength1.44\unitlength\ifx\pspicture\undefined
-% \else\psset{unit=\unitlength}\fi
+% {\unitlength1.44\unitlength
% \input{BlackDog.picture}}
% {\caption{%^^A
-% Флот (\cmd{\ffigbox})}\label{floatrow:mirrmix:figII}}%
+% Флот (\cmd{\ffigbox}) в~«зеркальном» ряду}\label{floatrow:mirrmix:figII}}%
% \hsize\Xhsize
%
% \fcapside[\FBwidth][4cm]
-% {\unitlength1.44\unitlength\ifx\pspicture\undefined
-% \else\psset{unit=\unitlength}\fi
-% \input{TheCat.picture}}
-% {\caption{%^^A
+% {\unitlength1.44\unitlength
+% \input{Cat.picture}}
+% {\caption[Флот \cmd{\fcapside} в~«зеркальном» ряду]{%^^A
% Флот с подписью сбоку (\cmd{\fcapside}) в зеркальном ряду
-% с флотом с подписью снизу}\label{floatrow:mirrmix:figI}}
+% с флотом с подписью \hbox{снизу}}\label{floatrow:mirrmix:figI}}
% \end{floatrow}%
% \end{figure}
%
+%^^A% The figures~\ref{floatrow:mirrmix:figII}--\ref{floatrow:mirrmix:figI}
+%^^A% use following float style settings:
% Рисунки~\ref{floatrow:mirrmix:figII}--\ref{floatrow:mirrmix:figI}
% использовали следующие настройки:
-%\begin{verbatim}
-%\floatsetup[figure]
-% {style=Boxed,frameset={\fboxsep4pt},captionskip=5pt,
-% capposition=bottom,objectset=centering,capbesidewidth=none,
-% capbesideposition=inside,capbesidesep=enskip,margins=centering,
-% capbesideframe=yes}
-%\end{verbatim}
-%
+% \par\RestoreSpaces
+%\begin{Quote}
+%|\floatsetup[figure]|
+%| {style=Boxed,frameset={\fboxsep4pt},captionskip=5pt,|
+%| capposition=bottom,objectset=centering,capbesidewidth=none,|
+%| capbesideposition=inside,capbesidesep=enskip,margins=centering,|
+%| capbesideframe=yes}|
+%\end{Quote}
+%
+%^^A% \subsubsection{Photo-Album-like Layouts}
% \subsubsection{Вёрстка под фотоальбом}
%
+%^^A% Another example of miscellaneous float row
+%^^A% (figures~\ref{flrow:three:figIII}--\ref{floatrow:threemirr:figII},
+%^^A% and, ``mirror layout''---^^A
+%^^A% \ref{floatrow:threemirr:figI}--\ref{floatrow:threemirr:figIII}) were
+%^^A% created by following lines:
% Другой пример необычного ряда флотов
% (рис.~\ref{flrow:three:figIII}--\ref{floatrow:threemirr:figII},
% и, <<зеркальная вёрстка>>, "---
% \ref{floatrow:threemirr:figI}--\ref{floatrow:threemirr:figIII})
% были созданы следующим кодом:
-%\begin{verbatim}
-%\begin{figure}[t]\BottomFloatBoxes
-%\begin{floatrow}
-%\hsize1.2\hsize \ffigbox[][6.7cm]
-% ...
-%
-%\vbox to6.7cm
-% {\floatsetup[figure]{floatrowsep=none}\killfloatstyle
-% \ffigbox[.8\hsize]
-% ...
-% \vss
-% \ffigbox[.8\hsize]
-% ...%
-% }%
-%\end{floatrow}%
-%\end{figure}
-%\end{verbatim}
+%\begin{Quote}
+%|\begin{figure}[t]\BottomFloatBoxes|\nopagebreak
+%|\begin{floatrow}|
+%|\hsize1.2\hsize \ffigbox[][6.7cm]|
+%| ...|
+%| |
+%|\vbox to6.7cm|
+%| {\floatsetup[figure]{floatrowsep=none}\killfloatstyle|
+%| \ffigbox[.8\hsize]|
+%| ...|
+%| \vss|
+%| \ffigbox[.8\hsize]|
+%| ...%|
+%| }%|
+%|\end{floatrow}%|
+%|\end{figure}|
+%\end{Quote}
%
% \floatsetup[figure]{heightadjust=none}
-% \begin{figure}\BottomFloatBoxes
+% \begin{figure}[H]\BottomFloatBoxes
% \begin{floatrow}
% \hsize1.2\hsize
% \ffigbox[][6.7cm]
-% {\setlength\unitlength{\hsize/58}\ifx\pspicture\undefined
-% \else\psset{unit=\unitlength}\fi
+% {\setlength\unitlength{\hsize/58}%^^A
% \input{Mouse.picture}}%
-% {\caption{Бокс флота в вёрстке под фотоальбом:
-% один в левой колонке}\label{flrow:three:figIII}}%
+% {\caption[Вёрстка фотоальбома: левый флот]{Бокс флота в~вёрстке под фотоальбом:
+% один в~левой колонке}\label{flrow:three:figIII}}%
%
% \vbox to6.7cm
% {\floatsetup[figure]{floatrowsep=none}\killfloatstyle
% \ffigbox[.8\hsize]
% {\input{TheCat.picture}}
-% {\caption{%^^A
+% {\caption[Вёрстка фотоальбома: правый верхний флот]{%^^A
% Бокс флота в вёрстке под фотоальбом: верхний флот в правой
% колонке}\label{floatrow:three:figI}} \vss \ffigbox[.8\hsize]
% {\input{BlackDog.picture}}%
-% {\caption{%^^A
+% {\caption[Вёрстка фотоальбома: правый верхний флот]{%^^A
% Нижний флот в правой колонке}%
% \label{floatrow:threemirr:figII}}}%
% \end{floatrow}%
% \end{figure}
%
+%^^A% The ``mirror'' layout created by following commands:
% <<Зеркальная вёрстка>> создана следующими командами:
-%\begin{verbatim}
-%\begin{figure}[t]\TopFloatBoxes
-%\begin{floatrow}
-%\vtop to7cm
-% {\floatsetup[figure]{floatrowsep=none}\killfloatstyle
-% \ffigbox[.8\hsize]
-% ...
-% \vss
-% \ffigbox[.8\hsize]
-% ...%
-% \vskip0pt}\floatrowsep
-%
-%\ffigbox[\Xhsize][7cm-11pt]
-% ...
-%\end{floatrow}%
-%\end{figure}
-%\end{verbatim}
-% Обратите внимание, что во втором примере с <<зеркальной вёрсткой>>
-% был использован трюк с определением высоты в аргументе
-% \meta{height} "--- подпись в левой колонке длиннее на одну строку,
+% \par\RestoreSpaces
+%\begin{Quote}
+%|\begin{figure}\TopFloatBoxes|
+%|\begin{floatrow}|
+%|\vtop to7cm|
+%| {\floatsetup[figure]{floatrowsep=none}\killfloatstyle|
+%| \ffigbox[.8\hsize]|
+%| ...|
+%| \vss|
+%| \ffigbox[.8\hsize]|
+%| ...%|
+%| \vskip0pt}\floatrowsep|
+%| |
+%|\ffigbox[\Xhsize][7cm-11pt]|
+%| ...|
+%|\end{floatrow}%|
+%|\end{figure}|
+%\end{Quote}
+%^^A% Note that in second example with ``mirror'' layout there was used
+%^^A% trick with \meta{height} definition---caption of float in the left
+%^^A% column is one line longer, so for the right column height of float
+%^^A% was reduced by 11pt---|\baselineskip| for |\small|
+%^^A% size\footnote{You get correct height with such calculations for
+%^^A% beside floats with \package{caption}'s version not older than 3.0d.}
+%^^A% (here were used \package{calc} package possibilities). The |\vtop| of
+%^^A% left column ends with |\vskip0pt|, otherwise you get fanny unwanted
+%^^A% layout.
+% Обратите внимание, что во втором примере с~<<зеркальной вёрсткой>>
+% был использован трюк с~определением высоты в~аргументе
+% \meta{height} "--- подпись в~левой колонке длиннее на одну строку,
% поэтому для правой колонки высота флота была уменьшена на 22pt
% "---2|\baselineskip| для шрифта размером
-% |\small|\footnote{Вы получите корректную высоту с такими расчётами
-% для флотов рядом при использовании версией пакета \pkg{caption}
+% |\small|\footnote{Вы получите корректную высоту с~такими расчётами
+% для флотов рядом при использовании версией пакета \package{caption}
% не ниже 3.0d.} (здесь были использованы возможности пакета
-% \pkg{calc}). Бокс |\vtop| в левой колонке завершён командой
+% \package{calc}). Бокс |\vtop| в~левой колонке завершён командой
% |\vskip0pt|, иначе вы получите неожиданный результат.
%
%
@@ -3574,99 +6287,388 @@
% \vtop to8cm {\floatsetup[figure]{floatrowsep=none}\killfloatstyle
% \ffigbox[.8\hsize]
% {\input{TheCat.picture}}
-% {\caption{%^^A
-% Бокс флота в зеркальной вёрстке под фотоальбом:
-% верхний флота в левой
+% {\caption[Зеркальная вёрстка фотоальбома: верхний левый флот]{%^^A
+% Бокс флота в~зеркальной вёрстке под фотоальбом:
+% верхний флот в~левой
% колонке}\label{floatrow:threemirr:figI}}
% \vss
% \ffigbox[.8\hsize]
% {\input{BlackDog.picture}}%
-% {\caption{%^^A
-% Бокс флота в зеркальной вёрстке под фотоальбом:
-% нижний флот в левой колонке}%
+% {\caption[Зеркальная вёрстка фотоальбома: нижний левый флот]{%^^A
+% Бокс флота в~зеркальной вёрстке под фотоальбом:
+% нижний флот в~левой колонке}%
% \label{floatrow:three:figII}}\vskip0pt}\floatrowsep
%
% \ffigbox[\Xhsize][8cm-22pt]
-% {\setlength\unitlength{\hsize/58}\ifx\pspicture\undefined
-% \else\psset{unit=\unitlength}\fi
+% {\setlength\unitlength{\hsize/58}%^^A
% \input{Mouse.picture}}%
-% {\caption{%^^A
-% Бокс флота в зеркальной вёрстке под фотоальбом:
-% отдельный в правой колонке}\label{floatrow:threemirr:figIII}}
+% {\caption[Зеркальная вёрстка фотоальбома: правый флот]{%^^A
+% Бокс флота в~зеркальной вёрстке под фотоальбом:
+% отдельный в~правой колонке}\label{floatrow:threemirr:figIII}}
% \end{floatrow}%
% \end{figure}
%
-% В обоих примерах для двух флотов друг под другом была отменена
+%^^A% In both examples for two floats one above another was cancelled
+%^^A% |\floatrowsep| code inside |\vbox|/|\vtop|.
+% В~обоих примерах для двух флотов друг под другом была отменена
% команда |\floatrowsep| внутри |\vbox|/|\vtop|.
%
+%^^A% Note that these examples are rather specific---you may try with
+%^^A% other combinations (e.g. more-``columned''), but maybe these layouts
+%^^A% need more care with usage of |\Xhsize| and/or |\floatrowsep|.
% Обратите внимание, что эти примеры довольно специфичны "--- можно
% попробовать создать другие комбинации (например,
% <<многоколонные>>), но возможно такая вёрстка потребует большей
-% внимательности по отношению к использованию |\Xhsize| и/или
+% внимательности по отношению к~использованию |\Xhsize| и/или
% |\floatrowsep|.
%
-% Я предполагаю, что два последних примера конфликтуют с <<девизом>>
-% данного пакета "--- уменьшить и переместить код оформления из
-% текста документа; но вёрстка под фотоальбом довольно редка в
-% технической литературе (или это не так?).
-%
-% \subsection{Файлы примеров}
+%^^A% I suppose that last two examples could conflict with ``motto'' of
+%^^A% this package---to reduce and remove layout code from document; but
+%^^A% photo-album-like layout is rather rare in technical literature (It
+%^^A% isn't?).
+% Я~предполагаю, что два последних примера конфликтуют с~<<девизом>>
+% данного пакета \cdash--- уменьшить и~переместить код оформления из
+% текста документа; но вёрстка под фотоальбом довольно редка
+% в~технической литературе (или это не так?).
%
-% Дистрибутив пакета \env{floatrow} предлагает несколько файлов с
-% примерами, которые демонстрируют настройки, не описанные в данном
-% документе (некоторые из них несколько экзотичны и ненатуральны).
+% \clearpage
+% \par\RestoreSpaces
+%^^A% \subsection{Sample files}\label{sec:samples}
+% \subsection{Файлы примеров}\label{sec:samples}
+%
+%^^A% The \env{floatrow} package distribution offers a few files with
+%^^A% examples, which show settings, not covered by current document (some
+%^^A% of them are bit exotic and unnatural). The samples have not aim to
+%^^A% create perfect layout, but to show easy modification for all float
+%^^A% types, and show goals and drawbacks in combinations of chosen layout
+%^^A% with different float types and their contents.
+% Дистрибутив пакета \env{floatrow} предлагает несколько файлов
+% с~примерами, которые демонстрируют настройки, не описанные в~данном
+% документе (некоторые из них несколько экзотичны и~ненатуральны).
% Примеры не имеют цели создать совершенную вёрстку, только показать
-% быстроту и простоту модификации оформления для флотов всех
-% типов, и показывает достоинства и недостатки в комбинациях
+% быстроту и~простоту модификации оформления для флотов всех
+% типов, и~показывает достоинства и~недостатки в~комбинациях
% выбранного оформления при разных размещениях флотов.
%
+%^^A% \emph{Note}. All miscellaneous float styles (i.e. almost
+%^^A% all sample files) need at least two \LaTeX{} runs.
% \emph{Замечание}. Все нестандартные стили флотов (фактически все
% файлы примеров) требуют как минимум две обработки \LaTeX'ом.
%
+%^^A% The list of samples:
% Перечень файлов примеров:
%
% \begin{Options}{\OptionLabel}
+%^^A% \item[frsample01.tex] all possible combinations of predefined
+%^^A% \package{floatrow} styles for captions above/below floats with foot
+%^^A% material; there were created plain float environments and
+%^^A% \env{floatrow}s, also there were created boxes with
+%^^A% alone objects and alone captions;
% \item[frsample01.tex] все возможные комбинации
-% предопределённых стилей пакета \pkg{floatrow}
-% для подписей сверху/снизу с экспликациями; были созданы
-% простые флоты, окружения с рядом флотов (окружение
-% \env{floatrow}), а также варианты объекта без подписи
-% и подписи без объекта;
-% \item[frsample02.tex] все возможные комбинации с
-% предопределёнными стилями пакета \pkg{floatrow} для подписей
-% сбоку и все возможные расположения подписей;
-% \item[frsample03.tex] различные тесты с таблицами;
-% \item[frsample04.tex] пример с необычным оформлением и
-% размещением подписей сбоку;
+% предопределённых стилей пакета \package{floatrow}
+% для подписей сверху/снизу с~экспликациями; были созданы
+% простые флоты, окружения с~рядом флотов (окружение
+% \env{floatrow}), а~также варианты объекта без подписи
+% и~подписи без объекта;
+%^^A% \item[frsample02.tex] all possible combinations of predefined
+%^^A% \package{floatrow} styles for beside captions and all possible
+%^^A% caption positions;
+% \item[frsample02.tex] все возможные комбинации
+% с~предопределёнными стилями пакета \package{floatrow} для подписей
+% сбоку и~все возможные расположения подписей;
+%^^A% \item[frsample03.tex] different tests with tables;
+% \item[frsample03.tex] различные тесты с~таблицами;
+%^^A% \item[frsample04.tex] sample with fancy layout with usage of
+%^^A% beside captions;
+% \item[frsample04.tex] пример с~необычным оформлением
+% и~размещением подписей сбоку;
+%^^A% \item[frsample05.tex] one-column facing layout; miscellaneous
+%^^A% caption settings.
% \item[frsample05.tex] одноколонная вёрстка, зеркальный макет
% на развороте; необычные настройки для подписей.
% \end{Options}
%
+%^^A% The next bundle of samples is a few file-headers with different
+%^^A% preamble which run the same file with various float
+%^^A% layouts. For these examples there was created a new float type of
+%^^A% float \texttt{textbox}---which includes text in its object contents.
% Следующий связанный ряд файлов-примеров имеют несколько
-% файлов"=заголовков с различной преамбулой, которые
-% обрабатывают файл с различным размещением флотов.
-% В этих примерах был создан новый тип флота
-% \texttt{textbox} "--- который включает в себя текст.
+% файлов"=заголовков с~различной преамбулой, которые
+% обрабатывают файл с~различным размещением флотов.
+% В~этих примерах был создан новый тип флота
+% \texttt{textbox} "--- который включает в~себя текст.
% \begin{Options}{\OptionLabel}
+%^^A% \item[frsample10.tex] one column non-facing layout; figures
+%^^A% printed in \texttt{plain} style; text boxes use miscellaneous
+%^^A% ruled style;
% \item[frsample10.tex] одноколонная вёрстка; рисунки оформлены
-% в стиле \texttt{plain}; боксы текста
-% (\texttt{textbox}) используют необычный стиль с линейками;
-% \item[frsample11.tex] одноколонная вёрстка с элементами
+% в~стиле \texttt{plain}; боксы текста
+% (\texttt{textbox}) используют необычный стиль с~линейками;
+%^^A% \item[frsample11.tex] one-column non-facing layout with elements
+%^^A% hanged on left margin (e.g. wide floats, in starred environments,
+%^^A% like \env{figure*});
+% \item[frsample11.tex] одноколонная вёрстка с~элементами
% выхода на левое поле (например, широкие
-% флоты в |*|-окружениях, как \env{figure*});
-% \item[frsample12.tex] двухколонная вёрстка с попытками
+% флоты в~«звёздных» окружениях, как \env{figure*});
+%^^A% \item[frsample12.tex] two-column layout with attempts of
+%^^A% colored float styles.
+% \item[frsample12.tex] двухколонная вёрстка с~попытками
% использования расцвеченных стилей флотов.
% \end{Options}
%
-% \section{Устаревшие команды}\label{sec:changed}
+%^^A% There is also added [temporary] sample file \file{sample-longtable.tex}
+%^^A% with \emph{beta-temp} package-patch for \env{longtable}
+%^^A% with defined commands |\endlasthead| and |\endprelastfoot| which
+%^^A% defines captions for continued and last pages of long table in three
+%^^A% possible ways.
+% Также добавлен файл-пример \file{sample-longtable.tex}
+% использующий \emph{beta-temp} пакет \package{fr-longtable}, где
+% определены команды |\endlasthead| и~|\endprelastfoot|, где даны три
+% варианта определения подписей (табличных заголовков) для продолжающейся
+% и~последней страниц \texttt{longtable}.
+%\vfil
+%
+%^^A% \subsection{Obsolete Commands}\label{sec:changed}
+% \subsection{Устаревшие команды}\label{sec:changed}
+%
+% \begin{small}
+%
+% \subsubsection{Интерфейс пользователя \protect\cdash--- новые плавающие объекты
+% [\package{float}]}\label{sec:floatborrowI}
+%
+% \DescribeMacro{\newfloat}
+%^^A% The most important command in \package{float}
+%^^A% is the |\newfloat| command\footnote{It doubles the
+%^^A% \cmd{\DeclareNewFloatType} command.}. It is patterned on
+%^^A% |\newtheorem|. The |\newfloat| command takes three required and
+%^^A% one optional argument; it is of the form
+% Самой важной командой в~пакете \package{float}
+% является команда |\newfloat|\footnote{Она дублируется командой
+% \cmd{\DeclareNewFloatType}.}.
+% Она сделана по образцу
+% |\newtheorem|. Команда |\newfloat| имеет три основных и~один дополнительный
+% аргумент; форма задания:
+% \par\RestoreSpaces
+% \begin{Quote}
+% \hspace*{\MacroIndent}|\newfloat{|\meta{type}|}{|^^A
+% \meta{placement}|}{|\meta{ext}|}[|\meta{within}{\tt]}
+% \end{Quote}
+% \begin{itemize}\itemsep0pt\parskip0pt
+% \item
+%^^A% \marg{type} is the `type' of the new class of floats, like
+%^^A% \texttt{program} or \texttt{algorithm}. After the appropriate
+%^^A% |\newfloat|, commands like |\begin{program}| or |\end{algorithm*}|
+%^^A% will be available.
+% \marg{type} задаёт тип нового класса флотов, таких как
+% \texttt{program} (программа) или \texttt{algorithm} (алгоритм).
+% Определив эти слова в~аргументе
+% |\newfloat|, вы можете задать команды, как |\begin{program}|
+% или |\end{algorithm*}|.
+% \item
+%^^A% \marg{placement} gives the default placement
+%^^A% parameters for this class of floats. The placement parameters are
+%^^A% the same as in standard \LaTeX, i.e., \texttt{t}, \texttt{b},
+%^^A% \texttt{p} and \texttt{h} for `top', `bottom', `page' and `here',
+%^^A% respectively.
+% \marg{placement} задаёт размещение по умолчанию
+% для данного класса флотов. Параметры те же самые,
+% что и~в~стандартном \LaTeX'е, например, \texttt{t}, \texttt{b},
+% \texttt{p} и~\texttt{h} для `top' (вверху), `bottom' (внизу),
+% `page' (отдельная страницы) и~`here' (здесь),
+% соответственно.
+% \item
+%^^A% \marg{ext} When \LaTeX\ writes the captions to an auxiliary file
+%^^A% for the list of figures (or whatever), it'll use the job name
+%^^A% followed by \marg{ext} as a file name.
+% \marg{ext}. Когда \LaTeX\ записывает подписи во вспомогательный файл
+% для списка рисунков (или любого другого флота), он использует
+% имя рабочего файла (документа)
+% с~расширением \marg{ext} как имя файла.
+% \item
+%^^A% \oarg{within} Finally, the optional
+%^^A% argument \meta{within} determines whether floats of this class will
+%^^A% be numbered within some sectional unit of the document. For example,
+%^^A% if \oarg{within}${}={}$\texttt{chapter}, the floats will be numbered
+%^^A% within chapters. (In standard \LaTeX, this happens with figures and
+%^^A% tables in the \cls{report} and \cls{book} document styles.) As an
+%^^A% example, Program~\ref{prog1.1} was created by a command sequence
+%^^A% similar to that shown in the following
+%^^A% Example\footnote{Settings for Example float
+%^^A% environment were created by \cmd{\DeclareNewFloatType} macro stuff.}.
+% \oarg{within}. Наконец, дополнительный
+% аргумент \meta{within} определяет будут ли плавающие объекты
+% данного класса нумероваться
+% внутри указанного раздела документа. Например,
+% если \oarg{within}${}={}$\texttt{chapter}, флоты будут перенумеровываться
+% по главам. (В~стандартном \LaTeX'е, это задано для рисунков и~таблиц
+% в~классах документов \cls{report} и~\cls{book}.) Как
+% пример, программа~\ref{prog1.1} была создана командной последовательностью
+% похожей на продемонстрированную в~следующем
+% примере\footnote{Настройки для этого окружения примера
+% были созданы командой \cmd{\DeclareNewFloatType}.}.
+% \end{itemize}
+%^^A% \emph{Floatrow note.}
+%^^A% There is also created a |\newfloat*| pair, which works similar to
+%^^A% |\restylefloat*| command (see below).
+% \emph{Замечание \textsf{floatrow}.}
+% Также создана команда-пара |\newfloat*|, которая работает аналогично команде
+% |\restylefloat*| (см.~ниже).
+% \begin{Example}[H]
+% \begin{verse}
+% |\floatstyle{ruled}|\\
+% |\newfloat{Program}{tbp}{lop}[section]|\\
+% \dots\ loads o' stuff \dots\\
+% |\begin{Program}|\\
+% |\begin{verbatim}|\\
+% \dots\ program text \dots\\
+% |\end{verbatim}|\\
+% |\caption{|\dots\ caption \dots|}|\\
+% |\end{Program}|
+% \end{verse}
+% \caption{Это ещё один простенький плавающий пример. Исключая
+% то, что он плавает, так как использует параметр {\tt[H]}, чтобы
+% появиться \textbf{Здесь}.}\label{exa1.1}
+% \end{Example}
+% \begin{Program}
+%\begin{verbatim}
+%#include <stdio.h>
+%
+%int main(int argc, char **argv) {
+% int i;
+% for (i = 0; i < argc; ++i)
+% printf("argv[%d] = %s\n", i, argv[i]);
+% return 0;
+%}
+%\end{verbatim}
+% \caption{Первая программа. Она ничего не делает в~пакете,
+% просто включена в~него как пример.
+% Обратите внимание на стиль \texttt{ruled}%
+% \label{prog1.1}}
+% \end{Program}
+%
+% \DescribeMacro{\floatstyle}
+%^^A% The |\floatstyle| command sets a default
+%^^A% float style. This float style will be used for all the floats that
+%^^A% are subsequently defined using |\newfloat|, until another
+%^^A% |\floatstyle| command appears. The |\floatstyle| command takes one
+%^^A% argument, the name of a float style. For instance,
+%^^A% |\floatstyle{ruled}|. Specifying a string that does not name a valid
+%^^A% float style is an error.
+% Команда |\floatstyle| определяет стиль флота по
+% умолчанию. Этот стиль будет использоваться для всех типов флотов
+% которые впоследствии будут определены в~команде |\newfloat|, до появления другой
+% команды |\floatstyle|. Команда |\floatstyle| имеет один аргумент,
+% имя стиля флота. Например,
+% |\floatstyle{ruled}|. Указание названия несуществующего стиля приведёт к~ошибке.
+%
+% \DescribeMacro{\floatname}
+%^^A% The |\floatname| command lets you define
+%^^A% the \emph{float name} that \LaTeX\ uses in the caption of a float,
+%^^A% i.e., `Figure' for a figure and so on. For example,
+%^^A% |\floatname{program}{Program}|. The |\newfloat| command sets the
+%^^A% float name to its argument \meta{type} if no other name has been
+%^^A% specified before.
+% Команда |\floatname| позволяет вам определить
+% \emph{имя флота}, которое \LaTeX\ использует в~подписи флота,
+% например, `Figure' для окружения рисунков и~тому подобное. Например,
+% |\floatname{program}{Program}| (или |\floatname|\nobreak
+% |{Program}|\allowbreak
+% |{\CYRP\cyrr\cyro\cyrg\cyrr\cyra\cyrm\cyrm\cyra}|).\allowbreak{}
+% Команда |\newfloat| определяет
+% имя флота по аргументу определяющему имя окружения (\meta{type}) если не было
+% определено другого имени до этого.
+%
+% \DescribeMacro{\floatplacement}
+%^^A% The |\floatplacement| command resets
+%^^A% the default placement specifier of a class of floats. E.g.,
+%^^A% |\floatplacement{figure}{tp}|.
+% Команда |\floatplacement| переопределяет
+% размещения флота по умолчанию для данного класса флотов. Например,
+% |\floatplacement{figure}{tp}|.
+%
+% \DescribeMacro{\restylefloat}\nopagebreak
+%^^A% The |\restylefloat| command is necessary
+%^^A% to change styles for the standard float types
+%^^A% \texttt{figure} and \texttt{table}. Since these aren't usually
+%^^A% defined via |\newfloat|, they don't have a style associated with
+%^^A% them. Thus you have to say, for example,
+% Команда |\restylefloat| необходима для
+% изменения стиля для стандартных типов флотов
+% \texttt{figure} и~\texttt{table}. Так как они не определяются
+% через команду |\newfloat|, они не имеют стиля, связанного с~ними.
+% Поэтому вы должны задать, например,
+% \par\RestoreSpaces
+% \begin{Quote}
+% \hspace*{\MacroIndent}|\floatstyle{ruled}|\\
+% \hspace*{\MacroIndent}|\restylefloat{table}|
+% \end{Quote}
+%^^A% to have tables come out \texttt{ruled}. The command also lets you
+%^^A% change style for floats that you define via |\newfloat|, although
+%^^A% this is, typographically speaking, not a good idea. See
+%^^A% table~\ref{table1} for an example\footnote{The \package{float} package
+%^^A% created special caption style with bold label for \texttt{boxed}
+%^^A% style. Please note that \texttt{plain} and \texttt{boxed} float
+%^^A% styles have not any special settings in \package{caption} 3.x package.
+%^^A% To emulate \texttt{boxed} style from \package{float} documentation there
+%^^A% were: cleared all special caption settings for tables, and restored
+%^^A% default colon separator after label.}. There is a |\restylefloat*|
+%^^A% command which will restyle an existing float type but will keep the
+%^^A% new float style from taking over the |\caption| command. In this
+%^^A% case the user is responsible for handling their own captions.
+% чтобы получить таблицы в~стиле \texttt{ruled}. Команда также позволяет
+% изменить стиль флота, определённого командой |\newfloat|, хотя
+% это, по типографским правилам, не лучшая идея. См.
+% табл.~\ref{table1} для примера\footnote{В~пакете \package{float}
+% создан специальный стиль подписи с~полужирным нумерационным заголовком
+% для стиля \texttt{boxed}.
+% Обратите внимание, что стили флота \texttt{plain} и~\texttt{boxed}
+% не имеют специальных настроек в~пакете \package{caption} 3.x.
+% Для эмуляции стиля \texttt{boxed} из документации пакета \package{float} были:
+% отменены все специальные установки для таблиц, и~восстановлено двоеточие
+% как разделитель после нумерационного заголовка.}. Существует
+% команда |\restylefloat*|,
+% которая переопределяет стиль флота, но не затрагивает стиля подписи.
+% В~этом случае пользователь сам отвечает за создание оформления подписей.
+% \DeleteShortVerb{\|}
+% %^^AEmulation of float's documentation settings
+% %^^A\floatstyle{boxed}
+% %^^A\restylefloat{table}
+% \begingroup
+% \clearcaptionsetup{table}
+% \captionsetup{labelsep=default,labelfont=bf}
+% \floatsetup[table]{style=boxed}
+% \begin{table}[h] \def\B#1{$\displaystyle{n\choose#1}$}
+% \begin{center} \begin{tabular}{c|cccccccc}
+% $n$&\B0&\B1&\B2&\B3&\B4&\B5&\B6&\B7\\ \hline
+% 0 & 1\\
+% 1 & 1&1\\
+% 2 & 1&2&1\\
+% 3 & 1&3&3&1\\
+% 4 & 1&4&6&4&1\\
+% 5 & 1&5&10&10&5&1\\
+% 6 & 1&6&15&20&15&6&1\\
+% 7 & 1&7&21&35&35&21&7&1
+% \end{tabular} \end{center}
+% \caption{Треугольник Паскаля. Это переоформленное окружение
+% \LaTeX'а \texttt{table}.%^^A
+% \label{table1}}
+% \end{table}
+% \endgroup
+% \MakeShortVerb{\|}
+%
+% \end{small}
%
+%^^A% |\floatsetup|, renamed or deleted after version 0.1b.
+%\RestoreSpaces
+% \begingroup\extrarowheight1.75pt\small\openup-.5pt\tabcolsep.5\tabcolsep\LTpre=0ptplus3pt\LTpost\LTpre
+% \subsubsection{Команды и~ключи \cmd{\floatsetup},
+% удалённые после версии 0.1b}
% Здесь приведены устаревшие макрокоманды, которые были заменены
% ключами из команды |\floatsetup|,
% переименованы или удалены после версии 0.1b.
%
-% \begingroup\extrarowheight1.75pt\small\tabcolsep.5\tabcolsep
-% \medskip\parindent0pt
-% \begin{tabular*}\hsize{@{\extracolsep{-.3ptplus1fill}}|
+% \parindent0pt
+% \begin{longtable}{@{\extracolsep{-.3ptplus1fill}}|
% >{\rightskip0ptplus1fil}p{.35\hsize}|
% >{\rightskip0ptplus1fil}p{.6\hsize}|}
% \multicolumn{2}{c}{Удалённые или заменённые команды}
@@ -3689,10 +6691,10 @@
% \\\hline
% \cmd{\floatfootskip} & команда, а не величина
% \\\hline
-% \end{tabular*}
+% \end{longtable}
%
% \vskip1pt
-% \begin{tabular*}\hsize{@{\extracolsep{-.3ptplus1fill}}|
+% \begin{longtable}{@{\extracolsep{-.3ptplus1fill}}|
% >{\rightskip0ptplus1fil}p{.35\hsize}|
% >{\rightskip0ptplus1fil}p{.6\hsize}|}
% \multicolumn{2}{c}{Команды, заменённые на ключи}
@@ -3763,11 +6765,10 @@
% \texttt{midcode=} (а также
% \texttt{rowpercode} и \texttt{rowpostcode}) ключи
% \\\hline
-% \end{tabular*}
+% \end{longtable}
%
% \vskip1pt
-%
-% \begin{tabular*}\hsize{@{\extracolsep{-.3ptplus1fill}}|
+% \begin{longtable}{@{\extracolsep{-.3ptplus1fill}}|
% >{\rightskip0ptplus1fil}p{.35\hsize}|
% >{\rightskip0ptplus1fil}p{.6\hsize}|}
% \multicolumn{2}{c}{Переименованные ключи}
@@ -3776,6 +6777,7 @@
% &
% \thead{Заменён на}
% \\\hline
+% \endhead
% \texttt{attachedcapstyle=} & \texttt{relatedcapstyle=}
% \\\hline
% \texttt{floatstyle=} & \texttt{style=}
@@ -3807,15 +6809,15 @@
% \end{tabular} &
% \extrarowheight0pt\begin{tabular}[t]{@{}l@{}}
% \vphantom{(}опции ключей \texttt{objectset=}
-% и \texttt{margins=}\\\quad
+% и~\texttt{margins=}\\\quad
% (для унификации
-% с аналогичными опциями\\\quad ключей в пакете
-% \pkg{caption})\\
+% с~аналогичными опциями\\\quad ключей в~пакете
+% \package{caption})\\
% \texttt{raggedright},\\ \texttt{raggedleft},\\
% \texttt{centering}
% \end{tabular}
% \\\hline
-% \end{tabular*}
+% \end{longtable}
% \endgroup
% \MakeShortVerb{\|}%
%