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
- 1 Example University
- 2 Another Institute
Example Venue 2026
<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
Example Workshop 2026
<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
- 1 Example University
- 2 Another Institute
Example Venue 2026
<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
- 1 Example University
- 2 Another Institute
Example Venue 2026
<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.
<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 -simplices combines a down and an up part:
<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.
- E. Author, F. Author. Example reference title. Example Journal, 2024.
<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
- G. Other, H. Other, and I. Other (2022). A second example reference. Example Conference. arXiv
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
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.
<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.
@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.
<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
2025
Example title: an earlier preprint
arXiv preprint
<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.
-
Topological deep learning
Neural networks for data in which relations join more than two things at once.
- Example title: higher-order message passing Example Venue 2026
- Example title: a benchmark for simplicial learning arXiv preprint
-
Sheaves
Local data glued along restriction maps.
- Example title: sheaf diffusion with learned restriction maps Example Workshop 2026
<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
<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
<ul class="ply-chips">
<li>Python</li><li>PyTorch</li><li>Rust</li><li>LaTeX</li><li>Astro</li>
</ul>