Sébastien Lorber
09ea3bcfab
feat(client-redirects-plugin): support fully qualified urls and querystring/hash in destination/to url ( #9171 )
2023-07-21 19:54:40 +02:00
Sébastien Lorber
bf913aea2a
feat: upgrade to MDX v2 ( #8288 )
...
Co-authored-by: Armano <armano2@users.noreply.github.com>
2023-04-21 19:48:57 +02:00
Dongjoon Lee
e553ce7e59
fix(docusaurus-utils-validation): baseUrl + routeBasePath: allow empty string, normalized as "/" ( #8258 )
...
Co-authored-by: sebastienlorber <lorber.sebastien@gmail.com>
fix https://github.com/facebook/docusaurus/issues/8254
2022-12-08 16:54:32 +01:00
Jody Heavener
683ba3d2a0
feat(docs,blog,pages): add support for "unlisted" front matter - hide md content in production ( #8004 )
...
Co-authored-by: sebastienlorber <lorber.sebastien@gmail.com>
2022-11-03 14:31:41 +01:00
Joshua Chen
bcae7503ff
fix(core): normalize slashes for url/baseUrl instead of throwing ( #8066 )
2022-09-08 17:18:26 +02:00
Joshua Chen
275f509d13
chore: upgrade dependencies ( #7993 )
...
* chore: upgrade dependencies
* Fix lint
* Bump more
* Fix lint
2022-09-08 01:31:53 -04:00
Sébastien Lorber
6f63ffe0a3
refactor(theme): split admonitions, make swizzle easier, better retrocompatibility ( #7945 )
...
Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
2022-09-07 17:49:44 +02:00
Alexey Pyltsyn
5746c58f41
refactor: handle all admonitions via JSX component ( #7152 )
...
Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
Co-authored-by: sebastienlorber <lorber.sebastien@gmail.com>
2022-06-03 14:26:33 +02:00
Joshua Chen
cd21a31005
test: strengthen internal types ( #7488 )
2022-05-25 15:38:44 +08:00
Joshua Chen
bf1513a3e3
refactor: fix a lot of errors in type-aware linting ( #7477 )
2022-05-24 15:40:26 +08:00
Joshua Chen
89b0fff128
refactor: reduce number of leaked anys ( #7465 )
2022-05-23 00:30:32 +08:00
Joshua Chen
0838884f67
chore: enable import/order rule ( #7418 )
2022-05-14 23:39:50 +08:00
Joshua Chen
b49ae67521
refactor(types): move non-core, non-public types out of the types package ( #7293 )
2022-05-03 17:15:48 +08:00
Joshua Chen
9145ae88cc
chore: disable string escaping in snapshots ( #7131 )
2022-04-08 11:23:19 +08:00
Joshua Chen
1156be3f20
refactor(content-{blog,docs}): unify handling of tags ( #7117 )
2022-04-07 15:58:21 +02:00
Joshua Chen
24c205a835
refactor: replace non-prop interface with type; allow plugin lifecycles to have sync type ( #7080 )
...
* refactor: replace non-prop interface with type; allow plugin lifecycles to have sync type
* fix
2022-03-31 19:16:07 +08:00
Joshua Chen
f1bcdbff63
fix(validation): improve error messages for a few schemas ( #6997 )
...
* fix(validation): improve error messages for a few schemas
* kick CI
* fix test
2022-03-25 21:50:37 +08:00
Joshua Chen
87592bca03
refactor: ensure all types are using index signature instead of Record ( #6995 )
...
* refactor: ensure all types are using index signature instead of Record
* kick CI
2022-03-25 18:06:30 +08:00
Joshua Chen
2eeb0e46a2
feat(utils): JSDoc for all APIs ( #6980 )
...
* feat(utils): JSDoc for all APIs
* fix tests
2022-03-24 21:34:31 +08:00
Alois Klink
4d2ab826b8
fix(validation): allow non-object params to remark/rehype plugins ( #6977 )
...
Remark and Rehype plugins allow having options as a non-object type,
such as a string.
For instance, the official MDX docs even have an example of this:
See https://mdxjs.com/docs/extending-mdx/#using-plugins
The official plugin `remarkjs/remark-frontmatter` allows passing
a string, e.g. `"toml"` as the options arg, instead of an object.
2022-03-24 09:19:06 +08:00
Joshua Chen
6e2eb44964
refactor: unify how validateOptions is handled ( #6961 )
...
* refactor: unify how validateOptions is handled
* fix types
* fix again
2022-03-22 19:40:56 +08:00
Joshua Chen
ad88f5cc87
test: improve test coverage; multiple internal refactors ( #6912 )
2022-03-14 21:53:57 +08:00
Joshua Chen
3a4b9b4c30
refactor: install eslint-plugin-regexp ( #6906 )
...
* refactor: install eslint-plugin-regexp
* simplify
* simplify
* fix
2022-03-13 18:32:17 +08:00
Joshua Chen
aa5a2d4c04
test: enable a few jest eslint rules ( #6900 )
...
* test: enable a few jest eslint rules
* more
2022-03-12 08:43:09 +08:00
Joshua Chen
c9ee6e467c
refactor: import jest as global; unify import style of some modules ( #6898 )
...
* refactor: import jest as global
* fix react
2022-03-11 19:04:27 +08:00
Joshua Chen
a4dc03edee
chore: upgrade dependencies ( #6789 )
...
* chore: upgrade dependencies
* upgrade setup-node
2022-03-01 10:40:34 +08:00
Joshua Chen
9562a5d203
refactor: remove deprecated Webpack utils & validation escape hatch ( #6740 )
2022-02-23 11:40:58 +01: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
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
aa446b7a9c
chore: clean up ESLint config, enable a few rules ( #6514 )
...
* chore: clean up ESLint config, enable a few rules
* enable max-len for comments
* fix build
2022-01-31 10:31:24 +08:00
Nick Schonning
521eb119a7
chore: add cSpell for spell checking ( #6456 )
...
* chore: Add cSpell for spell checking
* chore: exclude map files and remove dups
* chore: exclude more binary files
* chore: remove MD headings
* Update .cspell.json
* fix a few spellings
* fix more
* fix
Signed-off-by: Joshua Chen <sidachen2003@gmail.com>
* fix a few
* oops
Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
2022-01-25 09:40:02 +08:00
Sébastien Lorber
4004f5b68b
chore: regenerate yarn.lock ( #6341 )
...
Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
2022-01-14 15:52:12 +01:00
Joshua Chen
a79c23bc45
test(utils, mdx-loader, core): improve coverage ( #6303 )
...
* test(utils, mdx-loader, core): improve coverage
* windows...
* fix
2022-01-10 15:00:51 +08:00
Joshua Chen
cb1aa30286
refactor: enforce type import specifiers ( #6230 )
...
* refactor: enforce type import specifiers
* fix
* Upgrade esbuild
* Fix (haha)
2021-12-31 21:17:09 +08:00
Joshua Chen
770418f8d2
refactor: unify log format with new logger utility ( #5994 )
...
Co-authored-by: sebastienlorber <lorber.sebastien@gmail.com>
2021-12-20 17:24:59 +01:00
Joshua Chen
fd966b5395
refactor: add blank lines below all copyright headers ( #6071 )
2021-12-09 11:53:46 +08:00
Joshua Chen
e07ebadf6c
fix: make Docusaurus PnP strict mode compatible ( #6047 )
...
Co-authored-by: Kristoffer K. <merceyz@users.noreply.github.com>
2021-12-08 14:26:24 +01:00
Erick Zhao
c86dfbda61
feat(v2): allow specifying TOC max depth (themeConfig + frontMatter) ( #5578 )
...
* feat: add all TOC levels to MDX loader
* feat: add theme-level config for heading depth
* test: add remark MDX loader test
* fix: limit maxDepth validation to H2 - H6
* refactor: set default `maxDepth` using `joi`
* refactor: `maxDepth` -> `maxHeadingLevel
* refactor: invert underlying TOC depth API
* refactor: make TOC algorithm level-aware
* feat: add support for per-doc TOC heading levels
* feat: support document-level heading levels for blog
* fix: correct validation for toc level frontmatter
* fix: ensure TOC doesn't generate redundant DOM
* perf: simpler TOC heading search alg
* docs: document heading level props for `TOCInline`
* Update website/docs/guides/markdown-features/markdown-features-inline-toc.mdx
Co-authored-by: HonkingGoose <34918129+HonkingGoose@users.noreply.github.com>
* docs: fix docs (again)
* create dedicated test file for heading searching logic: exhaustive tests will be simpler to write
* toc search: add real-world test
* fix test
* add dogfooding tests for toc min/max
* add test for min/max toc frontmatter
* reverse min/max order
* add theme minHeadingLevel + tests
* simpler TOC rendering logic
* simplify TOC implementation (temp, WIP)
* reverse unnatural order for minHeadingLevel/maxHeadingLevel
* add TOC dogfooding tests to all content plugins
* expose toc min/max heading level frontmatter to all 3 content plugins
* refactor blogLayout: accept toc ReactElement directly
* move toc utils to theme-common
* add tests for filterTOC
* create new generic TOCItems component
* useless css file copied
* fix toc highlighting className conflicts
* update doc
* fix types
Co-authored-by: HonkingGoose <34918129+HonkingGoose@users.noreply.github.com>
Co-authored-by: slorber <lorber.sebastien@gmail.com>
2021-09-29 11:19:11 +02:00
swyx
194f429c1f
fix: add docs tag validation to solve #5478 ( #5479 )
...
* fix: add docs tag validation to solve #5478
fix: add docs tag validation to solve #5478
* Update docFrontMatter.ts
* Update docs-create-doc.mdx
* improve tag validation error messages + tests
* improve tags doc
* fix test
Co-authored-by: slorber <lorber.sebastien@gmail.com>
2021-09-03 14:43:24 +02:00
Joshua Chen
493225a3c6
feat(plugin-blog): multi-authors support + authors.yml global configuration ( #5396 )
...
* Complete function
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* A lot of blank lines
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* More lenient validation
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Remove or
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Simpler logic
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Expand docs
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Better docs
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Dogfood
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* More writeup
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Polish
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Polish
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Move mergeAuthorMap to authors.ts
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Unbreak relative assets
* Update docs
* Clarify in docs
* simplify feed authors
* rename authorMap -> authorsMap
* mergeAuthorsMap -> getBlogPostAuthors
* website => 5 blog posts per page
* improve authors map file
* Extract new theme authors components + display in row
* add comment for meta array syntaxes
* blog => getPathsToWatch should watch authorsMap file
* remove useless v1 blog FBID frontmatter
* keep older frontmatter syntax for now
* revert blog frontmatter
* Better console message
* better blog authors frontmatter impl
* add multi authors to beta blog post + fix some authors margins
* fix React key
* Refactor: mdx loader should support a more flexible assets system (poc, not documented yet)
* better display of blog post authors: adapt layout to authors count + add line clamp
* smaller local image
* fix blog feed tests
* fix blog frontmatter tests + improve validation schema
* add more frontmatter tests
* add tests for getAuthorsMapFilePath
* tests for validateAuthorsMapFile
* add tests for readAuthorsMapFile
* test getAuthorsMap
* exhaustive tests for getBlogPostAuthors
* fix remaining tests
* missing blog plugin author tests
* fix windows tests
* improve blog multi-author's doc
* Use new format in init template
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Improve error message
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* update feed snapshot
* blog authors: limit to 2 cols + fix margins for no authors
* minor doc improvements
* better init template blog posts, demonstrating Blog features
* replace the legacy blog author frontmatter in remaining places
* Prefer using clsx
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* cleanup getColClassName
* remove blog author name/title line-clamping
Co-authored-by: slorber <lorber.sebastien@gmail.com>
2021-08-26 12:21:58 +02:00
Isaac Philip
f9c79cbd58
feat: doc tags (same as blog tags) ( #3646 )
...
* [v2] tags to doc, same as tags to blog - [IN PROGRESS]
- Addition of plugin-content-docs
- Addition of DocTagsListPage in `docusaurus-theme-classic`
! Error exists for this commit towards the theme aspect and help required.
Commit towards #3434
* docs: make tags list page work
* temp: disable onBrokenLinks
* theme bootstrap: create DocTagsListPage
* DocTagsPage added and functionality too
- individual doc tag page added to show docs for that specific tag
* Added all Docs Tags Link
* add some shared tag utils
* move tag tests to _dogfooding
* fix type
* fix some tests
* fix blog test
* refactor blog post tags handling
* better yaml tag examples
* better dogfood md files
* refactor and factorize theme tag components
* finish DocTagDocListPage
* Extract DocItemFooter + add inline tag list
* minor fix
* better typings
* fix versions.test.ts tests
* add tests for doc tags
* fix tests
* test toTagDocListProp
* move shared theme code to tagUtils
* Add new theme translation keys
* move common theme code to tagUtils + add tests
* update-code-translations should handle theme-common
* update french translation
* revert add translation
* fix pluralization problem in theme.docs.tagDocListPageTitle
* add theme component configuration options
* add more tags tests
* add documentation for docs tagging
Co-authored-by: slorber <lorber.sebastien@gmail.com>
2021-08-19 10:31:15 +02:00
Joshua Chen
462b1cf2bc
style(v2): reduce number of ESLint warnings ( #4993 )
...
* Initial work
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* More fixes
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Update packages/docusaurus-theme-classic/src/theme/ThemedImage/index.tsx
Co-authored-by: Sébastien Lorber <slorber@users.noreply.github.com>
* Update packages/docusaurus-theme-bootstrap/src/theme/ThemedImage/index.tsx
Co-authored-by: Sébastien Lorber <slorber@users.noreply.github.com>
* Fix
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Replace versionPathPart with function
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Prefer non-null assertions
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Substitute for-of with forEach
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Fill `catch` block with placeholder comment
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Ignore local require
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Revert global require change
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Tighten eslint disable range
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Make eslint ignore examples and more tolerating to templates
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Use reduce to handle doc items sequentially
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Revert "Use reduce to handle doc items sequentially"
This reverts commit c7525d463b
2021-06-24 18:12:48 +02:00
Sébastien Lorber
f20599bb54
fix(v2): less strict blog/docs uri frontmatter validation ( #5032 )
2021-06-22 10:42:06 +02:00
Alexey Pyltsyn
41d9288e3d
refactor(v2): cleanup console output ( #4979 )
...
* refactor(v2): cleanup console output
* fix jest issue
Co-authored-by: slorber <lorber.sebastien@gmail.com>
2021-06-16 11:37:28 +02:00
Sébastien Lorber
9fe79caadc
polish(v2): url-subpath config validation warning ( #4977 )
2021-06-15 18:18:12 +02:00
Sébastien Lorber
aeb8e9da51
fix(v2): sitemap plugin should handle siteConfig.trailingSlash automatically ( #4950 )
...
* create new @docusaurus/utils-common and move applyTrailingSlash there
* sitemap plugin should handle siteConfig.trailingSlash automatically
* typo
2021-06-14 20:04:39 +02:00
Nam Hoang Le
e092910627
fix(v2): improve BlogPostFrontMatter schema validation ( #4759 )
...
* fix(v2): improve BlogPostFrontMatter schema validation
* Edit doc
* Add deprecate warning message
* minor changes, disable warnings temporarily
* only disable warnings + fix frontmatter date type
Co-authored-by: Nam Hoang Le <nam.hoang.le@mgm-tp.com>
Co-authored-by: slorber <lorber.sebastien@gmail.com>
2021-05-14 18:52:51 +02:00
John Reilly
e11597aba9
fix(v2): fix too strict markdown frontmatter validation ( #4654 )
...
* start work
* use orta.vscode-jest
* node 14
* add some better infra to validate markdown frontmatter
* better docs frontmatter validation
* fix Yaml / Joi validation issues
* fix Yaml / Joi validation issues
Co-authored-by: slorber <lorber.sebastien@gmail.com>
2021-04-21 16:19:55 +02:00
Sébastien Lorber
962c3748ea
chore(v2): Joi cyclic dep warning ( #4464 )
2021-03-18 20:19:09 +01:00
Sébastien Lorber
60d189a91c
fix(v2): Export Joi from validation-utils package ( #4459 )
2021-03-18 19:27:51 +01:00
