russellballestrini/russell.ballestrini.net
1
0
Fork 0
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity Actions

Change first-person to we in pelican theme post

Browse source
This commit is contained in:
Russell Ballestrini 2025-10-13 09:51:46 -04:00
parent 80cba5647b
commit 45a3a8df87
1 changed files with 4 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

8
content/2025-10-11-pelican-theme-upgrade-right-sidebar-toc.rst
View file

@ -9,7 +9,7 @@ pelican theme upgrade: right sidebar table of contents
**The companion** `pelican-svbhack theme repo <https://github.com/russellballestrini/pelican-svbhack>`_ **lives here.**
I upgraded the pelican-svbhack theme to add a right sidebar table of contents. This enhancement improves navigation on longer articles by providing quick access to section headings.
We upgraded the pelican-svbhack theme to add a right sidebar table of contents. This enhancement improves navigation on longer articles by providing quick access to section headings.
the design
==========
@ -91,7 +91,7 @@ homepage summary filtering
ReStructuredText automatically generates anchor links in section headings when a table of contents is present. These anchors work perfectly on article pages, but become broken links when article summaries appear on the homepage - the anchor targets don't exist in that context.
To solve this, I created a Pelican plugin that provides a ``strip_anchors`` Jinja2 filter. This filter removes TOC divs and ``toc-backref`` anchor links from article summaries before they're rendered on the homepage.
To solve this, we created a Pelican plugin that provides a ``strip_anchors`` Jinja2 filter. This filter removes TOC divs and ``toc-backref`` anchor links from article summaries before they're rendered on the homepage.
**The Plugin**
@ -146,7 +146,7 @@ Without this filter, homepage excerpts would contain links like ``<a href="#the-
dark mode implementation
========================
After publishing this post, I immediately implemented dark mode using the CSS variable system! The dark theme is now the default, with a light mode toggle available in both desktop and mobile navigation.
After publishing this post, we immediately implemented dark mode using the CSS variable system! The dark theme is now the default, with a light mode toggle available in both desktop and mobile navigation.
**Key Features**
@ -267,6 +267,6 @@ The ``js-enabled`` class is added to the document element in the same inline scr
This approach ensures the buttons are never visible if they can't function. Without JavaScript, users still get a perfectly usable site in the default dark theme - they just don't see non-functional toggle buttons cluttering the interface.
This technique follows the same principles I wrote about in my `capability driven presentation </capability-driven-presentation/>`_ post from 2016. For more on resilient web design philosophy, I highly recommend the free online book `Resilient Web Design <https://resilientwebdesign.com/>`_ by Jeremy Keith.
This technique follows the same principles we wrote about in the `capability driven presentation </capability-driven-presentation/>`_ post from 2016. For more on resilient web design philosophy, I highly recommend the free online book `Resilient Web Design <https://resilientwebdesign.com/>`_ by Jeremy Keith.
.. contents::