3pp-mirror/docusaurus
1
0
Fork 0
mirror of https://github.com/facebook/docusaurus.git synced 2025-05-09 23:27:28 +02:00
Code Issues Projects Releases Packages Wiki Activity
5580 commits 47 branches 176 tags 897 MiB
Commit graph

80 commits

Author SHA1 Message Date
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
Sébastien Lorber
c3ff131110
refactor(theme): split BlogPostItem into smaller theme subcomponents (#7716) 2022-07-08 13:28:53 +02: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
0838884f67
chore: enable import/order rule (#7418) 2022-05-14 23:39:50 +08:00
Joshua Chen
a2c993bf9a
fix(*): make TypeScript realize that each plugin package has a default export (#7294) 2022-05-03 18:23:34 +08:00
Joshua Chen
7941a46be3
feat: allow setting calendar for i18n date formatting (#6430) 
* feat: allow setting calendar for i18n date formatting

* fix TS

* add test
 2022-04-08 22:34:34 +08:00
Joshua Chen
1156be3f20
refactor(content-{blog,docs}): unify handling of tags (#7117) 2022-04-07 15:58:21 +02: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
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
Felipe Santos
e19a4e23e7
fix(content-docs): warn when files are not tracked (#6937) 
* fix(docs): warn when files are not tracked

* chore(devcontainer): use non-root user

* test: fix jest in vscode

* test(docs): improve existing test

* chore(devcontainer): fix jest error on startup

* chore: fix comments

* chore: remove "probably" from error message
 2022-03-21 08:42:36 +08:00
Joshua Chen
8d1c1954c1
refactor(content-blog): clean up type definitions; in-code documentation (#6922) 
* refactor(content-blog): clean up type definitions; in-code documentation

* add doc
 2022-03-16 19:36:57 +08:00
WonChul Heo
46b1027c4a
fix(content-blog): remove double leading slash in blog-only paginated view (#6918) 
* fix(content-blog): Fix permalink function of paginateBlogPosts

* add test

Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
 2022-03-15 16:45:05 +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
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
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
ea6ceaa371
refactor: ensure lodash is default-imported (#6716) 2022-02-19 18:15:02 +08:00
Felipe Santos
6996ed2f2f
feat(content-blog): infer blog post date from git history (#6593) 2022-02-09 17:18:32 +01: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
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
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
Joshua Chen
d133910cb2
feat(content-blog): parse date from middle of file path (#6245) 2022-01-20 16:43:00 +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
cf265c051e
refactor: move exported type definitions to declaration file (#6300) 
* refactor: move exported type definitions to declaration file

* fix

* fix
 2022-01-09 22:02:31 +08:00
Joshua Chen
9f0809ae28
fix(content-blog): always convert front matter date as UTC (#6244) 2022-01-02 12:47:23 +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
24d65d9bdd
refactor(utils): reorganize functions; move authors file resolution to utils (#6229) 
* refactor(utils): reorganize functions; move authors file resolution to utils

* More refactor
 2021-12-31 11:55:42 +08:00
Joshua Chen
2cc89e502f
feat(content-blog): include front matter in loaded content metadata (#6189) 
* feat(content-blog): include front matter in metadata

* fixes
 2021-12-26 11:24:24 +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
8644097ab7
fix(content-blog): make post ID unique (#6061) 
* fix(content-blog): make post ID unique

* Fixes
 2021-12-08 09:28:17 +08:00
Joshua Chen
0374426ce3
chore: upgrade TypeScript & other ESLint related deps (#5963) 
* chore: upgrade ESLint related deps

* Upgrade TS

* Fix lock

* Bump Babel

* Update config
 2021-11-18 21:15:37 +08:00
Devtato
1c024470e0
feat(content-blog): allow sorting posts in ascending order (#5787) 2021-11-09 18:25:43 +01:00
Joshua Chen
7a6607cfa1
refactor: remove a few Lodash usages & ESLint enforcement (#5807) 
* refactor: remove some lodash usage

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>

* Enforce ESLint

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>

* More forbids

* Fixup

* Fix

* Fix website
 2021-10-28 12:48:58 +08:00
Joshua Chen
9ad6de2b85
feat(content-blog): new readingTime plugin option (#5702) 2021-10-21 15:26:10 +02:00
Sébastien Lorber
29d13351a4
fix(content-blog): temporarily swallow feed mdxToHtml errors + feed refactor (#5753) 2021-10-21 11:57:47 +02:00
moonrailgun
6ed698976d
feat(content-blog): add full blog post html into RSS/Atom feeds (#4330) 
Co-authored-by: slorber <lorber.sebastien@gmail.com>
 2021-10-08 12:59:02 +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
Alexey Pyltsyn
29e06d0677
feat: make tags route path configurable (#5545) 2021-09-21 19:19:18 +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
0c0c14120e
refactor(plugin-blog): style improvements in blogUtils (#5338) 
* Minor refactor

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>

* Revert forEach change

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
 2021-08-11 15:40:33 +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
陈杨文
bb0c9eed0d
fix(v2): parse frontMatter.date (#5232) 
Signed-off-by: wener <wenermail@gmail.com>
 2021-07-28 19:32:14 +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
Sébastien Lorber
138b4c9975
fix(v2): allow undefined favicon (#5054) 
* fix(v2): allow undefined favicon

* fix snapshots
 2021-06-24 18:50:28 +02:00
Sébastien Lorber
1b0acc5547
refactor(v2): blog/docs: add more context in error messages (#4989) 
* refactor(v2): blog/docs: add more context in error messages

* more error handling
 2021-06-16 20:16:55 +02:00
Joshua Chen
80b6d9728e
fix(v2): always use UTC when dealing with blog dates (#4983) 
Signed-off-by: Josh-Cena <sidachen2003@gmail.com>
 2021-06-16 18:59:44 +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
Alexey Pyltsyn
208c089835
fix(v2): respect base url in RSS feeds (#4962) 2021-06-15 15:33:41 +02:00
Alexey Pyltsyn
f71e83450f
refactor(v2): do not generate RSS files for empty feed (#4905) 2021-06-09 13:26:53 +02:00
Sébastien Lorber
57806798c5
fix(v2): fix contentTitle issues when markdown h1 title contains code blocks (#4882) 
* attempt to fix contentTitle issues when markdown h1 title contains inline code blocks

* mention hide_title frontmatter only prevents frontmatter.title from being added in the dom (not a markdown # title in content)

* alwayss insert MainHeading under the div.markdown container for consistency

* ensure MainHeading has no useless id

* revert https://github.com/facebook/docusaurus/pull/4859 as it's now useless: docMeta.title contains the text/frontmatter title in priority over the contentTitle

* fix docs test after revert

* improve markdownParser and fix tests

* fix docs tests

* markdownParser: restore option to remove contentTitle (mostly for blog plugin)

* use removeContentTitle for blog
 2021-06-03 17:45:19 +02:00