Repository navigation
Releases
ByteByteGo Reference Linker v1.7.5
What's New (v1.7.5)
Test release for update checks
- Validate autoupdate toast against a new release entry
- Exercise changelog-driven release notes pipeline
- Dummy release for end-to-end verification
Release Notes (auto)
Full Changelog: v1.7.4...v1.7.5
ByteByteGo Reference Linker v1.7.4
What's New (v1.7.4)
Stabilize navigation and changelog release notes
- Improve up/down navigation reliability across dynamic pages
- Ensure release notes pull from repository changelog with badge install link
- Automated bump and publish workflows run end-to-end from main
Release Notes (auto)
Full Changelog: v1.7.3...v1.7.4
ByteByteGo Reference Linker v1.7.3
Full Changelog: v1.7.2...v1.7.3
ByteByteGo Reference Linker v1.7.2
Full Changelog: v1.7.1...v1.7.2
ByteByteGo Reference Linker v1.7.0
Full Changelog: v1.6.2...v1.7.0
v1.6.2 - Up Arrow Navigation Completely Fixed!
🎯 Complete Fix for Up Arrow Navigation
This release completely rewrites the up arrow navigation system to be 100% reliable!
What Was Wrong (Technical Deep Dive)
The previous implementation had a fundamental flaw:
// OLD APPROACH ❌
referenceLinkLocations.set(num, domElement);
// Later...
domElement.scrollIntoView(); // Element might be invalid!Problems:
- Stored DOM element references in a Map
- These became stale when MutationObserver re-ran
- Elements could be detached or replaced
- Map could be cleared, losing all references
The New Architecture ✅
// NEW APPROACH ✅
wrapper.setAttribute('data-ref-link', num);
// Later...
const element = document.querySelector(`[data-ref-link="${num}"]`);
element.scrollIntoView(); // Always finds the current element!Benefits:
- Uses
data-ref-linkattribute on each reference wrapper - Dynamically queries for elements when needed
- No stale references - always finds current DOM element
- Survives all page mutations and changes
- Added console warnings for debugging
🔧 What's Fixed
✅ Up arrows (↑) now work 100% of the time
✅ No more "sometimes works, sometimes doesn't"
✅ Survives dynamic page content changes
✅ Works after MutationObserver runs
✅ Console warnings if reference not found
📦 Update Now!
Tampermonkey will detect this is v1.6.2 and prompt you to reinstall.
🧪 How to Test
- Go to any ByteByteGo article with references
- Scroll down to the References/Resources section
- Click any up arrow (↑)
- It should scroll to the reference in the article and highlight it
- Works every single time! 🎉
🐛 Still Having Issues?
If up arrows still don't work:
- Open browser console (F12)
- Look for warnings like:
[ByteByteGo Refs] Could not find reference [X] in article - This means the reference
[X]doesn't exist in the article text - Report the issue with the article URL
📊 Technical Changes
- Added
data-ref-linkattribute to reference wrappers - Both
.ref-lineand<ol>implementations updated - Dynamic element lookup on every click
- Removed dependency on DOM element storage
- Better error handling with console warnings
This is the definitive fix for up arrow navigation! 🚀
v1.6.1 - Bug Fixes for Navigation
🐛 Bug Fixes
Navigation Improvements
- Fixed up arrow (↑) navigation: Up arrows in the References section now properly scroll back to where references are mentioned in the article
- Fixed missing up arrows: Up arrows now consistently appear for all references
- Improved stability: Better handling when page content changes dynamically
Update Notifications
- Fixed toast not showing: Update notification now properly displays when the script updates
- Added v1.6.1 changelog: Toast shows the latest improvements
🔧 Technical Changes
- Don't clear
referenceLinkLocationsduring mutations to preserve navigation targets - Added
data-ref-processedmarker to prevent duplicate processing - Improved MutationObserver handling for dynamic content
- More reliable reference link tracking across page changes
📦 How to Update
Automatic Updates (Recommended):
- Tampermonkey automatically checks for updates using the
@updateURL - Go to Tampermonkey Dashboard → Settings
- Enable "Check for updates" (usually on by default)
- Script will auto-update within 24 hours
Manual Update:
- Click: Update Now
- Tampermonkey will detect this is an update
- Click "Reinstall"
✨ What's Working Now
- ✅ Up arrows (↑) in References scroll back to article mentions
- ✅ Preview cards show on hover with OG images
- ✅ Down arrows (↓) scroll to References section
- ✅ Bidirectional navigation between article and references
- ✅ Update notifications appear after each update
If you're still experiencing issues, try:
- Hard refresh the ByteByteGo page (Ctrl+F5 or Cmd+Shift+R)
- Disable and re-enable the script in Tampermonkey
- Clear browser cache
Thanks for using ByteByteGo Reference Linker! 🚀
v1.6.0 - Compact Preview Cards & Update Notifications
🎉 What's New
🎨 Redesigned Preview Cards
- Compact & Beautiful: Max 400px width, professional design inspired by Discord/Slack
- Real OG Images: Automatically fetches and displays OpenGraph images from referenced URLs
- Adaptive Layout: Shows image only if available, compact mode otherwise
- Better URL Display: Proper truncation with ellipsis, no more overflow
- High-Quality Icons: 32px site icons using icon.horse service
🔔 Update Notification System
- Toast Notifications: See what's new after each update
- Version Changelog: Detailed list of changes
- Smart Detection: Shows only once per update using localStorage
- Auto-Dismiss: Automatically hides after 10 seconds
- Beautiful Animation: Smooth slide-up effect
⬆️ Bidirectional Navigation (from v1.5.0)
- Up arrows in References section to jump back to article
- Visual highlight when scrolling to references
- Works with all reference formats
🔧 Technical Improvements
- Cross-origin requests for OG image fetching
- Async image loading (doesn't block card display)
- Preload validation before showing images
- Better error handling for failed requests
- Version tracking system
📦 Installation
Your Tampermonkey will automatically detect this is an update and install it.
💡 Usage Tips
- Hover over any reference
[n]to see the preview card - Cards show OpenGraph images when available
- Click Open to visit the URL or Scroll to see the reference
- Use ↑ arrows in References section to jump back to article
Enjoy the improved experience! 🚀