stefano/BSSG
stefano/BSSG
11
11
Fork 8
Code Issues 14 Pull requests 3 Projects Releases 16 Packages Wiki Activity Actions

16 releases 17 tags

RSS feed
  • 0.20.0 e8c98d10ab

    0.20.0 Stable

    stefano released this 2025-05-25 19:34:58 +02:00 | 25 commits to main since this release

    Key Highlights in 0.20.0

    1. Introducing the BSSG Post Editor (bssg-editor.html)

    The star of this release is the brand-new BSSG Post Editor! This is a complete, standalone post editor that runs entirely in your browser as a single HTML file (bssg-editor.html), requiring no backend or complex setup.

    Key features of the BSSG Post Editor include:

    • Ghost-like Interface: Enjoy a modern, clean, split-pane interface with a Markdown editor on one side and a live preview on the other.
    • Complete Frontmatter Support: Easily manage all BSSG frontmatter fields: title, date, lastmod, tags, slug, description, image, and image_caption.
    • Unsplash Integration: Browse and select stunning featured images directly from Unsplash, with automatic, proper attribution for the image_caption.
    • Smart Auto-Save: Never lose your work with multiple auto-save triggers: every 10 words typed, after 5 seconds of inactivity, plus manual save.
    • Article Management: A local storage-based system lets you save, load, search, and delete your articles directly within the editor.
    • Rich Markdown Toolbar: A comprehensive formatting toolbar provides quick access to headers, lists, bold, italics, links, images, code blocks, quotes, and more.
    • Keyboard Shortcuts: Boost your productivity with full keyboard shortcut support (e.g., Ctrl+B for bold, Ctrl+I for italic, Ctrl+S to save).
    • Theme Support: Toggle between dark and light themes, with automatic detection of your system preference.
    • Focus Mode: Minimize distractions and concentrate on your writing.
    • Versatile Export Options: Export your posts as BSSG-compatible .md files (with correct naming conventions), copy Markdown to your clipboard, or import existing Markdown files.
    • Responsive Design: The editor works beautifully across desktop, tablet, and mobile devices. (Not perfect on mobile, yet)
    • Offline Capable: Being a single HTML file, it runs entirely in the browser and works offline.
    • Seamless BSSG Integration: Generates Markdown files with proper frontmatter and file naming conventions ready for BSSG.

    The BSSG Post Editor is designed to make content creation for your BSSG site intuitive, efficient, and enjoyable.

    2. Enhanced Local Development Server (./bssg.sh server)

    The experimental local development server introduced previously is now an official and enhanced feature!

    • The ./bssg.sh server command builds your static site and then starts an HTTP server to serve your output/ directory.
    • Dynamic SITE_URL Override: When initiating a build, the server command temporarily sets the SITE_URL to match the local server's address (e.g., http://localhost:8000). This ensures all links and asset paths are correct for local previewing without needing to change your production SITE_URL.
    • Improved Performance with socat: The server now prefers socat if available, enabling concurrent request handling. This means faster loading of pages with multiple images and a more reliable preview experience. netcat serves as a fallback, with a warning about its single-threaded limitations.
    • Configurable Defaults: You can now set default port and host for the server in your config.sh (or override in config.sh.local) using BSSG_SERVER_PORT_DEFAULT and BSSG_SERVER_HOST_DEFAULT. These defaults are also shown in the help message.
    • Command-line Options:
      • --port <PORT>: Specify a custom port.
      • --host <HOST>: Specify a custom host/IP.
      • --no-build: Skip the build step and serve existing output/ content.

    3. Under-the-Hood Improvements

    • The main bssg.sh script has been updated to incorporate the server command logic, robust argument parsing, and informative help text.
    • scripts/build/config_loader.sh now loads and exports the new server default configuration variables.
    • config.sh includes the new default server configuration variables.

    4. Community Contributions & Fixes

    This release also incorporates several important fixes and refinements, making BSSG more robust and reliable. A special thank you goes out to the great people from our community who contributed their time and expertise to help identify and resolve issues. Your contributions are invaluable!

    Downloads