Skip to content

V1.0.5

Choose a tag to compare

@aREversez aREversez released this 27 Jul 13:47
· 384 commits to main since this release
65babdd

V1.0.5

Key Resolution & Map References

  • Cross-folder keydef maps: keyref values now resolve correctly when the key definition map resides in a different folder than the root map (parent, sub-folder, or any reachable location). Resolution now follows the source map's references instead of assuming a same-level keys.ditamap.
  • Href rebasing: When a referenced map is inlined, all local hrefs within it are automatically rebased from the referenced map's folder to the root map's folder. This ensures topics, images, and nested maps resolve correctly regardless of directory depth.
  • <mapref> support: <mapref> elements are now fully expanded and rendered like topicref/keydef map references, replacing the previous empty rendering behavior.
  • All-in-one maps: Maps that reference only other maps (e.g., sub-maps in nested sub-folders) now render the complete merged tree, including recursively nested map references.
  • Key precedence: Key map discovery now scans all ancestor directories (nearest first) using first-definition-wins semantics, aligning with standard DITA key precedence rules.

Map Preview UX

  • Refresh button: Added a reload button to the map preview toolbar.
  • Mode toggle fix: Fixed an issue where switching to Book mode would get stuck; the toggle now correctly returns to Tree mode on the next click.
  • Book mode map entries: Referenced .ditamap entries now render as section placeholders instead of failing to load as topics.

Reading View ⇄ Source Toggle

  • Two-way toggle: Running Open DITA Reading View or Open DITA Map Reading View (via button, keybinding, or command palette) while the reading view is active now switches back to the source editor. This focuses an already-open source tab and closes the preview, or reopens the tab with the text editor in place.
  • Context-aware toolbar button: While a reading view is active, the editor title button changes to Back to DITA Source / Back to DITA Map Source ($(go-to-file) icon), ensuring the tooltip accurately reflects the action. New companion commands ditaViewer.showSource and ditaViewer.showMapSource have been added.

Bug Fixes

  • Disposed webview guard: Fixed an uncaught "Webview is disposed" error by preventing pending sync timers in the topic preview from posting to a webview that has been closed or replaced.