Skip to content

v0.6.1

Latest

Choose a tag to compare

@rachfop rachfop released this 03 Oct 01:34
· 1 commit to main since this release
f632da5

This release fixes how links, Markdown file paths, and content are generated for versioned, translated, and multi-section sites, and adds lint and format checks to the repo. Docs are at https://rachfop.github.io/docusaurus-plugin-llms.

Added

  • versions[].routePrefix, for explicit versions served inside the route base
    path (/docs/<version>/) (#88).

Changed

  • versions: 'auto' follows Docusaurus versioning: the last version writes the
    root files, the current docs go under next/ with the label Next, and the
    docs plugin's lastVersion, includeCurrentVersion, onlyIncludeVersions,
    and disableVersioning options apply (#88, #93).
  • Each locale's files use the page translations in i18n/<locale>/ (#88).
  • HTML tables, line breaks, and <img> tags become Markdown text and images,
    and HTML and MDX comments are removed (#85).
  • Duplicate llms-full.txt headings get a space before the suffix:
    ## Install (Api) (#86).
  • Option validation rejects output paths outside the build directory,
    duplicate output file names, a processingBatchSize that isn't a positive
    integer, and invalid per-version options (#78, #84, #88).

Fixed

  • Links and Markdown file paths match the routes Docusaurus builds for index
    and README pages, slugs and ids, number-prefixed files, date-prefixed blog
    posts, multi-section and baseUrl sites, and paths with spaces or accents
    (#74, #77, #87).
  • Content cleaning keeps prose lines that start with "import", code samples
    inside partials, and blank lines inside code, and long JSX tags don't hang
    the build (#85).
  • Page descriptions skip code fences, tables, admonitions, JSX, and comments,
    and a wrapped first paragraph is joined before it's truncated (#76, #85,
    #86).
  • Generated files stay inside the build directory and don't overwrite each
    other (#84).
  • Empty and unclosed code fences are left as written, <img> tags with a
    require() source become Markdown images, and @site/ images are
    rewritten (#92).
  • logLevel: 'quiet' prints errors only, and each plugin instance uses its
    own level (#78, #86).
  • Titles with brackets or line breaks, components in preserveComponents
    named like HTML tags, TabItem labels, the blog heading on multi-section
    sites, and image rewriting for relative paths (#86).

Documentation

  • Corrected documented option behavior, and documented how titles and
    descriptions are chosen, directory index pages, versioned sites, and
    translated sites (#79, #82, #88).