<?xml version="1.0" encoding="utf-8"?><feed xmlns="http://www.w3.org/2005/Atom" ><generator uri="https://jekyllrb.com/" version="3.10.0">Jekyll</generator><link href="https://drusagi.github.io/feed.xml" rel="self" type="application/atom+xml" /><link href="https://drusagi.github.io/" rel="alternate" type="text/html" /><updated>2025-11-15T00:55:29+00:00</updated><id>https://drusagi.github.io/feed.xml</id><title type="html">Shaohui Wang</title><subtitle>Shaohui Wang&apos;s academic portfolio</subtitle><author><name>Shaohui Wang</name><email>swang83@gsu.edu</email></author><entry><title type="html">Colorful Bionic: A Zotero Plugin for Enhanced Reading Experience, Especially for ADHD Readers</title><link href="https://drusagi.github.io/tools/research/colorful-bionic-zotero-plugin/" rel="alternate" type="text/html" title="Colorful Bionic: A Zotero Plugin for Enhanced Reading Experience, Especially for ADHD Readers" /><published>2025-01-14T00:00:00+00:00</published><updated>2025-01-14T00:00:00+00:00</updated><id>https://drusagi.github.io/tools/research/colorful-bionic-zotero-plugin</id><content type="html" xml:base="https://drusagi.github.io/tools/research/colorful-bionic-zotero-plugin/"><![CDATA[<p>I’m excited to introduce <a href="https://github.com/DrUsagi/Colorful-Bionic"><strong>Colorful Bionic</strong></a>, a Zotero plugin I developed that implements a colorful bionic reading experience in the Zotero reader. This plugin is particularly helpful for individuals with ADHD, as it can significantly improve reading speed and focus when reading academic papers.</p>

<h2 id="what-is-colorful-bionic">What is Colorful Bionic?</h2>

<p>Colorful Bionic is a Zotero plugin that highlights verbs, nouns, and conjunctions in different colors to enhance reading comprehension. It combines the principles of bionic reading with part-of-speech highlighting to create a more engaging and accessible reading experience.</p>

<h3 id="what-is-bionic-reading">What is Bionic Reading?</h3>

<p>Bionic Reading is a reading method designed to make it easier and faster to comprehend text by guiding the reader’s eyes through bolded initial letters of words. This technique emphasizes the beginning of each word, allowing the brain to “fill in” the rest of the word and phrase intuitively, leveraging cognitive shortcuts.</p>

<p><strong>A</strong>s <strong>sho</strong>wn <strong>i</strong>n <strong>th</strong>is <strong>sent</strong>ence, <strong>t</strong>he <strong>bol</strong>ded <strong>init</strong>ial <strong>lett</strong>ers <strong>o</strong>f <strong>ea</strong>ch <strong>wo</strong>rd <strong>a</strong>re <strong>us</strong>ed <strong>t</strong>o <strong>gui</strong>de <strong>t</strong>he <strong>read</strong>er’s <strong>ey</strong>es <strong>thro</strong>ugh <strong>t</strong>he <strong>te</strong>xt, <strong>mak</strong>ing <strong>i</strong>t <strong>eas</strong>ier <strong>t</strong>o <strong>compr</strong>ehend.</p>

<h3 id="why-this-matters-for-adhd-readers">Why This Matters for ADHD Readers</h3>

<p>As someone with severe ADHD, I found that traditional reading methods often made it difficult to maintain focus and comprehension when reading dense academic papers. The combination of bionic reading and color-coded part-of-speech highlighting has significantly improved my reading process, making it easier to focus on and comprehend text.</p>

<p>The plugin allows you to:</p>
<ul>
  <li>Highlight <strong>verbs</strong> in one color (which serve as important memory anchors)</li>
  <li>Highlight <strong>nouns</strong> in another color</li>
  <li>Highlight <strong>conjunctions</strong> to help identify paragraph structure</li>
  <li>Use <strong>bionic reading</strong> to guide your eyes through the text</li>
</ul>

<h2 id="technical-implementation-and-limitations">Technical Implementation and Limitations</h2>

<p>This plugin uses the <strong>compromise</strong> package for part-of-speech recognition. Due to the limitations of this package, which doesn’t support syntactic parsing of grammatical structures, it may not accurately identify various gerunds, verb transformations, etc.</p>

<p>While other larger NLP packages might offer better parsing accuracy, they are constrained by Zotero’s extension installation environment. For example, Stanford’s Stanza package would require mounting a server on the system, making it complex to install and call from Zotero, and it would process PDFs much more slowly.</p>

<p>I have also experimented with Wink NLP, but found that its parsing results were not significantly different from compromise. Consequently, this package’s verb recognition is not perfectly accurate and may include some omissions or incorrect annotations. However, the verbs that are highlighted still generally provide important information. I believe they remain crucial parts of sentences, and readers should be able to understand entire sentences by focusing primarily on these highlighted verbs.</p>

<h2 id="installation">Installation</h2>

<ol>
  <li>Download the plugin (.xpi file) from the <a href="https://github.com/DrUsagi/Colorful-Bionic/releases">GitHub releases page</a>
    <ul>
      <li><a href="https://github.com/DrUsagi/Colorful-Bionic/releases/latest">Latest Stable Release</a></li>
      <li><a href="https://github.com/DrUsagi/Colorful-Bionic/releases">All Releases</a></li>
    </ul>

    <p><em>Note</em>: If you’re using Firefox as your browser, right-click the <code class="language-plaintext highlighter-rouge">.xpi</code> and select “Save As..”</p>
  </li>
  <li>
    <p>In Zotero, click <code class="language-plaintext highlighter-rouge">Tools</code> in the top menu bar and then click <code class="language-plaintext highlighter-rouge">Plugins</code></p>
  </li>
  <li>
    <p>Go to the Extensions page and then click the gear icon in the top right</p>
  </li>
  <li>
    <p>Select <code class="language-plaintext highlighter-rouge">Install Add-on from file</code></p>
  </li>
  <li>
    <p>Browse to where you downloaded the <code class="language-plaintext highlighter-rouge">.xpi</code> file and select it</p>
  </li>
  <li>Finish!</li>
</ol>

<h2 id="quick-start">Quick Start</h2>

<ol>
  <li>Open a PDF in the Zotero reader</li>
  <li>The PDF will be displayed in bionic reading mode by default</li>
  <li>To toggle bionic reading mode and other features, use the <code class="language-plaintext highlighter-rouge">Bio</code> menu in the top menu bar or the BIO button in the toolbar</li>
  <li>You can highlight verbs and nouns in different colors to enhance comprehension</li>
</ol>

<h2 id="personal-usage-recommendations">Personal Usage Recommendations</h2>

<p>Based on my personal experience, I recommend:</p>
<ul>
  <li>Enabling black Bionic text and verb highlighting</li>
  <li>Using verbs as memory anchors in sentences can significantly improve reading speed for individuals with ADHD</li>
  <li>Highlighting only verbs keeps the text clean and less visually overwhelming</li>
  <li>Setting nouns to gray color can further emphasize the distinction between nouns and verbs</li>
  <li>Enabling conjunction highlighting can also enhance the reading experience, as longer yellow-highlighted conjunctions (such as “however”, “in addition”, etc.) often serve as important markers that help you understand paragraph structure and content flow</li>
</ul>

<h2 id="features">Features</h2>

<h3 id="v11-latest-release">v1.1 (Latest Release)</h3>

<p><strong>New Features and Improvements:</strong></p>
<ul>
  <li><strong>Enhanced UI</strong>: Redesigned BIO button display to show active features with their respective colors (V for verbs, N for nouns, C for conjunctions, P for punctuation)</li>
  <li><strong>Color Memory</strong>: Colors are now saved per document, allowing different PDFs to have custom color settings</li>
  <li><strong>Improved Menu Positioning</strong>: Menu now appears to the left of the BIO button to avoid overlapping with the sidebar</li>
  <li><strong>Punctuation Enhancement</strong>: Added bold punctuation feature with size adjustment and color highlighting, making it easier to identify sentence boundaries</li>
  <li><strong>Expanded Color Options</strong>: More color choices are now available for each part of speech highlighting</li>
  <li><strong>Sentence Boundary Recognition</strong>: Enhanced comma and period highlighting helps readers better identify sentence structures and boundaries</li>
  <li><strong>State Persistence</strong>: All settings are now properly saved and restored per document</li>
  <li><strong>Visual Indicator</strong>: BIO button now shows status indicators with appropriate styling based on active features</li>
</ul>

<h2 id="why-bionic-reading-worksdoesnt-work">Why Bionic Reading Works/Doesn’t Work?</h2>

<p>The effectiveness of Bionic Reading is a subject of ongoing debate, largely because it depends on individual differences in reading habits, cognitive processing, and preferences. While research is still evolving, many users (especially those with ADHD) report significant improvements in reading speed and comprehension.</p>

<p>Want to know more? Check out the latest research on <a href="https://scholar.google.com/scholar?q=bionic+reading">Google Scholar</a>.</p>

<h2 id="development">Development</h2>

<p>This plugin is built based on the <a href="https://github.com/windingwind/zotero-plugin-template">Zotero Plugin Template</a>.</p>

<p>To contribute or build from source:</p>

<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>git clone https://github.com/DrUsagi/Colorful-Bionic.git
<span class="nb">cd </span>Colorful-Bionic
npm <span class="nb">install
</span>npm run build
</code></pre></div></div>

<p>The plugin is built to <code class="language-plaintext highlighter-rouge">./builds/*.xpi</code>.</p>

<h2 id="open-source">Open Source</h2>

<p>Colorful Bionic is released under the <strong>AGPL-3.0 license</strong> and is available on <a href="https://github.com/DrUsagi/Colorful-Bionic">GitHub</a>. Contributions, issues, and pull requests are welcome!</p>

<h2 id="acknowledgements">Acknowledgements</h2>

<p>Colorful Bionic is a modified version based on the <a href="https://github.com/windingwind/zotero-bionic-reading">Bionic for Zotero</a> plugin developed by <a href="https://github.com/windingwind">windingwind</a>. Special thanks to windingwind for his contribution and pioneering work, which made this enhanced version possible. While the original plugin provides basic Bionic reading functionality, this version adds features like colorful part-of-speech highlighting.</p>

<h2 id="try-it-out">Try It Out!</h2>

<p>If you’re a researcher, student, or anyone who reads academic papers and struggles with focus or reading speed, I encourage you to try Colorful Bionic. It’s particularly helpful if you have ADHD or other attention-related challenges. The plugin is free, open-source, and actively maintained.</p>

<p>Visit the <a href="https://github.com/DrUsagi/Colorful-Bionic">GitHub repository</a> to download, install, and start improving your reading experience today!</p>

<hr />

<p><em>Have questions or feedback? Feel free to open an issue on <a href="https://github.com/DrUsagi/Colorful-Bionic/issues">GitHub</a> or reach out!</em></p>]]></content><author><name>Shaohui Wang</name><email>swang83@gsu.edu</email></author><category term="Tools" /><category term="Research" /><category term="Zotero" /><category term="ADHD" /><category term="Reading" /><category term="Productivity" /><category term="Open Source" /><summary type="html"><![CDATA[I’m excited to introduce Colorful Bionic, a Zotero plugin I developed that implements a colorful bionic reading experience in the Zotero reader. This plugin is particularly helpful for individuals with ADHD, as it can significantly improve reading speed and focus when reading academic papers.]]></summary></entry></feed>