Repository navigation
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 undernext/with the labelNext, and the
docs plugin'slastVersion,includeCurrentVersion,onlyIncludeVersions,
anddisableVersioningoptions 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.txtheadings get a space before the suffix:
## Install (Api)(#86). - Option validation rejects output paths outside the build directory,
duplicate output file names, aprocessingBatchSizethat 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 andbaseUrlsites, 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,TabItemlabels, the blog heading on multi-section
sites, and image rewriting for relative paths (#86).