Skip to content

v1.3.0+fa20

Choose a tag to compare

View all tags
@seshrs seshrs released this 19 Aug 03:00
· 626 commits to develop since this release
v1.3.0+fa20
f40193b
This commit was signed with the committer’s verified signature.
seshrs Sesh Sadasivam
GPG key ID: 5BC66A67C479577E
Verified
Learn about vigilant mode.

While the Spring/Summer 2020 releases included exciting visual updates, the Fall 2020 release features massive changes under-the-hood. Viewers of Primer Spec sites may notice that the site loads faster and just "feels" snappier ✨ — that's because Primer Spec's dynamic scripts were almost entirely rewritten using Preact (#63), a tiny React-inspired framework that also optimizes CPU-intensive page-manipulation.

Besides this ginormous refactor, v1.3.0 adds a bunch of other neat features for courses using the Primer Spec theme:

  • Configuration Options! ⚙️
    Does your site have pages that are small with so few headings that a Sidebar doesn't really make sense? Now you can disable the Sidebar on those pages! You can even set a default subtheme for your site, or default to a wide-screen view. Have a look at the new page/site configuration options in the Advanced Usage docs.

  • Better usage docs 📝
    GitHub Pages uses certain Jekyll plugins by default that makes working with MarkDown files much nicer. The Usage docs now [strongly] recommend enabling those plugins and configuration options. The instructions to preview your site locally have also been updated.

  • MathJax 3 🔢
    v1.2.1 introduced LaTeX rendering via MathJax 2. Now that Jekyll 3.9.0 (which GitHub Pages uses) outputs LaTeX in a format compatible with MathJax 3 by default, we updated our MathJax dependencies to work with it. (#53, #55, #63)

  • Other fixes: 🛠️

    • If a heading on a page had the title "Contents", the corresponding link in the Sidebar would not scroll to this section — this is because its ID conflicted with a heading in the Primer Spec Sidebar's table of contents. This is unfair competition — we renamed our header so you don't have to rename yours 😉 (#67)

    • 3D layering is hard. The Topbar appeared on top of the main content, but LaTeX expressions were somehow exceptions...? And the Sidebar appeared on top of the Topbar on small screens, but not on large screens? 😓
      If your head hurts, so did ours! We fixed the 3D layers for good, and hopefully it's all more consistent now. (#54)

Assets 2
Loading