Files
ProcessControl/_quarto.yml
T

144 lines
4.5 KiB
YAML

project:
type: book
# One source, three books. The language (lang:, output dir, title, abstract,
# chapter list, language menu) lives in _quarto-en.yml / _quarto-fr.yml /
# _quarto-de.yml:
# _book/ English (default profile, what the VS Code preview renders)
# _book/fr/ French
# _book/de/ German
# English sits at the top so the preview, which serves only _book/, can reach
# the other two. Build all three with ./render-all.sh -- a full English render
# (plain `quarto render`) empties _book/ and so removes fr/ and de/.
#
# English is the verified source here: the material these notes are built from
# (SIN.04028-From-Calling-to-Eventing/README.md) is written in English.
profile:
default: en
group:
- [en, fr, de]
metadata-files:
- i18n.yml
book:
title: "Process Control"
author:
- name: "Romain De Groote"
email: "romain@de-groote.ch"
abstract: "One small program, rebuilt step by step from direct method calls to an Event-Driven Architecture over MQTT: what moves at each step, and who ends up knowing whom."
date: last-modified
date-format: "D MMMM YYYY"
search: true
reader-mode: true
page-navigation: true
# chapters: lives in _quarto-{en,fr,de}.yml -- a part or appendix title is a
# plain string in metadata, which no filter can translate, so the list is
# written once per language. A new chapter has to be added to all three.
sidebar:
style: docked
collapse-level: 1
downloads: [pdf]
# @sec- references render as "Section 5.7" / "Chapter 6".
crossref:
chapters: true
format:
html:
# a figure is written as figures/<name>-@tr{langcode}, with no extension,
# so each format picks the file it can use: the svg here, the pdf below.
default-image-extension: svg
# Light first: Quarto stores the reader's pick as "default"/"alternate",
# so the order has to be the same in every book. The ◐ high-contrast
# button appears next to the toggle by itself (notes extension).
theme:
light: [cosmo, theme.scss]
dark: [darkly, theme.scss]
# github-dark drops comments to 2.4:1 on darkly's ground; a11y ships a
# light and a dark variant that both clear AA, and Quarto swaps them with
# the toggle.
highlight-style: a11y
include-in-header:
# language menu + remembered language (in the head: redirects before drawing)
- _i18n-switcher.html
include-after-body:
# animates a message through the mailboxes of a diagram (html only).
# A no-op on a page that holds no .flow-figure div.
- figures/flow-player.html
toc: true
toc-depth: 3
number-sections: true
number-depth: 2
code-copy: true
code-overflow: scroll
link-external-newwindow: true
smooth-scroll: true
anchor-sections: true
grid:
sidebar-width: 310px
body-width: 900px
margin-width: 240px
pdf:
default-image-extension: pdf
pdf-engine: lualatex
documentclass: scrreprt
classoption:
- 11pt
- DIV=11
- BCOR=6mm
- numbers=noenddot
- open=any
papersize: a4
geometry:
- top=2.3cm
- bottom=2.3cm
- inner=2.5cm
- outer=2.1cm
# DejaVu Sans Mono is required: the ASCII diagrams in these notes
# use box-drawing glyphs and arrows that Latin Modern Mono does not have.
# On Arch: pacman -S ttf-dejavu
mainfont: "Latin Modern Roman"
sansfont: "Latin Modern Sans"
monofont: "DejaVu Sans Mono"
monofontoptions:
- Scale=0.82
include-in-header: preamble.tex
toc: true
toc-depth: 2
number-sections: true
number-depth: 2
colorlinks: true
# colour *names*, defined in preamble.tex: a bare hex string reaches
# xcolor as an undefined colour and the pdf build fails.
linkcolor: "notes-link"
urlcolor: "notes-url"
citecolor: "notes-url"
fig-pos: "H"
keep-tex: false
highlight-style: github
# lang: is set per profile. The fr/de profiles also set babeloptions so their
# PDFs build from babel's bundled .ini language data (no extra TeX packages).
execute:
echo: false
warning: false
freeze: false
filters:
- notes
# study field: the colour of this book's badge on the index (see _extensions/notes/README.md)
field: cs
# The book's accent: the teal this book has drawn with from the start. Night
# mode keeps the hue and lifts the lightness by itself (theme.css), so there is
# no notecolor-dark here. Everything else draws with the extension's tokens.
notecolor: "#20666f"
# where a metadata-defined glossary entry lives, so a usage can link to it
glossary-page: glossary.html