Skip to content

v0.8.0

Choose a tag to compare

@Kasui92 Kasui92 released this 06 Sep 08:09
· 69 commits to main since this release
beacb4d

What's Changed

Added

  • Added @lancher-dev/jaad/layouts/Page.astro, a public layout that puts the documentation header and footer around a page of your own by @Kasui92

Changed

  • docs is now the default create-jaad template, and --template is optional everywhere, including non-interactive environments by @Kasui92
  • The scaffolder now copies its templates from real files instead of building them in code, so generated projects arrive formatted by @Kasui92
  • Documentation now covers the theme contract for custom layouts, the shapes behind navigation, the conditions that disable page shortcuts, and the fact that astro options apply only through @lancher-dev/jaad/site by @Kasui92
  • The official site now answers an unknown URL with its own not found page by @Kasui92

Removed

  • Removed @lancher-dev/jaad/layouts/Base.astro, deprecated in JAAD 0.7 by @Kasui92

Fixed

  • The opening documentation page takes its title from frontmatter again, instead of falling back to the first heading by @Kasui92
  • Repeated headings on a page now get the same numbered anchors as the rendered output, so every table of contents entry points at its own heading by @Kasui92
  • --jaad-sidebar-width now moves the content gutters with it, and a widened sidebar is no longer pushed off the screen by @Kasui92
  • Image alt text no longer reaches the search index or the generated page descriptions by @Kasui92
  • Bundled layouts, routes and themes resolve in projects whose path contains spaces by @Kasui92
  • --here --template site now stops instead of adding a landing page beside a JAAD configuration it did not write by @Kasui92
  • create-jaad . is treated as --here by @Kasui92
  • create-jaad exits non-zero when it is cancelled or cannot write the project by @Kasui92
  • create-jaad reads manifests that begin with a byte order mark, and treats a directory holding only .git as empty by @Kasui92
  • Printed next steps quote paths that contain spaces by @Kasui92
  • The site theme switcher exposes its state to assistive technology by @Kasui92

Upgrade Notes

  • Replace @lancher-dev/jaad/layouts/Base.astro imports with @lancher-dev/jaad/layouts/Page.astro. Base.astro forwarded every prop to that layout, so nothing else about the page changes.
  • --template is no longer required in non-interactive environments and defaults to docs. Existing --template docs and --template site invocations keep working.
  • --here --template site against a project that already has a jaad.config.* now stops with an error and writes nothing. The landing page needs routeBase: "/docs", which only the project can set, so add both by hand.

Full Changelog: v0.7.1...v0.8.0