Add poster for 2025 DBMI retreat (#347)

* initial draft and scaffold

* updates for banner and intro content

* banner

* add handbook and notebook images

* linting; future content

* update dimensions; remove files; add credit; size

Co-Authored-By: Gregory Way <gregory.way@gmail.com>

* Update accept.txt

* authors, sizing, and typos

* [pre-commit.ci lite] apply automatic fixes

* add erik

---------

Co-authored-by: Gregory Way <gregory.way@gmail.com>
Co-authored-by: pre-commit-ci-lite[bot] <117423508+pre-commit-ci-lite[bot]@users.noreply.github.com>

Author: 3 people

.pre-commit-config.yaml

@@ -120,7 +120,7 @@ repos:
         additional_dependencies: ["bandit[toml]"]
 
 -   repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: "v0.12.9"
+    rev: "v0.12.10"
     hooks:
       # A fast linter that checks for stylistic errors in Python code,
       # helping maintain code quality and adherence to style guidelines.

coverage.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" ?>
-<coverage version="7.10.2" timestamp="1754947931360" lines-valid="1052" lines-covered="919" line-rate="0.8736" branches-covered="0" branches-valid="0" branch-rate="0" complexity="0">
-	<!-- Generated by coverage.py: https://coverage.readthedocs.io/en/7.10.2 -->
+<coverage version="7.10.4" timestamp="1755793699457" lines-valid="1052" lines-covered="919" line-rate="0.8736" branches-covered="0" branches-valid="0" branch-rate="0" complexity="0">
+	<!-- Generated by coverage.py: https://coverage.readthedocs.io/en/7.10.4 -->
 	<!-- Based on https://raw.githubusercontent.com/cobertura/web/master/htdocs/xml/coverage-04.dtd -->
 	<sources>
 		<source>/Users/buntend/Documents/work/almanac</source>

pyproject.toml

@@ -196,3 +196,15 @@ else
     rm "new_cov.xml"
 fi
 """
+# note: quarto commands below expect quarto installed on the local system.
+# see here for more information: https://quarto.org/docs/download/
+poster-preview.shell = """
+quarto preview \
+  src/book/_posters/2025/poster.qmd
+"""
+poster-render.shell = """
+  quarto render \
+  src/book/_posters/2025/poster.qmd
+  mv src/book/_posters/2025/2026-poster.pdf \
+  src/book/_static/2026-poster.pdf
+"""

src/book/_posters/2025/_extensions/quarto-ext/poster/_extension.yml

@@ -0,0 +1,10 @@
+title: Poster (modified)
+author: Carlos Scheidegger, Dave Bunten
+version: 1.0.0
+quarto-required: ">=1.4.415"
+contributes:
+  formats:
+    typst:
+      template-partials:
+        - typst-template.typ
+        - typst-show.typ

src/book/_posters/2025/_extensions/quarto-ext/poster/typst-show.typ

@@ -0,0 +1,74 @@
+// Typst custom formats typically consist of a 'typst-template.typ' (which is
+// the source code for a typst template) and a 'typst-show.typ' which calls the
+// template's function (forwarding Pandoc metadata values as required)
+//
+// This is an example 'typst-show.typ' file (based on the default template
+// that ships with Quarto). It calls the typst function named 'article' which
+// is defined in the 'typst-template.typ' file.
+//
+// If you are creating or packaging a custom typst template you will likely
+// want to replace this file and 'typst-template.typ' entirely. You can find
+// documentation on creating typst templates here and some examples here:
+//   - https://typst.app/docs/tutorial/making-a-template/
+//   - https://github.com/typst/templates
+
+#show: doc => poster(
+  $if(title)$ title: [$title$], $endif$
+  // TODO: use Quarto's normalized metadata.
+  $if(poster-authors)$ authors: [$poster-authors$], $endif$
+  $if(departments)$ departments: [$departments$], $endif$
+  $if(size)$ size: "$size$", $endif$
+
+  // Institution logo.
+  $if(institution-logo)$ univ_logo: "$institution-logo$", $endif$
+
+  // Footer text.
+  // For instance, Name of Conference, Date, Location.
+  // or Course Name, Date, Instructor.
+  $if(footer-text)$ footer_text: [$footer-text$], $endif$
+
+  // Any URL, like a link to the conference website.
+  $if(footer-url)$ footer_url: [$footer-url$], $endif$
+
+  // Emails of the authors.
+  $if(footer-emails)$ footer_email_ids: [$footer-emails$], $endif$
+
+  // Color of the footer.
+  $if(footer-color)$ footer_color: "$footer-color$", $endif$
+
+  // DEFAULTS
+  // ========
+  // For 3-column posters, these are generally good defaults.
+  // Tested on 36in x 24in, 48in x 36in, and 36in x 48in posters.
+  // For 2-column posters, you may need to tweak these values.
+  // See ./examples/example_2_column_18_24.typ for an example.
+
+  // Any keywords or index terms that you want to highlight at the beginning.
+  $if(keywords)$ keywords: ($for(keywords)$"$it$"$sep$, $endfor$), $endif$
+
+  // Number of columns in the poster.
+  $if(num-columns)$ num_columns: $num-columns$, $endif$
+
+  // University logo's scale (in %).
+  $if(univ-logo-scale)$ univ_logo_scale: $univ-logo-scale$, $endif$
+
+  // University logo's column size (in in).
+  $if(univ-logo-column-size)$ univ_logo_column_size: $univ-logo-column-size$, $endif$
+
+  // Title and authors' column size (in in).
+  $if(title-column-size)$ title_column_size: $title-column-size$, $endif$
+
+  // Poster title's font size (in pt).
+  $if(title-font-size)$ title_font_size: $title-font-size$, $endif$
+
+  // Authors' font size (in pt).
+  $if(authors-font-size)$ authors_font_size: $authors-font-size$, $endif$
+
+  // Footer's URL and email font size (in pt).
+  $if(footer-url-font-size)$ footer_url_font_size: $footer-url-font-size$, $endif$
+
+  // Footer's text font size (in pt).
+  $if(footer-text-font-size)$ footer_text_font_size: [$footer-text-font-size$], $endif$
+
+  doc,
+)

src/book/_posters/2025/_extensions/quarto-ext/poster/typst-template.typ

@@ -0,0 +1,174 @@
+#let poster(
+  // set variables for use throughout
+  // note: some are referenced from `.qmd` file
+  size: "'36x24' or '48x36''",
+  title: "Paper Title",
+  authors: "Author Names (separated by commas)",
+  departments: "Department Name",
+  univ_logo: "Logo Path",
+  footer_text: " ",
+  footer_url: "Footer URL",
+  footer_email_ids: "Email IDs (separated by commas)",
+  footer_color: "Hex Color Code",
+  keywords: (),
+  num_columns: "4",
+  univ_logo_scale: "185",
+  univ_logo_column_size: "13",
+  title_column_size: "22",
+  title_font_size: "48",
+  authors_font_size: "36",
+  footer_url_font_size: "40",
+  footer_text_font_size: "40",
+  body
+) = {
+  // initialize template display formatting
+  set text(font: "Lato", size: 26pt)
+  let sizes = size.split("x")
+  let width = int(sizes.at(0)) * 1in
+  let height = int(sizes.at(1)) * 1in
+  univ_logo_scale = int(univ_logo_scale) * 1%
+  title_font_size = int(title_font_size) * 1pt
+  authors_font_size = int(authors_font_size) * 1pt
+  num_columns = int(num_columns)
+  univ_logo_column_size = int(univ_logo_column_size) * 1in
+  title_column_size = int(title_column_size) * 1in
+  footer_url_font_size = int(footer_url_font_size) * 1pt
+  footer_text_font_size = int(footer_text_font_size) * 1pt
+
+  // create overall page output
+  set page(
+    // total dimensions
+    width: width,
+    height: height,
+    // margin on all sides
+    margin:
+      (top: .8in, left: .8in, right: .8in, bottom: 1.8in),
+    // footer section
+    footer: [
+      #set align(center)
+      #set text(42pt)
+      #block(
+        fill: rgb(footer_color),
+        width: 100%,
+        inset: 20pt,
+        radius: 10pt,
+        // adds text to footer
+        [
+          #text(font: "Lato", size: footer_url_font_size, footer_url)
+          #h(1fr)
+          #text(size: footer_text_font_size, smallcaps(footer_text))
+          #h(1fr)
+          #text(font: "Lato", size: footer_url_font_size, footer_email_ids)
+        ]
+      )
+    ]
+  )
+
+  // set math display properties
+  set math.equation(numbering: "(1)")
+  show math.equation: set block(spacing: 0.65em)
+
+  set enum(indent: 10pt, body-indent: 9pt)
+  set list(indent: 10pt, body-indent: 9pt)
+
+  // set the heading numbering system
+  set heading(numbering: "I.A.1.")
+  show heading: it => context {
+    // Get numbering tuple for *this* heading at the current location.
+    let levels = counter(heading).at(here())
+    let deepest = if levels != () { levels.last() } else { 1 }
+
+    // defines how sub-headers display
+    set text(24pt, weight: 400)
+
+    // sub-header level 0
+    if it.level == 0 [
+      #set text(style: "italic")
+      #v(32pt, weak: true)
+      #if it.numbering != none {
+        numbering("i.", deepest)
+        h(7pt, weak: true)
+      }
+      #it.body
+
+    // sub-header level 1
+    ] else if it.level == 1 [
+      #v(10pt, weak: true)
+      #set align(left)
+      #set text({ 40pt }, weight: 600, font: "Vollkorn", fill: rgb("#246876"))
+      #v(50pt, weak: true)
+      #if it.numbering != none {
+        numbering("I.", deepest)
+        h(7pt, weak: true)
+      }
+      #it.body
+      #v(30pt, weak: true)
+      #line(length: 100%, stroke: rgb(200, 200, 200))
+      #v(30pt, weak: true)
+
+    // all other headers
+    ] else [
+      #set text({ 36pt }, weight: 600, font: "Vollkorn", fill: rgb("#1e4b5c"), style: "italic")
+      #if it.level == 2 {
+        numbering("❀  a)", deepest)
+        [ ]
+      }
+      #it.body
+      #v(40pt, weak: true)
+    ]
+}
+
+  // header grid
+  align(left,
+    grid(
+      // rows and cols in the header
+      rows: (auto, auto),
+      columns: (title_column_size, univ_logo_column_size),
+      column-gutter: 5pt,
+      row-gutter: 30pt,
+      // main title
+      image("./images/title-text.png", width: 65%),
+      grid.cell(
+        pad(top: 20pt,
+          image(univ_logo, width: univ_logo_scale),
+        ),
+        rowspan: 3,
+        align: left,
+      ),
+      // author display
+      text(size: 28pt, authors),
+      // department and notes display
+      text(size: 25pt, emph(departments)),
+    )
+  )
+
+  // spacing between the header and body
+  v(40pt)
+
+  // set main body display
+  show: columns.with(num_columns, gutter: 60pt)
+  // paragraph display properties
+  set par(leading: 10pt,
+    justify: false,
+    first-line-indent: 0em,
+    linebreaks: "optimized"
+  )
+
+  // Configure figures.
+  show figure: it => block({
+    // Display a backdrop rectangle.
+    it.body
+
+    // Display caption.
+    if it.has("caption") {
+      set align(left)
+      v(if it.has("gap") { it.gap } else { 24pt }, weak: true)
+      set text(weight: "bold")
+      it.caption
+    }
+
+  })
+
+  // adds body content to page
+  body
+}