Sitdown

Easily draw and style seating charts.

Example

#import "@preview/sitdown:1.0.0": *
#seating-chart(columns: 3, rows: 3, title: "Maths R103",
    [Tom, Katja], [Maja, Peter], [],
    [Uram, Liguo], [Benny, Tatjana], [Kim, John],
    [], [*Teacher*], []
)

Quick overview

• Import via #import "@preview/sitdown:1.0.0".
• Draw simple seating charts with #seating-chart():
  • Set the number of table rows with columns.
  • Use title to set a heading for the chart.
  • Write out tables with contents like in a grid.
  • Comma-separated names are drawn nicely laid out automatically.
• For more complex arrangements, use #free-seating-chart():
  • Place tables from top-left to bottom-right like in a grid.
  • Use htable[name][name] for horizontal tables.
    • Each content parameter takes up one "seat".
  • Use vtable[name][name] for vertically placed tables.
    • Successive names are placed in seats "below" preceding ones.
  • Use empty(num) to skip seats / leave them empty horizontally.
    • empty(2, 3) takes up six total seats: two horizontally in three
      adjacent rows.
  • If a table has less occupants than seats, use the span parameter to
    override the length.
  • Note: Just like with grid, occupied seats are skipped in order.

Example for complex charts

#free-seating-chart(columns: 6, rows: 5, title: "CS 101", font-size: 16pt,
    vtable[Felix][Pathi], htable[Sophie][Tan], empty(2), vtable[Karl][Ruhigül],
    empty(4, 2), vtable[Keno][Tom], vtable[Laila][Maria], htable[Max][Sophie],
    htable[Arne][Kathrin], empty(2), htable(span: 2, text(size: 20pt)[*Teacher*]),
)

Usage

Import

#import "@preview/sitzplan:1.0.0": *

Functionality

The package makes available two key functions. seating-chart() makes it easy
to draw simple seating charts where tables are all in uniform rows in the room.
free-seating-chart() can draw more complex table arrangements with a bit more
effort when defining them.

It's recommended to always define the charts so that the point of view is at
the bottom edge (placing e.g. the teacher in the bottom row).

seating-chart()

Draws a seating chart for simple row layouts that takes up all available space
on the page by default (specify width and/or height to constrain size).

Names are entered as one piece of content per table, separating names with
commas. This means the chart is input like any other grid.

Main function parameters:

• columns (default 3): Number of table columns the seating arrangement has.
• rows (default 4): Number of table rows the seating arrangement has.
• title (default none): Optional title to draw above the chart.
• vertical-rows (default ()): Which rows of the arrangement should have
  names separated vertically instead of horizontally.
  • Specified as an array of row numbers, starting at 1.
  • If not all tables are oriented the same way, use this to easily draw some
    as being oriented straight on from the viewer's perspective.
• vertical-cols (default ()): Same as vertical-rows but for the columns
  of the arrangement.

Styling parameters:

• font (default auto): What font to use in the chart.
  • If not specified, uses the font set in the document before.
• font-size (default 20pt): The font size to use for names on tables.
• title-font-size (default 28pt): The font size for the chart title.
• stroke (default 2pt): The stroke to use for the table borders.
• fill (default none): The fill to use for the table color.
• gutter (default 0.8em): The spacing between tables.
• border (default none): The border to draw around the whole chart
  (specified as a stroke).
• margin (default 0pt): How much margin to add inside the chart confines.
• background (default none): Background color for the whole chart.
• width (default auto): The width of the whole chart (given as a length).
  • Note auto in this case means filling all available space.
• height (default auto): The height of the whole chart (given as a length).

free-seating-chart()

Draws a seating chart that allows for a more complex layout. Also takes up all
available space if not constrained.

Instead of directly entering names, tables are instead specified to be standing
either horizontally or vertically from the viewer's perspective, while gaps in
the layout are set as empty.

For this, the function htable[], vtable[] and empty() are used inside the
free-seating-chart() call. htable and vtable are given any number of
names inside content brackets which create tables spanning an equal number of
"seats" in the layout. empty() is given either one or two numbers. With one
parameter, that many seats are set as empty horizontally. With two numbers, the
first specifies the horizontal dimension of the empty space, with the second
denoting the vertical one.

To draw a layout, go through it from top-left to bottom-right creating the
necessary tables and empty spaces as you go. Each successive element starts at
the next free slot in the underlying grid. Since this can be hard to visualize,
there a debug parameter that can be set as true to show where each element
ends up and how much space it occupies.

To leave seats empty on a table either put empty content brackets after a table
definition for the empty spot or use the span parameter on the table
functions to specify that the table should not have its' size dictated by the
number of names given.

Main function parameters:

• columns (default 6): Number of table columns the seating arrangement has.
• rows (default 4): Number of table rows the seating arrangement has.
• title (default none): Optional title to draw above the chart.

Styling parameters:

• font (default auto): What font to use in the chart.
  • If not specified, uses the font set in the document before.
• font-size (default 20pt): The font size to use for names on tables.
• title-font-size (default 28pt): The font size for the chart title.
• stroke (default 2pt): The stroke to use for the table borders.
• fill (default none): The fill to use for the table color.
• gutter (default 0.8em): The spacing between tables.
• border (default none): The border to draw around the whole chart
  (specified as a stroke).
• margin (default 0pt): How much margin to add inside the chart confines.
• background (default none): Background color for the whole chart.
• width (default auto): The width of the whole chart (given as a length).
  • Note auto in this case means filling all available space.
• height (default auto): The height of the whole chart (given as a length).
• debug (default false): Whether or not to draw debugging numbers and
  borders to clarify where all the input elements end up.

Helper functions for free-seating-chart()

htable[], vtable[] and empty() are the functions used inside a call of
free-seating-chart() to specify the layout. These all simply return
dictionaries containing the necessary data to construct the chart, meaning they
don't provide any use outside of the call to create the chart.

By default, a table is set up to cover as many seats as names are given as
content arguments to the call, e.g. htable[Tic][Tac][Toe] will create a
horizontal table three seats wide. If you wish to set the table length
manually, specify the span parameter: vtable(span: 2)[Abraham].

empty() creates a single empty space. empty(num) will create a horizontal
empty space of the specified number of seats. empty(num, other-num) will
create an empty space covering an area of seats num wide and other-num
tall.

Alternative function names

Alternative function names in German are available:

• sitzplan() instead of seating-chart().
• freier-sitzplan() instead of free-seating-chart().
• htisch[], vtisch[] and leer() instead of htable[], vtable[] and
  empty().

Local package

If you want to use the package locally, you have two options:

1. Download and extract the package folder to your chosen package namespace.
   Check the
   official documentation
   for where to find and create a namespace. Then simply import the package
   from that namespace. The following example assumes a namespace named local
   to be used: #import "@local/sitdown:1.0.0": *

   This makes the package available anywhere on your system via the namespace
   import.

2. Download only the single file named sitdown.typ and place it next to
   the typst file you wish to use the package in. Then simply import the file
   as follows: #import "sitdown.typ": *

   This method will make the package available only to files that you directly
   copy the source file next to.