Download Latest Version openpublisher5g_amd64-windows.exe (81.1 MB)
Home / 5.19.3
Name Modified Size InfoDownloads / Week
Parent folder
OpenPublisher5-i386-windowsXP.exe 2026-11-08 56.5 MB
openpublisher5_amd64-windows-portable.exe 2026-11-08 183.2 MB
openpublisher5_amd64-windows.exe 2026-11-08 165.2 MB
openpublisher5_amd64-macos.dmg 2026-11-08 233.1 MB
openpublisher5_amd64-linux.run 2026-11-08 193.4 MB
openpublisher5_amd64-linux.rpm 2026-11-08 215.4 MB
openpublisher5_amd64-linux.flatpak 2026-11-08 153.6 MB
openpublisher5_amd64-linux.deb 2026-11-08 156.2 MB
openpublisher5_amd64-linux.AppImage 2026-11-08 166.4 MB
openpublisher5_amd64-freebsd.pkg 2026-11-08 185.5 MB
5.19.3_ Header, Footer _ Master Page Undo Displacement Fix, Safe Master Page Removal _ Ribbon Controls source code.tar.gz 2026-11-08 103.6 MB
5.19.3_ Header, Footer _ Master Page Undo Displacement Fix, Safe Master Page Removal _ Ribbon Controls source code.zip 2026-11-08 104.1 MB
README.md 2026-11-08 7.4 kB
Totals: 13 Items   1.9 GB 0

πŸ“‹ Summary

Version 5.19.3 resolves an issue where enabling Headers and Footers or adding a Master Page could not be cleanly disabled or deleted, and pressing Undo (Ctrl+Z) inadvertently converted the user's entire document onto the Master Page instead of removing the Master Page as expected.

This release introduces comprehensive document structure tracking across history snapshots, provides a dedicated safe Master Page removal system that protects single-page and multi-page publications from content loss, adds responsive Header & Footer ribbon toggle buttons with active state indicators across both the Insert and Page Design tabs, and synchronizes all asset cachebusters and the Service Worker to v5.19.3.

op-HeaderFooterAndMasterPageUndoDisplacementFixAndSafestRemoval


πŸš€ Problems Solved & Root Cause Analysis

1. Document Displacement on Undo (Ctrl+Z)

  • The Issue: When users added a Master Page or enabled Header & Footer and subsequently pressed Undo (Ctrl+Z), the application reduced the page count from 2 to 1, but left state.hasMasterPage = true. As a result, Page 0 (the user's restored document) remained designated as the Master Page, causing standard document content to be trapped as a master template and headers/footers to become unremovable.
  • Root Cause:
  • core/history.js snapshots only stored { pages, idx, isSpreadMode }. The critical structural flags hasMasterPage and headersVisible were omitted.
  • The history spam filter in extensions/system-patches.js only checked whether paper.innerHTML changed. When a blank Master Page was added, innerHTML appeared identical to the blank page before it, causing the Master Page state snapshot to be skipped.
  • addMasterPage() in core/pages.js unshifted a new page into state.pages[0] before ensuring the pre-master document state was flushed to the history stack.
  • Resolution:
  • core/history.js: Added hasMasterPage and headersVisible to all history snapshots and restoreSnapshot() routines. When restoring an earlier state, master page designation and header visibility are restored accurately, calling toggleHeaderFooter(state.headersVisible, true), renderPage(), and updateSidebar().
  • extensions/system-patches.js: Updated flushHistory() and pushHistory() to monitor structural changes (pages.length, hasMasterPage, headersVisible, and currentPageIndex), ensuring additions and toggles are never suppressed.
  • core/pages.js: Updated addMasterPage() to flush pending edits before unshifting the master page, and immediately record the new master state in history.

2. Safe Master Page Removal

  • The Issue: Previously, deleting Page 0 when a Master Page was active executed standard deletePage(), which spliced index 0 from state.pages. In publications with only one user page, deleting the master page emptied the array and triggered addNewPage(), completely wiping the user's publication.
  • Resolution:
  • Implemented removeMasterPage(skipConfirm = false) in core/pages.js.
  • In multi-page publications, the Master Page is cleanly spliced out, adjusting state.currentPageIndex and switching to the user's first document page.
  • In single-page publications (where only one page exists), the page is safely retained and converted to a normal document page, resetting its ID and preserving all user elements.
  • Clicking the delete button (X) on the Master Page thumbnail or choosing "Delete Page" from the minimap context menu automatically delegates to removeMasterPage() with a clear confirmation dialog ("Are you sure you want to remove the Master Page? Its repeated headers, footers, and elements will be removed from all pages.").
  • Minimap context menu for the Master Page now explicitly displays "Remove Master Page" with a dedicated handler (contextRemoveMasterPage()).

  • Insert Ribbon Button: Added a dedicated Header & Footer button to the Insert ribbon under the Text group (id="ribbon-insert-hf-btn"), allowing quick access when drafting documents.
  • Page Design Ribbon Button: Updated the existing Layout group button to id="ribbon-design-hf-btn" with consistent labeling and tooltips.
  • Visual Active Indicators: Both ribbon buttons feature .active styling that lights up with theme accents when headers and footers are visible, providing clear visual feedback on whether the feature is active.
  • Clean Toggle & Undo: Calling toggleHeaderFooter() cleanly shows or hides headers and footers and records a history snapshot, allowing users to enable or disable them at will or undo the toggle instantly.

4. File Persistence & Loader Synchronization

  • Updated io/file-io.js and extensions/system-patches.js to persist headersVisible: state.headersVisible || false into .opub files.
  • Updated io/publisher-file-loader.js to restore state.headersVisible upon opening files and automatically apply visibility without triggering extra history pushes.

πŸ”„ Version Synchronization (v5.19.3)

Component Target Version Updated Reference
Service Worker v5.19.3 open-publisher-v5-19-3-1 in sw.js
About Dialog v5.19.3 Free Online Desktop Publishing Tool β€’ v5.19.3 in extensions/ui-interactions.js
UI Interactions Header v5.19.3 Header documentation in extensions/ui-interactions.js
PWA Installer v5.19.3 Registration query sw.js?v=5.19.3 in extensions/pwa-install.js
Application Cachebusters v5.19.3 All 98 script and stylesheet links updated to ?v=5.19.3 in index.html
Dashboard Controller v5.19.3 Template asset cachebusters updated to ?v=5.19.3 in ui/dashboard.js
Template Asset Loaders v5.19.3 getTemplateAssetUrl updated to ?v=5.19.3 in elements/templates/templates.js
README Documentation v5.19.3 Badge asset cachebusters updated to ?v=5.19.3 in README.md

βœ… Checklist Completed

  • [x] Fix Master Page undo bug so user document content remains on normal Page 1 without being converted into a master template
  • [x] Record hasMasterPage and headersVisible in history snapshots and restore cleanly on undo and redo
  • [x] Implement structural tracking in history debounce filter to prevent skipping blank master page additions
  • [x] Implement dedicated removeMasterPage() method with safety protection for single-page publications
  • [x] Add "Remove Master Page" context menu item and thumbnail tooltip for Master Page
  • [x] Add Header & Footer button to Insert ribbon and synchronize active indicators across ribbon buttons
  • [x] Persist headersVisible in .opub serialization and restore cleanly in file loader
  • [x] Bump Service Worker cache bucket to open-publisher-v5-19-3-1 in sw.js
  • [x] Bump all asset cachebusters to ?v=5.19.3 across HTML, scripts, templates, and documentation
  • [x] Pass all automated Playwright verification tests
  • [x] Maintain clean local git commit ready for user push

πŸš€ Version 5.19.3 - Open Publisher

Source: README.md, updated 2026-11-08