Fix frontMatter.sidebarTitle didn't affect without frontMatter.title set (#3478)

* aa

* aa

Author: dimaMachina

.changeset/ninety-news-behave.md

@@ -0,0 +1,5 @@
+---
+'nextra': patch
+---
+
+update package version range for `@theguild/remark-mermaid` to be at least `^0.1.3` https://github.com/nextauthjs/next-auth/pull/12029#discussion_r1801785960

.changeset/silver-poems-turn.md

@@ -0,0 +1,13 @@
+---
+'nextra': patch
+'nextra-theme-docs': patch
+---
+
+Fix `frontMatter.sidebarTitle` didn't affect without `frontMatter.title` set
+
+now priority for sidebar title is:
+
+1. `title` property from `_meta` file
+1. `frontMatter.sidebarTitle`
+1. `frontMatter.title`
+1. formatted with [Title](https://title.sh) based on filename

docs/pages/docs/_meta.ts

@@ -1,5 +1,5 @@
 export default {
-  index: 'Introduction',
+  index: '',
   guide: '',
   '-- Themes': {
     type: 'separator',

docs/pages/docs/docs-theme/page-configuration.mdx

@@ -1,3 +1,8 @@
+import { Screenshot } from 'components/screenshot'
+import { Video } from 'components/video'
+import { Callout, FileTree } from 'nextra/components'
+import menuImage from 'public/assets/docs/menu.png'
+
 # Page Configuration
 
 In Nextra, the site and page structure can be configured via the co-located
@@ -7,11 +12,6 @@ customize it further.
 Those configurations affect the overall layout of the theme, especially the
 navigation bar and the sidebar.
 
-import { Screenshot } from 'components/screenshot'
-import { Video } from 'components/video'
-import { Callout, FileTree } from 'nextra/components'
-import menuImage from 'public/assets/docs/menu.png'
-
 <Callout>
   Read more about Nextra's `_meta.js` files
   [here](/docs/guide/organize-files#_metajs).
@@ -45,7 +45,7 @@ export default {
 <Callout>
   If any routes are not listed in the `_meta.js` file, they will be appended to
   the end of the sidebar and sorted alphabetically, and the title will be
-  formatted with [Title](https://title.sh).
+  formatted with [Title](https://title.sh) based on filename.
 </Callout>
 
 ## Folders

docs/pages/docs/index.mdx

@@ -1,3 +1,9 @@
+---
+sidebarTitle: Introduction
+---
+
+import { Cards } from 'nextra/components'
+
 # Introduction
 
 **Nextra** is a framework on top of Next.js, that lets you build content focused
@@ -6,8 +12,6 @@ Markdown-based content with ease.
 
 ## Quick Start
 
-import { Cards } from 'nextra/components'
-
 To start using Nextra, you need to select a theme first:
 
 <Cards num={2}>

packages/nextra/package.json

@@ -133,7 +133,7 @@
     "@mdx-js/react": "^3.0.0",
     "@napi-rs/simple-git": "^0.1.9",
     "@shikijs/twoslash": "^1.0.0",
-    "@theguild/remark-mermaid": "^0.1.2",
+    "@theguild/remark-mermaid": "^0.1.3",
     "@theguild/remark-npm2yarn": "^0.3.2",
     "better-react-mathjax": "^2.0.3",
     "clsx": "^2.0.0",

packages/nextra/src/server/page-map.ts

@@ -121,7 +121,7 @@ async function collectFiles({
           const content = await fs.readFile(filePath, 'utf8')
           const { data } = grayMatter(content)
           if (!data.title) {
-            data.sidebarTitle = pageTitleFromFilename(name)
+            data.sidebarTitle ||= pageTitleFromFilename(name)
           }
 
           return {