K. Adam White

defomicron

<p>Civil Footnotes is a WordPress plugin for adding footnotes on your blog. Civil Footnotes parses your posts for notes wrapped in ((double parenthesis)), then extracts that parenthesized text into a footnote list at the end of the post.</p>
<p>There are many solutions for managing footnotes within your WordPress website, but Civil Footnotes distinguishes itself from the rest with a simple, readable plain text syntax that works whether you’re using the WordPress block editor, a Markdown editor, or the classic editor plugin.</p>
<p>The majority of Civil Footnotes’ formatting is taken from the blog <a href="https://daringfireball.net/" rel="nofollow ugc">Daring Fireball</a>, which first debuted this style of footnotes <a href="http://daringfireball.net/2005/07/footnotes" rel="nofollow ugc">in 2005</a>. The key difference is the addition of a <code>title</code> attribute to the footnote reference in the text which permits sighted mouse users to efficiently read the note by hovering their cursor over the reference number.</p>
<h4>Credits</h4>
<p>Civil Footnotes was originally created by <a href="https://defomicron.net/" rel="nofollow ugc">Austin Sweeney</a> and is currently maintained by <a href="https://www.kadamwhite.com" rel="nofollow ugc">K. Adam White</a>.</p>
<h3>License & Attribution</h3>
<p>This plugin is licensed under the terms of the <a href="./license.txt" rel="nofollow ugc">GNU General Public License</a> (or “GPL”). It is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.</p>


Civil Footnotes

Add footnotes to your site using a simple, easy-to-read inline syntax ((by wrapping footnote content with double-parentheses)).

Joop Laan

<p><strong>Inline Context</strong> is a powerful Block Editor enhancement that lets you create inline expandable notes or clean tooltip-style popovers anywhere in your content. It is ideal for <strong>content-rich websites</strong>, including editorial platforms, research sites, online magazines, documentation hubs, and educational blogs that rely on clear explanation without breaking the reader’s focus.</p>
<p>Instead of sending readers to glossary pages or external links, Inline Context allows you to provide definitions, references, clarifications, and annotations <em>in place</em> — keeping readers engaged and your content structured.</p>
<p>Notes can be <strong>reusable</strong>, categorized, styled, centrally managed, and automatically updated everywhere they appear.</p>
<p><a href="https://wordpress.org/plugins/inline-context/?preview=1" rel="ugc">Check the live preview</a></p>
<h4>Why this is valuable for content-heavy websites</h4>
<p>Websites with substantial text often need:</p>
<ul>
<li>definitions and terminology</li>
<li>source references</li>
<li>background information</li>
<li>contextual inline explanations</li>
<li>mini footnotes without scrolling</li>
<li>inline callouts, tips, or warnings</li>
</ul>
<p>Inline Context delivers all of this with a frictionless, accessible user experience. It helps readers stay focused, reduces navigation fatigue, and improves knowledge retention — especially in long articles or research-based content.</p>
<h4>How it works</h4>
<ol>
<li>Highlight text in the Block Editor.</li>
<li>Click <strong>Inline Context</strong>.</li>
<li>Enter your note content (rich text supported).</li>
<li>Optionally assign a category with custom icon & color.</li>
<li>Publish — your note appears inline or as a tooltip, depending on settings.</li>
</ol>
<p>You can also create <strong>reusable</strong> notes from a dedicated Custom Post Type. Updating a reusable note updates all instances site-wide.</p>
<h3>Key Features</h3>
<h4>Display modes</h4>
<ul>
<li>Inline expansion (reveals a small content panel)</li>
<li>Tooltip popovers (floating contextual bubbles)</li>
<li>Smart tooltip positioning to avoid off-screen display</li>
<li>Direct anchor links (<code>#context-note-xxx</code>) for deep linking</li>
<li>Auto-open on page load when accessed via link</li>
</ul>
<h4>Editor productivity</h4>
<ul>
<li>Reusable notes with global updates</li>
<li>Notes Library with usage tracking (shows where each note is used)</li>
<li>Quick Search inside the editor to insert existing notes</li>
<li>Rich text support via ReactQuill (bold, italic, lists, links)</li>
<li>Clean, integrated Rich Text toolbar button</li>
</ul>
<h4>Categories & icons</h4>
<ul>
<li>Create unlimited categories (Definition, Reference, External Article, Tip, Warning, etc.)</li>
<li>Choose from curated Dashicons or any of 300+ icons</li>
<li>Separate icons for open and closed states</li>
</ul>
<h4>Styling & customization</h4>
<p>Full styling control from <strong>Settings <span aria-hidden="true" class="wp-exclude-emoji">→</span> Inline Context</strong>:</p>
<ul>
<li>Link colors, hover, and focus states</li>
<li>Note padding, spacing, borders, backgrounds, shadows</li>
<li>Tooltip appearance</li>
<li>Chevron/indicator styling</li>
<li>Live interactive preview of all style changes</li>
</ul>
<h4>Accessibility & security</h4>
<ul>
<li>ARIA support, focus lock, Escape key behavior</li>
<li>Keyboard-navigable for both link and note</li>
<li>DOMPurify sanitization of note content</li>
</ul>
<h3>Internationalization</h3>
<p>Inline Context is fully translation-ready.</p>
<h3>Examples & inspiration</h3>
<p>The idea for this plugin originated from a project with Renée Kool — a visual artist working in public art, film, and emerging media. She wanted to create a website where a single link could reveal additional content containing multiple related links. We looked at the Dutch journalism platform De Correspondent, which use subtle inline notes to provide context without interrupting the flow of reading. You can see examples of their inline notes in this article: <a href="https://decorrespondent.nl/15887/hoe-nederland-kampioen-deeltijdwerken-werd/9053b712-3591-0002-29b3-8c7b69eae0c3" rel="nofollow ugc">Hoe Nederland kampioen deeltijdwerken werd</a></p>
<h3>Source code</h3>
<p>Inline Context uses <code>@wordpress/scripts</code> with webpack and npm to build assets.</p>
<p>Full source (including uncompiled JS and CSS) is available at:<br />
<a href="https://github.com/jooplaan/inline-context" rel="nofollow ugc">https://github.com/jooplaan/inline-context</a></p>


Inline Context

Add inline expandable notes or tooltips to provide context, definitions, and references without disrupting the reading flow.

Civil Footnotes vs Inline Context