Commit Graph

1213 Commits

Author SHA1 Message Date
lampovayatyan999 698de7ea1e docs: improve useIsBrowser section, clarify hydration vs DOM availabi… (#12176)
* docs: improve useIsBrowser section, clarify hydration vs DOM availability (#8678)

* Update website/docs/docusaurus-core.mdx

* Update website/docs/docusaurus-core.mdx

* Apply suggestion from @slorber

---------

Co-authored-by: Sébastien Lorber <slorber@users.noreply.github.com>
2026-06-18 12:31:49 +02:00
Sébastien Lorber a85847fbac docs(website): split Deployment page into a category with hosting provider subpages + cleanup providers (#12139) 2026-06-12 16:07:35 +02:00
Ifeanyi Chima b7963e359d docs: document that plugin-ideal-image changes imported image types (#12130) 2026-06-12 13:10:51 +02:00
Ifeanyi Chima 0968de19c9 docs(deployment): update Node.js version from 20 to 24 in deployment … (#12118) 2026-06-12 10:26:56 +02:00
Sébastien Lorber 34656d725c break(core): Remove legacy postBuild({head}) API and v4 future flag (#12084) 2026-05-29 17:25:09 +02:00
Sébastien Lorber a846a0fd73 feat(dev-server): add dev-server CLI options for HTTPS support (#12082) 2026-05-29 16:34:13 +02:00
Sébastien Lorber 1dba8e8e1b break(google-analytics): remove deprecated Google Analytics plugin (#12081) 2026-05-28 18:39:51 +02:00
Kiwi 698a15910f docs(cli): document missing --javascript option for docusaurus swizzle (#12038) 2026-05-21 14:41:10 +02:00
Atharv Mohite f63ef9452e docs: clarify where to add custom CSS files (#12032) 2026-05-21 14:01:46 +02:00
Sébastien Lorber 1641a13f04 break(eslint-plugin): Add ESLint flag configs, require ESLint >= 8.57 (#12025)
* Add support for ESLint flag config

* eslint plugin docs update

* eslint plugin docs update
2026-05-15 19:09:59 +02:00
Mark Feng 7e3edcee3d docs: document loading ambient types for optional plugins (#11986) 2026-05-09 18:09:04 +02:00
Bansidhar kadiya d7a8ae3c07 docs: add Tables section to Markdown features (#11970)
Co-authored-by: Sébastien Lorber <slorber@users.noreply.github.com>
Co-authored-by: sebastien <lorber.sebastien@gmail.com>
2026-05-09 17:55:05 +02:00
小墨 0363c9b875 docs: change file extensions from .md to .mdx in installation.mdx (#12003) 2026-05-09 17:30:01 +02:00
Danyal Ahmed 84650e563e docs: fix siteConfig.url link in i18n tutorial (#12002) 2026-05-09 17:25:05 +02:00
Yangshun Tay 190ef6fa5d chore: migrate from Prettier to oxfmt for code formatting (#11824)
Co-authored-by: sebastien <lorber.sebastien@gmail.com>
2026-05-07 13:50:57 +02:00
LiuHuaize 8c05ce7e9b docs: add package-manager tabs for create-docusaurus (#11925) 2026-04-28 16:52:26 +02:00
Kevin Winardi aedb78ef09 docs: Update example file from tags.yml to authors.yml (#11973) 2026-04-28 16:35:30 +02:00
Sébastien Lorber 3bfefa2117 break: update all packages to Node 24.14 update node engine in packages (#11914) 2026-04-07 18:39:36 +02:00
Sébastien Lorber 62c5bf456a chore: release v3.10 (#11825)
Co-authored-by: slorber <749374+slorber@users.noreply.github.com>
2026-04-07 16:20:00 +02:00
Eoin Shaughnessy 4a1bd941ba docs: fix grammar errors in migration and plugin docs (#11904) 2026-04-06 15:32:53 +02:00
Sébastien Lorber 4892e7f257 feat(core): add future.v4.mdx1CompatDisabledByDefault flag (#11896)
* add future.v4.mdx1CompatDisabledByDefault flag

* docs

* update snapshots

* add crowdin comment

* improve tests

* improve tests
2026-04-03 19:13:09 +02:00
Misrilal 9d50300132 docs(plugin-api): remove unimplemented dev server hooks (#11867) 2026-03-31 14:07:28 +02:00
Sébastien Lorber 29c3b5ce11 feat(core): Docusaurus Faster is stable + v4 future flag turns it on by default (#11802)
* feat(core): promote `future.experimental_faster` to `future.faster` + add `future.v4.fasterByDefault` flag

Stabilize the Docusaurus Faster config by removing the `experimental_` prefix.
Add a `fasterByDefault` v4 future flag that enables all faster features by default
when `v4: true` is used, allowing granular overrides. Init templates now include
`@docusaurus/faster` as a dependency since they use `v4: true`.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* refactor: apply lint autofix

* fix(docs): remove broken #faster anchor link in fasterByDefault docs

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(ci): add Yarn PnP packageExtension for @docusaurus/bundler → @docusaurus/faster

Yarn PnP strict mode doesn't resolve optional dependencies automatically.
Add a packageExtension so @docusaurus/bundler can resolve @docusaurus/faster
in the e2e Yarn Berry tests.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(core): declare @docusaurus/faster as optional peer dep instead of CI packageExtension

Revert the packageExtensions workaround in the e2e CI workflow and instead
declare @docusaurus/faster as an optional peer dependency of @docusaurus/core,
matching the existing pattern in @docusaurus/bundler.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* chore: retrigger CI

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* empty

* add randomness to e2e test script version, to avoid using cached versions when trying to run this locally

* Rspack + PnP doesn't work, so add a warning in this case + fallback to Webpack
This should fix the e2e pnp workflows

* refactor: apply lint autofix

* typo

* typo

* revert wrong change

* also use slower minimizers

* comment

* restore snapshots

* ensure faster key resolution is always exhaustive, no hardcoding of keys

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Co-authored-by: slorber <749374+slorber@users.noreply.github.com>
2026-03-13 17:17:28 +01:00
Sébastien Lorber 2a7f8b96e6 feat(core): promote siteConfig.storage to stable + add future.v4.siteStorageNamespacing flag [Claude] (#11797)
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-12 16:36:03 +01:00
Sébastien Lorber caff1c46ea chore(website): migrate MDX heading ids to comment syntax + upgrade Crowdin parser version (#11779) 2026-03-06 21:48:12 +01:00
Sébastien Lorber 9456b23440 docs(website): change recommended syntax for math equations (#11784) 2026-03-06 19:23:20 +01:00
Sébastien Lorber 7151555280 feat(cli): write-heading-ids CLI now supports the --syntax option (#11777) 2026-03-05 18:59:03 +01:00
Kunwardeep Singh b0cacdfdc5 docs: fix minor grammar (#11766)
Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
2026-03-05 13:32:30 +01:00
Sébastien Lorber 3dbd395983 feat(mdx-loader): add support for explicit headingId based on MD/MDX comments (#11755)
* refactor tests

* add claude todos

* stable impl

* revert eslint

* improve test

* improve type

* improve impl logic

* working and tested implementation

* refactor: apply lint autofix

* empty

* remove comments

* force usage of # in comment content

* improve the code + test edge cases

* add docs

---------

Co-authored-by: slorber <749374+slorber@users.noreply.github.com>
2026-02-27 18:52:20 +01:00
Neel Bansal 49619fdee1 feat(theme-live-codeblock): reset button + wire position prop (#11675)
* feat(theme-live-codeblock): add reset button to live code playground

Adds a reset button to live code playgrounds that restores edited code
to its original state. The button appears in the playground header
alongside the Live Editor label.

Closes #10711

* chore: update theme translations for reset button

* add mising LiveCodeBlockThemeConfig type import to website

* some fixes

* change type order

* remove useless dogfood page

* rename i18n key

* extract context to a client api export

* fix prop types import

* restore former comment

* refactor a bit, extract playground position prop

* expose position prop + dogfood

* wire position prop

* fix type issues

* subcomponents

* restore some former CSS

* fix React playground examples

* restore comment

---------

Co-authored-by: sebastien <lorber.sebastien@gmail.com>
Co-authored-by: Sébastien Lorber <slorber@users.noreply.github.com>
2026-02-19 17:41:19 +01:00
Sébastien Lorber eac406c8e8 feat(theme): Split <DocCard>, improve extensibility, better handling of emoji icons, stable classNames (#11734) 2026-02-13 17:02:45 +01:00
Sreehari Upas 5783f60ebe docs: document Vercel deep clone requirement for last update time (#11656)
Co-authored-by: Sreehari Upas <sreehariupas@Sreeharis-MacBook-Air-10.local>
2026-02-12 18:44:17 +01:00
Poetry Of Code d173a7767d docs(i18n): fix cp commands causing duplicate files in some shells (#11687)
* docs(i18n): fix cp commands causing duplicate files in some shells

The i18n tutorial and git workflow docs used `cp -r dir/**` which
causes duplicate files in shells like Fish where the glob expands
before the -r flag processes recursively.

Fix by:
- Using `cp -r dir/.` for recursive directory copies
- Removing -r and using single `*` for file pattern copies

Fixes #11158

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* docs(i18n): use recursive cp for pages to include subfolders

Use `cp -r src/pages/. dest` instead of separate glob commands,
matching the pattern already used for docs and blog copies.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* docs(i18n): copy only md/mdx files for pages i18n

Use find to recursively copy only .md and .mdx files from src/pages,
preserving directory structure, instead of copying all files.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Update website/docs/i18n/i18n-git.mdx

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Co-authored-by: Sébastien Lorber <slorber@users.noreply.github.com>
2026-02-06 11:49:12 +01:00
Aleksandar Zgonjan 7a3772a566 docs(deployment): recommend Cloudflare Workers over Cloudflare Pages (#11673)
Co-authored-by: Aleksandar Zgonjan <azgonjan@oglasnik.hr>
Co-authored-by: sebastien <lorber.sebastien@gmail.com>
2026-01-29 16:00:36 +01:00
Gnana Eswar Gunturu 071899b944 docs: fix wording in installation guide (#11670) 2026-01-19 14:42:24 +01:00
snikkrs 9b02423946 docs(api): note text fix in docusaurus.config.js.mdx (#11663)
Update docusaurus.config.js.mdx

Removed repeated text in a note.
2026-01-15 11:46:57 -05:00
Dmitriy Rotaenko d671e9a7d5 docs: Fix some typos on the Upgrading to Docusaurus v3 page (#11649) 2026-01-09 18:00:57 -05:00
Balthasar Hofer bf9924a5f6 feat(mdx-loader): add admonitions directive support for class/id shortcuts (#11642) 2026-01-05 16:34:17 +01:00
Balthasar Hofer c6a86ff717 feat(core): support custom html elements in head tags (#11571)
Co-authored-by: sebastien <lorber.sebastien@gmail.com>
2025-11-27 11:19:53 +01:00
Natan Yagudayev 89633b4d33 feat(theme-search-algolia): add support for DocSearch v4.3.2 and new Suggested Questions (#11541)
Co-authored-by: sebastien <lorber.sebastien@gmail.com>
2025-11-21 11:31:51 +01:00
Sébastien Lorber acc66c14b0 feat(core): New siteConfig future.experimental_vcs API + future.experimental_faster.gitEagerVcs flag (#11512)
Co-authored-by: slorber <749374+slorber@users.noreply.github.com>
2025-11-14 18:15:45 +01:00
Sébastien Lorber c8fc3311f1 fix(docs): add support for missing sidebar_key front matter attribute (#11490) 2025-10-17 12:34:08 +02:00
Ethan 13ec1eaa3e docs(website): fix typo for onBrokenMarkdownImages (#11444) 2025-10-09 17:44:15 +02:00
Dan Roscigno 8f32716def docs(website): upgrade Node.js version from 18 to 20 in GitHub/Travis workflow examples (#11443) 2025-09-29 17:33:43 +02:00
Sébastien Lorber 70f6312c0d feat(blog): Add support for email social icon + resize default social icon a bit (#11425) 2025-09-23 15:08:02 +02:00
Dylan Tientcheu 9c689880ed feat(search): add runtime support for DocSearch v4 (#11327)
Co-authored-by: sebastien <lorber.sebastien@gmail.com>
2025-09-19 14:15:57 +02:00
Sébastien Lorber 1c484e1d59 chore: drop support for Node 18, that reached End-of-Life (#11408) 2025-09-12 18:48:12 +02:00
Sébastien Lorber 3dacdf33c9 feat(mdx): resolve @site/* markdown links, fix resolution priority bugs (#11397) 2025-09-04 15:29:26 +02:00
Feez2403 305910758b feat(mermaid): support elk layout (#11357)
Co-authored-by: sebastien <lorber.sebastien@gmail.com>
2025-08-24 20:11:21 +02:00
ya-dvorovenko c131034bc2 docs: remove stray character in plugin overview page (#11368) 2025-08-24 12:11:22 +02:00