Skip to content

Releases

Polytope 0.8.1

Choose a tag to compare

@dario-loi dario-loi released this 15 Nov 15:16
de8bc9d

polytope_theme.mpl.inline_svg() and save_inline_svg() now give the same SVG for the same figure (fixed clip-path hash salt, no date stamp), so a committed plot changes only when the plot does. The npm package is the same as 0.8.0 apart from its version. Changelog: https://dario-loi.github.io/polytope/changelog/

Polytope 0.8.0

Choose a tag to compare

@dario-loi dario-loi released this 15 Nov 15:06
0dea1b7

Search in the bar, BibTeX downloads, layout rules and components from the reference site. Full notes: https://dario-loi.github.io/polytope/changelog/

Polytope 0.7.2

Choose a tag to compare

@dario-loi dario-loi released this 14 Oct 04:10

Polytope 0.7.2 brings back the Atlas flights. The ride with the scroll in 0.7.1 followed every step of the wheel and moved too fast to read; the globe now flies from entry to entry again, with the durations and easing of 0.7.0.

npm update @dario-loi/polytope
pip install -U "polytope-theme[matplotlib,plotly]"
  • The two fixes the ride was for stay, in the flights' own pace. A short entry still gets its landing: scroll past up to two entries during a flight and the ball stops at their places in turn, each of those legs a little quicker, while a longer jump flies straight there. A new entry mid-flight turns the ball from where it is, with its trail unbroken, where before it jumped ahead to the place it had been flying to.
  • Kept from 0.7.1: outlines out of view are not drawn, which leaves every pixel the same and takes about half the frame time of the 0.7.0 flights. The kind filter comes with the page, the caption under the pinned globe on phones keeps two lines, an entry with no place holds the globe at the one before it, and a drag cut short by the window losing focus leaves no touch behind.
  • A moving globe no longer switches to coarser outlines on the way in, so a slow arrival never sharpens its coast.

Nothing in the markup changes, so npm update is enough. The full list is in the changelog.

Polytope 0.7.1

Choose a tag to compare

@dario-loi dario-loi released this 14 Oct 03:46

Polytope 0.7.1 steadies the complex and the Atlas while a page loads and scrolls, and lets a site's own structured data merge with the records <Seo> writes.

npm update @dario-loi/polytope
pip install -U "polytope-theme[matplotlib,plotly]"
  • A complex with autoplay="visible" waits as bare points from the first paint, its slider and counts at 0. Before, the finished drawing showed until the script loaded, then vanished and grew again, which looked like a flash on a slow phone. Without script, or with reduced motion, it is still drawn finished.
  • The complex draws each edge and triangle once, in order of the radius where it appears, so a growth frame or a slider step adds or removes only the cells in between. On a CPU slowed six times a frame went from 16 to 6 ms at 36 points, and from 57 to 11 ms at 120.
  • The Atlas rides the route with the scroll: the globe and the ball move along the great circle as the reader scrolls, and back when they scroll up. A stop on the way settles on the current entry, and a fast scroll catches up through every place it passed, so a short entry is no longer skipped.
  • The Atlas draws less. Long coasts are kept in runs, and a run out of view is drawn as a line between its ends, which leaves every pixel on screen the same. With the CPU slowed four times, a CV scroll on a phone drops 16% of frames, against 46% before. The kind filter is drawn on the server, so the entries no longer move down when the script starts.
  • <Seo citation> gives its ScholarlyArticle an @id, the canonical address with #article, and the Person record gets #person on the site's home. Records that share an @id are written as one, with the fields given in schema winning, so a site's fuller record of a paper merges into the one Seo writes instead of listing every author twice. On the home page siteName writes a WebSite record, and the paper record gains its PDF, preview picture, page range, and language.
  • Fixes. An Atlas entry with no place, such as remote work, holds the globe at the place before it instead of stopping the map with an error. A drag cut short by the window losing focus no longer turns the next drag into a pinch. The complex and the probability machine show their finished state on paper. A complex whose points or radius is not a number draws the default.

Nothing in the markup changes, so npm update is enough. The full list is in the changelog.

Polytope 0.7.0

Choose a tag to compare

@dario-loi dario-loi released this 13 Oct 12:18
607fc4c

Polytope 0.7.0 adds cards for list pages, folds long author lists, and fixes what a sweep of a real Polytope site turned up.

npm install @dario-loi/polytope@^0.7.0
pip install -U "polytope-theme[matplotlib,plotly]"
  • Cards for list pages. New <Card> and <CardGrid> for pages of papers, posts, and projects: a black panel with the entry's figure, or a complex seeded from its title, then the title, a meta line, a summary, and tags. A lead card spans the row, and a grid with fewer cards than columns shares the row between them. Labels over a figure use the new flag tokens and .ply-label--flag.
  • Folded author lists. <PaperHeader fold={12}> folds a long author list to the first names, yours, and the last, with a button for the rest. The fold is in the built page, so nothing moves while it loads; without script, and on paper, the list shows whole. <PubList fold> folds author lines as text. A link with primary: true becomes the header's primary button.
  • A shorter pager. The pager shows a title's name and keeps the subtitle for screen readers, so a long paper title no longer outweighs the page. Labels balance, and prevText and nextText rename the directions.
  • Masts and titles. A mast without an exhibit stays one column at every width. <Mast compact> sets a smaller title. New <MastTitle> and <WoodTitle> set wood-type titles in your own layouts, and the helpers behind them (woodTitle, splitTitle, emWidth) are exported.
  • Code. BibTeX wraps long fields under their value instead of scrolling, and <Code wrap> does the same for any block. A code block takes focus only while it scrolls.
  • Fixes. A theme change under reduced motion no longer paints the whole Atlas tomato. The chapter menu closes on Escape, a press outside, or focus moving past it. Printed code is in ink, long code blocks break across pages, and links to other sites print their address. The wordmark, publication titles, and the author toggle grow to 44px targets under a finger, and .ply-target does the same for your own links. A segmented row fits a phone. Also new: <Atlas quiet>, <Empty level>, <PubList label={false}>, <ThemeToggle persist={false}>, and a fonts.css export.

To update, install ^0.7.0, since npm update stays within 0.6. Headers in a box that shrinks to fit its content now need a width. Pager labels with a colon show only the name, and BibTeX blocks wrap; pass split={false} or wrap={false} to keep the old look. The full list is in the changelog.

Polytope 0.6.3

Choose a tag to compare

@dario-loi dario-loi released this 13 Oct 03:38
4ef0bb6

Polytope 0.6.3 keeps long paper titles to about three lines, in a narrow column as across the page.

npm update @dario-loi/polytope
pip install -U "polytope-theme[matplotlib,plotly]"
  • Titles size to the header, not the window. Paper and post titles now size to the header's own width. In a column beside an exhibit, a title used to keep its full size and run about nine characters to a line. A title runs about 22 characters to a line, and longer lines for a long title, so most keep to three lines. On phones a long title can drop toward 24px, and a title's longest word never breaks.
  • Subtitles in the text face. A paper title with a subtitle (the part after the first colon) sets the name in wood type and the subtitle under it in Libre Franklin. The colon stays in the heading, hidden, so screen readers and copies keep the whole title. Pass split={false} to <PaperHeader> to keep a title whole. In plain HTML, add <span class="ply-visually-hidden">: </span><span class="ply-paper__subtitle">...</span> inside the heading.
  • Smaller fixes. Short hyphenated terms such as Test-Time stay on one line. The venue line is balanced. Author, affiliation, and tag rows keep one baseline inside .ply-prose.

To update, run npm update; nothing else is needed. A title with a colon now shows its subtitle under the name. The full list is in the changelog.

Polytope 0.6.2

Choose a tag to compare

@dario-loi dario-loi released this 13 Oct 02:14
e8beed6

Polytope 0.6.2 sets your name in bold in a paper header's author list.

npm update @dario-loi/polytope
pip install -U "polytope-theme[matplotlib,plotly]"
  • me on <PaperHeader>. Pass the author name to set in bold, as <PubList> already takes. Every name in the header was semibold, so a bolder weight alone would barely show: with a name marked, the other names drop to regular and yours is bold. In plain HTML, give your li in .ply-authors the class ply-me.

A header without me looks as before. To use it, pass me with your name as it reads in authors. The full list is in the changelog.

Polytope 0.6.1

Choose a tag to compare

@dario-loi dario-loi released this 13 Oct 02:03
be8aa71

Polytope 0.6.1 keeps a long CV's route readable on the Atlas and turns the globe smoothly near the poles.

npm update @dario-loi/polytope
pip install -U "polytope-theme[matplotlib,plotly]"
  • The route fades with time. While an entry is current, the moves into and out of its place keep the full chalk, and the rest of the route fades with each move away from it, to 0.55, 0.3, then 0.15 of the chalk. With no entry current, as past the last entry, the whole route is chalk. The weights ease in as the current entry changes.
  • Smooth turns near the poles. A flight whose route passes near a pole turns the globe with the route and lands with north up, instead of spinning half a turn in a few frames. If a drag stops a flight partway, the drag turns the globe the way the pointer moves, and the globe turns back to north up once you let go.

Nothing to change in your pages. The full list is in the changelog.

Polytope 0.6.0

Choose a tag to compare

@dario-loi dario-loi released this 12 Oct 22:37
5dd4cde

Polytope 0.6.0 gives papers and posts a reading frame: the text at the centre of the page, the section list in a rail at the left, and a margin after the text for notes and small figures.

npm install @dario-loi/polytope@^0.6.0
pip install -U "polytope-theme[matplotlib,plotly]"
  • Articles. New .ply-article and <Article>, for a paper, a post, or a page of notes. The text sits at the centre of the page. From 80rem the on-this-page list hangs in a rail at the left edge, with a tomato point on the current section; below that it waits in an "On this page" disclosure above the text. <Article> builds the list from your h2 and h3 headings at build time, so it needs no script and nothing moves when the page loads.
  • Two lanes. A block sits in the text or in the margin, never across both. .ply-margin and <Figure margin> put a small figure, table, or code block in the margin beside its paragraph. In an article, .ply-wide keeps to the text, and a long table or line of code scrolls in its own frame.
  • Posts. New <PostHeader>: the title set like a paper's, a lede, the date, the reading time, and tags. A new blog post pattern shows a whole post.
  • Docs pages centre their text beside the sidebar and list the page's sections under the current page, in the sidebar and in the phone menu. <SideNav> takes a current slot for this.
  • Wide screens. From 100rem, docs and article text is 18px in a 38rem column, the same 68 characters to a line. New tokens: --ply-size-body-wide, --ply-layout-measure-wide, --ply-layout-margin.
  • Smaller fixes. Paper and post titles balance their lines and break the same way at every width. Table captions stay in view while a wide table scrolls. A screen reader reads a sidenote's number once.

To move a paper page built by hand to the new frame, wrap its body in <Article> and pass the header in its header slot, as the paper pattern's source does. A docs grid that still has .ply-docs__toc keeps its three columns from 80rem. The full list is in the changelog.

Polytope 0.5.1

Choose a tag to compare

@dario-loi dario-loi released this 12 Oct 17:10
abec90d

Polytope 0.5.1 makes pages paint sooner and stay still while fonts load, and keeps the Atlas responsive while it starts.

npm update @dario-loi/polytope
pip install -U "polytope-theme[matplotlib,plotly]"
  • Fallback faces. Arial or Liberation Sans scaled to Libre Franklin, Menlo, Liberation Mono, or Courier New to JetBrains Mono, and Liberation Serif Bold to Ultra where Georgia is missing. Text keeps its size while the fonts load, so nothing moves when they arrive. The font tokens name the new faces, which ship in polytope.css.
  • Math styles where the math is. Equation and M bring KaTeX's stylesheet, so only pages with math load it. Your own import of katex/dist/katex.min.css is no longer needed and does no harm.
  • Code blocks below the screen skip their layout until the reader nears them.
  • The Atlas decodes its map and draws its first frame in short slices behind the server's globe, loads the close outlines once the reader starts reading, and runs its geometry about three times faster with the same result.
  • The top bar keeps the search field's word wherever the tabs fit set closer, and measures correctly under reduced motion, where it could show the menu although the tabs fit.
  • Copy buttons on blocks titled with a file name read "Copy train.py from Code panels".

Nothing to change in your pages. The full list is in the changelog.