laika.rewrite
Members list
Type members
Classlikes
Provides the paths for default templates for all formats.
Provides the paths for default templates for all formats.
Attributes
- Graph
- Supertypes
- class Objecttrait Matchableclass Any
- Self type
- DefaultTemplatePath.type
Describes the output for a render operation.
Describes the output for a render operation.
The format selector is used by any configuration elements that allows to restrict the output of documents to certain target formats. It is not always identical to the fileSuffix used for the specific format.
Attributes
- Companion:
- object
- Graph
- Supertypes
- trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass Any
Attributes
- Companion:
- class
- Graph
- Supertypes
- trait Producttrait Mirrorclass Objecttrait Matchableclass Any
- Self type
- OutputContext.type
A resolver for context references in templates or markup documents.
A resolver for context references in templates or markup documents.
Attributes
- Companion:
- object
- Graph
- Supertypes
- trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass Any
Companion for constructing ReferenceResolvers for a particular target Document.
Companion for constructing ReferenceResolvers for a particular target Document.
Attributes
- Companion:
- class
- Graph
- Supertypes
- trait Producttrait Mirrorclass Objecttrait Matchableclass Any
- Self type
- ReferenceResolver.type
Configuration for a single version of the documentation.
Configuration for a single version of the documentation.
Attributes
- canonical
indicates whether this is the canonical version
- displayValue
the description of the version to use in any UI (e.g. version dropdowns)
- fallbackLink
the link target to use when switching to this version from a page that does not exist in this version
- label
an optional label that will be used in the UI (e.g.
Dev
orStable
)- pathSegment
the string to use as a path segments in URLs pointing to this version
- Companion:
- object
- Graph
- Supertypes
- trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass Any
Optional configuration for scanning existing versions that had been generated by a different tool. This setting is optional and serves two purposes:
Optional configuration for scanning existing versions that had been generated by a different tool. This setting is optional and serves two purposes:
-
If older versions of the documentation had been generated by different tools, Laika can use this configuration for indexing the available paths for "smart linking", which is a feature of the Helium version switcher drop down. The result of the scanning operation will be used to populate the file
/laika/versionInfo.json
in the output directory. -
If you are using the preview server (either the
laikaPreview
task in the sbt plugin, or thelaika.preview.ServerBuilder
from the API) and you want to also test the version switcher drop down menu, then Laika needs to know where older versions are located so that it can serve them, too.
The specified root directory is expected to match the structure of versioned documentation as rendered by Laika.
This means that the root directory is expected to have immediate sub-directories with names that correspond
to the pathSegment
property of the configuration for that version.
Attributes
- exclude
paths to be skipped when scanning the output directory for existing versions (e.g. for API docs), interpreted from the root directory of each version.
- rootDirectory
file system path that represents the root of existing versions.
- Companion:
- object
- Graph
- Supertypes
- trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass Any
Attributes
- Companion:
- class
- Graph
- Supertypes
- trait Producttrait Mirrorclass Objecttrait Matchableclass Any
- Self type
- VersionScannerConfig.type
Global configuration for versioned documentation.
Global configuration for versioned documentation.
The order in the Seq
properties will be used for any list views in the UI (e.g. for the version chooser dropdown).
Attributes
- currentVersion
the version that the sources of a transformation produce
- newerVersions
list of newer versions that have previously been rendered (may be empty)
- olderVersions
list of older versions that have previously been rendered (may be empty)
- renderUnversioned
indicates whether unversioned documents should be rendered (setting this to false may be useful when re-rendering older versions)
- scannerConfig
optional configuration for scanning and indexing existing versions, used by the Helium version switcher dropdown and by the preview server.
- Companion:
- object
- Graph
- Supertypes
- trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass Any