285 lines
8.8 KiB
YAML
285 lines
8.8 KiB
YAML
# $Id: pdf-theme-UserManual.yaml $
|
|
|
|
brand:
|
|
color:
|
|
primary: '#1a3355'
|
|
secondary: '#6d767e'
|
|
tertiary: '#b9c7d0'
|
|
inverse: '#e5ebeb'
|
|
links: '#4169e1'
|
|
note:
|
|
background:
|
|
attention: '#fff3ce'
|
|
caution: '#f8d8db'
|
|
info: '#dbe5f1'
|
|
tip: '#d0e8de'
|
|
|
|
pdf2:
|
|
font:
|
|
sans: 'Noto Sans'
|
|
serif: 'Noto Serif'
|
|
monospaced: 'DejaVu Sans Mono'
|
|
# ^^^ - Important to have proper unicode monospace font so we can use non-breaking hyphen (U+2011)
|
|
# in syntax diagrams.
|
|
#
|
|
# If the PDF contains any use of font "Helvetica" then it might be that the topic nesting is too deep.
|
|
# Maximum nesting is 4 (not sure what limits it), but all config for h5 is ignored.
|
|
|
|
page:
|
|
size: PA4
|
|
mirror-margins: true
|
|
|
|
header:
|
|
color: $brand-color-secondary
|
|
display-align: before
|
|
end-indent: 10mm
|
|
font-family: $pdf2-font-sans
|
|
padding-after: 6pt
|
|
padding-before: 12pt
|
|
start-indent: 10mm
|
|
odd:
|
|
content: '{chapter}'
|
|
text-align: end
|
|
even:
|
|
content: '{title}'
|
|
text-align: start
|
|
|
|
footer:
|
|
color: $brand-color-secondary
|
|
end-indent: 10mm
|
|
font-family: $pdf2-font-sans
|
|
padding-after: 12pt
|
|
padding-before: 6pt
|
|
start-indent: 10mm
|
|
odd:
|
|
content: '{folio}'
|
|
font-weight: bold
|
|
text-align: end
|
|
even:
|
|
content: '{folio}'
|
|
font-weight: bold
|
|
text-align: start
|
|
|
|
style:
|
|
body:
|
|
font-family: $pdf2-font-serif
|
|
font-size: 11pt
|
|
line-height: 1.3
|
|
start-indent: 48pt
|
|
|
|
cmdname:
|
|
color: $brand-color-primary
|
|
font-family: $pdf2-font-monospaced
|
|
font-weight: bold
|
|
|
|
codeblock:
|
|
background-color: $brand-color-inverse
|
|
border: solid 1pt $brand-color-tertiary
|
|
font-family: $pdf2-font-monospaced
|
|
font-size: 8pt
|
|
keep-together.within-page: always
|
|
space-after: 8pt
|
|
|
|
codeph:
|
|
color: $brand-color-secondary
|
|
font-family: $pdf2-font-monospaced
|
|
font-size: '0.9 * from-parent(font-size)'
|
|
|
|
cover:
|
|
background-image: en_US/images/vboxlogo.svg
|
|
background-repeat: no-repeat
|
|
background-position-horizontal: center
|
|
|
|
cover-title:
|
|
color: $brand-color-primary
|
|
font-family: $pdf2-font-sans
|
|
font-size: 48pt
|
|
font-weight: bold
|
|
line-height: 1.3
|
|
space-before: 165mm
|
|
|
|
example-title:
|
|
color: $brand-color-secondary
|
|
|
|
fig:
|
|
caption:
|
|
color: $brand-color-secondary
|
|
font-family: $pdf2-font-sans
|
|
font-size: 9pt
|
|
font-style: italic
|
|
font-weight: normal
|
|
|
|
filepath:
|
|
color: $brand-color-secondary
|
|
font-family: $pdf2-font-monospaced
|
|
|
|
h1:
|
|
border-after: solid 2pt $brand-color-inverse
|
|
color: $brand-color-primary
|
|
font-family: $pdf2-font-sans
|
|
font-size: 18pt
|
|
font-weight: bold
|
|
space-before: 0pt
|
|
padding-top: 0pt
|
|
space-after: 9pt
|
|
title-numbering: true
|
|
|
|
h2:
|
|
border-after: solid 1pt $brand-color-inverse
|
|
color: $brand-color-primary
|
|
font-family: $pdf2-font-sans
|
|
font-size: 16pt
|
|
font-style: italic
|
|
space-before: 16pt
|
|
space-after: 8pt
|
|
title-numbering: true
|
|
|
|
h3:
|
|
color: $brand-color-primary
|
|
font-family: $pdf2-font-sans
|
|
font-size: 14pt
|
|
font-weight: bold
|
|
space-before: 21pt
|
|
space-after: 7pt
|
|
title-numbering: true
|
|
|
|
h4:
|
|
color: $brand-color-primary
|
|
font-family: $pdf2-font-sans
|
|
font-size: 12pt
|
|
font-weight: bold
|
|
font-style: italic
|
|
space-before: 15pt
|
|
start-indent: 'from-parent(start-indent)'
|
|
title-numbering: true
|
|
|
|
link:
|
|
color: $brand-color-links
|
|
font-style: italic
|
|
|
|
note:
|
|
background-color: $brand-color-note-background-info
|
|
border: solid 1pt $brand-color-tertiary
|
|
keep-together.within-page: always
|
|
label:
|
|
font-family: $pdf2-font-sans
|
|
space-end: 2pt
|
|
padding-start: 6pt
|
|
start-indent: '6pt + from-parent(start-indent)'
|
|
padding-end: 6pt
|
|
end-indent: '6pt + from-parent(end-indent)'
|
|
space-before: 6pt
|
|
space-after: 12pt
|
|
attention:
|
|
background-color: $brand-color-note-background-attention
|
|
caution:
|
|
background-color: $brand-color-note-background-caution
|
|
important:
|
|
background-color: $brand-color-note-background-attention
|
|
notice:
|
|
background-color: $brand-color-note-background-attention
|
|
restriction:
|
|
background-color: $brand-color-note-background-attention
|
|
tip:
|
|
background-color: $brand-color-note-background-tip
|
|
warning:
|
|
background-color: $brand-color-note-background-caution
|
|
|
|
section-title:
|
|
color: $brand-color-secondary
|
|
font-family: $pdf2-font-sans
|
|
|
|
shortdesc:
|
|
color: $brand-color-secondary
|
|
line-height: 1.3
|
|
|
|
table:
|
|
caption:
|
|
color: $brand-color-secondary
|
|
font-family: $pdf2-font-sans
|
|
font-size: 9pt
|
|
font-style: italic
|
|
font-weight: normal
|
|
font-family: $pdf2-font-sans
|
|
font-size: 9pt
|
|
header:
|
|
background-color: $brand-color-inverse
|
|
font-family: $pdf2-font-monospaced # Hack for arrow glyphs
|
|
|
|
toc-1:
|
|
color: $brand-color-primary
|
|
font-family: $pdf2-font-sans
|
|
space-before: 6pt
|
|
start-indent: 0pt
|
|
|
|
toc-2:
|
|
color: black
|
|
space-before: 4pt
|
|
start-indent: 12pt
|
|
|
|
toc-3:
|
|
color: black
|
|
space-before: 2pt
|
|
start-indent: 32pt
|
|
|
|
toc-4:
|
|
color: black
|
|
space-before: 2pt
|
|
start-indent: 48pt
|
|
|
|
varname:
|
|
color: $brand-color-secondary
|
|
font-family: $pdf2-font-monospaced
|
|
font-style: italic
|
|
|
|
|
|
#
|
|
# The following properties requires an pdf-generator git newer than February 2023,
|
|
# or version 0.6.2+ (unreleased).
|
|
#
|
|
|
|
# We need to specify the font for each of these elements, so we get a consistent
|
|
# monospace font capable of doing non-breaking hyphen glyps. The default "Courier"
|
|
# does not do the job, at least not on Windows.
|
|
delim:
|
|
font-family: $pdf2-font-monospaced
|
|
groupchoice:
|
|
font-family: $pdf2-font-monospaced
|
|
groupcomp:
|
|
font-family: $pdf2-font-monospaced
|
|
groupseq:
|
|
font-family: $pdf2-font-monospaced
|
|
kwd:
|
|
font-family: $pdf2-font-monospaced
|
|
oper:
|
|
font-family: $pdf2-font-monospaced
|
|
repsep:
|
|
font-family: $pdf2-font-monospaced
|
|
sep:
|
|
font-family: $pdf2-font-monospaced
|
|
syntaxdiagram:
|
|
font-family: $pdf2-font-monospaced
|
|
font-size: 10pt # Needed for long unbreakable synopsis bits
|
|
start-indent: '1cm + from-parent(start-indent)'
|
|
text-indent: -1cm
|
|
keep-together.within-page: always
|
|
var:
|
|
font-family: $pdf2-font-monospaced
|
|
pre:
|
|
font-family: $pdf2-font-monospaced
|
|
font-size: 9pt # Needed for 80 column
|
|
userinput:
|
|
font-family: $pdf2-font-monospaced
|
|
font-size: 10pt # More line length without annoying line breaks
|
|
screen:
|
|
font-family: $pdf2-font-monospaced
|
|
font-size: 10pt # More line length without annoying line breaks
|
|
systemoutput:
|
|
font-family: $pdf2-font-monospaced
|
|
font-size: 10pt # More line length without annoying line breaks
|
|
|
|
|
|
# Prevent a parameter and it's definition from ending up on different pages.
|
|
plentry:
|
|
keep-together.within-page: always
|
|
|