Sourcerer

Sourcerer is a Typst package for displaying stylized source code blocks, with some extra features. Main features include:

• Rendering source code with numbering
• Rendering only a range of lines from the source code, keeping the original highlighting of the code (For example, block comments are still rendered well, even if cut)
• Adding in-code line labels which are easily referenceable (via reference)
• Considerable customization options for the display of the code block
• Consistent and pretty cutoff between pages
• Displaying the language used for a code block in a readable manner, in-code-block

Usage

First, import the package via:

#import "@preview/sourcerer:0.2.1": code

Then, display custom code blocks via the code function, like so:

#code(
  lang: "Typst",
  ```typ
  Woah, that's pretty #smallcaps(cool)!
  That's neat too.

)

This results in:

<p align="center">
  <img src="https://github.com/miestrode/sourcerer/raw/main/assets/sourcerer.png" width="750"/>
</p>

To view all of the options of the `code` function, consult the [documentation](DOCS.md).