File indexing completed on 2024-11-24 04:34:44

0001 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
0002 <html>
0003 <!-- This document is an unofficial reference manual for LaTeX, a
0004 document preparation system, version of November 2018.
0005 
0006 This manual was originally translated from LATEX.HLP v1.0a in the
0007 VMS Help Library.  The pre-translation version was written by
0008 George D. Greenwade of Sam Houston State University.  The
0009 LaTeX 2.09 version was written by Stephen Gilmore.  The
0010 LaTeX2e version was adapted from this by Torsten Martinsen.  Karl
0011 Berry made further updates and additions, and gratefully acknowledges
0012 using Hypertext Help with LaTeX, by Sheldon Green, and
0013 LaTeX Command Summary (for LaTeX 2.09) by
0014 L. Botway and C. Biemesderfer (published by the TeX Users
0015 Group as TeXniques number 10), as reference material.  We also
0016 gratefully acknowledge additional material appearing in
0017 latex2e-reference by Martin Herbert Dietze.  (From these references no
0018 text was directly copied.)
0019 
0020 Copyright 2007, 2008, 2009, 2010, 2011, 2012, 2013,
0021 2014, 2015, 2016, 2017, 2018 Karl Berry.
0022 
0023 Copyright 1988, 1994, 2007 Stephen Gilmore.
0024 
0025 Copyright 1994, 1995, 1996 Torsten Martinsen.
0026 
0027 Permission is granted to make and distribute verbatim copies of
0028 this manual provided the copyright notice and this permission notice
0029 are preserved on all copies.
0030 
0031 
0032 Permission is granted to copy and distribute modified versions of this
0033 manual under the conditions for verbatim copying, provided that the entire
0034 resulting derived work is distributed under the terms of a permission
0035 notice identical to this one.
0036 
0037 Permission is granted to copy and distribute translations of this manual
0038 into another language, under the above conditions for modified versions. -->
0039 <!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
0040 <head>
0041 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
0042 <title>minipage (LaTeX2e unofficial reference manual (November 2018))</title>
0043 
0044 <meta name="description" content="minipage (LaTeX2e unofficial reference manual (November 2018))">
0045 <meta name="keywords" content="minipage (LaTeX2e unofficial reference manual (November 2018))">
0046 <meta name="resource-type" content="document">
0047 <meta name="distribution" content="global">
0048 <meta name="Generator" content="makeinfo">
0049 <link href="index.html#Top" rel="start" title="Top">
0050 <link href="IndexDocument.html#Index" rel="index" title="Index">
0051 <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
0052 <link href="Environments.html#Environments" rel="up" title="Environments">
0053 <link href="picture.html#picture" rel="next" title="picture">
0054 <link href="math.html#math" rel="prev" title="math">
0055 <style type="text/css">
0056 <!--
0057 /* $Id: latex2e.css 690 2018-09-15 15:20:19Z jimhefferon $
0058    Minor css for latexrefman. Public domain.
0059    Originally written by Jim Hefferon and Karl Berry, 2018. */
0060 
0061 /* So you can style for yourself */
0062 @import url("/css/latexreflocal.css");
0063 
0064 
0065 
0066 a.summary-letter {text-decoration: none}
0067 blockquote.indentedblock {margin-right: 0em}
0068 blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
0069 blockquote.smallquotation {font-size: smaller}
0070 div.display {margin-left: 3.2em}
0071 div.example {margin-left: 3.2em}
0072 div.lisp {margin-left: 3.2em}
0073 div.smalldisplay {margin-left: 3.2em}
0074 div.smallexample {margin-left: 3.2em}
0075 div.smalllisp {margin-left: 3.2em}
0076 kbd {font-style: oblique}
0077 pre.display {font-family: inherit}
0078 pre.format {font-family: inherit}
0079 pre.menu-comment {font-family: serif}
0080 pre.menu-preformatted {font-family: serif}
0081 pre.smalldisplay {font-family: inherit; font-size: smaller}
0082 pre.smallexample {font-size: smaller}
0083 pre.smallformat {font-family: inherit; font-size: smaller}
0084 pre.smalllisp {font-size: smaller}
0085 span.nolinebreak {white-space: nowrap}
0086 span.roman {font-family: initial; font-weight: normal}
0087 span.sansserif {font-family: sans-serif; font-weight: normal}
0088 ul.no-bullet {list-style: none}
0089 BODY {
0090   margin-top: 1em;
0091   margin-left: 1em; /* auto results in two-digit <ol> lost off left */
0092   margin-right: 1em;
0093   margin-bottom: 1em;
0094   /* the idea is to use the whole window, unless it is ridiculously
0095      wide, probably with too-small fonts, too.  */
0096   max-width: 64em;
0097 }
0098 
0099 /* Because we want @math{... @code ...} to be upright, not slanted,
0100    and Texinfo won't fix it. */
0101 code {font-style:normal; font-family:monospace; }
0102 
0103 /* We put a link to our own home page at the bottom. */
0104 div.referenceinfo {font-size:small;}
0105 
0106 -->
0107 </style>
0108 
0109 
0110 </head>
0111 
0112 <body lang="en">
0113 <a name="minipage"></a>
0114 <div class="header">
0115 <p>
0116 Next: <a href="picture.html#picture" accesskey="n" rel="next">picture</a>, Previous: <a href="math.html#math" accesskey="p" rel="prev">math</a>, Up: <a href="Environments.html#Environments" accesskey="u" rel="up">Environments</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="IndexDocument.html#Index" title="Index" rel="index">Index</a>]</p>
0117 </div>
0118 <hr>
0119 <a name="minipage-1"></a>
0120 <h3 class="section">8.18 <code>minipage</code></h3>
0121 
0122 <a name="index-environment_002c-minipage"></a>
0123 <a name="index-minipage-environment"></a>
0124         
0125 <a name="index-minipage_002c-creating-a"></a>
0126 
0127 <p>Synopses:
0128 </p>
0129 <div class="example">
0130 <pre class="example">\begin{minipage}{<var>width</var>}
0131   <var>contents</var>
0132 \end{minipage}
0133 </pre></div>
0134 
0135 <p>or
0136 </p>
0137 <div class="example">
0138 <pre class="example">\begin{minipage}[<var>position</var>][<var>height</var>][<var>inner-pos</var>]{<var>width</var>}
0139   <var>contents</var>
0140 \end{minipage}
0141 </pre></div>
0142 
0143 <p>Put <var>contents</var> into a box that is <var>width</var> wide.  This is like a
0144 small version of a page; it can contain its own footnotes, itemized
0145 lists, etc. (There are some restrictions, including that it cannot have
0146 floats.)  This box will not be broken across pages.  So <code>minipage</code>
0147 is similar to <code>\parbox</code> (see <a href="_005cparbox.html#g_t_005cparbox">\parbox</a>) but here you can have
0148 paragraphs.
0149 </p>
0150 <p>This example will be 3&nbsp;inches wide, and has two paragraphs.
0151 </p>
0152 <div class="example">
0153 <pre class="example">\begin{minipage}{3in}
0154   Stephen Kleene was a founder of the Theory of Computation.
0155 
0156   He was a student of Church, wrote three influential texts,
0157   was President of the Association for Symbolic Logic,
0158   and won the National Medal of Science.
0159 \end{minipage}
0160 </pre></div>
0161 
0162 <p>See below for a discussion of the paragraph indent inside a
0163 <code>minipage</code>.
0164 </p>
0165 <p>The required argument <var>width</var> is a rigid length (see <a href="Lengths.html#Lengths">Lengths</a>).
0166 It gives the width of the box into which <var>contents</var> are typeset.
0167 </p>
0168 <p>There are three optional arguments, <var>position</var>, <var>height</var>, and
0169 <var>inner-pos</var>.  You need not include all three. For example, get the
0170 default <var>position</var> and set the <var>height</var> with
0171 <code>\begin{minipage}[c][2.54cm] <var>contents</var> \end{minipage}</code>.
0172 (Get the natural height with an empty argument, <code>[]</code>.)
0173 </p>
0174 <p>The optional argument <var>position</var> governs how the <code>minipage</code>
0175 vertically aligns with the surrounding material.
0176 </p>
0177 <dl compact="compact">
0178 <dt><code>c</code></dt>
0179 <dd><p>(synonym <code>m</code>) Default.  Positions the <code>minipage</code> so its
0180 vertical center lines up with the center of the adjacent text line (what
0181 Plain TeX calls <code>\vcenter</code>).
0182 </p>
0183 </dd>
0184 <dt><code>t</code></dt>
0185 <dd><p>Match the top line in the <code>minipage</code> with the baseline of the
0186 surrounding text (Plain TeX&rsquo;s <code>\vtop</code>.
0187 </p>
0188 </dd>
0189 <dt><code>b</code></dt>
0190 <dd><p>Match the bottom line in the <code>minipage</code> with the baseline of the
0191 surrounding text (Plain TeX&rsquo;s <code>\vbox</code>.
0192 </p></dd>
0193 </dl>
0194 
0195 <p>To see the effects of these, contrast running this
0196 </p>
0197 <div class="example">
0198 <pre class="example">---\begin{minipage}[c]{0.25in}
0199   first\\ second\\ third
0200 \end{minipage}
0201 </pre></div>
0202 
0203 <p>with the results of changing <code>c</code> to <code>b</code> or&nbsp;<code>t</code>.
0204 </p>
0205 <p>The optional argument <var>height</var> is a rigid length (see <a href="Lengths.html#Lengths">Lengths</a>).
0206 It sets the height of the <code>minipage</code>.  You can enter any value
0207 larger than, or equal to, or smaller than the <code>minipage</code>&rsquo;s natural
0208 height and LaTeX will not give an error or warning.  You can also set
0209 it to a height of zero or a negative value.
0210 </p>
0211 <p>The final optional argument <var>inner-pos</var> controls the placement of
0212 <var>content</var> inside the box. These are the possible values are (the
0213 default is the value of <var>position</var>).
0214 </p>
0215 <dl compact="compact">
0216 <dt><code>t</code></dt>
0217 <dd><p>Place <var>content</var> at the top of the box.
0218 </p>
0219 </dd>
0220 <dt><code>c</code></dt>
0221 <dd><p>Place it in the vertical center.
0222 </p>
0223 </dd>
0224 <dt><code>b</code></dt>
0225 <dd><p>Place it at the box bottom.
0226 </p>
0227 </dd>
0228 <dt><code>s</code></dt>
0229 <dd><p>Stretch <var>contents</var> out vertically; it must contain vertically
0230 stretchable space.
0231 </p>
0232 </dd>
0233 </dl>
0234 
0235 <p>The <var>inner-pos</var> argument makes sense when the <var>height</var> option
0236 is set to a value larger than the <code>minipage</code>&rsquo;s natural height.  To
0237 see the effect of the options, run this example with the various choices
0238 in place of <code>b</code>.
0239 </p>
0240 <div class="example">
0241 <pre class="example">Text before
0242 \begin{center}
0243   ---\begin{minipage}[c][3in][b]{0.25\textwidth}
0244        first\\ second\\ third
0245   \end{minipage}              
0246 \end{center}
0247 Text after  
0248 </pre></div>
0249 
0250 <a name="index-indentation-of-paragraphs_002c-in-minipage"></a>
0251 <a name="index-paragraph-indentation_002c-in-minipage"></a>
0252 <a name="index-_005cparindent"></a>
0253 <p>By default paragraphs are not indented in a <code>minipage</code>.  Change
0254 that with a command such as <code>\setlength{\parindent}{1pc}</code> at
0255 the start of <var>contents</var>.
0256 </p>
0257 <a name="index-footnotes-in-figures"></a>
0258 <a name="index-figures_002c-footnotes-in"></a>
0259 <p>Footnotes in a <code>minipage</code> environment are handled in a way that is
0260 particularly useful for putting footnotes in figures or tables.  A
0261 <code>\footnote</code> or <code>\footnotetext</code> command puts the footnote at
0262 the bottom of the minipage instead of at the bottom of the page, and it
0263 uses the <code>\mpfootnote</code> counter instead of the ordinary
0264 <code>footnote</code> counter (see <a href="Counters.html#Counters">Counters</a>).
0265 </p>
0266 <p>This puts the footnote at the bottom of the table, not the bottom of the
0267 page.
0268 </p>
0269 <div class="example">
0270 <pre class="example">\begin{center}           % center the minipage on the line
0271 \begin{minipage}{2.5in}
0272   \begin{center}         % center the table inside the minipage
0273     \begin{tabular}{ll}
0274       \textsc{Monarch}  &amp;\textsc{Reign}             \\ \hline
0275       Elizabeth II      &amp;63 years\footnote{to date} \\
0276       Victoria          &amp;63 years                   \\
0277       George III        &amp;59 years
0278     \end{tabular}
0279   \end{center}  
0280 \end{minipage}
0281 \end{center}
0282 </pre></div>
0283 
0284 <p>If you nest minipages then there is an oddness when using footnotes.
0285 Footnotes appear at the bottom of the text ended by the next
0286 <code>\end{minipage}</code> which may not be their logical place.
0287 </p>
0288 <p>This puts a table containing data side by side with a map graphic.  They
0289 are vertically centered.
0290 </p>
0291 <div class="example">
0292 <pre class="example">\newcommand*{\vcenteredhbox}[1]{\begin{tabular}{@{}c@{}}#1\end{tabular}}
0293   ...
0294 \begin{center}
0295   \vcenteredhbox{\includegraphics[width=0.3\textwidth]{nyc.png}}
0296   \hspace{0.1\textwidth}
0297   \begin{minipage}{0.5\textwidth}
0298     \begin{tabular}{r|l}
0299       \multicolumn{1}{r}{Borough} &amp;Pop (million)  \\ \hline
0300       The Bronx      &amp;$1.5$  \\
0301       Brooklyn       &amp;$2.6$  \\
0302       Manhattan      &amp;$1.6$  \\
0303       Queens         &amp;$2.3$  \\
0304       Staten Island  &amp;$0.5$  
0305     \end{tabular}
0306   \end{minipage}              
0307 \end{center}
0308 </pre></div>
0309 
0310 
0311 
0312 
0313 <hr/><div class='referenceinfo'> <a href='https://latexref.xyz/'> <i>Unofficial LaTeX2e reference manual</i></a></div>
0314 </body>
0315 </html>