Page Not Found
We could not find what you were looking for.
Please contact the owner of the site that linked you to the original URL and let them know their link is broken.
diff --git a/.nojekyll b/.nojekyll deleted file mode 100644 index e69de29bb2..0000000000 diff --git a/4/docu.png b/4/docu.png new file mode 100644 index 0000000000..f458149e3c Binary files /dev/null and b/4/docu.png differ diff --git a/4/图片.png b/4/图片.png new file mode 100644 index 0000000000..2e4d675f90 Binary files /dev/null and b/4/图片.png differ diff --git a/404.html b/404.html index fe2a0f448c..b1113f3c54 100644 --- a/404.html +++ b/404.html @@ -2,13 +2,57 @@
- -We could not find what you were looking for.
Please contact the owner of the site that linked you to the original URL and let them know their link is broken.
We could not find what you were looking for.
Please contact the owner of the site that linked you to the original URL and let them know their link is broken.
default
community
docs-tests
default
blog-tests
default
pages-tests
default
3.2.1
3.2.1
3.2.1
3.2.1
3.2.1
3.2.1
3.2.1
3.2.1
3.2.1
3.2.1
3.2.1
3.2.1
3.2.1
3.2.1
3.2.1
@theme/DocItem
93875
@site/changelog/source/2.0.0-alpha.72.md?truncated=true
21344
@generated/docusaurus-plugin-content-docs/default/p/docs-category-getting-started-8c0.json
98639
@site/changelog/source/2.0.0-beta.5.md
897
@site/blog/2022/01-24-docusaurus-2021-recap/index.mdx?truncated=true
78152
@site/changelog/source/2.0.0-alpha.31.md?truncated=true
7927
@site/changelog/source/2.0.0-beta.13.md
76393
@generated/docusaurus-plugin-content-docs/docs-tests/__plugin.json
28615
@site/_dogfooding/_pages tests/layout-no-children.tsx
79818
@site/_dogfooding/_pages tests/error-boundary-tests.tsx
9058
@site/_dogfooding/_docs tests/folder with space/doc 1.mdx
76657
@site/_dogfooding/_pages tests/link-tests.tsx
2086
@theme/ChangelogPage
6722
@site/_dogfooding/_blog tests/2022-04-20-dup-footnote.mdx
51309
@site/changelog/source/2.0.0-alpha.20.md
21935
@theme/BlogTagsListPage
32843
@site/blog/releases/3.1/index.mdx
66819
@site/changelog/source/2.0.0-alpha.29.md
91072
@site/docs/api/plugins/plugin-google-analytics.mdx
63443
@site/docs/api/themes/theme-configuration.mdx
22091
@site/_dogfooding/_pages tests/diagrams.mdx
16697
@site/blog/releases/3.2/index.mdx?truncated=true
47835
@site/docs/deployment.mdx
25871
@site/_dogfooding/_docs tests/toc/toc-3-_.mdx
9133
@site/docs/api/misc/create-docusaurus.mdx
24048
@generated/docusaurus-plugin-content-blog/blog-tests/p/tests-blog-tags-docusaurus-page-2-9d9.json
70681
@site/changelog/source/2.0.0-beta.19.md?truncated=true
3381
@site/changelog/source/2.0.0-beta.22.md
88675
@site/changelog/source/2.0.0-beta.17.md?truncated=true
75736
@site/blog/releases/2.2/index.mdx
73660
@site/changelog/source/2.0.0-alpha.54.md?truncated=true
35134
@site/changelog/source/3.2.1.md
21887
@site/_dogfooding/_blog tests/2021-10-07-blog-post-mdx-feed-tests.mdx
43316
@theme/ChangelogList
31426
@site/docs/guides/markdown-features/markdown-features-code-blocks.mdx
28363
@site/_dogfooding/_blog tests/2022-01-20-image-only-authors.mdx?truncated=true
39641
@site/docs/api/plugins/plugin-content-docs.mdx
37595
@site/blog/releases/2.4/index.mdx
38260
@site/changelog/source/2.0.0-beta.20.md
39224
@site/blog/2022/09-01-docusaurus-2.1/index.mdx?truncated=true
48653
@generated/docusaurus-plugin-content-blog/blog-tests/p/tests-blog-tags-docusaurus-f4f.json
59872
@site/_dogfooding/_docs tests/toc/toc-_-5.mdx
31014
@site/docs/api/plugins/plugin-sitemap.mdx
60405
@site/blog/2022/09-01-docusaurus-2.1/index.mdx
16506
@site/changelog/source/2.2.0.md
26542
@site/changelog/source/2.0.0-beta.21.md
66150
@site/_dogfooding/_blog tests/2023-08-05.mdx
38730
@generated/docusaurus-plugin-debug/default/p/docusaurus-debug-content-4f8.json
23888
@generated/docusaurus-plugin-content-blog/blog-tests/p/tests-blog-tags-long-long-long-long-long-9a2.json
20232
@site/docs/migration/v2/migration-automated.mdx
91507
@site/changelog/source/2.0.0-alpha.25.md
93892
@site/changelog/source/2.0.0-beta.12.md
59009
@site/blog/2018/09-11-Towards-Docusaurus-2.mdx?truncated=true
86949
@site/changelog/source/2.0.0-alpha.65.md?truncated=true
86057
@site/blog/2023/09-29-preparing-your-site-for-docusaurus-v3/index.mdx
72807
@site/changelog/source/2.0.0-beta.1.md?truncated=true
57715
@site/_dogfooding/_blog tests/2023-07-19-b.mdx
8192
@theme/DocCategoryGeneratedIndexPage
96477
@site/changelog/source/2.0.0-beta.1.md
38240
@site/_dogfooding/_blog tests/2022-01-20-image-only-authors.mdx
47706
@site/docs/guides/markdown-features/markdown-features-toc.mdx
47336
@site/blog/releases/3.2/index.mdx
69476
@site/_dogfooding/_pages tests/tabs-tests.mdx
53694
@site/docs/api/misc/eslint-plugin/prefer-docusaurus-heading.mdx
83656
@site/changelog/source/2.0.0-beta.5.md?truncated=true
39045
@generated/docusaurus-plugin-content-blog/default/p/blog-tags-recap-2ed.json
55911
@theme/SearchPage
38548
@site/changelog/source/2.0.0-beta.20.md?truncated=true
30923
@site/changelog/source/2.0.0-alpha.74.md?truncated=true
54098
@site/changelog/source/2.0.0-alpha.60.md?truncated=true
47478
@site/docs/search.mdx
82720
@site/changelog/source/2.0.0-alpha.57.md
26778
@site/src/pages/index.tsx
45098
@theme/MDXPage
32266
@site/_dogfooding/_blog tests/2022-01-22-dup-footnote.mdx
8453
@site/community/3-contributing.mdx
45378
@site/docs/api/plugins/plugin-content-blog.mdx
86681
@site/docs/guides/markdown-features/markdown-features-tabs.mdx
74820
@site/_dogfooding/_docs tests/doc-with-last-update.mdx
19459
@site/_dogfooding/_blog tests/2021-08-21-blog-post-toc-tests.mdx
10921
@site/docs/api/plugins/plugin-client-redirects.mdx
2830
@theme/DebugConfig
56118
@generated/docusaurus-plugin-content-blog/default/p/blog-tags-beta-2cd.json
45160
@site/blog/releases/2.4/index.mdx?truncated=true
66778
@generated/docusaurus-plugin-content-blog/default/p/blog-page-4-30b.json
30816
@site/blog/2021/11-21-algolia-docsearch-migration/index.mdx?truncated=true
3560
@generated/docusaurus-plugin-content-blog/default/p/blog-archive-80c.json
5556
@site/changelog/source/2.0.0-alpha.37.md
89747
@generated/docusaurus-plugin-content-blog/default/p/blog-tags-blog-476.json
5001
@site/changelog/source/2.0.0-beta.6.md
88570
@generated/docusaurus-plugin-content-blog/blog-tests/p/tests-blog-tags-long-long-06d.json
91801
@site/docs/advanced/ssg.mdx
30291
@site/changelog/source/2.0.0-alpha.69.md?truncated=true
78667
@site/changelog/source/2.0.0-alpha.32.md?truncated=true
50737
@site/community/5-release-process.mdx
9621
@site/changelog/source/2.0.0-alpha.65.md
70026
@site/changelog/source/2.0.0-alpha.58.md
29488
@site/_dogfooding/_blog tests/2021-09-13-dup-title.mdx
3986
@site/changelog/source/2.0.0-alpha.22.md?truncated=true
44627
@site/changelog/source/2.0.0-alpha.27.md
35233
@site/_dogfooding/_pages tests/markdown-tests-mdx.mdx
60198
@site/_dogfooding/_blog tests/2023-08-05.mdx?truncated=true
39219
@site/docs/guides/whats-next.mdx
64787
@site/changelog/source/2.0.0-alpha.39.md
91624
@site/changelog/source/2.0.0-beta.14.md
60794
@site/_dogfooding/_blog tests/2021-08-22-no-author.mdx?truncated=true
27592
@site/changelog/source/2.0.0-alpha.28.md
16824
@generated/docusaurus-plugin-content-blog/blog-tests/p/tests-blog-tags-visibility-1bb.json
70701
@site/changelog/source/3.0.1.md
36478
@site/_dogfooding/_pages tests/analytics.tsx
46986
@site/docs/guides/docs/docs-create-doc.mdx
95661
@site/_dogfooding/_pages tests/seo.md
69409
@site/changelog/source/2.0.0-beta.16.md?truncated=true
59529
@site/_dogfooding/_docs tests/tests/visibility/only-unlisteds/unlisted2.mdx
39199
@site/changelog/source/2.0.0-alpha.61.md
49339
@site/changelog/source/2.4.1.md
46036
@site/_dogfooding/_docs tests/tests/visibility/some-unlisteds/unlisted1.mdx
44028
@site/_dogfooding/_blog tests/2022-01-21-dup-footnote.mdx
35243
@generated/docusaurus-plugin-content-blog/default/p/blog-tags-search-304.json
29173
@generated/docusaurus-plugin-content-blog/default/p/blog-tags-release-b5c.json
96178
@site/blog/releases/3.1/index.mdx?truncated=true
1149
@site/docs/api/misc/eslint-plugin/README.mdx
38722
@site/changelog/source/2.0.0-alpha.64.md?truncated=true
36100
@generated/docusaurus-plugin-content-blog/blog-tests/p/tests-blog-page-2-cc6.json
20500
@site/_dogfooding/_docs tests/tests/visibility/only-unlisteds/unlisted-subcategory/unlisted3.mdx
37788
@site/changelog/source/2.0.0-beta.22.md?truncated=true
82037
@generated/docusaurus-plugin-content-docs/docs-tests/p/tests-docs-category-another-category-with-index-5e9.json
30710
@generated/docusaurus-plugin-content-blog/default/__plugin.json
94468
@site/docs/api/plugins/plugin-google-gtag.mdx
59610
@theme/DocTagsListPage
28211
@site/changelog/source/2.0.0-beta.4.md
42618
@site/changelog/source/2.0.0-beta.6.md?truncated=true
12915
@site/src/plugins/featureRequests/FeatureRequestsPage
41505
@site/_dogfooding/_blog tests/2022-04-20-dup-footnote.mdx?truncated=true
36071
@site/_dogfooding/_pages tests/react-18/index.tsx
95637
@site/blog/releases/2.3/index.mdx
32537
@site/blog/2018/12-14-Happy-First-Birthday-Slash.mdx
28950
@site/_dogfooding/_docs tests/tests/custom-props/doc-without-custom-props.mdx
57948
@site/changelog/source/2.0.0-beta.14.md?truncated=true
63685
@site/_dogfooding/_pages tests/hydration-tests.tsx
53745
@site/changelog/source/2.0.0-alpha.56.md?truncated=true
27185
@generated/docusaurus-plugin-content-docs/docs-tests/p/tests-docs-tags-c-cf7.json
28376
@site/changelog/source/2.0.1.md?truncated=true
89560
@site/changelog/source/2.0.0.md
56959
@site/docs/i18n/i18n-crowdin.mdx
30855
@site/_dogfooding/_docs tests/tests/ascii/folder/æøå.mdx
12996
@site/changelog/source/2.0.1.md
6493
@site/community/2-resources.mdx
63761
@site/_dogfooding/_pages tests/z-index-tests.tsx
9384
@site/docs/advanced/client.mdx
1743
@site/community/0-support.mdx
26371
@site/docs/browser-support.mdx
92082
@site/changelog/source/2.0.0-beta.3.md
37888
@generated/docusaurus-plugin-content-blog/blog-tests/p/tests-blog-26e.json
13567
@generated/docusaurus-plugin-content-blog/default/p/blog-page-2-677.json
97610
@site/blog/2020/01-07-tribute-to-endi.mdx
3838
@generated/feature-requests-plugin/default/__plugin.json
50735
@site/changelog/source/2.0.0-alpha.62.md?truncated=true
24093
@generated/docusaurus-plugin-content-blog/default/p/blog-tags-037.json
88871
@site/changelog/source/2.0.0-alpha.23.md?truncated=true
95382
@site/_dogfooding/_blog tests/2021-10-08-blog-post-mdx-require-feed-tests.mdx
7801
@site/blog/2022/01-24-docusaurus-2021-recap/index.mdx
81833
@site/_dogfooding/_docs tests/tests/category-links/with-readme-doc/sample-doc.mdx
73967
@site/changelog/source/2.2.0.md?truncated=true
94444
@site/changelog/source/2.0.0-beta.2.md
70813
@generated/docusaurus-plugin-content-blog/default/p/blog-tags-tribute-4fa.json
22611
@site/docs/guides/docs/sidebar/autogenerated.mdx
18615
@site/changelog/source/2.0.0-alpha.30.md?truncated=true
37777
@site/changelog/source/2.0.0-alpha.70.md
15231
@generated/changelog-plugin/default/__plugin.json
32907
@generated/docusaurus-plugin-content-blog/default/p/blog-tags-adoption-bac.json
42031
@site/docs/api/misc/logger/logger.mdx
41363
@site/changelog/source/2.0.0-alpha.71.md
27458
@site/changelog/source/2.4.2.md?truncated=true
58402
@generated/docusaurus-plugin-content-blog/blog-tests/p/tests-blog-page-4-23e.json
81033
@site/changelog/source/2.0.0-alpha.57.md?truncated=true
36092
@site/changelog/source/2.0.0-beta.21.md?truncated=true
10015
@site/changelog/source/2.0.0-alpha.59.md
61439
@site/docs/api/plugins/plugin-ideal-image.mdx
42528
@site/docs/guides/markdown-features/markdown-features-assets.mdx
14006
@site/_dogfooding/_pages tests/unlisted.mdx
55915
@site/changelog/source/2.0.0-alpha.74.md
83011
@site/_dogfooding/_docs tests/tests/category-links/custom-index-convention/intro.mdx
12399
@site/community/1-team.mdx
2011
@site/_dogfooding/_blog tests/2022-08-24-post-unlisted.mdx?truncated=true
26298
@generated/docusaurus-plugin-content-blog/blog-tests/p/tests-blog-page-5-b5a.json
91606
@site/_dogfooding/_blog tests/2021-08-23-multiple-authors.mdx?truncated=true
9655
@site/_dogfooding/_docs tests/toc/toc-5-5.mdx
1125
@site/changelog/source/2.4.1.md?truncated=true
78064
@site/src/pages/examples/markdownPageExample.mdx
23850
@site/blog/2022/08-01-announcing-docusaurus-2.0/index.mdx
71943
@site/_dogfooding/_docs tests/tests/visibility/force-unlisted.mdx
56368
@generated/changelog-plugin/default/p/changelog-page-4-977.json
98402
@site/changelog/source/2.0.0-alpha.53.md
95224
@site/docs/api/plugins/plugin-debug.mdx
81849
@site/changelog/source/2.0.0-alpha.48.md?truncated=true
96126
@generated/docusaurus-plugin-content-blog/default/p/blog-c06.json
80899
@site/blog/2017/12-14-introducing-docusaurus.mdx?truncated=true
60932
@site/_dogfooding/_pages tests/navbar-dropdown-tests.mdx
50233
@generated/docusaurus-plugin-content-blog/default/p/blog-tags-endi-4b5.json
53059
@site/changelog/source/2.0.0-alpha.31.md
71482
@site/docs/api/plugin-methods/i18n-lifecycles.mdx
6290
@site/changelog/source/2.0.0-alpha.26.md?truncated=true
21638
@site/blog/releases/3.0/index.mdx
92471
@site/changelog/source/2.0.0-alpha.64.md
40847
@site/docs/guides/markdown-features/markdown-features-math-equations.mdx
11415
@site/changelog/source/2.0.0-alpha.20.md?truncated=true
16124
@site/_dogfooding/_docs tests/tests/toc-partials/index.mdx
97689
@site/changelog/source/2.0.0-alpha.63.md
69986
@site/blog/2020/01-07-tribute-to-endi.mdx?truncated=true
21223
@site/blog/2017/12-14-introducing-docusaurus.mdx
56799
@site/changelog/source/2.0.0.md?truncated=true
86753
@site/blog/2019/12-30-docusaurus-2019-recap.mdx?truncated=true
14542
@theme/DocsRoot
54527
@generated/docusaurus.config
36809
@generated/docusaurus-plugin-content-blog/blog-tests/p/tests-blog-tags-long-ce7.json
80553
@generated/docusaurus-plugin-content-blog/blog-tests/p/tests-blog-page-3-837.json
49735
@site/changelog/source/2.3.1.md
65714
@site/blog/2021/03-09-releasing-docusaurus-i18n.mdx?truncated=true
52322
@site/community/4-canary.mdx
75449
@site/docs/styling-layout.mdx
74277
@site/changelog/source/2.0.0-alpha.75.md
42794
@site/changelog/source/2.3.0.md?truncated=true
76435
@site/docs/guides/markdown-features/markdown-features-react.mdx
9817
~blog/blog-tests/blog-post-list-prop-blog-tests.json
90224
@site/changelog/source/2.0.0-alpha.66.md?truncated=true
19581
@site/changelog/source/2.0.0-beta.4.md?truncated=true
15829
@site/changelog/source/2.0.0-alpha.36.md
70278
@theme/DebugRegistry
91850
@site/changelog/source/2.0.0-alpha.35.md
57409
@site/_dogfooding/_docs tests/standalone.mdx
13645
@generated/changelog-plugin/default/p/changelog-page-5-a55.json
65833
@theme/BlogTagsPostsPage
7935
@site/changelog/source/2.4.3.md
86160
@site/changelog/source/2.0.0-alpha.27.md?truncated=true
5590
@theme/DebugSiteMetadata
18989
@site/_dogfooding/_docs tests/toc/toc-4-5.mdx
40198
@site/changelog/source/2.0.0-alpha.66.md
47677
@site/_dogfooding/_docs tests/toc/toc-2-2.mdx
96645
@site/changelog/source/2.0.0-beta.16.md
55605
@site/changelog/source/2.0.0-beta.0.md
55769
@site/docs/api/themes/theme-classic.mdx
21827
@site/blog/2018/04-30-How-I-Converted-Profilo-To-Docusaurus.mdx?truncated=true
605
@site/docs/migration/v2/migration-versioned-sites.mdx
99866
@site/blog/2023/09-29-preparing-your-site-for-docusaurus-v3/index.mdx?truncated=true
15691
@site/docs/api/plugins/plugin-google-tag-manager.mdx
19531
@site/_dogfooding/_pages tests/head-metadata.mdx
70573
@site/_dogfooding/_docs tests/more-test.mdx
8975
@generated/docusaurus-plugin-content-docs/docs-tests/p/tests-docs-tags-a-246.json
35795
@site/_dogfooding/_blog tests/2023-07-19-a.mdx
73772
@site/changelog/source/2.0.0-alpha.44.md?truncated=true
18766
@site/changelog/source/2.0.0-alpha.23.md
79442
@site/changelog/source/2.0.0-alpha.59.md?truncated=true
48732
@site/docs/guides/docs/sidebar/items.mdx
70946
@site/docs/playground.mdx
10714
@site/changelog/source/2.0.0-alpha.26.md
41858
@site/_dogfooding/_blog tests/2021-11-13-dup-title.mdx?truncated=true
13412
@site/changelog/source/2.0.0-rc.1.md?truncated=true
34895
@site/changelog/source/2.0.0-alpha.54.md
94188
@site/changelog/source/3.2.1.md?truncated=true
20294
@site/changelog/source/2.0.0-alpha.72.md
21678
@generated/feature-requests-plugin/default/paths.json
81836
@site/_dogfooding/_blog tests/2022-10-02-html-slug.mdx?truncated=true
78444
@site/_dogfooding/_docs tests/tests/visibility/some-drafts/draft-subcategory/listed1.mdx
77569
@site/changelog/source/2.0.0-alpha.44.md
49194
@site/changelog/source/2.0.0-alpha.67.md?truncated=true
63843
@site/_dogfooding/_docs tests/beginner's guide.mdx
43056
@site/_dogfooding/_docs tests/toc/toc-2-4.mdx
98208
@site/docs/guides/docs/docs-introduction.mdx
39461
@site/blog/releases/2.2/index.mdx?truncated=true
38098
@site/docs/api/plugin-methods/lifecycle-apis.mdx
51144
@site/changelog/source/3.0.1.md?truncated=true
12164
@site/changelog/source/2.0.0-alpha.19.md
50888
@site/docs/api/plugin-methods/static-methods.mdx
52431
@generated/docusaurus-plugin-content-blog/blog-tests/p/tests-blog-tags-paginated-tag-page-3-a87.json
66402
@site/changelog/source/2.0.0-alpha.49.md?truncated=true
5757
@site/docs/guides/markdown-features/markdown-features-intro.mdx
98583
@generated/docusaurus-plugin-content-docs/default/p/docs-b5f.json
90919
@site/changelog/source/2.0.0-alpha.69.md
90368
@generated/docusaurus-plugin-content-blog/blog-tests/p/tests-blog-tags-paginated-tag-488.json
41005
@site/blog/2019/12-30-docusaurus-2019-recap.mdx
26468
@generated/docusaurus-plugin-content-blog/blog-tests/p/tests-blog-tags-blog-page-2-340.json
27427
@site/src/pages/showcase/index.tsx
73881
@site/_dogfooding/_blog tests/2021-10-07-blog-post-mdx-feed-tests.mdx?truncated=true
2616
@site/blog/2018/04-30-How-I-Converted-Profilo-To-Docusaurus.mdx
20269
@site/changelog/source/2.0.0-alpha.36.md?truncated=true
39139
@site/_dogfooding/_pages tests/code-block-tests.mdx
6208
@site/changelog/source/2.0.0-alpha.38.md?truncated=true
45530
@site/changelog/source/2.0.0-alpha.60.md
59846
@site/blog/2023/09-22-upgrading-frontend-dependencies-with-confidence-using-visual-regression-testing/index.mdx?truncated=true
50520
~blog/default/blog-post-list-prop-default.json
45641
@site/docs/migration/v3.mdx
97369
@site/docs/guides/docs/docs-multi-instance.mdx
92726
@site/_dogfooding/_docs tests/tests/category-links/no-subdoc/index.mdx
41192
@site/changelog/source/2.0.0-alpha.43.md
41060
@generated/docusaurus-plugin-content-docs/community/p/community-742.json
38743
@site/changelog/source/2.4.0.md
59536
@generated/docusaurus-plugin-content-blog/blog-tests/p/tests-blog-page-6-cba.json
55881
@site/docs/api/themes/theme-live-codeblock.mdx
10460
@site/changelog/source/2.0.0-alpha.55.md?truncated=true
1229
@site/changelog/source/2.1.0.md?truncated=true
33858
@site/changelog/source/2.0.0-alpha.40.md?truncated=true
31491
@site/_dogfooding/_docs tests/tests/category-links/with-category-name-doc/with-category-name-doc.mdx
99977
@site/changelog/source/V2 Changelog.md
41130
@site/_dogfooding/_docs tests/tests/visibility/some-unlisteds/unlisted-subcategory/index.mdx
74728
@site/_dogfooding/_docs tests/toc/toc-test-good.mdx
38984
@generated/docusaurus-plugin-content-docs/docs-tests/p/tests-docs-tags-b-873.json
78863
@site/docs/docusaurus-core.mdx
16319
@site/changelog/source/2.0.0-alpha.61.md?truncated=true
26727
@site/_dogfooding/_docs tests/tests/links/broken-anchors-tests.mdx
26201
~blog/blog-tests/blogMetadata-blog-tests.json
31880
@site/changelog/source/2.0.0-beta.10.md?truncated=true
39683
@site/changelog/source/2.0.0-beta.7.md
24579
@site/changelog/source/2.0.0-alpha.48.md
31911
@generated/changelog-plugin/default/p/changelog-page-2-90a.json
31413
@site/changelog/source/2.0.0-alpha.33.md?truncated=true
10932
@generated/docusaurus-plugin-content-docs/docs-tests/p/tests-docs-tags-visibility-a5c.json
98408
@site/docs/i18n/i18n-introduction.mdx
91098
@site/changelog/source/2.0.0-beta.3.md?truncated=true
9635
@generated/docusaurus-plugin-content-blog/default/p/blog-page-3-fd4.json
26826
@site/changelog/source/3.1.0.md
27709
@site/changelog/source/2.0.0-alpha.32.md
70072
@site/changelog/source/2.0.0-beta.11.md?truncated=true
22847
@site/_dogfooding/_blog tests/2021-09-13-dup-title.mdx?truncated=true
12686
@site/_dogfooding/_docs tests/tests/admonitions.mdx
64790
@generated/docusaurus-plugin-content-blog/default/p/blog-tags-release-page-2-ceb.json
21150
@site/docs/migration/index.mdx
31366
@site/docs/api/themes/overview.mdx
49064
@generated/docusaurus-plugin-content-docs/docs-tests/p/tests-docs-tags-836.json
93625
@site/changelog/source/2.0.0-alpha.49.md
81762
@site/changelog/source/2.0.0-alpha.33.md
82778
@generated/docusaurus-plugin-content-docs/docs-tests/p/tests-docs-tags-listed-89a.json
12171
@site/docs/swizzling.mdx
36460
@theme/DebugRoutes
75277
@site/_dogfooding/_pages tests/crashTest.tsx
73687
@site/changelog/source/V2 Changelog.md?truncated=true
43686
~blog/../changelog-plugin/default/blog-post-list-prop-changelog.json
56923
@site/changelog/source/2.0.0-alpha.24.md?truncated=true
42607
@site/blog/releases/3.0/index.mdx?truncated=true
7393
@site/_dogfooding/_blog tests/2022-01-22-dup-footnote.mdx?truncated=true
72925
@site/docs/introduction.mdx
64784
@site/_dogfooding/_pages tests/index.mdx
31089
@site/src/pages/examples/noIndex.mdx
18330
@site/changelog/source/2.0.0-alpha.62.md
58867
@site/changelog/source/2.4.2.md
23193
@site/blog/2021/05-12-announcing-docusaurus-two-beta/index.mdx
64779
@site/_dogfooding/_blog tests/2021-08-21-blog-post-toc-tests.mdx?truncated=true
17737
@generated/docusaurus-plugin-content-blog/default/p/blog-tags-i-18-n-d57.json
12494
@site/_dogfooding/_blog tests/2022-01-21-dup-footnote.mdx?truncated=true
3232
@site/changelog/source/2.0.0-alpha.63.md?truncated=true
4309
@site/_dogfooding/_blog tests/2021-10-08-blog-post-mdx-require-feed-tests.mdx?truncated=true
81510
@generated/changelog-plugin/default/p/changelog-d19.json
22435
@site/changelog/source/2.0.0-alpha.22.md
13704
@site/docs/api/misc/eslint-plugin/no-untranslated-text.mdx
74309
@generated/docusaurus-plugin-content-docs/docs-tests/p/tests-docs-category-tests-e66.json
11152
@theme/BlogArchivePage
45722
@generated/docusaurus-plugin-content-blog/blog-tests/p/tests-blog-tags-463.json
47522
@site/changelog/source/2.0.0-alpha.30.md
92932
@site/blog/2021/11-21-algolia-docsearch-migration/index.mdx
67602
@site/changelog/source/2.0.0-alpha.37.md?truncated=true
62649
@site/changelog/source/2.0.0-beta.2.md?truncated=true
5121
@site/docs/typescript-support.mdx
96891
@generated/docusaurus-plugin-content-blog/default/p/blog-tags-maintenance-416.json
58454
@site/_dogfooding/_docs tests/tests/category-links/with-index-doc/sample-doc.mdx
49262
@generated/docusaurus-plugin-content-blog/blog-tests/p/tests-blog-tags-long-long-long-c12.json
59256
@site/_dogfooding/_blog tests/2023-07-19-b.mdx?truncated=true
1645
@site/docs/guides/docs/versioning.mdx
10707
@site/_dogfooding/_docs tests/doc-without-sidebar.mdx
78598
@site/changelog/source/2.0.0-alpha.53.md?truncated=true
17744
@site/changelog/source/2.0.0-beta.19.md
81655
@site/_dogfooding/_docs tests/toc/toc-3-5.mdx
18115
@site/docs/using-plugins.mdx
69790
@site/docs/api/plugin-methods/extend-infrastructure.mdx
4033
@generated/docusaurus-plugin-content-docs/docs-tests/p/tests-docs-category-links-generated-index-slug-d5e.json
32129
@site/docs/migration/v2/migration-manual.mdx
38476
@site/changelog/source/2.4.0.md?truncated=true
25707
@site/docs/blog.mdx
54945
@site/_dogfooding/_blog tests/2023-07-19-a.mdx?truncated=true
32640
@generated/docusaurus-plugin-content-blog/default/p/blog-tags-documentation-944.json
84567
@site/blog/2018/09-11-Towards-Docusaurus-2.mdx
30675
@theme/BlogListPage
83319
@site/docs/api/themes/theme-mermaid.mdx
31119
@generated/docusaurus-plugin-content-pages/default/__plugin.json
79365
@site/changelog/source/2.0.0-beta.0.md?truncated=true
65603
@generated/docusaurus-plugin-content-blog/blog-tests/p/tests-blog-archive-538.json
39292
@theme/DocVersionRoot
88337
@site/changelog/source/2.0.0-alpha.21.md
91351
@theme/DocRoot
76959
@site/_dogfooding/_docs tests/folder with space/doc 2.mdx
24422
@site/changelog/source/2.0.0-alpha.55.md
35019
@generated/docusaurus-plugin-content-docs/default/__plugin.json
41765
~blog/default/blogMetadata-default.json
81838
@site/blog/2018/12-14-Happy-First-Birthday-Slash.mdx?truncated=true
46352
@site/changelog/source/2.0.0-alpha.71.md?truncated=true
23732
@site/changelog/source/2.0.0-rc.1.md
43196
@site/changelog/source/2.0.0-alpha.50.md
72427
@site/_dogfooding/_docs tests/tests/category-links/no-index-doc/index.mdx
76749
@site/changelog/source/2.0.0-beta.18.md
65367
@generated/docusaurus-plugin-content-blog/default/p/blog-tags-profilo-007.json
14513
@site/changelog/source/2.0.0-alpha.58.md?truncated=true
40964
@site/_dogfooding/_blog tests/2021-08-23-multiple-authors.mdx
45929
@site/blog/2021/03-09-releasing-docusaurus-i18n.mdx
29963
@generated/docusaurus-plugin-content-docs/docs-tests/p/tests-docs-tags-unlisted-307.json
10122
@site/docs/i18n/i18n-git.mdx
87182
@site/_dogfooding/_blog tests/2021-11-13-dup-title.mdx
78207
@generated/docusaurus-plugin-debug/default/__plugin.json
97139
@site/changelog/source/2.0.0-alpha.43.md?truncated=true
604
@site/blog/2021/05-12-announcing-docusaurus-two-beta/index.mdx?truncated=true
74106
@site/docs/guides/markdown-features/markdown-features-links.mdx
67188
@site/_dogfooding/_docs tests/dummy.mdx
29368
@site/changelog/source/3.1.0.md?truncated=true
61587
@site/_dogfooding/_pages tests/page-toc-tests.mdx
2641
@site/_dogfooding/_blog tests/demo/2020-08-03-second-blog-intro.mdx?truncated=true
44254
@site/docs/cli.mdx
35359
@theme/DebugContent
66074
@site/_dogfooding/_blog tests/2022-10-02-html-slug.mdx
73169
@site/changelog/source/2.0.0-beta.18.md?truncated=true
55274
@site/_dogfooding/_docs tests/tests/visibility/some-unlisteds/unlisted-subcategory/unlisted3.mdx
12288
@site/docs/api/docusaurus.config.js.mdx
83588
@site/changelog/source/2.0.0-beta.17.md
71743
@site/_dogfooding/_docs tests/tests/visibility/only-unlisteds/unlisted-subcategory/index.mdx
41547
@site/docs/guides/markdown-features/markdown-features-admonitions.mdx
31478
@site/_dogfooding/_docs tests/toc/toc-test-bad.mdx
7171
@site/changelog/source/3.1.1.md?truncated=true
17505
@site/changelog/source/2.0.0-alpha.34.md?truncated=true
82370
@generated/docusaurus-plugin-content-blog/default/p/blog-tags-release-page-3-4c9.json
59979
@generated/docusaurus-plugin-content-blog/default/p/blog-tags-birth-1aa.json
71168
@site/docs/api/plugins/plugin-pwa.mdx
55895
@site/changelog/source/2.0.0-alpha.75.md?truncated=true
78267
@site/changelog/source/2.0.0-alpha.50.md?truncated=true
65343
@generated/docusaurus-theme-search-algolia/default/__plugin.json
51324
@generated/docusaurus-plugin-content-blog/blog-tests/__plugin.json
59981
@site/docs/api/plugins/plugin-vercel-analytics.mdx
97584
@site/blog/2021/01-19-docusaurus-2020-recap.mdx
67386
@site/docs/api/plugin-methods/README.mdx
12922
@site/changelog/source/2.0.0-alpha.67.md
75709
@site/_dogfooding/_docs tests/tests/category-links/regular-category/sample-doc.mdx
82023
@site/_dogfooding/_docs tests/tests/visibility/some-unlisteds/unlisted2.mdx
17534
@generated/docusaurus-plugin-content-blog/default/p/blog-tags-new-d08.json
36924
@site/docs/guides/markdown-features/markdown-features-diagrams.mdx
73233
@site/docs/i18n/i18n-tutorial.mdx
89415
@site/docs/static-assets.mdx
77136
@site/docs/advanced/routing.mdx
24109
@site/changelog/source/3.1.1.md
64108
@site/changelog/source/2.0.0-alpha.51.md?truncated=true
25921
@generated/docusaurus-plugin-content-pages/pages-tests/__plugin.json
13950
@site/_dogfooding/_docs tests/tests/category-links/no-index-doc/sample-doc.mdx
45535
@site/_dogfooding/_docs tests/tests/category-links/with-category-name-doc/sample-doc.mdx
85520
@site/changelog/source/2.0.0-beta.10.md
89673
@site/docs/configuration.mdx
66411
@generated/docusaurus-plugin-content-blog/blog-tests/p/tests-blog-tags-blog-821.json
37117
@theme/BlogPostPage
28575
@site/docs/api/plugins/plugin-content-pages.mdx
6945
@site/docs/guides/markdown-features/markdown-features-head-metadata.mdx
56500
@site/changelog/source/2.0.0-alpha.73.md?truncated=true
53390
@site/changelog/source/3.2.0.md?truncated=true
4145
@site/_dogfooding/_docs tests/tests/category-links/with-readme-doc/README.mdx
64021
@site/docs/migration/v2/migration-overview.mdx
22858
@site/changelog/source/2.0.0-alpha.68.md
60179
@site/changelog/source/2.0.0-alpha.24.md
39883
@site/docs/api/misc/eslint-plugin/no-html-links.mdx
69546
@site/docs/migration/v2/migration-translated-sites.mdx
9701
@site/docs/api/misc/eslint-plugin/string-literal-i18n-messages.mdx
23432
@site/_dogfooding/_docs tests/doc-with-another-sidebar.mdx
24221
@site/changelog/source/2.3.0.md
44331
@site/_dogfooding/_blog tests/2021-08-22-no-author.mdx
55472
@site/_dogfooding/_blog tests/demo/2020-08-03-second-blog-intro.mdx
20435
@site/changelog/source/2.0.0-alpha.29.md?truncated=true
68698
@site/docs/advanced/index.mdx
31565
@site/changelog/source/2.0.0-beta.13.md?truncated=true
67843
@site/changelog/source/2.0.0-beta.11.md
76563
@site/blog/2021/01-19-docusaurus-2020-recap.mdx?truncated=true
66914
@site/changelog/source/2.0.0-alpha.38.md
55639
@site/changelog/source/2.0.0-alpha.41.md
62682
@site/docs/guides/docs/sidebar/multiple-sidebars.mdx
82442
@generated/docusaurus-plugin-content-blog/default/p/blog-page-5-c6b.json
84379
@site/changelog/source/3.0.0.md
85541
@generated/docusaurus-plugin-content-docs/docs-tests/p/tests-docs-tags-d-custom-permalink-7c5.json
68645
@site/changelog/source/2.0.0-beta.7.md?truncated=true
20768
@site/_dogfooding/_docs tests/tests/category-links/readme.mdx
79503
@site/changelog/source/2.0.0-alpha.19.md?truncated=true
50013
@site/_dogfooding/_docs tests/toc/toc-2-5.mdx
68858
@site/_dogfooding/_docs tests/tests/custom-props/index.mdx
57969
@site/docs/api/plugins/overview.mdx
84277
@generated/changelog-plugin/default/p/changelog-page-3-c10.json
62262
@site/_dogfooding/_pages tests/markdown-tests-md.md
98985
@theme/DocTagDocListPage
68641
@site/_dogfooding/_docs tests/tests/category-links/custom-index-convention/sample-doc.mdx
37485
@generated/docusaurus-plugin-content-docs/docs-tests/p/tests-docs-tags-some-tag-7ab.json
92179
@site/changelog/source/2.0.0-alpha.56.md
28134
@site/docs/api/themes/theme-search-algolia.mdx
83624
@generated/docusaurus-plugin-content-docs/docs-tests/p/tests-docs-307.json
92873
@site/_dogfooding/_pages tests/embeds.tsx
12827
@site/_dogfooding/_docs tests/tests/Case-Sentitive-Doc.mdx
82134
@generated/docusaurus-plugin-content-docs/community/__plugin.json
19469
@generated/docusaurus-plugin-content-docs/docs-tests/p/tests-docs-tags-e-39b.json
11116
@site/changelog/source/2.0.0-alpha.40.md
95907
@site/changelog/source/2.3.1.md?truncated=true
4969
@site/changelog/source/2.0.0-alpha.21.md?truncated=true
81418
@site/changelog/source/3.2.0.md
44109
@site/changelog/source/2.0.0-beta.8.md
3327
@site/_dogfooding/_docs tests/tests/visibility/only-unlisteds/unlisted1.mdx
17770
@site/changelog/source/2.0.0-alpha.25.md?truncated=true
46898
@site/docs/guides/creating-pages.mdx
93226
@site/docs/seo.mdx
63150
@site/docs/advanced/plugins.mdx
8549
@site/changelog/source/2.0.0-alpha.68.md?truncated=true
11366
@site/docs/guides/markdown-features/markdown-features-plugins.mdx
51458
@site/blog/2023/09-22-upgrading-frontend-dependencies-with-confidence-using-visual-regression-testing/index.mdx
43924
@site/changelog/source/2.0.0-alpha.35.md?truncated=true
14602
@site/changelog/source/2.0.0-alpha.70.md?truncated=true
75388
~blog/../changelog-plugin/default/blogMetadata-changelog.json
13782
@generated/docusaurus-plugin-content-docs/docs-tests/p/tests-docs-category-sidebar-item-description-tests-753.json
32752
@site/changelog/source/2.4.3.md?truncated=true
90828
@site/_dogfooding/_docs tests/toc/toc-_-_.mdx
55957
@site/changelog/source/2.0.0-alpha.34.md
18957
@site/_dogfooding/_blog tests/2022-08-24-post-unlisted.mdx
21040
@generated/docusaurus-plugin-content-blog/blog-tests/p/tests-blog-tags-unlisted-c83.json
30619
@site/changelog/source/2.0.0-beta.12.md?truncated=true
48865
@site/changelog/source/2.0.0-beta.15.md?truncated=true
463
@site/changelog/source/2.0.0-beta.15.md
30
@site/changelog/source/2.0.0-alpha.41.md?truncated=true
9961
@site/changelog/source/2.0.0-alpha.51.md
68347
@theme/DebugGlobalData
61179
@site/src/pages/tests.mdx
10349
@site/blog/releases/2.3/index.mdx?truncated=true
71507
@site/blog/2022/08-01-announcing-docusaurus-2.0/index.mdx?truncated=true
44604
@site/docs/advanced/architecture.mdx
55330
@site/changelog/source/3.0.0.md?truncated=true
48360
@site/changelog/source/2.0.0-alpha.73.md
58111
@site/_dogfooding/_docs tests/tests/img-tests.mdx
7474
@generated/docusaurus-plugin-content-blog/blog-tests/p/tests-blog-tags-paginated-tag-page-4-404.json
52088
@generated/docusaurus-plugin-content-blog/blog-tests/p/tests-blog-tags-paginated-tag-page-2-ef6.json
92118
@site/changelog/source/2.0.0-beta.9.md
90433
@generated/docusaurus-plugin-content-docs/default/p/docs-category-guides-350.json
89604
@site/changelog/source/2.0.0-alpha.28.md?truncated=true
77373
@site/_dogfooding/_docs tests/tests/visibility/some-unlisteds/unlisted-subcategory/listed1.mdx
21007
@site/changelog/source/2.1.0.md
98171
@site/changelog/source/2.0.0-beta.8.md?truncated=true
94514
@site/docs/guides/docs/sidebar/index.mdx
2230
@generated/docusaurus-plugin-content-blog/blog-tests/p/tests-blog-tags-long-long-long-long-160.json
99424
@site/changelog/source/2.0.0-beta.9.md?truncated=true
23086
@generated/docusaurus-plugin-content-blog/default/p/blog-tags-docusaurus-0e0.json
29333
@site/_dogfooding/_docs tests/tests/custom-props/doc-with-custom-props.mdx
35972
@site/_dogfooding/_docs tests/index.mdx
67918
@site/_dogfooding/_docs tests/toc/toc-2-3.mdx
1242
@site/src/pages/versions.tsx
60826
@site/docs/installation.mdx
70976
@site/changelog/source/2.0.0-alpha.39.md?truncated=true
10856
@site/_dogfooding/_docs tests/tests/category-links/with-index-doc/index.mdx
88804
@site/_dogfooding/_docs tests/tests/ascii/æøå/index.mdx
24816
@site/_dogfooding/_docs tests/tests/visibility/index.mdx
72511
/__docusaurus/debug
true
/__docusaurus/debug/config
true
/__docusaurus/debug/content
true
/__docusaurus/debug/globalData
true
/__docusaurus/debug/metadata
true
/__docusaurus/debug/registry
true
/__docusaurus/debug/routes
true
/blog
true
/blog/2017/12/14/introducing-docusaurus
true
/blog/2018/04/30/How-I-Converted-Profilo-To-Docusaurus
true
/blog/2018/09/11/Towards-Docusaurus-2
true
/blog/2018/12/14/Happy-First-Birthday-Slash
true
/blog/2019/12/30/docusaurus-2019-recap
true
/blog/2020/01/07/tribute-to-endi
true
/blog/2021/01/19/docusaurus-2020-recap
true
/blog/2021/03/09/releasing-docusaurus-i18n
true
/blog/2021/05/12/announcing-docusaurus-two-beta
true
/blog/2021/11/21/algolia-docsearch-migration
true
/blog/2022/01/24/docusaurus-2021-recap
true
/blog/2022/08/01/announcing-docusaurus-2.0
true
/blog/2022/09/01/docusaurus-2.1
true
/blog/archive
true
/blog/page/2
true
/blog/page/3
true
/blog/page/4
true
/blog/page/5
true
/blog/preparing-your-site-for-docusaurus-v3
true
/blog/releases/2.2
true
/blog/releases/2.3
true
/blog/releases/2.4
true
/blog/releases/3.0
true
/blog/releases/3.1
true
/blog/releases/3.2
true
/blog/tags
true
/blog/tags/adoption
true
/blog/tags/beta
true
/blog/tags/birth
true
/blog/tags/blog
true
/blog/tags/documentation
true
/blog/tags/docusaurus
true
/blog/tags/endi
true
/blog/tags/i-18-n
true
/blog/tags/maintenance
true
/blog/tags/new
true
/blog/tags/profilo
true
/blog/tags/recap
true
/blog/tags/release
true
/blog/tags/release/page/2
true
/blog/tags/release/page/3
true
/blog/tags/search
true
/blog/tags/tribute
true
/blog/upgrading-frontend-dependencies-with-confidence-using-visual-regression-testing
true
/changelog
true
/changelog/2.0.0
true
/changelog/2.0.0-alpha.19
true
/changelog/2.0.0-alpha.20
true
/changelog/2.0.0-alpha.21
true
/changelog/2.0.0-alpha.22
true
/changelog/2.0.0-alpha.23
true
/changelog/2.0.0-alpha.24
true
/changelog/2.0.0-alpha.25
true
/changelog/2.0.0-alpha.26
true
/changelog/2.0.0-alpha.27
true
/changelog/2.0.0-alpha.28
true
/changelog/2.0.0-alpha.29
true
/changelog/2.0.0-alpha.30
true
/changelog/2.0.0-alpha.31
true
/changelog/2.0.0-alpha.32
true
/changelog/2.0.0-alpha.33
true
/changelog/2.0.0-alpha.34
true
/changelog/2.0.0-alpha.35
true
/changelog/2.0.0-alpha.36
true
/changelog/2.0.0-alpha.37
true
/changelog/2.0.0-alpha.38
true
/changelog/2.0.0-alpha.39
true
/changelog/2.0.0-alpha.40
true
/changelog/2.0.0-alpha.41
true
/changelog/2.0.0-alpha.43
true
/changelog/2.0.0-alpha.44
true
/changelog/2.0.0-alpha.48
true
/changelog/2.0.0-alpha.49
true
/changelog/2.0.0-alpha.50
true
/changelog/2.0.0-alpha.51
true
/changelog/2.0.0-alpha.53
true
/changelog/2.0.0-alpha.54
true
/changelog/2.0.0-alpha.55
true
/changelog/2.0.0-alpha.56
true
/changelog/2.0.0-alpha.57
true
/changelog/2.0.0-alpha.58
true
/changelog/2.0.0-alpha.59
true
/changelog/2.0.0-alpha.60
true
/changelog/2.0.0-alpha.61
true
/changelog/2.0.0-alpha.62
true
/changelog/2.0.0-alpha.63
true
/changelog/2.0.0-alpha.64
true
/changelog/2.0.0-alpha.65
true
/changelog/2.0.0-alpha.66
true
/changelog/2.0.0-alpha.67
true
/changelog/2.0.0-alpha.68
true
/changelog/2.0.0-alpha.69
true
/changelog/2.0.0-alpha.70
true
/changelog/2.0.0-alpha.71
true
/changelog/2.0.0-alpha.72
true
/changelog/2.0.0-alpha.73
true
/changelog/2.0.0-alpha.74
true
/changelog/2.0.0-alpha.75
true
/changelog/2.0.0-beta.0
true
/changelog/2.0.0-beta.1
true
/changelog/2.0.0-beta.10
true
/changelog/2.0.0-beta.11
true
/changelog/2.0.0-beta.12
true
/changelog/2.0.0-beta.13
true
/changelog/2.0.0-beta.14
true
/changelog/2.0.0-beta.15
true
/changelog/2.0.0-beta.16
true
/changelog/2.0.0-beta.17
true
/changelog/2.0.0-beta.18
true
/changelog/2.0.0-beta.19
true
/changelog/2.0.0-beta.2
true
/changelog/2.0.0-beta.20
true
/changelog/2.0.0-beta.21
true
/changelog/2.0.0-beta.22
true
/changelog/2.0.0-beta.3
true
/changelog/2.0.0-beta.4
true
/changelog/2.0.0-beta.5
true
/changelog/2.0.0-beta.6
true
/changelog/2.0.0-beta.7
true
/changelog/2.0.0-beta.8
true
/changelog/2.0.0-beta.9
true
/changelog/2.0.0-rc.1
true
/changelog/2.0.1
true
/changelog/2.1.0
true
/changelog/2.2.0
true
/changelog/2.3.0
true
/changelog/2.3.1
true
/changelog/2.4.0
true
/changelog/2.4.1
true
/changelog/2.4.2
true
/changelog/2.4.3
true
/changelog/3.0.0
true
/changelog/3.0.1
true
/changelog/3.1.0
true
/changelog/3.1.1
true
/changelog/3.2.0
true
/changelog/3.2.1
true
/changelog/page/2
true
/changelog/page/3
true
/changelog/page/4
true
/changelog/page/5
true
/changelog/V2 Changelog
true
/examples/markdownPageExample
true
/examples/noIndex
true
/feature-requests
false
/search
true
/showcase
true
/tests
true
/tests/blog
true
/tests/blog/2020/08/03/demo/second-blog-intro
true
/tests/blog/2021/08/21/blog-post-toc-tests
true
/tests/blog/2021/08/22/no-author
true
/tests/blog/2021/08/23/multiple-authors
true
/tests/blog/2021/09/13/dup-title
true
/tests/blog/2021/10/07/blog-post-mdx-feed-tests
true
/tests/blog/2021/10/08/blog-post-mdx-require-feed-tests
true
/tests/blog/2021/11/13/dup-title
true
/tests/blog/2022/01/20/image-only-authors
true
/tests/blog/2022/01/21/dup-footnote
true
/tests/blog/2022/01/22/dup-footnote
true
/tests/blog/2022/04/20/dup-footnote
true
/tests/blog/2023/07/19/a
true
/tests/blog/2023/07/19/b
true
/tests/blog/2023/08/05
true
/tests/blog/archive
true
/tests/blog/page/2
true
/tests/blog/page/3
true
/tests/blog/page/4
true
/tests/blog/page/5
true
/tests/blog/page/6
true
/tests/blog/tags
true
/tests/blog/tags/blog
true
/tests/blog/tags/blog/page/2
true
/tests/blog/tags/docusaurus
true
/tests/blog/tags/docusaurus/page/2
true
/tests/blog/tags/long
true
/tests/blog/tags/long-long
true
/tests/blog/tags/long-long-long
true
/tests/blog/tags/long-long-long-long
true
/tests/blog/tags/long-long-long-long-long
true
/tests/blog/tags/paginated-tag
true
/tests/blog/tags/paginated-tag/page/2
true
/tests/blog/tags/paginated-tag/page/3
true
/tests/blog/tags/paginated-tag/page/4
true
/tests/blog/tags/unlisted
true
/tests/blog/tags/visibility
true
/tests/blog/unlisted-post
true
/tests/blog/x/y/z.html
true
/tests/pages
true
/tests/pages/analytics
true
/tests/pages/code-block-tests
true
/tests/pages/crashTest
true
/tests/pages/diagrams
true
/tests/pages/embeds
true
/tests/pages/error-boundary-tests
true
/tests/pages/head-metadata
true
/tests/pages/hydration-tests
true
/tests/pages/layout-no-children
true
/tests/pages/link-tests
true
/tests/pages/markdown-tests-md
true
/tests/pages/markdown-tests-mdx
true
/tests/pages/navbar-dropdown-tests
true
/tests/pages/page-toc-tests
true
/tests/pages/react-18
true
/tests/pages/seo
true
/tests/pages/tabs-tests
true
/tests/pages/unlisted
true
/tests/pages/z-index-tests
true
/versions
true
/community
false
/tests/docs
false
/docs
false
/
true
*
false
parseFrontMatter
hook",id:"parsefrontmatter-hook",level:3},{value:"Other changes",id:"other-changes",level:2}];function l(e){const r={a:"a",admonition:"admonition",code:"code",h2:"h2",h3:"h3",img:"img",li:"li",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,s.a)(),...e.components};return(0,t.jsxs)(t.Fragment,{children:[(0,t.jsxs)(r.p,{children:["We are happy to announce ",(0,t.jsx)(r.strong,{children:"Docusaurus 3.1"}),"."]}),"\n",(0,t.jsxs)(r.p,{children:["The upgrade should be easy: as explained in our ",(0,t.jsx)(r.a,{href:"/community/release-process",children:"release process documentation"}),", minor versions respect ",(0,t.jsx)(r.a,{href:"https://semver.org/",children:"Semantic Versioning"}),"."]}),"\n",(0,t.jsx)(r.p,{children:(0,t.jsx)(r.img,{alt:"Docusaurus blog post social card",src:n(21004).Z+"",width:"1200",height:"600"})}),"\n","\n",(0,t.jsx)(r.h2,{id:"highlights",children:"Highlights"}),"\n",(0,t.jsx)(r.h3,{id:"broken-anchors-checker",children:"Broken anchors checker"}),"\n",(0,t.jsxs)(r.p,{children:["In ",(0,t.jsx)(r.a,{href:"https://github.com/facebook/docusaurus/pull/9528",children:"#9528"}),", we improved the built-in broken links checker to also detect broken anchors."]}),"\n",(0,t.jsx)(r.p,{children:(0,t.jsx)(r.img,{alt:"Docusaurus blog post social card",src:n(22497).Z+"",width:"1920",height:"896"})}),"\n",(0,t.jsxs)(r.admonition,{title:"Make it fail fast",type:"tip",children:[(0,t.jsxs)(r.p,{children:["The new ",(0,t.jsx)(r.a,{href:"/docs/api/docusaurus-config#onBrokenAnchors",children:(0,t.jsx)(r.code,{children:"onBrokenAnchors"})})," option has value ",(0,t.jsx)(r.code,{children:"warn"})," by default, for retro-compatibility reasons."]}),(0,t.jsxs)(r.p,{children:["We recommend to turn it to ",(0,t.jsx)(r.code,{children:"throw"})," and fail your CI builds instead of deploying broken anchors to productions."]})]}),"\n",(0,t.jsxs)(r.admonition,{type:"note",children:[(0,t.jsxs)(r.p,{children:["For users and plugin authors implementing custom ",(0,t.jsx)(r.code,{children:"useColorMode
",id:"use-color-mode",level:3},{value:"i18n",id:"i18n",level:2},{value:"Translation files location",id:"translation-files-location",level:3},{value:"Example file-system structure",id:"example-file-system-structure",level:3}];function a(e){const n={a:"a",admonition:"admonition",code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",h4:"h4",li:"li",p:"p",pre:"pre",strong:"strong",table:"table",tbody:"tbody",td:"td",th:"th",thead:"thead",tr:"tr",ul:"ul",...(0,s.a)(),...e.components};return(0,d.jsxs)(d.Fragment,{children:[(0,d.jsx)(n.h1,{id:"theme-configuration",children:"Theme configuration"}),"\n","\n",(0,d.jsxs)(n.p,{children:["This configuration applies to all ",(0,d.jsx)(n.a,{href:"/docs/api/themes",children:"main themes"}),"."]}),"\n",(0,d.jsx)(n.h2,{id:"common",children:"Common"}),"\n",(0,d.jsx)(n.h3,{id:"color-mode---dark-mode",children:"Color mode"}),"\n",(0,d.jsx)(n.p,{children:"The classic theme provides by default light and dark mode support, with a navbar switch for the user."}),"\n",(0,d.jsxs)(n.p,{children:["It is possible to customize the color mode support within the ",(0,d.jsx)(n.code,{children:"colorMode"})," object."]}),"\n",(0,d.jsx)(n.p,{children:"Accepted fields:"}),"\n",(0,d.jsx)(t.Z,{children:(0,d.jsxs)(n.table,{children:[(0,d.jsx)(n.thead,{children:(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.th,{children:"Name"}),(0,d.jsx)(n.th,{children:"Type"}),(0,d.jsx)(n.th,{children:"Default"}),(0,d.jsx)(n.th,{children:"Description"})]})}),(0,d.jsxs)(n.tbody,{children:[(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"defaultMode"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)("code",{children:"'light' | 'dark'"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"'light'"})}),(0,d.jsx)(n.td,{children:"The color mode when user first visits the site."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"disableSwitch"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"boolean"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"false"})}),(0,d.jsx)(n.td,{children:"Hides the switch in the navbar. Useful if you want to support a single color mode."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"respectPrefersColorScheme"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"boolean"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"false"})}),(0,d.jsxs)(n.td,{children:["Whether to use the ",(0,d.jsx)(n.code,{children:"prefers-color-scheme"})," media-query, using user system preferences, instead of the hardcoded ",(0,d.jsx)(n.code,{children:"defaultMode"}),"."]})]})]})]})}),"\n",(0,d.jsx)(n.p,{children:"Example configuration:"}),"\n",(0,d.jsx)(n.pre,{children:(0,d.jsx)(n.code,{className:"language-js",metastring:'title="docusaurus.config.js"',children:"export default {\n themeConfig: {\n // highlight-start\n colorMode: {\n defaultMode: 'light',\n disableSwitch: false,\n respectPrefersColorScheme: false,\n },\n // highlight-end\n },\n};\n"})}),"\n",(0,d.jsxs)(n.admonition,{type:"warning",children:[(0,d.jsxs)(n.p,{children:["With ",(0,d.jsx)(n.code,{children:"respectPrefersColorScheme: true"}),", the ",(0,d.jsx)(n.code,{children:"defaultMode"})," is overridden by user system preferences."]}),(0,d.jsx)(n.p,{children:"If you only want to support one color mode, you likely want to ignore user system preferences."})]}),"\n",(0,d.jsx)(n.h3,{id:"meta-image",children:"Meta image"}),"\n",(0,d.jsxs)(n.p,{children:["You can configure a default image that will be used for your meta tag, in particular ",(0,d.jsx)(n.code,{children:"og:image"})," and ",(0,d.jsx)(n.code,{children:"twitter:image"}),"."]}),"\n",(0,d.jsx)(n.p,{children:"Accepted fields:"}),"\n",(0,d.jsx)(t.Z,{children:(0,d.jsxs)(n.table,{children:[(0,d.jsx)(n.thead,{children:(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.th,{children:"Name"}),(0,d.jsx)(n.th,{children:"Type"}),(0,d.jsx)(n.th,{children:"Default"}),(0,d.jsx)(n.th,{children:"Description"})]})}),(0,d.jsx)(n.tbody,{children:(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"image"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"undefined"})}),(0,d.jsx)(n.td,{children:'The meta image URL for the site. Relative to your site\'s "static" directory. Cannot be SVGs. Can be external URLs too.'})]})})]})}),"\n",(0,d.jsx)(n.p,{children:"Example configuration:"}),"\n",(0,d.jsx)(n.pre,{children:(0,d.jsx)(n.code,{className:"language-js",metastring:'title="docusaurus.config.js"',children:"export default {\n themeConfig: {\n // highlight-next-line\n image: 'img/docusaurus.png',\n },\n};\n"})}),"\n",(0,d.jsx)(n.h3,{id:"metadata",children:"Metadata"}),"\n",(0,d.jsx)(n.p,{children:"You can configure additional HTML metadata (and override existing ones)."}),"\n",(0,d.jsx)(n.p,{children:"Accepted fields:"}),"\n",(0,d.jsx)(t.Z,{children:(0,d.jsxs)(n.table,{children:[(0,d.jsx)(n.thead,{children:(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.th,{children:"Name"}),(0,d.jsx)(n.th,{children:"Type"}),(0,d.jsx)(n.th,{children:"Default"}),(0,d.jsx)(n.th,{children:"Description"})]})}),(0,d.jsx)(n.tbody,{children:(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"metadata"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"Metadata[]"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"[]"})}),(0,d.jsxs)(n.td,{children:["Any field will be directly passed to the ",(0,d.jsx)(n.code,{children:""})," tag. Possible fields include ",(0,d.jsx)(n.code,{children:"id"}),", ",(0,d.jsx)(n.code,{children:"name"}),", ",(0,d.jsx)(n.code,{children:"property"}),", ",(0,d.jsx)(n.code,{children:"content"}),", ",(0,d.jsx)(n.code,{children:"itemprop"}),", etc."]})]})})]})}),"\n",(0,d.jsx)(n.p,{children:"Example configuration:"}),"\n",(0,d.jsx)(n.pre,{children:(0,d.jsx)(n.code,{className:"language-js",metastring:'title="docusaurus.config.js"',children:"export default {\n themeConfig: {\n // highlight-next-line\n metadata: [{name: 'twitter:card', content: 'summary'}],\n },\n};\n"})}),"\n",(0,d.jsx)(n.h3,{id:"announcement-bar",children:"Announcement bar"}),"\n",(0,d.jsxs)(n.p,{children:["Sometimes you want to announce something in your website. Just for such a case, you can add an announcement bar. This is a non-fixed and optionally dismissible panel above the navbar. All configuration are in the ",(0,d.jsx)(n.code,{children:"announcementBar"})," object."]}),"\n",(0,d.jsx)(n.p,{children:"Accepted fields:"}),"\n",(0,d.jsx)(t.Z,{name:"announcement-bar",children:(0,d.jsxs)(n.table,{children:[(0,d.jsx)(n.thead,{children:(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.th,{children:"Name"}),(0,d.jsx)(n.th,{children:"Type"}),(0,d.jsx)(n.th,{children:"Default"}),(0,d.jsx)(n.th,{children:"Description"})]})}),(0,d.jsxs)(n.tbody,{children:[(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"id"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"'announcement-bar'"})}),(0,d.jsx)(n.td,{children:"Any value that will identify this message."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"content"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"''"})}),(0,d.jsx)(n.td,{children:"The text content of the announcement. HTML will be interpolated."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"backgroundColor"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"'#fff'"})}),(0,d.jsx)(n.td,{children:"Background color of the entire bar."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"textColor"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"'#000'"})}),(0,d.jsx)(n.td,{children:"Announcement text color."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"isCloseable"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"boolean"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"true"})}),(0,d.jsx)(n.td,{children:"Whether this announcement can be dismissed with a '\xd7' button."})]})]})]})}),"\n",(0,d.jsx)(n.p,{children:"Example configuration:"}),"\n",(0,d.jsx)(n.pre,{children:(0,d.jsx)(n.code,{className:"language-js",metastring:'title="docusaurus.config.js"',children:"export default {\n themeConfig: {\n // highlight-start\n announcementBar: {\n id: 'support_us',\n content:\n 'We are looking to revamp our docs, please fill this survey',\n backgroundColor: '#fafbfc',\n textColor: '#091E42',\n isCloseable: false,\n },\n // highlight-end\n },\n};\n"})}),"\n",(0,d.jsx)(n.h2,{id:"navbar",children:"Navbar"}),"\n",(0,d.jsx)(n.p,{children:"Accepted fields:"}),"\n",(0,d.jsx)(t.Z,{name:"navbar-overview",children:(0,d.jsxs)(n.table,{children:[(0,d.jsx)(n.thead,{children:(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.th,{children:"Name"}),(0,d.jsx)(n.th,{children:"Type"}),(0,d.jsx)(n.th,{children:"Default"}),(0,d.jsx)(n.th,{children:"Description"})]})}),(0,d.jsxs)(n.tbody,{children:[(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"title"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"undefined"})}),(0,d.jsx)(n.td,{children:"Title for the navbar."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"logo"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.em,{children:"See below"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"undefined"})}),(0,d.jsx)(n.td,{children:"Customization of the logo object."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"items"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"NavbarItem[]"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"[]"})}),(0,d.jsx)(n.td,{children:"A list of navbar items. See specification below."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"hideOnScroll"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"boolean"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"false"})}),(0,d.jsx)(n.td,{children:"Whether the navbar is hidden when the user scrolls down."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"style"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)("code",{children:"'primary' | 'dark'"})}),(0,d.jsx)(n.td,{children:"Same as theme"}),(0,d.jsx)(n.td,{children:"Sets the navbar style, ignoring the dark/light theme."})]})]})]})}),"\n",(0,d.jsx)(n.h3,{id:"navbar-logo",children:"Navbar logo"}),"\n",(0,d.jsxs)(n.p,{children:["The logo can be placed in ",(0,d.jsx)(n.a,{href:"/docs/static-assets",children:"static folder"}),". Logo URL is set to base URL of your site by default. Although you can specify your own URL for the logo, if it is an external link, it will open in a new tab. In addition, you can override a value for the target attribute of logo link, it can come in handy if you are hosting docs website in a subdirectory of your main website, and in which case you probably do not need a link in the logo to the main website will open in a new tab."]}),"\n",(0,d.jsx)(n.p,{children:"To improve dark mode support, you can also set a different logo for this mode."}),"\n",(0,d.jsx)(n.p,{children:"Accepted fields:"}),"\n",(0,d.jsx)(t.Z,{name:"navbar-logo",children:(0,d.jsxs)(n.table,{children:[(0,d.jsx)(n.thead,{children:(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.th,{children:"Name"}),(0,d.jsx)(n.th,{children:"Type"}),(0,d.jsx)(n.th,{children:"Default"}),(0,d.jsx)(n.th,{children:"Description"})]})}),(0,d.jsxs)(n.tbody,{children:[(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"alt"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"undefined"})}),(0,d.jsx)(n.td,{children:"Alt tag for the logo image."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"src"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.strong,{children:"Required"})}),(0,d.jsx)(n.td,{children:"URL to the logo image. Base URL is appended by default."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"srcDark"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"logo.src"})}),(0,d.jsx)(n.td,{children:"An alternative image URL to use in dark mode."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"href"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"siteConfig.baseUrl"})}),(0,d.jsx)(n.td,{children:"Link to navigate to when the logo is clicked."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"width"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)("code",{children:"string | number"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"undefined"})}),(0,d.jsxs)(n.td,{children:["Specifies the ",(0,d.jsx)(n.code,{children:"width"})," attribute."]})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"height"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)("code",{children:"string | number"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"undefined"})}),(0,d.jsxs)(n.td,{children:["Specifies the ",(0,d.jsx)(n.code,{children:"height"})," attribute."]})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"target"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsxs)(n.td,{children:["Calculated based on ",(0,d.jsx)(n.code,{children:"href"})," (external links will open in a new tab, all others in the current one)."]}),(0,d.jsxs)(n.td,{children:["The ",(0,d.jsx)(n.code,{children:"target"})," attribute of the link; controls whether the link is opened in a new tab, the current one, or otherwise."]})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"className"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"undefined"})}),(0,d.jsx)(n.td,{children:"CSS class applied to the image."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"style"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"object"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"undefined"})}),(0,d.jsx)(n.td,{children:"CSS inline style object. React/JSX flavor, using camelCase properties."})]})]})]})}),"\n",(0,d.jsx)(n.p,{children:"Example configuration:"}),"\n",(0,d.jsx)(n.pre,{children:(0,d.jsx)(n.code,{className:"language-js",metastring:'title="docusaurus.config.js"',children:"export default {\n themeConfig: {\n navbar: {\n title: 'Site Title',\n // highlight-start\n logo: {\n alt: 'Site Logo',\n src: 'img/logo.svg',\n srcDark: 'img/logo_dark.svg',\n href: 'https://docusaurus.io/',\n target: '_self',\n width: 32,\n height: 32,\n className: 'custom-navbar-logo-class',\n style: {border: 'solid red'},\n },\n // highlight-end\n },\n },\n};\n"})}),"\n",(0,d.jsx)(n.h3,{id:"navbar-items",children:"Navbar items"}),"\n",(0,d.jsxs)(n.p,{children:["You can add items to the navbar via ",(0,d.jsx)(n.code,{children:"themeConfig.navbar.items"}),"."]}),"\n",(0,d.jsx)(n.pre,{children:(0,d.jsx)(n.code,{className:"language-js",metastring:'title="docusaurus.config.js"',children:"export default {\n themeConfig: {\n navbar: {\n // highlight-start\n items: [\n {\n type: 'doc',\n position: 'left',\n docId: 'introduction',\n label: 'Docs',\n },\n {to: 'blog', label: 'Blog', position: 'left'},\n {\n type: 'docsVersionDropdown',\n position: 'right',\n },\n {\n type: 'localeDropdown',\n position: 'right',\n },\n {\n href: 'https://github.com/facebook/docusaurus',\n position: 'right',\n className: 'header-github-link',\n 'aria-label': 'GitHub repository',\n },\n ],\n // highlight-end\n },\n },\n};\n"})}),"\n",(0,d.jsxs)(n.p,{children:["The items can have different behaviors based on the ",(0,d.jsx)(n.code,{children:"type"})," field. The sections below will introduce you to all the types of navbar items available."]}),"\n",(0,d.jsx)(n.h4,{id:"navbar-link",children:"Navbar link"}),"\n",(0,d.jsx)(n.p,{children:"By default, Navbar items are regular links (internal or external)."}),"\n",(0,d.jsxs)(n.p,{children:["React Router should automatically apply active link styling to links, but you can use ",(0,d.jsx)(n.code,{children:"activeBasePath"})," in edge cases. For cases in which a link should be active on several different paths (such as when you have multiple doc folders under the same sidebar), you can use ",(0,d.jsx)(n.code,{children:"activeBaseRegex"}),". ",(0,d.jsx)(n.code,{children:"activeBaseRegex"})," is a more flexible alternative to ",(0,d.jsx)(n.code,{children:"activeBasePath"})," and takes precedence over it -- Docusaurus parses it into a regular expression that is tested against the current URL."]}),"\n",(0,d.jsxs)(n.p,{children:["Outbound (external) links automatically get ",(0,d.jsx)(n.code,{children:'target="_blank" rel="noopener noreferrer"'})," attributes."]}),"\n",(0,d.jsx)(n.p,{children:"Accepted fields:"}),"\n",(0,d.jsx)(t.Z,{name:"navbar-link",children:(0,d.jsxs)(n.table,{children:[(0,d.jsx)(n.thead,{children:(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.th,{children:"Name"}),(0,d.jsx)(n.th,{children:"Type"}),(0,d.jsx)(n.th,{children:"Default"}),(0,d.jsx)(n.th,{children:"Description"})]})}),(0,d.jsxs)(n.tbody,{children:[(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"type"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"'default'"})}),(0,d.jsx)(n.td,{children:"Optional"}),(0,d.jsx)(n.td,{children:"Sets the type of this item to a link."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"label"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.strong,{children:"Required"})}),(0,d.jsx)(n.td,{children:"The name to be shown for this item."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"html"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:"Optional"}),(0,d.jsxs)(n.td,{children:["Same as ",(0,d.jsx)(n.code,{children:"label"}),", but renders pure HTML instead of text content."]})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"to"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.strong,{children:"Required"})}),(0,d.jsx)(n.td,{children:"Client-side routing, used for navigating within the website. The baseUrl will be automatically prepended to this value."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"href"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.strong,{children:"Required"})}),(0,d.jsxs)(n.td,{children:["A full-page navigation, used for navigating outside of the website. ",(0,d.jsxs)(n.strong,{children:["Only one of ",(0,d.jsx)(n.code,{children:"to"})," or ",(0,d.jsx)(n.code,{children:"href"})," should be used."]})]})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"prependBaseUrlToHref"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"boolean"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"false"})}),(0,d.jsxs)(n.td,{children:["Prepends the baseUrl to ",(0,d.jsx)(n.code,{children:"href"})," values."]})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"position"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)("code",{children:"'left' | 'right'"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"'left'"})}),(0,d.jsx)(n.td,{children:"The side of the navbar this item should appear on."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"activeBasePath"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsxs)(n.td,{children:[(0,d.jsx)(n.code,{children:"to"})," / ",(0,d.jsx)(n.code,{children:"href"})]}),(0,d.jsx)(n.td,{children:"To apply the active class styling on all routes starting with this path. This usually isn't necessary."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"activeBaseRegex"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"undefined"})}),(0,d.jsxs)(n.td,{children:["Alternative to ",(0,d.jsx)(n.code,{children:"activeBasePath"})," if required."]})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"className"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"''"})}),(0,d.jsx)(n.td,{children:"Custom CSS class (for styling any item)."})]})]})]})}),"\n",(0,d.jsx)(n.admonition,{type:"note",children:(0,d.jsx)(n.p,{children:"In addition to the fields above, you can specify other arbitrary attributes that can be applied to a HTML link."})}),"\n",(0,d.jsx)(n.p,{children:"Example configuration:"}),"\n",(0,d.jsx)(n.pre,{children:(0,d.jsx)(n.code,{className:"language-js",metastring:'title="docusaurus.config.js"',children:"export default {\n themeConfig: {\n navbar: {\n items: [\n // highlight-start\n {\n to: 'docs/introduction',\n // Only one of \"to\" or \"href\" should be used\n // href: 'https://www.facebook.com',\n label: 'Introduction',\n // Only one of \"label\" or \"html\" should be used\n // html: 'Introduction'\n position: 'left',\n activeBaseRegex: 'docs/(next|v8)',\n target: '_blank',\n },\n // highlight-end\n ],\n },\n },\n};\n"})}),"\n",(0,d.jsx)(n.h4,{id:"navbar-dropdown",children:"Navbar dropdown"}),"\n",(0,d.jsxs)(n.p,{children:["Navbar items of the type ",(0,d.jsx)(n.code,{children:"dropdown"})," has the additional ",(0,d.jsx)(n.code,{children:"items"})," field, an inner array of navbar items."]}),"\n",(0,d.jsxs)(n.p,{children:["Navbar dropdown items only accept the following ",(0,d.jsx)(n.strong,{children:'"link-like" item types'}),":"]}),"\n",(0,d.jsxs)(n.ul,{children:["\n",(0,d.jsx)(n.li,{children:(0,d.jsx)(n.a,{href:"#navbar-link",children:"Navbar link"})}),"\n",(0,d.jsx)(n.li,{children:(0,d.jsx)(n.a,{href:"#navbar-doc-link",children:"Navbar doc link"})}),"\n",(0,d.jsx)(n.li,{children:(0,d.jsx)(n.a,{href:"#navbar-docs-version",children:"Navbar docs version"})}),"\n",(0,d.jsx)(n.li,{children:(0,d.jsx)(n.a,{href:"#navbar-doc-sidebar",children:"Navbar doc sidebar"})}),"\n",(0,d.jsx)(n.li,{children:(0,d.jsx)(n.a,{href:"#navbar-with-custom-html",children:"Navbar with custom HTML"})}),"\n"]}),"\n",(0,d.jsxs)(n.p,{children:["Note that the dropdown base item is a clickable link as well, so this item can receive any of the props of a ",(0,d.jsx)(n.a,{href:"#navbar-link",children:"plain navbar link"}),"."]}),"\n",(0,d.jsx)(n.p,{children:"Accepted fields:"}),"\n",(0,d.jsx)(t.Z,{name:"navbar-dropdown",children:(0,d.jsxs)(n.table,{children:[(0,d.jsx)(n.thead,{children:(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.th,{children:"Name"}),(0,d.jsx)(n.th,{children:"Type"}),(0,d.jsx)(n.th,{children:"Default"}),(0,d.jsx)(n.th,{children:"Description"})]})}),(0,d.jsxs)(n.tbody,{children:[(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"type"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"'dropdown'"})}),(0,d.jsx)(n.td,{children:"Optional"}),(0,d.jsx)(n.td,{children:"Sets the type of this item to a dropdown."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"label"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.strong,{children:"Required"})}),(0,d.jsx)(n.td,{children:"The name to be shown for this item."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"items"})}),(0,d.jsx)(n.td,{children:(0,d.jsxs)("code",{children:[(0,d.jsx)(n.a,{href:"#navbar-dropdown",children:"LinkLikeItem"}),"[]"]})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.strong,{children:"Required"})}),(0,d.jsx)(n.td,{children:"The items to be contained in the dropdown."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"position"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)("code",{children:"'left' | 'right'"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"'left'"})}),(0,d.jsx)(n.td,{children:"The side of the navbar this item should appear on."})]})]})]})}),"\n",(0,d.jsx)(n.p,{children:"Example configuration:"}),"\n",(0,d.jsx)(n.pre,{children:(0,d.jsx)(n.code,{className:"language-js",metastring:'title="docusaurus.config.js"',children:"export default {\n themeConfig: {\n navbar: {\n items: [\n // highlight-start\n {\n type: 'dropdown',\n label: 'Community',\n position: 'left',\n items: [\n {\n label: 'Facebook',\n href: 'https://www.facebook.com',\n },\n {\n type: 'doc',\n label: 'Social',\n docId: 'social',\n },\n // ... more items\n ],\n },\n // highlight-end\n ],\n },\n },\n};\n"})}),"\n",(0,d.jsx)(n.h4,{id:"navbar-doc-link",children:"Navbar doc link"}),"\n",(0,d.jsxs)(n.p,{children:["If you want to link to a specific doc, this special navbar item type will render the link to the doc of the provided ",(0,d.jsx)(n.code,{children:"docId"}),". It will get the class ",(0,d.jsx)(n.code,{children:"navbar__link--active"})," as long as you browse a doc of the same sidebar."]}),"\n",(0,d.jsx)(n.p,{children:"Accepted fields:"}),"\n",(0,d.jsx)(t.Z,{name:"navbar-doc-link",children:(0,d.jsxs)(n.table,{children:[(0,d.jsx)(n.thead,{children:(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.th,{children:"Name"}),(0,d.jsx)(n.th,{children:"Type"}),(0,d.jsx)(n.th,{children:"Default"}),(0,d.jsx)(n.th,{children:"Description"})]})}),(0,d.jsxs)(n.tbody,{children:[(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"type"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"'doc'"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.strong,{children:"Required"})}),(0,d.jsx)(n.td,{children:"Sets the type of this item to a doc link."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"docId"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.strong,{children:"Required"})}),(0,d.jsx)(n.td,{children:"The ID of the doc that this item links to."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"label"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"docId"})}),(0,d.jsx)(n.td,{children:"The name to be shown for this item."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"position"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)("code",{children:"'left' | 'right'"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"'left'"})}),(0,d.jsx)(n.td,{children:"The side of the navbar this item should appear on."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"docsPluginId"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"'default'"})}),(0,d.jsx)(n.td,{children:"The ID of the docs plugin that the doc belongs to."})]})]})]})}),"\n",(0,d.jsx)(n.p,{children:"Example configuration:"}),"\n",(0,d.jsx)(n.pre,{children:(0,d.jsx)(n.code,{className:"language-js",metastring:'title="docusaurus.config.js"',children:"export default {\n themeConfig: {\n navbar: {\n items: [\n // highlight-start\n {\n type: 'doc',\n position: 'left',\n docId: 'introduction',\n label: 'Docs',\n },\n // highlight-end\n ],\n },\n },\n};\n"})}),"\n",(0,d.jsx)(n.h4,{id:"navbar-doc-sidebar",children:"Navbar linked to a sidebar"}),"\n",(0,d.jsx)(n.p,{children:"You can link a navbar item to the first document link (which can be a doc link or a generated category index) of a given sidebar without having to hardcode a doc ID."}),"\n",(0,d.jsx)(n.p,{children:"Accepted fields:"}),"\n",(0,d.jsx)(t.Z,{name:"navbar-doc-sidebar",children:(0,d.jsxs)(n.table,{children:[(0,d.jsx)(n.thead,{children:(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.th,{children:"Name"}),(0,d.jsx)(n.th,{children:"Type"}),(0,d.jsx)(n.th,{children:"Default"}),(0,d.jsx)(n.th,{children:"Description"})]})}),(0,d.jsxs)(n.tbody,{children:[(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"type"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"'docSidebar'"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.strong,{children:"Required"})}),(0,d.jsx)(n.td,{children:"Sets the type of this navbar item to a sidebar's first document."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"sidebarId"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.strong,{children:"Required"})}),(0,d.jsx)(n.td,{children:"The ID of the sidebar that this item is linked to."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"label"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:"First document link's sidebar label"}),(0,d.jsx)(n.td,{children:"The name to be shown for this item."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"position"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)("code",{children:"'left' | 'right'"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"'left'"})}),(0,d.jsx)(n.td,{children:"The side of the navbar this item should appear on."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"docsPluginId"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"'default'"})}),(0,d.jsx)(n.td,{children:"The ID of the docs plugin that the sidebar belongs to."})]})]})]})}),"\n",(0,d.jsx)(n.admonition,{type:"tip",children:(0,d.jsx)(n.p,{children:"Use this navbar item type if your sidebar is updated often and the order is not stable."})}),"\n",(0,d.jsx)(n.p,{children:"Example configuration:"}),"\n",(0,d.jsx)(n.pre,{children:(0,d.jsx)(n.code,{className:"language-js",metastring:'title="docusaurus.config.js"',children:"export default {\n themeConfig: {\n navbar: {\n items: [\n // highlight-start\n {\n type: 'docSidebar',\n position: 'left',\n sidebarId: 'api',\n label: 'API',\n },\n // highlight-end\n ],\n },\n },\n};\n"})}),"\n",(0,d.jsx)(n.pre,{children:(0,d.jsx)(n.code,{className:"language-js",metastring:'title="sidebars.js"',children:"export default {\n tutorial: [\n {\n type: 'autogenerated',\n dirName: 'guides',\n },\n ],\n api: [\n // highlight-next-line\n 'cli', // The navbar item will be linking to this doc\n 'docusaurus-core',\n {\n type: 'autogenerated',\n dirName: 'api',\n },\n ],\n};\n"})}),"\n",(0,d.jsx)(n.h4,{id:"navbar-docs-version-dropdown",children:"Navbar docs version dropdown"}),"\n",(0,d.jsx)(n.p,{children:"If you use docs with versioning, this special navbar item type that will render a dropdown with all your site's available versions."}),"\n",(0,d.jsx)(n.p,{children:"The user will be able to switch from one version to another, while staying on the same doc (as long as the doc ID is constant across versions)."}),"\n",(0,d.jsx)(n.p,{children:"Accepted fields:"}),"\n",(0,d.jsx)(t.Z,{name:"navbar-docs-version-dropdown",children:(0,d.jsxs)(n.table,{children:[(0,d.jsx)(n.thead,{children:(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.th,{children:"Name"}),(0,d.jsx)(n.th,{children:"Type"}),(0,d.jsx)(n.th,{children:"Default"}),(0,d.jsx)(n.th,{children:"Description"})]})}),(0,d.jsxs)(n.tbody,{children:[(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"type"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"'docsVersionDropdown'"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.strong,{children:"Required"})}),(0,d.jsx)(n.td,{children:"Sets the type of this item to a docs version dropdown."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"position"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)("code",{children:"'left' | 'right'"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"'left'"})}),(0,d.jsx)(n.td,{children:"The side of the navbar this item should appear on."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"dropdownItemsBefore"})}),(0,d.jsx)(n.td,{children:(0,d.jsxs)("code",{children:[(0,d.jsx)(n.a,{href:"#navbar-dropdown",children:"LinkLikeItem"}),"[]"]})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"[]"})}),(0,d.jsx)(n.td,{children:"Add additional dropdown items at the beginning of the dropdown."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"dropdownItemsAfter"})}),(0,d.jsx)(n.td,{children:(0,d.jsxs)("code",{children:[(0,d.jsx)(n.a,{href:"#navbar-dropdown",children:"LinkLikeItem"}),"[]"]})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"[]"})}),(0,d.jsx)(n.td,{children:"Add additional dropdown items at the end of the dropdown."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"docsPluginId"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"'default'"})}),(0,d.jsx)(n.td,{children:"The ID of the docs plugin that the doc versioning belongs to."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"dropdownActiveClassDisabled"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"boolean"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"false"})}),(0,d.jsx)(n.td,{children:"Do not add the link active class when browsing docs."})]})]})]})}),"\n",(0,d.jsx)(n.p,{children:"Example configuration:"}),"\n",(0,d.jsx)(n.pre,{children:(0,d.jsx)(n.code,{className:"language-js",metastring:'title="docusaurus.config.js"',children:"export default {\n themeConfig: {\n navbar: {\n items: [\n // highlight-start\n {\n type: 'docsVersionDropdown',\n position: 'left',\n dropdownItemsAfter: [{to: '/versions', label: 'All versions'}],\n dropdownActiveClassDisabled: true,\n },\n // highlight-end\n ],\n },\n },\n};\n"})}),"\n",(0,d.jsx)(n.h4,{id:"navbar-docs-version",children:"Navbar docs version"}),"\n",(0,d.jsx)(n.p,{children:"If you use docs with versioning, this special navbar item type will link to the active/browsed version of your doc (depends on the current URL), and fallback to the latest version."}),"\n",(0,d.jsx)(n.p,{children:"Accepted fields:"}),"\n",(0,d.jsx)(t.Z,{name:"navbar-docs-version",children:(0,d.jsxs)(n.table,{children:[(0,d.jsx)(n.thead,{children:(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.th,{children:"Name"}),(0,d.jsx)(n.th,{children:"Type"}),(0,d.jsx)(n.th,{children:"Default"}),(0,d.jsx)(n.th,{children:"Description"})]})}),(0,d.jsxs)(n.tbody,{children:[(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"type"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"'docsVersion'"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.strong,{children:"Required"})}),(0,d.jsx)(n.td,{children:"Sets the type of this item to a doc version link."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"label"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:"The active/latest version label."}),(0,d.jsx)(n.td,{children:"The name to be shown for this item."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"to"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:"The active/latest version."}),(0,d.jsx)(n.td,{children:"The internal link that this item points to."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"position"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)("code",{children:"'left' | 'right'"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"'left'"})}),(0,d.jsx)(n.td,{children:"The side of the navbar this item should appear on."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"docsPluginId"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"'default'"})}),(0,d.jsx)(n.td,{children:"The ID of the docs plugin that the doc versioning belongs to."})]})]})]})}),"\n",(0,d.jsx)(n.p,{children:"Example configuration:"}),"\n",(0,d.jsx)(n.pre,{children:(0,d.jsx)(n.code,{className:"language-js",metastring:'title="docusaurus.config.js"',children:"export default {\n themeConfig: {\n navbar: {\n items: [\n // highlight-start\n {\n type: 'docsVersion',\n position: 'left',\n to: '/path',\n label: 'label',\n },\n // highlight-end\n ],\n },\n },\n};\n"})}),"\n",(0,d.jsx)(n.h4,{id:"navbar-locale-dropdown",children:"Navbar locale dropdown"}),"\n",(0,d.jsxs)(n.p,{children:["If you use the ",(0,d.jsx)(n.a,{href:"/docs/i18n/introduction",children:"i18n feature"}),", this special navbar item type will render a dropdown with all your site's available locales."]}),"\n",(0,d.jsx)(n.p,{children:"The user will be able to switch from one locale to another, while staying on the same page."}),"\n",(0,d.jsx)(n.p,{children:"Accepted fields:"}),"\n",(0,d.jsx)(t.Z,{name:"navbar-locale-dropdown",children:(0,d.jsxs)(n.table,{children:[(0,d.jsx)(n.thead,{children:(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.th,{children:"Name"}),(0,d.jsx)(n.th,{children:"Type"}),(0,d.jsx)(n.th,{children:"Default"}),(0,d.jsx)(n.th,{children:"Description"})]})}),(0,d.jsxs)(n.tbody,{children:[(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"type"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"'localeDropdown'"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.strong,{children:"Required"})}),(0,d.jsx)(n.td,{children:"Sets the type of this item to a locale dropdown."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"position"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)("code",{children:"'left' | 'right'"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"'left'"})}),(0,d.jsx)(n.td,{children:"The side of the navbar this item should appear on."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"dropdownItemsBefore"})}),(0,d.jsx)(n.td,{children:(0,d.jsxs)("code",{children:[(0,d.jsx)(n.a,{href:"#navbar-dropdown",children:"LinkLikeItem"}),"[]"]})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"[]"})}),(0,d.jsx)(n.td,{children:"Add additional dropdown items at the beginning of the dropdown."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"dropdownItemsAfter"})}),(0,d.jsx)(n.td,{children:(0,d.jsxs)("code",{children:[(0,d.jsx)(n.a,{href:"#navbar-dropdown",children:"LinkLikeItem"}),"[]"]})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"[]"})}),(0,d.jsx)(n.td,{children:"Add additional dropdown items at the end of the dropdown."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"queryString"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"undefined"})}),(0,d.jsx)(n.td,{children:"The query string to be appended to the URL."})]})]})]})}),"\n",(0,d.jsx)(n.p,{children:"Example configuration:"}),"\n",(0,d.jsx)(n.pre,{children:(0,d.jsx)(n.code,{className:"language-js",metastring:'title="docusaurus.config.js"',children:"export default {\n themeConfig: {\n navbar: {\n items: [\n // highlight-start\n {\n type: 'localeDropdown',\n position: 'left',\n dropdownItemsAfter: [\n {\n to: 'https://my-site.com/help-us-translate',\n label: 'Help us translate',\n },\n ],\n },\n // highlight-end\n ],\n },\n },\n};\n"})}),"\n",(0,d.jsx)(n.h4,{id:"navbar-search",children:"Navbar search"}),"\n",(0,d.jsxs)(n.p,{children:["If you use the ",(0,d.jsx)(n.a,{href:"/docs/search",children:"search"}),", the search bar will be the rightmost element in the navbar."]}),"\n",(0,d.jsx)(n.p,{children:"However, with this special navbar item type, you can change the default location."}),"\n",(0,d.jsx)(t.Z,{name:"navbar-search",children:(0,d.jsxs)(n.table,{children:[(0,d.jsx)(n.thead,{children:(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.th,{children:"Name"}),(0,d.jsx)(n.th,{children:"Type"}),(0,d.jsx)(n.th,{children:"Default"}),(0,d.jsx)(n.th,{children:"Description"})]})}),(0,d.jsxs)(n.tbody,{children:[(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"type"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"'search'"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.strong,{children:"Required"})}),(0,d.jsx)(n.td,{children:"Sets the type of this item to a search bar."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"position"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)("code",{children:"'left' | 'right'"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"'left'"})}),(0,d.jsx)(n.td,{children:"The side of the navbar this item should appear on."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"className"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:"/"}),(0,d.jsx)(n.td,{children:"Custom CSS class for this navbar item."})]})]})]})}),"\n",(0,d.jsx)(n.pre,{children:(0,d.jsx)(n.code,{className:"language-js",metastring:'title="docusaurus.config.js"',children:"export default {\n themeConfig: {\n navbar: {\n items: [\n // highlight-start\n {\n type: 'search',\n position: 'right',\n },\n // highlight-end\n ],\n },\n },\n};\n"})}),"\n",(0,d.jsx)(n.h4,{id:"navbar-with-custom-html",children:"Navbar with custom HTML"}),"\n",(0,d.jsx)(n.p,{children:"You can also render your own HTML markup inside a navbar item using this navbar item type."}),"\n",(0,d.jsx)(t.Z,{name:"navbar-html",children:(0,d.jsxs)(n.table,{children:[(0,d.jsx)(n.thead,{children:(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.th,{children:"Name"}),(0,d.jsx)(n.th,{children:"Type"}),(0,d.jsx)(n.th,{children:"Default"}),(0,d.jsx)(n.th,{children:"Description"})]})}),(0,d.jsxs)(n.tbody,{children:[(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"type"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"'html'"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.strong,{children:"Required"})}),(0,d.jsx)(n.td,{children:"Sets the type of this item to a HTML element."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"position"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)("code",{children:"'left' | 'right'"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"'left'"})}),(0,d.jsx)(n.td,{children:"The side of the navbar this item should appear on."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"className"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"''"})}),(0,d.jsx)(n.td,{children:"Custom CSS class for this navbar item."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"value"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"''"})}),(0,d.jsx)(n.td,{children:"Custom HTML to be rendered inside this navbar item."})]})]})]})}),"\n",(0,d.jsx)(n.pre,{children:(0,d.jsx)(n.code,{className:"language-js",metastring:'title="docusaurus.config.js"',children:"export default {\n themeConfig: {\n navbar: {\n items: [\n // highlight-start\n {\n type: 'html',\n position: 'right',\n value: '',\n },\n // highlight-end\n ],\n },\n },\n};\n"})}),"\n",(0,d.jsx)(n.h3,{id:"auto-hide-sticky-navbar",children:"Auto-hide sticky navbar"}),"\n",(0,d.jsx)(n.p,{children:"You can enable this cool UI feature that automatically hides the navbar when a user starts scrolling down the page, and show it again when the user scrolls up."}),"\n",(0,d.jsx)(n.pre,{children:(0,d.jsx)(n.code,{className:"language-js",metastring:'title="docusaurus.config.js"',children:"export default {\n themeConfig: {\n navbar: {\n // highlight-next-line\n hideOnScroll: true,\n },\n },\n};\n"})}),"\n",(0,d.jsx)(n.h3,{id:"navbar-style",children:"Navbar style"}),"\n",(0,d.jsx)(n.p,{children:"You can set the static Navbar style without disabling the theme switching ability. The selected style will always apply no matter which theme user have selected."}),"\n",(0,d.jsxs)(n.p,{children:["Currently, there are two possible style options: ",(0,d.jsx)(n.code,{children:"dark"})," and ",(0,d.jsx)(n.code,{children:"primary"})," (based on the ",(0,d.jsx)(n.code,{children:"--ifm-color-primary"})," color). You can see the styles preview in the ",(0,d.jsx)(n.a,{href:"https://infima.dev/docs/components/navbar/",children:"Infima documentation"}),"."]}),"\n",(0,d.jsx)(n.pre,{children:(0,d.jsx)(n.code,{className:"language-js",metastring:'title="docusaurus.config.js"',children:"export default {\n themeConfig: {\n navbar: {\n // highlight-next-line\n style: 'primary',\n },\n },\n};\n"})}),"\n",(0,d.jsx)(n.h2,{id:"codeblock",children:"CodeBlock"}),"\n",(0,d.jsxs)(n.p,{children:["Docusaurus uses ",(0,d.jsx)(n.a,{href:"https://github.com/FormidableLabs/prism-react-renderer",children:"Prism React Renderer"})," to highlight code blocks. All configuration are in the ",(0,d.jsx)(n.code,{children:"prism"})," object."]}),"\n",(0,d.jsx)(n.p,{children:"Accepted fields:"}),"\n",(0,d.jsx)(t.Z,{name:"codeblock",children:(0,d.jsxs)(n.table,{children:[(0,d.jsx)(n.thead,{children:(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.th,{children:"Name"}),(0,d.jsx)(n.th,{children:"Type"}),(0,d.jsx)(n.th,{children:"Default"}),(0,d.jsx)(n.th,{children:"Description"})]})}),(0,d.jsxs)(n.tbody,{children:[(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"theme"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"PrismTheme"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"palenight"})}),(0,d.jsx)(n.td,{children:"The Prism theme to use for light-theme code blocks."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"darkTheme"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"PrismTheme"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"palenight"})}),(0,d.jsx)(n.td,{children:"The Prism theme to use for dark-theme code blocks."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"defaultLanguage"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"undefined"})}),(0,d.jsx)(n.td,{children:"The default language to use for code blocks not declaring any explicit language."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"magicComments"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"MagicCommentConfig[]"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.em,{children:"see below"})}),(0,d.jsxs)(n.td,{children:["The list of ",(0,d.jsx)(n.a,{href:"/docs/markdown-features/code-blocks#custom-magic-comments",children:"magic comments"}),"."]})]})]})]})}),"\n",(0,d.jsx)(n.pre,{children:(0,d.jsx)(n.code,{className:"language-ts",children:"type MagicCommentConfig = {\n className: string;\n line?: string;\n block?: {start: string; end: string};\n};\n"})}),"\n",(0,d.jsx)(n.pre,{children:(0,d.jsx)(n.code,{className:"language-js",children:"const defaultMagicComments = [\n {\n className: 'theme-code-block-highlighted-line',\n line: 'highlight-next-line',\n block: {start: 'highlight-start', end: 'highlight-end'},\n },\n];\n"})}),"\n",(0,d.jsx)(n.h3,{id:"theme",children:"Theme"}),"\n",(0,d.jsxs)(n.p,{children:["By default, we use ",(0,d.jsx)(n.a,{href:"https://github.com/FormidableLabs/prism-react-renderer/blob/master/packages/prism-react-renderer/src/themes/palenight.ts",children:"Palenight"})," as syntax highlighting theme. You can specify a custom theme from the ",(0,d.jsx)(n.a,{href:"https://github.com/FormidableLabs/prism-react-renderer/tree/master/packages/prism-react-renderer/src/themes",children:"list of available themes"}),". You may also use a different syntax highlighting theme when the site is in dark mode."]}),"\n",(0,d.jsx)(n.p,{children:"Example configuration:"}),"\n",(0,d.jsx)(n.pre,{children:(0,d.jsx)(n.code,{className:"language-js",metastring:'title="docusaurus.config.js"',children:"import {themes as prismThemes} from 'prism-react-renderer';\n\nexport default {\n themeConfig: {\n prism: {\n // highlight-start\n theme: prismThemes.github,\n darkTheme: prismThemes.dracula,\n // highlight-end\n },\n },\n};\n"})}),"\n",(0,d.jsx)(n.admonition,{type:"note",children:(0,d.jsxs)(n.p,{children:["If you use the line highlighting Markdown syntax, you might need to specify a different highlight background color for the dark mode syntax highlighting theme. Refer to the ",(0,d.jsx)(n.a,{href:"/docs/markdown-features/code-blocks#line-highlighting",children:"docs for guidance"}),"."]})}),"\n",(0,d.jsx)(n.h3,{id:"default-language",children:"Default language"}),"\n",(0,d.jsxs)(n.p,{children:["You can set a default language for code blocks if no language is added after the opening triple backticks (i.e. ```). Note that a valid ",(0,d.jsx)(n.a,{href:"https://prismjs.com/#supported-languages",children:"language name"})," must be passed."]}),"\n",(0,d.jsx)(n.p,{children:"Example configuration:"}),"\n",(0,d.jsx)(n.pre,{children:(0,d.jsx)(n.code,{className:"language-js",metastring:'title="docusaurus.config.js"',children:"export default {\n themeConfig: {\n prism: {\n // highlight-next-line\n defaultLanguage: 'javascript',\n },\n },\n};\n"})}),"\n",(0,d.jsx)(n.h2,{id:"footer-1",children:"Footer"}),"\n",(0,d.jsxs)(n.p,{children:["You can add logo and a copyright to the footer via ",(0,d.jsx)(n.code,{children:"themeConfig.footer"}),". Logo can be placed in ",(0,d.jsx)(n.a,{href:"/docs/static-assets",children:"static folder"}),". Logo URL works in the same way of the navbar logo."]}),"\n",(0,d.jsx)(n.p,{children:"Accepted fields:"}),"\n",(0,d.jsx)(t.Z,{name:"footer",children:(0,d.jsxs)(n.table,{children:[(0,d.jsx)(n.thead,{children:(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.th,{children:"Name"}),(0,d.jsx)(n.th,{children:"Type"}),(0,d.jsx)(n.th,{children:"Default"}),(0,d.jsx)(n.th,{children:"Description"})]})}),(0,d.jsxs)(n.tbody,{children:[(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"logo"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"Logo"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"undefined"})}),(0,d.jsxs)(n.td,{children:["Customization of the logo object. See ",(0,d.jsx)(n.a,{href:"#navbar-logo",children:"Navbar logo"})," for details."]})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"copyright"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"undefined"})}),(0,d.jsx)(n.td,{children:"The copyright message to be displayed at the bottom, also supports custom HTML."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"style"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)("code",{children:"'dark' | 'light'"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"'light'"})}),(0,d.jsx)(n.td,{children:"The color theme of the footer component."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"links"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)("code",{children:"(Column | FooterLink)[]"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"[]"})}),(0,d.jsx)(n.td,{children:"The link groups to be present."})]})]})]})}),"\n",(0,d.jsx)(n.p,{children:"Example configuration:"}),"\n",(0,d.jsx)(n.pre,{children:(0,d.jsx)(n.code,{className:"language-js",metastring:'title="docusaurus.config.js"',children:"export default {\n themeConfig: {\n // highlight-start\n footer: {\n logo: {\n alt: 'Meta Open Source Logo',\n src: 'img/meta_oss_logo.png',\n href: 'https://opensource.fb.com',\n width: 160,\n height: 51,\n },\n copyright: `Copyright \xa9 ${new Date().getFullYear()} My Project, Inc. Built with Docusaurus.`,\n },\n // highlight-end\n },\n};\n"})}),"\n",(0,d.jsx)(n.h3,{id:"footer-links",children:"Footer Links"}),"\n",(0,d.jsxs)(n.p,{children:["You can add links to the footer via ",(0,d.jsx)(n.code,{children:"themeConfig.footer.links"}),". There are two types of footer configurations: ",(0,d.jsx)(n.strong,{children:"multi-column footers"})," and ",(0,d.jsx)(n.strong,{children:"simple footers"}),"."]}),"\n",(0,d.jsxs)(n.p,{children:["Multi-column footer links have a ",(0,d.jsx)(n.code,{children:"title"})," and a list of ",(0,d.jsx)(n.code,{children:"FooterItem"}),"s for each column."]}),"\n",(0,d.jsx)(t.Z,{name:"footer-links",children:(0,d.jsxs)(n.table,{children:[(0,d.jsx)(n.thead,{children:(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.th,{children:"Name"}),(0,d.jsx)(n.th,{children:"Type"}),(0,d.jsx)(n.th,{children:"Default"}),(0,d.jsx)(n.th,{children:"Description"})]})}),(0,d.jsxs)(n.tbody,{children:[(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"title"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"undefined"})}),(0,d.jsx)(n.td,{children:"Label of the section of these links."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"items"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"FooterItem[]"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"[]"})}),(0,d.jsx)(n.td,{children:"Links in this section."})]})]})]})}),"\n",(0,d.jsxs)(n.p,{children:["Accepted fields of each ",(0,d.jsx)(n.code,{children:"FooterItem"}),":"]}),"\n",(0,d.jsx)(t.Z,{name:"footer-items",children:(0,d.jsxs)(n.table,{children:[(0,d.jsx)(n.thead,{children:(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.th,{children:"Name"}),(0,d.jsx)(n.th,{children:"Type"}),(0,d.jsx)(n.th,{children:"Default"}),(0,d.jsx)(n.th,{children:"Description"})]})}),(0,d.jsxs)(n.tbody,{children:[(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"label"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.strong,{children:"Required"})}),(0,d.jsx)(n.td,{children:"Text to be displayed for this link."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"to"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.strong,{children:"Required"})}),(0,d.jsx)(n.td,{children:"Client-side routing, used for navigating within the website. The baseUrl will be automatically prepended to this value."})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"href"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.strong,{children:"Required"})}),(0,d.jsxs)(n.td,{children:["A full-page navigation, used for navigating outside of the website. ",(0,d.jsxs)(n.strong,{children:["Only one of ",(0,d.jsx)(n.code,{children:"to"})," or ",(0,d.jsx)(n.code,{children:"href"})," should be used."]})]})]}),(0,d.jsxs)(n.tr,{children:[(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"html"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"string"})}),(0,d.jsx)(n.td,{children:(0,d.jsx)(n.code,{children:"undefined"})}),(0,d.jsxs)(n.td,{children:["Renders the HTML pass-through instead of a simple link. In case ",(0,d.jsx)(n.code,{children:"html"})," is used, no other options should be provided."]})]})]})]})}),"\n",(0,d.jsx)(n.p,{children:"Example multi-column configuration:"}),"\n",(0,d.jsx)(n.pre,{children:(0,d.jsx)(n.code,{className:"language-js",metastring:'title="docusaurus.config.js"',children:"export default {\n footer: {\n // highlight-start\n links: [\n {\n title: 'Docs',\n items: [\n {\n label: 'Style Guide',\n to: 'docs/',\n },\n {\n label: 'Second Doc',\n to: 'docs/doc2/',\n },\n ],\n },\n {\n title: 'Community',\n items: [\n {\n label: 'Stack Overflow',\n href: 'https://stackoverflow.com/questions/tagged/docusaurus',\n },\n {\n label: 'Discord',\n href: 'https://discordapp.com/invite/docusaurus',\n },\n {\n label: 'Twitter',\n href: 'https://twitter.com/docusaurus',\n },\n {\n html: `\n \n docusaurus.config.js
settings",id:"docusaurusconfigjs-settings",level:3},{value:"Environment settings",id:"environment-settings",level:3},{value:"Deploy",id:"deploy",level:3},{value:"Triggering deployment with GitHub Actions",id:"triggering-deployment-with-github-actions",level:3},{value:"Triggering deployment with Travis CI",id:"triggering-deployment-with-travis-ci",level:3},{value:"Triggering deployment with Buddy",id:"triggering-deployment-with-buddy",level:3},{value:"Using Azure Pipelines",id:"using-azure-pipelines",level:3},{value:"Using Drone",id:"using-drone",level:3},{value:"Deploying to Flightcontrol",id:"deploying-to-flightcontrol",level:2},{value:"Deploying to Koyeb",id:"deploying-to-koyeb",level:2},{value:"Deploying to Render",id:"deploying-to-render",level:2},{value:"Deploying to Qovery",id:"deploying-to-qovery",level:2},{value:"Deploying to Hostman",id:"deploying-to-hostman",level:2},{value:"Deploying to Surge",id:"deploying-to-surge",level:2},{value:"Using your domain",id:"using-your-domain",level:3},{value:"Setting up CNAME file",id:"setting-up-cname-file",level:3},{value:"Deploying to Stormkit",id:"deploying-to-stormkit",level:2},{value:"Deploying to QuantCDN",id:"deploying-to-quantcdn",level:2},{value:"Deploying to Layer0",id:"deploying-to-layer0",level:2},{value:"Deploying to Cloudflare Pages",id:"deploying-to-cloudflare-pages",level:2},{value:"Deploying to Azure Static Web Apps",id:"deploying-to-azure-static-web-apps",level:2},{value:"Deploying to Kinsta",id:"deploying-to-kinsta",level:2}];function u(e){const n={a:"a",admonition:"admonition",code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",img:"img",li:"li",ol:"ol",p:"p",pre:"pre",strong:"strong",table:"table",tbody:"tbody",td:"td",th:"th",thead:"thead",tr:"tr",ul:"ul",...(0,i.a)(),...e.components},{Details:s}=n;return s||function(e,n){throw new Error("Expected "+(n?"component":"object")+" `"+e+"` to be defined: you likely forgot to import, pass, or provide it.")}("Details",!0),(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(n.h1,{id:"deployment",children:"Deployment"}),"\n",(0,t.jsx)(n.p,{children:"To build the static files of your website for production, run:"}),"\n",(0,t.jsxs)(o.Z,{groupId:"npm2yarn",children:[(0,t.jsx)(r.Z,{value:"npm",children:(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",children:"npm run build\n"})})}),(0,t.jsx)(r.Z,{value:"yarn",label:"Yarn",children:(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",children:"yarn build\n"})})}),(0,t.jsx)(r.Z,{value:"pnpm",label:"pnpm",children:(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",children:"pnpm run build\n"})})})]}),"\n",(0,t.jsxs)(n.p,{children:["Once it finishes, the static files will be generated within the ",(0,t.jsx)(n.code,{children:"build"})," directory."]}),"\n",(0,t.jsxs)(n.admonition,{type:"note",children:[(0,t.jsxs)(n.p,{children:["The only responsibility of Docusaurus is to build your site and emit static files in ",(0,t.jsx)(n.code,{children:"build"}),"."]}),(0,t.jsx)(n.p,{children:"It is now up to you to choose how to host those static files."})]}),"\n",(0,t.jsxs)(n.p,{children:["You can deploy your site to static site hosting services such as ",(0,t.jsx)(n.a,{href:"https://vercel.com/",children:"Vercel"}),", ",(0,t.jsx)(n.a,{href:"https://pages.github.com/",children:"GitHub Pages"}),", ",(0,t.jsx)(n.a,{href:"https://www.netlify.com/",children:"Netlify"}),", ",(0,t.jsx)(n.a,{href:"https://render.com/docs/static-sites",children:"Render"}),", and ",(0,t.jsx)(n.a,{href:"https://surge.sh/help/getting-started-with-surge",children:"Surge"}),"."]}),"\n",(0,t.jsx)(n.p,{children:"A Docusaurus site is statically rendered, and it can generally work without JavaScript!"}),"\n",(0,t.jsx)(n.h2,{id:"configuration",children:"Configuration"}),"\n",(0,t.jsxs)(n.p,{children:["The following parameters are required in ",(0,t.jsx)(n.code,{children:"docusaurus.config.js"})," to optimize routing and serve files from the correct location:"]}),"\n",(0,t.jsxs)(n.table,{children:[(0,t.jsx)(n.thead,{children:(0,t.jsxs)(n.tr,{children:[(0,t.jsx)(n.th,{children:"Name"}),(0,t.jsx)(n.th,{children:"Description"})]})}),(0,t.jsxs)(n.tbody,{children:[(0,t.jsxs)(n.tr,{children:[(0,t.jsx)(n.td,{children:(0,t.jsx)(n.code,{children:"url"})}),(0,t.jsxs)(n.td,{children:["URL for your site. For a site deployed at ",(0,t.jsx)(n.code,{children:"https://my-org.com/my-project/"}),", ",(0,t.jsx)(n.code,{children:"url"})," is ",(0,t.jsx)(n.code,{children:"https://my-org.com/"}),"."]})]}),(0,t.jsxs)(n.tr,{children:[(0,t.jsx)(n.td,{children:(0,t.jsx)(n.code,{children:"baseUrl"})}),(0,t.jsxs)(n.td,{children:["Base URL for your project, with a trailing slash. For a site deployed at ",(0,t.jsx)(n.code,{children:"https://my-org.com/my-project/"}),", ",(0,t.jsx)(n.code,{children:"baseUrl"})," is ",(0,t.jsx)(n.code,{children:"/my-project/"}),"."]})]})]})]}),"\n",(0,t.jsx)(n.h2,{id:"testing-build-locally",children:"Testing your Build Locally"}),"\n",(0,t.jsxs)(n.p,{children:["It is important to test your build locally before deploying it for production. Docusaurus provides a ",(0,t.jsx)(n.a,{href:"/docs/cli#docusaurus-serve-sitedir",children:(0,t.jsx)(n.code,{children:"docusaurus serve"})})," command for that:"]}),"\n",(0,t.jsxs)(o.Z,{groupId:"npm2yarn",children:[(0,t.jsx)(r.Z,{value:"npm",children:(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",children:"npm run serve\n"})})}),(0,t.jsx)(r.Z,{value:"yarn",label:"Yarn",children:(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",children:"yarn serve\n"})})}),(0,t.jsx)(r.Z,{value:"pnpm",label:"pnpm",children:(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-bash",children:"pnpm run serve\n"})})})]}),"\n",(0,t.jsxs)(n.p,{children:["By default, this will load your site at ",(0,t.jsx)(n.a,{href:"http://localhost:3000/",children:(0,t.jsx)(n.code,{children:"http://localhost:3000/"})}),"."]}),"\n",(0,t.jsx)(n.h2,{id:"trailing-slashes",children:"Trailing slash configuration"}),"\n",(0,t.jsxs)(n.p,{children:["Docusaurus has a ",(0,t.jsxs)(n.a,{href:"/docs/api/docusaurus-config#trailingSlash",children:[(0,t.jsx)(n.code,{children:"trailingSlash"})," config"]})," to allow customizing URLs/links and emitted filename patterns."]}),"\n",(0,t.jsxs)(n.p,{children:["The default value generally works fine. Unfortunately, each static hosting provider has a ",(0,t.jsx)(n.strong,{children:"different behavior"}),", and deploying the exact same site to various hosts can lead to distinct results. Depending on your host, it can be useful to change this config."]}),"\n",(0,t.jsx)(n.admonition,{type:"tip",children:(0,t.jsxs)(n.p,{children:["Use ",(0,t.jsx)(n.a,{href:"https://github.com/slorber/trailing-slash-guide",children:"slorber/trailing-slash-guide"})," to understand better the behavior of your host and configure ",(0,t.jsx)(n.code,{children:"trailingSlash"})," appropriately."]})}),"\n",(0,t.jsx)(n.h2,{id:"using-environment-variables",children:"Using environment variables"}),"\n",(0,t.jsxs)(n.p,{children:["Putting potentially sensitive information in the environment is common practice. However, in a typical Docusaurus website, the ",(0,t.jsx)(n.code,{children:"docusaurus.config.js"})," file is the only interface to the Node.js environment (see ",(0,t.jsx)(n.a,{href:"/docs/advanced/architecture",children:"our architecture overview"}),"), while everything else (MDX pages, React components, etc.) are client side and do not have direct access to the ",(0,t.jsx)(n.code,{children:"process"})," global variable. In this case, you can consider using ",(0,t.jsx)(n.a,{href:"/docs/api/docusaurus-config#customFields",children:(0,t.jsx)(n.code,{children:"customFields"})})," to pass environment variables to the client side."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-js",metastring:'title="docusaurus.config.js"',children:"// If you are using dotenv (https://www.npmjs.com/package/dotenv)\nimport 'dotenv/config';\n\nexport default {\n title: '...',\n url: process.env.URL, // You can use environment variables to control site specifics as well\n // highlight-start\n customFields: {\n // Put your custom environment here\n teamEmail: process.env.EMAIL,\n },\n // highlight-end\n};\n"})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-jsx",metastring:'title="home.jsx"',children:"import useDocusaurusContext from '@docusaurus/useDocusaurusContext';\n\nexport default function Home() {\n const {\n siteConfig: {customFields},\n } = useDocusaurusContext();\n return -t, --typescript
",id:"typescript",level:3},{value:"-g, --git-strategy
",id:"git-strategy",level:3},{value:"-p, --package-manager
",id:"package-manager",level:3},{value:"-s, --skip-install
",id:"skip-install",level:3}];function d(e){const s={admonition:"admonition",code:"code",h1:"h1",h2:"h2",h3:"h3",li:"li",p:"p",pre:"pre",ul:"ul",...(0,t.a)(),...e.components};return(0,n.jsxs)(n.Fragment,{children:[(0,n.jsx)(s.h1,{id:"-create-docusaurus",children:"\ud83d\udce6 create-docusaurus"}),"\n",(0,n.jsx)(s.p,{children:"A scaffolding utility to help you instantly set up a functional Docusaurus app."}),"\n",(0,n.jsx)(s.h2,{id:"usage",children:"Usage"}),"\n",(0,n.jsx)(s.pre,{children:(0,n.jsx)(s.code,{className:"language-bash",children:"npx create-docusaurus@latest [name] [template] [rootDir]\n"})}),"\n",(0,n.jsxs)(s.p,{children:["The ",(0,n.jsx)(s.code,{children:"name"})," argument will be used as the site's path as well as the ",(0,n.jsx)(s.code,{children:"name"})," field in the created app's package.json. It can be an absolute path, or a path relative to ",(0,n.jsx)(s.code,{children:"rootDir"}),"."]}),"\n",(0,n.jsxs)(s.p,{children:["The ",(0,n.jsx)(s.code,{children:"template"})," argument can be one of the following:"]}),"\n",(0,n.jsxs)(s.ul,{children:["\n",(0,n.jsxs)(s.li,{children:[(0,n.jsx)(s.code,{children:"classic"}),": Uses the classic template (recommended)"]}),"\n",(0,n.jsxs)(s.li,{children:[(0,n.jsx)(s.code,{children:"facebook"}),": Uses the Facebook/Meta template, which contains some Meta-specific setup"]}),"\n",(0,n.jsxs)(s.li,{children:["A git repo URL (beginning with ",(0,n.jsx)(s.code,{children:"https://"})," or ",(0,n.jsx)(s.code,{children:"git@"}),"), which can be cloned to the destination"]}),"\n",(0,n.jsx)(s.li,{children:"A local file path relative to CWD, which contains the files to be copied to destination"}),"\n"]}),"\n",(0,n.jsxs)(s.p,{children:["The ",(0,n.jsx)(s.code,{children:"rootDir"})," will be used to resolve the absolute path to the site directory. The default is CWD."]}),"\n",(0,n.jsx)(s.admonition,{type:"warning",children:(0,n.jsx)(s.p,{children:"This command should be preferably used in an interactive shell so all features are available."})}),"\n",(0,n.jsx)(s.h2,{id:"options",children:"Options"}),"\n",(0,n.jsx)(s.h3,{id:"typescript",children:(0,n.jsx)(s.code,{children:"-t, --typescript"})}),"\n",(0,n.jsxs)(s.p,{children:["Used when the template argument is a recognized name. Currently, only ",(0,n.jsx)(s.code,{children:"classic"})," provides a TypeScript variant."]}),"\n",(0,n.jsx)(s.h3,{id:"git-strategy",children:(0,n.jsx)(s.code,{children:"-g, --git-strategy"})}),"\n",(0,n.jsx)(s.p,{children:"Used when the template argument is a git repo. It needs to be one of:"}),"\n",(0,n.jsxs)(s.ul,{children:["\n",(0,n.jsxs)(s.li,{children:[(0,n.jsx)(s.code,{children:"deep"}),": preserves full git history"]}),"\n",(0,n.jsxs)(s.li,{children:[(0,n.jsx)(s.code,{children:"shallow"}),": clones with ",(0,n.jsx)(s.code,{children:"--depth=1"})]}),"\n",(0,n.jsxs)(s.li,{children:[(0,n.jsx)(s.code,{children:"copy"}),": does a shallow clone, but does not create a git repo"]}),"\n",(0,n.jsxs)(s.li,{children:[(0,n.jsx)(s.code,{children:"custom"}),": enter your custom git clone command. We will prompt you for it. You can write something like ",(0,n.jsx)(s.code,{children:"git clone --depth 10"}),", and we will append the repository URL and destination directory."]}),"\n"]}),"\n",(0,n.jsx)(s.h3,{id:"package-manager",children:(0,n.jsx)(s.code,{children:"-p, --package-manager"})}),"\n",(0,n.jsxs)(s.p,{children:["Value should be one of ",(0,n.jsx)(s.code,{children:"npm"}),", ",(0,n.jsx)(s.code,{children:"yarn"}),", ",(0,n.jsx)(s.code,{children:"pnpm"}),", or ",(0,n.jsx)(s.code,{children:"bun"}),". If it's not explicitly provided, Docusaurus will infer one based on:"]}),"\n",(0,n.jsxs)(s.ul,{children:["\n",(0,n.jsx)(s.li,{children:"The lockfile already present in the CWD (e.g. if you are setting up website in an existing project)"}),"\n",(0,n.jsxs)(s.li,{children:["The command used to invoke ",(0,n.jsx)(s.code,{children:"create-docusaurus"})," (e.g. ",(0,n.jsx)(s.code,{children:"npm init"}),", ",(0,n.jsx)(s.code,{children:"npx"}),", ",(0,n.jsx)(s.code,{children:"yarn create"}),", ",(0,n.jsx)(s.code,{children:"bunx"}),", etc.)"]}),"\n",(0,n.jsx)(s.li,{children:"Interactive prompting, in case all heuristics are not present"}),"\n"]}),"\n",(0,n.jsx)(s.h3,{id:"skip-install",children:(0,n.jsx)(s.code,{children:"-s, --skip-install"})}),"\n",(0,n.jsxs)(s.p,{children:["If provided, Docusaurus will not automatically install dependencies after creating the app. The ",(0,n.jsx)(s.code,{children:"--package-manager"})," option is only useful when you are actually installing dependencies."]})]})}function u(e={}){const{wrapper:s}={...(0,t.a)(),...e.components};return s?(0,n.jsx)(s,{...e,children:(0,n.jsx)(d,{...e})}):d(e)}},71670:(e,s,i)=>{i.d(s,{Z:()=>o,a:()=>a});var n=i(27378);const t={},c=n.createContext(t);function a(e){const s=n.useContext(c);return n.useMemo((function(){return"function"==typeof e?e(s):{...s,...e}}),[s,e])}function o(e){let s;return s=e.disableParentContext?"function"==typeof e.components?e.components(t):e.components||t:a(e.components),n.createElement(c.Provider,{value:s},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/07e02e06.36631e65.js b/assets/js/07e02e06.36631e65.js
new file mode 100644
index 0000000000..384d271c13
--- /dev/null
+++ b/assets/js/07e02e06.36631e65.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkwebsite=self.webpackChunkwebsite||[]).push([[99305],{70681:s=>{s.exports=JSON.parse('{"tag":{"label":"docusaurus","permalink":"/tests/blog/tags/docusaurus","allTagsPath":"/tests/blog/tags","count":4,"unlisted":false},"listMetadata":{"permalink":"/tests/blog/tags/docusaurus/page/2","page":2,"postsPerPage":3,"totalPages":2,"totalCount":4,"previousPage":"/tests/blog/tags/docusaurus","blogDescription":"Blog","blogTitle":"Blog"}}')}}]);
\ No newline at end of file
diff --git a/assets/js/08b2e33e.7d6ae115.js b/assets/js/08b2e33e.7d6ae115.js
new file mode 100644
index 0000000000..9b2bd1330c
--- /dev/null
+++ b/assets/js/08b2e33e.7d6ae115.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkwebsite=self.webpackChunkwebsite||[]).push([[20989],{3381:(e,a,t)=>{t.r(a),t.d(a,{assets:()=>r,contentTitle:()=>s,default:()=>l,frontMatter:()=>o,metadata:()=>h,toc:()=>u});var i=t(24246),n=t(71670);const o={mdx:{format:"md"},date:"2022-05-04T20:00",authors:["aerovulpe","AkiraVoid","andrewnicols","AntonPalmqvist","ApsarasX","chelproc","chernodub","CuratorCat","cwen0","cxOrz","DanRoscigno","deiucanta","deployn","Dr-Electron","dr-ngubo","duanwilliam","elias-pap","imsingh","jeffreyaven","jodyheavener","JohnnyMcWeed","johnnyreilly","Josh-Cena","kaycebasques","kgolubic","layerzzzio","leedom92","LeviticusMB","lex111","lukasbach","mjau-mjau","mxhdx","nartc","naveensrinivasan","pcordon","phryneas","Pierre-Gilles","redhat123456","rev4324","sandypockets","shczhen","slorber","sulu5890","surendran82","svix-ken","sykp241095","zzzhangqi"]},s="2.0.0-beta.19",h={permalink:"/changelog/2.0.0-beta.19",source:"@site/changelog/source/2.0.0-beta.19.md",title:"2.0.0-beta.19",description:"New Feature",date:"2022-05-04T20:00:00.000Z",tags:[],hasTruncateMarker:!0,authors:[{name:"Aaron Nwabuoku",alias:"aerovulpe",url:"https://github.com/aerovulpe",imageURL:"https://github.com/aerovulpe.png",key:"aerovulpe"},{name:"AkiraVoid",alias:"AkiraVoid",url:"https://github.com/AkiraVoid",imageURL:"https://github.com/AkiraVoid.png",key:"AkiraVoid"},{name:"Andrew Lyons",alias:"andrewnicols",url:"https://github.com/andrewnicols",imageURL:"https://github.com/andrewnicols.png",key:"andrewnicols"},{name:"apq",alias:"AntonPalmqvist",url:"https://github.com/AntonPalmqvist",imageURL:"https://github.com/AntonPalmqvist.png",key:"AntonPalmqvist"},{name:"ApsarasX",alias:"ApsarasX",url:"https://github.com/ApsarasX",imageURL:"https://github.com/ApsarasX.png",key:"ApsarasX"},{name:"chelproc",alias:"chelproc",url:"https://github.com/chelproc",imageURL:"https://github.com/chelproc.png",key:"chelproc"},{name:"Viktor Chernodub",alias:"chernodub",url:"https://github.com/chernodub",imageURL:"https://github.com/chernodub.png",key:"chernodub"},{name:"curatorcat.pcc.eth",alias:"CuratorCat",url:"https://github.com/CuratorCat",imageURL:"https://github.com/CuratorCat.png",key:"CuratorCat"},{name:"Cwen Yin",alias:"cwen0",url:"https://github.com/cwen0",imageURL:"https://github.com/cwen0.png",key:"cwen0"},{name:"Fusang\u2740",alias:"cxOrz",url:"https://github.com/cxOrz",imageURL:"https://github.com/cxOrz.png",key:"cxOrz"},{name:"Dan Roscigno",alias:"DanRoscigno",url:"https://github.com/DanRoscigno",imageURL:"https://github.com/DanRoscigno.png",key:"DanRoscigno"},{name:"Andrei Canta",alias:"deiucanta",url:"https://github.com/deiucanta",imageURL:"https://github.com/deiucanta.png",key:"deiucanta"},{name:"deployn",alias:"deployn",url:"https://github.com/deployn",imageURL:"https://github.com/deployn.png",key:"deployn"},{name:"Dr-Electron",alias:"Dr-Electron",url:"https://github.com/Dr-Electron",imageURL:"https://github.com/Dr-Electron.png",key:"Dr-Electron"},{name:"Chinazaekpere Ngubo",alias:"dr-ngubo",url:"https://github.com/dr-ngubo",imageURL:"https://github.com/dr-ngubo.png",key:"dr-ngubo"},{name:"duanwilliam",alias:"duanwilliam",url:"https://github.com/duanwilliam",imageURL:"https://github.com/duanwilliam.png",key:"duanwilliam"},{name:"Elias Papavasileiou",alias:"elias-pap",url:"https://github.com/elias-pap",imageURL:"https://github.com/elias-pap.png",key:"elias-pap"},{name:"Indermohan Singh",alias:"imsingh",url:"https://github.com/imsingh",imageURL:"https://github.com/imsingh.png",key:"imsingh"},{name:"Jeffrey Aven",alias:"jeffreyaven",url:"https://github.com/jeffreyaven",imageURL:"https://github.com/jeffreyaven.png",key:"jeffreyaven"},{name:"Jody Heavener",alias:"jodyheavener",url:"https://github.com/jodyheavener",imageURL:"https://github.com/jodyheavener.png",key:"jodyheavener"},{name:"JMW",alias:"JohnnyMcWeed",url:"https://github.com/JohnnyMcWeed",imageURL:"https://github.com/JohnnyMcWeed.png",key:"JohnnyMcWeed"},{name:"John Reilly",alias:"johnnyreilly",url:"https://github.com/johnnyreilly",imageURL:"https://github.com/johnnyreilly.png",key:"johnnyreilly"},{name:"Joshua Chen",alias:"Josh-Cena",url:"https://github.com/Josh-Cena",imageURL:"https://github.com/Josh-Cena.png",key:"Josh-Cena"},{name:"Kayce Basques",alias:"kaycebasques",url:"https://github.com/kaycebasques",imageURL:"https://github.com/kaycebasques.png",key:"kaycebasques"},{name:"kgolubic",alias:"kgolubic",url:"https://github.com/kgolubic",imageURL:"https://github.com/kgolubic.png",key:"kgolubic"},{name:"loic",alias:"layerzzzio",url:"https://github.com/layerzzzio",imageURL:"https://github.com/layerzzzio.png",key:"layerzzzio"},{name:"Leedom",alias:"leedom92",url:"https://github.com/leedom92",imageURL:"https://github.com/leedom92.png",key:"leedom92"},{name:"Martin Blom",alias:"LeviticusMB",url:"https://github.com/LeviticusMB",imageURL:"https://github.com/LeviticusMB.png",key:"LeviticusMB"},{name:"Alexey Pyltsyn",alias:"lex111",url:"https://github.com/lex111",imageURL:"https://github.com/lex111.png",key:"lex111"},{name:"Lukas Bach",alias:"lukasbach",url:"https://github.com/lukasbach",imageURL:"https://github.com/lukasbach.png",key:"lukasbach"},{name:"Karl Ward",alias:"mjau-mjau",url:"https://github.com/mjau-mjau",imageURL:"https://github.com/mjau-mjau.png",key:"mjau-mjau"},{name:"mehdim",alias:"mxhdx",url:"https://github.com/mxhdx",imageURL:"https://github.com/mxhdx.png",key:"mxhdx"},{name:"Chau Tran",alias:"nartc",url:"https://github.com/nartc",imageURL:"https://github.com/nartc.png",key:"nartc"},{name:"Naveen",alias:"naveensrinivasan",url:"https://github.com/naveensrinivasan",imageURL:"https://github.com/naveensrinivasan.png",key:"naveensrinivasan"},{name:"Pablo Cordon",alias:"pcordon",url:"https://github.com/pcordon",imageURL:"https://github.com/pcordon.png",key:"pcordon"},{name:"Lenz Weber-Tronic",alias:"phryneas",url:"https://github.com/phryneas",imageURL:"https://github.com/phryneas.png",key:"phryneas"},{name:"Pierre-Gilles Leymarie",alias:"Pierre-Gilles",url:"https://github.com/Pierre-Gilles",imageURL:"https://github.com/Pierre-Gilles.png",key:"Pierre-Gilles"},{name:"redhat123456",alias:"redhat123456",url:"https://github.com/redhat123456",imageURL:"https://github.com/redhat123456.png",key:"redhat123456"},{name:"rev",alias:"rev4324",url:"https://github.com/rev4324",imageURL:"https://github.com/rev4324.png",key:"rev4324"},{name:"Zac A",alias:"sandypockets",url:"https://github.com/sandypockets",imageURL:"https://github.com/sandypockets.png",key:"sandypockets"},{name:"czhen",alias:"shczhen",url:"https://github.com/shczhen",imageURL:"https://github.com/shczhen.png",key:"shczhen"},{name:"S\xe9bastien Lorber",alias:"slorber",url:"https://github.com/slorber",imageURL:"https://github.com/slorber.png",key:"slorber"},{name:"Evan",alias:"sulu5890",url:"https://github.com/sulu5890",imageURL:"https://github.com/sulu5890.png",key:"sulu5890"},{name:"surendran82",alias:"surendran82",url:"https://github.com/surendran82",imageURL:"https://github.com/surendran82.png",key:"surendran82"},{name:"svix-ken",alias:"svix-ken",url:"https://github.com/svix-ken",imageURL:"https://github.com/svix-ken.png",key:"svix-ken"},{name:"sykp241095",alias:"sykp241095",url:"https://github.com/sykp241095",imageURL:"https://github.com/sykp241095.png",key:"sykp241095"},{name:"Qi Zhang",alias:"zzzhangqi",url:"https://github.com/zzzhangqi",imageURL:"https://github.com/zzzhangqi.png",key:"zzzhangqi"}],frontMatter:{mdx:{format:"md"},date:"2022-05-04T20:00",authors:["aerovulpe","AkiraVoid","andrewnicols","AntonPalmqvist","ApsarasX","chelproc","chernodub","CuratorCat","cwen0","cxOrz","DanRoscigno","deiucanta","deployn","Dr-Electron","dr-ngubo","duanwilliam","elias-pap","imsingh","jeffreyaven","jodyheavener","JohnnyMcWeed","johnnyreilly","Josh-Cena","kaycebasques","kgolubic","layerzzzio","leedom92","LeviticusMB","lex111","lukasbach","mjau-mjau","mxhdx","nartc","naveensrinivasan","pcordon","phryneas","Pierre-Gilles","redhat123456","rev4324","sandypockets","shczhen","slorber","sulu5890","surendran82","svix-ken","sykp241095","zzzhangqi"]},unlisted:!1,prevItem:{title:"2.0.0-beta.20",permalink:"/changelog/2.0.0-beta.20"},nextItem:{title:"2.0.0-beta.18",permalink:"/changelog/2.0.0-beta.18"},listPageLink:"/changelog/page/2"},r={authorsImageUrls:[void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0]},u=[];function m(e){return(0,i.jsx)(i.Fragment,{})}function l(e={}){const{wrapper:a}={...(0,n.a)(),...e.components};return a?(0,i.jsx)(a,{...e,children:(0,i.jsx)(m,{...e})}):m()}},71670:(e,a,t)=>{t.d(a,{Z:()=>h,a:()=>s});var i=t(27378);const n={},o=i.createContext(n);function s(e){const a=i.useContext(o);return i.useMemo((function(){return"function"==typeof e?e(a):{...a,...e}}),[a,e])}function h(e){let a;return a=e.disableParentContext?"function"==typeof e.components?e.components(n):e.components||n:s(e.components),i.createElement(o.Provider,{value:a},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/08eb0f2d.97c644b7.js b/assets/js/08eb0f2d.97c644b7.js
new file mode 100644
index 0000000000..130005ea07
--- /dev/null
+++ b/assets/js/08eb0f2d.97c644b7.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkwebsite=self.webpackChunkwebsite||[]).push([[52453],{88675:(e,s,n)=>{n.r(s),n.d(s,{assets:()=>r,contentTitle:()=>a,default:()=>u,frontMatter:()=>c,metadata:()=>t,toc:()=>o});var i=n(24246),h=n(71670);const c={mdx:{format:"md"},date:"2022-07-08T20:00",authors:["201flaviosilva","7Wate","AkagiYui","alewolf","alexandernst","Altomy","anaclumos","bcabanes","BenDMyers","Boulet-","cbebe","clemiee","datlechin","DharsanB","dht","difranca","dpang314","emattia","forresst","Gary50613","ghostsquad","HyunseungLee-Travis","JeremyDolle","johnie","johnnyreilly","Josh-Cena","jpdriver","jqshuv","kursatsmsek","lanegoolsby","lex111","matkoch","metal-young","mrazauskas","pincman","redcamel","reinvanhaaren","RudraSen2","sado0823","saosangmo","scopsy","SheetJSDev","sigwinch28","slorber","Smilefounder","sserrata","szilarddoro","vannyle","webbertakken","yangshun","zpao"]},a="2.0.0-beta.22",t={permalink:"/changelog/2.0.0-beta.22",source:"@site/changelog/source/2.0.0-beta.22.md",title:"2.0.0-beta.22",description:"Breaking Change",date:"2022-07-08T20:00:00.000Z",tags:[],hasTruncateMarker:!0,authors:[{name:"Fl\xe1vio Silva",alias:"201flaviosilva",url:"https://github.com/201flaviosilva",imageURL:"https://github.com/201flaviosilva.png",key:"201flaviosilva"},{name:"7Wate",alias:"7Wate",url:"https://github.com/7Wate",imageURL:"https://github.com/7Wate.png",key:"7Wate"},{name:"\u8d64\u57ce\u7ed3\u8863",alias:"AkagiYui",url:"https://github.com/AkagiYui",imageURL:"https://github.com/AkagiYui.png",key:"AkagiYui"},{name:"alewolf",alias:"alewolf",url:"https://github.com/alewolf",imageURL:"https://github.com/alewolf.png",key:"alewolf"},{name:"Alexander Nestorov",alias:"alexandernst",url:"https://github.com/alexandernst",imageURL:"https://github.com/alexandernst.png",key:"alexandernst"},{name:"Ahmed Altomy",alias:"Altomy",url:"https://github.com/Altomy",imageURL:"https://github.com/Altomy.png",key:"Altomy"},{name:"Sunghyun Cho",alias:"anaclumos",url:"https://github.com/anaclumos",imageURL:"https://github.com/anaclumos.png",key:"anaclumos"},{name:"Benjamin Cabanes",alias:"bcabanes",url:"https://github.com/bcabanes",imageURL:"https://github.com/bcabanes.png",key:"bcabanes"},{name:"Ben Myers",alias:"BenDMyers",url:"https://github.com/BenDMyers",imageURL:"https://github.com/BenDMyers.png",key:"BenDMyers"},{name:"Boulet",alias:"Boulet-",url:"https://github.com/Boulet-",imageURL:"https://github.com/Boulet-.png",key:"Boulet-"},{name:"Charles Ancheta",alias:"cbebe",url:"https://github.com/cbebe",imageURL:"https://github.com/cbebe.png",key:"cbebe"},{name:"Clemie McCartney",alias:"clemiee",url:"https://github.com/clemiee",imageURL:"https://github.com/clemiee.png",key:"clemiee"},{name:"Ng\xf4 Qu\u1ed1c \u0110\u1ea1t",alias:"datlechin",url:"https://github.com/datlechin",imageURL:"https://github.com/datlechin.png",key:"datlechin"},{name:"Dharsan B",alias:"DharsanB",url:"https://github.com/DharsanB",imageURL:"https://github.com/DharsanB.png",key:"DharsanB"},{name:"dht",alias:"dht",url:"https://github.com/dht",imageURL:"https://github.com/dht.png",key:"dht"},{name:"Diego Fran\xe7a",alias:"difranca",url:"https://github.com/difranca",imageURL:"https://github.com/difranca.png",key:"difranca"},{name:"dpang314",alias:"dpang314",url:"https://github.com/dpang314",imageURL:"https://github.com/dpang314.png",key:"dpang314"},{name:"emattia",alias:"emattia",url:"https://github.com/emattia",imageURL:"https://github.com/emattia.png",key:"emattia"},{name:"Forresst",alias:"forresst",url:"https://github.com/forresst",imageURL:"https://github.com/forresst.png",key:"forresst"},{name:"\u51f1\u6069 Kane",alias:"Gary50613",url:"https://github.com/Gary50613",imageURL:"https://github.com/Gary50613.png",key:"Gary50613"},{name:"Wes McNamee",alias:"ghostsquad",url:"https://github.com/ghostsquad",imageURL:"https://github.com/ghostsquad.png",key:"ghostsquad"},{name:"Hyunseung Lee",alias:"HyunseungLee-Travis",url:"https://github.com/HyunseungLee-Travis",imageURL:"https://github.com/HyunseungLee-Travis.png",key:"HyunseungLee-Travis"},{name:"DOLLE",alias:"JeremyDolle",url:"https://github.com/JeremyDolle",imageURL:"https://github.com/JeremyDolle.png",key:"JeremyDolle"},{name:"Johnie Hjelm",alias:"johnie",url:"https://github.com/johnie",imageURL:"https://github.com/johnie.png",key:"johnie"},{name:"John Reilly",alias:"johnnyreilly",url:"https://github.com/johnnyreilly",imageURL:"https://github.com/johnnyreilly.png",key:"johnnyreilly"},{name:"Joshua Chen",alias:"Josh-Cena",url:"https://github.com/Josh-Cena",imageURL:"https://github.com/Josh-Cena.png",key:"Josh-Cena"},{name:"JP",alias:"jpdriver",url:"https://github.com/jpdriver",imageURL:"https://github.com/jpdriver.png",key:"jpdriver"},{name:"Joshua Schmitt",alias:"jqshuv",url:"https://github.com/jqshuv",imageURL:"https://github.com/jqshuv.png",key:"jqshuv"},{name:"K\xfcr\u015fat \u015eim\u015fek",alias:"kursatsmsek",url:"https://github.com/kursatsmsek",imageURL:"https://github.com/kursatsmsek.png",key:"kursatsmsek"},{name:"Lane Goolsby",alias:"lanegoolsby",url:"https://github.com/lanegoolsby",imageURL:"https://github.com/lanegoolsby.png",key:"lanegoolsby"},{name:"Alexey Pyltsyn",alias:"lex111",url:"https://github.com/lex111",imageURL:"https://github.com/lex111.png",key:"lex111"},{name:"Matthias Koch",alias:"matkoch",url:"https://github.com/matkoch",imageURL:"https://github.com/matkoch.png",key:"matkoch"},{name:"\u674e\u5c0f\u96e8",alias:"metal-young",url:"https://github.com/metal-young",imageURL:"https://github.com/metal-young.png",key:"metal-young"},{name:"Tom Mrazauskas",alias:"mrazauskas",url:"https://github.com/mrazauskas",imageURL:"https://github.com/mrazauskas.png",key:"mrazauskas"},{name:"pincman",alias:"pincman",url:"https://github.com/pincman",imageURL:"https://github.com/pincman.png",key:"pincman"},{name:"Redcamel",alias:"redcamel",url:"https://github.com/redcamel",imageURL:"https://github.com/redcamel.png",key:"redcamel"},{name:"Rein van Haaren",alias:"reinvanhaaren",url:"https://github.com/reinvanhaaren",imageURL:"https://github.com/reinvanhaaren.png",key:"reinvanhaaren"},{name:"Rudra Sen",alias:"RudraSen2",url:"https://github.com/RudraSen2",imageURL:"https://github.com/RudraSen2.png",key:"RudraSen2"},{name:"sado",alias:"sado0823",url:"https://github.com/sado0823",imageURL:"https://github.com/sado0823.png",key:"sado0823"},{name:"Dzung Do",alias:"saosangmo",url:"https://github.com/saosangmo",imageURL:"https://github.com/saosangmo.png",key:"saosangmo"},{name:"Dima Grossman",alias:"scopsy",url:"https://github.com/scopsy",imageURL:"https://github.com/scopsy.png",key:"scopsy"},{name:"SheetJSDev",alias:"SheetJSDev",url:"https://github.com/SheetJSDev",imageURL:"https://github.com/SheetJSDev.png",key:"SheetJSDev"},{name:"Joe Harrison",alias:"sigwinch28",url:"https://github.com/sigwinch28",imageURL:"https://github.com/sigwinch28.png",key:"sigwinch28"},{name:"S\xe9bastien Lorber",alias:"slorber",url:"https://github.com/slorber",imageURL:"https://github.com/slorber.png",key:"slorber"},{name:"Huy Nguyen",alias:"Smilefounder",url:"https://github.com/Smilefounder",imageURL:"https://github.com/Smilefounder.png",key:"Smilefounder"},{name:"Steven Serrata",alias:"sserrata",url:"https://github.com/sserrata",imageURL:"https://github.com/sserrata.png",key:"sserrata"},{name:"Szil\xe1rd D\xf3r\xf3",alias:"szilarddoro",url:"https://github.com/szilarddoro",imageURL:"https://github.com/szilarddoro.png",key:"szilarddoro"},{name:"Le Thi Van",alias:"vannyle",url:"https://github.com/vannyle",imageURL:"https://github.com/vannyle.png",key:"vannyle"},{name:"Webber Takken",alias:"webbertakken",url:"https://github.com/webbertakken",imageURL:"https://github.com/webbertakken.png",key:"webbertakken"},{name:"Yangshun Tay",alias:"yangshun",url:"https://github.com/yangshun",imageURL:"https://github.com/yangshun.png",key:"yangshun"},{name:"Paul O\u2019Shannessy",alias:"zpao",url:"https://github.com/zpao",imageURL:"https://github.com/zpao.png",key:"zpao"}],frontMatter:{mdx:{format:"md"},date:"2022-07-08T20:00",authors:["201flaviosilva","7Wate","AkagiYui","alewolf","alexandernst","Altomy","anaclumos","bcabanes","BenDMyers","Boulet-","cbebe","clemiee","datlechin","DharsanB","dht","difranca","dpang314","emattia","forresst","Gary50613","ghostsquad","HyunseungLee-Travis","JeremyDolle","johnie","johnnyreilly","Josh-Cena","jpdriver","jqshuv","kursatsmsek","lanegoolsby","lex111","matkoch","metal-young","mrazauskas","pincman","redcamel","reinvanhaaren","RudraSen2","sado0823","saosangmo","scopsy","SheetJSDev","sigwinch28","slorber","Smilefounder","sserrata","szilarddoro","vannyle","webbertakken","yangshun","zpao"]},unlisted:!1,prevItem:{title:"2.0.0-rc.1",permalink:"/changelog/2.0.0-rc.1"},nextItem:{title:"2.0.0-beta.21",permalink:"/changelog/2.0.0-beta.21"},listPageLink:"/changelog/"},r={authorsImageUrls:[void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0]},o=[{value:"\ud83d\udca5 Breaking Change",id:"boom-breaking-change",level:2},{value:"\ud83d\ude80 New Feature",id:"rocket-new-feature",level:2},{value:"\ud83d\udc1b Bug Fix",id:"bug-bug-fix",level:2},{value:"\ud83d\udc85 Polish",id:"nail_care-polish",level:2},{value:"\ud83d\udcdd Documentation",id:"memo-documentation",level:2},{value:"\ud83d\udd27 Maintenance",id:"wrench-maintenance",level:2},{value:"Committers: 51",id:"committers-51",level:2}];function l(e){const s={a:"a",code:"code",h2:"h2",li:"li",ul:"ul",...(0,h.a)(),...e.components};return(0,i.jsxs)(i.Fragment,{children:[(0,i.jsx)(s.h2,{id:"boom-breaking-change",children:"\ud83d\udca5 Breaking Change"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-theme-classic"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7740",children:"#7740"})," refactor(theme): nest theme icons under subfolder @theme/Icon/* (",(0,i.jsx)(s.a,{href:"https://github.com/slorber",children:"@slorber"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-plugin-content-blog"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-theme-classic"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-theme-common"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7716",children:"#7716"})," refactor(theme): split BlogPostItem into smaller theme subcomponents (",(0,i.jsx)(s.a,{href:"https://github.com/slorber",children:"@slorber"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-theme-classic"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-theme-common"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-theme-search-algolia"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7660",children:"#7660"})," refactor(theme-common): split package into public/internal API entrypoints (",(0,i.jsx)(s.a,{href:"https://github.com/slorber",children:"@slorber"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-plugin-content-docs"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-theme-classic"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-theme-common"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7644",children:"#7644"})," refactor(docs,theme): split DocItem comp, useDoc hook (",(0,i.jsx)(s.a,{href:"https://github.com/slorber",children:"@slorber"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-logger"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-content-blog"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-content-docs"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-types"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-utils"}),", ",(0,i.jsx)(s.code,{children:"docusaurus"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7642",children:"#7642"}),' refactor: remove "error" reporting level, move reportMessage to logger (',(0,i.jsx)(s.a,{href:"https://github.com/Josh-Cena",children:"@Josh-Cena"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-mdx-loader"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-content-blog"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-content-docs"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-content-pages"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-theme-classic"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-utils-validation"}),", ",(0,i.jsx)(s.code,{children:"docusaurus"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7152",children:"#7152"})," refactor: handle all admonitions via JSX component (",(0,i.jsx)(s.a,{href:"https://github.com/lex111",children:"@lex111"}),")"]}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,i.jsx)(s.h2,{id:"rocket-new-feature",children:"\ud83d\ude80 New Feature"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-theme-translations"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7732",children:"#7732"})," feat(theme-translations): Dutch translation (",(0,i.jsx)(s.a,{href:"https://github.com/reinvanhaaren",children:"@reinvanhaaren"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7715",children:"#7715"})," feat(theme-translations): Swedish translation (",(0,i.jsx)(s.a,{href:"https://github.com/johnie",children:"@johnie"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-theme-search-algolia"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-theme-translations"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7666",children:"#7666"})," feat(algolia-search): allow translating search modal (",(0,i.jsx)(s.a,{href:"https://github.com/forresst",children:"@forresst"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"create-docusaurus"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-theme-classic"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-theme-common"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7643",children:"#7643"})," feat(theme-classic): themeConfig navbar/footer logos accept className/style + update Meta Open-Source Logo (",(0,i.jsx)(s.a,{href:"https://github.com/slorber",children:"@slorber"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-plugin-client-redirects"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7649",children:"#7649"})," feat(client-redirects): make plugin respect onDuplicateRoutes config (",(0,i.jsx)(s.a,{href:"https://github.com/Josh-Cena",children:"@Josh-Cena"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-plugin-content-blog"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-content-docs"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-types"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-utils"}),", ",(0,i.jsx)(s.code,{children:"docusaurus"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7624",children:"#7624"})," feat: allow customizing localization path of each locale (",(0,i.jsx)(s.a,{href:"https://github.com/Josh-Cena",children:"@Josh-Cena"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7581",children:"#7581"})," feat(core): allow opting out of HTML minification (",(0,i.jsx)(s.a,{href:"https://github.com/alexandernst",children:"@alexandernst"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-theme-classic"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-theme-common"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7557",children:"#7557"})," feat: allow specifying custom target for FooterLogo (",(0,i.jsx)(s.a,{href:"https://github.com/vannyle",children:"@vannyle"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-theme-classic"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-theme-common"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-theme-translations"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7556",children:"#7556"})," feat: add admonition type title translations (",(0,i.jsx)(s.a,{href:"https://github.com/slorber",children:"@slorber"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-plugin-content-blog"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-content-docs"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-content-pages"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-types"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-utils"}),", ",(0,i.jsx)(s.code,{children:"docusaurus"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7386",children:"#7386"})," feat(core): allow customizing the i18n directory path (",(0,i.jsx)(s.a,{href:"https://github.com/Josh-Cena",children:"@Josh-Cena"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-theme-live-codeblock"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7514",children:"#7514"})," feat(live-codeblock): add support for noInline to interactive code blocks (",(0,i.jsx)(s.a,{href:"https://github.com/jpdriver",children:"@jpdriver"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-plugin-content-docs"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7461",children:"#7461"})," feat(content-docs): last_update front matter (",(0,i.jsx)(s.a,{href:"https://github.com/dpang314",children:"@dpang314"}),")"]}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,i.jsx)(s.h2,{id:"bug-bug-fix",children:"\ud83d\udc1b Bug Fix"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-theme-classic"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7727",children:"#7727"})," fix(theme): show blog post edit link even when no tag & not truncated (",(0,i.jsx)(s.a,{href:"https://github.com/anaclumos",children:"@anaclumos"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7659",children:"#7659"})," fix(theme-classic): expose empty string alt text in navbar logos (",(0,i.jsx)(s.a,{href:"https://github.com/BenDMyers",children:"@BenDMyers"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7595",children:"#7595"})," fix(content-pages): add article wrapper around MDXContent (",(0,i.jsx)(s.a,{href:"https://github.com/matkoch",children:"@matkoch"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-theme-translations"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7694",children:"#7694"})," fix(theme-translations): typo in vi locale (",(0,i.jsx)(s.a,{href:"https://github.com/saosangmo",children:"@saosangmo"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-plugin-content-docs"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7638",children:"#7638"})," fix(docs): forward doc frontMatter.sidebar_custom_props to linking sidebar category (",(0,i.jsx)(s.a,{href:"https://github.com/slorber",children:"@slorber"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7634",children:"#7634"})," fix(content-docs): allow translating doc labels in sidebars.js (",(0,i.jsx)(s.a,{href:"https://github.com/Josh-Cena",children:"@Josh-Cena"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-utils"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7604",children:"#7604"})," fix(utils): allow any non-boundary characters in Markdown heading ID (",(0,i.jsx)(s.a,{href:"https://github.com/Josh-Cena",children:"@Josh-Cena"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-cssnano-preset"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7593",children:"#7593"})," fix(cssnano-preset): disable z-index minification (",(0,i.jsx)(s.a,{href:"https://github.com/dpang314",children:"@dpang314"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-theme-common"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7551",children:"#7551"})," fix(theme-classic): code block wrap mode should allow wrapping in the middle of a word (",(0,i.jsx)(s.a,{href:"https://github.com/slorber",children:"@slorber"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7485",children:"#7485"})," fix(theme-classic): inconsistent code block wrapping (",(0,i.jsx)(s.a,{href:"https://github.com/dpang314",children:"@dpang314"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-mdx-loader"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-module-type-aliases"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-content-blog"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-content-docs"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-content-pages"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-debug"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-google-analytics"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-google-gtag"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-ideal-image"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-pwa"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-sitemap"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-preset-classic"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-theme-classic"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-theme-common"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-types"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-utils-common"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-utils"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7521",children:"#7521"})," fix: make type-checking work in Yarn PnP (",(0,i.jsx)(s.a,{href:"https://github.com/Josh-Cena",children:"@Josh-Cena"}),")"]}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,i.jsx)(s.h2,{id:"nail_care-polish",children:"\ud83d\udc85 Polish"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-theme-translations"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7696",children:"#7696"})," fix(theme-translations): improve grammar of zh translation (",(0,i.jsx)(s.a,{href:"https://github.com/AkagiYui",children:"@AkagiYui"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7691",children:"#7691"})," chore(theme-translations): complete vi translations (",(0,i.jsx)(s.a,{href:"https://github.com/datlechin",children:"@datlechin"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7683",children:"#7683"})," chore(theme-translations): complete ar translations (",(0,i.jsx)(s.a,{href:"https://github.com/Altomy",children:"@Altomy"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7633",children:"#7633"})," chore(theme-translations): complete ko translations (",(0,i.jsx)(s.a,{href:"https://github.com/HyunseungLee-Travis",children:"@HyunseungLee-Travis"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7702",children:"#7702"})," feat(deploy): copy local git config to tmp repo (",(0,i.jsx)(s.a,{href:"https://github.com/ghostsquad",children:"@ghostsquad"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7600",children:"#7600"})," fix: force refresh on chunk preload error (",(0,i.jsx)(s.a,{href:"https://github.com/yangshun",children:"@yangshun"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-plugin-content-docs"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7673",children:"#7673"}),' fix(content-docs): format last update date as "Jun 19, 2020" (',(0,i.jsx)(s.a,{href:"https://github.com/sigwinch28",children:"@sigwinch28"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-theme-common"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-theme-search-algolia"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7671",children:"#7671"})," refactor(theme-common): rename useDynamicCallback to useEvent (",(0,i.jsx)(s.a,{href:"https://github.com/slorber",children:"@slorber"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-theme-common"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7648",children:"#7648"})," fix(theme-common): make useShallowMemoObject key-order-insensitive (",(0,i.jsx)(s.a,{href:"https://github.com/Josh-Cena",children:"@Josh-Cena"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"create-docusaurus"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7639",children:"#7639"})," chore(create): update the facebook template with current assets (",(0,i.jsx)(s.a,{href:"https://github.com/zpao",children:"@zpao"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7520",children:"#7520"})," feat: add engines field to templates' package.json (",(0,i.jsx)(s.a,{href:"https://github.com/johnnyreilly",children:"@johnnyreilly"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-mdx-loader"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-migrate"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-content-docs"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-pwa"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-theme-classic"}),", ",(0,i.jsx)(s.code,{children:"docusaurus"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7579",children:"#7579"})," refactor(pwa): simplify registerSW code, fix ESLint errors (",(0,i.jsx)(s.a,{href:"https://github.com/Josh-Cena",children:"@Josh-Cena"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-plugin-google-analytics"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-google-gtag"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7545",children:"#7545"})," feat(analytics): allow query/hash changes to be sent to GA (",(0,i.jsx)(s.a,{href:"https://github.com/lanegoolsby",children:"@lanegoolsby"}),")"]}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,i.jsx)(s.h2,{id:"memo-documentation",children:"\ud83d\udcdd Documentation"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:["Other\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7739",children:"#7739"})," docs: swizzle react-live with eject (",(0,i.jsx)(s.a,{href:"https://github.com/SheetJSDev",children:"@SheetJSDev"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7723",children:"#7723"})," docs: add GitHub pages deployment troubleshooting guide (",(0,i.jsx)(s.a,{href:"https://github.com/Josh-Cena",children:"@Josh-Cena"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7705",children:"#7705"})," docs: mention MDXContent (",(0,i.jsx)(s.a,{href:"https://github.com/Josh-Cena",children:"@Josh-Cena"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7675",children:"#7675"})," docs: add docusaurus-openapi-docs to resources (",(0,i.jsx)(s.a,{href:"https://github.com/sserrata",children:"@sserrata"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7677",children:"#7677"})," docs: add more info on github cross repo deployment (",(0,i.jsx)(s.a,{href:"https://github.com/bcabanes",children:"@bcabanes"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7563",children:"#7563"})," docs: add awesome-docusaurus resource (",(0,i.jsx)(s.a,{href:"https://github.com/webbertakken",children:"@webbertakken"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7665",children:"#7665"})," docs: add link from every category index page to the guide page (",(0,i.jsx)(s.a,{href:"https://github.com/Josh-Cena",children:"@Josh-Cena"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7519",children:"#7519"})," docs: multiple documentation elaborations (",(0,i.jsx)(s.a,{href:"https://github.com/Josh-Cena",children:"@Josh-Cena"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7518",children:"#7518"})," docs: remove useless front matter (",(0,i.jsx)(s.a,{href:"https://github.com/Josh-Cena",children:"@Josh-Cena"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7512",children:"#7512"})," docs: update Kent C. Dodds Twitter avatar (",(0,i.jsx)(s.a,{href:"https://github.com/DharsanB",children:"@DharsanB"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"create-docusaurus"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7611",children:"#7611"})," docs: advise using Node 18 in deployment (",(0,i.jsx)(s.a,{href:"https://github.com/Josh-Cena",children:"@Josh-Cena"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7582",children:"#7582"})," docs: make localhost links clickable (",(0,i.jsx)(s.a,{href:"https://github.com/dht",children:"@dht"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-plugin-client-redirects"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7607",children:"#7607"})," refactor(client-redirects): elaborate documentation, minor refactor (",(0,i.jsx)(s.a,{href:"https://github.com/Josh-Cena",children:"@Josh-Cena"}),")"]}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,i.jsx)(s.h2,{id:"wrench-maintenance",children:"\ud83d\udd27 Maintenance"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-theme-classic"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-theme-common"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7676",children:"#7676"})," refactor(theme): move LayoutProviders to Layout/Provider; composeProviders util (",(0,i.jsx)(s.a,{href:"https://github.com/slorber",children:"@slorber"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus-theme-classic"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7674",children:"#7674"})," chore: prevent importing theme components with relative paths (",(0,i.jsx)(s.a,{href:"https://github.com/slorber",children:"@slorber"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7664",children:"#7664"})," chore: upgrade Infima to alpha.40 (",(0,i.jsx)(s.a,{href:"https://github.com/slorber",children:"@slorber"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:["Other\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7663",children:"#7663"})," misc: share .vscode/extensions.json (",(0,i.jsx)(s.a,{href:"https://github.com/Josh-Cena",children:"@Josh-Cena"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"docusaurus"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7583",children:"#7583"})," refactor(cli): make the CLI an even thinner wrapper around command functions (",(0,i.jsx)(s.a,{href:"https://github.com/Josh-Cena",children:"@Josh-Cena"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7547",children:"#7547"})," chore: update static-site-generator-webpack-plugin (",(0,i.jsx)(s.a,{href:"https://github.com/slorber",children:"@slorber"}),")"]}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.code,{children:"create-docusaurus"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-cssnano-preset"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-logger"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-mdx-loader"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-migrate"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-client-redirects"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-content-blog"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-content-docs"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-content-pages"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-debug"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-google-analytics"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-google-gtag"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-ideal-image"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-pwa"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-plugin-sitemap"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-preset-classic"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-remark-plugin-npm2yarn"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-theme-classic"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-theme-common"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-theme-live-codeblock"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-theme-search-algolia"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-theme-translations"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-types"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-utils-common"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-utils-validation"}),", ",(0,i.jsx)(s.code,{children:"docusaurus-utils"}),", ",(0,i.jsx)(s.code,{children:"docusaurus"}),", ",(0,i.jsx)(s.code,{children:"eslint-plugin"}),", ",(0,i.jsx)(s.code,{children:"lqip-loader"}),", ",(0,i.jsx)(s.code,{children:"stylelint-copyright"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:[(0,i.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7586",children:"#7586"})," chore: upgrade to TS 4.7, compile with NodeNext (",(0,i.jsx)(s.a,{href:"https://github.com/Josh-Cena",children:"@Josh-Cena"}),")"]}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,i.jsx)(s.h2,{id:"committers-51",children:"Committers: 51"}),"\n",(0,i.jsxs)(s.ul,{children:["\n",(0,i.jsxs)(s.li,{children:["7Wate (",(0,i.jsx)(s.a,{href:"https://github.com/7Wate",children:"@7Wate"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Ahmed Altomy (",(0,i.jsx)(s.a,{href:"https://github.com/Altomy",children:"@Altomy"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Alexander Nestorov (",(0,i.jsx)(s.a,{href:"https://github.com/alexandernst",children:"@alexandernst"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Alexey Pyltsyn (",(0,i.jsx)(s.a,{href:"https://github.com/lex111",children:"@lex111"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Ben Myers (",(0,i.jsx)(s.a,{href:"https://github.com/BenDMyers",children:"@BenDMyers"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Benjamin Cabanes (",(0,i.jsx)(s.a,{href:"https://github.com/bcabanes",children:"@bcabanes"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Boulet (",(0,i.jsx)(s.a,{href:"https://github.com/Boulet-",children:"@Boulet-"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Charles Ancheta (",(0,i.jsx)(s.a,{href:"https://github.com/cbebe",children:"@cbebe"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Clemie McCartney (",(0,i.jsx)(s.a,{href:"https://github.com/clemiee",children:"@clemiee"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["DOLLE (",(0,i.jsx)(s.a,{href:"https://github.com/JeremyDolle",children:"@JeremyDolle"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Dharsan B (",(0,i.jsx)(s.a,{href:"https://github.com/DharsanB",children:"@DharsanB"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Diego Fran\xe7a (",(0,i.jsx)(s.a,{href:"https://github.com/difranca",children:"@difranca"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Dima Grossman (",(0,i.jsx)(s.a,{href:"https://github.com/scopsy",children:"@scopsy"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Dzung Do (",(0,i.jsx)(s.a,{href:"https://github.com/saosangmo",children:"@saosangmo"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Fl\xe1vio Silva (",(0,i.jsx)(s.a,{href:"https://github.com/201flaviosilva",children:"@201flaviosilva"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Forresst (",(0,i.jsx)(s.a,{href:"https://github.com/forresst",children:"@forresst"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Huy Nguyen (",(0,i.jsx)(s.a,{href:"https://github.com/Smilefounder",children:"@Smilefounder"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Hyunseung Lee (",(0,i.jsx)(s.a,{href:"https://github.com/HyunseungLee-Travis",children:"@HyunseungLee-Travis"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["JP (",(0,i.jsx)(s.a,{href:"https://github.com/jpdriver",children:"@jpdriver"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Joe Harrison (",(0,i.jsx)(s.a,{href:"https://github.com/sigwinch28",children:"@sigwinch28"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["John Reilly (",(0,i.jsx)(s.a,{href:"https://github.com/johnnyreilly",children:"@johnnyreilly"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Johnie Hjelm (",(0,i.jsx)(s.a,{href:"https://github.com/johnie",children:"@johnie"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Joshua Chen (",(0,i.jsx)(s.a,{href:"https://github.com/Josh-Cena",children:"@Josh-Cena"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Joshua Schmitt (",(0,i.jsx)(s.a,{href:"https://github.com/jqshuv",children:"@jqshuv"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["K\xfcr\u015fat \u015eim\u015fek (",(0,i.jsx)(s.a,{href:"https://github.com/kursatsmsek",children:"@kursatsmsek"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Lane Goolsby (",(0,i.jsx)(s.a,{href:"https://github.com/lanegoolsby",children:"@lanegoolsby"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Le Thi Van (",(0,i.jsx)(s.a,{href:"https://github.com/vannyle",children:"@vannyle"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Matthias Koch (",(0,i.jsx)(s.a,{href:"https://github.com/matkoch",children:"@matkoch"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Ng\xf4 Qu\u1ed1c \u0110\u1ea1t (",(0,i.jsx)(s.a,{href:"https://github.com/datlechin",children:"@datlechin"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Paul O\u2019Shannessy (",(0,i.jsx)(s.a,{href:"https://github.com/zpao",children:"@zpao"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Redcamel (",(0,i.jsx)(s.a,{href:"https://github.com/redcamel",children:"@redcamel"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Rein van Haaren (",(0,i.jsx)(s.a,{href:"https://github.com/reinvanhaaren",children:"@reinvanhaaren"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Rudra Sen (",(0,i.jsx)(s.a,{href:"https://github.com/RudraSen2",children:"@RudraSen2"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Steven Serrata (",(0,i.jsx)(s.a,{href:"https://github.com/sserrata",children:"@sserrata"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Sunghyun Cho (",(0,i.jsx)(s.a,{href:"https://github.com/anaclumos",children:"@anaclumos"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Szil\xe1rd D\xf3r\xf3 (",(0,i.jsx)(s.a,{href:"https://github.com/szilarddoro",children:"@szilarddoro"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["S\xe9bastien Lorber (",(0,i.jsx)(s.a,{href:"https://github.com/slorber",children:"@slorber"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Tom Mrazauskas (",(0,i.jsx)(s.a,{href:"https://github.com/mrazauskas",children:"@mrazauskas"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Webber Takken (",(0,i.jsx)(s.a,{href:"https://github.com/webbertakken",children:"@webbertakken"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Wes McNamee (",(0,i.jsx)(s.a,{href:"https://github.com/ghostsquad",children:"@ghostsquad"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["Yangshun Tay (",(0,i.jsx)(s.a,{href:"https://github.com/yangshun",children:"@yangshun"}),")"]}),"\n",(0,i.jsx)(s.li,{children:(0,i.jsx)(s.a,{href:"https://github.com/SheetJSDev",children:"@SheetJSDev"})}),"\n",(0,i.jsx)(s.li,{children:(0,i.jsx)(s.a,{href:"https://github.com/alewolf",children:"@alewolf"})}),"\n",(0,i.jsx)(s.li,{children:(0,i.jsx)(s.a,{href:"https://github.com/dpang314",children:"@dpang314"})}),"\n",(0,i.jsxs)(s.li,{children:["dht (",(0,i.jsx)(s.a,{href:"https://github.com/dht",children:"@dht"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["emattia (",(0,i.jsx)(s.a,{href:"https://github.com/emattia",children:"@emattia"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["pincman (",(0,i.jsx)(s.a,{href:"https://github.com/pincman",children:"@pincman"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["sado (",(0,i.jsx)(s.a,{href:"https://github.com/sado0823",children:"@sado0823"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["\u51f1\u6069 Kane (",(0,i.jsx)(s.a,{href:"https://github.com/Gary50613",children:"@Gary50613"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["\u674e\u5c0f\u96e8 (",(0,i.jsx)(s.a,{href:"https://github.com/metal-young",children:"@metal-young"}),")"]}),"\n",(0,i.jsxs)(s.li,{children:["\u8d64\u57ce\u7ed3\u8863 (",(0,i.jsx)(s.a,{href:"https://github.com/AkagiYui",children:"@AkagiYui"}),")"]}),"\n"]})]})}function u(e={}){const{wrapper:s}={...(0,h.a)(),...e.components};return s?(0,i.jsx)(s,{...e,children:(0,i.jsx)(l,{...e})}):l(e)}},71670:(e,s,n)=>{n.d(s,{Z:()=>t,a:()=>a});var i=n(27378);const h={},c=i.createContext(h);function a(e){const s=i.useContext(c);return i.useMemo((function(){return"function"==typeof e?e(s):{...s,...e}}),[s,e])}function t(e){let s;return s=e.disableParentContext?"function"==typeof e.components?e.components(h):e.components||h:a(e.components),i.createElement(c.Provider,{value:s},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/090b93b4.a5c9059f.js b/assets/js/090b93b4.a5c9059f.js
new file mode 100644
index 0000000000..af4d4e4061
--- /dev/null
+++ b/assets/js/090b93b4.a5c9059f.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkwebsite=self.webpackChunkwebsite||[]).push([[98796],{75736:(t,e,a)=>{a.r(e),a.d(e,{assets:()=>h,contentTitle:()=>o,default:()=>c,frontMatter:()=>s,metadata:()=>r,toc:()=>l});var n=a(24246),i=a(71670);const s={mdx:{format:"md"},date:"2022-03-03T20:00",authors:["anicholls","arifszn","dmitryvinn","dstotijn","Josh-Cena","PatelN123","slorber","vaibhavshn"]},o="2.0.0-beta.17",r={permalink:"/changelog/2.0.0-beta.17",source:"@site/changelog/source/2.0.0-beta.17.md",title:"2.0.0-beta.17",description:"New Feature",date:"2022-03-03T20:00:00.000Z",tags:[],hasTruncateMarker:!0,authors:[{name:"Alex Nicholls",alias:"anicholls",url:"https://github.com/anicholls",imageURL:"https://github.com/anicholls.png",key:"anicholls"},{name:"Ariful Alam",alias:"arifszn",url:"https://github.com/arifszn",imageURL:"https://github.com/arifszn.png",key:"arifszn"},{name:"Dmitry Vinnik",alias:"dmitryvinn",url:"https://github.com/dmitryvinn",imageURL:"https://github.com/dmitryvinn.png",key:"dmitryvinn"},{name:"David Stotijn",alias:"dstotijn",url:"https://github.com/dstotijn",imageURL:"https://github.com/dstotijn.png",key:"dstotijn"},{name:"Joshua Chen",alias:"Josh-Cena",url:"https://github.com/Josh-Cena",imageURL:"https://github.com/Josh-Cena.png",key:"Josh-Cena"},{name:"Nayan Patel",alias:"PatelN123",url:"https://github.com/PatelN123",imageURL:"https://github.com/PatelN123.png",key:"PatelN123"},{name:"S\xe9bastien Lorber",alias:"slorber",url:"https://github.com/slorber",imageURL:"https://github.com/slorber.png",key:"slorber"},{name:"Vaibhav Shinde",alias:"vaibhavshn",url:"https://github.com/vaibhavshn",imageURL:"https://github.com/vaibhavshn.png",key:"vaibhavshn"}],frontMatter:{mdx:{format:"md"},date:"2022-03-03T20:00",authors:["anicholls","arifszn","dmitryvinn","dstotijn","Josh-Cena","PatelN123","slorber","vaibhavshn"]},unlisted:!1,prevItem:{title:"2.0.0-beta.18",permalink:"/changelog/2.0.0-beta.18"},nextItem:{title:"2.0.0-beta.16",permalink:"/changelog/2.0.0-beta.16"},listPageLink:"/changelog/page/2"},h={authorsImageUrls:[void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0]},l=[];function m(t){return(0,n.jsx)(n.Fragment,{})}function c(t={}){const{wrapper:e}={...(0,i.a)(),...t.components};return e?(0,n.jsx)(e,{...t,children:(0,n.jsx)(m,{...t})}):m()}},71670:(t,e,a)=>{a.d(e,{Z:()=>r,a:()=>o});var n=a(27378);const i={},s=n.createContext(i);function o(t){const e=n.useContext(s);return n.useMemo((function(){return"function"==typeof t?t(e):{...e,...t}}),[e,t])}function r(t){let e;return e=t.disableParentContext?"function"==typeof t.components?t.components(i):t.components||i:o(t.components),n.createElement(s.Provider,{value:e},t.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/0938a5e1.42c52b23.js b/assets/js/0938a5e1.42c52b23.js
new file mode 100644
index 0000000000..3f813f2ab9
--- /dev/null
+++ b/assets/js/0938a5e1.42c52b23.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkwebsite=self.webpackChunkwebsite||[]).push([[8648],{40805:(e,s,r)=>{r.d(s,{Z:()=>n});const n=r.p+"assets/images/social-card-402517ac2205718a22585e627fe1351c.png"},6698:(e,s,r)=>{r.d(s,{Z:()=>l});var n=r(24246),a=(r(27378),r(40624));const o={browserWindow:"browserWindow_my1Q",browserWindowHeader:"browserWindowHeader_jXSR",row:"row_KZDM",buttons:"buttons_uHc7",right:"right_oyze",browserWindowAddressBar:"browserWindowAddressBar_Pd8y",dot:"dot_giz1",browserWindowMenuIcon:"browserWindowMenuIcon_Vhuh",bar:"bar_rrRL",browserWindowBody:"browserWindowBody_Idgs"};function t(e,s,r){return s in e?Object.defineProperty(e,s,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[s]=r,e}function i(e){for(var s=1;sheadTags
",id:"config-headtags",level:3},{value:"Accessibility",id:"accessibility",level:3},{value:"Developer Experience",id:"developer-experience",level:3},{value:"Translations",id:"translations",level:3},{value:"Other changes",id:"other-changes",level:2}];function h(e){const s={a:"a",admonition:"admonition",code:"code",h2:"h2",h3:"h3",img:"img",li:"li",mermaid:"mermaid",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,a.a)(),...e.components};return(0,n.jsxs)(n.Fragment,{children:[(0,n.jsxs)(s.p,{children:["We are happy to announce ",(0,n.jsx)(s.strong,{children:"Docusaurus 2.2"}),"."]}),"\n",(0,n.jsxs)(s.p,{children:["The upgrade should be easy: as explained in our ",(0,n.jsx)(s.a,{href:"/community/release-process",children:"release process documentation"}),", minor versions respect ",(0,n.jsx)(s.a,{href:"https://semver.org/",children:"Semantic Versioning"}),"."]}),"\n",(0,n.jsx)(s.p,{children:(0,n.jsx)(s.img,{alt:"Docusaurus 2.2 social card",src:r(65495).Z+"",width:"1200",height:"600"})}),"\n","\n",(0,n.jsx)(s.h2,{id:"highlights",children:"Highlights"}),"\n",(0,n.jsx)(s.h3,{id:"mermaid-diagrams",children:"Mermaid diagrams"}),"\n",(0,n.jsxs)(s.p,{children:["In ",(0,n.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7490",children:"#7490"}),", we added support for Mermaid diagrams. This fills the gap between GitHub Flavored Markdown which also ",(0,n.jsx)(s.a,{href:"https://github.blog/2022-02-14-include-diagrams-markdown-files-mermaid/",children:"added support recently"}),". You can create Mermaid diagrams using Markdown code blocks:"]}),"\n",(0,n.jsx)(s.pre,{children:(0,n.jsx)(s.code,{className:"language-md",children:"```mermaid\nsequenceDiagram\n participant Alice\n participant Bob\n Alice->>John: Hello John, how are you?\n loop Health check\n John->>John: Fight against hypochondria\n end\n Note right of John: Rational thoughts Hello {project}!
;\n\nrender(Hello {project}!
\n);\n\nrender(\n"})," tag, ",(0,r.jsx)(n.code,{children:""})," tag, or ",(0,r.jsx)(n.code,{children:""})," component."]}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-jsx",children:"\n Input: 1 2 3 4{'\\n'}\n Output: \"366300745\"{'\\n'}\n
\n"})}),"\n",(0,r.jsx)(c.Z,{children:(0,r.jsxs)("pre",{children:[(0,r.jsx)("b",{children:"Input: "}),"1 2 3 4\n",(0,r.jsx)("b",{children:"Output: "}),'"366300745"\n']})}),"\n",(0,r.jsx)(n.admonition,{title:"MDX is whitespace insensitive",type:"warning",children:(0,r.jsxs)(n.p,{children:["MDX is in line with JSX behavior: line break characters, even when inside ",(0,r.jsx)(n.code,{children:""}),", are turned into spaces. You have to explicitly write the new line character for it to be printed out."]})}),"\n",(0,r.jsx)(n.admonition,{type:"warning",children:(0,r.jsx)(n.p,{children:"Syntax highlighting only works on plain strings. Docusaurus will not attempt to parse code block content containing JSX children."})}),"\n",(0,r.jsx)(n.h2,{id:"multi-language-support-code-blocks",children:"Multi-language support code blocks"}),"\n",(0,r.jsx)(n.p,{children:"With MDX, you can easily create interactive components within your documentation, for example, to display code in multiple programming languages and switch between them using a tabs component."}),"\n",(0,r.jsxs)(n.p,{children:["Instead of implementing a dedicated component for multi-language support code blocks, we've implemented a general-purpose ",(0,r.jsx)(n.a,{href:"/docs/markdown-features/tabs",children:(0,r.jsx)(n.code,{children:""})})," component in the classic theme so that you can use it for other non-code scenarios as well."]}),"\n",(0,r.jsxs)(n.p,{children:["The following example is how you can have multi-language code tabs in your docs. Note that the empty lines above and below each language block are ",(0,r.jsx)(n.strong,{children:"intentional"}),". This is a ",(0,r.jsx)(n.a,{href:"/docs/markdown-features/react#markdown-and-jsx-interoperability",children:"current limitation of MDX"}),": you have to leave empty lines around Markdown syntax for the MDX parser to know that it's Markdown syntax and not JSX."]}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-jsx",children:'import Tabs from \'@theme/Tabs\';\nimport TabItem from \'@theme/TabItem\';\n\n\n\n\n```js\nfunction helloWorld() {\n console.log(\'Hello, world!\');\n}\n```\n\n \n\n\n```py\ndef hello_world():\n print("Hello, world!")\n```\n\n \n\n\n```java\nclass HelloWorld {\n public static void main(String args[]) {\n System.out.println("Hello, World");\n }\n}\n```\n\n \n \n'})}),"\n",(0,r.jsx)(n.p,{children:"And you will get the following:"}),"\n",(0,r.jsx)(c.Z,{children:(0,r.jsxs)(i.Z,{children:[(0,r.jsx)(s.Z,{value:"js",label:"JavaScript",children:(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-js",children:"function helloWorld() {\n console.log('Hello, world!');\n}\n"})})}),(0,r.jsx)(s.Z,{value:"py",label:"Python",children:(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-py",children:'def hello_world():\n print("Hello, world!")\n'})})}),(0,r.jsx)(s.Z,{value:"java",label:"Java",children:(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-java",children:'class HelloWorld {\n public static void main(String args[]) {\n System.out.println("Hello, World");\n }\n}\n'})})})]})}),"\n",(0,r.jsxs)(n.p,{children:["If you have multiple of these multi-language code tabs, and you want to sync the selection across the tab instances, refer to the ",(0,r.jsx)(n.a,{href:"/docs/markdown-features/tabs#syncing-tab-choices",children:"Syncing tab choices section"}),"."]}),"\n",(0,r.jsx)(n.h3,{id:"npm2yarn-remark-plugin",children:"Docusaurus npm2yarn remark plugin"}),"\n",(0,r.jsx)(n.p,{children:"Displaying CLI commands in both npm and Yarn is a very common need, for example:"}),"\n",(0,r.jsxs)(i.Z,{groupId:"npm2yarn",children:[(0,r.jsx)(s.Z,{value:"npm",children:(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-bash",children:"npm install @docusaurus/remark-plugin-npm2yarn\n"})})}),(0,r.jsx)(s.Z,{value:"yarn",label:"Yarn",children:(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-bash",children:"yarn add @docusaurus/remark-plugin-npm2yarn\n"})})}),(0,r.jsx)(s.Z,{value:"pnpm",label:"pnpm",children:(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-bash",children:"pnpm add @docusaurus/remark-plugin-npm2yarn\n"})})})]}),"\n",(0,r.jsxs)(n.p,{children:["Docusaurus provides such a utility out of the box, freeing you from using the ",(0,r.jsx)(n.code,{children:"Tabs"})," component every time. To enable this feature, first install the ",(0,r.jsx)(n.code,{children:"@docusaurus/remark-plugin-npm2yarn"})," package as above, and then in ",(0,r.jsx)(n.code,{children:"docusaurus.config.js"}),", for the plugins where you need this feature (doc, blog, pages, etc.), register it in the ",(0,r.jsx)(n.code,{children:"remarkPlugins"})," option. (See ",(0,r.jsx)(n.a,{href:"/docs/api/plugins/@docusaurus/plugin-content-docs#ex-config",children:"Docs configuration"})," for more details on configuration format)"]}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-js",metastring:'title="docusaurus.config.js"',children:"export default {\n // ...\n presets: [\n [\n '@docusaurus/preset-classic',\n {\n docs: {\n // highlight-start\n remarkPlugins: [\n [require('@docusaurus/remark-plugin-npm2yarn'), {sync: true}],\n ],\n // highlight-end\n },\n pages: {\n // highlight-next-line\n remarkPlugins: [require('@docusaurus/remark-plugin-npm2yarn')],\n },\n blog: {\n // highlight-start\n remarkPlugins: [\n [\n require('@docusaurus/remark-plugin-npm2yarn'),\n {converters: ['pnpm']},\n ],\n ],\n // highlight-end\n // ...\n },\n },\n ],\n ],\n};\n"})}),"\n",(0,r.jsxs)(n.p,{children:["And then use it by adding the ",(0,r.jsx)(n.code,{children:"npm2yarn"})," key to the code block:"]}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-md",children:"```bash npm2yarn\nnpm install @docusaurus/remark-plugin-npm2yarn\n```\n"})}),"\n",(0,r.jsx)(n.h4,{id:"npm2yarn-remark-plugin-configuration",children:"Configuration"}),"\n",(0,r.jsxs)(n.table,{children:[(0,r.jsx)(n.thead,{children:(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.th,{children:"Option"}),(0,r.jsx)(n.th,{children:"Type"}),(0,r.jsx)(n.th,{children:"Default"}),(0,r.jsx)(n.th,{children:"Description"})]})}),(0,r.jsxs)(n.tbody,{children:[(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"sync"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"boolean"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"false"})}),(0,r.jsx)(n.td,{children:"Whether to sync the selected converter across all code blocks."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"converters"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"array"})}),(0,r.jsxs)(n.td,{children:[(0,r.jsx)(n.code,{children:"'yarn'"}),", ",(0,r.jsx)(n.code,{children:"'pnpm'"})]}),(0,r.jsx)(n.td,{children:"The list of converters to use. The order of the converters is important, as the first converter will be used as the default choice."})]})]})]}),"\n",(0,r.jsx)(n.h2,{id:"usage-in-jsx",children:"Usage in JSX"}),"\n",(0,r.jsxs)(n.p,{children:["Outside of Markdown, you can use the ",(0,r.jsx)(n.code,{children:"@theme/CodeBlock"})," component to get the same output."]}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-jsx",children:'import CodeBlock from \'@theme/CodeBlock\';\n\nexport default function MyReactPage() {\n return (\n \n {/* highlight-start */}\n \n {`function HelloCodeTitle(props) {\n return Hello, {props.name}
;\n}`}\n \n {/* highlight-end */}\n \n );\n}\n'})}),"\n",(0,r.jsx)(c.Z,{children:(0,r.jsx)(l.Z,{language:"jsx",title:"/src/components/HelloCodeTitle.js",showLineNumbers:!0,children:"function HelloCodeTitle(props) {\n return Hello, {props.name}
;\n}"})}),"\n",(0,r.jsxs)(n.p,{children:["The props accepted are ",(0,r.jsx)(n.code,{children:"language"}),", ",(0,r.jsx)(n.code,{children:"title"})," and ",(0,r.jsx)(n.code,{children:"showLineNumbers"}),", in the same way as you write Markdown code blocks."]}),"\n",(0,r.jsxs)(n.p,{children:["Although discouraged, you can also pass in a ",(0,r.jsx)(n.code,{children:"metastring"})," prop like ",(0,r.jsx)(n.code,{children:"metastring='{1-2} title=\"/src/components/HelloCodeTitle.js\" showLineNumbers'"}),", which is how Markdown code blocks are handled under the hood. However, we recommend you ",(0,r.jsx)(n.a,{href:"#highlighting-with-comments",children:"use comments for highlighting lines"}),"."]}),"\n",(0,r.jsxs)(n.p,{children:["As ",(0,r.jsx)(n.a,{href:"#using-jsx-markup",children:"previously stated"}),", syntax highlighting is only applied when the children is a simple string."]})]})}function m(e={}){const{wrapper:n}={...(0,o.a)(),...e.components};return n?(0,r.jsx)(n,{...e,children:(0,r.jsx)(g,{...e})}):g(e)}}}]);
\ No newline at end of file
diff --git a/assets/js/0af1b9a1.a5c2f22a.js b/assets/js/0af1b9a1.a5c2f22a.js
new file mode 100644
index 0000000000..7b2f42ac6a
--- /dev/null
+++ b/assets/js/0af1b9a1.a5c2f22a.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkwebsite=self.webpackChunkwebsite||[]).push([[54223],{39641:(t,g,i)=>{i.r(g),i.d(g,{assets:()=>a,contentTitle:()=>e,default:()=>n,frontMatter:()=>o,metadata:()=>m,toc:()=>p});var h=i(24246),u=i(71670);const o={authors:[{image_url:"https://github.com/endiliey.png",url:"https://github.com/endiliey"},{image_url:"https://github.com/lex111.png",url:"https://github.com/lex111"},{image_url:"https://github.com/slorber.png",url:"https://github.com/slorber"},{image_url:"https://github.com/yangshun.png",url:"https://github.com/yangshun"},{image_url:"https://github.com/JoelMarcey.png",url:"https://github.com/JoelMarcey"},{image_url:"https://github.com/Josh-Cena.png",url:"https://github.com/Josh-Cena"},{image_url:"https://github.com/deltice.png",url:"https://github.com/deltice"},{image_url:"https://github.com/SamChou19815.png",url:"https://github.com/SamChou19815"},{image_url:"https://github.com/ericnakagawa.png",url:"https://github.com/ericnakagawa"},{image_url:"https://github.com/Simek.png",url:"https://github.com/Simek"},{image_url:"https://github.com/hramos.png",url:"https://github.com/hramos"},{image_url:"https://github.com/wgao19.png",url:"https://github.com/wgao19"},{image_url:"https://github.com/rickyvetter.png",url:"https://github.com/rickyvetter"},{image_url:"https://github.com/fanny.png",url:"https://github.com/fanny"},{image_url:"https://github.com/armano2.png",url:"https://github.com/armano2"},{image_url:"https://github.com/RDIL.png",url:"https://github.com/RDIL"},{image_url:"https://github.com/teikjun.png",url:"https://github.com/teikjun"},{image_url:"https://github.com/hong4rc.png",url:"https://github.com/hong4rc"},{image_url:"https://github.com/anshulrgoyal.png",url:"https://github.com/anshulrgoyal"},{image_url:"https://github.com/italicize.png",url:"https://github.com/italicize"}],tags:["paginated-tag"]},e="Image-only authors",m={permalink:"/tests/blog/2022/01/20/image-only-authors",editUrl:"https://github.com/facebook/docusaurus/edit/main/website/_dogfooding/_blog-tests/_dogfooding/_blog tests/2022-01-20-image-only-authors.mdx",source:"@site/_dogfooding/_blog tests/2022-01-20-image-only-authors.mdx",title:"Image-only authors",description:"You can make a compact authors list without author names!",date:"2022-01-20T00:00:00.000Z",tags:[{label:"paginated-tag",permalink:"/tests/blog/tags/paginated-tag"}],readingTime:2,hasTruncateMarker:!1,authors:[{image_url:"https://github.com/endiliey.png",url:"https://github.com/endiliey",imageURL:"https://github.com/endiliey.png"},{image_url:"https://github.com/lex111.png",url:"https://github.com/lex111",imageURL:"https://github.com/lex111.png"},{image_url:"https://github.com/slorber.png",url:"https://github.com/slorber",imageURL:"https://github.com/slorber.png"},{image_url:"https://github.com/yangshun.png",url:"https://github.com/yangshun",imageURL:"https://github.com/yangshun.png"},{image_url:"https://github.com/JoelMarcey.png",url:"https://github.com/JoelMarcey",imageURL:"https://github.com/JoelMarcey.png"},{image_url:"https://github.com/Josh-Cena.png",url:"https://github.com/Josh-Cena",imageURL:"https://github.com/Josh-Cena.png"},{image_url:"https://github.com/deltice.png",url:"https://github.com/deltice",imageURL:"https://github.com/deltice.png"},{image_url:"https://github.com/SamChou19815.png",url:"https://github.com/SamChou19815",imageURL:"https://github.com/SamChou19815.png"},{image_url:"https://github.com/ericnakagawa.png",url:"https://github.com/ericnakagawa",imageURL:"https://github.com/ericnakagawa.png"},{image_url:"https://github.com/Simek.png",url:"https://github.com/Simek",imageURL:"https://github.com/Simek.png"},{image_url:"https://github.com/hramos.png",url:"https://github.com/hramos",imageURL:"https://github.com/hramos.png"},{image_url:"https://github.com/wgao19.png",url:"https://github.com/wgao19",imageURL:"https://github.com/wgao19.png"},{image_url:"https://github.com/rickyvetter.png",url:"https://github.com/rickyvetter",imageURL:"https://github.com/rickyvetter.png"},{image_url:"https://github.com/fanny.png",url:"https://github.com/fanny",imageURL:"https://github.com/fanny.png"},{image_url:"https://github.com/armano2.png",url:"https://github.com/armano2",imageURL:"https://github.com/armano2.png"},{image_url:"https://github.com/RDIL.png",url:"https://github.com/RDIL",imageURL:"https://github.com/RDIL.png"},{image_url:"https://github.com/teikjun.png",url:"https://github.com/teikjun",imageURL:"https://github.com/teikjun.png"},{image_url:"https://github.com/hong4rc.png",url:"https://github.com/hong4rc",imageURL:"https://github.com/hong4rc.png"},{image_url:"https://github.com/anshulrgoyal.png",url:"https://github.com/anshulrgoyal",imageURL:"https://github.com/anshulrgoyal.png"},{image_url:"https://github.com/italicize.png",url:"https://github.com/italicize",imageURL:"https://github.com/italicize.png"}],frontMatter:{authors:[{image_url:"https://github.com/endiliey.png",url:"https://github.com/endiliey",imageURL:"https://github.com/endiliey.png"},{image_url:"https://github.com/lex111.png",url:"https://github.com/lex111",imageURL:"https://github.com/lex111.png"},{image_url:"https://github.com/slorber.png",url:"https://github.com/slorber",imageURL:"https://github.com/slorber.png"},{image_url:"https://github.com/yangshun.png",url:"https://github.com/yangshun",imageURL:"https://github.com/yangshun.png"},{image_url:"https://github.com/JoelMarcey.png",url:"https://github.com/JoelMarcey",imageURL:"https://github.com/JoelMarcey.png"},{image_url:"https://github.com/Josh-Cena.png",url:"https://github.com/Josh-Cena",imageURL:"https://github.com/Josh-Cena.png"},{image_url:"https://github.com/deltice.png",url:"https://github.com/deltice",imageURL:"https://github.com/deltice.png"},{image_url:"https://github.com/SamChou19815.png",url:"https://github.com/SamChou19815",imageURL:"https://github.com/SamChou19815.png"},{image_url:"https://github.com/ericnakagawa.png",url:"https://github.com/ericnakagawa",imageURL:"https://github.com/ericnakagawa.png"},{image_url:"https://github.com/Simek.png",url:"https://github.com/Simek",imageURL:"https://github.com/Simek.png"},{image_url:"https://github.com/hramos.png",url:"https://github.com/hramos",imageURL:"https://github.com/hramos.png"},{image_url:"https://github.com/wgao19.png",url:"https://github.com/wgao19",imageURL:"https://github.com/wgao19.png"},{image_url:"https://github.com/rickyvetter.png",url:"https://github.com/rickyvetter",imageURL:"https://github.com/rickyvetter.png"},{image_url:"https://github.com/fanny.png",url:"https://github.com/fanny",imageURL:"https://github.com/fanny.png"},{image_url:"https://github.com/armano2.png",url:"https://github.com/armano2",imageURL:"https://github.com/armano2.png"},{image_url:"https://github.com/RDIL.png",url:"https://github.com/RDIL",imageURL:"https://github.com/RDIL.png"},{image_url:"https://github.com/teikjun.png",url:"https://github.com/teikjun",imageURL:"https://github.com/teikjun.png"},{image_url:"https://github.com/hong4rc.png",url:"https://github.com/hong4rc",imageURL:"https://github.com/hong4rc.png"},{image_url:"https://github.com/anshulrgoyal.png",url:"https://github.com/anshulrgoyal",imageURL:"https://github.com/anshulrgoyal.png"},{image_url:"https://github.com/italicize.png",url:"https://github.com/italicize",imageURL:"https://github.com/italicize.png"}],tags:["paginated-tag"]},unlisted:!1,prevItem:{title:"Third post with footnote to test posts with same footnote reference.",permalink:"/tests/blog/2022/01/21/dup-footnote"},nextItem:{title:"Post with duplicate title",permalink:"/tests/blog/2021/11/13/dup-title"}},a={authorsImageUrls:[void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0,void 0]},p=[];function s(t){const g={p:"p",...(0,u.a)(),...t.components};return(0,h.jsx)(g.p,{children:"You can make a compact authors list without author names!"})}function n(t={}){const{wrapper:g}={...(0,u.a)(),...t.components};return g?(0,h.jsx)(g,{...t,children:(0,h.jsx)(s,{...t})}):s(t)}},71670:(t,g,i)=>{i.d(g,{Z:()=>m,a:()=>e});var h=i(27378);const u={},o=h.createContext(u);function e(t){const g=h.useContext(o);return h.useMemo((function(){return"function"==typeof t?t(g):{...g,...t}}),[g,t])}function m(t){let g;return g=t.disableParentContext?"function"==typeof t.components?t.components(u):t.components||u:e(t.components),h.createElement(o.Provider,{value:g},t.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/0b6cd89a.baa8fb50.js b/assets/js/0b6cd89a.baa8fb50.js
new file mode 100644
index 0000000000..647c7ac6c6
--- /dev/null
+++ b/assets/js/0b6cd89a.baa8fb50.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkwebsite=self.webpackChunkwebsite||[]).push([[39987],{61132:(e,n,t)=>{t.d(n,{Z:()=>o});var r=t(24246),s=(t(27378),t(40624));const i={tabItem:"tabItem_pnkT"};function o({children:e,hidden:n,className:t}){return(0,r.jsx)("div",{role:"tabpanel",className:(0,s.Z)(i.tabItem,t),hidden:n,children:e})}},97555:(e,n,t)=>{t.d(n,{Z:()=>S});var r=t(24246),s=t(27378),i=t(40624),o=t(75527),c=t(3620),d=t(44479),l=t(62821),a=t(52196),u=t(53589);function h(e,n,t){return n in e?Object.defineProperty(e,n,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[n]=t,e}function j(e,n){return n=null!=n?n:{},Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):function(e,n){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);n&&(r=r.filter((function(n){return Object.getOwnPropertyDescriptor(e,n).enumerable}))),t.push.apply(t,r)}return t}(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))})),e}function p(e){var n,t;return null!==(t=null===(n=s.Children.toArray(e).filter((e=>"\n"!==e)).map((e=>{if(!e||(0,s.isValidElement)(e)&&function(e){const{props:n}=e;return!!n&&"object"==typeof n&&"value"in n}(e))return e;throw new Error(`Docusaurus error: Bad child <${"string"==typeof e.type?e.type:e.type.name}>: all children of the component should be , and every should have a unique "value" prop.`)})))||void 0===n?void 0:n.filter(Boolean))&&void 0!==t?t:[]}function x(e){const{values:n,children:t}=e;return(0,s.useMemo)((()=>{const e=null!=n?n:function(e){return p(e).map((({props:{value:e,label:n,attributes:t,default:r}})=>({value:e,label:n,attributes:t,default:r})))}(t);return function(e){const n=(0,a.l)(e,((e,n)=>e.value===n.value));if(n.length>0)throw new Error(`Docusaurus error: Duplicate values "${n.map((e=>e.value)).join(", ")}" found in . Every value needs to be unique.`)}(e),e}),[n,t])}function b({value:e,tabValues:n}){return n.some((n=>n.value===e))}function f({queryString:e=!1,groupId:n}){const t=(0,c.k6)(),r=function({queryString:e=!1,groupId:n}){if("string"==typeof e)return e;if(!1===e)return null;if(!0===e&&!n)throw new Error('Docusaurus error: The component groupId prop is required if queryString=true, because this value is used as the search param name. You can also provide an explicit value such as queryString="my-search-param".');return null!=n?n:null}({queryString:e,groupId:n}),i=(0,l._X)(r),o=(0,s.useCallback)((e=>{if(!r)return;const n=new URLSearchParams(t.location.search);n.set(r,e),t.replace(j(function(e){for(var n=1;nfunction({defaultValue:e,tabValues:n}){if(0===n.length)throw new Error("Docusaurus error: the component requires at least one children component");if(e){if(!b({value:e,tabValues:n}))throw new Error(`Docusaurus error: The has a defaultValue "${e}" but none of its children has the corresponding value. Available values are: ${n.map((e=>e.value)).join(", ")}. If you intend to show no default tab, use defaultValue={null} instead.`);return e}var t;const r=null!==(t=n.find((e=>e.default)))&&void 0!==t?t:n[0];if(!r)throw new Error("Unexpected error: 0 tabValues");return r.value}({defaultValue:n,tabValues:i}))),[l,a]=f({queryString:t,groupId:r}),[h,j]=function({groupId:e}){const n=function(e){return e?`docusaurus.tab.${e}`:null}(e),[t,r]=(0,u.Nk)(n);return[t,(0,s.useCallback)((e=>{n&&r.set(e)}),[n,r])]}({groupId:r}),p=(()=>{const e=null!=l?l:h;return b({value:e,tabValues:i})?e:null})();(0,d.Z)((()=>{p&&c(p)}),[p]);return{selectedValue:o,selectValue:(0,s.useCallback)((e=>{if(!b({value:e,tabValues:i}))throw new Error(`Can't select invalid tab value=${e}`);c(e),a(e),j(e)}),[a,j,i]),tabValues:i}}var m=t(29088);const y={tabList:"tabList_Qoir",tabItem:"tabItem_AQgk"};function v(e,n,t){return n in e?Object.defineProperty(e,n,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[n]=t,e}function O(e){for(var n=1;n{const n=e.currentTarget,r=d.indexOf(n),i=c[r].value;i!==t&&(l(n),s(i))},u=e=>{let n=null;switch(e.key){case"Enter":a(e);break;case"ArrowRight":{const r=d.indexOf(e.currentTarget)+1;var t;n=null!==(t=d[r])&&void 0!==t?t:d[0];break}case"ArrowLeft":{const t=d.indexOf(e.currentTarget)-1;var r;n=null!==(r=d[t])&&void 0!==r?r:d[d.length-1];break}}null==n||n.focus()};return(0,r.jsx)("ul",{role:"tablist","aria-orientation":"horizontal",className:(0,i.Z)("tabs",{"tabs--block":n},e),children:c.map((({value:e,label:n,attributes:s})=>(0,r.jsx)("li",w(O({role:"tab",tabIndex:t===e?0:-1,"aria-selected":t===e,ref:e=>d.push(e),onKeyDown:u,onClick:a},s),{className:(0,i.Z)("tabs__item",y.tabItem,null==s?void 0:s.className,{"tabs__item--active":t===e}),children:null!=n?n:e}),e)))})}function k({lazy:e,children:n,selectedValue:t}){const i=(Array.isArray(n)?n:[n]).filter(Boolean);if(e){const e=i.find((e=>e.props.value===t));return e?(0,s.cloneElement)(e,{className:"margin-top--md"}):null}return(0,r.jsx)("div",{className:"margin-top--md",children:i.map(((e,n)=>(0,s.cloneElement)(e,{key:n,hidden:e.props.value!==t})))})}function D(e){const n=g(e);return(0,r.jsxs)("div",{className:(0,i.Z)("tabs-container",y.tabList),children:[(0,r.jsx)(P,O({},e,n)),(0,r.jsx)(k,O({},e,n))]})}function S(e){const n=(0,m.Z)();return(0,r.jsx)(D,w(O({},e),{children:p(e.children)}),String(n))}},94544:(e,n,t)=>{t.d(n,{Z:()=>i});var r=t(24246),s=(t(27378),t(29088));function i({children:e,fallback:n}){return(0,s.Z)()?(0,r.jsx)(r.Fragment,{children:null==e?void 0:e()}):null!=n?n:null}},52605:(e,n,t)=>{t.d(n,{Z:()=>a});var r=t(24246),s=t(27378),i=t(80474),o=t(3620);const c={apiTable:"apiTable_e8hp"};function d({name:e,children:n},t){const c=function(e){let n=e;for(;(0,s.isValidElement)(n);)[n]=s.Children.toArray(n.props.children);if("string"!=typeof n)throw new Error(`Could not extract APITable row name from JSX tree:\n${JSON.stringify(e,null,2)}`);return n}(n),d=e?`${e}-${c}`:c,l=`#${d}`,a=(0,o.k6)();return(0,i.Z)().collectAnchor(d),(0,r.jsx)("tr",{id:d,tabIndex:0,ref:a.location.hash===l?t:void 0,onClick:e=>{"A"===e.target.tagName.toUpperCase()||a.push(l)},onKeyDown:e=>{"Enter"===e.key&&a.push(l)},children:n.props.children})}const l=s.forwardRef(d);function a({children:e,name:n}){if("table"!==e.type)throw new Error("Bad usage of APITable component.\nIt is probably that your Markdown table is malformed.\nMake sure to double-check you have the appropriate number of columns for each table row.");const[t,i]=s.Children.toArray(e.props.children),o=(0,s.useRef)(null);(0,s.useEffect)((()=>{var e;null===(e=o.current)||void 0===e||e.focus()}),[o]);const d=s.Children.map(i.props.children,(e=>(0,r.jsx)(l,{name:n,ref:o,children:e})));return(0,r.jsxs)("table",{className:c.apiTable,children:[t,(0,r.jsx)("tbody",{children:d})]})}},82064:(e,n,t)=>{t.d(n,{Z:()=>u});var r=t(24246),s=(t(27378),t(41428)),i=t(92053),o=t(36712),c=t(97555),d=t(61132),l=t(38112);const a=void 0;function u({code:e,pluginName:n,presetOptionName:t}){const u=(0,i.zu)(a).path;return(0,r.jsxs)(c.Z,{groupId:"api-config-ex",children:[(0,r.jsxs)(d.Z,{value:"preset",label:(0,o.I)({message:"Preset options"}),children:[(0,r.jsx)("p",{children:(0,r.jsx)(o.Z,{id:"apiDocs.configTabs.presetOptions.description",values:{presetLink:(0,r.jsx)(s.Z,{to:`${u}/using-plugins#docusauruspreset-classic`,children:(0,r.jsx)(o.Z,{children:"preset options"})})},children:"If you use a preset, configure this plugin through the {presetLink}:"})}),(0,r.jsx)(l.Z,{language:"js",title:"docusaurus.config.js",children:`module.exports = {\n presets: [\n [\n '@docusaurus/preset-classic',\n {\n // highlight-start\n ${t}: ${e.replace(/\n/g,"\n ")},\n // highlight-end\n },\n ],\n ],\n};`})]}),(0,r.jsxs)(d.Z,{value:"plugin",label:(0,o.I)({message:"Plugin options"}),children:[(0,r.jsx)("p",{children:(0,r.jsx)(o.Z,{children:"If you are using a standalone plugin, provide options directly to the plugin:"})}),(0,r.jsx)(l.Z,{language:"js",title:"docusaurus.config.js",children:`module.exports = {\n plugins: [\n [\n '${n}',\n // highlight-start\n ${e.replace(/\n/g,"\n ")},\n // highlight-end\n ],\n ],\n};`})]})]})}},38112:(e,n,t)=>{t.d(n,{Z:()=>Ue});var r={};t.r(r),t.d(r,{ButtonExample:()=>_});var s=t(24246),i=t(27378),o=t(40624),c=t(29088),d=t(32711),l=t(36712),a=t(4423),u=t(94544),h=t(30691),j=t(78844),p=t(73919);function x(){const{prism:e}=(0,p.L)(),{colorMode:n}=(0,j.I)(),t=e.theme,r=e.darkTheme||t;return"dark"===n?r:t}var b=t(88941);const f={playgroundContainer:"playgroundContainer_6Ior",playgroundHeader:"playgroundHeader_Tvsk",playgroundEditor:"playgroundEditor_TySg",playgroundPreview:"playgroundPreview_mApW"};function g(e,n,t){return n in e?Object.defineProperty(e,n,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[n]=t,e}function m(e){for(var n=1;n=0||(s[t]=e[t]);return s}(e,n);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(s[t]=e[t])}return s}function O({children:e}){return(0,s.jsx)("div",{className:(0,o.Z)(f.playgroundHeader),children:e})}function w(){return(0,s.jsx)("div",{children:"Loading..."})}function P(){return(0,s.jsx)(u.Z,{fallback:(0,s.jsx)(w,{}),children:()=>(0,s.jsxs)(s.Fragment,{children:[(0,s.jsx)(b.Z,{fallback:e=>(0,s.jsx)(h.Ac,m({},e)),children:(0,s.jsx)(d.i5,{})}),(0,s.jsx)(d.IF,{})]})})}function k(){return(0,s.jsxs)(s.Fragment,{children:[(0,s.jsx)(O,{children:(0,s.jsx)(l.Z,{id:"theme.Playground.result",description:"The result label of the live codeblocks",children:"Result"})}),(0,s.jsx)("div",{className:f.playgroundPreview,children:(0,s.jsx)(P,{})})]})}function D(){const e=(0,c.Z)();return(0,s.jsx)(d.uz,{className:f.playgroundEditor},String(e))}function S(){return(0,s.jsxs)(s.Fragment,{children:[(0,s.jsx)(O,{children:(0,s.jsx)(l.Z,{id:"theme.Playground.liveEditor",description:"The live editor label of the live codeblocks",children:"Live Editor"})}),(0,s.jsx)(D,{})]})}const C=e=>`${e};`;function N(e){var n,{children:t,transformCode:r}=e,i=v(e,["children","transformCode"]);const{siteConfig:{themeConfig:o}}=(0,a.Z)(),{liveCodeBlock:{playgroundPosition:c}}=o,l=x();var u;const h=null!==(u=null===(n=i.metastring)||void 0===n?void 0:n.includes("noInline"))&&void 0!==u&&u;return(0,s.jsx)("div",{className:f.playgroundContainer,children:(0,s.jsx)(d.nu,y(m({code:null==t?void 0:t.replace(/\n$/,""),noInline:h,transformCode:null!=r?r:C,theme:l},i),{children:"top"===c?(0,s.jsxs)(s.Fragment,{children:[(0,s.jsx)(k,{}),(0,s.jsx)(S,{})]}):(0,s.jsxs)(s.Fragment,{children:[(0,s.jsx)(S,{}),(0,s.jsx)(k,{})]})}))})}function E(e,n,t){return n in e?Object.defineProperty(e,n,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[n]=t,e}function I(e){for(var n=1;n[\"'])(?.*?)\\1"),F=RegExp("\\{(?[\\d,-]+)\\}"),W={js:{start:"\\/\\/",end:""},jsBlock:{start:"\\/\\*",end:"\\*\\/"},jsx:{start:"\\{\\s*\\/\\*",end:"\\*\\/\\s*\\}"},bash:{start:"#",end:""},html:{start:"\x3c!--",end:"--\x3e"}},G=(q=function(e){for(var n=1;n",end:""}})?z:{},Object.getOwnPropertyDescriptors?Object.defineProperties(q,Object.getOwnPropertyDescriptors(z)):function(e,n){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);n&&(r=r.filter((function(n){return Object.getOwnPropertyDescriptor(e,n).enumerable}))),t.push.apply(t,r)}return t}(Object(z)).forEach((function(e){Object.defineProperty(q,e,Object.getOwnPropertyDescriptor(z,e))})),q);var q,z;const H=Object.keys(W);function X(e,n){const t=e.map((e=>{const{start:t,end:r}=G[e];return`(?:${t}\\s*(${n.flatMap((e=>{var n,t;return[e.line,null===(n=e.block)||void 0===n?void 0:n.start,null===(t=e.block)||void 0===t?void 0:t.end].filter(Boolean)})).join("|")})\\s*${r})`})).join("|");return new RegExp(`^\\s*(?:${t})\\s*$`)}function J(e,n){let t=e.replace(/\n$/,"");const{language:r,magicComments:s,metastring:i}=n;if(i&&F.test(i)){const e=i.match(F).groups.range;if(0===s.length)throw new Error(`A highlight range has been given in code block's metastring (\`\`\` ${i}), but no magic comment config is available. Docusaurus applies the first magic comment entry's className for metastring ranges.`);const n=s[0].className,r=M()(e).filter((e=>e>0)).map((e=>[e-1,[n]]));return{lineClassNames:Object.fromEntries(r),code:t}}if(void 0===r)return{lineClassNames:{},code:t};const o=function(e,n){switch(e){case"js":case"javascript":case"ts":case"typescript":return X(["js","jsBlock"],n);case"jsx":case"tsx":return X(["js","jsBlock","jsx"],n);case"html":return X(["js","jsBlock","html"],n);case"python":case"py":case"bash":return X(["bash"],n);case"markdown":case"md":return X(["html","jsx","bash"],n);case"tex":case"latex":case"matlab":return X(["tex"],n);case"lua":case"haskell":case"sql":return X(["lua"],n);case"wasm":return X(["wasm"],n);case"vb":case"vba":case"visual-basic":return X(["vb","rem"],n);case"vbnet":return X(["vbnet","rem"],n);case"batch":return X(["rem"],n);case"basic":return X(["rem","f90"],n);case"fsharp":return X(["js","ml"],n);case"ocaml":case"sml":return X(["ml"],n);case"fortran":return X(["f90"],n);case"cobol":return X(["cobol"],n);default:return X(H,n)}}(r,s),c=t.split("\n"),d=Object.fromEntries(s.map((e=>[e.className,{start:0,range:""}]))),l=Object.fromEntries(s.filter((e=>e.line)).map((({className:e,line:n})=>[n,e]))),a=Object.fromEntries(s.filter((e=>e.block)).map((({className:e,block:n})=>[n.start,e]))),u=Object.fromEntries(s.filter((e=>e.block)).map((({className:e,block:n})=>[n.end,e])));for(let j=0;jvoid 0!==e));l[n]?d[l[n]].range+=`${j},`:a[n]?d[a[n]].start=j:u[n]&&(d[u[n]].range+=`${d[u[n]].start}-${j-1},`),c.splice(j,1)}t=c.join("\n");const h={};return Object.entries(d).forEach((([e,{range:n}])=>{M()(n).forEach((n=>{var t;null!==(t=(U=h)[V=n])&&void 0!==t||(U[V]=[]),h[n].push(e)}))})),{lineClassNames:h,code:t}}const Q={codeBlockContainer:"codeBlockContainer_jDV4"};function K(e,n,t){return n in e?Object.defineProperty(e,n,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[n]=t,e}function Y(e,n){return n=null!=n?n:{},Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):function(e,n){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);n&&(r=r.filter((function(n){return Object.getOwnPropertyDescriptor(e,n).enumerable}))),t.push.apply(t,r)}return t}(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))})),e}function ee(e,n){if(null==e)return{};var t,r,s=function(e,n){if(null==e)return{};var t,r,s={},i=Object.keys(e);for(r=0;r=0||(s[t]=e[t]);return s}(e,n);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(s[t]=e[t])}return s}function ne(e){var{as:n}=e,t=ee(e,["as"]);const r=function(e){const n={color:"--prism-color",backgroundColor:"--prism-background-color"},t={};return Object.entries(e.plain).forEach((([e,r])=>{const s=n[e];s&&"string"==typeof r&&(t[s]=r)})),t}(x());return(0,s.jsx)(n,Y(function(e){for(var n=1;n{var n;r(null===(n=e.current)||void 0===n?void 0:n.closest("[role=tabpanel][hidden]"))}),[e,r]);(0,i.useEffect)((()=>{s()}),[s]),function(e,n,t=ie){const r=(0,se.zX)(n),s=(0,se.Ql)(t);(0,i.useEffect)((()=>{const n=new MutationObserver(r);return e&&n.observe(e,s),()=>n.disconnect()}),[e,r,s])}(t,(e=>{e.forEach((e=>{"attributes"===e.type&&"hidden"===e.attributeName&&(n(),s())}))}),{attributes:!0,characterData:!1,childList:!1,subtree:!1})}var ce=t(26101);const de={codeLine:"codeLine_qRmp",codeLineNumber:"codeLineNumber_dS_J",codeLineContent:"codeLineContent_XF5l"};function le(e,n,t){return n in e?Object.defineProperty(e,n,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[n]=t,e}function ae(e){for(var n=1;n(0,s.jsx)("span",ae({},i({token:e,key:n})),n)));return(0,s.jsxs)("span",ue(ae({},c),{children:[t?(0,s.jsxs)(s.Fragment,{children:[(0,s.jsx)("span",{className:de.codeLineNumber}),(0,s.jsx)("span",{className:de.codeLineContent,children:d})]}):d,(0,s.jsx)("br",{})]}))}var je=t(34370);function pe(e,n,t){return n in e?Object.defineProperty(e,n,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[n]=t,e}function xe(e,n){return n=null!=n?n:{},Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):function(e,n){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);n&&(r=r.filter((function(n){return Object.getOwnPropertyDescriptor(e,n).enumerable}))),t.push.apply(t,r)}return t}(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))})),e}function be(e){return(0,s.jsx)("svg",xe(function(e){for(var n=1;n{(0,je.Z)(e),r(!0),c.current=window.setTimeout((()=>{r(!1)}),1e3)}),[e]);return(0,i.useEffect)((()=>()=>window.clearTimeout(c.current)),[]),(0,s.jsx)("button",{type:"button","aria-label":t?(0,l.I)({id:"theme.CodeBlock.copied",message:"Copied",description:"The copied button label on code blocks"}):(0,l.I)({id:"theme.CodeBlock.copyButtonAriaLabel",message:"Copy code to clipboard",description:"The ARIA label for copy code blocks button"}),title:(0,l.I)({id:"theme.CodeBlock.copy",message:"Copy",description:"The copy button label on code blocks"}),className:(0,o.Z)("clean-btn",n,ye.copyButton,t&&ye.copyButtonCopied),onClick:d,children:(0,s.jsxs)("span",{className:ye.copyButtonIcons,"aria-hidden":"true",children:[(0,s.jsx)(be,{className:ye.copyButtonIcon}),(0,s.jsx)(me,{className:ye.copyButtonSuccessIcon})]})})}function Oe(e,n,t){return n in e?Object.defineProperty(e,n,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[n]=t,e}function we(e,n){return n=null!=n?n:{},Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):function(e,n){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);n&&(r=r.filter((function(n){return Object.getOwnPropertyDescriptor(e,n).enumerable}))),t.push.apply(t,r)}return t}(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))})),e}function Pe(e){return(0,s.jsx)("svg",we(function(e){for(var n=1;ne.startsWith("language-")));return null==n?void 0:n.replace(/language-/,"")}(n))&&void 0!==u?u:l),j=x(),b=function(){const[e,n]=(0,i.useState)(!1),[t,r]=(0,i.useState)(!1),s=(0,i.useRef)(null),o=(0,i.useCallback)((()=>{const t=s.current.querySelector("code");e?t.removeAttribute("style"):(t.style.whiteSpace="pre-wrap",t.style.overflowWrap="anywhere"),n((e=>!e))}),[s,e]),c=(0,i.useCallback)((()=>{const{scrollWidth:e,clientWidth:n}=s.current,t=e>n||s.current.querySelector("code").hasAttribute("style");r(t)}),[s]);return oe(s,c),(0,i.useEffect)((()=>{c()}),[e,c]),(0,i.useEffect)((()=>(window.addEventListener("resize",c,{passive:!0}),()=>{window.removeEventListener("resize",c)})),[c]),{codeBlockRef:s,isEnabled:e,isCodeScrollable:t,toggle:o}}(),f=function(e){var n,t;return null!==(t=null===(n=null==e?void 0:e.match($))||void 0===n?void 0:n.groups.title)&&void 0!==t?t:""}(t)||r,{lineClassNames:g,code:m}=J(e,{metastring:t,language:h,magicComments:a}),y=null!=c?c:function(e){return Boolean(null==e?void 0:e.includes("showLineNumbers"))}(t);return(0,s.jsxs)(ne,{as:"div",className:(0,o.Z)(n,h&&!n.includes(`language-${h}`)&&`language-${h}`),children:[f&&(0,s.jsx)("div",{className:te.codeBlockTitle,children:f}),(0,s.jsxs)("div",{className:te.codeBlockContent,children:[(0,s.jsx)(ce.y$,{theme:j,code:m,language:null!=h?h:"text",children:({className:e,style:n,tokens:t,getLineProps:r,getTokenProps:i})=>(0,s.jsx)("pre",{tabIndex:0,ref:b.codeBlockRef,className:(0,o.Z)(e,te.codeBlock,"thin-scrollbar"),style:n,children:(0,s.jsx)("code",{className:(0,o.Z)(te.codeBlockLines,y&&te.codeBlockLinesWithNumbering),children:t.map(((e,n)=>(0,s.jsx)(he,{line:e,getLineProps:r,getTokenProps:i,classNames:g[n],showLineNumbers:y},n)))})})}),(0,s.jsxs)("div",{className:te.buttonGroup,children:[(b.isEnabled||b.isCodeScrollable)&&(0,s.jsx)(De,{className:te.codeButton,onClick:()=>b.toggle(),isEnabled:b.isEnabled}),(0,s.jsx)(ve,{className:te.codeButton,code:m})]})]})]})}function Ce(e,n,t){return n in e?Object.defineProperty(e,n,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[n]=t,e}function Ne(e,n){return n=null!=n?n:{},Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):function(e,n){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);n&&(r=r.filter((function(n){return Object.getOwnPropertyDescriptor(e,n).enumerable}))),t.push.apply(t,r)}return t}(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))})),e}function Ee(e,n){if(null==e)return{};var t,r,s=function(e,n){if(null==e)return{};var t,r,s={},i=Object.keys(e);for(r=0;r=0||(s[t]=e[t]);return s}(e,n);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(s[t]=e[t])}return s}function Ie(e,n,t){return n in e?Object.defineProperty(e,n,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[n]=t,e}function Te(e){for(var n=1;n(0,i.isValidElement)(e)))?e:Array.isArray(e)?e.join(""):e}(n),d="string"==typeof o?Se:re;return(0,s.jsx)(d,Ne(function(e){for(var n=1;n{t.r(n),t.d(n,{assets:()=>h,contentTitle:()=>a,default:()=>x,frontMatter:()=>l,metadata:()=>u,toc:()=>j});var r=t(24246),s=t(71670),i=t(97555),o=t(61132),c=t(52605),d=t(82064);const l={sidebar_position:1,slug:"/api/plugins/@docusaurus/plugin-content-docs"},a="\ud83d\udce6 plugin-content-docs",u={id:"api/plugins/plugin-content-docs",title:"\ud83d\udce6 plugin-content-docs",description:"Provides the Docs functionality and is the default docs plugin for Docusaurus.",source:"@site/docs/api/plugins/plugin-content-docs.mdx",sourceDirName:"api/plugins",slug:"/api/plugins/@docusaurus/plugin-content-docs",permalink:"/docs/api/plugins/@docusaurus/plugin-content-docs",draft:!1,unlisted:!1,editUrl:"https://github.com/facebook/docusaurus/edit/main/website/docs/api/plugins/plugin-content-docs.mdx",tags:[],version:"current",lastUpdatedBy:"ozaki",lastUpdatedAt:1710503406e3,sidebarPosition:1,frontMatter:{sidebar_position:1,slug:"/api/plugins/@docusaurus/plugin-content-docs"},sidebar:"api",previous:{title:"Plugins overview",permalink:"/docs/api/plugins"},next:{title:"\ud83d\udce6 plugin-content-blog",permalink:"/docs/api/plugins/@docusaurus/plugin-content-blog"}},h={},j=[{value:"Installation",id:"installation",level:2},{value:"Configuration",id:"configuration",level:2},{value:"Types",id:"types",level:3},{value:"EditUrlFunction
",id:"EditUrlFunction",level:4},{value:"PrefixParser
",id:"PrefixParser",level:4},{value:"SidebarGenerator
",id:"SidebarGenerator",level:4},{value:"VersionsConfig
",id:"VersionsConfig",level:4},{value:"Example configuration",id:"ex-config",level:3},{value:"Markdown front matter",id:"markdown-front-matter",level:2},{value:"i18n",id:"i18n",level:2},{value:"Translation files location",id:"translation-files-location",level:3},{value:"Example file-system structure",id:"example-file-system-structure",level:3}];function p(e){const n={a:"a",admonition:"admonition",code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",h4:"h4",li:"li",p:"p",pre:"pre",strong:"strong",table:"table",tbody:"tbody",td:"td",th:"th",thead:"thead",tr:"tr",ul:"ul",...(0,s.a)(),...e.components};return(0,r.jsxs)(r.Fragment,{children:[(0,r.jsx)(n.h1,{id:"-plugin-content-docs",children:"\ud83d\udce6 plugin-content-docs"}),"\n","\n",(0,r.jsxs)(n.p,{children:["Provides the ",(0,r.jsx)(n.a,{href:"/docs/docs-introduction",children:"Docs"})," functionality and is the default docs plugin for Docusaurus."]}),"\n",(0,r.jsx)(n.h2,{id:"installation",children:"Installation"}),"\n",(0,r.jsxs)(i.Z,{groupId:"npm2yarn",children:[(0,r.jsx)(o.Z,{value:"npm",children:(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-bash",children:"npm install --save @docusaurus/plugin-content-docs\n"})})}),(0,r.jsx)(o.Z,{value:"yarn",label:"Yarn",children:(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-bash",children:"yarn add @docusaurus/plugin-content-docs\n"})})}),(0,r.jsx)(o.Z,{value:"pnpm",label:"pnpm",children:(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-bash",children:"pnpm add @docusaurus/plugin-content-docs\n"})})})]}),"\n",(0,r.jsxs)(n.admonition,{type:"tip",children:[(0,r.jsxs)(n.p,{children:["If you use the preset ",(0,r.jsx)(n.code,{children:"@docusaurus/preset-classic"}),", you don't need to install this plugin as a dependency."]}),(0,r.jsxs)(n.p,{children:["You can configure this plugin through the ",(0,r.jsx)(n.a,{href:"/docs/using-plugins#docusauruspreset-classic",children:"preset options"}),"."]})]}),"\n",(0,r.jsx)(n.h2,{id:"configuration",children:"Configuration"}),"\n",(0,r.jsx)(n.p,{children:"Accepted fields:"}),"\n",(0,r.jsx)(c.Z,{children:(0,r.jsxs)(n.table,{children:[(0,r.jsx)(n.thead,{children:(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.th,{children:"Name"}),(0,r.jsx)(n.th,{children:"Type"}),(0,r.jsx)(n.th,{children:"Default"}),(0,r.jsx)(n.th,{children:"Description"})]})}),(0,r.jsxs)(n.tbody,{children:[(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"path"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"string"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"'docs'"})}),(0,r.jsx)(n.td,{children:"Path to the docs content directory on the file system, relative to site directory."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"editUrl"})}),(0,r.jsx)(n.td,{children:(0,r.jsxs)("code",{children:["string | ",(0,r.jsx)(n.a,{href:"#EditUrlFunction",children:"EditUrlFunction"})]})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"undefined"})}),(0,r.jsxs)(n.td,{children:["Base URL to edit your site. The final URL is computed by ",(0,r.jsx)(n.code,{children:"editUrl + relativeDocPath"}),". Using a function allows more nuanced control for each file. Omitting this variable entirely will disable edit links."]})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"editLocalizedFiles"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"boolean"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"false"})}),(0,r.jsxs)(n.td,{children:["The edit URL will target the localized file, instead of the original unlocalized file. Ignored when ",(0,r.jsx)(n.code,{children:"editUrl"})," is a function."]})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"editCurrentVersion"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"boolean"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"false"})}),(0,r.jsxs)(n.td,{children:["The edit URL will always target the current version doc instead of older versions. Ignored when ",(0,r.jsx)(n.code,{children:"editUrl"})," is a function."]})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"routeBasePath"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"string"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"'docs'"})}),(0,r.jsxs)(n.td,{children:["URL route for the docs section of your site. ",(0,r.jsx)(n.strong,{children:"DO NOT"})," include a trailing slash. Use ",(0,r.jsx)(n.code,{children:"/"})," for shipping docs without base path."]})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"tagsBasePath"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"string"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"'tags'"})}),(0,r.jsxs)(n.td,{children:["URL route for the tags list page of your site. It is prepended to the ",(0,r.jsx)(n.code,{children:"routeBasePath"}),"."]})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"include"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"string[]"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"['**/*.{md,mdx}']"})}),(0,r.jsx)(n.td,{children:"Array of glob patterns matching Markdown files to be built, relative to the content path."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"exclude"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"string[]"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.em,{children:"See example configuration"})}),(0,r.jsxs)(n.td,{children:["Array of glob patterns matching Markdown files to be excluded. Serves as refinement based on the ",(0,r.jsx)(n.code,{children:"include"})," option."]})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"sidebarPath"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)("code",{children:"false | string"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"undefined"})}),(0,r.jsxs)(n.td,{children:["Path to sidebar configuration. Use ",(0,r.jsx)(n.code,{children:"false"})," to disable sidebars, or ",(0,r.jsx)(n.code,{children:"undefined"})," to create a fully autogenerated sidebar."]})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"sidebarCollapsible"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"boolean"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"true"})}),(0,r.jsxs)(n.td,{children:["Whether sidebar categories are collapsible by default. See also ",(0,r.jsx)(n.a,{href:"/docs/sidebar/items#collapsible-categories",children:"Collapsible categories"})]})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"sidebarCollapsed"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"boolean"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"true"})}),(0,r.jsxs)(n.td,{children:["Whether sidebar categories are collapsed by default. See also ",(0,r.jsx)(n.a,{href:"/docs/sidebar/items#expanded-categories-by-default",children:"Expanded categories by default"})]})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"sidebarItemsGenerator"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)("code",{children:(0,r.jsx)(n.a,{href:"#SidebarGenerator",children:"SidebarGenerator"})})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.em,{children:"Omitted"})}),(0,r.jsxs)(n.td,{children:["Function used to replace the sidebar items of type ",(0,r.jsx)(n.code,{children:"'autogenerated'"})," with real sidebar items (docs, categories, links...). See also ",(0,r.jsx)(n.a,{href:"/docs/sidebar/autogenerated#customize-the-sidebar-items-generator",children:"Customize the sidebar items generator"})]})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"numberPrefixParser"})}),(0,r.jsx)(n.td,{children:(0,r.jsxs)("code",{children:["boolean | ",(0,r.jsx)(n.a,{href:"#PrefixParser",children:"PrefixParser"})]})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.em,{children:"Omitted"})}),(0,r.jsxs)(n.td,{children:["Custom parsing logic to extract number prefixes from file names. Use ",(0,r.jsx)(n.code,{children:"false"})," to disable this behavior and leave the docs untouched, and ",(0,r.jsx)(n.code,{children:"true"})," to use the default parser. See also ",(0,r.jsx)(n.a,{href:"/docs/sidebar/autogenerated#using-number-prefixes",children:"Using number prefixes"})]})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"docsRootComponent"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"string"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"'@theme/DocsRoot'"})}),(0,r.jsx)(n.td,{children:"Parent component of all the docs plugin pages (including all versions). Stays mounted when navigation between docs pages and versions."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"docVersionRootComponent"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"string"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"'@theme/DocVersionLayout'"})}),(0,r.jsx)(n.td,{children:"Parent component of all docs pages of an individual version (doc pages with sidebars, tags pages). Stays mounted when navigation between pages of that specific version."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"docRootComponent"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"string"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"'@theme/DocPage'"})}),(0,r.jsx)(n.td,{children:"Parent component of all doc pages with sidebars (regular docs pages, category generated index pages). Stays mounted when navigation between such pages."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"docItemComponent"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"string"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"'@theme/DocItem'"})}),(0,r.jsx)(n.td,{children:"Main doc container, with TOC, pagination, etc."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"docTagsListComponent"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"string"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"'@theme/DocTagsListPage'"})}),(0,r.jsx)(n.td,{children:"Root component of the tags list page"})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"docTagDocListComponent"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"string"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"'@theme/DocTagDocListPage'"})}),(0,r.jsx)(n.td,{children:'Root component of the "docs containing tag X" page.'})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"docCategoryGeneratedIndexComponent"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"string"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"'@theme/DocCategoryGeneratedIndexPage'"})}),(0,r.jsx)(n.td,{children:"Root component of the generated category index page."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"remarkPlugins"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"any[]"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"[]"})}),(0,r.jsx)(n.td,{children:"Remark plugins passed to MDX."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"rehypePlugins"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"any[]"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"[]"})}),(0,r.jsx)(n.td,{children:"Rehype plugins passed to MDX."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"beforeDefaultRemarkPlugins"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"any[]"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"[]"})}),(0,r.jsx)(n.td,{children:"Custom Remark plugins passed to MDX before the default Docusaurus Remark plugins."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"beforeDefaultRehypePlugins"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"any[]"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"[]"})}),(0,r.jsx)(n.td,{children:"Custom Rehype plugins passed to MDX before the default Docusaurus Rehype plugins."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"showLastUpdateAuthor"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"boolean"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"false"})}),(0,r.jsx)(n.td,{children:"Whether to display the author who last updated the doc."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"showLastUpdateTime"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"boolean"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"false"})}),(0,r.jsxs)(n.td,{children:["Whether to display the last date the doc was updated. This requires access to git history during the build, so will not work correctly with shallow clones (a common default for CI systems). With GitHub ",(0,r.jsx)(n.code,{children:"actions/checkout"}),", use",(0,r.jsx)(n.code,{children:"fetch-depth: 0"}),"."]})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"breadcrumbs"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"boolean"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"true"})}),(0,r.jsx)(n.td,{children:"Enable or disable the breadcrumbs on doc pages."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"disableVersioning"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"boolean"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"false"})}),(0,r.jsxs)(n.td,{children:["Explicitly disable versioning even when multiple versions exist. This will make the site only include the current version. Will error if ",(0,r.jsx)(n.code,{children:"includeCurrentVersion: false"})," and ",(0,r.jsx)(n.code,{children:"disableVersioning: true"}),"."]})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"includeCurrentVersion"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"boolean"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"true"})}),(0,r.jsx)(n.td,{children:"Include the current version of your docs."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"lastVersion"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"string"})}),(0,r.jsxs)(n.td,{children:["First version in ",(0,r.jsx)(n.code,{children:"versions.json"})]}),(0,r.jsx)(n.td,{children:"The version navigated to in priority and displayed by default for docs navbar items."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"onlyIncludeVersions"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"string[]"})}),(0,r.jsx)(n.td,{children:"All versions available"}),(0,r.jsx)(n.td,{children:"Only include a subset of all available versions."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"versions"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)("code",{children:(0,r.jsx)(n.a,{href:"#VersionsConfig",children:"VersionsConfig"})})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"{}"})}),(0,r.jsx)(n.td,{children:"Independent customization of each version's properties."})]})]})]})}),"\n",(0,r.jsx)(n.h3,{id:"types",children:"Types"}),"\n",(0,r.jsx)(n.h4,{id:"EditUrlFunction",children:(0,r.jsx)(n.code,{children:"EditUrlFunction"})}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-ts",children:"type EditUrlFunction = (params: {\n version: string;\n versionDocsDirPath: string;\n docPath: string;\n permalink: string;\n locale: string;\n}) => string | undefined;\n"})}),"\n",(0,r.jsx)(n.h4,{id:"PrefixParser",children:(0,r.jsx)(n.code,{children:"PrefixParser"})}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-ts",children:"type PrefixParser = (filename: string) => {\n filename: string;\n numberPrefix?: number;\n};\n"})}),"\n",(0,r.jsx)(n.h4,{id:"SidebarGenerator",children:(0,r.jsx)(n.code,{children:"SidebarGenerator"})}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-ts",children:"type SidebarGenerator = (generatorArgs: {\n /** The sidebar item with type \"autogenerated\" to be transformed. */\n item: {type: 'autogenerated'; dirName: string};\n /** Useful metadata for the version this sidebar belongs to. */\n version: {contentPath: string; versionName: string};\n /** All the docs of that version (unfiltered). */\n docs: {\n id: string;\n title: string;\n frontMatter: DocFrontMatter & Record;\n source: string;\n sourceDirName: string;\n sidebarPosition?: number | undefined;\n }[];\n /** Number prefix parser configured for this plugin. */\n numberPrefixParser: PrefixParser;\n /** The default category index matcher which you can override. */\n isCategoryIndex: CategoryIndexMatcher;\n /**\n * key is the path relative to the doc content directory, value is the\n * category metadata file's content.\n */\n categoriesMetadata: {[filePath: string]: CategoryMetadata};\n /**\n * Useful to re-use/enhance the default sidebar generation logic from\n * Docusaurus.\n */\n defaultSidebarItemsGenerator: SidebarGenerator;\n // Returns an array of sidebar items \u2014 same as what you can declare in\n // sidebars.js, except for shorthands. See https://docusaurus.io/docs/sidebar/items\n}) => Promise;\n\ntype CategoryIndexMatcher = (param: {\n /** The file name, without extension */\n fileName: string;\n /**\n * The list of directories, from lowest level to highest.\n * If there's no dir name, directories is ['.']\n */\n directories: string[];\n /** The extension, with a leading dot */\n extension: string;\n}) => boolean;\n"})}),"\n",(0,r.jsx)(n.h4,{id:"VersionsConfig",children:(0,r.jsx)(n.code,{children:"VersionsConfig"})}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-ts",children:"type VersionConfig = {\n /**\n * The base path of the version, will be appended to `baseUrl` +\n * `routeBasePath`.\n */\n path?: string;\n /** The label of the version to be used in badges, dropdowns, etc. */\n label?: string;\n /** The banner to show at the top of a doc of that version. */\n banner?: 'none' | 'unreleased' | 'unmaintained';\n /** Show a badge with the version label at the top of each doc. */\n badge?: boolean;\n /** Prevents search engines from indexing this version */\n noIndex?: boolean;\n /** Add a custom class name to the element of each doc */\n className?: string;\n};\n\ntype VersionsConfig = {[versionName: string]: VersionConfig};\n"})}),"\n",(0,r.jsx)(n.h3,{id:"ex-config",children:"Example configuration"}),"\n",(0,r.jsx)(n.p,{children:"You can configure this plugin through preset options or plugin options."}),"\n",(0,r.jsx)(n.admonition,{type:"tip",children:(0,r.jsx)(n.p,{children:"Most Docusaurus users configure this plugin through the preset options."})}),"\n","\n",(0,r.jsx)(d.Z,{pluginName:"@docusaurus/plugin-content-docs",presetOptionName:"docs",code:"{\n path: 'docs',\n breadcrumbs: true,\n // Simple use-case: string editUrl\n // editUrl: 'https://github.com/facebook/docusaurus/edit/main/website/',\n // Advanced use-case: functional editUrl\n editUrl: ({versionDocsDirPath, docPath}) =>\n `https://github.com/facebook/docusaurus/edit/main/website/${versionDocsDirPath}/${docPath}`,\n editLocalizedFiles: false,\n editCurrentVersion: false,\n routeBasePath: 'docs',\n include: ['**/*.md', '**/*.mdx'],\n exclude: [\n '**/_*.{js,jsx,ts,tsx,md,mdx}',\n '**/_*/**',\n '**/*.test.{js,jsx,ts,tsx}',\n '**/__tests__/**',\n ],\n sidebarPath: 'sidebars.js',\n async sidebarItemsGenerator({\n defaultSidebarItemsGenerator,\n numberPrefixParser,\n item,\n version,\n docs,\n isCategoryIndex,\n }) {\n // Use the provided data to generate a custom sidebar slice\n return [\n {type: 'doc', id: 'intro'},\n {\n type: 'category',\n label: 'Tutorials',\n items: [\n {type: 'doc', id: 'tutorial1'},\n {type: 'doc', id: 'tutorial2'},\n ],\n },\n ];\n },\n numberPrefixParser(filename) {\n // Implement your own logic to extract a potential number prefix\n const numberPrefix = findNumberPrefix(filename);\n // Prefix found: return it with the cleaned filename\n if (numberPrefix) {\n return {\n numberPrefix,\n filename: filename.replace(prefix, ''),\n };\n }\n // No number prefix found\n return {numberPrefix: undefined, filename};\n },\n docsRootComponent: '@theme/DocsRoot',\n docVersionRootComponent: '@theme/DocVersionRoot',\n docRootComponent: '@theme/DocRoot',\n docItemComponent: '@theme/DocItem',\n remarkPlugins: [require('./my-remark-plugin')],\n rehypePlugins: [],\n beforeDefaultRemarkPlugins: [],\n beforeDefaultRehypePlugins: [],\n showLastUpdateAuthor: false,\n showLastUpdateTime: false,\n disableVersioning: false,\n includeCurrentVersion: true,\n lastVersion: undefined,\n versions: {\n current: {\n label: 'Android SDK v2.0.0 (WIP)',\n path: 'android-2.0.0',\n banner: 'none',\n },\n '1.0.0': {\n label: 'Android SDK v1.0.0',\n path: 'android-1.0.0',\n banner: 'unmaintained',\n },\n },\n onlyIncludeVersions: ['current', '1.0.0', '2.0.0'],\n}"}),"\n",(0,r.jsx)(n.h2,{id:"markdown-front-matter",children:"Markdown front matter"}),"\n",(0,r.jsxs)(n.p,{children:["Markdown documents can use the following Markdown ",(0,r.jsx)(n.a,{href:"/docs/markdown-features#front-matter",children:"front matter"})," metadata fields, enclosed by a line ",(0,r.jsx)(n.code,{children:"---"})," on either side."]}),"\n",(0,r.jsx)(n.p,{children:"Accepted fields:"}),"\n",(0,r.jsx)(c.Z,{children:(0,r.jsxs)(n.table,{children:[(0,r.jsx)(n.thead,{children:(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.th,{children:"Name"}),(0,r.jsx)(n.th,{children:"Type"}),(0,r.jsx)(n.th,{children:"Default"}),(0,r.jsx)(n.th,{children:"Description"})]})}),(0,r.jsxs)(n.tbody,{children:[(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"id"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"string"})}),(0,r.jsx)(n.td,{children:"file path (including folders, without the extension)"}),(0,r.jsx)(n.td,{children:"A unique document ID."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"title"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"string"})}),(0,r.jsxs)(n.td,{children:["Markdown title or ",(0,r.jsx)(n.code,{children:"id"})]}),(0,r.jsx)(n.td,{children:"The text title of your document. Used for the page metadata and as a fallback value in multiple places (sidebar, next/previous buttons...). Automatically added at the top of your doc if it does not contain any Markdown title."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"pagination_label"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"string"})}),(0,r.jsxs)(n.td,{children:[(0,r.jsx)(n.code,{children:"sidebar_label"})," or ",(0,r.jsx)(n.code,{children:"title"})]}),(0,r.jsx)(n.td,{children:"The text used in the document next/previous buttons for this document."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"sidebar_label"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"string"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"title"})}),(0,r.jsx)(n.td,{children:"The text shown in the document sidebar for this document."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"sidebar_position"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"number"})}),(0,r.jsx)(n.td,{children:"Default ordering"}),(0,r.jsxs)(n.td,{children:["Controls the position of a doc inside the generated sidebar slice when using ",(0,r.jsx)(n.code,{children:"autogenerated"})," sidebar items. See also ",(0,r.jsx)(n.a,{href:"/docs/sidebar/autogenerated#autogenerated-sidebar-metadata",children:"Autogenerated sidebar metadata"}),"."]})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"sidebar_class_name"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"string"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"undefined"})}),(0,r.jsx)(n.td,{children:"Gives the corresponding sidebar label a special class name when using autogenerated sidebars."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"sidebar_custom_props"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"object"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"undefined"})}),(0,r.jsxs)(n.td,{children:["Assign ",(0,r.jsx)(n.a,{href:"/docs/sidebar#passing-custom-props",children:"custom props"})," to the sidebar item referencing this doc"]})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"displayed_sidebar"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"string"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"undefined"})}),(0,r.jsxs)(n.td,{children:["Force the display of a given sidebar when browsing the current document. Read the ",(0,r.jsx)(n.a,{href:"/docs/sidebar/multiple-sidebars",children:"multiple sidebars guide"})," for details."]})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"hide_title"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"boolean"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"false"})}),(0,r.jsx)(n.td,{children:"Whether to hide the title at the top of the doc. It only hides a title declared through the front matter, and have no effect on a Markdown title at the top of your document."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"hide_table_of_contents"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"boolean"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"false"})}),(0,r.jsx)(n.td,{children:"Whether to hide the table of contents to the right."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"toc_min_heading_level"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"number"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"2"})}),(0,r.jsx)(n.td,{children:"The minimum heading level shown in the table of contents. Must be between 2 and 6 and lower or equal to the max value."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"toc_max_heading_level"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"number"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"3"})}),(0,r.jsx)(n.td,{children:"The max heading level shown in the table of contents. Must be between 2 and 6."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"pagination_next"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)("code",{children:"string | null"})}),(0,r.jsx)(n.td,{children:"Next doc in the sidebar"}),(0,r.jsxs)(n.td,{children:['The ID of the documentation you want the "Next" pagination to link to. Use ',(0,r.jsx)(n.code,{children:"null"}),' to disable showing "Next" for this page.']})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"pagination_prev"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)("code",{children:"string | null"})}),(0,r.jsx)(n.td,{children:"Previous doc in the sidebar"}),(0,r.jsxs)(n.td,{children:['The ID of the documentation you want the "Previous" pagination to link to. Use ',(0,r.jsx)(n.code,{children:"null"}),' to disable showing "Previous" for this page.']})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"parse_number_prefixes"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"boolean"})}),(0,r.jsxs)(n.td,{children:[(0,r.jsx)(n.code,{children:"numberPrefixParser"})," plugin option"]}),(0,r.jsxs)(n.td,{children:["Whether number prefix parsing is disabled on this doc. See also ",(0,r.jsx)(n.a,{href:"/docs/sidebar/autogenerated#using-number-prefixes",children:"Using number prefixes"}),"."]})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"custom_edit_url"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)("code",{children:"string | null"})}),(0,r.jsxs)(n.td,{children:["Computed using the ",(0,r.jsx)(n.code,{children:"editUrl"})," plugin option"]}),(0,r.jsxs)(n.td,{children:["The URL for editing this document. Use ",(0,r.jsx)(n.code,{children:"null"}),' to disable showing "Edit this page" for this page.']})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"keywords"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"string[]"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"undefined"})}),(0,r.jsx)(n.td,{children:"Keywords meta tag for the document page, for search engines."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"description"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"string"})}),(0,r.jsx)(n.td,{children:"The first line of Markdown content"}),(0,r.jsxs)(n.td,{children:["The description of your document, which will become the ",(0,r.jsx)(n.code,{children:''})," and ",(0,r.jsx)(n.code,{children:''})," in ",(0,r.jsx)(n.code,{children:""}),", used by search engines."]})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"image"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"string"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"undefined"})}),(0,r.jsxs)(n.td,{children:["Cover or thumbnail image that will be used as the ",(0,r.jsx)(n.code,{children:''})," in the ",(0,r.jsx)(n.code,{children:""}),", enhancing link previews on social media and messaging platforms."]})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"slug"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"string"})}),(0,r.jsx)(n.td,{children:"File path"}),(0,r.jsxs)(n.td,{children:["Allows to customize the document URL (",(0,r.jsx)(n.code,{children:"//"}),"). Support multiple patterns: ",(0,r.jsx)(n.code,{children:"slug: my-doc"}),", ",(0,r.jsx)(n.code,{children:"slug: /my/path/myDoc"}),", ",(0,r.jsx)(n.code,{children:"slug: /"}),"."]})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"tags"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"Tag[]"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"undefined"})}),(0,r.jsxs)(n.td,{children:["A list of strings or objects of two string fields ",(0,r.jsx)(n.code,{children:"label"})," and ",(0,r.jsx)(n.code,{children:"permalink"})," to tag to your docs."]})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"draft"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"boolean"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"false"})}),(0,r.jsx)(n.td,{children:"Draft documents will only be available during development."})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"unlisted"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"boolean"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"false"})}),(0,r.jsx)(n.td,{children:'Unlisted documents will be available in both development and production. They will be "hidden" in production, not indexed, excluded from sitemaps, and can only be accessed by users having a direct link.'})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"last_update"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"FrontMatterLastUpdate"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"undefined"})}),(0,r.jsxs)(n.td,{children:["Allows overriding the last update author/date. Date can be any ",(0,r.jsx)(n.a,{href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/parse",children:"parsable date string"}),"."]})]})]})]})}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-ts",children:"type FrontMatterLastUpdate = {date?: string; author?: string};\n\ntype Tag = string | {label: string; permalink: string};\n"})}),"\n",(0,r.jsx)(n.p,{children:"Example:"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-md",children:"---\nid: doc-markdown\ntitle: Docs Markdown Features\nhide_title: false\nhide_table_of_contents: false\nsidebar_label: Markdown\nsidebar_position: 3\npagination_label: Markdown features\ncustom_edit_url: https://github.com/facebook/docusaurus/edit/main/docs/api-doc-markdown.md\ndescription: How do I find you when I cannot solve this problem\nkeywords:\n - docs\n - docusaurus\nimage: https://i.imgur.com/mErPwqL.png\nslug: /myDoc\nlast_update:\n date: 1/1/2000\n author: custom author name\n---\n\n# Markdown Features\n\nMy Document Markdown content\n"})}),"\n",(0,r.jsx)(n.h2,{id:"i18n",children:"i18n"}),"\n",(0,r.jsxs)(n.p,{children:["Read the ",(0,r.jsx)(n.a,{href:"/docs/i18n/introduction",children:"i18n introduction"})," first."]}),"\n",(0,r.jsx)(n.h3,{id:"translation-files-location",children:"Translation files location"}),"\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.strong,{children:"Base path"}),": ",(0,r.jsx)(n.code,{children:"website/i18n/[locale]/docusaurus-plugin-content-docs"})]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.strong,{children:"Multi-instance path"}),": ",(0,r.jsx)(n.code,{children:"website/i18n/[locale]/docusaurus-plugin-content-docs-[pluginId]"})]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.strong,{children:"JSON files"}),": extracted with ",(0,r.jsx)(n.a,{href:"/docs/cli#docusaurus-write-translations-sitedir",children:(0,r.jsx)(n.code,{children:"docusaurus write-translations"})})]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.strong,{children:"Markdown files"}),": ",(0,r.jsx)(n.code,{children:"website/i18n/[locale]/docusaurus-plugin-content-docs/[versionName]"})]}),"\n"]}),"\n",(0,r.jsx)(n.h3,{id:"example-file-system-structure",children:"Example file-system structure"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-bash",children:"website/i18n/[locale]/docusaurus-plugin-content-docs\n\u2502\n\u2502 # translations for website/docs\n\u251c\u2500\u2500 current\n\u2502 \u251c\u2500\u2500 api\n\u2502 \u2502 \u2514\u2500\u2500 config.md\n\u2502 \u2514\u2500\u2500 getting-started.md\n\u251c\u2500\u2500 current.json\n\u2502\n\u2502 # translations for website/versioned_docs/version-1.0.0\n\u251c\u2500\u2500 version-1.0.0\n\u2502 \u251c\u2500\u2500 api\n\u2502 \u2502 \u2514\u2500\u2500 config.md\n\u2502 \u2514\u2500\u2500 getting-started.md\n\u2514\u2500\u2500 version-1.0.0.json\n"})})]})}function x(e={}){const{wrapper:n}={...(0,s.a)(),...e.components};return n?(0,r.jsx)(n,{...e,children:(0,r.jsx)(p,{...e})}):p(e)}}}]);
\ No newline at end of file
diff --git a/assets/js/0b7c2a4a.eef7ffe9.js b/assets/js/0b7c2a4a.eef7ffe9.js
new file mode 100644
index 0000000000..b01fa03124
--- /dev/null
+++ b/assets/js/0b7c2a4a.eef7ffe9.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkwebsite=self.webpackChunkwebsite||[]).push([[43769],{90632:(e,r,n)=>{n.d(r,{Z:()=>t});const t=n.p+"assets/images/social-card-3239a62bb56c9529ff255bc2c72e94f6.png"},61132:(e,r,n)=>{n.d(r,{Z:()=>i});var t=n(24246),s=(n(27378),n(40624));const a={tabItem:"tabItem_pnkT"};function i({children:e,hidden:r,className:n}){return(0,t.jsx)("div",{role:"tabpanel",className:(0,s.Z)(a.tabItem,n),hidden:r,children:e})}},97555:(e,r,n)=>{n.d(r,{Z:()=>P});var t=n(24246),s=n(27378),a=n(40624),i=n(75527),o=n(3620),l=n(44479),c=n(62821),u=n(52196),d=n(53589);function h(e,r,n){return r in e?Object.defineProperty(e,r,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[r]=n,e}function p(e,r){return r=null!=r?r:{},Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):function(e,r){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var t=Object.getOwnPropertySymbols(e);r&&(t=t.filter((function(r){return Object.getOwnPropertyDescriptor(e,r).enumerable}))),n.push.apply(n,t)}return n}(Object(r)).forEach((function(n){Object.defineProperty(e,n,Object.getOwnPropertyDescriptor(r,n))})),e}function g(e){var r,n;return null!==(n=null===(r=s.Children.toArray(e).filter((e=>"\n"!==e)).map((e=>{if(!e||(0,s.isValidElement)(e)&&function(e){const{props:r}=e;return!!r&&"object"==typeof r&&"value"in r}(e))return e;throw new Error(`Docusaurus error: Bad child <${"string"==typeof e.type?e.type:e.type.name}>: all children of the component should be , and every should have a unique "value" prop.`)})))||void 0===r?void 0:r.filter(Boolean))&&void 0!==n?n:[]}function b(e){const{values:r,children:n}=e;return(0,s.useMemo)((()=>{const e=null!=r?r:function(e){return g(e).map((({props:{value:e,label:r,attributes:n,default:t}})=>({value:e,label:r,attributes:n,default:t})))}(n);return function(e){const r=(0,u.l)(e,((e,r)=>e.value===r.value));if(r.length>0)throw new Error(`Docusaurus error: Duplicate values "${r.map((e=>e.value)).join(", ")}" found in . Every value needs to be unique.`)}(e),e}),[r,n])}function m({value:e,tabValues:r}){return r.some((r=>r.value===e))}function f({queryString:e=!1,groupId:r}){const n=(0,o.k6)(),t=function({queryString:e=!1,groupId:r}){if("string"==typeof e)return e;if(!1===e)return null;if(!0===e&&!r)throw new Error('Docusaurus error: The component groupId prop is required if queryString=true, because this value is used as the search param name. You can also provide an explicit value such as queryString="my-search-param".');return null!=r?r:null}({queryString:e,groupId:r}),a=(0,c._X)(t),i=(0,s.useCallback)((e=>{if(!t)return;const r=new URLSearchParams(n.location.search);r.set(t,e),n.replace(p(function(e){for(var r=1;rfunction({defaultValue:e,tabValues:r}){if(0===r.length)throw new Error("Docusaurus error: the component requires at least one children component");if(e){if(!m({value:e,tabValues:r}))throw new Error(`Docusaurus error: The has a defaultValue "${e}" but none of its children has the corresponding value. Available values are: ${r.map((e=>e.value)).join(", ")}. If you intend to show no default tab, use defaultValue={null} instead.`);return e}var n;const t=null!==(n=r.find((e=>e.default)))&&void 0!==n?n:r[0];if(!t)throw new Error("Unexpected error: 0 tabValues");return t.value}({defaultValue:r,tabValues:a}))),[c,u]=f({queryString:n,groupId:t}),[h,p]=function({groupId:e}){const r=function(e){return e?`docusaurus.tab.${e}`:null}(e),[n,t]=(0,d.Nk)(r);return[n,(0,s.useCallback)((e=>{r&&t.set(e)}),[r,t])]}({groupId:t}),g=(()=>{const e=null!=c?c:h;return m({value:e,tabValues:a})?e:null})();(0,l.Z)((()=>{g&&o(g)}),[g]);return{selectedValue:i,selectValue:(0,s.useCallback)((e=>{if(!m({value:e,tabValues:a}))throw new Error(`Can't select invalid tab value=${e}`);o(e),u(e),p(e)}),[u,p,a]),tabValues:a}}var x=n(29088);const y={tabList:"tabList_Qoir",tabItem:"tabItem_AQgk"};function w(e,r,n){return r in e?Object.defineProperty(e,r,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[r]=n,e}function v(e){for(var r=1;r{const r=e.currentTarget,t=l.indexOf(r),a=o[t].value;a!==n&&(c(r),s(a))},d=e=>{let r=null;switch(e.key){case"Enter":u(e);break;case"ArrowRight":{const t=l.indexOf(e.currentTarget)+1;var n;r=null!==(n=l[t])&&void 0!==n?n:l[0];break}case"ArrowLeft":{const n=l.indexOf(e.currentTarget)-1;var t;r=null!==(t=l[n])&&void 0!==t?t:l[l.length-1];break}}null==r||r.focus()};return(0,t.jsx)("ul",{role:"tablist","aria-orientation":"horizontal",className:(0,a.Z)("tabs",{"tabs--block":r},e),children:o.map((({value:e,label:r,attributes:s})=>(0,t.jsx)("li",k(v({role:"tab",tabIndex:n===e?0:-1,"aria-selected":n===e,ref:e=>l.push(e),onKeyDown:d,onClick:u},s),{className:(0,a.Z)("tabs__item",y.tabItem,null==s?void 0:s.className,{"tabs__item--active":n===e}),children:null!=r?r:e}),e)))})}function D({lazy:e,children:r,selectedValue:n}){const a=(Array.isArray(r)?r:[r]).filter(Boolean);if(e){const e=a.find((e=>e.props.value===n));return e?(0,s.cloneElement)(e,{className:"margin-top--md"}):null}return(0,t.jsx)("div",{className:"margin-top--md",children:a.map(((e,r)=>(0,s.cloneElement)(e,{key:r,hidden:e.props.value!==n})))})}function S(e){const r=j(e);return(0,t.jsxs)("div",{className:(0,a.Z)("tabs-container",y.tabList),children:[(0,t.jsx)(O,v({},e,r)),(0,t.jsx)(D,v({},e,r))]})}function P(e){const r=(0,x.Z)();return(0,t.jsx)(S,k(v({},e),{children:g(e.children)}),String(r))}},13381:(e,r,n)=>{n.d(r,{Z:()=>a});var t=n(24246),s=(n(27378),n(6698));function a({url:e}){return(0,t.jsx)("div",{style:{padding:10},children:(0,t.jsx)(s.Z,{url:e,style:{minWidth:"min(100%,45vw)",width:800,maxWidth:"100%",overflow:"hidden"},bodyStyle:{padding:0},children:(0,t.jsx)("iframe",{src:e,title:e,style:{display:"block",width:"100%",height:300}})})})}},6698:(e,r,n)=>{n.d(r,{Z:()=>c});var t=n(24246),s=(n(27378),n(40624));const a={browserWindow:"browserWindow_my1Q",browserWindowHeader:"browserWindowHeader_jXSR",row:"row_KZDM",buttons:"buttons_uHc7",right:"right_oyze",browserWindowAddressBar:"browserWindowAddressBar_Pd8y",dot:"dot_giz1",browserWindowMenuIcon:"browserWindowMenuIcon_Vhuh",bar:"bar_rrRL",browserWindowBody:"browserWindowBody_Idgs"};function i(e,r,n){return r in e?Object.defineProperty(e,r,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[r]=n,e}function o(e){for(var r=1;r{n.d(r,{Z:()=>a});var t=n(24246),s=n(27378);function a({children:e="Boom!",message:r="Boom!\nSomething bad happened, but you can try again!",cause:n}){const[a,i]=(0,s.useState)(!1);if(a)throw new Error(r,{cause:n?new Error(n):void 0});return(0,t.jsx)("button",{className:"button button--danger",type:"button",onClick:()=>i(!0),children:e})}},41665:(e,r,n)=>{n.d(r,{Z:()=>t});const t=n.p+"assets/images/navbar-error-15eefab8e8d77aa4d605939956987164.jpg"},61578:(e,r,n)=>{n.d(r,{Z:()=>t});const t=n.p+"assets/images/sidebar-item-description-f38981b17f486bc09fb811c6992ef668.jpg"},86435:(e,r,n)=>{n.d(r,{Z:()=>t});const t=n.p+"assets/images/social-card-3239a62bb56c9529ff255bc2c72e94f6.png"},38260:(e,r,n)=>{n.r(r),n.d(r,{assets:()=>p,contentTitle:()=>d,default:()=>m,frontMatter:()=>u,metadata:()=>h,toc:()=>g});var t=n(24246),s=n(71670),a=n(97555),i=n(61132),o=n(6698),l=n(13381),c=n(3818);const u={title:"Docusaurus 2.4",authors:["slorber"],tags:["release"],image:"./img/social-card.png",date:new Date("2023-03-23T00:00:00.000Z")},d=void 0,h={permalink:"/blog/releases/2.4",editUrl:"https://github.com/facebook/docusaurus/edit/main/website/blog/releases/2.4/index.mdx",source:"@site/blog/releases/2.4/index.mdx",title:"Docusaurus 2.4",description:"We are happy to announce Docusaurus 2.4.",date:"2023-03-23T00:00:00.000Z",tags:[{label:"release",permalink:"/blog/tags/release"}],readingTime:3.05,hasTruncateMarker:!0,authors:[{name:"S\xe9bastien Lorber",title:"Docusaurus maintainer, This Week In React editor",url:"https://thisweekinreact.com",twitter:"sebastienlorber",email:"sebastien@thisweekinreact.com",imageURL:"https://github.com/slorber.png",key:"slorber"}],frontMatter:{title:"Docusaurus 2.4",authors:["slorber"],tags:["release"],image:"./img/social-card.png",date:"2023-03-23T00:00:00.000Z"},unlisted:!1,lastUpdatedAt:1694767701e3,lastUpdatedBy:"S\xe9bastien Lorber",prevItem:{title:"Upgrading frontend dependencies with confidence",permalink:"/blog/upgrading-frontend-dependencies-with-confidence-using-visual-regression-testing"},nextItem:{title:"Docusaurus 2.3",permalink:"/blog/releases/2.3"}},p={image:n(90632).Z,authorsImageUrls:[void 0]},g=[{value:"Highlights",id:"highlights",level:2},{value:"Sidebar item description",id:"sidebar-item-description",level:3},{value:"Theme Query String",id:"theme-query-string",level:3},{value:"Remark plugin npm2yarn upgrade",id:"remark-plugin-npm2yarn-upgrade",level:3},{value:"gtag support for multiple tracking IDs",id:"gtag-support-for-multiple-tracking-ids",level:3},{value:"Developer Experience",id:"developer-experience",level:3},{value:"Translations",id:"translations",level:3},{value:"Other changes",id:"other-changes",level:2}];function b(e){const r={a:"a",admonition:"admonition",code:"code",h2:"h2",h3:"h3",img:"img",li:"li",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,s.a)(),...e.components};return(0,t.jsxs)(t.Fragment,{children:[(0,t.jsxs)(r.p,{children:["We are happy to announce ",(0,t.jsx)(r.strong,{children:"Docusaurus 2.4"}),"."]}),"\n",(0,t.jsxs)(r.p,{children:["The upgrade should be easy: as explained in our ",(0,t.jsx)(r.a,{href:"/community/release-process",children:"release process documentation"}),", minor versions respect ",(0,t.jsx)(r.a,{href:"https://semver.org/",children:"Semantic Versioning"}),"."]}),"\n",(0,t.jsx)(r.p,{children:(0,t.jsx)(r.img,{alt:"Docusaurus blog post social card",src:n(86435).Z+"",width:"1200",height:"600"})}),"\n","\n",(0,t.jsx)(r.h2,{id:"highlights",children:"Highlights"}),"\n",(0,t.jsx)(r.h3,{id:"sidebar-item-description",children:"Sidebar item description"}),"\n",(0,t.jsxs)(r.p,{children:["In ",(0,t.jsx)(r.a,{href:"https://github.com/facebook/docusaurus/pull/8236",children:"#8236"}),", we made it possible to provide a new ",(0,t.jsx)(r.code,{children:"description"})," attribute for docs sidebar items of type ",(0,t.jsx)(r.code,{children:"link"})," and ",(0,t.jsx)(r.code,{children:"category"}),"."]}),"\n",(0,t.jsx)(r.pre,{children:(0,t.jsx)(r.code,{className:"language-tsx",metastring:'title="sidebars.js"',children:"[\n {\n type: 'link',\n label: 'Link with description',\n href: 'https://docusaurus.io',\n // highlight-next-line\n description: 'Some link description',\n },\n {\n type: 'category',\n label: 'Category with description',\n // highlight-next-line\n description: 'Some category description',\n items: [],\n },\n];\n"})}),"\n",(0,t.jsx)(r.p,{children:"These descriptions will be used in category generated index pages."}),"\n",(0,t.jsx)(r.p,{children:(0,t.jsx)(r.img,{alt:"Show sidebar category generated index with custom descriptions",src:n(61578).Z+"",width:"1400",height:"691"})}),"\n",(0,t.jsx)(r.h3,{id:"theme-query-string",children:"Theme Query String"}),"\n",(0,t.jsxs)(r.p,{children:["In ",(0,t.jsx)(r.a,{href:"https://github.com/facebook/docusaurus/pull/8708",children:"#8708"}),", we added the possibility to force Docusaurus to initialize itself in ",(0,t.jsx)(r.code,{children:"light"})," or ",(0,t.jsx)(r.code,{children:"dark"})," mode through a new ",(0,t.jsx)(r.code,{children:"docusaurus-theme"})," query-string parameter."]}),"\n",(0,t.jsx)(r.p,{children:"This is useful to ensure a consistent theme when embedding an existing Docusaurus page into an iframe or WebView."}),"\n",(0,t.jsx)(l.Z,{url:"/docs/?docusaurus-theme=light"}),"\n",(0,t.jsx)(l.Z,{url:"/docs/?docusaurus-theme=dark"}),"\n",(0,t.jsx)(r.h3,{id:"remark-plugin-npm2yarn-upgrade",children:"Remark plugin npm2yarn upgrade"}),"\n",(0,t.jsxs)(r.p,{children:["In ",(0,t.jsx)(r.a,{href:"https://github.com/facebook/docusaurus/pull/8690",children:"#8690"}),", we upgraded our Remark plugin ",(0,t.jsx)(r.a,{href:"https://github.com/facebook/docusaurus/tree/main/packages/docusaurus-remark-plugin-npm2yarn",children:"@docusaurus/remark-plugin-npm2yarn"})," with many conversion bug fixes, first-class support for pnpm, and the ability to register custom converters producing new tabs."]}),"\n",(0,t.jsx)(r.pre,{children:(0,t.jsx)(r.code,{className:"language-markdown",children:"Run these commands!\n\n```bash npm2yarn\nnpm install\nnpm run build\nnpm run myCustomScript -- --some-arg\n```\n"})}),"\n",(0,t.jsx)(o.Z,{children:(0,t.jsxs)(a.Z,{children:[(0,t.jsx)(i.Z,{value:"npm",children:(0,t.jsx)(r.pre,{children:(0,t.jsx)(r.code,{className:"language-bash",children:"npm install\nnpm run build\nnpm run myCustomScript -- --some-arg\n"})})}),(0,t.jsx)(i.Z,{value:"yarn",label:"Yarn",children:(0,t.jsx)(r.pre,{children:(0,t.jsx)(r.code,{className:"language-bash",children:"yarn install\nyarn build\nyarn myCustomScript --some-arg\n"})})}),(0,t.jsx)(i.Z,{value:"pnpm",label:"pnpm",children:(0,t.jsx)(r.pre,{children:(0,t.jsx)(r.code,{className:"language-bash",children:"pnpm install\npnpm run build\npnpm run myCustomScript --some-arg\n"})})})]})}),"\n",(0,t.jsx)(r.h3,{id:"gtag-support-for-multiple-tracking-ids",children:"gtag support for multiple tracking IDs"}),"\n",(0,t.jsxs)(r.p,{children:["In ",(0,t.jsx)(r.a,{href:"https://github.com/facebook/docusaurus/pull/8620",children:"#8620"})," we added support for the ",(0,t.jsx)(r.a,{href:"/docs/api/plugins/@docusaurus/plugin-google-gtag",children:"@docusaurus/plugin-google-gtag"})," plugin to declare multiple tracking IDs."]}),"\n",(0,t.jsx)(r.pre,{children:(0,t.jsx)(r.code,{className:"language-js",metastring:'title="docusaurus.config.js"',children:"module.exports = {\n presets: [\n [\n '@docusaurus/preset-classic',\n {\n gtag: {\n trackingID: [\n // highlight-next-line\n 'G-',\n // highlight-next-line\n 'UA-',\n ],\n },\n },\n ],\n ],\n};\n"})}),"\n",(0,t.jsxs)(r.admonition,{title:"Google is sunsetting Universal Analytics",type:"warning",children:[(0,t.jsxs)(r.p,{children:[(0,t.jsx)(r.strong,{children:(0,t.jsx)(r.a,{href:"https://blog.google/products/marketingplatform/analytics/prepare-for-future-with-google-analytics-4/",children:"Google will sunset its Universal Analytics"})})," on ",(0,t.jsx)(r.strong,{children:"July 1, 2023"}),"."]}),(0,t.jsxs)(r.p,{children:["Docusaurus users should migrate to Google Analytics 4. Google ",(0,t.jsx)(r.strong,{children:"does not permit to migrate your existing Universal Analytics data"})," to your new Google Analytics 4 property."]}),(0,t.jsxs)(r.p,{children:["To preserve the continuity of your analytics, we temporarily recommend that you report events to 2 tracking IDs at the same time: the old one (",(0,t.jsx)(r.code,{children:"UA-*"}),") and new one (",(0,t.jsx)(r.code,{children:"G-*"}),"). Refer to the ",(0,t.jsx)(r.strong,{children:(0,t.jsx)(r.a,{href:"https://github.com/facebook/docusaurus/issues/7221",children:"dedicated issue"})})," for details."]})]}),"\n",(0,t.jsx)(r.h3,{id:"developer-experience",children:"Developer Experience"}),"\n",(0,t.jsxs)(r.p,{children:["In ",(0,t.jsx)(r.a,{href:"https://github.com/facebook/docusaurus/pull/8736",children:"#8736"}),", we improved how we render error messages and added initial support to render the full causal chain of an error (see ",(0,t.jsx)(r.a,{href:"https://h3manth.com/ES2022/#error-cause",children:"ES2022 Error Cause"}),")."]}),"\n",(0,t.jsx)(r.admonition,{type:"tip",children:(0,t.jsxs)(r.p,{children:["To see it in action, click here: ",(0,t.jsx)(c.Z,{cause:"Probably undefined is not a function \ud83d\ude04"})]})}),"\n",(0,t.jsxs)(r.p,{children:["In ",(0,t.jsx)(r.a,{href:"https://github.com/facebook/docusaurus/pull/8735",children:"#8735"})," we also made navbar-related error messages clearer to help users understand what they did wrong."]}),"\n",(0,t.jsx)(r.p,{children:(0,t.jsx)(r.img,{alt:"Docusaurus navbar error message screenshot",src:n(41665).Z+"",width:"1676",height:"1614"})}),"\n",(0,t.jsx)(r.h3,{id:"translations",children:"Translations"}),"\n",(0,t.jsx)(r.p,{children:"We made it possible to translate some new elements:"}),"\n",(0,t.jsxs)(r.ul,{children:["\n",(0,t.jsxs)(r.li,{children:[(0,t.jsx)(r.a,{href:"https://github.com/facebook/docusaurus/pull/8677",children:"#8677"})," introduces a new ",(0,t.jsx)(r.code,{children:"process.env.DOCUSAURUS_CURRENT_LOCALE"})," (experimental) allowing you to localize your config file, including site title, tagline, announcement bar, baseUrl..."]}),"\n",(0,t.jsxs)(r.li,{children:[(0,t.jsx)(r.a,{href:"https://github.com/facebook/docusaurus/pull/8616",children:"#8616"})," allows to translate the navbar and footer logo alt text"]}),"\n"]}),"\n",(0,t.jsx)(r.p,{children:"We added default theme translation support for multiple languages:"}),"\n",(0,t.jsxs)(r.ul,{children:["\n",(0,t.jsxs)(r.li,{children:["\ud83c\udded\ud83c\uddfa ",(0,t.jsx)(r.a,{href:"https://github.com/facebook/docusaurus/pull/8668",children:"#8668"}),": Hungarian"]}),"\n",(0,t.jsxs)(r.li,{children:["\ud83c\uddf3\ud83c\uddf4 ",(0,t.jsx)(r.a,{href:"https://github.com/facebook/docusaurus/pull/8631",children:"#8631"}),": Norwegian (Bokm\xe5l)"]}),"\n"]}),"\n",(0,t.jsx)(r.admonition,{type:"tip",children:(0,t.jsxs)(r.p,{children:["Completing theme translations is an ",(0,t.jsx)(r.a,{href:"https://github.com/facebook/docusaurus/issues/3526",children:"ongoing effort"})," and an easy way to contribute to Docusaurus. We add new theme features regularly, for which we often ",(0,t.jsx)(r.a,{href:"https://github.com/facebook/docusaurus/issues/3526",children:"need new translations"}),"."]})}),"\n",(0,t.jsx)(r.h2,{id:"other-changes",children:"Other changes"}),"\n",(0,t.jsx)(r.p,{children:"Other notable changes include:"}),"\n",(0,t.jsxs)(r.ul,{children:["\n",(0,t.jsxs)(r.li,{children:[(0,t.jsx)(r.a,{href:"https://github.com/facebook/docusaurus/pull/8674",children:"#8674"}),": respect ",(0,t.jsx)(r.code,{children:"prefers-reduced-motion: reduce"})," media query"]}),"\n",(0,t.jsxs)(r.li,{children:[(0,t.jsx)(r.a,{href:"https://github.com/facebook/docusaurus/pull/8712",children:"#8712"}),": use a navbar item of type ",(0,t.jsx)(r.code,{children:"docSidebar"})," in template"]}),"\n",(0,t.jsxs)(r.li,{children:[(0,t.jsx)(r.a,{href:"https://github.com/facebook/docusaurus/pull/8801",children:"#8801"}),": allow tabs children to be falsy"]}),"\n",(0,t.jsxs)(r.li,{children:[(0,t.jsx)(r.a,{href:"https://github.com/facebook/docusaurus/pull/8757",children:"#8757"}),": make search page react to external query-string changes"]}),"\n",(0,t.jsxs)(r.li,{children:[(0,t.jsx)(r.a,{href:"https://github.com/facebook/docusaurus/pull/8803",children:"#8803"}),": fix code block buttons position in RTL"]}),"\n",(0,t.jsxs)(r.li,{children:[(0,t.jsx)(r.a,{href:"https://github.com/facebook/docusaurus/pull/8615",children:"#8615"}),": fix color mode toggle when using dark navbar"]}),"\n",(0,t.jsxs)(r.li,{children:[(0,t.jsx)(r.a,{href:"https://github.com/facebook/docusaurus/pull/8699",children:"#8699"}),": fix navbar dropdown tab focus bug"]}),"\n"]}),"\n",(0,t.jsxs)(r.p,{children:["Check the ",(0,t.jsx)(r.strong,{children:(0,t.jsx)(r.a,{href:"/changelog/2.4.0",children:"2.4.0 changelog entry"})})," for an exhaustive list of changes."]})]})}function m(e={}){const{wrapper:r}={...(0,s.a)(),...e.components};return r?(0,t.jsx)(r,{...e,children:(0,t.jsx)(b,{...e})}):b(e)}},71670:(e,r,n)=>{n.d(r,{Z:()=>o,a:()=>i});var t=n(27378);const s={},a=t.createContext(s);function i(e){const r=t.useContext(a);return t.useMemo((function(){return"function"==typeof e?e(r):{...r,...e}}),[r,e])}function o(e){let r;return r=e.disableParentContext?"function"==typeof e.components?e.components(s):e.components||s:i(e.components),t.createElement(a.Provider,{value:r},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/0b899567.e413dd2c.js b/assets/js/0b899567.e413dd2c.js
new file mode 100644
index 0000000000..82472cc752
--- /dev/null
+++ b/assets/js/0b899567.e413dd2c.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkwebsite=self.webpackChunkwebsite||[]).push([[82413],{39224:(e,s,t)=>{t.r(s),t.d(s,{assets:()=>a,contentTitle:()=>r,default:()=>u,frontMatter:()=>n,metadata:()=>h,toc:()=>l});var o=t(24246),i=t(71670);const n={mdx:{format:"md"},date:"2022-05-05T20:00",authors:["Josh-Cena","lex111","pepopowitz","RDIL","sgromkov","slorber"]},r="2.0.0-beta.20",h={permalink:"/changelog/2.0.0-beta.20",source:"@site/changelog/source/2.0.0-beta.20.md",title:"2.0.0-beta.20",description:"Bug Fix",date:"2022-05-05T20:00:00.000Z",tags:[],hasTruncateMarker:!0,authors:[{name:"Joshua Chen",alias:"Josh-Cena",url:"https://github.com/Josh-Cena",imageURL:"https://github.com/Josh-Cena.png",key:"Josh-Cena"},{name:"Alexey Pyltsyn",alias:"lex111",url:"https://github.com/lex111",imageURL:"https://github.com/lex111.png",key:"lex111"},{name:"Steven Hicks",alias:"pepopowitz",url:"https://github.com/pepopowitz",imageURL:"https://github.com/pepopowitz.png",key:"pepopowitz"},{name:"Reece Dunham",alias:"RDIL",url:"https://github.com/RDIL",imageURL:"https://github.com/RDIL.png",key:"RDIL"},{name:"Sergey Gromkov",alias:"sgromkov",url:"https://github.com/sgromkov",imageURL:"https://github.com/sgromkov.png",key:"sgromkov"},{name:"S\xe9bastien Lorber",alias:"slorber",url:"https://github.com/slorber",imageURL:"https://github.com/slorber.png",key:"slorber"}],frontMatter:{mdx:{format:"md"},date:"2022-05-05T20:00",authors:["Josh-Cena","lex111","pepopowitz","RDIL","sgromkov","slorber"]},unlisted:!1,prevItem:{title:"2.0.0-beta.21",permalink:"/changelog/2.0.0-beta.21"},nextItem:{title:"2.0.0-beta.19",permalink:"/changelog/2.0.0-beta.19"},listPageLink:"/changelog/"},a={authorsImageUrls:[void 0,void 0,void 0,void 0,void 0,void 0]},l=[{value:"\ud83d\udc1b Bug Fix",id:"bug-bug-fix",level:2},{value:"\ud83d\udcdd Documentation",id:"memo-documentation",level:2},{value:"Committers: 6",id:"committers-6",level:2}];function c(e){const s={a:"a",code:"code",h2:"h2",li:"li",ul:"ul",...(0,i.a)(),...e.components};return(0,o.jsxs)(o.Fragment,{children:[(0,o.jsx)(s.h2,{id:"bug-bug-fix",children:"\ud83d\udc1b Bug Fix"}),"\n",(0,o.jsxs)(s.ul,{children:["\n",(0,o.jsxs)(s.li,{children:[(0,o.jsx)(s.code,{children:"docusaurus"}),"\n",(0,o.jsxs)(s.ul,{children:["\n",(0,o.jsxs)(s.li,{children:[(0,o.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7342",children:"#7342"})," fix: avoid flash of page scrolling to top on refresh (",(0,o.jsx)(s.a,{href:"https://github.com/slorber",children:"@slorber"}),")"]}),"\n",(0,o.jsxs)(s.li,{children:[(0,o.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7329",children:"#7329"})," fix(core): inject docusaurus version into SSR as local (",(0,o.jsx)(s.a,{href:"https://github.com/RDIL",children:"@RDIL"}),")"]}),"\n"]}),"\n"]}),"\n",(0,o.jsxs)(s.li,{children:[(0,o.jsx)(s.code,{children:"docusaurus-theme-classic"}),"\n",(0,o.jsxs)(s.ul,{children:["\n",(0,o.jsxs)(s.li,{children:[(0,o.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7341",children:"#7341"})," fix(theme-classic): properly highlight code block line numbers (",(0,o.jsx)(s.a,{href:"https://github.com/Josh-Cena",children:"@Josh-Cena"}),")"]}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,o.jsx)(s.h2,{id:"memo-documentation",children:"\ud83d\udcdd Documentation"}),"\n",(0,o.jsxs)(s.ul,{children:["\n",(0,o.jsxs)(s.li,{children:[(0,o.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7334",children:"#7334"})," feat(website): make canary release page display actual canary version name (",(0,o.jsx)(s.a,{href:"https://github.com/Josh-Cena",children:"@Josh-Cena"}),")"]}),"\n",(0,o.jsxs)(s.li,{children:[(0,o.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7343",children:"#7343"})," docs: add page for create-docusaurus API documentation (",(0,o.jsx)(s.a,{href:"https://github.com/Josh-Cena",children:"@Josh-Cena"}),")"]}),"\n",(0,o.jsxs)(s.li,{children:[(0,o.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7340",children:"#7340"})," docs: add Yandex Metrika plugin to community plugins (",(0,o.jsx)(s.a,{href:"https://github.com/sgromkov",children:"@sgromkov"}),")"]}),"\n",(0,o.jsxs)(s.li,{children:[(0,o.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7336",children:"#7336"})," fix(website): fix multiple accessibility issues around color contrast (",(0,o.jsx)(s.a,{href:"https://github.com/Josh-Cena",children:"@Josh-Cena"}),")"]}),"\n",(0,o.jsxs)(s.li,{children:[(0,o.jsx)(s.a,{href:"https://github.com/facebook/docusaurus/pull/7327",children:"#7327"})," docs: add clarity to versioning behavior (",(0,o.jsx)(s.a,{href:"https://github.com/pepopowitz",children:"@pepopowitz"}),")"]}),"\n"]}),"\n",(0,o.jsx)(s.h2,{id:"committers-6",children:"Committers: 6"}),"\n",(0,o.jsxs)(s.ul,{children:["\n",(0,o.jsxs)(s.li,{children:["Alexey Pyltsyn (",(0,o.jsx)(s.a,{href:"https://github.com/lex111",children:"@lex111"}),")"]}),"\n",(0,o.jsxs)(s.li,{children:["Joshua Chen (",(0,o.jsx)(s.a,{href:"https://github.com/Josh-Cena",children:"@Josh-Cena"}),")"]}),"\n",(0,o.jsxs)(s.li,{children:["Reece Dunham (",(0,o.jsx)(s.a,{href:"https://github.com/RDIL",children:"@RDIL"}),")"]}),"\n",(0,o.jsxs)(s.li,{children:["Sergey Gromkov (",(0,o.jsx)(s.a,{href:"https://github.com/sgromkov",children:"@sgromkov"}),")"]}),"\n",(0,o.jsxs)(s.li,{children:["Steven Hicks (",(0,o.jsx)(s.a,{href:"https://github.com/pepopowitz",children:"@pepopowitz"}),")"]}),"\n",(0,o.jsxs)(s.li,{children:["S\xe9bastien Lorber (",(0,o.jsx)(s.a,{href:"https://github.com/slorber",children:"@slorber"}),")"]}),"\n"]})]})}function u(e={}){const{wrapper:s}={...(0,i.a)(),...e.components};return s?(0,o.jsx)(s,{...e,children:(0,o.jsx)(c,{...e})}):c(e)}},71670:(e,s,t)=>{t.d(s,{Z:()=>h,a:()=>r});var o=t(27378);const i={},n=o.createContext(i);function r(e){const s=o.useContext(n);return o.useMemo((function(){return"function"==typeof e?e(s):{...s,...e}}),[s,e])}function h(e){let s;return s=e.disableParentContext?"function"==typeof e.components?e.components(i):e.components||i:r(e.components),o.createElement(n.Provider,{value:s},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/0bc851e0.4433ddd3.js b/assets/js/0bc851e0.4433ddd3.js
new file mode 100644
index 0000000000..70e830bac7
--- /dev/null
+++ b/assets/js/0bc851e0.4433ddd3.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkwebsite=self.webpackChunkwebsite||[]).push([[33009],{47817:(e,s,t)=>{t.d(s,{Z:()=>r});const r=t.p+"assets/images/social-card-8dc2413b4f9e86328bf77575e91171d7.png"},28147:(e,s,t)=>{t.d(s,{Z:()=>r});const r=t.p+"assets/images/social-card-8dc2413b4f9e86328bf77575e91171d7.png"},48653:(e,s,t)=>{t.r(s),t.d(s,{assets:()=>c,contentTitle:()=>o,default:()=>d,frontMatter:()=>a,metadata:()=>i,toc:()=>u});var r=t(24246),n=t(71670);const a={title:"Docusaurus 2.1",authors:["slorber"],tags:["release"],image:"./img/social-card.png"},o=void 0,i={permalink:"/blog/2022/09/01/docusaurus-2.1",editUrl:"https://github.com/facebook/docusaurus/edit/main/website/blog/2022/09-01-docusaurus-2.1/index.mdx",source:"@site/blog/2022/09-01-docusaurus-2.1/index.mdx",title:"Docusaurus 2.1",description:"We are happy to announce Docusaurus 2.1, our very first minor version release.",date:"2022-09-01T00:00:00.000Z",tags:[{label:"release",permalink:"/blog/tags/release"}],readingTime:1.725,hasTruncateMarker:!0,authors:[{name:"S\xe9bastien Lorber",title:"Docusaurus maintainer, This Week In React editor",url:"https://thisweekinreact.com",twitter:"sebastienlorber",email:"sebastien@thisweekinreact.com",imageURL:"https://github.com/slorber.png",key:"slorber"}],frontMatter:{title:"Docusaurus 2.1",authors:["slorber"],tags:["release"],image:"./img/social-card.png"},unlisted:!1,lastUpdatedAt:1710954485e3,lastUpdatedBy:"Zed Spencer-Milnes",prevItem:{title:"Docusaurus 2.2",permalink:"/blog/releases/2.2"},nextItem:{title:"Announcing Docusaurus 2.0",permalink:"/blog/2022/08/01/announcing-docusaurus-2.0"}},c={image:t(47817).Z,authorsImageUrls:[void 0]},u=[];function l(e){const s={a:"a",img:"img",p:"p",strong:"strong",...(0,n.a)(),...e.components};return(0,r.jsxs)(r.Fragment,{children:[(0,r.jsxs)(s.p,{children:["We are happy to announce ",(0,r.jsx)(s.strong,{children:"Docusaurus 2.1"}),", our very first minor version release."]}),"\n",(0,r.jsxs)(s.p,{children:["The upgrade should be easy: as explained in our ",(0,r.jsx)(s.a,{href:"/community/release-process",children:"release process documentation"}),", minor versions respect ",(0,r.jsx)(s.a,{href:"https://semver.org/",children:"Semantic Versioning"}),"."]}),"\n",(0,r.jsx)(s.p,{children:(0,r.jsx)(s.img,{alt:"Docusaurus 2.1 social card",src:t(28147).Z+"",width:"1200",height:"600"})})]})}function d(e={}){const{wrapper:s}={...(0,n.a)(),...e.components};return s?(0,r.jsx)(s,{...e,children:(0,r.jsx)(l,{...e})}):l(e)}},71670:(e,s,t)=>{t.d(s,{Z:()=>i,a:()=>o});var r=t(27378);const n={},a=r.createContext(n);function o(e){const s=r.useContext(a);return r.useMemo((function(){return"function"==typeof e?e(s):{...s,...e}}),[s,e])}function i(e){let s;return s=e.disableParentContext?"function"==typeof e.components?e.components(n):e.components||n:o(e.components),r.createElement(a.Provider,{value:s},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/0bdaac98.d6cfb712.js b/assets/js/0bdaac98.d6cfb712.js
new file mode 100644
index 0000000000..9629f33537
--- /dev/null
+++ b/assets/js/0bdaac98.d6cfb712.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkwebsite=self.webpackChunkwebsite||[]).push([[14265],{59872:s=>{s.exports=JSON.parse('{"tag":{"label":"docusaurus","permalink":"/tests/blog/tags/docusaurus","allTagsPath":"/tests/blog/tags","count":4,"unlisted":false},"listMetadata":{"permalink":"/tests/blog/tags/docusaurus","page":1,"postsPerPage":3,"totalPages":2,"totalCount":4,"nextPage":"/tests/blog/tags/docusaurus/page/2","blogDescription":"Blog","blogTitle":"Blog"}}')}}]);
\ No newline at end of file
diff --git a/assets/js/0c7845dd.10da5707.js b/assets/js/0c7845dd.10da5707.js
new file mode 100644
index 0000000000..9c7c39c1e7
--- /dev/null
+++ b/assets/js/0c7845dd.10da5707.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkwebsite=self.webpackChunkwebsite||[]).push([[43473],{31014:(e,s,t)=>{t.r(s),t.d(s,{assets:()=>u,contentTitle:()=>l,default:()=>x,frontMatter:()=>o,metadata:()=>d,toc:()=>r});var n=t(24246),i=t(71670),c=t(58464);const o={toc_max_heading_level:5},l=void 0,d={id:"toc/toc-_-5",title:"toc-_-5",description:"",source:"@site/_dogfooding/_docs tests/toc/toc-_-5.mdx",sourceDirName:"toc",slug:"/toc/toc-_-5",permalink:"/tests/docs/toc/toc-_-5",draft:!1,unlisted:!1,tags:[],version:"current",lastUpdatedBy:"Anatoly Kopyl",lastUpdatedAt:1705687091e3,frontMatter:{toc_max_heading_level:5},sidebar:"sidebar",previous:{title:"toc-5-5",permalink:"/tests/docs/toc/toc-5-5"},next:{title:"toc-_-_",permalink:"/tests/docs/toc/toc-_-_"}},u={},r=[...c.d$];function h(e){return(0,n.jsx)(c.ZP,{})}function x(e={}){const{wrapper:s}={...(0,i.a)(),...e.components};return s?(0,n.jsx)(s,{...e,children:(0,n.jsx)(h,{...e})}):h()}},58464:(e,s,t)=>{t.d(s,{ZP:()=>l,d$:()=>c});var n=t(24246),i=t(71670);const c=[{value:"section 1",id:"section-1",level:2},{value:"subsection 1-1",id:"subsection-1-1",level:3},{value:"subsection 1-1-1",id:"subsection-1-1-1",level:4},{value:"subsection 1-1-1-1",id:"subsection-1-1-1-1",level:5},{value:"subsection 1-1-1-1-1",id:"subsection-1-1-1-1-1",level:6},{value:"subsection 1-1-1-1-2",id:"subsection-1-1-1-1-2",level:6},{value:"subsection 1-1-1-2",id:"subsection-1-1-1-2",level:5},{value:"subsection 1-1-2",id:"subsection-1-1-2",level:4},{value:"subsection 1-2",id:"subsection-1-2",level:3},{value:"subsection 1-3",id:"subsection-1-3",level:3},{value:"section 2",id:"section-2",level:2},{value:"subsection 2-1",id:"subsection-2-1",level:3},{value:"subsection 2-1",id:"subsection-2-1-1",level:3},{value:"section 3",id:"section-3",level:2},{value:"subsection 3-1",id:"subsection-3-1",level:3},{value:"subsection 3-2",id:"subsection-3-2",level:3}];function o(e){const s={h1:"h1",h2:"h2",h3:"h3",h4:"h4",h5:"h5",h6:"h6",p:"p",...(0,i.a)(),...e.components};return(0,n.jsxs)(n.Fragment,{children:[(0,n.jsx)(s.h1,{id:"title",children:"title"}),"\n",(0,n.jsx)(s.p,{children:"some text"}),"\n",(0,n.jsx)(s.h2,{id:"section-1",children:"section 1"}),"\n",(0,n.jsx)(s.p,{children:"some text"}),"\n",(0,n.jsx)(s.h3,{id:"subsection-1-1",children:"subsection 1-1"}),"\n",(0,n.jsx)(s.p,{children:"some text"}),"\n",(0,n.jsx)(s.h4,{id:"subsection-1-1-1",children:"subsection 1-1-1"}),"\n",(0,n.jsx)(s.p,{children:"some text"}),"\n",(0,n.jsx)(s.h5,{id:"subsection-1-1-1-1",children:"subsection 1-1-1-1"}),"\n",(0,n.jsx)(s.p,{children:"some text"}),"\n",(0,n.jsx)(s.h6,{id:"subsection-1-1-1-1-1",children:"subsection 1-1-1-1-1"}),"\n",(0,n.jsx)(s.p,{children:"some text"}),"\n",(0,n.jsx)(s.h6,{id:"subsection-1-1-1-1-2",children:"subsection 1-1-1-1-2"}),"\n",(0,n.jsx)(s.p,{children:"some text"}),"\n",(0,n.jsx)(s.h5,{id:"subsection-1-1-1-2",children:"subsection 1-1-1-2"}),"\n",(0,n.jsx)(s.p,{children:"some text"}),"\n",(0,n.jsx)(s.h4,{id:"subsection-1-1-2",children:"subsection 1-1-2"}),"\n",(0,n.jsx)(s.p,{children:"some text"}),"\n",(0,n.jsx)(s.h3,{id:"subsection-1-2",children:"subsection 1-2"}),"\n",(0,n.jsx)(s.p,{children:"some text"}),"\n",(0,n.jsx)(s.h3,{id:"subsection-1-3",children:"subsection 1-3"}),"\n",(0,n.jsx)(s.p,{children:"some text"}),"\n",(0,n.jsx)(s.h2,{id:"section-2",children:"section 2"}),"\n",(0,n.jsx)(s.p,{children:"some text"}),"\n",(0,n.jsx)(s.h3,{id:"subsection-2-1",children:"subsection 2-1"}),"\n",(0,n.jsx)(s.p,{children:"some text"}),"\n",(0,n.jsx)(s.h3,{id:"subsection-2-1-1",children:"subsection 2-1"}),"\n",(0,n.jsx)(s.p,{children:"some text"}),"\n",(0,n.jsx)(s.h2,{id:"section-3",children:"section 3"}),"\n",(0,n.jsx)(s.p,{children:"some text"}),"\n",(0,n.jsx)(s.h3,{id:"subsection-3-1",children:"subsection 3-1"}),"\n",(0,n.jsx)(s.p,{children:"some text"}),"\n",(0,n.jsx)(s.h3,{id:"subsection-3-2",children:"subsection 3-2"}),"\n",(0,n.jsx)(s.p,{children:"some text"})]})}function l(e={}){const{wrapper:s}={...(0,i.a)(),...e.components};return s?(0,n.jsx)(s,{...e,children:(0,n.jsx)(o,{...e})}):o(e)}},71670:(e,s,t)=>{t.d(s,{Z:()=>l,a:()=>o});var n=t(27378);const i={},c=n.createContext(i);function o(e){const s=n.useContext(c);return n.useMemo((function(){return"function"==typeof e?e(s):{...s,...e}}),[s,e])}function l(e){let s;return s=e.disableParentContext?"function"==typeof e.components?e.components(i):e.components||i:o(e.components),n.createElement(c.Provider,{value:s},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/0e384e19.08498ba7.js b/assets/js/0e384e19.08498ba7.js
deleted file mode 100644
index fb70492a37..0000000000
--- a/assets/js/0e384e19.08498ba7.js
+++ /dev/null
@@ -1 +0,0 @@
-"use strict";(self.webpackChunkdocusaurus=self.webpackChunkdocusaurus||[]).push([[3976],{1512:(e,t,n)=>{n.r(t),n.d(t,{assets:()=>l,contentTitle:()=>i,default:()=>u,frontMatter:()=>o,metadata:()=>a,toc:()=>d});var s=n(4848),r=n(8453);const o={sidebar_position:1},i="Tutorial Intro",a={id:"intro",title:"Tutorial Intro",description:"Let's discover Docusaurus in less than 5 minutes.",source:"@site/docs/intro.md",sourceDirName:".",slug:"/intro",permalink:"/docs/intro",draft:!1,unlisted:!1,editUrl:"https://github.com/facebook/docusaurus/tree/main/packages/create-docusaurus/templates/shared/docs/intro.md",tags:[],version:"current",sidebarPosition:1,frontMatter:{sidebar_position:1},sidebar:"tutorialSidebar",next:{title:"Tutorial - Basics",permalink:"/docs/category/tutorial---basics"}},l={},d=[{value:"Getting Started",id:"getting-started",level:2},{value:"What you'll need",id:"what-youll-need",level:3},{value:"Generate a new site",id:"generate-a-new-site",level:2},{value:"Start your site",id:"start-your-site",level:2}];function c(e){const t={a:"a",code:"code",h1:"h1",h2:"h2",h3:"h3",li:"li",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,r.R)(),...e.components};return(0,s.jsxs)(s.Fragment,{children:[(0,s.jsx)(t.h1,{id:"tutorial-intro",children:"Tutorial Intro"}),"\n",(0,s.jsxs)(t.p,{children:["Let's discover ",(0,s.jsx)(t.strong,{children:"Docusaurus in less than 5 minutes"}),"."]}),"\n",(0,s.jsx)(t.h2,{id:"getting-started",children:"Getting Started"}),"\n",(0,s.jsxs)(t.p,{children:["Get started by ",(0,s.jsx)(t.strong,{children:"creating a new site"}),"."]}),"\n",(0,s.jsxs)(t.p,{children:["Or ",(0,s.jsx)(t.strong,{children:"try Docusaurus immediately"})," with ",(0,s.jsx)(t.strong,{children:(0,s.jsx)(t.a,{href:"https://docusaurus.new",children:"docusaurus.new"})}),"."]}),"\n",(0,s.jsx)(t.h3,{id:"what-youll-need",children:"What you'll need"}),"\n",(0,s.jsxs)(t.ul,{children:["\n",(0,s.jsxs)(t.li,{children:[(0,s.jsx)(t.a,{href:"https://nodejs.org/en/download/",children:"Node.js"})," version 18.0 or above:","\n",(0,s.jsxs)(t.ul,{children:["\n",(0,s.jsx)(t.li,{children:"When installing Node.js, you are recommended to check all checkboxes related to dependencies."}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,s.jsx)(t.h2,{id:"generate-a-new-site",children:"Generate a new site"}),"\n",(0,s.jsxs)(t.p,{children:["Generate a new Docusaurus site using the ",(0,s.jsx)(t.strong,{children:"classic template"}),"."]}),"\n",(0,s.jsx)(t.p,{children:"The classic template will automatically be added to your project after you run the command:"}),"\n",(0,s.jsx)(t.pre,{children:(0,s.jsx)(t.code,{className:"language-bash",children:"npm init docusaurus@latest my-website classic\n"})}),"\n",(0,s.jsx)(t.p,{children:"You can type this command into Command Prompt, Powershell, Terminal, or any other integrated terminal of your code editor."}),"\n",(0,s.jsx)(t.p,{children:"The command also installs all necessary dependencies you need to run Docusaurus."}),"\n",(0,s.jsx)(t.h2,{id:"start-your-site",children:"Start your site"}),"\n",(0,s.jsx)(t.p,{children:"Run the development server:"}),"\n",(0,s.jsx)(t.pre,{children:(0,s.jsx)(t.code,{className:"language-bash",children:"cd my-website\nnpm run start\n"})}),"\n",(0,s.jsxs)(t.p,{children:["The ",(0,s.jsx)(t.code,{children:"cd"})," command changes the directory you're working with. In order to work with your newly created Docusaurus site, you'll need to navigate the terminal there."]}),"\n",(0,s.jsxs)(t.p,{children:["The ",(0,s.jsx)(t.code,{children:"npm run start"})," command builds your website locally and serves it through a development server, ready for you to view at ",(0,s.jsx)(t.a,{href:"http://localhost:3000/",children:"http://localhost:3000/"}),"."]}),"\n",(0,s.jsxs)(t.p,{children:["Open ",(0,s.jsx)(t.code,{children:"docs/intro.md"})," (this page) and edit some lines: the site ",(0,s.jsx)(t.strong,{children:"reloads automatically"})," and displays your changes."]})]})}function u(e={}){const{wrapper:t}={...(0,r.R)(),...e.components};return t?(0,s.jsx)(t,{...e,children:(0,s.jsx)(c,{...e})}):c(e)}},8453:(e,t,n)=>{n.d(t,{R:()=>i,x:()=>a});var s=n(6540);const r={},o=s.createContext(r);function i(e){const t=s.useContext(o);return s.useMemo((function(){return"function"==typeof e?e(t):{...t,...e}}),[t,e])}function a(e){let t;return t=e.disableParentContext?"function"==typeof e.components?e.components(r):e.components||r:i(e.components),s.createElement(o.Provider,{value:t},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/0e4d8110.a815cf65.js b/assets/js/0e4d8110.a815cf65.js
new file mode 100644
index 0000000000..3cf1cc460d
--- /dev/null
+++ b/assets/js/0e4d8110.a815cf65.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkwebsite=self.webpackChunkwebsite||[]).push([[84733],{61132:(e,t,n)=>{n.d(t,{Z:()=>s});var r=n(24246),o=(n(27378),n(40624));const c={tabItem:"tabItem_pnkT"};function s({children:e,hidden:t,className:n}){return(0,r.jsx)("div",{role:"tabpanel",className:(0,o.Z)(c.tabItem,n),hidden:t,children:e})}},97555:(e,t,n)=>{n.d(t,{Z:()=>E});var r=n(24246),o=n(27378),c=n(40624),s=n(75527),i=n(3620),l=n(44479),a=n(62821),u=n(52196),d=n(53589);function p(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function b(e,t){return t=null!=t?t:{},Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(t)):function(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}(Object(t)).forEach((function(n){Object.defineProperty(e,n,Object.getOwnPropertyDescriptor(t,n))})),e}function f(e){var t,n;return null!==(n=null===(t=o.Children.toArray(e).filter((e=>"\n"!==e)).map((e=>{if(!e||(0,o.isValidElement)(e)&&function(e){const{props:t}=e;return!!t&&"object"==typeof t&&"value"in t}(e))return e;throw new Error(`Docusaurus error: Bad child <${"string"==typeof e.type?e.type:e.type.name}>: all children of the component should be , and every should have a unique "value" prop.`)})))||void 0===t?void 0:t.filter(Boolean))&&void 0!==n?n:[]}function h(e){const{values:t,children:n}=e;return(0,o.useMemo)((()=>{const e=null!=t?t:function(e){return f(e).map((({props:{value:e,label:t,attributes:n,default:r}})=>({value:e,label:t,attributes:n,default:r})))}(n);return function(e){const t=(0,u.l)(e,((e,t)=>e.value===t.value));if(t.length>0)throw new Error(`Docusaurus error: Duplicate values "${t.map((e=>e.value)).join(", ")}" found in . Every value needs to be unique.`)}(e),e}),[t,n])}function g({value:e,tabValues:t}){return t.some((t=>t.value===e))}function j({queryString:e=!1,groupId:t}){const n=(0,i.k6)(),r=function({queryString:e=!1,groupId:t}){if("string"==typeof e)return e;if(!1===e)return null;if(!0===e&&!t)throw new Error('Docusaurus error: The component groupId prop is required if queryString=true, because this value is used as the search param name. You can also provide an explicit value such as queryString="my-search-param".');return null!=t?t:null}({queryString:e,groupId:t}),c=(0,a._X)(r),s=(0,o.useCallback)((e=>{if(!r)return;const t=new URLSearchParams(n.location.search);t.set(r,e),n.replace(b(function(e){for(var t=1;tfunction({defaultValue:e,tabValues:t}){if(0===t.length)throw new Error("Docusaurus error: the component requires at least one children component");if(e){if(!g({value:e,tabValues:t}))throw new Error(`Docusaurus error: The has a defaultValue "${e}" but none of its children has the corresponding value. Available values are: ${t.map((e=>e.value)).join(", ")}. If you intend to show no default tab, use defaultValue={null} instead.`);return e}var n;const r=null!==(n=t.find((e=>e.default)))&&void 0!==n?n:t[0];if(!r)throw new Error("Unexpected error: 0 tabValues");return r.value}({defaultValue:t,tabValues:c}))),[a,u]=j({queryString:n,groupId:r}),[p,b]=function({groupId:e}){const t=function(e){return e?`docusaurus.tab.${e}`:null}(e),[n,r]=(0,d.Nk)(t);return[n,(0,o.useCallback)((e=>{t&&r.set(e)}),[t,r])]}({groupId:r}),f=(()=>{const e=null!=a?a:p;return g({value:e,tabValues:c})?e:null})();(0,l.Z)((()=>{f&&i(f)}),[f]);return{selectedValue:s,selectValue:(0,o.useCallback)((e=>{if(!g({value:e,tabValues:c}))throw new Error(`Can't select invalid tab value=${e}`);i(e),u(e),b(e)}),[u,b,c]),tabValues:c}}var y=n(29088);const O={tabList:"tabList_Qoir",tabItem:"tabItem_AQgk"};function x(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function v(e){for(var t=1;t