sile-typesetter / sile / 9304049654

local getLineMetrics = function (l)

   end

         end

         end)

         end

         end

         end

      end

   end

end

local linespacingLeading = function (_, vbox, previous)

      else

      end

   end

   end

   end

   end

   -- For these methods, we need to read the font metrics

   end

      -- Distance to next baseline is max(descender) of fonts on previous +

      -- max(ascender) of fonts on next

   end

      end

   end

end

   end)

end

      parameter = "linespacing.method",

      default = "tex",

      type = "string",

      help = "How to set the line spacing (tex, fixed, fit-font, fit-glyph, css)",

   })

      parameter = "linespacing.fixed.baselinedistance",

      type = "length",

      help = "Distance from baseline to baseline in the case of fixed line spacing",

   })

      parameter = "linespacing.minimumfirstlineposition",

      type = "length",

   })

      parameter = "linespacing.fit-glyph.extra-space",

      type = "length",

   })

      parameter = "linespacing.fit-font.extra-space",

      type = "length",

   })

      parameter = "linespacing.css.line-height",

      type = "length",

   })

end

   end)

   end)

end

package.documentation = [[

\begin{document}

\linespacing-on

SILE’s default method of inserting leading between lines should be familiar to users of TeX, but it is not the most friendly system for book designers.

The \autodoc:package{linespacing} package provides a better choice of leading systems.

After loading the package, you are able to choose the linespacing mode by setting the \autodoc:setting{linespacing.method} parameter.

The following examples have funny sized words in them so that you can see how the different methods interact.

By default, this is set to \code{tex}. The other options available are:

\medskip

\set[parameter=linespacing.method,value=fixed]

\set[parameter=linespacing.fixed.baselinedistance,value=1.5em]

\begin{itemize}

\item{\code{fixed}. This set the lines at a fixed baseline-to-baseline distance, determined by the \autodoc:setting{linespacing.fixed.baselinedistance} parameter.

You can specify this parameter either relative to the type size (\code{1.2em}) or as a absolute distance (\code{15pt}).

This paragraph is set with a fixed 1.5em baseline-to-baseline distance.}

\end{itemize}

\medskip

\set[parameter=linespacing.method,value=fit-glyph]

\begin{itemize}

\item{\code{fit-glyph}. This sets the lines solid; that is, the lowest point on line 1 (either a descender like \font[size=20pt]{q} or, if there are no descenders, the baseline) will touch the \font[size=20pt]{highest} point of line 2, as in this paragraph.

You generally don’t want to use this as-is.}

\end{itemize}

\set[parameter=linespacing.fit-glyph.extra-space,value=5pt]

What you probably want to do is insert a constant (relative or absolute) s\font[size=20pt]{p}ace between the lines by setting the \autodoc:setting{linespacing.fit-glyph.extra-space} parameter.

\font[size=20pt]{T}his paragraph is set with 5 points of space between the descenders and the ascenders.

\medskip

\set[parameter=linespacing.method,value=fit-font]

\begin{itemize}

\item{\code{fit-font}. This inspects each \code{hbox} on the line, and asks the fonts it finds for their bounding boxes—the highest ascender and the lower descender.

It then sets the lines solid.

Essentially each character is treated as if it is the same height, rather like composing a slug of metal type.

If there are things other than text on your line, or the text is buried inside other boxes, this may not work well.}

\end{itemize}

\set[parameter=linespacing.fit-font.extra-space,value=5pt]

As with \code{fit-glyph}, you can insert extra space between the lines with the \autodoc:setting{linespacing.fit-font.extra-space} parameter.

\medskip

\set[parameter=linespacing.method,value=css]

\set[parameter=linespacing.css.line-height,value=2em]

\begin{itemize}

\item{\code{css}. This is similar to the method used in browsers; the baseline distance is set with the \autodoc:setting{linespacing.css.line-height} parameter, and the excess \font[size=20pt]{space} between this parameter and the actual height of the line is distributed between the top and bottom of the line.}

\end{itemize}

\medskip

\linespacing-off

\end{document}