@docusaurus/theme-classic 2.0.0-beta.15d451942 → 2.0.0-beta.16

package/{lib-next/validateThemeConfig.js → src/validateThemeConfig.ts}

@@ -5,7 +5,8 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-const {Joi, URISchema} = require('@docusaurus/utils-validation');
+import {Joi, URISchema} from '@docusaurus/utils-validation';
+import type {ThemeConfig, Validate, ValidationResult} from '@docusaurus/types';
 
 const DEFAULT_DOCS_CONFIG = {
   versionPersistence: 'localStorage',
@@ -28,10 +29,10 @@ const DEFAULT_COLOR_MODE_CONFIG = {
   },
 };
 
-const DEFAULT_CONFIG = {
+export const DEFAULT_CONFIG = {
   colorMode: DEFAULT_COLOR_MODE_CONFIG,
   docs: DEFAULT_DOCS_CONFIG,
-  metadatas: [],
+  metadata: [],
   prism: {
     additionalLanguages: [],
   },
@@ -40,84 +41,62 @@ const DEFAULT_CONFIG = {
     items: [],
   },
   hideableSidebar: false,
+  autoCollapseSidebarCategories: false,
+  tableOfContents: {
+    minHeadingLevel: 2,
+    maxHeadingLevel: 3,
+  },
 };
-exports.DEFAULT_CONFIG = DEFAULT_CONFIG;
 
 const NavbarItemPosition = Joi.string().equal('left', 'right').default('left');
 
-const BaseNavbarItemSchema = Joi.object({
-  to: Joi.string(),
-  href: URISchema,
+const NavbarItemBaseSchema = Joi.object({
   label: Joi.string(),
   className: Joi.string(),
-  prependBaseUrlToHref: Joi.string(),
 })
-  // We allow any unknown attributes on the links
-  // (users may need additional attributes like target, aria-role, data-customAttribute...)
+  // We allow any unknown attributes on the links (users may need additional
+  // attributes like target, aria-role, data-customAttribute...)
   .unknown();
 
-// TODO we should probably create a custom navbar item type "dropdown"
-// having this recursive structure is bad because we only support 2 levels
-// + parent/child don't have exactly the same props
-const DefaultNavbarItemSchema = BaseNavbarItemSchema.append({
-  items: Joi.array().optional().items(BaseNavbarItemSchema),
-  position: NavbarItemPosition,
+const DefaultNavbarItemSchema = NavbarItemBaseSchema.append({
+  to: Joi.string(),
+  href: URISchema,
   activeBasePath: Joi.string(),
   activeBaseRegex: Joi.string(),
-});
-// TODO the dropdown parent item can have no href/to
-// should check should not apply to dropdown parent item
-// .xor('href', 'to');
+  prependBaseUrlToHref: Joi.bool(),
+  // This is only triggered in case of a nested dropdown
+  items: Joi.forbidden().messages({
+    'any.unknown': 'Nested dropdowns are not allowed',
+  }),
+})
+  .xor('href', 'to')
+  .messages({
+    'object.xor': 'One and only one between "to" and "href" should be provided',
+  });
 
-const DocsVersionNavbarItemSchema = Joi.object({
+const DocsVersionNavbarItemSchema = NavbarItemBaseSchema.append({
   type: Joi.string().equal('docsVersion').required(),
-  position: NavbarItemPosition,
-  label: Joi.string(),
   to: Joi.string(),
   docsPluginId: Joi.string(),
-  className: Joi.string(),
 });
 
-const DocsVersionDropdownNavbarItemSchema = Joi.object({
-  type: Joi.string().equal('docsVersionDropdown').required(),
-  position: NavbarItemPosition,
-  docsPluginId: Joi.string(),
-  dropdownActiveClassDisabled: Joi.boolean(),
-  dropdownItemsBefore: Joi.array().items(BaseNavbarItemSchema).default([]),
-  dropdownItemsAfter: Joi.array().items(BaseNavbarItemSchema).default([]),
-  className: Joi.string(),
-});
-
-const DocItemSchema = Joi.object({
+const DocItemSchema = NavbarItemBaseSchema.append({
   type: Joi.string().equal('doc').required(),
-  position: NavbarItemPosition,
   docId: Joi.string().required(),
-  label: Joi.string(),
   docsPluginId: Joi.string(),
-  activeSidebarClassName: Joi.string().default('navbar__link--active'),
-  className: Joi.string(),
 });
 
-const LocaleDropdownNavbarItemSchema = Joi.object({
-  type: Joi.string().equal('localeDropdown').required(),
-  position: NavbarItemPosition,
-  dropdownItemsBefore: Joi.array().items(BaseNavbarItemSchema).default([]),
-  dropdownItemsAfter: Joi.array().items(BaseNavbarItemSchema).default([]),
-  className: Joi.string(),
-});
-
-const SearchItemSchema = Joi.object({
-  type: Joi.string().equal('search').required(),
-  position: NavbarItemPosition,
+const DocSidebarItemSchema = NavbarItemBaseSchema.append({
+  type: Joi.string().equal('docSidebar').required(),
+  sidebarId: Joi.string().required(),
+  docsPluginId: Joi.string(),
 });
 
-// Can this be made easier? :/
-const isOfType = (type) => {
-  let typeSchema = Joi.string().required();
+const itemWithType = (type: string | undefined) => {
   // because equal(undefined) is not supported :/
-  if (type) {
-    typeSchema = typeSchema.equal(type);
-  }
+  const typeSchema = type
+    ? Joi.string().required().equal(type)
+    : Joi.string().forbidden();
   return Joi.object({
     type: typeSchema,
   })
@@ -125,58 +104,113 @@ const isOfType = (type) => {
     .required();
 };
 
-const NavbarItemSchema = Joi.object().when({
+const DropdownSubitemSchema = Joi.object({
+  position: Joi.forbidden(),
+}).when('.', {
   switch: [
     {
-      is: isOfType('docsVersion'),
+      is: itemWithType('docsVersion'),
       then: DocsVersionNavbarItemSchema,
     },
     {
-      is: isOfType('docsVersionDropdown'),
-      then: DocsVersionDropdownNavbarItemSchema,
-    },
-    {
-      is: isOfType('doc'),
+      is: itemWithType('doc'),
       then: DocItemSchema,
     },
     {
-      is: isOfType('localeDropdown'),
-      then: LocaleDropdownNavbarItemSchema,
+      is: itemWithType('docSidebar'),
+      then: DocSidebarItemSchema,
     },
     {
-      is: isOfType('search'),
-      then: SearchItemSchema,
+      is: itemWithType(undefined),
+      then: DefaultNavbarItemSchema,
     },
     {
-      is: isOfType(undefined),
+      is: Joi.alternatives().try(
+        itemWithType('dropdown'),
+        itemWithType('docsVersionDropdown'),
+        itemWithType('localeDropdown'),
+        itemWithType('search'),
+      ),
       then: Joi.forbidden().messages({
-        'any.unknown': 'Bad navbar item type {.type}',
+        'any.unknown': 'Nested dropdowns are not allowed',
       }),
     },
   ],
-  otherwise: DefaultNavbarItemSchema,
+  otherwise: Joi.forbidden().messages({
+    'any.unknown': 'Bad navbar item type {.type}',
+  }),
 });
 
-/*
-const NavbarItemSchema = Joi.object({
-  type: Joi.string().only(['docsVersion'])
-})
-  .when(Joi.object({ type: 'docsVersion' }).unknown(), {
-    then: Joi.object({ pepperoni: Joi.boolean() })
-  })
-  .when(Joi.object().unknown(), {
-    then: Joi.object({ croutons: Joi.boolean() })
-  })
+const DropdownNavbarItemSchema = NavbarItemBaseSchema.append({
+  items: Joi.array().items(DropdownSubitemSchema).required(),
+});
 
- */
+const DocsVersionDropdownNavbarItemSchema = NavbarItemBaseSchema.append({
+  type: Joi.string().equal('docsVersionDropdown').required(),
+  docsPluginId: Joi.string(),
+  dropdownActiveClassDisabled: Joi.boolean(),
+  dropdownItemsBefore: Joi.array().items(DropdownSubitemSchema).default([]),
+  dropdownItemsAfter: Joi.array().items(DropdownSubitemSchema).default([]),
+});
 
-/*
-const NavbarItemSchema = Joi.object().when('type', {
-  is: Joi.valid('docsVersion'),
-  then: DocsVersionNavbarItemSchema,
-  otherwise: DefaultNavbarItemSchema,
+const LocaleDropdownNavbarItemSchema = NavbarItemBaseSchema.append({
+  type: Joi.string().equal('localeDropdown').required(),
+  dropdownItemsBefore: Joi.array().items(DropdownSubitemSchema).default([]),
+  dropdownItemsAfter: Joi.array().items(DropdownSubitemSchema).default([]),
+});
+
+const SearchItemSchema = Joi.object({
+  type: Joi.string().equal('search').required(),
+});
+
+const NavbarItemSchema = Joi.object({
+  position: NavbarItemPosition,
+}).when('.', {
+  switch: [
+    {
+      is: itemWithType('docsVersion'),
+      then: DocsVersionNavbarItemSchema,
+    },
+    {
+      is: itemWithType('dropdown'),
+      then: DropdownNavbarItemSchema,
+    },
+    {
+      is: itemWithType('docsVersionDropdown'),
+      then: DocsVersionDropdownNavbarItemSchema,
+    },
+    {
+      is: itemWithType('doc'),
+      then: DocItemSchema,
+    },
+    {
+      is: itemWithType('docSidebar'),
+      then: DocSidebarItemSchema,
+    },
+    {
+      is: itemWithType('localeDropdown'),
+      then: LocaleDropdownNavbarItemSchema,
+    },
+    {
+      is: itemWithType('search'),
+      then: SearchItemSchema,
+    },
+    {
+      is: itemWithType(undefined),
+      then: Joi.object().when('.', {
+        // Dropdown item can be specified without type field
+        is: Joi.object({
+          items: Joi.array().required(),
+        }).unknown(),
+        then: DropdownNavbarItemSchema,
+        otherwise: DefaultNavbarItemSchema,
+      }),
+    },
+  ],
+  otherwise: Joi.forbidden().messages({
+    'any.unknown': 'Bad navbar item type {.type}',
+  }),
 });
- */
 
 const ColorModeSchema = Joi.object({
   defaultMode: Joi.string()
@@ -221,22 +255,22 @@ const FooterLinkItemSchema = Joi.object({
   .with('to', 'label')
   .with('href', 'label')
   .nand('html', 'label')
-  // We allow any unknown attributes on the links
-  // (users may need additional attributes like target, aria-role, data-customAttribute...)
+  // We allow any unknown attributes on the links (users may need additional
+  // attributes like target, aria-role, data-customAttribute...)
   .unknown();
 
 const CustomCssSchema = Joi.alternatives()
   .try(Joi.array().items(Joi.string().required()), Joi.string().required())
   .optional();
 
-const ThemeConfigSchema = Joi.object({
+export const ThemeConfigSchema = Joi.object({
   // TODO temporary (@alpha-58)
-  disableDarkMode: Joi.any().forbidden(false).messages({
+  disableDarkMode: Joi.any().forbidden().messages({
     'any.unknown':
       'disableDarkMode theme config is deprecated. Please use the new colorMode attribute. You likely want: config.themeConfig.colorMode.disableSwitch = true',
   }),
   // TODO temporary (@alpha-58)
-  defaultDarkMode: Joi.any().forbidden(false).messages({
+  defaultDarkMode: Joi.any().forbidden().messages({
     'any.unknown':
       'defaultDarkMode theme config is deprecated. Please use the new colorMode attribute. You likely want: config.themeConfig.colorMode.defaultMode = "dark"',
   }),
@@ -244,14 +278,20 @@ const ThemeConfigSchema = Joi.object({
   colorMode: ColorModeSchema,
   image: Joi.string(),
   docs: DocsSchema,
-  metadatas: Joi.array()
+  metadata: Joi.array()
     .items(HtmlMetadataSchema)
-    .default(DEFAULT_CONFIG.metadatas),
+    .default(DEFAULT_CONFIG.metadata),
+  // cSpell:ignore metadatas
+  metadatas: Joi.any().forbidden().messages({
+    'any.unknown':
+      // cSpell:ignore metadatas
+      'themeConfig.metadatas has been renamed as themeConfig.metadata. See https://github.com/facebook/docusaurus/pull/5871',
+  }),
   announcementBar: Joi.object({
     id: Joi.string().default('announcement-bar'),
-    content: Joi.string(),
-    backgroundColor: Joi.string().default('#fff'),
-    textColor: Joi.string().default('#000'),
+    content: Joi.string().required(),
+    backgroundColor: Joi.string(),
+    textColor: Joi.string(),
     isCloseable: Joi.bool().default(true),
   }).optional(),
   navbar: Joi.object({
@@ -270,6 +310,8 @@ const ThemeConfigSchema = Joi.object({
       alt: Joi.string().allow(''),
       src: Joi.string().required(),
       srcDark: Joi.string(),
+      width: Joi.alternatives().try(Joi.string(), Joi.number()),
+      height: Joi.alternatives().try(Joi.string(), Joi.number()),
       href: Joi.string(),
       target: Joi.string(),
     }),
@@ -280,16 +322,24 @@ const ThemeConfigSchema = Joi.object({
       alt: Joi.string().allow(''),
       src: Joi.string(),
       srcDark: Joi.string(),
+      // TODO infer this from reading the image
+      width: Joi.alternatives().try(Joi.string(), Joi.number()),
+      height: Joi.alternatives().try(Joi.string(), Joi.number()),
       href: Joi.string(),
     }),
     copyright: Joi.string(),
-    links: Joi.array()
-      .items(
+    links: Joi.alternatives(
+      Joi.array().items(
         Joi.object({
-          title: Joi.string().allow(null),
+          title: Joi.string().allow(null).default(null),
           items: Joi.array().items(FooterLinkItemSchema).default([]),
         }),
-      )
+      ),
+      Joi.array().items(FooterLinkItemSchema),
+    )
+      .messages({
+        'alternatives.match': `The footer must be either simple or multi-column, and not a mix of the two. See: https://docusaurus.io/docs/api/themes/configuration#footer-links`,
+      })
       .default([]),
   }).optional(),
   prism: Joi.object({
@@ -309,9 +359,39 @@ const ThemeConfigSchema = Joi.object({
     .default(DEFAULT_CONFIG.prism)
     .unknown(),
   hideableSidebar: Joi.bool().default(DEFAULT_CONFIG.hideableSidebar),
+  autoCollapseSidebarCategories: Joi.bool().default(
+    DEFAULT_CONFIG.autoCollapseSidebarCategories,
+  ),
+  sidebarCollapsible: Joi.forbidden().messages({
+    'any.unknown':
+      'The themeConfig.sidebarCollapsible has been moved to docs plugin options. See: https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-content-docs',
+  }),
+  tableOfContents: Joi.object({
+    minHeadingLevel: Joi.number()
+      .default(DEFAULT_CONFIG.tableOfContents.minHeadingLevel)
+      .when('maxHeadingLevel', {
+        is: Joi.exist(),
+        then: Joi.number()
+          .integer()
+          .min(2)
+          .max(6)
+          .max(Joi.ref('maxHeadingLevel')),
+        otherwise: Joi.number().integer().min(2).max(6),
+      }),
+    maxHeadingLevel: Joi.number()
+      .integer()
+      .min(2)
+      .max(6)
+      .default(DEFAULT_CONFIG.tableOfContents.maxHeadingLevel),
+  }).default(DEFAULT_CONFIG.tableOfContents),
 });
-exports.ThemeConfigSchema = ThemeConfigSchema;
 
-exports.validateThemeConfig = ({validate, themeConfig}) => {
+export function validateThemeConfig({
+  validate,
+  themeConfig,
+}: {
+  validate: Validate<ThemeConfig>;
+  themeConfig: ThemeConfig;
+}): ValidationResult<ThemeConfig> {
   return validate(ThemeConfigSchema, themeConfig);
-};
+}

package/babel.config.js

@@ -1,35 +0,0 @@
-/**
- * Copyright (c) Facebook, Inc. and its affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-module.exports = {
-  env: {
-    // USED FOR NODE/RUNTIME
-    // maybe we should differenciate both cases because
-    // we mostly need to transpile some features so that node does not crash...
-    lib: {
-      presets: [
-        ['@babel/preset-typescript', {isTSX: true, allExtensions: true}],
-      ],
-      // Useful to transpile for older node versions
-      plugins: [
-        '@babel/plugin-transform-modules-commonjs',
-        '@babel/plugin-proposal-nullish-coalescing-operator',
-        '@babel/plugin-proposal-optional-chaining',
-      ],
-    },
-
-    // USED FOR JS SWIZZLE
-    // /lib-next folder is used as source to swizzle JS source code
-    // This JS code is created from TS source code
-    // This source code should look clean/human readable to be usable
-    'lib-next': {
-      presets: [
-        ['@babel/preset-typescript', {isTSX: true, allExtensions: true}],
-      ],
-    },
-  },
-};

package/codeTranslations/README.md

@@ -1,20 +0,0 @@
-# Default theme translations
-
-The Docusaurus theme includes default translations for labels used by the theme itself (like the pagination "Next" / "Previous").
-
-## For Docusaurus users:
-
-Please help us provide exhaustive translations:
-
-- add your `language.json` file if it is missing (copy `base.json` and remove the attributes `___DESCRIPTION`)
-- double-check your `language.json` file for bad or missing translations
-
-## For maintainers:
-
-After updating the theme code, you can "synchronize" the translations by running:
-
-```
-yarn workspace @docusaurus/theme-classic update-code-translations
-```
-
-Then, ask contributors to translate the newly added labels on this [issue](https://github.com/facebook/docusaurus/issues/3526)

package/codeTranslations/ar.json

@@ -1,55 +0,0 @@
-{
-  "theme.AnnouncementBar.closeButtonAriaLabel": "إغلاق",
-  "theme.CodeBlock.copied": "تم النسخ",
-  "theme.CodeBlock.copy": "نسخ",
-  "theme.CodeBlock.copyButtonAriaLabel": "نسخ الرمز إلى الحافظة",
-  "theme.NotFound.p1": "لم نتمكن من العثور على ما كنت تبحث عنه.",
-  "theme.NotFound.p2": "يرجى الاتصال بمالك الموقع الذي ربطك بعنوان URL الأصلي وإخباره بأن الارتباط الخاص به معطل.",
-  "theme.NotFound.title": "الصفحة غير موجودة",
-  "theme.Playground.liveEditor": "محرر مباشر",
-  "theme.Playground.result": "النتيجة",
-  "theme.PwaReloadPopup.closeButtonAriaLabel": "إغلاق",
-  "theme.PwaReloadPopup.info": "نسخة جديدة متاحة",
-  "theme.PwaReloadPopup.refreshButtonText": "تحديث",
-  "theme.SearchBar.label": "بحث",
-  "theme.SearchPage.algoliaLabel": "البحث بواسطه Algolia",
-  "theme.SearchPage.documentsFound.plurals": "One document found|{count} documents found",
-  "theme.SearchPage.emptyResultsTitle": "ابحث في الوثائق",
-  "theme.SearchPage.existingResultsTitle": "نتائج البحث عن \"{query}\"",
-  "theme.SearchPage.fetchingNewResults": "جلب نتائج جديدة ...",
-  "theme.SearchPage.inputLabel": "بحث",
-  "theme.SearchPage.inputPlaceholder": "اكتب ما تبحث عنه هنا",
-  "theme.SearchPage.noResultsText": "لم يتم العثور على نتائج",
-  "theme.blog.paginator.navAriaLabel": "التنقل في صفحة قائمة المدونة",
-  "theme.blog.paginator.newerEntries": "إدخالات أحدث",
-  "theme.blog.paginator.olderEntries": "إدخالات أقدم",
-  "theme.blog.post.paginator.navAriaLabel": "التنقل في صفحة مقالات المدونة",
-  "theme.blog.post.paginator.newerPost": "مقالات أحدث",
-  "theme.blog.post.paginator.olderPost": "مقالات أقدم",
-  "theme.blog.post.plurals": "مقاله واحده|{count} مقالات",
-  "theme.blog.post.readMore": "اقرأ المزيد",
-  "theme.blog.post.readingTime.plurals": "{readingTime} دقائق قراءة|{readingTime} دقائق قراءة",
-  "theme.blog.tagTitle": "{nPosts} موسومة ب \"{tagName}\"",
-  "theme.common.editThisPage": "تعديل هذه الصفحة",
-  "theme.common.headingLinkTitle": "ارتباط مباشر بالعنوان",
-  "theme.common.skipToMainContent": "انتقل إلى المحتوى الرئيسي",
-  "theme.docs.paginator.navAriaLabel": "التنقل بين صفحات المستندات",
-  "theme.docs.paginator.next": "التالى",
-  "theme.docs.paginator.previous": "السابق",
-  "theme.docs.sidebar.collapseButtonAriaLabel": "طي الشريط الجانبي",
-  "theme.docs.sidebar.collapseButtonTitle": "طي الشريط الجانبي",
-  "theme.docs.sidebar.expandButtonAriaLabel": "توسيع الشريط الجانبي",
-  "theme.docs.sidebar.expandButtonTitle": "توسيع الشريط الجانبي",
-  "theme.docs.sidebar.responsiveCloseButtonLabel": "إغلاق القائمة",
-  "theme.docs.sidebar.responsiveOpenButtonLabel": "فتح القائمة",
-  "theme.docs.versions.latestVersionLinkLabel": "احدث اصدار",
-  "theme.docs.versions.latestVersionSuggestionLabel": "للحصول على أحدث الوثائق، راجع {latestVersionLink} ({versionLabel}).",
-  "theme.docs.versions.unmaintainedVersionLabel": "هذه هي وثائق {siteTitle} {versionLabel}، التي لم تعد تتم صيانتها بشكل نشط.",
-  "theme.docs.versions.unreleasedVersionLabel": "هذه وثائق لم يتم طرحها لإصدار {siteTitle} {versionLabel}.",
-  "theme.lastUpdated.atDate": " في {date}",
-  "theme.lastUpdated.byUser": " بواسطة {user}",
-  "theme.lastUpdated.lastUpdatedAtBy": "آخر تحديث{atDate}{byUser}",
-  "theme.tags.tagsListLabel": "الوسوم:",
-  "theme.tags.tagsPageLink": "عرض كل الوسوم",
-  "theme.tags.tagsPageTitle": "الوسوم"
-}

package/codeTranslations/base.json

@@ -1,108 +0,0 @@
-{
-  "theme.AnnouncementBar.closeButtonAriaLabel": "Close",
-  "theme.AnnouncementBar.closeButtonAriaLabel___DESCRIPTION": "The ARIA label for close button of announcement bar",
-  "theme.CodeBlock.copied": "Copied",
-  "theme.CodeBlock.copied___DESCRIPTION": "The copied button label on code blocks",
-  "theme.CodeBlock.copy": "Copy",
-  "theme.CodeBlock.copy___DESCRIPTION": "The copy button label on code blocks",
-  "theme.CodeBlock.copyButtonAriaLabel": "Copy code to clipboard",
-  "theme.CodeBlock.copyButtonAriaLabel___DESCRIPTION": "The ARIA label for copy code blocks button",
-  "theme.NotFound.p1": "We could not find what you were looking for.",
-  "theme.NotFound.p1___DESCRIPTION": "The first paragraph of the 404 page",
-  "theme.NotFound.p2": "Please contact the owner of the site that linked you to the original URL and let them know their link is broken.",
-  "theme.NotFound.p2___DESCRIPTION": "The 2nd paragraph of the 404 page",
-  "theme.NotFound.title": "Page Not Found",
-  "theme.NotFound.title___DESCRIPTION": "The title of the 404 page",
-  "theme.Playground.liveEditor": "Live Editor",
-  "theme.Playground.liveEditor___DESCRIPTION": "The live editor label of the live codeblocks",
-  "theme.Playground.result": "Result",
-  "theme.Playground.result___DESCRIPTION": "The result label of the live codeblocks",
-  "theme.PwaReloadPopup.closeButtonAriaLabel": "Close",
-  "theme.PwaReloadPopup.closeButtonAriaLabel___DESCRIPTION": "The ARIA label for close button of PWA reload popup",
-  "theme.PwaReloadPopup.info": "New version available",
-  "theme.PwaReloadPopup.info___DESCRIPTION": "The text for PWA reload popup",
-  "theme.PwaReloadPopup.refreshButtonText": "Refresh",
-  "theme.PwaReloadPopup.refreshButtonText___DESCRIPTION": "The text for PWA reload button",
-  "theme.SearchBar.label": "Search",
-  "theme.SearchBar.label___DESCRIPTION": "The ARIA label and placeholder for search button",
-  "theme.SearchPage.algoliaLabel": "Search by Algolia",
-  "theme.SearchPage.algoliaLabel___DESCRIPTION": "The ARIA label for Algolia mention",
-  "theme.SearchPage.documentsFound.plurals": "One document found|{count} documents found",
-  "theme.SearchPage.documentsFound.plurals___DESCRIPTION": "Pluralized label for \"{count} documents found\". Use as much plural forms (separated by \"|\") as your language support (see https://www.unicode.org/cldr/cldr-aux/charts/34/supplemental/language_plural_rules.html)",
-  "theme.SearchPage.emptyResultsTitle": "Search the documentation",
-  "theme.SearchPage.emptyResultsTitle___DESCRIPTION": "The search page title for empty query",
-  "theme.SearchPage.existingResultsTitle": "Search results for \"{query}\"",
-  "theme.SearchPage.existingResultsTitle___DESCRIPTION": "The search page title for non-empty query",
-  "theme.SearchPage.fetchingNewResults": "Fetching new results...",
-  "theme.SearchPage.fetchingNewResults___DESCRIPTION": "The paragraph for fetching new search results",
-  "theme.SearchPage.inputLabel": "Search",
-  "theme.SearchPage.inputLabel___DESCRIPTION": "The ARIA label for search page input",
-  "theme.SearchPage.inputPlaceholder": "Type your search here",
-  "theme.SearchPage.inputPlaceholder___DESCRIPTION": "The placeholder for search page input",
-  "theme.SearchPage.noResultsText": "No results were found",
-  "theme.SearchPage.noResultsText___DESCRIPTION": "The paragraph for empty search result",
-  "theme.blog.paginator.navAriaLabel": "Blog list page navigation",
-  "theme.blog.paginator.navAriaLabel___DESCRIPTION": "The ARIA label for the blog pagination",
-  "theme.blog.paginator.newerEntries": "Newer Entries",
-  "theme.blog.paginator.newerEntries___DESCRIPTION": "The label used to navigate to the newer blog posts page (previous page)",
-  "theme.blog.paginator.olderEntries": "Older Entries",
-  "theme.blog.paginator.olderEntries___DESCRIPTION": "The label used to navigate to the older blog posts page (next page)",
-  "theme.blog.post.paginator.navAriaLabel": "Blog post page navigation",
-  "theme.blog.post.paginator.navAriaLabel___DESCRIPTION": "The ARIA label for the blog posts pagination",
-  "theme.blog.post.paginator.newerPost": "Newer Post",
-  "theme.blog.post.paginator.newerPost___DESCRIPTION": "The blog post button label to navigate to the newer/previous post",
-  "theme.blog.post.paginator.olderPost": "Older Post",
-  "theme.blog.post.paginator.olderPost___DESCRIPTION": "The blog post button label to navigate to the older/next post",
-  "theme.blog.post.plurals": "One post|{count} posts",
-  "theme.blog.post.plurals___DESCRIPTION": "Pluralized label for \"{count} posts\". Use as much plural forms (separated by \"|\") as your language support (see https://www.unicode.org/cldr/cldr-aux/charts/34/supplemental/language_plural_rules.html)",
-  "theme.blog.post.readMore": "Read More",
-  "theme.blog.post.readMore___DESCRIPTION": "The label used in blog post item excerpts to link to full blog posts",
-  "theme.blog.post.readingTime.plurals": "One min read|{readingTime} min read",
-  "theme.blog.post.readingTime.plurals___DESCRIPTION": "Pluralized label for \"{readingTime} min read\". Use as much plural forms (separated by \"|\") as your language support (see https://www.unicode.org/cldr/cldr-aux/charts/34/supplemental/language_plural_rules.html)",
-  "theme.blog.tagTitle": "{nPosts} tagged with \"{tagName}\"",
-  "theme.blog.tagTitle___DESCRIPTION": "The title of the page for a blog tag",
-  "theme.common.editThisPage": "Edit this page",
-  "theme.common.editThisPage___DESCRIPTION": "The link label to edit the current page",
-  "theme.common.headingLinkTitle": "Direct link to heading",
-  "theme.common.headingLinkTitle___DESCRIPTION": "Title for link to heading",
-  "theme.common.skipToMainContent": "Skip to main content",
-  "theme.common.skipToMainContent___DESCRIPTION": "The skip to content label used for accessibility, allowing to rapidly navigate to main content with keyboard tab/enter navigation",
-  "theme.docs.paginator.navAriaLabel": "Docs pages navigation",
-  "theme.docs.paginator.navAriaLabel___DESCRIPTION": "The ARIA label for the docs pagination",
-  "theme.docs.paginator.next": "Next",
-  "theme.docs.paginator.next___DESCRIPTION": "The label used to navigate to the next doc",
-  "theme.docs.paginator.previous": "Previous",
-  "theme.docs.paginator.previous___DESCRIPTION": "The label used to navigate to the previous doc",
-  "theme.docs.sidebar.collapseButtonAriaLabel": "Collapse sidebar",
-  "theme.docs.sidebar.collapseButtonAriaLabel___DESCRIPTION": "The title attribute for collapse button of doc sidebar",
-  "theme.docs.sidebar.collapseButtonTitle": "Collapse sidebar",
-  "theme.docs.sidebar.collapseButtonTitle___DESCRIPTION": "The title attribute for collapse button of doc sidebar",
-  "theme.docs.sidebar.expandButtonAriaLabel": "Expand sidebar",
-  "theme.docs.sidebar.expandButtonAriaLabel___DESCRIPTION": "The ARIA label and title attribute for expand button of doc sidebar",
-  "theme.docs.sidebar.expandButtonTitle": "Expand sidebar",
-  "theme.docs.sidebar.expandButtonTitle___DESCRIPTION": "The ARIA label and title attribute for expand button of doc sidebar",
-  "theme.docs.sidebar.responsiveCloseButtonLabel": "Close menu",
-  "theme.docs.sidebar.responsiveCloseButtonLabel___DESCRIPTION": "The ARIA label for close button of mobile doc sidebar",
-  "theme.docs.sidebar.responsiveOpenButtonLabel": "Open menu",
-  "theme.docs.sidebar.responsiveOpenButtonLabel___DESCRIPTION": "The ARIA label for open button of mobile doc sidebar",
-  "theme.docs.versions.latestVersionLinkLabel": "latest version",
-  "theme.docs.versions.latestVersionLinkLabel___DESCRIPTION": "The label used for the latest version suggestion link label",
-  "theme.docs.versions.latestVersionSuggestionLabel": "For up-to-date documentation, see the {latestVersionLink} ({versionLabel}).",
-  "theme.docs.versions.latestVersionSuggestionLabel___DESCRIPTION": "The label userd to tell the user that he's browsing an unmaintained doc version",
-  "theme.docs.versions.unmaintainedVersionLabel": "This is documentation for {siteTitle} {versionLabel}, which is no longer actively maintained.",
-  "theme.docs.versions.unmaintainedVersionLabel___DESCRIPTION": "The label used to tell the user that he's browsing an unmaintained doc version",
-  "theme.docs.versions.unreleasedVersionLabel": "This is unreleased documentation for {siteTitle} {versionLabel} version.",
-  "theme.docs.versions.unreleasedVersionLabel___DESCRIPTION": "The label used to tell the user that he's browsing an unreleased doc version",
-  "theme.lastUpdated.atDate": " on {date}",
-  "theme.lastUpdated.atDate___DESCRIPTION": "The words used to describe on which date a page has been last updated",
-  "theme.lastUpdated.byUser": " by {user}",
-  "theme.lastUpdated.byUser___DESCRIPTION": "The words used to describe by who the page has been last updated",
-  "theme.lastUpdated.lastUpdatedAtBy": "Last updated{atDate}{byUser}",
-  "theme.lastUpdated.lastUpdatedAtBy___DESCRIPTION": "The sentence used to display when a page has been last updated, and by who",
-  "theme.tags.tagsListLabel": "Tags:",
-  "theme.tags.tagsListLabel___DESCRIPTION": "The label alongside a tag list",
-  "theme.tags.tagsPageLink": "View All Tags",
-  "theme.tags.tagsPageLink___DESCRIPTION": "The label of the link targeting the tag list page",
-  "theme.tags.tagsPageTitle": "Tags",
-  "theme.tags.tagsPageTitle___DESCRIPTION": "The title of the tag list page"
-}