Commit graph

2682 commits

Author SHA1 Message Date
Sébastien Lorber
a6f53aa9d2
refactor(theme-classic): bias again search metadata toward Algolia DocSearch (#6707) 2022-02-17 14:24:31 +01:00
Alexey Pyltsyn
089ef14c9a
fix(theme-common): do not run useLocationChange when hot reloading (#6696) 2022-02-17 08:41:15 +08:00
Alexey Pyltsyn
53c2c118c4
feat(search-algolia): allow disabling search page and configuring path (#6692) 2022-02-16 19:07:01 +01:00
Jody Heavener
3629b5ab39
feat(docs,theme-classic): docs breadcrumbs (#6517)
Co-authored-by: sebastienlorber <lorber.sebastien@gmail.com>
2022-02-16 19:02:58 +01:00
Joshua Chen
67918e35e2
refactor: convert CLI entry points to ESM; migrate create-docusaurus to ESM (#6661)
* refactor: convert CLI entry points to ESM

* fix

* fix

* fix

* fix!

* create-docusaurus ESM

* fix lock

* final touchups

* fix lodash

* fix

* use lodash

* fix hasYarn
2022-02-16 23:00:35 +08:00
Joshua Chen
eacc695542
fix(pwa): declare babel core as direct dependency (#6691) 2022-02-16 18:47:40 +08:00
Joshua Chen
80a9806775
fix(theme-classic): improve aria label of color mode toggle (#6674)
* fix(theme-classic): improve aria label of color mode toggle

* oops
2022-02-16 10:38:09 +08:00
Erick Zhao
0c6165b161
fix(utils): make SVGO not remove title (#6684)
* chore(utils): add `removeTitle: false` to svg loader

By default, SVGR removes the `<title>` tag from SVG inputs.
This hinders a11y since "the `<title>` element provides an
accessible, short-text description of any SVG container
element or graphics element".

Modern browsers also show tooltips on hover for inline
SVG with the `<title>` tag.

See https://developer.mozilla.org/en-US/docs/Web/SVG/Element/title

* fix test
2022-02-15 17:14:54 +08:00
Joshua Chen
b89d93fab5
refactor: recommend using data-theme without html element selector (#6668)
* refactor: recommend using data-theme without html element selector

* simplify site CSS

* refactor
2022-02-14 10:23:42 +08:00
Joshua Chen
0c7e592d34
chore: upgrade dependencies (#6660)
* chore: upgrade dependencies

* fix types
2022-02-12 15:29:40 +08:00
Joshua Chen
acf4ae8f96
refactor: reduce exported members of docusaurus router (#6651) 2022-02-11 12:16:13 +01:00
Alexey Pyltsyn
cfef4755da
refactor(theme-classic): clean up CSS of doc sidebar item (#6622)
* refactor(theme-classic): clean up doc sidebar item CSS

* Use link placeholder for Introduction category

* Use test pages for dogfooding

* Update sidebars.js

* Add another test case
2022-02-11 13:11:47 +08:00
Joshua Chen
da9075105a
refactor(module-aliases): remove react-helmet dependency (#6658) 2022-02-11 13:08:08 +08:00
Konstantin Tarkus
916e4f1a26
fix(core): forward ref to Link's anchor element (#6644)
* feat(core): allow to pass ref into the Link component

* refactor

* add dogfood

Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
2022-02-11 12:34:13 +08:00
Clement Demonchy
1cd4757828
feat: allow numbers in plugin ID (#6656)
* fix example for id that didn't respect regex

example for id don't work with version 2.0.0-beta.15:
ValidationError: "id" with value "docs1" fails to match the required pattern: /^[a-zA-Z_-]+$/
Error: Process completed with exit code 1.

* properly fix

Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
2022-02-11 11:57:58 +08:00
Alexey Pyltsyn
10a5f71154
fix(theme-classic): minor BTT button fixes (#6652) 2022-02-10 15:35:34 +01:00
Joshua Chen
bae9827d92
refactor(utils): replace hash with contenthash for file loader (#6650) 2022-02-10 17:43:55 +08:00
Joshua Chen
fbbec7fef8
fix(cli): make docusaurus clear also remove .yarn/.cache folder (#6646)
* fix(cli): make clear also remove .yarn/.cache folder

* refactor
2022-02-10 12:54:32 +08:00
Joshua Chen
b16b394eb6
feat(create): allow specifying a git clone strategy (#6610)
* feat(create): allow specifying a git clone strategy

* Update index.ts
2022-02-10 11:15:06 +08:00
Felipe Santos
6996ed2f2f
feat(content-blog): infer blog post date from git history (#6593) 2022-02-09 17:18:32 +01:00
TheCatLady
665d164351
feat(content-docs): add custom props front matter (#6619)
Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
2022-02-09 17:04:07 +01:00
toto6038
59289ed4d5
refactor(theme-translation): Improve Traditional Chinese translation quality (#6635) 2022-02-08 16:29:59 +08:00
Joshua Chen
5db848f0e7
refactor: move module declarations for non-route components to theme-classic (#6629) 2022-02-07 20:17:41 +08:00
Daniel Hanke
5e2196441e
docs: fix presets documentation link (#6627) 2022-02-07 16:30:39 +08:00
Joshua Chen
74a645e612
fix(utils): convert Markdown links in reference-style links (#6617) 2022-02-05 19:37:20 +08:00
Joshua Chen
d2574b287f
fix: remove more peer dependency warnings (#6615)
* fix: remove more peer dependency warnings

* fixes

* fixes

* fix

* remove more
2022-02-05 17:46:01 +08:00
Joshua Chen
919f1600c2
refactor: remove Babel plugins that are included in preset-env (#6614) 2022-02-05 16:55:40 +08:00
Joshua Chen
93c5ad8742
fix(theme-classic): make Prism additional languages properly server-side rendered (#6612) 2022-02-05 16:03:29 +08:00
Joshua Chen
10c292cb05
refactor(migrate): change internal methods' parameter style (#6609) 2022-02-05 13:14:53 +08:00
Joshua Chen
ed34a92957
fix(cli): log error itself on unhandled rejection (#6607) 2022-02-04 23:33:34 +08:00
John Reilly
a9eb005333
feat: make Markdown images lazy loaded (#6598)
* feat: lazy loading images

* feat: use real images
2022-02-04 22:04:53 +08:00
Joshua Chen
45f6f8b869
chore: fix ESLint warnings, restrict export all syntax (#6605)
* chore: fix ESLint warnings, forbid export all syntax

* fix...

* reorder
2022-02-04 21:57:10 +08:00
Joshua Chen
3fd99ad8d4
feat(content-blog): allow customizing blog archive component through option (#6603)
* feat(content-blog): allow customizing blog archive component through option

* fix
2022-02-04 18:56:09 +08:00
Joshua Chen
0c4dc00443
feat(content-docs): allow omitting enclosing array consistently for category shorthand (#6602)
* feat(content-docs): allow omitting enclosing array consistently for category shorthand

* update snapshot

* fix doc
2022-02-04 11:16:08 +08:00
Joshua Chen
e3fd3e74ce
refactor(content-docs): clean up sidebars logic; validate generator returns (#6596)
* refactor(content-docs): clean up sidebars logic; validate generator returns

* remove another TODO

* fix types

* refactors

* refactor...
2022-02-04 09:46:25 +08:00
Mikey O'Toole
d6bdf7e804
fix(theme-classic): add docSidebar as allowed item in dropdown (#6599)
* Add ThemeClassName to Docs Sidebar container.

* Fix issue #6597 - Missing docSidebar in theme config validation.

* revert comment change

Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
2022-02-04 09:38:09 +08:00
Muhammad Redho Ayassa
48f080ebca
feat(content-blog): Allow pagination for BlogTagsPostsPage (#6221)
Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
Co-authored-by: sebastienlorber <lorber.sebastien@gmail.com>
2022-02-03 18:33:13 +01:00
Joshua Chen
01c6f15b15
fix(theme-classic): make focused link outlined with JS disabled (#6505) 2022-02-03 18:28:10 +01:00
Joshua Chen
1ca07f8466
refactor(content-docs): read category metadata files before autogenerating (#6586)
* refactor(content-docs): read category metadata files before autogenerating

* fix tests

* fix Windows...

* warn user when behavior is undetermined

* oops

* fix typo
2022-02-03 16:16:19 +08:00
Felipe Santos
b03431f139
fix: read last update from inner git repositories (#6592) 2022-02-03 16:02:28 +08:00
Jody Heavener
6ec0db4722
feat(content-docs): sidebar item type "html" for rendering pure markup (#6519)
Co-authored-by: sebastienlorber <lorber.sebastien@gmail.com>
2022-02-02 18:38:35 +01:00
Miles Johnson
65ba551f5b
fix(content-docs): export versioning utils (#6477) 2022-02-02 17:21:54 +01:00
Joshua Chen
3573b5e4a9
fix(content-docs): render category with no subitems as a normal link (#6495) 2022-02-02 14:45:00 +01:00
Joshua Chen
759952cefd
misc: enable jsx-key eslint rule (#6584) 2022-02-02 19:22:26 +08:00
Joshua Chen
250d9c8cf5
refactor(live-codeblock): migrate theme to TS (#6583)
* refactor(live-codeblock): migrate theme to TS

* Don't make it visible
2022-02-02 17:48:06 +08:00
seyoon20087
a615ab3999
feat(core): use react-helmet-async (#6306)
* Use React Strict Mode

Even though Strict Mode is not required a WARNING icon now displays
on all components that do not use React.StrictMode on React DevTools extension.

Signed-off-by: Shinwon Elizabeth Yoon <24852454+seyoon20087@users.noreply.github.com>

* Utilize react-helmet-async instead of react-helmet

react-helmet is NOT thread safe, as explained in https://open.nytimes.com/the-future-of-meta-tag-management-for-modern-react-development-ec26a7dc9183#fdc2

Therefore, it's better if react-helmet-async is utilized instead of react-helmet.

Even though react-helmet-async is being utilized, most users will not require any code changes to @docusaurus/Head since it uses the same API as react-helmet.

Signed-off-by: Shinwon Elizabeth Yoon <24852454+seyoon20087@users.noreply.github.com>

* Include HelmetProvider inside client entry

I forgot to do this before.

Signed-off-by: Shinwon Elizabeth Yoon <24852454+seyoon20087@users.noreply.github.com>

* format

* fix TS

* address reviews

* Remove forked react-loadable package in favor of @react-loadable/revised

Both unforked react-loadable and @docusaurus/react-loadable uses legacy React APIs.

However, @react-loadable/revised (https://github.com/react-loadable/revised) is actively maintained and widely used in production, thus replaced with this package.

Signed-off-by: Shinwon Elizabeth Yoon <24852454+seyoon20087@users.noreply.github.com>

* remove unused comma

* Address reviews from https://github.com/facebook/docusaurus/pull/6306#pullrequestreview-864745191

Signed-off-by: Shinwon Elizabeth Yoon <24852454+seyoon20087@users.noreply.github.com>

Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
2022-02-02 14:52:44 +08:00
Joshua Chen
661bc32402
chore(deps): bump all dependencies; regenerate lockfile (#6580) 2022-02-02 13:00:31 +08:00
Alexey Pyltsyn
72bad11e97
fix(theme-classic): highlight active collapsible doc category properly (#6531) 2022-02-01 21:18:21 +08:00
Joshua Chen
1cefb643dd
refactor: enforce named capture groups; clean up regexes (#6524)
* refactor: enforce named capture groups; clean up regexes

* fixes

* fix
2022-02-01 17:43:15 +08:00
Joshua Chen
c56e6194b4
refactor: mark all functions that import external modules as async (#6521) 2022-01-31 13:04:45 +08:00