struct

Config::SiteConfig

Inherits YAML::Serializable < Struct < Value < Object

Global configuration from conf.yml (NOT translatable)

Constructors

new(ctx : YAML::ParseContext, node : YAML::Nodes::Node)
Source
new(*, __context_for_yaml_serializable ctx : YAML::ParseContext, __node_for_yaml_serializable node : YAML::Nodes::Node)
Source

Instance methods

after_initialize

Normalize url_prefix to a bare path segment ("blog" for "/blog/" or "/blog"): consumers join it with explicit slashes, and a leading one would produce "//blog/..." links

Source
archive
Source
archive=(archive : String)
Source
books
Source
books=(books : String)
Source
color_scheme
Source
color_scheme=(color_scheme : String)
Source
content
Source
content=(content : String)
Source
content_fallback=(content_fallback : Bool)

When true (default), content that has no translation for the current language is still rendered using the default-language version, flagged with is_fallback in the template context. When false, untranslated content is simply absent from that language's site.

Source
content_fallback?

When true (default), content that has no translation for the current language is still rendered using the default-language version, flagged with is_fallback in the template context. When false, untranslated content is simply absent from that language's site.

Source
dark_scheme

Optional explicit scheme overrides; empty means derive both variants from color_scheme

Source
dark_scheme=(dark_scheme : String)

Optional explicit scheme overrides; empty means derive both variants from color_scheme

Source
date_output_format
Source
date_output_format=(date_output_format : String)
Source
description
Source
description=(description : String)
Source
features
Source
features=(features : Array(String))
Source
folder_indexes

folder_indexes feature options (see conf.yml's folder_indexes section)

Source
folder_indexes=(folder_indexes : FolderIndexesConfig)

folder_indexes feature options (see conf.yml's folder_indexes section)

Source
fonts
Source
fonts=(fonts : Fonts)
Source
footer=(footer : String)
Source
galleries
Source
galleries=(galleries : String)
Source
image_large
Source
image_large=(image_large : Int32)
Source
image_thumb
Source
image_thumb=(image_thumb : Int32)
Source
import

Import configuration (hash of feed name to config)

Source
import=(import : Hash(String, YAML::Any))

Import configuration (hash of feed name to config)

Source
import_templates
Source
import_templates=(import_templates : String)
Source
language
Source
language=(language : String)
Source
light_scheme
Source
light_scheme=(light_scheme : String)
Source
listings
Source
listings=(listings : String)
Source
locale
Source
locale=(locale : String)
Source
nav_items=(nav_items : NavItems)
Source
output

NOT translatable

Source
output=(output : String)

NOT translatable

Source
pandoc_formats
Source
pandoc_formats=(pandoc_formats : Hash(String, String))
Source
posts
Source
posts=(posts : String)
Source
pretty_html=(pretty_html : Bool)

When true (default), every page goes through a lexbor parse/serialize round trip that normalizes its HTML formatting. When false, pages that need no link or code-class fixing are written as the raw template output (faster, same DOM).

Source
pretty_html?

When true (default), every page goes through a lexbor parse/serialize round trip that normalizes its HTML formatting. When false, pages that need no link or code-class fixing are written as the raw template output (faster, same DOM).

Source
syntax_highlighter

Server-side syntax highlighter for markdown code blocks: "tartrazine" (default) or "none" (leaves language-* classes for client-side highlighting)

Source
syntax_highlighter=(syntax_highlighter : String)

Server-side syntax highlighter for markdown code blocks: "tartrazine" (default) or "none" (leaves language-* classes for client-side highlighting)

Source
syntax_theme

Explicit tartrazine theme name for code blocks (e.g. "monokai"). When unset, dark and light syntax themes are derived from the site's base16 color_scheme

Source
syntax_theme=(syntax_theme : String)

Explicit tartrazine theme name for code blocks (e.g. "monokai"). When unset, dark and light syntax themes are derived from the site's base16 color_scheme

Source
taxonomies

Taxonomies and features

Source
taxonomies=(taxonomies : Taxonomies)

Taxonomies and features

Source
theme
Source
theme=(theme : String)
Source
theme_params

Overrides for the active theme's theme.yml parameters (exposed to templates as the theme variable)

Source
theme_params=(theme_params : Hash(String, YAML::Any))

Overrides for the active theme's theme.yml parameters (exposed to templates as the theme variable)

Source
title

Translatable properties (also in LangConfig, but read into LangConfig)

Source
title=(title : String)

Translatable properties (also in LangConfig, but read into LangConfig)

Source
url=(url : String)
Source
url_prefix

URL prefix prepended to all generated links. When the site is served under a subpath (e.g. /blog/), set this to that prefix so the relativizer computes correct relative paths. Leave empty (default) for root-mounted sites.

Source
url_prefix=(url_prefix : String)

URL prefix prepended to all generated links. When the site is served under a subpath (e.g. /blog/), set this to that prefix so the relativizer computes correct relative paths. Leave empty (default) for root-mounted sites.

Source
verbosity
Source
verbosity=(verbosity : Int32)
Source