Commit graph

780 commits

Author SHA1 Message Date
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
9562a5d203
refactor: remove deprecated Webpack utils & validation escape hatch (#6740) 2022-02-23 11:40:58 +01:00
Sébastien Lorber
a6f53aa9d2
refactor(theme-classic): bias again search metadata toward Algolia DocSearch (#6707) 2022-02-17 14:24:31 +01:00
Sébastien Lorber
12aae9a086
docs: add doc for generated-index keyword/image metadata (#6708) 2022-02-17 14:24:13 +01:00
Alexey Pyltsyn
0f1f35b678
docs(website): fix video responsiveness (#6709) 2022-02-17 14:22:36 +01:00
Dmitry Vinnik
1551407a9b
docs: add deep dive video for Docusaurus (#6687) 2022-02-17 12:03:26 +01:00
Sébastien Lorber
49361e2ae9
docs(website): search doc typo searchParameters (#6704) 2022-02-17 11:57:30 +01: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
94532dfd26
docs: fix bad anchor link syntax (#6683) 2022-02-15 11:24:50 +08:00
Joshua Chen
d460d48dfc
docs: mention that all official themes are TypeScript-covered (#6675)
* docs: mention that all official themes are TypeScript-covered

* revert...

* kick
2022-02-14 23:33:37 +08:00
Joshua Chen
c27695ab5c
docs: mention about blog date in front matter (#6673)
* docs: mention about blog date in front matter

* fix
2022-02-14 15:42:37 +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
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
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
BigDataWriter
bd05b74808
docs: improve wording of using Markdown file paths (#6633)
* Update docs-markdown-features.mdx

* Author meant to recommend the use of full paths rather than relative paths: Technical edit
* Revised intro to naturally introduce the benefits of this recommendation: Style edit

* Update website/docs/guides/docs/docs-markdown-features.mdx

* Update website/docs/guides/docs/docs-markdown-features.mdx

Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
2022-02-08 11:12:38 +08:00
Joshua Chen
a350a8a130
docs: fix bad anchor link syntax (#6611) 2022-02-05 14:52:19 +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
Everardo J. Barojas M
caa9d281c3
docs: improve Github Actions example jobs (#6591)
* docs: Improve docs on deploy.yml gh action

* docs: Improve docs on test-deploy.yml gh action

* docs: improve docs on delpoy.yml and test-deploy.yml gh action on next version docs

* docs: rm unneeded lines

* edits

Co-authored-by: Everardo J Barojas M <everardo@prescrypto.com>
Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
2022-02-03 20:42:19 +08: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
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
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
2553f1fb5a
refactor: improve internal typing (#6507)
* refactor: improve internal typing

* fix

* fix test
2022-01-29 22:58:40 +08:00
Gaurish
8bdecf107c
docs: add Cloudflare pages deployment guide (#6501)
* Docs: Add Cloudflare pages deployment guide

* minor tweaks

Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
2022-01-29 13:27:34 +08:00
Joshua Chen
c1e3801ee7
fix(cli): allow passing a list of file names to write-heading-ids (#6500) 2022-01-29 12:21:15 +08:00
Joshua Chen
f2b1c8e80e
docs: mention how env vars can be read (#6499) 2022-01-29 11:34:30 +08:00
Tamal Web
ade486d079
docs: mention where to find the sitemap (#6492)
* Added the sitemap url

So that users know where to locate their sitemaps

* Update plugin-sitemap.md

Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
2022-01-28 17:11:09 +08:00
Joshua Chen
556f59b193
fix(utils): do not resolve Markdown paths with @site prefix (#6489) 2022-01-28 10:10:39 +08:00
Joshua Chen
5c447b1ca3
docs: elaborate on Markdown asset linking; document pathname:// (#6404) 2022-01-27 23:16:55 +08:00
Joshua Chen
3c58d7f027
feat(content-docs): allow explicitly disabling index page for generated category (#6452)
* feat(content-docs): allow explicitly disabling index page for generated category

* docs

* add test
2022-01-27 23:14:07 +08:00
Joshua Chen
b8fbf7c530
docs: remove mention that CDN resources are caches cross-domain (#6484) 2022-01-27 19:21:07 +08:00
Pranab Das
f415da1c95
refactor: self-host KaTeX assets (#6429)
Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
2022-01-27 11:39:45 +01:00
Joshua Chen
24a895fbc5
feat(content-docs): expose isCategoryIndex matcher to customize conventions (#6451)
Co-authored-by: sebastienlorber <lorber.sebastien@gmail.com>
2022-01-26 17:58:52 +01:00
Joshua Chen
76a8d5f38a
fix(content-blog): generate feed by reading build output (#6454) 2022-01-26 16:54:15 +01:00
Sébastien Lorber
dd539dd23f
feat(search): enable contextual search by default (#6407) 2022-01-25 11:45:41 +08:00
Joshua Chen
59022c5eea
docs: add advanced guides (#6296)
* docs: add advanced guides

* complete

* fix link

* Create architecture

* use png

* explanations

* more text

* process.env.NODE_ENV

* typo

* Add image zoom

* nit

* nit

* reorganize

* fix links

* fix links

* reorganize

* elaborate on presets

* fix

* routing docs

* ssr section

* more content

* complete SSR guide

* pathname://

* improvements

* document executionenvironment

* reformat

* final tweaks!

* avoid slug

* oops
2022-01-25 11:29:18 +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
Edouard Bonlieu
0f8bb3bbe6
docs: add Koyeb as a deployment option (#6431) 2022-01-24 18:57:02 +08:00
Joshua Chen
711a6fe3d0
docs: document embedding generated index in doc page (#6453)
* docs: document embedding generated index in doc page

* fix
2022-01-23 20:04:34 +08:00
Joshua Chen
01676329e1
docs: split sidebar documentation into sections (#6450)
* docs: split sidebar documentation into sections

* set slugs

* fix links
2022-01-23 17:50:48 +08:00
Joshua Chen
8140560332
docs: multiple doc improvements (#6449) 2022-01-23 15:49:28 +08:00
Nick Schonning
2528226eeb
chore: add height/width for front page images (#6385)
* chore: add height/width for Lighthouse performance

* use auto width

Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
2022-01-23 09:57:31 +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
e40cafccd5
chore: enable stylelint standard config (#6442)
* chore: enable stylelint standard config

* remove empty line

* fix
2022-01-22 21:26:35 +08:00
Joshua Chen
cbcbdaa9d3
docs: elaborate on i18n tutorial (#6428) 2022-01-21 21:25:03 +08:00
Joseph
8ce3cee400
feat(theme-classic): auto-collapse sibling categories in doc sidebar (#3811)
Co-authored-by: Josh-Cena <sidachen2003@gmail.com>
2022-01-20 16:38:16 +01:00
Joshua Chen
4e69c052d6
feat(content-blog): allow authors list to contain images only (#6416)
* feat(content-blog): allow authors list to contain images only

* adjust styles

* fix

* fix

* mention in docs

* fix wording
2022-01-20 22:08:18 +08:00
Joshua Chen
d506bca12d
feat(content-blog): allow disabling generating archive (#6415) 2022-01-20 14:52:19 +01:00
Joshua Chen
d133910cb2
feat(content-blog): parse date from middle of file path (#6245) 2022-01-20 16:43:00 +08:00