Release 3.0.0
Release Notes
Gemtexter 3.0.0 introduces a comprehensive theming system, enhanced HTML styling capabilities, and improved project organization. This major release focuses on customization, visual improvements, and better user experience.
🎨 New Features
Theme System
- Custom HTML themes: Configure different visual styles for your static sites using the new
HTML_THEME_DIRconfiguration option - Built-in themes: Three ready-to-use themes included - Simple, Business, and Future
- Easy customization: Copy and modify existing themes to create your own unique designs
Enhanced HTML Output
- Advanced typography: New font families including Abril Fatface, Lato, and improved font organization
- Source code highlighting: Enhanced syntax highlighting with GNU Source Highlight CSS styles, including the vampire theme for darker aesthetics
- Table of Contents generation: Automatic ToC creation with proper HTML anchors and cross-references
- Improved styling: Better visual hierarchy, spacing, and color schemes across all themes
Content Management
- Zero JavaScript philosophy: All generated sites remain completely JavaScript-free while providing rich functionality
- Mastodon verification: Built-in support for social media verification with proper
rel='me'attributes
🔧 Improvements
Project Organization
- Restructured font directory: All fonts moved to organized subdirectories for better management
- Cleaner configuration: Removed deprecated configuration files and streamlined setup options
- Better file organization: Improved directory structure for themes and assets
Performance & Reliability
- Enhanced caching: Improved generation speed with better caching mechanisms
- Robust HTML validation: Better XHTML 1.0 Transitional compliance and validation support
- Improved template processing: More reliable multiline template handling and evaluation
🚨 Breaking Changes
Removed Features
- Deprecated HTML variant: The previous default HTML styling has been removed in favor of the new theme system
- Configuration cleanup: Several old configuration files have been removed (
gemtexter-paul.buetow.org.conf,gemtexter-snonux.land.conf)
Migration Required
- Theme configuration: If you were using custom CSS, you'll need to migrate to the new theme system by configuring
HTML_THEME_DIR - Font paths: Custom font references may need updating due to the reorganized font directory structure
🐛 Bug Fixes
- Fixed HTML encoding issues in lists and links
- Improved markdown ToC generation with proper internal link IDs
- Better handling of inline code formatting in HTML output
- Resolved atom feed validation issues
📚 Documentation
- Updated README with comprehensive theming documentation
- Added examples for ToC generation and template usage
- Improved configuration file documentation
- Added GNU Source Highlight style examples and licensing information
🎯 Technical Details
- Enhanced template engine with better variable handling
- Improved CSS organization and maintainability
- Better separation of concerns between content and presentation
- Streamlined build process and dependency management
This release represents a significant step forward in Gemtexter's evolution, providing users with powerful customization options while maintaining the simplicity and performance that makes it an excellent choice for static site generation from Gemtext content.