Companion for creating selection config instances that can be passed to Laika configuration and builders that produce configuration of all possible combinations of @:select directives.
See the documentation for the @:select
directive in the manual for the full context of this feature.
Attributes
- Companion
- class
- Source
- Selections.scala
- Graph
-
- Supertypes
- Self type
-
Selections.type
Members list
Type members
Classlikes
Attributes
- Source
- Selections.scala
- Supertypes
Inherited types
The names of the product elements
The name of the type
Value members
Concrete methods
Groups configuration for one or more @:select directives in an instance that can be passed to Laika configuration.
Groups configuration for one or more @:select directives in an instance that can be passed to Laika configuration.
Example for Laika's own manual, which allows the user to chose between seeing configuration examples for sbt or for the library API:
laikaConfig := LaikaConfig.defaults
.withConfigValue(Selections(
SelectionConfig("config",
ChoiceConfig("sbt", "sbt Plugin"),
ChoiceConfig("library", "Library API")
).withSeparateEbooks
))
See the documentation for the @:select
directive in the manual for the full context of this feature.
Attributes
- Source
- Selections.scala
Creates all valid combinations of choices for the given configuration instance.
Creates all valid combinations of choices for the given configuration instance. The returned chain contains tuples that contain both, the modified document tree that can be passed to EPUB or PDF renderers to produce a specific version of the document tree only containing one set of selections and the classifiers that can be appended to the artifact name for distinction.
Concretely this means that you pass in a single document tree obtained from a parser that might contain one or more @:select
directives for alternate content the user can choose from, and get back several new document trees where in each of them all but one of the choices have been removed from every @:select
directive. This is useful for e-book rendering where it is not desirable or possible to show the alternative content in interactive tabs. It is therefore used for EPUB and PDF rendering, but not for site generation.
This is a rather low-level method that you'd only need to use if you want to replicate the functionality that Laika's sbt plugin offers around producing different variants of the same documentation, based on the use of @:select
directives in text markup.
See the documentation for the @:select
directive in the manual in this case for the full context of this feature.
Attributes
- Source
- Selections.scala
Creates all valid combinations of choices for the given configuration instance.
Creates all valid combinations of choices for the given configuration instance.
This is a rather low-level method that you'd only need to use if you want to replicate the functionality that Laika's sbt plugin offers around producing different variants of the same documentation, based on the use of @:select
directives in text markup.
See the documentation for the @:select
directive in the manual in this case for the full context of this feature.
In contrast to the createCombinations
method this one is mostly useful for features like generating a download page for all e-book artifacts produced by the renderer as it also contains the label information.
Attributes
- Source
- Selections.scala
Concrete fields
Attributes
- Source
- Selections.scala
Implicits
Implicits
Attributes
- Source
- Selections.scala
Attributes
- Source
- Selections.scala
Attributes
- Source
- Selections.scala