book.toml

[book]
authors = ["Steven Johnson (steven.johnson@iohk.io)"]
language = "en"
multilingual = false
src = "book/src"
title = "Catalyst Voting System - Core Technology"

[build]
build-dir = "book/html" # This is where github wants it so we can publish as gh-pages.
create-missing = false # DO NOT create missing files.

[preprocessor.fs-summary]
# (default: true)
clean-paths = false

[preprocessor.regex]
patterns = "./book/templates/patterns.json"
after = ["fs-summary"] # Because ALL other preprocessors run AFTER regex, no need to specify in all.
before = [ # Make sure regex pre-processing happens before any other pre-processing.
    "kroki-preprocessor",
    "admonish",
    "open-on-gh",
    "template"
]

[preprocessor.template]

[preprocessor.kroki-preprocessor]
endpoint = "http://kroki:8000"

[preprocessor.admonish]
command = "mdbook-admonish"
assets_version = "2.0.0" # do not edit: managed by `mdbook-admonish install`
on_failure = "bail"
before = [
    "kroki-preprocessor" # Ensure we can put diagrams inside admonish blocks.
]


[preprocessor.open-on-gh]
command = "mdbook-open-on-gh"
renderer = ["html"]

# BROKEN DISABLE UNTIL FIXED
#[preprocessor.theme]
# enable pagetoc (toc on the right)
#pagetoc                   = true

# some variables related (defined in theme/css/variables.css)
# `content-max-width` + `pagetoc-width` = 95% seems the best
#pagetoc-width            = "13%"
#content-max-width        = "82%"
#pagetoc-fontsize         = "14.5px"
#sidebar-width            = "450px"
#menu-bar-height          = "40px"   # memu-bar = the bar on the top
#page-padding             = "15px"
#mobile-content-max-width = "98%"

# layout
#content-padding           = "0 10px"
#content-main-margin-left  = "2%"
#content-main-margin-right = "2%"
#nav-chapters-max-width    = "auto"
#nav-chapters-min-width    = "auto"
#chapter-line-height       = "2em"
#section-line-height       = "1.5em"

# modify some fontsizes
#root-font-size    = "70%"    # control the main font-size
#body-font-size    = "1.5rem"
#code-font-size    = "0.9em"
#sidebar-font-size = "1em"    # sidebar = toc on the left

# modify some colors under ayu/coal/light/navy/rust theme
#coal-inline-code-color  = "#ffb454"
#light-inline-code-color = "#F42C4C"
#navy-inline-code-color  = "#ffb454"
#rust-inline-code-color  = "#F42C4C"
#light-links             = "#1f1fff"
#rust-links              = "#1f1fff"

# if true, never read and touch the files in theme dir
#turn-off = false

[output.html]
theme          = "book/assets/theme"
additional-css = [
    "./book/assets/css/mdbook-admonish.css",
    "./book/assets/css/open-in.css",
#    "./book/assets/theme/pagetoc.css",
]
copy_fonts=false

additional-js = [
#    "./book/assets/theme/pagetoc.js"
]

# Required: Your repository URL used in the link.
git-repository-url = "https://github.com/input-output-hk/catalyst-core"

# Your git branch. Defaults to `main`
git-branch = "main"

# The text to use in the footer.
# The link text is marked by `[]`
open-on-text = "Found a bug? [Edit this page on GitHub.]"


[output.html.search]
enable = true            # enables the search feature
limit-results = 30       # maximum number of search results
teaser-word-count = 30   # number of words used for a search result teaser
use-boolean-and = true   # multiple search terms must all match
boost-title = 2          # ranking boost factor for matches in headers
boost-hierarchy = 1      # ranking boost factor for matches in page names
boost-paragraph = 1      # ranking boost factor for matches in text
expand = true            # partial words will match longer terms
heading-split-level = 3  # link results to heading levels
copy-js = true           # include Javascript code for search

[output.html.fold]
enable = true    # whether or not to enable section folding
level = 0        # the depth to start folding

#[output.linkcheck]
# Should we check links on the internet? Enabling this option adds a
# non-negligible performance impact
#follow-web-links = true

# Are we allowed to link to files outside of the book's root directory? This
# may help prevent linking to sensitive files (e.g. "../../../../etc/shadow")
#traverse-parent-directories = false

# If necessary, you can exclude one or more links from being checked with a
# list of regular expressions. The regex will be applied to the link href (i.e.
# the `./index.html` in `[some page](./index.html)`) so it can be used to
# ignore both web and filesystem links.
#
# Hint: you can use TOML's raw strings (single quote) to avoid needing to
# escape things twice.
# exclude = [ 'google\.com' ]

# The User-Agent to use when sending web requests
#user-agent = "mdbook-linkcheck-0.7.7"

# The number of seconds a cached result is valid for (12 hrs by default)
#cache-timeout = 43200

# How should warnings be treated?
#
# - "warn" will emit warning messages
# - "error" treats all warnings as errors, failing the linkcheck
# - "ignore" will ignore warnings, suppressing diagnostic messages and allowing
#   the linkcheck to continuing
# We do NOT allow broken links in CI, but only warn in development.
# DO NOT EDIT THIS SETTING OR YOu WILL BREAK CI.
#warning-policy = "warn"

# Extra HTTP headers that must be send to certain web sites
# in order to link check to succeed.
#
# This is a dictionary (map), with keys being regexes
# matching a set of web sites, and values being an array of
# the headers.
#[output.linkcheck.http-headers]
# Any hyperlink that contains this regexp will be sent
# the "Accept: text/html" header
#'crates\.io' = ["Accept: text/html"]

# mdbook-linkcheck will interpolate environment variables into your header via
# $IDENT.
#
# If this is not what you want you must escape the `$` symbol, like `\$TOKEN`.
# `\` itself can also be escaped via `\\`.
#
# Note: If interpolation fails, the header will be skipped and the failure will
# be logged. This can be useful if a particular header isn't always necessary,
# but may be helpful (e.g. when working with rate limiting).
#'website\.com' = ["Authorization: Basic $TOKEN"]