typst-report

Typst Research Report

Create full Typst documents that mix fletcher architecture diagrams (via @local/diagrams:0.1.0) with TikZ-rendered SVGs (via #image()). Output is a single PDF with numbered figures, cross-references, and publication-ready typography.

Standard Preamble

Every report begins with this template:

#import "@local/diagrams:0.1.0": *

#set page(
  paper: "a4",
  margin: (x: 25mm, y: 30mm),
)
#set text(font: "New Computer Modern", size: 10pt, lang: "en")
#set heading(numbering: "1.1")
#set figure(supplement: [Fig.])
#set figure.caption(separator: [. ])
#show figure: set block(breakable: false)
#show ref: it => {
  let el = it.element
  if el != none and el.func() == figure { [Fig. #it] } else { it }
}

#show heading.where(level: 1): it => {
  v(1em)
  text(weight: "bold", size: 12pt, it)
  v(0.3em)
}

Title Block

#align(center)[
  #text(size: 14pt, weight: "bold")[Report Title]
  #v(0.3em)
  #text(size: 10pt, fill: gray)[Author · Date · Version]
]
#v(1em)
#line(length: 100%, stroke: 0.5pt + gray)
#v(1em)

Figure Numbering and Cross-References

All figures are numbered automatically. Reference them with @label:

#figure(
  ml-diagram(
    data-in((0,0), [Input]),
    edge("-|>"),
    encoder((1,0), [Encoder]),
  ),
  caption: [CTC pipeline overview. Input poses are encoded before CTC decoding.],
) <fig:pipeline>

As shown in @fig:pipeline, the encoder receives raw pose sequences.

Mixed Diagram Pattern: fletcher + TikZ SVG

The core pattern for combining both diagram types in one report:

// Fletcher diagram (inline — uses @local/diagrams)
#figure(
  ml-diagram(
    data-in((0,0), [Poses\ #dim[(T, 22)]]),
    edge("-|>"),
    encoder((1,0), [BiGRU\ #dim[(T, 256)]]),
    edge("-|>"),
    ctc-head((2,0), [CTC\ #dim[46]]),
    edge("-|>"),
    data-out((3,0), [Phonemes]),
  ),
  caption: [Recognition pipeline (fletcher).],
) <fig:arch>

// TikZ SVG (pre-rendered, import as image)
#figure(
  image("figures/bigru-internals.svg", width: 80%),
  caption: [BiGRU cell internals (TikZ).],
) <fig:bigru>