diff --git a/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/2018/12/14/Happy-First-Birthday-Slash/index.html b/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/2018/12/14/Happy-First-Birthday-Slash/index.html index 1a3b803a8f..49dfac178e 100644 --- a/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/2018/12/14/Happy-First-Birthday-Slash/index.html +++ b/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/2018/12/14/Happy-First-Birthday-Slash/index.html @@ -11,7 +11,7 @@
-
Skip to main content
+
Skip to main content
diff --git a/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/date-matter/index.html b/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/date-matter/index.html index f56293ab02..8ebb7561b1 100644 --- a/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/date-matter/index.html +++ b/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/date-matter/index.html @@ -11,7 +11,7 @@
-
Skip to main content

date-matter

· One min read

date inside front matter

+
Skip to main content

date-matter

· One min read

date inside front matter

diff --git a/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/heading-as-title/index.html b/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/heading-as-title/index.html index 8e699a3d2d..ca57228852 100644 --- a/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/heading-as-title/index.html +++ b/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/heading-as-title/index.html @@ -11,7 +11,7 @@
-
Skip to main content

some heading

· 0 min read
+
Skip to main content

some heading

· 0 min read
diff --git a/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/hey/my super path/héllô/index.html b/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/hey/my super path/héllô/index.html index 99bfcb770a..9218b56b4e 100644 --- a/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/hey/my super path/héllô/index.html +++ b/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/hey/my super path/héllô/index.html @@ -11,7 +11,7 @@
-
Skip to main content

Complex Slug

· One min read

complex url slug

+
Skip to main content

Complex Slug

· One min read

complex url slug

diff --git a/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/mdx-blog-post/index.html b/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/mdx-blog-post/index.html index 0b8cd0bbf4..6aac38a41d 100644 --- a/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/mdx-blog-post/index.html +++ b/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/mdx-blog-post/index.html @@ -11,7 +11,7 @@
-
Skip to main content

Full Blog Sample

· One min read

HTML Heading 1

HTML Heading 2

HTML Paragraph

Import DOM

Heading 1

Heading 2​

Heading 3​

Heading 4​

Heading 5​
  • list1
  • list2
  • list3
  • list1
  • list2
  • list3

Normal Text Italics Text Bold Text

linkimage

+
Skip to main content

Full Blog Sample

· One min read

HTML Heading 1

HTML Heading 2

HTML Paragraph

Import DOM

Heading 1

Heading 2​

Heading 3​

Heading 4​

Heading 5​
  • list1
  • list2
  • list3
  • list1
  • list2
  • list3

Normal Text Italics Text Bold Text

linkimage

diff --git a/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/mdx-require-blog-post/index.html b/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/mdx-require-blog-post/index.html index 8d0ac938d8..ad5e9da1c1 100644 --- a/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/mdx-require-blog-post/index.html +++ b/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/mdx-require-blog-post/index.html @@ -11,7 +11,7 @@
-
Skip to main content

MDX Blog Sample with require calls

· One min read

Test MDX with require calls

+
Skip to main content

MDX Blog Sample with require calls

· One min read

Test MDX with require calls

diff --git a/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/simple/slug/index.html b/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/simple/slug/index.html index 1dd47a9943..7f0519e71c 100644 --- a/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/simple/slug/index.html +++ b/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/simple/slug/index.html @@ -11,7 +11,7 @@
-
Skip to main content

Simple Slug

· One min read

simple url slug

+
Skip to main content

Simple Slug

· One min read

simple url slug

diff --git a/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/unlisted/index.html b/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/unlisted/index.html index 7167942e8f..118d4b581f 100644 --- a/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/unlisted/index.html +++ b/packages/docusaurus-plugin-content-blog/src/__tests__/__fixtures__/website/build-snap/blog/unlisted/index.html @@ -11,7 +11,7 @@
-
Skip to main content

unlisted Slug

· One min read

this post is unlisted

+
Skip to main content

unlisted Slug

· One min read

this post is unlisted

diff --git a/packages/docusaurus-theme-common/src/utils/skipToContentUtils.tsx b/packages/docusaurus-theme-common/src/utils/skipToContentUtils.tsx index f1f7c37005..23924be346 100644 --- a/packages/docusaurus-theme-common/src/utils/skipToContentUtils.tsx +++ b/packages/docusaurus-theme-common/src/utils/skipToContentUtils.tsx @@ -14,8 +14,11 @@ import {useLocationChange} from './useLocationChange'; * The id of the element that should become focused on a page * that does not have a
html tag. * Focusing the Docusaurus Layout children is a reasonable fallback. + * + * __ prefix allows search crawlers (Algolia/DocSearch) to ignore anchors + * https://github.com/facebook/docusaurus/issues/8883#issuecomment-1516328368 */ -export const SkipToContentFallbackId = 'docusaurus_skipToContent_fallback'; +export const SkipToContentFallbackId = '__docusaurus_skipToContent_fallback'; /** * Returns the skip to content element to focus when the link is clicked. diff --git a/packages/docusaurus-utils-common/src/index.ts b/packages/docusaurus-utils-common/src/index.ts index b1bbfb5237..17b69e0727 100644 --- a/packages/docusaurus-utils-common/src/index.ts +++ b/packages/docusaurus-utils-common/src/index.ts @@ -5,7 +5,10 @@ * LICENSE file in the root directory of this source tree. */ -export const blogPostContainerID = 'post-content'; +// __ prefix allows search crawlers (Algolia/DocSearch) to ignore anchors +// https://github.com/facebook/docusaurus/issues/8883#issuecomment-1516328368 +export const blogPostContainerID = '__blog-post-container'; + export { default as applyTrailingSlash, type ApplyTrailingSlashParams, diff --git a/packages/docusaurus/src/client/BaseUrlIssueBanner/index.tsx b/packages/docusaurus/src/client/BaseUrlIssueBanner/index.tsx index 8bc3dd9258..ffbfdae2b7 100644 --- a/packages/docusaurus/src/client/BaseUrlIssueBanner/index.tsx +++ b/packages/docusaurus/src/client/BaseUrlIssueBanner/index.tsx @@ -14,12 +14,12 @@ import useDocusaurusContext from '@docusaurus/useDocusaurusContext'; // Double-security: critical CSS will hide the banner if CSS can load! import './styles.module.css'; -const BannerContainerId = 'docusaurus-base-url-issue-banner-container'; - -const BannerId = 'docusaurus-base-url-issue-banner'; - +// __ prefix allows search crawlers (Algolia/DocSearch) to ignore anchors +// https://github.com/facebook/docusaurus/issues/8883#issuecomment-1516328368 +const BannerContainerId = '__docusaurus-base-url-issue-banner-container'; +const BannerId = '__docusaurus-base-url-issue-banner'; const SuggestionContainerId = - 'docusaurus-base-url-issue-banner-suggestion-container'; + '__docusaurus-base-url-issue-banner-suggestion-container'; const InsertBannerWindowAttribute = '__DOCUSAURUS_INSERT_BASEURL_BANNER'; diff --git a/packages/docusaurus/src/client/BaseUrlIssueBanner/styles.module.css b/packages/docusaurus/src/client/BaseUrlIssueBanner/styles.module.css index a046944686..ea9918c2b4 100644 --- a/packages/docusaurus/src/client/BaseUrlIssueBanner/styles.module.css +++ b/packages/docusaurus/src/client/BaseUrlIssueBanner/styles.module.css @@ -5,6 +5,6 @@ * LICENSE file in the root directory of this source tree. */ -:global(#docusaurus-base-url-issue-banner-container) { +:global(#__docusaurus-base-url-issue-banner-container) { display: none; }