Skip to content
Polytope

Research

The parts every paper page needs: a header, figures, equations, citations, BibTeX, and a publication list.

Experimental May change in any minor version before 1.0.


In this chapter 15 pages

Paper header

Example title: Higher-order message passing on cell complexes

  • A. Author1,*
  • John Doe2,*
  • B. Author1,2
  • 1 Example University
  • 2 Another Institute

* Equal contribution

Example Venue 2026

astro
<PaperHeader
  venue="NeurIPS 2026"
  title="..."
  authors={[{ name: "John Doe", affiliations: [1], equal: true }, ...]}
  affiliations={["Example University"]}
  me="John Doe"
  links={[{ label: "Paper", href: "/paper.pdf", icon: "paper" }, { label: "Code", href: repo, icon: "code" }]}
/>

The title is the page's h1. When the header sits inside another page, as it does above, pass level=2. Pass me with your name as it reads in authors to set it in bold, as on the publication wall; the other names drop to regular weight. In plain HTML, give your li the class ply-me.

The title sizes to the header's own width, not the window's, so it sets the same in a column beside an exhibit as across the page. It runs about 22 characters to a line, and longer lines for a long title, so most titles keep to three lines. A title with a subtitle (the part after the first colon) sets the name in wood type and the subtitle under it in the text face. The colon stays in the heading, hidden, so screen readers and copies keep the whole title. Pass split={false} to keep the whole title in wood type. In plain HTML, write the subtitle as <span class="ply-visually-hidden">: </span><span class="ply-title__sub">...</span> inside the heading, and set --_len (the length of the name) and --_em (the width of its longest word, from emWidth) on it, as the component does.

Because the header measures its own width, it takes its width from where it sits, never from its text. In a grid column or a block it fills its space; in a box that shrinks to fit its content, such as an inline-block or a fit-content box, give it a width. The first link is the primary button; give another link primary: true to make it the one, such as the PDF when the first link is the venue's page.

Long author lists

A report with dozens of authors folds: pass fold with the most names to show whole, and a longer list shows the first half of that number, yours, and the last author, with a gap where names are left out and a button for the whole list. The fold is in the page as built, so nothing moves while it loads. Without script, and on paper, the list shows whole. In plain HTML, load js/fold.js (it is part of js/all.js).

Example report: a shared benchmark for cell complexes

  • A. Author
  • B. Author
  • C. Author
  • D. Author
  • E. Author
  • F. Author
  • G. Author
  • H. Author
  • John Doe
  • I. Author
  • J. Author
  • K. Author
  • L. Author
  • M. Author

Example Workshop 2026

astro
<PaperHeader title="..." authors={authors} me="John Doe" fold={12} />

Front matter slots

Two slots finish a paper page's front matter. figure holds the key figure. It takes the width of the header and the margin together, so it ends where the margin column ends. A Figure with column keeps to the text's width, and split sets a long caption under a wide figure in two balanced columns from 60rem.

Example title: a paper with a key figure

  • A. Author1
  • John Doe2
  • 1 Example University
  • 2 Another Institute

Example Venue 2026

Key figure
Figure 1.A long caption sets in two balanced columns from 60rem, which keeps its lines near the reading measure and its edges the figure's. It starts with what the figure shows and ends with how to read it, so a reader who looks at nothing else still gets the result. The columns balance, so the caption stays one block.
astro
<PaperHeader title="..." authors={authors}>
  <Figure slot="figure" num={1} split>
    <Picture src={teaser} alt="..." />
    <Fragment slot="caption">What the figure shows, then how to read it.</Fragment>
  </Figure>
</PaperHeader>

exhibit is for a paper with no figure. A picture or a complex hangs in the margin beside the header from 60rem and stacks under it below that. The header sits in .ply-paper-head only when one of the two slots is filled, so a header without them is unchanged.

Example title: a paper without a figure

  • A. Author1
  • John Doe2
  • 1 Example University
  • 2 Another Institute

Example Venue 2026

Example Venue 2026. The card's complex, seeded from the title.
astro
<PaperHeader title="..." authors={authors}>
  <figure slot="exhibit" class="ply-exhibit">
    <ComplexStatic seed={seed} points={28} radius={0.17} label="..." />
    <figcaption><b>NeurIPS 2026.</b> ...</figcaption>
  </figure>
</PaperHeader>

Summary, divider, and foot

Tldr sets the paper in one line at the lede's size, under the header and before the abstract, behind a small wall label. A 3px rule closes the front matter before the text, and .ply-rule--measure keeps it to the text's width. Article's foot slot holds what closes the page, such as the pager, at the text's edge and under the article's own padding.

In short Edges between cells carry the message that the vertices cannot.


astro
<Article>
  <PaperHeader slot="header" title="..." authors={authors} />
  <Tldr>One line that says what the paper found.</Tldr>
  <Abstract><p>...</p></Abstract>
  <hr class="ply-rule ply-rule--measure" />
  <h2>1. Introduction</h2>
  <Pager slot="foot" label="More papers" prevText="Newer" nextText="Older" prev={newer} next={older} />
</Article>

Equations

KaTeX renders math at build time, so pages ship HTML and MathML and no math script. The Hodge Laplacian on kk-simplices combines a down and an up part:

Lk=Bk⊤Bk+Bk+1Bk+1⊤L_k = B_k^{\top} B_k + B_{k+1} B_{k+1}^{\top}
(1)
astro
<p>... on <M tex="k" />-simplices ...</p>
<Equation tex={String.raw`L_k = B_k^{\top} B_k + B_{k+1} B_{k+1}^{\top}`} num={1} />

Equation and M bring KaTeX's stylesheet, so only pages with math load it. When the TeX contains a backslash, pass it as tex={String.raw`...`}: Astro 7 reads backslash sequences inside quoted attributes as escape characters, so \binom in quotes arrives as a backspace and inom. The components stop the build with a clear message if that happens.

Citations

Hover or focus a citation to see the reference without leaving the sentence[1]Example reference title
E. Author, F. Author
Example Journal, 2024
. The number links to the reference list.

  1. E. Author, F. Author. Example reference title. Example Journal, 2024.
astro
<Cite n={1} title="..." authors="..." venue="..." year={2024} />

The card stays open while the pointer is on it and closes with Escape. In plain HTML, load js/cite.js (it is part of js/all.js).

Reference list

References lists the works a paper cites, each entry the target #ref-key of a citation link. The title links to the version of record, and an alternate copy gets its own link, named for a screen reader with the title. The entry a link jumped to is tinted, with a tomato bar beside it. Sort the list with byAuthorYear, and build each address with refHref.

References

astro
import { References, byAuthorYear, refHref } from "@dario-loi/polytope/astro";

<References refs={refs.sort(byAuthorYear)} />
// refs: { key, authors, year, title, venue?, href?, alt?: { label, href }, cite?: string[] }[]

In an MDX body the citation text can link itself. citeLinks from @dario-loi/polytope/astro/cite-links.mjs is a hast plugin for Astro 7's MDX pipeline. It reads a JSON file of { key, cite } entries beside each MDX file and links every occurrence of a cite string, such as "Bodnar et al., 2022", to #ref-key, at build time. Text already inside a link, code, or a heading is left alone. match picks the files and refs maps a file's path to its reference file.

Figures

Figure content goes here
Figure 2.Captions start with what the figure shows, then how to read it.

On an article page, margin puts a small figure in the margin after the text, beside the paragraph after it. On narrow screens it stays in the text. Every other figure keeps to the text column, even with wide, which runs a figure past the text only on a docs page.

astro
<Figure num={2} margin>
  <img src={plot.src} alt="..." />
  <Fragment slot="caption">What the figure shows, then how to read it.</Fragment>
</Figure>

column keeps a figure to the text's width wherever it sits, and split sets a long caption under a wide figure in two columns from 60rem. Both are described with the front matter slots.

BibTeX

Long fields wrap under their value, so the whole entry reads before it is copied, and a cite key never breaks unless it is wider than the block. Pass wrap={false} to let lines scroll instead. Code takes the same wrap.

BibTeX
@inproceedings{author2026example,
  title     = {Example title: Higher-order message passing on cell complexes},
  author    = {Author, A. and Doe, John and Author, B.},
  booktitle = {Example Venue},
  year      = {2026}
}

Give bib and ris the addresses of the entry as files, and a row of two small buttons, Download .bib and Download .ris, sits under the panel. Each button downloads its file. downloadAttrs adds attributes to both, such as the data attributes an analytics script reads, and {format} in a value becomes bib or ris. Each button also has data-format set to its format.

astro
<BibTeX entry={bibtex} bib="/papers/key.bib" ris="/papers/key.ris"
  downloadAttrs={{ "data-track": "citation-download", "data-track-label": "{format}" }} />

Publication wall

Publications grouped by year, the year in wood type, the site owner's name in bold in each author list.

2026

  • Example title: Higher-order message passing on cell complexes

    A. Author, John Doe, B. Author

    Example Venue 2026

  • Example title: a second paper in the same year

    John Doe, C. Author

    Example Workshop 2026

2025

  • Example title: an earlier preprint

    D. Author, John Doe

    arXiv preprint

astro
<PubList pubs={pubs} me="John Doe" class="ply-wall--lead" />

class adds classes to the wall, such as ply-wall--lead for the short tomato lead above each year.

The wall is a region named label ("Publications"). When it sits in a section of yours that has its own heading, pass label={false}, so the page does not name two regions alike. fold folds a long author list here as in the header, as text: the first names, yours, and the last.

Walls

A wall is a list divided by rules, its labels in one column. The year wall of PubList is one; the same classes set other lists. From 64rem every wall's label column is as wide as an article's rail (--ply-layout-toc), so the labels of every wall, list, and home section start at one edge and what they label starts one column in.

Rows

A .ply-wall__row sets a name in the label column and what it labels beside it, with a hairline between rows. It suits a list of topics with their papers, or of skills with their tools. Put .ply-wall on a ul, ol, or dl. .ply-wall--lead on the wall adds a short tomato lead above each label, a name here and a year on the year wall. From 80rem, .ply-wall__body--split sets a description and a list in two columns, so the row is as tall as its longer side. .ply-wall__aside is a quiet note after a link, such as a venue.

HTML
<ul class="ply-wall ply-wall--lead" role="list">
  <li class="ply-wall__row">
    <h3 class="ply-wall__name"><a href="#">Topological deep learning</a></h3>
    <div class="ply-wall__body ply-wall__body--split">
      <p class="ply-wall__about">Neural networks for data in which relations join more than two things at once.</p>
      <ul class="ply-wall__list" role="list">
        <li><a href="#">Example title: higher-order message passing</a> <span class="ply-wall__aside">Example Venue 2026</span></li>
        <li><a href="#">Example title: a benchmark for simplicial learning</a> <span class="ply-wall__aside">arXiv preprint</span></li>
      </ul>
    </div>
  </li>
  <li class="ply-wall__row">
    <h3 class="ply-wall__name"><a href="#">Sheaves</a></h3>
    <div class="ply-wall__body ply-wall__body--split">
      <p class="ply-wall__about">Local data glued along restriction maps.</p>
      <ul class="ply-wall__list" role="list">
        <li><a href="#">Example title: sheaf diffusion with learned restriction maps</a> <span class="ply-wall__aside">Example Workshop 2026</span></li>
      </ul>
    </div>
  </li>
</ul>

Ledger

A ledger sets awards, service, and talks: the text at the start of each row and the year at the end, in bold tabular figures, with hairlines between. Set --ply-ledger-when to give the years a color of the site's own.

  • Example Prize, for the best student paper at Example Venue2026
  • Reviewer, Example Conference and Example Workshop2024-2026
HTML
<ul class="ply-ledger">
  <li><span class="ply-ledger__text">Example Prize, for the best student paper at Example Venue</span><span class="ply-ledger__when">2026</span></li>
  <li><span class="ply-ledger__text">Reviewer, Example Conference and Example Workshop</span><span class="ply-ledger__when">2024-2026</span></li>
</ul>

Chips

Chips are short names, such as skills or tools, in the mono face. Each sits in a sunken box with a hairline, and the row wraps.

  • Python
  • PyTorch
  • Rust
  • LaTeX
  • Astro
HTML
<ul class="ply-chips">
  <li>Python</li><li>PyTorch</li><li>Rust</li><li>LaTeX</li><li>Astro</li>
</ul>