nextra

What's Changed

• fix(Search): check for active results on Enter key by @Dev-CasperTheGhost in https://github.com/shuding/nextra/pull/285
• Fix broken "nav" pages by @maltejur in https://github.com/shuding/nextra/pull/281
• Typescript, pnpm and Turbo by @promer94 in https://github.com/shuding/nextra/pull/286
• Update readme by @jaredpalmer in https://github.com/shuding/nextra/pull/294
• Safer turbo caching by @jaredpalmer in https://github.com/shuding/nextra/pull/293
• fix mdxOptions and export theme types by @promer94 in https://github.com/shuding/nextra/pull/295
• feat: support src directory by @arsnl in https://github.com/shuding/nextra/pull/299
• use remark-gfm v3.0.1 by @joostory in https://github.com/shuding/nextra/pull/300
• feat: [blog theme] support array typed tags; fix #302 by @geekplux in https://github.com/shuding/nextra/pull/303
• feat: [blog theme] add pure nav links; fix #301 by @geekplux in https://github.com/shuding/nextra/pull/305
• Redesign by @shuding in https://github.com/shuding/nextra/pull/312
• chore: Update upstream dependencies by @shuding in https://github.com/shuding/nextra/pull/319
• fix: theme switch menu position by @promer94 in https://github.com/shuding/nextra/pull/323
• Add types script to prepublishOnly by @navin-moorthy in https://github.com/shuding/nextra/pull/322
• Fix #283: Use util.promisify to wrap graceful-fs methods in nextra loader.js by @robbear in https://github.com/shuding/nextra/pull/318
• refactor: improve core by @promer94 in https://github.com/shuding/nextra/pull/308
• fix: Upgrade dependencies and fix bug of invalid locale cookie by @shuding in https://github.com/shuding/nextra/pull/338
• fix: Locale issues by @shuding in https://github.com/shuding/nextra/pull/339
• Group search results by page and other improvements by @shuding in https://github.com/shuding/nextra/pull/340
• fix blog theme and add test for normalize-page by @promer94 in https://github.com/shuding/nextra/pull/342
• Rename createFeedbackUrl to satisfy hooks useX rule by @jaredpalmer in https://github.com/shuding/nextra/pull/344
• Improvements to the search by @shuding in https://github.com/shuding/nextra/pull/345
• Fix dependency resolving by @shuding in https://github.com/shuding/nextra/pull/370
• breaking: Add theme context fields by @shuding in https://github.com/shuding/nextra/pull/371
• fix: upgrade @headlessui/react by @promer94 in https://github.com/shuding/nextra/pull/376
• fix(search): add fallback bg-color for search result by @neighborhood999 in https://github.com/shuding/nextra/pull/363
• fix sort-date by @jrvidal in https://github.com/shuding/nextra/pull/355
• Issue 195: Fixing search in core by @mannybecerra in https://github.com/shuding/nextra/pull/317
• MDX 2.0.0 by @shuding in https://github.com/shuding/nextra/pull/387
• Styling improvements by @shuding in https://github.com/shuding/nextra/pull/388
• breaking: Rename unstable_contentDump to unstable_flexsearch by @shuding in https://github.com/shuding/nextra/pull/389
• Option to disable indexing codeblocks by @shuding in https://github.com/shuding/nextra/pull/390
• Support for a subset of next-themes options by @shuding in https://github.com/shuding/nextra/pull/392
• Options for hiding/adding a link by @shuding in https://github.com/shuding/nextra/pull/393
• Expose the page map starting from the current level by @shuding in https://github.com/shuding/nextra/pull/394
• Support for adding index page for directories by @shuding in https://github.com/shuding/nextra/pull/395
• breaking: Layout element and style improvements by @shuding in https://github.com/shuding/nextra/pull/396
• Style improvements by @shuding in https://github.com/shuding/nextra/pull/397
• Improve search indexing by @shuding in https://github.com/shuding/nextra/pull/398
• Improve search by @shuding in https://github.com/shuding/nextra/pull/399
• Improve collapsible animation and support <details> by @shuding in https://github.com/shuding/nextra/pull/402
• Breadcrumb by @shuding in https://github.com/shuding/nextra/pull/403
• Bug fixes by @shuding in https://github.com/shuding/nextra/pull/404
• Improve styling of sidebar, menu and ToC by @shuding in https://github.com/shuding/nextra/pull/407
• Style fixes, republish packages by @shuding in https://github.com/shuding/nextra/pull/408
• Style improvements by @shuding in https://github.com/shuding/nextra/pull/409
• the head config to support function in doc theme by @Djuki in https://github.com/shuding/nextra/pull/410
• Rename nextra/ssg to nextra/data by @shuding in https://github.com/shuding/nextra/pull/413
• Fix blog theme by @promer94 in https://github.com/shuding/nextra/pull/406
• Update shiki to 0.10.1 by @robbear in https://github.com/shuding/nextra/pull/415
• usee cross-env to set env vars by @aruniverse in https://github.com/shuding/nextra/pull/417
• Discussion: Feedback for MDX compilation failure by @robbear in https://github.com/shuding/nextra/pull/420
• Add layout option and * fallback of meta.json by @shuding in https://github.com/shuding/nextra/pull/425
• Fix bugs when a folder is empty by @shuding in https://github.com/shuding/nextra/pull/426
• Improvements by @shuding in https://github.com/shuding/nextra/pull/432
• Shu/4200 by @Brooooooklyn in https://github.com/shuding/nextra/pull/442
• Add built-in tabs by @shuding in https://github.com/shuding/nextra/pull/443
• Handle MDX parse errors gracefully during webpack compilation by @gkaemmer in https://github.com/shuding/nextra/pull/439
• Improvements by @shuding in https://github.com/shuding/nextra/pull/445
• Export Tabs component in docs theme by @shuding in https://github.com/shuding/nextra/pull/447
• Upgrade next-themes and make logo area full-width by @shuding in https://github.com/shuding/nextra/pull/456
• Make Flexsearch relative to basePath by @adamshiervani in https://github.com/shuding/nextra/pull/457
• Make search result item relative to basePath by @adamshiervani in https://github.com/shuding/nextra/pull/460
• Make the layout more stable by @shuding in https://github.com/shuding/nextra/pull/471
• Fix layout problem by @promer94 in https://github.com/shuding/nextra/pull/451
• Add blue info colors to the callout component by @harrybawsac in https://github.com/shuding/nextra/pull/446
• Move ToC out of article from the layout by @shuding in https://github.com/shuding/nextra/pull/472
• Bug fixes; add type: "separator"; style tweaks by @shuding in https://github.com/shuding/nextra/pull/473
• fix(theme-switch): cannot use of ARIA attribute without role attribute by @numToStr in https://github.com/shuding/nextra/pull/476
• Layout improvements by @shuding in https://github.com/shuding/nextra/pull/480
• Fix navbar newWindow styles and raw layout centering by @jaredpalmer in https://github.com/shuding/nextra/pull/493
• chore(nextra): remove unnecessary assign by @B2o5T in https://github.com/shuding/nextra/pull/486
• chore(nextra): refactor utils.ts by @B2o5T in https://github.com/shuding/nextra/pull/487
• fix typo, Update features.js by @B2o5T in https://github.com/shuding/nextra/pull/488
• fix(blog/docs): remove css from content field in tailwind.config.js by @B2o5T in https://github.com/shuding/nextra/pull/495
• chore(ci): setup test action by @B2o5T in https://github.com/shuding/nextra/pull/506
• chore(nextra): refactor loader.ts by @B2o5T in https://github.com/shuding/nextra/pull/511
• fix(nextra): remove p-limit from dependencies by @B2o5T in https://github.com/shuding/nextra/pull/518
• fix(theme-blog): remove extra padding from post-item list by @numToStr in https://github.com/shuding/nextra/pull/507
• fix(nextra): specify type of NextraPlugin.config by @B2o5T in https://github.com/shuding/nextra/pull/510
• feat(nextra): export compile.tsx by @B2o5T in https://github.com/shuding/nextra/pull/517
• fix(blog): nav styles when there are many links by @B2o5T in https://github.com/shuding/nextra/pull/535
• Support new middleware cookies api by @huozhi in https://github.com/shuding/nextra/pull/544

New Contributors

• @Dev-CasperTheGhost made their first contribution in https://github.com/shuding/nextra/pull/285
• @arsnl made their first contribution in https://github.com/shuding/nextra/pull/299
• @joostory made their first contribution in https://github.com/shuding/nextra/pull/300
• @robbear made their first contribution in https://github.com/shuding/nextra/pull/318
• @neighborhood999 made their first contribution in https://github.com/shuding/nextra/pull/363
• @jrvidal made their first contribution in https://github.com/shuding/nextra/pull/355
• @mannybecerra made their first contribution in https://github.com/shuding/nextra/pull/317
• @Djuki made their first contribution in https://github.com/shuding/nextra/pull/410
• @aruniverse made their first contribution in https://github.com/shuding/nextra/pull/417
• @Brooooooklyn made their first contribution in https://github.com/shuding/nextra/pull/442
• @gkaemmer made their first contribution in https://github.com/shuding/nextra/pull/439
• @adamshiervani made their first contribution in https://github.com/shuding/nextra/pull/457
• @harrybawsac made their first contribution in https://github.com/shuding/nextra/pull/446
• @numToStr made their first contribution in https://github.com/shuding/nextra/pull/476
• @B2o5T made their first contribution in https://github.com/shuding/nextra/pull/486

Full Changelog: https://github.com/shuding/nextra/compare/v2.0.0-beta.5...2.0.0-beta.6

What's Changed

• fix: react key warning by @promer94 in https://github.com/shuding/nextra/pull/272
• Set lower build target by @shuding in https://github.com/shuding/nextra/pull/277

Full Changelog: https://github.com/shuding/nextra/compare/v2.0.0-beta.4...v2.0.0-beta.5

What's Changed

• Fix filter of undefined caused by MDX tree being empty by @shuding in https://github.com/shuding/nextra/pull/269

Full Changelog: https://github.com/shuding/nextra/compare/v2.0.0-beta.3...v2.0.0-beta.4

What's Changed

• Code refactoring for the docs theme by @shuding in https://github.com/shuding/nextra/pull/259
• Refactor docs theme with useConfig internally by @shuding in https://github.com/shuding/nextra/pull/260
• add exports by @promer94 in https://github.com/shuding/nextra/pull/261
• Add exports for docs theme by @shuding in https://github.com/shuding/nextra/pull/263

New Contributors

• @promer94 made their first contribution in https://github.com/shuding/nextra/pull/261

Full Changelog: https://github.com/shuding/nextra/compare/v2.0.0-beta.2...v2.0.0-beta.3

Since 2.0.0, version numbers of the Nextra core and official themes (blog, docs) will be matched precisely. This release includes:

• [email protected]
• [email protected]
• [email protected]

You can upgrade with yarn add nextra@beta or npm install nextra@beta.

Breaking Changes

MDX v2

Nextra 2 will use MDX 2, please check the corresponding migrating guide and blog post if you are interested.

Next.js 12

Since MDX v2 is ESM-only, Nextra 2 requires at least Next.js 12 for its native ESM support.

Highlighting Lines

Before v2, you can use the highlight=1,3-5 syntax to highlight specific lines in a pre code block:

```js highlight=1,3-5
import useSWR from 'swr'

export default function Page() {
  // ...
}
```

In v2, you need to wrap it with "" to make it a valid JSX prop:

```js highlight="1,3-5"
import useSWR from 'swr'

export default function Page() {
  // ...
}
```

(The following is generated automatically and includes all PRs since this is the first release created on GitHub)

What's Changed

• Convert Windows backslash path to slash path by @sinchang in https://github.com/shuding/nextra/pull/11
• I18n by @shuding in https://github.com/shuding/nextra/pull/19
• dev(nextra): Add watch command by @davesnx in https://github.com/shuding/nextra/pull/38
• fix(loader): JSON parse throwing if isn't valid by @davesnx in https://github.com/shuding/nextra/pull/37
• Edit in Github link support for any random repository directories by @davesnx in https://github.com/shuding/nextra/pull/43
• Add Prettier config by @pacocoursey in https://github.com/shuding/nextra/pull/44
• Fix local example build on core by @pacocoursey in https://github.com/shuding/nextra/pull/45
• Decrease anchor links font size by @pacocoursey in https://github.com/shuding/nextra/pull/46
• Add postcss for Tailwind watch mode by @shuding in https://github.com/shuding/nextra/pull/47
• Ignore files with empty basename, like .DS_Store etc by @fanweixiao in https://github.com/shuding/nextra/pull/62
• Fix/css display property by @gr-qft in https://github.com/shuding/nextra/pull/55
• Add Bleed component by @shuding in https://github.com/shuding/nextra/pull/68
• Accept mdx options by @rot1024 in https://github.com/shuding/nextra/pull/76
• fix: og protocol peropty in meta by @huozhi in https://github.com/shuding/nextra/pull/79
• Change the logo wrapper from inline to block by @thien-do in https://github.com/shuding/nextra/pull/88
• Option for disabling the default font by @shuding in https://github.com/shuding/nextra/pull/89
• Fix error with React 17, i18n routes and SSG/SSR by @shuding in https://github.com/shuding/nextra/pull/96
• Fix search focusing by @madmanwithabike in https://github.com/shuding/nextra/pull/98
• Update Callout component to correctly support emojis by @shuding in https://github.com/shuding/nextra/pull/106
• Make external links safe by default. by @leerob in https://github.com/shuding/nextra/pull/111
• build stork index only when stork:true by @navin-moorthy in https://github.com/shuding/nextra/pull/120
• Allow menus collapsed by default by @benoror in https://github.com/shuding/nextra/pull/122
• minor accessibility issues ul-li by @marcosrjjunior in https://github.com/shuding/nextra/pull/138
• Fix test.en.mdx file typo errors, add search result list circular key handle support by @AmagiDDmxh in https://github.com/shuding/nextra/pull/146
• Support Cusdis in nextra-theme-blog by @djyde in https://github.com/shuding/nextra/pull/143
• feat: get current year dynamically by @surjithctly in https://github.com/shuding/nextra/pull/156
• Fixed fresh loading from URLs containing header tags by @nguyenvukhang in https://github.com/shuding/nextra/pull/167
• Support static next/image out of the box by @shuding in https://github.com/shuding/nextra/pull/177
• Fix GFM support and upgrade MDX loader by @shuding in https://github.com/shuding/nextra/pull/184
• Better Callouts by @shuding in https://github.com/shuding/nextra/pull/185
• Prefix stork options with unstable_ by @shuding in https://github.com/shuding/nextra/pull/186
• Add unstable_faviconGlyph option to the docs theme by @shuding in https://github.com/shuding/nextra/pull/187
• Support highlighting a range of code lines by @shuding in https://github.com/shuding/nextra/pull/189
• Normalize option names by @shuding in https://github.com/shuding/nextra/pull/190
• Update loader.js by @olmesm in https://github.com/shuding/nextra/pull/180
• Support page types by @shuding in https://github.com/shuding/nextra/pull/191
• Improvements to search and mobile layout by @shuding in https://github.com/shuding/nextra/pull/192
• Improve navbar and sidebar for the docs theme by @shuding in https://github.com/shuding/nextra/pull/193
• add titleSuffix config to blog theme by @thien-do in https://github.com/shuding/nextra/pull/201
• Fixing routes so they work in Windows by @dzearing in https://github.com/shuding/nextra/pull/215
• Add option to change the Git icon in the top right corner by @maltejur in https://github.com/shuding/nextra/pull/224
• Add rel="noreferrer" to all links with target="_blank" by @maltejur in https://github.com/shuding/nextra/pull/232
• feat: provide title fallback by @geekplux in https://github.com/shuding/nextra/pull/237
• Stripe-like search input by @jaredpalmer in https://github.com/shuding/nextra/pull/245
• Improve nav bar by @jaredpalmer in https://github.com/shuding/nextra/pull/246
• fix for MDXProvider/TOC, and bump mdx version to 2.0.0-rc2 by @ChinW in https://github.com/shuding/nextra/pull/251
• Fix sidebar for trailingSlash: true by @maltejur in https://github.com/shuding/nextra/pull/236
• Feature: dark mode for nextra-theme-blog by @geekplux in https://github.com/shuding/nextra/pull/242
• feat: custom head according to meta or frontMatter of post by @geekplux in https://github.com/shuding/nextra/pull/240

New Contributors

• @sinchang made their first contribution in https://github.com/shuding/nextra/pull/11
• @davesnx made their first contribution in https://github.com/shuding/nextra/pull/38
• @fanweixiao made their first contribution in https://github.com/shuding/nextra/pull/62
• @gr-qft made their first contribution in https://github.com/shuding/nextra/pull/55
• @rot1024 made their first contribution in https://github.com/shuding/nextra/pull/76
• @huozhi made their first contribution in https://github.com/shuding/nextra/pull/79
• @thien-do made their first contribution in https://github.com/shuding/nextra/pull/88
• @madmanwithabike made their first contribution in https://github.com/shuding/nextra/pull/98
• @leerob made their first contribution in https://github.com/shuding/nextra/pull/111
• @navin-moorthy made their first contribution in https://github.com/shuding/nextra/pull/120
• @benoror made their first contribution in https://github.com/shuding/nextra/pull/122
• @marcosrjjunior made their first contribution in https://github.com/shuding/nextra/pull/138
• @AmagiDDmxh made their first contribution in https://github.com/shuding/nextra/pull/146
• @djyde made their first contribution in https://github.com/shuding/nextra/pull/143
• @nguyenvukhang made their first contribution in https://github.com/shuding/nextra/pull/167
• @olmesm made their first contribution in https://github.com/shuding/nextra/pull/180
• @dzearing made their first contribution in https://github.com/shuding/nextra/pull/215
• @jaredpalmer made their first contribution in https://github.com/shuding/nextra/pull/245
• @ChinW made their first contribution in https://github.com/shuding/nextra/pull/251

Full Changelog: https://github.com/shuding/nextra/commits/v2.0.0-beta.2