Ghost Release: 1.0.0-alpha.7

TL;DR

Ghost 1.0.0-alpha.7 brings significant improvements to the logging system, a more decoupled client-server architecture, and enhanced editor capabilities. This alpha release focuses on refining the platform's core functionality with better logging configuration options, a new public configuration endpoint, and editor enhancements like slash menu and code block support. While strictly for development and testing purposes, this release represents important progress toward the stable 1.0.0 version.

Highlight of the Release

• Comprehensive logging improvements with configurable rotation and better file organization
• New public configuration endpoint for better client-server separation
• Ghost Editor updates including slash menu, soft returns, and code block support
• Fixed timezone-related issues that were causing startup errors
• Multiple dependency updates and bug fixes

Migration Guide

No specific migration steps are required for this alpha release. However, developers should note:

• If you've been manually configuring logging, review the new logging parameters as the system has been significantly refactored
• If your Ghost theme or custom code directly accessed configuration from the HTML meta tags, you'll need to update to use the new configuration endpoint
• The logs folder structure has changed, with logs now being stored in the content/logs directory

Upgrade Recommendations

As this is an alpha release (1.0.0-alpha.7), it is strictly for development and testing purposes only. Do not use this version for production blogs.

If you're already testing previous alpha versions, upgrading to this version is recommended to test the improved logging system and editor enhancements.

For production sites, continue using the latest stable release or the LTS version (0.11) as outlined in the LTS blog post.

Bug Fixes

• Fixed missing schedulerUrl option that was accidentally deleted during config module refactoring
• Fixed Daylight Saving Time (DST) issues in listeners spec by calculating timezone offset dynamically
• Fixed timezone-related errors where users were seeing "Cannot read property 'zone' of undefined" when starting Ghost
• Now properly requiring moment-timezone when using timezone features

New Features

Improved Logging System

• Configurable Log Rotation: Every parameter is now configurable with increased default number of files to 100
• Smart Log File Naming: Log files now use domain-based naming (e.g., content/logs/http___my_ghost_blog_com_ghost.log)
• Custom Path Configuration: Users can set custom log paths via logging.path
• Multiple Log Files: System now logs to separate files by default:
  • content/logs/domain.error.log for errors only
  • content/logs/domain.log for all logs
• Better Log Formatting: Improved PrettyStream with cleaner output and generic handling
• Middleware for Logging: Added dedicated middleware for handling logs

Public Configuration Endpoint

• Ghost-Admin now requests configuration from an API endpoint instead of having it embedded in HTML
• Improved separation between client and server components
• Added client credentials to configuration endpoint

Ghost Editor Enhancements

• Slash Menu: Added command menu triggered by typing "/"
• Soft Return Support: Added ability to create line breaks without paragraph breaks
• Code Block Support: Added triple backtick (```) support for code blocks
• Updated Toolbars: Improved editor toolbar functionality
• Enhanced Link Functionality: Better handling of links in the editor
• Performance Improvements: General editor performance optimizations

Security Updates

No specific security fixes were mentioned in this release.

Performance Improvements

• Ghost Editor performance optimizations for smoother editing experience
• Improved logging system with more efficient handling of log streams
• Better client-server separation with the configuration endpoint reducing initial load time

Impact Summary

This alpha release represents significant progress toward Ghost 1.0.0 with improvements focused on developer experience and content creation. The logging system overhaul provides better diagnostics and configuration options, while the new public configuration endpoint further separates client and server concerns, making the platform more modular. Content creators will appreciate the editor enhancements that improve the writing experience.

The fixes for timezone-related issues address problems that were causing startup failures for some users. While this is still an alpha release not intended for production use, it demonstrates Ghost's continued evolution toward a more robust, flexible publishing platform with improved architecture and user experience.

Full Release Notes