pdf

laika.helium.Helium.pdf$
object pdf

Selects the configuration options available for PDF generation.

Attributes

Graph
Supertypes
class Object
trait Matchable
class Any
Self type
pdf.type

Members list

Value members

Inherited methods

protected def copyWith(pdfSettings: PDFSettings): Helium

Attributes

Inherited from:
CopyOps (hidden)
protected def copyWith(epubSettings: EPUBSettings): Helium

Attributes

Inherited from:
CopyOps (hidden)
protected def copyWith(siteSettings: SiteSettings): Helium

Attributes

Inherited from:
CopyOps (hidden)
def coverImages(images: CoverImage*): Helium

Specifies one or more cover images for the PDF document.

Specifies one or more cover images for the PDF document.

Multiple cover images are only relevant when the @:select directive is used to generate different versions of the same e-book which can all have their own cover image. See the documentation for the @:select directive in the chapter "Standard Directives" in the manual for details.

Attributes

Inherited from:
PDFOps (hidden)
protected def currentColors: ColorSet

Attributes

Inherited from:
PDFOps (hidden)
protected def currentMetadata: DocumentMetadata

Attributes

Inherited from:
PDFOps (hidden)
def fontFamilies(body: String, headlines: String, code: String): Helium

Specifies which font family to use for the body text, for headlines and for inline code and code blocks.

Specifies which font family to use for the body text, for headlines and for inline code and code blocks.

All specified fonts need to be made available for the theme first by using the fontResources method. The body font needs to be available at least as regular, italic, bold and bold italic. The headline font needs to support bold and bold italic. For the code font a regular font weight is sufficient.

Attributes

Inherited from:
SingleConfigOps (hidden)

Adds one or more font resources to the theme, either based on a local classpath or file system resource, or a web font URL, or both.

Adds one or more font resources to the theme, either based on a local classpath or file system resource, or a web font URL, or both.

E-book formats like EPUB or PDF require a local font file to be available for embedding. A web font URL can only be used for website generation.

When using this method, all default fonts of the Helium theme will be de-registered.

Attributes

Inherited from:
PDFOps (hidden)
def fontSizes(body: Length, code: Length, title: Length, header2: Length, header3: Length, header4: Length, small: Length): Helium

Configure the theme's font sizes. Most property names are self-explanatory, the small font is currently only used for footnote references in PDF output.

Configure the theme's font sizes. Most property names are self-explanatory, the small font is currently only used for footnote references in PDF output.

Attributes

Inherited from:
SingleConfigOps (hidden)
def layout(pageWidth: Length, pageHeight: Length, marginTop: Length, marginRight: Length, marginBottom: Length, marginLeft: Length, defaultBlockSpacing: Length, defaultLineHeight: Double, keepTogetherDecoratedLines: Int): Helium

Allows to override the defaults for Helium's PDF layout.

Allows to override the defaults for Helium's PDF layout.

You can use the constructors found in the LengthUnit companion to create length values, e.g. LengthUnit.px(12). It's usually most convenient to import laika.ast.LengthUnit._ for your configuration code.

Most arguments should be self-explanatory. The keepTogetherDecoratedLines value controls the number of lines for decorated blocks like code examples or callouts that should always be kept on the same page. With a setting of 12 for example only blocks with more than 12 lines are allowed to be split across multiple pages. If you choose very high numbers for this setting you might see pages with a lot of blank space when it has to move a large block to the next page.

Attributes

Inherited from:
PDFOps (hidden)
def messageColors(info: Color, infoLight: Color, warning: Color, warningLight: Color, error: Color, errorLight: Color): Helium

Attributes

Inherited from:
ColorOps (hidden)
def metadata(title: Option[String], description: Option[String], identifier: Option[String], authors: Seq[String], language: Option[String], datePublished: Option[OffsetDateTime], dateModified: Option[OffsetDateTime], version: Option[String]): Helium

Allows to define a small set of metadata that describes the output.

Allows to define a small set of metadata that describes the output.

In the generated site it will be used to populate the <head> section of the HTML output, for EPUB and PDF it will be used to embed the information into the generated files in a way that the respective readers understand.

When using the sbt plugin the title, description and version metadata will be pre-populated by the standard sbt settings name, description and version respectively. When using the library API no medata will be defined by default. It is recommended to always define the language and title as the minimum set of metadata.

Value parameters

authors

one or more author names

dateModified

the modification date as a UTC date-time

datePublished

the publication date as a UTC date-time

description

a short description of the site and/or e-book

identifier

a unique identifier for the e-book, not used for site generation

language

the language of the site and/or e-book, should always be defined

title

the title of the site and/or e-book

version

the version string for the output

Attributes

Inherited from:
SingleConfigOps (hidden)

Attributes

Inherited from:
ColorOps (hidden)
def tableOfContent(title: String, depth: Int): Helium

Adds a dedicated page for a table of content, in addition to the reader-native navigation structure.

Adds a dedicated page for a table of content, in addition to the reader-native navigation structure.

Value parameters

depth

the navigation depth which may be different than the one for the reader-native navigation structure

title

the title to display on the page and in navigation that links to the page

Attributes

Inherited from:
PDFOps (hidden)
def themeColors(primary: Color, primaryMedium: Color, primaryLight: Color, secondary: Color, text: Color, background: Color, bgGradient: (Color, Color)): Helium

Attributes

Inherited from:
ColorOps (hidden)
protected def withColors(colors: ColorSet): Helium

Attributes

Inherited from:
PDFOps (hidden)
protected def withFontFamilies(fonts: ThemeFonts): Helium

Attributes

Inherited from:
PDFOps (hidden)
protected def withFontSizes(sizes: FontSizes): Helium

Attributes

Inherited from:
PDFOps (hidden)
protected def withMetadata(metadata: DocumentMetadata): Helium

Attributes

Inherited from:
PDFOps (hidden)