From 291c18430c53f64c873bec67758559808f9a1cf3 Mon Sep 17 00:00:00 2001 From: Joshua Chen Date: Sat, 28 May 2022 18:49:21 +0800 Subject: [PATCH] docs: remove useless front matter --- website/docs/api/docusaurus.config.js.md | 1 - website/docs/api/misc/create-docusaurus.md | 5 +++-- website/docs/api/misc/eslint-plugin/README.md | 6 +++--- .../docs/api/misc/eslint-plugin/no-untranslated-text.md | 2 +- .../misc/eslint-plugin/string-literal-i18n-messages.md | 2 +- website/docs/api/misc/logger/logger.md | 5 +++-- website/docs/api/plugins/overview.md | 5 +++-- website/docs/api/plugins/plugin-client-redirects.md | 6 +++--- website/docs/api/plugins/plugin-content-blog.md | 6 +++--- website/docs/api/plugins/plugin-content-docs.md | 6 +++--- website/docs/api/plugins/plugin-content-pages.md | 6 +++--- website/docs/api/plugins/plugin-debug.md | 6 +++--- website/docs/api/plugins/plugin-google-analytics.md | 6 +++--- website/docs/api/plugins/plugin-google-gtag.md | 6 +++--- website/docs/api/plugins/plugin-ideal-image.md | 6 +++--- website/docs/api/plugins/plugin-pwa.md | 6 +++--- website/docs/api/plugins/plugin-sitemap.md | 6 +++--- website/docs/api/themes/overview.md | 5 +++-- website/docs/api/themes/theme-classic.md | 6 +++--- website/docs/api/themes/theme-configuration.md | 8 ++++---- website/docs/api/themes/theme-live-codeblock.md | 6 +++--- website/docs/api/themes/theme-search-algolia.md | 6 +++--- website/docs/blog.mdx | 7 ++++--- website/docs/browser-support.md | 5 +++-- website/docs/cli.md | 2 +- website/docs/configuration.md | 5 +++-- website/docs/deployment.mdx | 5 +++-- website/docs/docusaurus-core.md | 4 ++-- website/docs/guides/creating-pages.md | 4 ++-- website/docs/guides/docs/docs-create-doc.mdx | 3 ++- website/docs/guides/docs/docs-introduction.md | 3 ++- website/docs/guides/docs/docs-multi-instance.mdx | 3 ++- website/docs/guides/docs/versioning.md | 7 ++++--- .../markdown-features/markdown-features-admonitions.mdx | 3 ++- .../markdown-features/markdown-features-assets.mdx | 3 ++- .../markdown-features/markdown-features-code-blocks.mdx | 3 ++- .../markdown-features-head-metadata.mdx | 1 - .../guides/markdown-features/markdown-features-intro.mdx | 4 ++-- .../markdown-features-math-equations.mdx | 3 ++- .../markdown-features/markdown-features-plugins.mdx | 3 ++- .../guides/markdown-features/markdown-features-react.mdx | 1 - .../guides/markdown-features/markdown-features-tabs.mdx | 3 ++- website/docs/i18n/i18n-crowdin.mdx | 3 ++- website/docs/i18n/i18n-git.md | 3 ++- website/docs/i18n/i18n-introduction.md | 3 ++- website/docs/i18n/i18n-tutorial.md | 4 +++- website/docs/installation.md | 5 +++-- website/docs/introduction.md | 4 ++-- website/docs/migration/migration-automated.md | 4 ++-- website/docs/migration/migration-manual.md | 4 ++-- website/docs/migration/migration-overview.md | 4 ++-- website/docs/migration/migration-translated-sites.md | 4 ++-- website/docs/migration/migration-versioned-sites.md | 4 ++-- website/docs/search.md | 4 ++-- website/docs/seo.md | 5 +++-- website/docs/static-assets.md | 9 +++++---- website/docs/styling-layout.md | 4 ++-- website/docs/typescript-support.md | 5 +++-- 58 files changed, 141 insertions(+), 117 deletions(-) diff --git a/website/docs/api/docusaurus.config.js.md b/website/docs/api/docusaurus.config.js.md index 9910ddb5220a3..d20d29d34c766 100644 --- a/website/docs/api/docusaurus.config.js.md +++ b/website/docs/api/docusaurus.config.js.md @@ -1,6 +1,5 @@ --- sidebar_position: 0 -id: docusaurus.config.js description: API reference for Docusaurus configuration file. slug: /api/docusaurus-config --- diff --git a/website/docs/api/misc/create-docusaurus.md b/website/docs/api/misc/create-docusaurus.md index e35d3884cd78c..b4dc0491e4a81 100644 --- a/website/docs/api/misc/create-docusaurus.md +++ b/website/docs/api/misc/create-docusaurus.md @@ -1,9 +1,10 @@ --- sidebar_position: 0 -title: '📦 create-docusaurus' -slug: '/api/misc/create-docusaurus' +slug: /api/misc/create-docusaurus --- +# 📦 create-docusaurus + A scaffolding utility to help you instantly set up a functional Docusaurus app. ## Usage {#usage} diff --git a/website/docs/api/misc/eslint-plugin/README.md b/website/docs/api/misc/eslint-plugin/README.md index 8519bcfe6ef1c..9d0d2236846cc 100644 --- a/website/docs/api/misc/eslint-plugin/README.md +++ b/website/docs/api/misc/eslint-plugin/README.md @@ -1,10 +1,10 @@ --- sidebar_position: 1 -id: eslint-plugin -title: '📦 eslint-plugin' -slug: '/api/misc/@docusaurus/eslint-plugin' +slug: /api/misc/@docusaurus/eslint-plugin --- +# 📦 eslint-plugin + [ESLint](https://eslint.org/) is a tool that statically analyzes your code and reports problems or suggests best practices through editor hints and command line. Docusaurus provides an ESLint plugin to enforce best Docusaurus practices. ## Installation diff --git a/website/docs/api/misc/eslint-plugin/no-untranslated-text.md b/website/docs/api/misc/eslint-plugin/no-untranslated-text.md index 346c021fe8ea9..10037be178dc4 100644 --- a/website/docs/api/misc/eslint-plugin/no-untranslated-text.md +++ b/website/docs/api/misc/eslint-plugin/no-untranslated-text.md @@ -1,5 +1,5 @@ --- -slug: '/api/misc/@docusaurus/eslint-plugin/no-untranslated-text' +slug: /api/misc/@docusaurus/eslint-plugin/no-untranslated-text --- # no-untranslated-text diff --git a/website/docs/api/misc/eslint-plugin/string-literal-i18n-messages.md b/website/docs/api/misc/eslint-plugin/string-literal-i18n-messages.md index 9829a4d89bf70..c216b78233a96 100644 --- a/website/docs/api/misc/eslint-plugin/string-literal-i18n-messages.md +++ b/website/docs/api/misc/eslint-plugin/string-literal-i18n-messages.md @@ -1,5 +1,5 @@ --- -slug: '/api/misc/@docusaurus/eslint-plugin/string-literal-i18n-messages' +slug: /api/misc/@docusaurus/eslint-plugin/string-literal-i18n-messages --- # string-literal-i18n-messages diff --git a/website/docs/api/misc/logger/logger.md b/website/docs/api/misc/logger/logger.md index fb291473dd5fa..e4591bb384d34 100644 --- a/website/docs/api/misc/logger/logger.md +++ b/website/docs/api/misc/logger/logger.md @@ -1,9 +1,10 @@ --- sidebar_position: 2 -title: '📦 logger' -slug: '/api/misc/@docusaurus/logger' +slug: /api/misc/@docusaurus/logger --- +# 📦 logger + An encapsulated logger for semantically formatting console messages. Authors of packages in the Docusaurus ecosystem are encouraged to use this package to provide unified log formats. diff --git a/website/docs/api/plugins/overview.md b/website/docs/api/plugins/overview.md index 31897e73e682a..f1d1656aa38cd 100644 --- a/website/docs/api/plugins/overview.md +++ b/website/docs/api/plugins/overview.md @@ -1,11 +1,12 @@ --- sidebar_position: 0 id: plugins-overview -title: 'Docusaurus plugins' sidebar_label: Plugins overview -slug: '/api/plugins' +slug: /api/plugins --- +# Docusaurus plugins + We provide official Docusaurus plugins. ## Content plugins {#content-plugins} diff --git a/website/docs/api/plugins/plugin-client-redirects.md b/website/docs/api/plugins/plugin-client-redirects.md index 991ea778ad915..a97122b36dbb8 100644 --- a/website/docs/api/plugins/plugin-client-redirects.md +++ b/website/docs/api/plugins/plugin-client-redirects.md @@ -1,10 +1,10 @@ --- sidebar_position: 4 -id: plugin-client-redirects -title: '📦 plugin-client-redirects' -slug: '/api/plugins/@docusaurus/plugin-client-redirects' +slug: /api/plugins/@docusaurus/plugin-client-redirects --- +# 📦 plugin-client-redirects + import APITable from '@site/src/components/APITable'; Docusaurus Plugin to generate **client-side redirects**. diff --git a/website/docs/api/plugins/plugin-content-blog.md b/website/docs/api/plugins/plugin-content-blog.md index 8cdc51d7c668a..52806b0168734 100644 --- a/website/docs/api/plugins/plugin-content-blog.md +++ b/website/docs/api/plugins/plugin-content-blog.md @@ -1,10 +1,10 @@ --- sidebar_position: 2 -id: plugin-content-blog -title: '📦 plugin-content-blog' -slug: '/api/plugins/@docusaurus/plugin-content-blog' +slug: /api/plugins/@docusaurus/plugin-content-blog --- +# 📦 plugin-content-blog + import APITable from '@site/src/components/APITable'; Provides the [Blog](blog.mdx) feature and is the default blog plugin for Docusaurus. diff --git a/website/docs/api/plugins/plugin-content-docs.md b/website/docs/api/plugins/plugin-content-docs.md index a44ce3ca1a5ae..4b7deaff16d67 100644 --- a/website/docs/api/plugins/plugin-content-docs.md +++ b/website/docs/api/plugins/plugin-content-docs.md @@ -1,10 +1,10 @@ --- sidebar_position: 1 -id: plugin-content-docs -title: '📦 plugin-content-docs' -slug: '/api/plugins/@docusaurus/plugin-content-docs' +slug: /api/plugins/@docusaurus/plugin-content-docs --- +# 📦 plugin-content-docs + import APITable from '@site/src/components/APITable'; Provides the [Docs](../../guides/docs/docs-introduction.md) functionality and is the default docs plugin for Docusaurus. diff --git a/website/docs/api/plugins/plugin-content-pages.md b/website/docs/api/plugins/plugin-content-pages.md index 7a8264d564618..23dff9c2a799e 100644 --- a/website/docs/api/plugins/plugin-content-pages.md +++ b/website/docs/api/plugins/plugin-content-pages.md @@ -1,10 +1,10 @@ --- sidebar_position: 3 -id: plugin-content-pages -title: '📦 plugin-content-pages' -slug: '/api/plugins/@docusaurus/plugin-content-pages' +slug: /api/plugins/@docusaurus/plugin-content-pages --- +# 📦 plugin-content-pages + import APITable from '@site/src/components/APITable'; The default pages plugin for Docusaurus. The classic template ships with this plugin with default configurations. This plugin provides [creating pages](guides/creating-pages.md) functionality. diff --git a/website/docs/api/plugins/plugin-debug.md b/website/docs/api/plugins/plugin-debug.md index 6aea24d496f27..e8c79044d9457 100644 --- a/website/docs/api/plugins/plugin-debug.md +++ b/website/docs/api/plugins/plugin-debug.md @@ -1,10 +1,10 @@ --- sidebar_position: 5 -id: plugin-debug -title: '📦 plugin-debug' -slug: '/api/plugins/@docusaurus/plugin-debug' +slug: /api/plugins/@docusaurus/plugin-debug --- +# 📦 plugin-debug + ```mdx-code-block import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; diff --git a/website/docs/api/plugins/plugin-google-analytics.md b/website/docs/api/plugins/plugin-google-analytics.md index da8f938732c92..5e6403652e902 100644 --- a/website/docs/api/plugins/plugin-google-analytics.md +++ b/website/docs/api/plugins/plugin-google-analytics.md @@ -1,10 +1,10 @@ --- sidebar_position: 6 -id: plugin-google-analytics -title: '📦 plugin-google-analytics' -slug: '/api/plugins/@docusaurus/plugin-google-analytics' +slug: /api/plugins/@docusaurus/plugin-google-analytics --- +# 📦 plugin-google-analytics + import APITable from '@site/src/components/APITable'; The default [Google Analytics](https://developers.google.com/analytics/devguides/collection/analyticsjs/) plugin. It is a JavaScript library for measuring how users interact with your website **in the production build**. If you are using Google Analytics 4 you might need to consider using [plugin-google-gtag](./plugin-google-gtag.md) instead. diff --git a/website/docs/api/plugins/plugin-google-gtag.md b/website/docs/api/plugins/plugin-google-gtag.md index da5a53a954bf7..df65941b537b4 100644 --- a/website/docs/api/plugins/plugin-google-gtag.md +++ b/website/docs/api/plugins/plugin-google-gtag.md @@ -1,10 +1,10 @@ --- sidebar_position: 7 -id: plugin-google-gtag -title: '📦 plugin-google-gtag' -slug: '/api/plugins/@docusaurus/plugin-google-gtag' +slug: /api/plugins/@docusaurus/plugin-google-gtag --- +# 📦 plugin-google-gtag + import APITable from '@site/src/components/APITable'; The default [Global Site Tag (gtag.js)](https://developers.google.com/analytics/devguides/collection/gtagjs/) plugin. It is a JavaScript tagging framework and API that allows you to send event data to Google Analytics, Google Ads, and Google Marketing Platform. This section describes how to configure a Docusaurus site to enable global site tag for Google Analytics. diff --git a/website/docs/api/plugins/plugin-ideal-image.md b/website/docs/api/plugins/plugin-ideal-image.md index db40b29d7d7f8..900c54e627e73 100644 --- a/website/docs/api/plugins/plugin-ideal-image.md +++ b/website/docs/api/plugins/plugin-ideal-image.md @@ -1,10 +1,10 @@ --- sidebar_position: 8 -id: plugin-ideal-image -title: '📦 plugin-ideal-image' -slug: '/api/plugins/@docusaurus/plugin-ideal-image' +slug: /api/plugins/@docusaurus/plugin-ideal-image --- +# 📦 plugin-ideal-image + import APITable from '@site/src/components/APITable'; Docusaurus Plugin to generate an almost ideal image (responsive, lazy-loading, and low quality placeholder). diff --git a/website/docs/api/plugins/plugin-pwa.md b/website/docs/api/plugins/plugin-pwa.md index a732e8094d68d..a9647173182a2 100644 --- a/website/docs/api/plugins/plugin-pwa.md +++ b/website/docs/api/plugins/plugin-pwa.md @@ -1,10 +1,10 @@ --- sidebar_position: 9 -id: plugin-pwa -title: '📦 plugin-pwa' -slug: '/api/plugins/@docusaurus/plugin-pwa' +slug: /api/plugins/@docusaurus/plugin-pwa --- +# 📦 plugin-pwa + Docusaurus Plugin to add PWA support using [Workbox](https://developers.google.com/web/tools/workbox). This plugin generates a [Service Worker](https://developers.google.com/web/fundamentals/primers/service-workers) in production build only, and allows you to create fully PWA-compliant documentation site with offline and installation support. ## Installation {#installation} diff --git a/website/docs/api/plugins/plugin-sitemap.md b/website/docs/api/plugins/plugin-sitemap.md index 145b62d9e2586..b1d18e2f1e78a 100644 --- a/website/docs/api/plugins/plugin-sitemap.md +++ b/website/docs/api/plugins/plugin-sitemap.md @@ -1,10 +1,10 @@ --- sidebar_position: 10 -id: plugin-sitemap -title: '📦 plugin-sitemap' -slug: '/api/plugins/@docusaurus/plugin-sitemap' +slug: /api/plugins/@docusaurus/plugin-sitemap --- +# 📦 plugin-sitemap + import APITable from '@site/src/components/APITable'; This plugin creates sitemaps for your site so that search engine crawlers can crawl your site more accurately. diff --git a/website/docs/api/themes/overview.md b/website/docs/api/themes/overview.md index 6047040db0d79..f16eff35b511d 100644 --- a/website/docs/api/themes/overview.md +++ b/website/docs/api/themes/overview.md @@ -1,11 +1,12 @@ --- sidebar_position: 0 id: themes-overview -title: 'Docusaurus themes' sidebar_label: Themes overview -slug: '/api/themes' +slug: /api/themes --- +# Docusaurus themes + We provide official Docusaurus themes. ## Main themes {#main-themes} diff --git a/website/docs/api/themes/theme-classic.md b/website/docs/api/themes/theme-classic.md index e99a320f135bb..900f69cfa1d74 100644 --- a/website/docs/api/themes/theme-classic.md +++ b/website/docs/api/themes/theme-classic.md @@ -1,10 +1,10 @@ --- sidebar_position: 2 -id: theme-classic -title: '📦 theme-classic' -slug: '/api/themes/@docusaurus/theme-classic' +slug: /api/themes/@docusaurus/theme-classic --- +# 📦 theme-classic + The classic theme for Docusaurus. You can refer to the [theme configuration page](theme-configuration.md) for more details on the configuration. diff --git a/website/docs/api/themes/theme-configuration.md b/website/docs/api/themes/theme-configuration.md index d1291bbc3cbc1..7936ae6f5f21c 100644 --- a/website/docs/api/themes/theme-configuration.md +++ b/website/docs/api/themes/theme-configuration.md @@ -1,12 +1,12 @@ --- sidebar_position: 1 -id: theme-configuration -title: 'Theme configuration' -sidebar_label: 'Configuration' -slug: '/api/themes/configuration' +sidebar_label: Configuration +slug: /api/themes/configuration toc_max_heading_level: 4 --- +# Theme configuration + import APITable from '@site/src/components/APITable'; This configuration applies to all [main themes](./overview.md). diff --git a/website/docs/api/themes/theme-live-codeblock.md b/website/docs/api/themes/theme-live-codeblock.md index 75e803499e542..be6f4da721d78 100644 --- a/website/docs/api/themes/theme-live-codeblock.md +++ b/website/docs/api/themes/theme-live-codeblock.md @@ -1,10 +1,10 @@ --- sidebar_position: 3 -id: theme-live-codeblock -title: '📦 theme-live-codeblock' -slug: '/api/themes/@docusaurus/theme-live-codeblock' +slug: /api/themes/@docusaurus/theme-live-codeblock --- +# 📦 theme-live-codeblock + This theme provides a `@theme/CodeBlock` component that is powered by react-live. You can read more on [interactive code editor](../../guides/markdown-features/markdown-features-code-blocks.mdx#interactive-code-editor) documentation. ```bash npm2yarn diff --git a/website/docs/api/themes/theme-search-algolia.md b/website/docs/api/themes/theme-search-algolia.md index 05e2f767fe122..1b5ce68a74bfe 100644 --- a/website/docs/api/themes/theme-search-algolia.md +++ b/website/docs/api/themes/theme-search-algolia.md @@ -1,10 +1,10 @@ --- sidebar_position: 4 -id: theme-search-algolia -title: '📦 theme-search-algolia' -slug: '/api/themes/@docusaurus/theme-search-algolia' +slug: /api/themes/@docusaurus/theme-search-algolia --- +# 📦 theme-search-algolia + This theme provides a `@theme/SearchBar` component that integrates with Algolia DocSearch easily. Combined with `@docusaurus/theme-classic`, it provides a very easy search integration. You can read more on [search](../../search.md) documentation. ```bash npm2yarn diff --git a/website/docs/blog.mdx b/website/docs/blog.mdx index 3e0173879a5f8..25bd18f60a8e4 100644 --- a/website/docs/blog.mdx +++ b/website/docs/blog.mdx @@ -1,12 +1,13 @@ --- -id: blog -title: Blog +description: Deploy a full-featured blog in no time with Docusaurus. --- +# Blog + import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; -The blog feature enables you to deploy in no time a full-featured blog. +The blog feature enables you to deploy a full-featured blog in no time. :::info diff --git a/website/docs/browser-support.md b/website/docs/browser-support.md index 6a5bbadfdcc65..576f75e1e7399 100644 --- a/website/docs/browser-support.md +++ b/website/docs/browser-support.md @@ -1,8 +1,9 @@ --- -id: browser-support -title: Browser support +description: How to balance between bundle size and have sufficient browser support. --- +# Browser support + Docusaurus allows sites to define the list of supported browsers through a [browserslist configuration](https://github.com/browserslist/browserslist). ## Purpose {#purpose} diff --git a/website/docs/cli.md b/website/docs/cli.md index c1b79ddd9d876..92bf71a806330 100644 --- a/website/docs/cli.md +++ b/website/docs/cli.md @@ -1,5 +1,5 @@ --- -id: cli +description: Docusaurus provides a set of scripts to help you generate, serve, and deploy your website. --- # CLI diff --git a/website/docs/configuration.md b/website/docs/configuration.md index 161882929c99b..fcfc92e0bc17d 100644 --- a/website/docs/configuration.md +++ b/website/docs/configuration.md @@ -1,8 +1,9 @@ --- -id: configuration -title: Configuration +description: Configuring your site's behavior through docusaurus.config.js and more. --- +# Configuration + import TOCInline from '@theme/TOCInline'; Docusaurus has a unique take on configurations. We encourage you to congregate information about your site into one place. We guard the fields of this file and facilitate making this data object accessible across your site. diff --git a/website/docs/deployment.mdx b/website/docs/deployment.mdx index 23ea588caf498..ded6aca33f882 100644 --- a/website/docs/deployment.mdx +++ b/website/docs/deployment.mdx @@ -1,8 +1,9 @@ --- -id: deployment -title: Deployment +description: Deploy your Docusaurus app for production on a range of static site hosting services. --- +# Deployment + To build the static files of your website for production, run: ```bash npm2yarn diff --git a/website/docs/docusaurus-core.md b/website/docs/docusaurus-core.md index c43d22c061e09..807727872e160 100644 --- a/website/docs/docusaurus-core.md +++ b/website/docs/docusaurus-core.md @@ -1,9 +1,9 @@ --- -id: docusaurus-core -title: Docusaurus Client API sidebar_label: Client API --- +# Docusaurus Client API + Docusaurus provides some APIs on the clients that can be helpful to you when building your site. ## Components {#components} diff --git a/website/docs/guides/creating-pages.md b/website/docs/guides/creating-pages.md index cdf100cdf9a9a..0f5839213a5c7 100644 --- a/website/docs/guides/creating-pages.md +++ b/website/docs/guides/creating-pages.md @@ -1,10 +1,10 @@ --- -id: creating-pages -title: Creating Pages slug: /creating-pages sidebar_label: Pages --- +# Creating Pages + In this section, we will learn about creating pages in Docusaurus. The `@docusaurus/plugin-content-pages` plugin empowers you to create **one-off standalone pages** like a showcase page, playground page, or support page. You can use React components, or Markdown. diff --git a/website/docs/guides/docs/docs-create-doc.mdx b/website/docs/guides/docs/docs-create-doc.mdx index f81121781d1da..baf451a96a0f6 100644 --- a/website/docs/guides/docs/docs-create-doc.mdx +++ b/website/docs/guides/docs/docs-create-doc.mdx @@ -1,10 +1,11 @@ --- id: create-doc -title: Create a doc description: Create a Markdown Document slug: /create-doc --- +# Create a doc + Create a Markdown file, `greeting.md`, and place it under the `docs` directory. ```bash diff --git a/website/docs/guides/docs/docs-introduction.md b/website/docs/guides/docs/docs-introduction.md index 02e9d76b45cd6..885a1e6720f77 100644 --- a/website/docs/guides/docs/docs-introduction.md +++ b/website/docs/guides/docs/docs-introduction.md @@ -1,10 +1,11 @@ --- id: introduction -title: Docs Introduction sidebar_label: Introduction slug: /docs-introduction --- +# Docs Introduction + The docs feature provides users with a way to organize Markdown files in a hierarchical format. :::info diff --git a/website/docs/guides/docs/docs-multi-instance.mdx b/website/docs/guides/docs/docs-multi-instance.mdx index 1ab708b4c9375..0f267fcbe1740 100644 --- a/website/docs/guides/docs/docs-multi-instance.mdx +++ b/website/docs/guides/docs/docs-multi-instance.mdx @@ -1,10 +1,11 @@ --- id: multi-instance -title: Docs Multi-instance description: Use multiple docs plugin instances on a single Docusaurus site. slug: /docs-multi-instance --- +# Docs Multi-instance + The `@docusaurus/plugin-content-docs` plugin can support [multi-instance](../../using-plugins.md#multi-instance-plugins-and-plugin-ids). :::note diff --git a/website/docs/guides/docs/versioning.md b/website/docs/guides/docs/versioning.md index e27512e083a62..0d3f5e5dd4e0a 100644 --- a/website/docs/guides/docs/versioning.md +++ b/website/docs/guides/docs/versioning.md @@ -1,15 +1,16 @@ --- -id: versioning -title: Versioning +description: You can use the versioning CLI to create a new documentation version based on the latest content in the docs directory. That specific set of documentation will then be preserved and accessible even as the documentation in the `docs` directory continues to evolve. slug: /versioning --- +# Versioning + ```mdx-code-block import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; ``` -You can use the version script to create a new documentation version based on the latest content in the `docs` directory. That specific set of documentation will then be preserved and accessible even as the documentation in the `docs` directory changes moving forward. +You can use the versioning CLI to create a new documentation version based on the latest content in the `docs` directory. That specific set of documentation will then be preserved and accessible even as the documentation in the `docs` directory continues to evolve. :::caution diff --git a/website/docs/guides/markdown-features/markdown-features-admonitions.mdx b/website/docs/guides/markdown-features/markdown-features-admonitions.mdx index 3302ee532661b..a864fe0d4f50c 100644 --- a/website/docs/guides/markdown-features/markdown-features-admonitions.mdx +++ b/website/docs/guides/markdown-features/markdown-features-admonitions.mdx @@ -1,10 +1,11 @@ --- id: admonitions -title: Admonitions description: Handling admonitions/callouts in Docusaurus Markdown slug: /markdown-features/admonitions --- +# Admonitions + import BrowserWindow from '@site/src/components/BrowserWindow'; import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; diff --git a/website/docs/guides/markdown-features/markdown-features-assets.mdx b/website/docs/guides/markdown-features/markdown-features-assets.mdx index 321ddb5d9ad23..c4ba65dfa6e27 100644 --- a/website/docs/guides/markdown-features/markdown-features-assets.mdx +++ b/website/docs/guides/markdown-features/markdown-features-assets.mdx @@ -1,10 +1,11 @@ --- id: assets -title: Assets description: Handling assets in Docusaurus Markdown slug: /markdown-features/assets --- +# Assets + import BrowserWindow from '@site/src/components/BrowserWindow'; import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; diff --git a/website/docs/guides/markdown-features/markdown-features-code-blocks.mdx b/website/docs/guides/markdown-features/markdown-features-code-blocks.mdx index ff817c1c952a7..3661393dea7e3 100644 --- a/website/docs/guides/markdown-features/markdown-features-code-blocks.mdx +++ b/website/docs/guides/markdown-features/markdown-features-code-blocks.mdx @@ -1,10 +1,11 @@ --- id: code-blocks -title: Code blocks description: Handling code blocks in Docusaurus Markdown slug: /markdown-features/code-blocks --- +# Code blocks + import BrowserWindow from '@site/src/components/BrowserWindow'; import CodeBlock from '@theme/CodeBlock'; diff --git a/website/docs/guides/markdown-features/markdown-features-head-metadata.mdx b/website/docs/guides/markdown-features/markdown-features-head-metadata.mdx index 66fd5748c5e9f..8d4669505bf97 100644 --- a/website/docs/guides/markdown-features/markdown-features-head-metadata.mdx +++ b/website/docs/guides/markdown-features/markdown-features-head-metadata.mdx @@ -1,6 +1,5 @@ --- id: head-metadata -title: Head Metadata description: Declaring page-specific head metadata through MDX slug: /markdown-features/head-metadata --- diff --git a/website/docs/guides/markdown-features/markdown-features-intro.mdx b/website/docs/guides/markdown-features/markdown-features-intro.mdx index afefc966a2ed1..5ba73bbf6d6d8 100644 --- a/website/docs/guides/markdown-features/markdown-features-intro.mdx +++ b/website/docs/guides/markdown-features/markdown-features-intro.mdx @@ -1,11 +1,11 @@ --- id: introduction -title: Markdown Features -sidebar_label: Introduction description: Docusaurus uses MDX. Find out more about Docusaurus-specific features when writing Markdown. slug: /markdown-features --- +# Markdown Features + import BrowserWindow from '@site/src/components/BrowserWindow'; Documentation is one of your product's interfaces with your users. A well-written and well-organized set of docs helps your users understand your product quickly. Our aligned goal here is to help your users find and understand the information they need, as quickly as possible. diff --git a/website/docs/guides/markdown-features/markdown-features-math-equations.mdx b/website/docs/guides/markdown-features/markdown-features-math-equations.mdx index e3281d6fd6ad1..1f6e322825184 100644 --- a/website/docs/guides/markdown-features/markdown-features-math-equations.mdx +++ b/website/docs/guides/markdown-features/markdown-features-math-equations.mdx @@ -1,10 +1,11 @@ --- id: math-equations -title: Math Equations description: Writing LaTeX Math Equations slug: /markdown-features/math-equations --- +# Math Equations + import BrowserWindow from '@site/src/components/BrowserWindow'; Mathematical equations can be rendered using [KaTeX](https://katex.org). diff --git a/website/docs/guides/markdown-features/markdown-features-plugins.mdx b/website/docs/guides/markdown-features/markdown-features-plugins.mdx index 7c78af39d8e8a..6a7a3629c1061 100644 --- a/website/docs/guides/markdown-features/markdown-features-plugins.mdx +++ b/website/docs/guides/markdown-features/markdown-features-plugins.mdx @@ -1,10 +1,11 @@ --- id: plugins -title: MDX Plugins description: Using MDX plugins to expand Docusaurus Markdown functionalities slug: /markdown-features/plugins --- +# MDX Plugins + Sometimes, you may want to extend or tweak your Markdown syntax. For example: - How do I embed youtube videos using the image syntax (`![](https://youtu.be/yKNxeF4KMsY)`)? diff --git a/website/docs/guides/markdown-features/markdown-features-react.mdx b/website/docs/guides/markdown-features/markdown-features-react.mdx index ca1588df16b1a..0a3e31ba6dd43 100644 --- a/website/docs/guides/markdown-features/markdown-features-react.mdx +++ b/website/docs/guides/markdown-features/markdown-features-react.mdx @@ -1,6 +1,5 @@ --- id: react -title: MDX and React description: Using the power of React in Docusaurus Markdown documents, thanks to MDX slug: /markdown-features/react --- diff --git a/website/docs/guides/markdown-features/markdown-features-tabs.mdx b/website/docs/guides/markdown-features/markdown-features-tabs.mdx index 40987d28e4796..897f54a8a7c04 100644 --- a/website/docs/guides/markdown-features/markdown-features-tabs.mdx +++ b/website/docs/guides/markdown-features/markdown-features-tabs.mdx @@ -1,10 +1,11 @@ --- id: tabs -title: Tabs description: Using tabs inside Docusaurus Markdown slug: /markdown-features/tabs --- +# Tabs + ```mdx-code-block import BrowserWindow from '@site/src/components/BrowserWindow'; import Tabs from '@theme/Tabs'; diff --git a/website/docs/i18n/i18n-crowdin.mdx b/website/docs/i18n/i18n-crowdin.mdx index 60afe1f10b229..c7f0ca21930bd 100644 --- a/website/docs/i18n/i18n-crowdin.mdx +++ b/website/docs/i18n/i18n-crowdin.mdx @@ -1,10 +1,11 @@ --- id: crowdin -title: i18n - Using Crowdin slug: /i18n/crowdin toc_max_heading_level: 4 --- +# i18n - Using Crowdin + The i18n system of Docusaurus is **decoupled from any translation software**. You can integrate Docusaurus with the **tools and SaaS of your choice**, as long as you put the **translation files at the correct location**. diff --git a/website/docs/i18n/i18n-git.md b/website/docs/i18n/i18n-git.md index 12c8f157995f9..18f3094aa2624 100644 --- a/website/docs/i18n/i18n-git.md +++ b/website/docs/i18n/i18n-git.md @@ -1,9 +1,10 @@ --- id: git -title: i18n - Using git slug: /i18n/git --- +# i18n - Using git + A **possible translation strategy** is to **version control the translation files** with Git (or any other [VCS](https://en.wikipedia.org/wiki/Version_control)). ## Tradeoffs {#tradeoffs} diff --git a/website/docs/i18n/i18n-introduction.md b/website/docs/i18n/i18n-introduction.md index 610e8304175d2..3cfa077af6f2b 100644 --- a/website/docs/i18n/i18n-introduction.md +++ b/website/docs/i18n/i18n-introduction.md @@ -1,9 +1,10 @@ --- id: introduction -title: i18n - Introduction slug: /i18n/introduction --- +# i18n - Introduction + It is **easy to translate a Docusaurus website** with its internationalization ([i18n](https://en.wikipedia.org/wiki/Internationalization_and_localization)) support. ## Goals {#goals} diff --git a/website/docs/i18n/i18n-tutorial.md b/website/docs/i18n/i18n-tutorial.md index c8e051ab32584..d04b61744bec4 100644 --- a/website/docs/i18n/i18n-tutorial.md +++ b/website/docs/i18n/i18n-tutorial.md @@ -1,9 +1,11 @@ --- id: tutorial -title: i18n - Tutorial +description: This tutorial will walk you through the basics of the Docusaurus i18n system. slug: /i18n/tutorial --- +# i18n - Tutorial + ```mdx-code-block import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; diff --git a/website/docs/installation.md b/website/docs/installation.md index 92576624eec1c..442d758f7d181 100644 --- a/website/docs/installation.md +++ b/website/docs/installation.md @@ -1,8 +1,9 @@ --- -id: installation -title: Installation +description: How to install Docusaurus locally, and start a Docusaurus site in no time. --- +# Installation + ```mdx-code-block import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; diff --git a/website/docs/introduction.md b/website/docs/introduction.md index cec5f22c2e08f..c5f4d0106f420 100644 --- a/website/docs/introduction.md +++ b/website/docs/introduction.md @@ -1,10 +1,10 @@ --- -id: introduction -title: Introduction description: Docusaurus was designed from the ground up to be easily installed and used to get your website up and running quickly. slug: / --- +# Introduction + ⚡️ Docusaurus will help you ship a **beautiful documentation site in no time**. 💸 Building a custom tech stack is expensive. Instead, **focus on your content** and just write Markdown files. diff --git a/website/docs/migration/migration-automated.md b/website/docs/migration/migration-automated.md index a4422db65d1e7..65f95cfdaf5aa 100644 --- a/website/docs/migration/migration-automated.md +++ b/website/docs/migration/migration-automated.md @@ -1,9 +1,9 @@ --- -id: migration-automated -title: Automated migration slug: /migration/automated --- +# Automated migration + The migration CLI automatically migrates your v1 website to a v2 website. :::info diff --git a/website/docs/migration/migration-manual.md b/website/docs/migration/migration-manual.md index a10451db78a28..aa641852976a4 100644 --- a/website/docs/migration/migration-manual.md +++ b/website/docs/migration/migration-manual.md @@ -1,10 +1,10 @@ --- -id: migration-manual -title: Manual migration slug: /migration/manual toc_max_heading_level: 4 --- +# Manual migration + This manual migration process should be run after the [automated migration process](./migration-automated.md), to complete the missing parts, or debug issues in the migration CLI output. ## Project setup {#project-setup} diff --git a/website/docs/migration/migration-overview.md b/website/docs/migration/migration-overview.md index 14e9b967694c5..efed50c1acd83 100644 --- a/website/docs/migration/migration-overview.md +++ b/website/docs/migration/migration-overview.md @@ -1,9 +1,9 @@ --- -id: migration-overview -title: Migration overview slug: /migration --- +# Migration overview + This doc guides you through migrating an existing Docusaurus 1 site to Docusaurus 2. We try to make this as easy as possible, and provide a migration cli. diff --git a/website/docs/migration/migration-translated-sites.md b/website/docs/migration/migration-translated-sites.md index 9403f86c6de49..9964943f16e27 100644 --- a/website/docs/migration/migration-translated-sites.md +++ b/website/docs/migration/migration-translated-sites.md @@ -1,9 +1,9 @@ --- -id: migration-translated-sites -title: Translated sites slug: /migration/translated-sites --- +# Translated sites + This page explains how migrate a translated Docusaurus v1 site to Docusaurus v2. ## i18n differences {#i18n-differences} diff --git a/website/docs/migration/migration-versioned-sites.md b/website/docs/migration/migration-versioned-sites.md index 98eae9ef20ea6..e21dc802fb063 100644 --- a/website/docs/migration/migration-versioned-sites.md +++ b/website/docs/migration/migration-versioned-sites.md @@ -1,9 +1,9 @@ --- -id: migration-versioned-sites -title: Versioned sites slug: /migration/versioned-sites --- +# Versioned sites + Read up https://docusaurus.io/blog/2018/09/11/Towards-Docusaurus-2#versioning first for problems in v1's approach. :::note diff --git a/website/docs/search.md b/website/docs/search.md index d3b27ec96cabc..e00e022cfaca3 100644 --- a/website/docs/search.md +++ b/website/docs/search.md @@ -1,11 +1,11 @@ --- -id: search -title: Search keywords: - algolia - search --- +# Search + There are a few options you can use to add search to your website: - 🥇 [Algolia DocSearch](#using-algolia-docsearch) (**official**) diff --git a/website/docs/seo.md b/website/docs/seo.md index 3c61f7fae51b8..578bb7761c303 100644 --- a/website/docs/seo.md +++ b/website/docs/seo.md @@ -1,12 +1,13 @@ --- -id: seo -title: Search engine optimization (SEO) +description: How to make your Docusaurus site maximally search-engine-friendly. sidebar_label: SEO keywords: - seo - positioning --- +# Search engine optimization (SEO) + import BrowserWindow from '@site/src/components/BrowserWindow'; Docusaurus supports search engine optimization in a variety of ways. diff --git a/website/docs/static-assets.md b/website/docs/static-assets.md index ec2660c42d759..08fbacb9e58e7 100644 --- a/website/docs/static-assets.md +++ b/website/docs/static-assets.md @@ -1,11 +1,12 @@ --- -id: static-assets -title: Static Assets +description: Static assets are the non-code files that are directly copied to the build output. Learn about how they are handled and what the best practices of using static assets are. --- -Every website needs assets: images, stylesheets, favicons, etc. By default, you are suggested to put these assets in the `static` folder. +# Static Assets -Every file you put into **that directory will be copied** into the root of the generated `build` folder with the directory hierarchy preserved. E.g. if you add a file named `sun.jpg` to the static folder, it will be copied to `build/sun.jpg`. +Static assets are the non-code files that are directly copied to the build output. They include images, stylesheets, favicons, fonts, etc. + +By default, you are suggested to put these assets in the `static` folder. Every file you put into **that directory will be copied** into the root of the generated `build` folder with the directory hierarchy preserved. E.g. if you add a file named `sun.jpg` to the static folder, it will be copied to `build/sun.jpg`. This means that: diff --git a/website/docs/styling-layout.md b/website/docs/styling-layout.md index b6cba21b2e5de..b9cee786b7112 100644 --- a/website/docs/styling-layout.md +++ b/website/docs/styling-layout.md @@ -1,11 +1,11 @@ --- -id: styling-layout -title: Styling and Layout description: A Docusaurus site is a pre-rendered single-page React application. You can style it the way you style React apps. --- import ColorGenerator from '@site/src/components/ColorGenerator'; +# Styling and Layout + :::tip This section is focused on styling through stylesheets. For more advanced customizations (DOM structure, React code...), refer to the [swizzling guide](./swizzling.md). diff --git a/website/docs/typescript-support.md b/website/docs/typescript-support.md index 8bd87a1f89602..c8d7c117c6e58 100644 --- a/website/docs/typescript-support.md +++ b/website/docs/typescript-support.md @@ -1,8 +1,9 @@ --- -id: typescript-support -title: TypeScript Support +description: Docusaurus is written in TypeScript and provides first-class TypeScript support. --- +# TypeScript Support + Docusaurus is written in TypeScript and provides first-class TypeScript support. ## Initialization {#initialization}