Type Members

1.  case class AutonumberConfig(documents: Boolean = true, sections: Boolean = true, maxDepth: Int = Int.MaxValue) extends Product with Serializable

   Configuration for autonumbering of documents and sections.

2.  case class BasicPathTranslator(outputSuffix: String) extends PathTranslator with Product with Serializable

   Basic path translator implementation that only replaces the suffix of the path.

   Basic path translator implementation that only replaces the suffix of the path.

   Used in scenarios where only a single document gets rendered and there is no use case for cross references or static or versioned documents.

3.  case class ChoiceConfig(name: String, label: String, selected: Boolean = false) extends Product with Serializable

   Configuration for a single choice within a selection.

   Configuration for a single choice within a selection.

   name

   the name of the selection as used in text markup, e.g. @:choice(name).

   label

   the label to be used on tabs or on download pages describing this choice

   selected

   indicates whether this choice is one of the selected choices in the current render operation

4.  case class Classifiers(value: Seq[String]) extends Product with Serializable
5.  case class ConfigurablePathTranslator(config: TranslatorConfig, outputSuffix: String, outputFormat: String, refPath: Path, targetLookup: (Path) ⇒ Option[TranslatorSpec]) extends PathTranslator with Product with Serializable

   Translates paths of input documents to the corresponding output path, based on a configuration instance.

6.  case class ConfigurationException(msg: String) extends RuntimeException with Product with Serializable
7.  case class CoverImage(path: Path, classifier: Option[String] = None) extends Product with Serializable

   Configuration for a cover image for e-books (EPUB or PDF).

   Configuration for a cover image for e-books (EPUB or PDF).

   The optional classifier can be used if the @:select directive is used to produce multiple e-books with slightly different content. The classifier would refer to the name of the configured choice, or in case of multiple choices, to the combination of their names concatenated with -.

8.  case class CoverImages(default: Option[Path], classified: Map[String, Path]) extends Product with Serializable
9.  trait PathTranslator extends AnyRef

   Translates paths of input documents to the corresponding output path.

   Translates paths of input documents to the corresponding output path. The minimum translation that usually has to happen is to replace the suffix from the input document the path has been obtained from to the suffix of the output format. Further translations are allowed to happen based on user configuration.

10.  sealed trait Scope extends AnyRef
11.  case class SelectionConfig(name: String, choices: NonEmptyChain[ChoiceConfig], separateEbooks: Boolean = false) extends Product with Serializable

    Configuration for a single kind of selection and its choices available for the user.

    Configuration for a single kind of selection and its choices available for the user.

    name

    the name of the selection as used in text markup, e.g. @:select(name).

    choices

    the configuration for one or more choices that are available in each of the directives

    separateEbooks

    whether the selection should render all its choices in the same output or produce separate e-books where in each of them only one of the choice is displayed. This way separate e-books for Scala vs. Java code samples or sbt vs. Maven build examples can be produced. Keep in mind that multiple selections having this property set to true would result in the cartesian product of available e-book versions, it is therefore unusual to have more than one or two.

12.  case class Selections(selections: Seq[SelectionConfig]) extends Product with Serializable

    Groups configuration for multiple @:select directives.

    Groups configuration for multiple @:select directives.

    The @:select directive is a special directive that allows to create alternative versions of the same documentation, for example one with Scala code examples and one with Java. Or as in the case of Laika's own documentation, one showing configuration setup with sbt and the other through the library API.

    When using the default Helium theme these alternatives will be rendered as tabs in the website.

    While for EPUB and PDF output it triggers the generation of separate books for each of the alternatives and offers them on the download page to cater for the fact that tabs do not work well on paper.

13.  sealed trait TargetFormats extends AnyRef

    Describes the supported target (output) formats of a resource.