Ghost Release: 1.8.1

TL;DR

Ghost 1.8.1: Performance Improvements and Bug Fixes

This minor release focuses on reducing redirects in the admin interface, improving the scheduler functionality, and fixing several rendering issues. The update replaces outdated dependencies with modern alternatives and optimizes how Ghost handles URL redirects and HTML rendering. These changes improve performance and reliability without introducing breaking changes.

Highlight of the Release

• Reduced redirects when accessing the Ghost admin interface
• Improved scheduler with caching, debug logs, and custom timeout support
• Fixed mobiledoc DOM rendering for markdown content with complex HTML
• Replaced deprecated request library with got for image size detection
• Updated documentation URLs to remove outdated version references

Migration Guide

No migration steps are required for this minor release. The changes are backward compatible and should work seamlessly after updating to version 1.8.1.

Upgrade Recommendations

This is a minor release with performance improvements and bug fixes. It's recommended for all users to upgrade to Ghost 1.8.1, especially if you:

• Use the admin interface regularly and want faster access
• Work with scheduled posts
• Create content with complex markdown and HTML
• Have experienced issues with the "active" state display in the apps section

The upgrade process should be straightforward with no breaking changes reported.

Bug Fixes

Fixed Admin UI Issues

• Fixed the "active" state display of apps on the apps index screen (TryGhost/Admin#843)

Fixed Mobiledoc DOM Rendering

• Re-instated mobiledoc DOM rendering with a bypass of SimpleDOM parsing (fixes #8757)
• Updated the markdown card render method to use SimpleDOM's createRawHtmlSection
• This avoids SimpleDOM parsing and tokenization issues with broken or unsupported free-form HTML that markdown allows
• Replaced markdown extraction/rendering with mobiledoc's renderer in the Post model

New Features

Enhanced Scheduler Functionality

The scheduler component received several improvements:

• Added caching logic to adapter creation (similar to storage adapters)
• Added debug logs to the default scheduler for better troubleshooting
• Added requestTimeout parameter to support custom timeouts
• Implemented isRunning logic to prevent the scheduler from running twice simultaneously

Streamlined Admin Redirects

Ghost now handles admin redirects more efficiently:

• Previously: Users were redirected from example.com/ghost to admin.example.com/ghost and then to /ghost/ (two redirects)
• Now: Users are redirected directly from example.com/ghost to admin.example.com/ghost/ (single redirect)

Security Updates

No specific security fixes were mentioned in this release.

Performance Improvements

Reduced Redirects

The admin interface now requires fewer redirects when accessing Ghost admin:

• Eliminated unnecessary redirect from /ghost to /ghost/
• This results in faster admin interface loading times

Improved Image Size Detection

• Replaced the deprecated request library with the more modern got library for image size detection
• Simplified handling for request cases like timeouts and redirect following
• More efficient processing of images in content

Enhanced Scheduler Performance

• Added caching logic to scheduler adapter creation
• Prevents duplicate scheduler instances from running simultaneously
• More efficient resource utilization

Impact Summary

Ghost 1.8.1 is a maintenance release that focuses on performance optimizations and bug fixes. The most notable improvements include reduced redirects when accessing the admin interface, enhanced scheduler functionality, and fixed rendering issues with markdown content.

The update to the image size detection mechanism by replacing the deprecated request library with got provides more reliable handling of images. The fix for mobiledoc DOM rendering addresses issues with complex HTML in markdown content, which is particularly beneficial for content creators who use advanced formatting.

For administrators, the streamlined redirect process means faster access to the admin interface, and the fixed "active" state display in the apps section improves the user experience. Developers will appreciate the improved scheduler with better debugging capabilities and the ability to set custom timeouts.

Overall, this release enhances the stability and performance of Ghost without introducing breaking changes, making it a recommended upgrade for all users.

Full Release Notes