Ghost Release: 1.24.8

TL;DR

Ghost 1.24.8: Bug Fixes and Koenig Editor Improvements

This release focuses on fixing critical bugs affecting AMP pages and Disqus comments, while also enhancing the Koenig editor beta with improved heading tag rendering and URL handling. Additionally, a new development option has been added to reduce CPU usage during client-only development.

Highlight of the Release

• Fixed Disqus comments on post preview pages to prevent cross-posting issues
• Added --no-server-watch option to grunt-dev reducing idle CPU usage from 20% to 0%
• Fixed 404 errors when accessing AMP versions of posts with 'amp' in their slugs
• Added ID attributes to heading tags in Koenig editor for improved navigation
• Added support for schema-less URLs in Koenig embed cards

Migration Guide

No migration steps are required for this release. This is a maintenance release with bug fixes and minor enhancements that should not affect existing functionality.

Upgrade Recommendations

This release contains important bug fixes for AMP pages and Disqus comments integration, along with improvements to the Koenig editor beta. We recommend all users upgrade to this version, especially if you:

• Use AMP pages on your site
• Have Disqus comments enabled
• Are testing the Koenig editor beta
• Develop Ghost themes or extensions

The upgrade process should be straightforward with no breaking changes or migration steps required.

Bug Fixes

Fixed AMP Page Rendering

• Fixed 404 errors when accessing AMP versions of posts with 'amp' in their slug
• Modified the URL matching in the AMP router to only match /amp or /amp/ at the end of URLs
• Prevents false positives when 'amp' appears elsewhere in the URL path

Fixed Disqus Comments

• Fixed issues with Disqus comments on post preview pages
• Prevents comments from appearing on incorrect threads
• URL helper now outputs post preview URL for draft/scheduled posts
• Ensures unique page URLs at Disqus to maintain thread uniqueness

Koenig Editor Fixes

• Added support for schema-less URLs in embed cards
• Adjusted the "base url" regex in the oembed endpoint to strip schemaless scheme // as well as https?://

Documentation Fix

• Removed extra * from the JSDoc of the handlePermissions function in server/api/utils

New Features

New Development Option

• Added --no-server-watch option to grunt-dev command
  • Skips watching server and theme files during development
  • Reduces idle CPU usage from 20% to 0%
  • Particularly useful for client-only development to save battery power

Koenig Editor Improvements

• Added ID attributes to heading tags when rendering
  • New DomModifier class to walk and modify SimpleDom documents
  • Automatically converts heading tag content to dasherized strings for ID attributes
  • Handles duplicate IDs by adding -1, -2 suffixes as needed
  • Improves navigation and linking capabilities within posts

Security Updates

No security fixes were included in this release.

Performance Improvements

Development Performance

• New --no-server-watch option for grunt dev command significantly reduces resource usage
  • Cuts idle CPU usage from 20% to 0% when enabled
  • Improves battery life during client-only development
  • Command usage: grunt dev --no-server-watch

Rendering Optimizations

• Improved the AMP router's URL handling efficiency
• Enhanced SimpleDom document processing with the new DomModifier class
• Switched top-level var declarations to ES6 in Koenig editor components

Impact Summary

Ghost 1.24.8 is primarily a maintenance release that addresses several important bugs and adds quality-of-life improvements for developers and content creators.

The most significant fixes address issues with AMP page rendering for posts containing 'amp' in their slugs and problems with Disqus comments on preview pages. These fixes ensure better compatibility and user experience for sites using these features.

For developers, the new --no-server-watch option provides a substantial performance improvement during development, reducing CPU usage and extending battery life during client-only work.

The Koenig editor beta continues to mature with improvements to heading tag rendering (adding ID attributes) and better support for schema-less URLs in embed cards, enhancing the editing experience for content creators.

Overall, this release represents incremental but important improvements to Ghost's stability and usability without introducing breaking changes.

Full Release Notes