# $Id: pdf-theme-UserManual.yaml 105564 2024-08-01 12:18:48Z vboxsync $

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:
        # TODO: Could we get an SVG logo? Or at least a higher resolution one (this is 512x512, I think).
        background-image:   en_US/images/vboxlogo.png
        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