Kotlindoc

Creates a page for each Class and Package in your project, displaying the expected KDoc information of methods, fields, etc. but in your site's theme.

Default Config
# config.yml
...
kotlindoc:
  sourceDirs: [../../main/kotlin]
or
# config/kotlindoc.yml
sourceDirs: [../../main/kotlin]
Key Type Default Value Description
sourceDirs List<String> [../../main/kotlin]
Key Type Default Value Description
allData Map<String, Object> {}

All options passed to this object.

layout String empty string

Set the default layout to be used for all Pages from this Generator. Pages can specify their own layouts, which take precedence over the Generator layout.

parallel boolean false

Improve site generation performance dramatically by rendering the pages from this Generator in parallel. There are currently thread-safety issues that may cause deadlocks, especially when in serve mode when build cycles may be executed multiple times. As such this feature should be considered highly experimental and used with caution.

theme Object null

Set a theme to be used only when rendering pages from this Generator. This can be a String to use that theme's default options set in config.yml, or an object with a key property to use those specific options for the theme.

Key Type Description
allGenerators Site Config

Configure this item with additional options merged in from config.yml, from the object at the archetype key. Dots in the key indicate sub-objects within the site config.

Orchid Kotlindoc Invoker Impl

No options
No options
No archetypes

Kotlindoc Classes

All Kotlindoc class pages.

Key Type Default Value Description
title String All Classes
Key Type Default Value Description
allData Map<String, Object> {}

All options passed to this object.

asSubmenu boolean false

Set all the menu items from this as a dropdown, instead of including them directly at the root.

order int 0

By default, menu items are rendered in the order in which they are declared, but the ordering can be changed by setting the order on any individual menu item. A higher value for order will render that menu item earlier in the list.

submenuTitle String empty string

The title the menu

No archetypes

Kotlindoc Packages

All Kotlindoc package pages.

Key Type Default Value Description
title String All Packages
Key Type Default Value Description
allData Map<String, Object> {}

All options passed to this object.

asSubmenu boolean false

Set all the menu items from this as a dropdown, instead of including them directly at the root.

order int 0

By default, menu items are rendered in the order in which they are declared, but the ordering can be changed by setting the order on any individual menu item. A higher value for order will render that menu item earlier in the list.

submenuTitle String empty string

The title the menu

No archetypes

Kotlindoc Class Sections

Links to the different sections within a Kotlindoc Class page, optionally with their items nested underneath them.

Key Type Default Value Description
includeItems boolean false

Whether to include the items for each category. For example, including a menu item for each individual constructor as children of 'Constructors' or just a link to the Constructors section.

Key Type Default Value Description
allData Map<String, Object> {}

All options passed to this object.

asSubmenu boolean false

Set all the menu items from this as a dropdown, instead of including them directly at the root.

order int 0

By default, menu items are rendered in the order in which they are declared, but the ordering can be changed by setting the order on any individual menu item. A higher value for order will render that menu item earlier in the list.

submenuTitle String empty string

The title the menu

No archetypes

Base Kotlindoc Page

No options
Key Type Default Value Description
allData Map<String, Object> {}

All options passed to this object.

changeFrequency String empty string

A rough estimate of how frequently the content of this page changes, primarily to include in the generated sitemap.xml. One of [always, hourly, daily, weekly, monthly, yearly, never].

components ComponentHolder Empty ComponentHolder

The components that comprise the main content body for this page. The 'intrinsic content' of the page, which is typically the rendered markup of the containing file, is added by default as a component of type pageContent if none are specified. The full pageContent component is rendered within the chosen page template. If a custom list of components is given, you will need to add the pageContent component yourself.

defaultBreadcrumbs String empty string

The default breadcrumbs to display for this page.

description String empty string

Specify a custom description for this page, to include in the meta description tag.

draft boolean false

Set this page as currently being a draft. Drafts will not be included in the rendered site.

expiryDate LocalDateTime now (yyyy-mm-dd HH:MM:SS)

Set when this page expires. Pages with an expiry date in the past are considered a draft. Should be a valid ISO-8601 date or datetime without timezone, such as 2018-01-01 or 2018-01-01T08:15:30.

extraCss String[] empty array

Add extra CSS files to this page only, which will be compiled just like the rest of the site's assets.

extraJs String[] empty array

Add extra Javascript files to every this page only, which will be compiled just like the rest of the site's assets.

lastModifiedDate LocalDateTime now (yyyy-mm-dd HH:MM:SS)

Set when this page was last modified. Should be a valid ISO-8601 date or datetime without timezone, such as 2018-01-01 or 2018-01-01T08:15:30.

layout String empty string

The layout to embed this page in, or 'none' to render the page content without a layout. A page's default layout, if none is specified, is index

menu OrchidMenu Empty OrchidMenu

The secondary only added to this page. It is common for generators to add menu items to their pagesautomcatically, but the menu specified on the page will take precedence over the generator's page.

next PageRelation com.eden.orchid.impl.relations.PageRelation@4ec2eb80
noFollow boolean false

Request that search engines do not follow links from this page by adding a meta tag on in the page's head.

noIndex boolean false

Request that search engines do not index this page by adding a meta tag on in the page's head.

parent PageRelation com.eden.orchid.impl.relations.PageRelation@57cad6a5
previous PageRelation com.eden.orchid.impl.relations.PageRelation@5daf3b9d
publishDate LocalDateTime now (yyyy-mm-dd HH:MM:SS)

Set when this page was published. Pages with a publish date in the future are considered a draft. Should be a valid ISO-8601 date or datetime without timezone, such as 2018-01-01 or 2018-01-01T08:15:30. Note that some generators may choose to set this value based on some external criteria, but the value in front matter should take precedence over the generator's determined publish date.

relativePriority float 0.0

The importance of this page relative to the rest of the pages on your site. Should be a value between 0 and 1.

template String[] empty array

Specify a template or a list of templates to use when rendering this page. The first template that exists will be chosen for this page, otherwise the page's default set of templates will be searched for (which typically is customized by the generator that produces this page).

title String empty string

Specify a custom title for this Page, which takes precedence over the title given by its generator.

Key Type Description
allPages Site Config

Configure this item with additional options merged in from config.yml, from the object at the archetype key. Dots in the key indicate sub-objects within the site config.

kotlindoc.pages Site Config

Configure this item with additional options merged in from config.yml, from the object at the archetype key. Dots in the key indicate sub-objects within the site config.

Kotlin class

Documentation for a Kotlin or Java class.

No options
Key Type Default Value Description
allData Map<String, Object> {}

All options passed to this object.

changeFrequency String empty string

A rough estimate of how frequently the content of this page changes, primarily to include in the generated sitemap.xml. One of [always, hourly, daily, weekly, monthly, yearly, never].

components ComponentHolder Empty ComponentHolder

The components that comprise the main content body for this page. The 'intrinsic content' of the page, which is typically the rendered markup of the containing file, is added by default as a component of type pageContent if none are specified. The full pageContent component is rendered within the chosen page template. If a custom list of components is given, you will need to add the pageContent component yourself.

defaultBreadcrumbs String empty string

The default breadcrumbs to display for this page.

description String empty string

Specify a custom description for this page, to include in the meta description tag.

draft boolean false

Set this page as currently being a draft. Drafts will not be included in the rendered site.

expiryDate LocalDateTime now (yyyy-mm-dd HH:MM:SS)

Set when this page expires. Pages with an expiry date in the past are considered a draft. Should be a valid ISO-8601 date or datetime without timezone, such as 2018-01-01 or 2018-01-01T08:15:30.

extraCss String[] empty array

Add extra CSS files to this page only, which will be compiled just like the rest of the site's assets.

extraJs String[] empty array

Add extra Javascript files to every this page only, which will be compiled just like the rest of the site's assets.

lastModifiedDate LocalDateTime now (yyyy-mm-dd HH:MM:SS)

Set when this page was last modified. Should be a valid ISO-8601 date or datetime without timezone, such as 2018-01-01 or 2018-01-01T08:15:30.

layout String empty string

The layout to embed this page in, or 'none' to render the page content without a layout. A page's default layout, if none is specified, is index

menu OrchidMenu Empty OrchidMenu

The secondary only added to this page. It is common for generators to add menu items to their pagesautomcatically, but the menu specified on the page will take precedence over the generator's page.

next PageRelation com.eden.orchid.impl.relations.PageRelation@5aa686cf
noFollow boolean false

Request that search engines do not follow links from this page by adding a meta tag on in the page's head.

noIndex boolean false

Request that search engines do not index this page by adding a meta tag on in the page's head.

parent PageRelation com.eden.orchid.impl.relations.PageRelation@3a360264
previous PageRelation com.eden.orchid.impl.relations.PageRelation@7e3a9bf
publishDate LocalDateTime now (yyyy-mm-dd HH:MM:SS)

Set when this page was published. Pages with a publish date in the future are considered a draft. Should be a valid ISO-8601 date or datetime without timezone, such as 2018-01-01 or 2018-01-01T08:15:30. Note that some generators may choose to set this value based on some external criteria, but the value in front matter should take precedence over the generator's determined publish date.

relativePriority float 0.0

The importance of this page relative to the rest of the pages on your site. Should be a value between 0 and 1.

template String[] empty array

Specify a template or a list of templates to use when rendering this page. The first template that exists will be chosen for this page, otherwise the page's default set of templates will be searched for (which typically is customized by the generator that produces this page).

title String empty string

Specify a custom title for this Page, which takes precedence over the title given by its generator.

Key Type Description
allPages Site Config

Configure this item with additional options merged in from config.yml, from the object at the archetype key. Dots in the key indicate sub-objects within the site config.

kotlindoc.pages Site Config

Configure this item with additional options merged in from config.yml, from the object at the archetype key. Dots in the key indicate sub-objects within the site config.

kotlindoc.classPages Site Config

Configure this item with additional options merged in from config.yml, from the object at the archetype key. Dots in the key indicate sub-objects within the site config.

Kotlin Package

Documentation for a Kotlin or Java package.

No options
Key Type Default Value Description
allData Map<String, Object> {}

All options passed to this object.

changeFrequency String empty string

A rough estimate of how frequently the content of this page changes, primarily to include in the generated sitemap.xml. One of [always, hourly, daily, weekly, monthly, yearly, never].

components ComponentHolder Empty ComponentHolder

The components that comprise the main content body for this page. The 'intrinsic content' of the page, which is typically the rendered markup of the containing file, is added by default as a component of type pageContent if none are specified. The full pageContent component is rendered within the chosen page template. If a custom list of components is given, you will need to add the pageContent component yourself.

defaultBreadcrumbs String empty string

The default breadcrumbs to display for this page.

description String empty string

Specify a custom description for this page, to include in the meta description tag.

draft boolean false

Set this page as currently being a draft. Drafts will not be included in the rendered site.

expiryDate LocalDateTime now (yyyy-mm-dd HH:MM:SS)

Set when this page expires. Pages with an expiry date in the past are considered a draft. Should be a valid ISO-8601 date or datetime without timezone, such as 2018-01-01 or 2018-01-01T08:15:30.

extraCss String[] empty array

Add extra CSS files to this page only, which will be compiled just like the rest of the site's assets.

extraJs String[] empty array

Add extra Javascript files to every this page only, which will be compiled just like the rest of the site's assets.

lastModifiedDate LocalDateTime now (yyyy-mm-dd HH:MM:SS)

Set when this page was last modified. Should be a valid ISO-8601 date or datetime without timezone, such as 2018-01-01 or 2018-01-01T08:15:30.

layout String empty string

The layout to embed this page in, or 'none' to render the page content without a layout. A page's default layout, if none is specified, is index

menu OrchidMenu Empty OrchidMenu

The secondary only added to this page. It is common for generators to add menu items to their pagesautomcatically, but the menu specified on the page will take precedence over the generator's page.

next PageRelation com.eden.orchid.impl.relations.PageRelation@221f771a
noFollow boolean false

Request that search engines do not follow links from this page by adding a meta tag on in the page's head.

noIndex boolean false

Request that search engines do not index this page by adding a meta tag on in the page's head.

parent PageRelation com.eden.orchid.impl.relations.PageRelation@2b7c81d3
previous PageRelation com.eden.orchid.impl.relations.PageRelation@3f012fa9
publishDate LocalDateTime now (yyyy-mm-dd HH:MM:SS)

Set when this page was published. Pages with a publish date in the future are considered a draft. Should be a valid ISO-8601 date or datetime without timezone, such as 2018-01-01 or 2018-01-01T08:15:30. Note that some generators may choose to set this value based on some external criteria, but the value in front matter should take precedence over the generator's determined publish date.

relativePriority float 0.0

The importance of this page relative to the rest of the pages on your site. Should be a value between 0 and 1.

template String[] empty array

Specify a template or a list of templates to use when rendering this page. The first template that exists will be chosen for this page, otherwise the page's default set of templates will be searched for (which typically is customized by the generator that produces this page).

title String empty string

Specify a custom title for this Page, which takes precedence over the title given by its generator.

Key Type Description
allPages Site Config

Configure this item with additional options merged in from config.yml, from the object at the archetype key. Dots in the key indicate sub-objects within the site config.

kotlindoc.pages Site Config

Configure this item with additional options merged in from config.yml, from the object at the archetype key. Dots in the key indicate sub-objects within the site config.

kotlindoc.packagePages Site Config

Configure this item with additional options merged in from config.yml, from the object at the archetype key. Dots in the key indicate sub-objects within the site config.