Commit graph

97 commits

Author SHA1 Message Date
Oleksiy Gapotchenko
4d7a28963a
feat(theme): add versions attribute to docsVersionDropdown navbar item (#10852)
Co-authored-by: sebastien <lorber.sebastien@gmail.com>
2025-01-30 18:21:54 +01:00
Ivan Cheban
1b44d7ae3c
docs: simplify sidebar description (#10810) 2025-01-03 12:04:26 +01:00
Sébastien Lorber
35aa39bddb
docs: mention config/sidebars run in Node.js runtime (#10608) 2024-10-23 20:01:07 +02:00
ozaki
0eb7b64aac
feat(docs, blog): add support for tags.yml, predefined list of tags (#10137)
Co-authored-by: Sébastien Lorber <slorber@users.noreply.github.com>
Co-authored-by: OzakIOne <OzakIOne@users.noreply.github.com>
Co-authored-by: sebastien <lorber.sebastien@gmail.com>
Co-authored-by: slorber <slorber@users.noreply.github.com>
2024-05-31 17:32:08 +02:00
Joshua Chen
324c853da0
docs: emphasize "index slug" convention (#9906) 2024-03-04 12:33:17 +01:00
Sébastien Lorber
4388267c26
fix(core): various broken anchor link fixes (#9732) 2024-01-12 16:09:45 +01:00
ozaki
fd49301a45
feat(core): make broken link checker detect broken anchors - add onBrokenAnchors config (#9528)
Co-authored-by: sebastienlorber <lorber.sebastien@gmail.com>
2024-01-04 12:56:20 +01:00
Mikey O'Toole
be5b5c660f
docs: versioning docs should show example versioned sidebar files (#9500)
Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
Co-authored-by: sebastienlorber <lorber.sebastien@gmail.com>
2023-11-10 19:03:18 +01:00
Sébastien Lorber
4e150d2b82
docs: add Docusaurus v3.0 upgrade guide (#9417) 2023-10-19 19:38:32 +02:00
Chongyi Zheng
45f1a669b5
feat(core): support TypeScript + ESM configuration (#9317)
Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
Co-authored-by: sebastienlorber <lorber.sebastien@gmail.com>
2023-10-14 02:46:03 +02:00
Sébastien Lorber
f5ae537d3e
fix(theme): make warning a first-class admonition, and deprecate caution admonition (#9308) 2023-09-15 10:48:21 +02:00
Forresst
7ce0d87575
docs: fix bad link for create doc (#9288) 2023-09-07 12:31:03 +02:00
Coupy
a145205848
docs: fix typo in docs-introduction (#9267) 2023-08-31 12:28:23 +02:00
Sébastien Lorber
14586895ae
docs: improve sidebar items custom props docs (#8888) 2023-04-13 12:24:27 +02:00
Sébastien Lorber
361dfda2fd
docs: remove problematic mdx2 anchor id docs for MDX 2 migration (#8788) 2023-03-17 18:10:04 +01:00
Sébastien Lorber
9c920c531b
docs: prepare docs for MDX 2 (#8782) 2023-03-16 17:02:38 +01:00
Davide Donadio
5c271f5622
feat(content-docs): add support for sidebar item category/link descriptions in generated index page (#8236)
Co-authored-by: Davide Donadio <davide.donadio@it.clara.net>
Co-authored-by: sebastienlorber <lorber.sebastien@gmail.com>
2023-03-16 10:14:42 +01:00
Sébastien Lorber
120b99b1f3
docs(website): use .mdx extension for every docs (#8490) 2022-12-30 15:08:28 +01:00
Marco Stroppel
024474a7b9
docs: fix link to docs only mode (#8453)
Co-authored-by: Sébastien Lorber <slorber@users.noreply.github.com>
Co-authored-by: sebastienlorber <lorber.sebastien@gmail.com>
2022-12-22 15:33:55 +01:00
Anna
4b11c57f7e
docs: autogenerated page comment does not matching dirName in examples (#8364) 2022-11-23 17:37:22 +01:00
Sébastien Lorber
c811d6249e
feat(theme): ability to use <DocCardList> without items prop, on any doc page (#8008) 2022-08-26 17:42:59 +02:00
Joshua Chen
8e3e89d9ff
docs: add link from every category index page to the guide page (#7665) 2022-06-23 13:46:59 +02:00
Joshua Chen
e12a2efaeb
docs: normalize capitalization (#7619) 2022-06-15 13:04:33 +08:00
Joshua Chen
aeb6c971c0
docs: normalize capitalization (#7613) 2022-06-14 14:01:06 +08:00
Joshua Chen
c03def7d5f
docs: wrap more JSX in mdx-code-block (#7568) 2022-06-05 15:41:06 +08:00
Joshua Chen
f40dc31381
docs: multiple documentation elaborations (#7519) 2022-05-28 21:24:01 +08:00
Joshua Chen
ab566ecce3
docs: remove useless front matter (#7518) 2022-05-28 19:07:45 +08:00
Steven Hicks
9ead309809
docs: add clarity to versioning behavior (#7327) 2022-05-05 00:15:50 +08:00
Joshua Chen
785fed723f
refactor(theme-classic): move all sidebar-related config under themeConfig.docs.sidebar (#7277) 2022-05-04 12:08:19 +02:00
Joshua Chen
9fd5d62340
docs: enhance docs about Markdown TOC and metadata (#7278)
* docs: multiple documentation improvements

* fix

* fix
2022-04-30 21:30:14 +08:00
Joshua Chen
d2562a4434
refactor: normalize Markdown linkification behavior, elaborate in documentation (#7248)
* refactor: normalize Markdown linkification behavior, elaborate in documentation

* fix broken links

* allow links to be relative to site root

* fix test

* minor doc update

* Update website/docs/guides/markdown-features/markdown-features-links.md

Co-authored-by: Sébastien Lorber <slorber@users.noreply.github.com>

Co-authored-by: Sébastien Lorber <slorber@users.noreply.github.com>
2022-04-29 11:36:39 +08:00
Andrew Lyons
ec109737e9
docs: explain more clearly the purpose of a ref sidebar type (#7159) 2022-04-12 15:59:41 +08:00
Leedom
b842197ac6
docs: consistently use sidebars.js filename (#7016)
* modify sidebar.js to sidebars.js in installation.md

* modify sidebar.js to sidebars.js

Co-authored-by: leedom <leedom@jinlanzuan.com>
2022-03-27 09:55:12 +08:00
Joshua Chen
b5ceead3b2
feat(content-docs): autogenerate category with linked doc metadata as fallback (#6859) 2022-03-25 15:23:11 +01:00
Kayce Basques
284649c7c8
docs: clarify the usage of slug (#6926)
* Clarify the usage of slug

As a new user it was unclear whether setting `slug` would change the URL relative to the root directory or relative to the docs directory. The example I added should make that clear without needing to test out the functionality in a Docusaurus instance (which is what I had to do).

* editorial changes

Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
2022-03-17 07:54:18 +08:00
tae
2e163a9ec4
feat(content-docs): allow custom props through _category_.json (#6780)
* feat(content-docs): allow custom props through _category_.json

* refactor

* documentation

Co-authored-by: Joshua Chen <sidachen2003@gmail.com>
2022-03-05 18:52:36 +08:00
Sébastien Lorber
12aae9a086
docs: add doc for generated-index keyword/image metadata (#6708) 2022-02-17 14:24:13 +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
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
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
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
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
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
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
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
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