shuding · shuding · Aug 21, 2022 · Aug 20, 2022 · Aug 20, 2022 · Aug 20, 2022
diff --git a/.changeset/poor-rivers-develop.md b/.changeset/poor-rivers-develop.md
@@ -0,0 +1,6 @@
+---
+'nextra': patch
+'nextra-theme-docs': patch
+---
+
+rename `meta.json` to `_meta.json`
diff --git a/.changeset/proud-phones-dress.md b/.changeset/proud-phones-dress.md
@@ -0,0 +1,5 @@
+---
+'nextra-theme-docs': patch
+---
+
+clicking on folder should navigate to first children if `index` page doesn't exist
diff --git a/.changeset/tall-cows-whisper.md b/.changeset/tall-cows-whisper.md
@@ -0,0 +1,7 @@
+---
+'nextra': patch
+'nextra-theme-blog': patch
+'nextra-theme-docs': patch
+---
+
+rename `PageOpts.meta` to `PageOpts.frontMatter`
diff --git a/examples/docs/src/pages/meta.json → examples/docs/src/pages/_meta.json b/examples/docs/src/pages/meta.json → examples/docs/src/pages/_meta.json
diff --git a/examples/docs/src/pages/advanced/meta.json → examples/docs/src/pages/advanced/_meta.json b/examples/docs/src/pages/advanced/meta.json → examples/docs/src/pages/advanced/_meta.json
diff --git a/examples/docs/src/pages/features/meta.json → examples/docs/src/pages/features/_meta.json b/examples/docs/src/pages/features/meta.json → examples/docs/src/pages/features/_meta.json
diff --git a/examples/docs/src/pages/themes/meta.json → examples/docs/src/pages/themes/_meta.json b/examples/docs/src/pages/themes/meta.json → examples/docs/src/pages/themes/_meta.json
diff --git a/...ples/docs/src/pages/themes/blog/meta.json → ...les/docs/src/pages/themes/blog/_meta.json b/...ples/docs/src/pages/themes/blog/meta.json → ...les/docs/src/pages/themes/blog/_meta.json
diff --git a/...ples/docs/src/pages/themes/docs/meta.json → ...les/docs/src/pages/themes/docs/_meta.json b/...ples/docs/src/pages/themes/docs/meta.json → ...les/docs/src/pages/themes/docs/_meta.json
diff --git a/examples/swr-site/pages/meta.en-US.json → examples/swr-site/pages/_meta.en-US.json b/examples/swr-site/pages/meta.en-US.json → examples/swr-site/pages/_meta.en-US.json
diff --git a/examples/swr-site/pages/meta.es-ES.json → examples/swr-site/pages/_meta.es-ES.json b/examples/swr-site/pages/meta.es-ES.json → examples/swr-site/pages/_meta.es-ES.json
diff --git a/examples/swr-site/pages/meta.ja.json → examples/swr-site/pages/_meta.ja.json b/examples/swr-site/pages/meta.ja.json → examples/swr-site/pages/_meta.ja.json
diff --git a/examples/swr-site/pages/meta.ko.json → examples/swr-site/pages/_meta.ko.json b/examples/swr-site/pages/meta.ko.json → examples/swr-site/pages/_meta.ko.json
diff --git a/examples/swr-site/pages/meta.ru.json → examples/swr-site/pages/_meta.ru.json b/examples/swr-site/pages/meta.ru.json → examples/swr-site/pages/_meta.ru.json
diff --git a/examples/swr-site/pages/meta.zh-CN.json → examples/swr-site/pages/_meta.zh-CN.json b/examples/swr-site/pages/meta.zh-CN.json → examples/swr-site/pages/_meta.zh-CN.json
diff --git a/...ples/swr-site/pages/about/meta.en-US.json → ...les/swr-site/pages/about/_meta.en-US.json b/...ples/swr-site/pages/about/meta.en-US.json → ...les/swr-site/pages/about/_meta.en-US.json
diff --git a/examples/swr-site/pages/blog/meta.en-US.json → ...ples/swr-site/pages/blog/_meta.en-US.json b/examples/swr-site/pages/blog/meta.en-US.json → ...ples/swr-site/pages/blog/_meta.en-US.json
diff --git a/examples/swr-site/pages/blog/meta.es-ES.json → ...ples/swr-site/pages/blog/_meta.es-ES.json b/examples/swr-site/pages/blog/meta.es-ES.json → ...ples/swr-site/pages/blog/_meta.es-ES.json
diff --git a/examples/swr-site/pages/blog/meta.ja.json → examples/swr-site/pages/blog/_meta.ja.json b/examples/swr-site/pages/blog/meta.ja.json → examples/swr-site/pages/blog/_meta.ja.json
diff --git a/examples/swr-site/pages/blog/meta.ko.json → examples/swr-site/pages/blog/_meta.ko.json b/examples/swr-site/pages/blog/meta.ko.json → examples/swr-site/pages/blog/_meta.ko.json
diff --git a/examples/swr-site/pages/blog/meta.ru.json → examples/swr-site/pages/blog/_meta.ru.json b/examples/swr-site/pages/blog/meta.ru.json → examples/swr-site/pages/blog/_meta.ru.json
diff --git a/examples/swr-site/pages/blog/meta.zh-CN.json → ...ples/swr-site/pages/blog/_meta.zh-CN.json b/examples/swr-site/pages/blog/meta.zh-CN.json → ...ples/swr-site/pages/blog/_meta.zh-CN.json
diff --git a/examples/swr-site/pages/docs/meta.en-US.json → ...ples/swr-site/pages/docs/_meta.en-US.json b/examples/swr-site/pages/docs/meta.en-US.json → ...ples/swr-site/pages/docs/_meta.en-US.json
diff --git a/examples/swr-site/pages/docs/meta.es-ES.json → ...ples/swr-site/pages/docs/_meta.es-ES.json b/examples/swr-site/pages/docs/meta.es-ES.json → ...ples/swr-site/pages/docs/_meta.es-ES.json
diff --git a/examples/swr-site/pages/docs/meta.ja.json → examples/swr-site/pages/docs/_meta.ja.json b/examples/swr-site/pages/docs/meta.ja.json → examples/swr-site/pages/docs/_meta.ja.json
diff --git a/examples/swr-site/pages/docs/meta.ko.json → examples/swr-site/pages/docs/_meta.ko.json b/examples/swr-site/pages/docs/meta.ko.json → examples/swr-site/pages/docs/_meta.ko.json
diff --git a/examples/swr-site/pages/docs/meta.ru.json → examples/swr-site/pages/docs/_meta.ru.json b/examples/swr-site/pages/docs/meta.ru.json → examples/swr-site/pages/docs/_meta.ru.json
diff --git a/examples/swr-site/pages/docs/meta.zh-CN.json → ...ples/swr-site/pages/docs/_meta.zh-CN.json b/examples/swr-site/pages/docs/meta.zh-CN.json → ...ples/swr-site/pages/docs/_meta.zh-CN.json
diff --git a/...-site/pages/docs/advanced/meta.en-US.json → ...site/pages/docs/advanced/_meta.en-US.json b/...-site/pages/docs/advanced/meta.en-US.json → ...site/pages/docs/advanced/_meta.en-US.json
diff --git a/...-site/pages/docs/advanced/meta.es-ES.json → ...site/pages/docs/advanced/_meta.es-ES.json b/...-site/pages/docs/advanced/meta.es-ES.json → ...site/pages/docs/advanced/_meta.es-ES.json
diff --git a/...swr-site/pages/docs/advanced/meta.ja.json → ...wr-site/pages/docs/advanced/_meta.ja.json b/...swr-site/pages/docs/advanced/meta.ja.json → ...wr-site/pages/docs/advanced/_meta.ja.json
diff --git a/...swr-site/pages/docs/advanced/meta.ko.json → ...wr-site/pages/docs/advanced/_meta.ko.json b/...swr-site/pages/docs/advanced/meta.ko.json → ...wr-site/pages/docs/advanced/_meta.ko.json
diff --git a/...swr-site/pages/docs/advanced/meta.ru.json → ...wr-site/pages/docs/advanced/_meta.ru.json b/...swr-site/pages/docs/advanced/meta.ru.json → ...wr-site/pages/docs/advanced/_meta.ru.json
diff --git a/...-site/pages/docs/advanced/meta.zh-CN.json → ...site/pages/docs/advanced/_meta.zh-CN.json b/...-site/pages/docs/advanced/meta.zh-CN.json → ...site/pages/docs/advanced/_meta.zh-CN.json
diff --git a/...s/swr-site/pages/examples/meta.en-US.json → .../swr-site/pages/examples/_meta.en-US.json b/...s/swr-site/pages/examples/meta.en-US.json → .../swr-site/pages/examples/_meta.en-US.json
diff --git a/...s/swr-site/pages/examples/meta.es-ES.json → .../swr-site/pages/examples/_meta.es-ES.json b/...s/swr-site/pages/examples/meta.es-ES.json → .../swr-site/pages/examples/_meta.es-ES.json
diff --git a/...ples/swr-site/pages/examples/meta.ja.json → ...les/swr-site/pages/examples/_meta.ja.json b/...ples/swr-site/pages/examples/meta.ja.json → ...les/swr-site/pages/examples/_meta.ja.json
diff --git a/...ples/swr-site/pages/examples/meta.ko.json → ...les/swr-site/pages/examples/_meta.ko.json b/...ples/swr-site/pages/examples/meta.ko.json → ...les/swr-site/pages/examples/_meta.ko.json
diff --git a/...ples/swr-site/pages/examples/meta.ru.json → ...les/swr-site/pages/examples/_meta.ru.json b/...ples/swr-site/pages/examples/meta.ru.json → ...les/swr-site/pages/examples/_meta.ru.json
diff --git a/...s/swr-site/pages/examples/meta.zh-CN.json → .../swr-site/pages/examples/_meta.zh-CN.json b/...s/swr-site/pages/examples/meta.zh-CN.json → .../swr-site/pages/examples/_meta.zh-CN.json
diff --git a/examples/swr-site/theme.config.tsx b/examples/swr-site/theme.config.tsx
@@ -131,10 +131,10 @@ const config: DocsThemeConfig = {
   head() {
     const config = useConfig();
     const description =
-      config.meta.description ||
+      config.frontMatter.description ||
       "SWR is a React Hooks library for data fetching. SWR first returns the data from cache (stale), then sends the fetch request (revalidate), and finally comes with the up-to-date data again.";
     const image =
-      config.meta.image ||
+      config.frontMatter.image ||
       "https://assets.vercel.com/image/upload/v1572282926/swr/twitter-card.jpg";
     return (
       <>

diff --git a/packages/nextra-theme-blog/__test__/__fixture__/pageMap.ts b/packages/nextra-theme-blog/__test__/__fixture__/pageMap.ts
@@ -2,7 +2,7 @@ import { BlogPageOpts } from '../../src/types'
 export const indexOpts: BlogPageOpts = {
   filePath: 'index.mdx',
   route: '/',
-  meta: {
+  frontMatter: {
     type: 'page',
     title: 'About',
     date: '2020-01-01T00:00:00.000Z'
@@ -105,7 +105,7 @@ export const indexOpts: BlogPageOpts = {
 export const postsOpts: BlogPageOpts = {
   filePath: 'index.md',
   route: '/posts',
-  meta: {
+  frontMatter: {
     type: 'posts',
     title: 'Random Thoughts',
     date: '2020-01-03T00:00:00.000Z'
@@ -208,7 +208,7 @@ export const postsOpts: BlogPageOpts = {
 export const articleOpts: BlogPageOpts = {
   filePath: 'aaron-swartz-a-programmable-web.mdx',
   route: '/posts/aaron-swartz-a-programmable-web',
-  meta: {
+  frontMatter: {
     title: 'Notes on A Programmable Web by Aaron Swartz',
     date: '2016/5/21',
     description:

diff --git a/packages/nextra-theme-blog/src/article-layout.tsx b/packages/nextra-theme-blog/src/article-layout.tsx
@@ -10,7 +10,7 @@ export const ArticleLayout = ({ children }: { children: ReactNode }) => {
   const { back } = getParent({ opts, config })
   return (
     <BasicLayout>
-      <Meta {...opts.meta} back={back} config={config} />
+      <Meta {...opts.frontMatter} back={back} config={config} />
       <MDXTheme>
         {children}
         {config.postFooter}

diff --git a/packages/nextra-theme-blog/src/basic-layout.tsx b/packages/nextra-theme-blog/src/basic-layout.tsx
@@ -11,7 +11,7 @@ export const BasicLayout = ({ children }: { children: ReactNode }) => {
     <article className="container prose prose-sm dark:prose-dark md:prose">
       <Head>
         <title>{title}</title>
-        {config.head?.({ title, meta: opts.meta })}
+        {config.head?.({ title, meta: opts.frontMatter })}
       </Head>
       <HeadingContext.Provider value={ref}>
         {opts.hasJsxInH1 ? <h1 ref={ref} /> : null}

diff --git a/packages/nextra-theme-blog/src/blog-context.tsx b/packages/nextra-theme-blog/src/blog-context.tsx
@@ -14,7 +14,7 @@ export const BlogProvider = ({
   children,
   opts
 }: LayoutProps & { children: ReactNode }): ReactElement => {
-  const { date } = opts.meta
+  const { date } = opts.frontMatter
 
   if (date && !isValidDate(date)) {
     throw new Error(

diff --git a/packages/nextra-theme-blog/src/index.tsx b/packages/nextra-theme-blog/src/index.tsx
@@ -21,7 +21,7 @@ const BlogLayout = ({
   children,
   opts
 }: LayoutProps & { children: ReactNode }): ReactElement => {
-  const type = opts.meta.type || 'post'
+  const type = opts.frontMatter.type || 'post'
   const Layout = layoutMap[type]
   if (!Layout) {
     throw new Error(

diff --git a/packages/nextra-theme-blog/src/posts-layout.tsx b/packages/nextra-theme-blog/src/posts-layout.tsx
@@ -12,9 +12,7 @@ export const PostsLayout = ({ children }: { children: ReactNode }) => {
   const { config, opts } = useBlogContext()
   const { posts } = collectPostsAndNavs({ config, opts })
   const router = useRouter()
-  const {
-    meta: { type }
-  } = opts
+  const { type } = opts.frontMatter
   const tagName = type === 'tag' ? router.query.tag : null
   const postList = posts.map(post => {
     if (tagName) {

diff --git a/packages/nextra-theme-blog/src/types.ts b/packages/nextra-theme-blog/src/types.ts
@@ -28,7 +28,7 @@ export interface NextraBlogTheme {
 }
 
 export interface BlogPageOpts extends PageOpts {
-  meta: Meta
+  frontMatter: Meta
 }
 
 type Meta = {