144 lines
4.5 KiB
YAML
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
|