Joshua Chen
cc0bceab9c
chore: tighten ESLint config ( #6931 )
...
* chore: tighten ESLint config
* more refactor
* refactor push
* fix
2022-03-17 17:59:41 +08:00
Joshua Chen
8c1e518ba2
chore: do not print prototype in jest snapshot ( #6908 )
2022-03-13 19:34:50 +08:00
Joshua Chen
d85cee576d
test: improve test coverage; properly test core client APIs ( #6905 )
...
* test: improve test coverage
* fix
2022-03-12 23:15:45 +08:00
Joshua Chen
76cb012209
chore: spell-check test files ( #6903 )
2022-03-12 15:24:56 +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
8e934450d8
refactor: remove unnecessary default values normalized during validation ( #6864 )
...
* refactor: remove unnecessary default values normalized during validation
* more
2022-03-07 19:23:30 +08:00
Joshua Chen
4db0c620de
refactor: enable a few TS flags ( #6852 )
...
* refactor: enable a few TS flags
* refactor
* revert to working version
* fix
* better
* change
2022-03-06 13:09:10 +08:00
Joshua Chen
8a24d56783
fix(mdx-loader): allow image paths to be URL encoded ( #6792 )
2022-03-02 12:14:53 +01:00
Joshua Chen
9d7ed31661
fix(mdx-loader): suppress image reading warning in Yarn PnP; log warning instead of error ( #6779 )
2022-02-28 10:49:53 +08:00
Joshua Chen
f903422617
refactor: unify error handling behavior ( #6755 )
...
* refactor: unify error handling behavior
* revert
* normalize paths
* test...
* change
* does this work...
* fix...
* maybe fix
* maybe fix
* fix
* fix...
2022-02-25 15:07:13 +08:00
Joshua Chen
0d14470d54
refactor: unify export directive style ( #6751 )
2022-02-24 17:25:17 +08:00
Joshua Chen
c3370be64d
refactor: make MDX export a flat TOC list instead of tree ( #6729 )
2022-02-23 15:12:04 +01:00
Joshua Chen
c6d0d812eb
refactor: convert all fs methods to async ( #6725 )
...
* refactor: convert all fs methods to async
* fix snap
2022-02-20 10:21:33 +08:00
Joshua Chen
692680d1d1
fix(mdx-loader): make headings containing links properly formatted in ToC ( #6712 )
2022-02-18 10:57:08 +08:00
Joshua Chen
bae9827d92
refactor(utils): replace hash with contenthash for file loader ( #6650 )
2022-02-10 17:43:55 +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
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
37be796aa8
test: rename 'fixtures' to '__fixtures__' ( #6474 )
...
* test: rename 'fixutes' to '__fixtures__'
* test: rename '__test' to '__tests__'
* test: update snapshot
2022-01-27 09:30:09 +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
Anthony McCaigue
ab1dada1aa
fix: allow links to JSON in .md files to be transformed as asset links ( #4827 )
...
* fix: fix links to JSON from .md files
closes #3561
It seems to be a common problem that many people are having see:
https://stackoverflow.com/questions/65307533/link-to-static-json-file
Co-authored-by: Anthony McCaigue <anthony@nquiringminds.com>
Co-authored-by: Alois Klink <alois@nquiringminds.com>
* Add dogfooding examples
* actually fix
* oops
Co-authored-by: Alois Klink <alois@nquiringminds.com>
Co-authored-by: Josh-Cena <sidachen2003@gmail.com>
2022-01-23 11:46:27 +08:00
Joshua Chen
3d7ba337c2
refactor(mdx-loader): use vfile.path to access Markdown file path ( #6443 )
2022-01-22 22:28:50 +08:00
Joshua Chen
e5801e49f6
feat(mdx-loader): read image dimensions when processing Markdown ( #6339 )
2022-01-19 12:45:14 +01:00
Joshua Chen
3cb0972b79
refactor: use findAsyncSequential in a few places ( #6377 )
...
* refactor: use findAsyncSequential in a few places
* fixes
* fix
2022-01-17 08:57:06 +08:00
Joshua Chen
52db7320a6
chore: enable eslint-plugin-jest ( #6375 )
2022-01-16 15:53:23 +08:00
Nick Schonning
02a233a221
chore: minor typo cleanup ( #6324 )
...
* chore: minor typo cleanup
* fix tests
Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
2022-01-13 14:36:53 +08:00
Joshua Chen
217b62682d
feat(mdx-loader): preserve hash in image src; support GH themed images ( #6323 )
...
* feat(mdx-loader): preserve hash in image src; support GH themed images
* more refactor
2022-01-13 10:22:48 +08: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
f02fefb5b7
fix(utils): properly escape Windows paths ( #6190 )
...
* fix(utils): properly escape Windows paths
* Use in more places
* Escape path in test
* Fix snapshot
* Better comment
* Fix tests
2021-12-25 15:24:21 +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
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
Sébastien Lorber
cfae5d0933
feat(content-docs): sidebar category linking to document or auto-generated index page ( #5830 )
...
Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
Co-authored-by: Armano <armano2@users.noreply.github.com>
Co-authored-by: Alexey Pyltsyn <lex61rus@gmail.com>
2021-12-03 14:44:59 +01:00
Oliver Ullman
1366c31201
feat(core): allow sourcing from multiple static directories ( #4095 )
...
* [WIP] Implementaion of multiple directory static sourcing
* Move default to validation
* Update test
* Refactor
* Port to MDX loader
* Fix
* Move dogfooding assets
* Doc writeup
* Restore assets
* Support absolute paths
* Dogfood absolute path
* Fix
* More tests
* Fix snapshots
Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
2021-11-18 22:26:26 +08:00
Joshua Chen
c5feac6ba2
refactor: move deps declarations into src ( #5946 )
2021-11-14 13:35:15 +08:00
Joshua Chen
d1308a8736
refactor: improve setup of type declaration files ( #5914 )
2021-11-12 17:47:27 +01:00
Joshua Chen
68c970175a
refactor: migrate lqip-loader to TS, fix typing for Webpack Loaders ( #5779 )
2021-10-27 16:38:11 +02:00
Alexey Pyltsyn
67403b3b65
fix: preserve hash in asset link ( #5690 )
2021-10-12 16:49:01 +02:00
Bharat Middha
09550b0535
feat: properly type-check the Docusaurus config of new sites ( #5589 )
...
* fix: makes types DocusaurusConfig optional to match docs
* add UserDocusaurusConfig with required keys for user config
* convert UserDocusaurusConfig to use util type
* Docusaurus website config should be type-checked by CI + fix all existing issues
* add doc for config typechecking
* Update template configs for TS autocompletion
* fix last config typechecking bugs
* reapply prettier
* reapply prettier-docs
* Fix TS doc: add missing ()
* fix some docu plugin types
* add "const config" for simpler jsdoc annotation
Co-authored-by: slorber <lorber.sebastien@gmail.com>
2021-09-30 17:49:44 +02:00
Joshua Chen
3f1f8255a2
chore: upgrade Prettier + regenerate lock file ( #5611 )
...
* Bump deps
* Run prettier
* Format docs
* Minor refactor
* Collapse objects
* Fix type
* Update lock file
2021-09-30 12:54:17 +02: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
Joshua Chen
2ef70cb806
refactor(preset-classic): migrate preset-classic to TypeScript ( #5579 )
2021-09-22 11:09:52 +02:00
Joshua Chen
a839966cd2
polish: remove unused eslint-disable ( #5560 )
...
* fix eslint
* Add report unused disable to CI
* Fix two anys
2021-09-21 18:07:54 +02:00
Joshua Chen
df3752cc71
fix: fix a few TS errors ( #5437 )
...
* fix errors
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Fix website
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Revert adding lib
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Fix tsconfig
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Restore previous ordering
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* exclude sw.js from typechecking
* Tests: include typechecking of website
* cleanup @site/ alias in TS config
Co-authored-by: slorber <lorber.sebastien@gmail.com>
2021-08-30 13:06:00 +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
Joshua Chen
3fc47938a5
chore(mdx-loader): migrate package to TypeScript ( #5347 )
...
* Polish code style
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Partly done migration
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Complete typing
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Fix tests
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* A-ha
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Cleanup
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Fix error
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
* Cleanup
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
2021-08-12 14:55:14 +02:00
Sébastien Lorber
cabb768473
feat: blog posts support /YYYY/MM/DD/blog-post/index.md pattern + blog frontmatter can reference relative images ( #5309 )
...
* POC of blog post folder
* add parseBlogFileName with tests + refactor and extract processBlogSourceFile in separate method
* improve blog date pattern doc + link from content plugin guides to API ref docs
* Some FrontMatter fields should be able to reference relative image assets, converted to Webpack require calls and exposed as frontMatterAssets
* remove log
2021-08-06 17:51:59 +02:00
Sébastien Lorber
916b82119b
feat: mdx loader fallback, allow importing mdx docs from anywhere ( #5299 )
...
* move deep filepath test
* split markdownPageExample.md
* re-org dogfooding content
* Add mdx partials fallback synthetic plugin by default
* test commit
* hide changelog title as it's already included in the partial file
* trigger CI
* fix changelog sidebar label
2021-08-06 11:32:22 +02:00
Sébastien Lorber
4d06f26c1f
fix(v2): Fix MDX docs being considered as partials when siteDir match the _ prefix convention ( #5199 )
...
* Add _ to dogfood docs folder to cover against edge case
* Fix edge case with MDX partials when site / content dir contains a _ prefix
* add globUtils tests
* proper dogfooding folder re-organization, all content plugins being used
* refactor dogfooding folder + expose /tests page index
* fix page plugin ignoring options.routeBasePath
2021-07-21 14:13:51 +02:00
Sébastien Lorber
8bdb3da233
feat(v2): generalize usage of _ prefix convention to exclude content files/folders ( #5173 )
...
* create a swizzleWarning partial for shared text
* Generalize usage of _ prefix convention to exclude content files/folders
* add api doc
* MDX loader should not expect metadata/frontmatter on MDX partial files
2021-07-15 13:21:41 +02:00
