From 96bd073656db3cf329db40ff0269d28d9b678ab5 Mon Sep 17 00:00:00 2001 From: sebastienlorber Date: Thu, 1 Sep 2022 12:41:42 +0200 Subject: [PATCH 1/2] the tutorial explicit sidebar must contain tutorial-basics/create-a-document => less confusing --- packages/create-docusaurus/templates/facebook/sidebars.js | 4 +++- .../shared/docs/tutorial-basics/create-a-document.md | 6 ++++-- packages/create-docusaurus/templates/shared/sidebars.js | 4 +++- 3 files changed, 10 insertions(+), 4 deletions(-) diff --git a/packages/create-docusaurus/templates/facebook/sidebars.js b/packages/create-docusaurus/templates/facebook/sidebars.js index be7a480ce62a..7c923fa366ee 100644 --- a/packages/create-docusaurus/templates/facebook/sidebars.js +++ b/packages/create-docusaurus/templates/facebook/sidebars.js @@ -25,10 +25,12 @@ module.exports = { // But you can create a sidebar manually /* tutorialSidebar: [ + 'intro', + 'hello', { type: 'category', label: 'Tutorial', - items: ['hello'], + items: ['tutorial-basics/create-a-document'], }, ], */ diff --git a/packages/create-docusaurus/templates/shared/docs/tutorial-basics/create-a-document.md b/packages/create-docusaurus/templates/shared/docs/tutorial-basics/create-a-document.md index 3c92695c517e..ffddfa8eb8ac 100644 --- a/packages/create-docusaurus/templates/shared/docs/tutorial-basics/create-a-document.md +++ b/packages/create-docusaurus/templates/shared/docs/tutorial-basics/create-a-document.md @@ -44,11 +44,13 @@ It is also possible to create your sidebar explicitly in `sidebars.js`: ```js title="sidebars.js" module.exports = { tutorialSidebar: [ + 'intro', + // highlight-next-line + 'hello', { type: 'category', label: 'Tutorial', - // highlight-next-line - items: ['hello'], + items: ['tutorial-basics/create-a-document'], }, ], }; diff --git a/packages/create-docusaurus/templates/shared/sidebars.js b/packages/create-docusaurus/templates/shared/sidebars.js index fd342f2cdb2b..9ab54c2459c4 100644 --- a/packages/create-docusaurus/templates/shared/sidebars.js +++ b/packages/create-docusaurus/templates/shared/sidebars.js @@ -19,10 +19,12 @@ const sidebars = { // But you can create a sidebar manually /* tutorialSidebar: [ + 'intro', + 'hello', { type: 'category', label: 'Tutorial', - items: ['hello'], + items: ['tutorial-basics/create-a-document'], }, ], */ From b65fbf1c17da102de2a77156cdb86a36d27dec16 Mon Sep 17 00:00:00 2001 From: sebastienlorber Date: Thu, 1 Sep 2022 12:48:48 +0200 Subject: [PATCH 2/2] tutorial, mention site config + theme Config --- .../templates/shared/docs/tutorial-basics/congratulations.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/packages/create-docusaurus/templates/shared/docs/tutorial-basics/congratulations.md b/packages/create-docusaurus/templates/shared/docs/tutorial-basics/congratulations.md index 9ef99bbadd93..04771a00b72f 100644 --- a/packages/create-docusaurus/templates/shared/docs/tutorial-basics/congratulations.md +++ b/packages/create-docusaurus/templates/shared/docs/tutorial-basics/congratulations.md @@ -14,7 +14,9 @@ Anything **unclear** or **buggy** in this tutorial? [Please report it!](https:// ## What's next? -- Read the [official documentation](https://docusaurus.io/). +- Read the [official documentation](https://docusaurus.io/) +- Modify your site configuration with [`docusaurus.config.js`](https://docusaurus.io/docs/api/docusaurus-config) +- Add navbar and footer items with [`themeConfig`](https://docusaurus.io/docs/api/themes/configuration) - Add a custom [Design and Layout](https://docusaurus.io/docs/styling-layout) - Add a [search bar](https://docusaurus.io/docs/search) - Find inspirations in the [Docusaurus showcase](https://docusaurus.io/showcase)