diff --git a/website/blog/authors.yml b/website/blog/authors.yml index a207780609..12abe07366 100644 --- a/website/blog/authors.yml +++ b/website/blog/authors.yml @@ -27,7 +27,6 @@ slorber: description: > A freelance React and React-Native developer near Paris and Docusaurus maintainer. Also runs ThisWeekInReact.com, a newsletter to stay updated with the React ecosystem. - socials: x: sebastienlorber linkedin: sebastienlorber diff --git a/website/blog/releases/3.5/img/author-index.png b/website/blog/releases/3.5/img/author-index.png new file mode 100644 index 0000000000..1f79084025 Binary files /dev/null and b/website/blog/releases/3.5/img/author-index.png differ diff --git a/website/blog/releases/3.5/img/author-page.png b/website/blog/releases/3.5/img/author-page.png new file mode 100644 index 0000000000..864b287bab Binary files /dev/null and b/website/blog/releases/3.5/img/author-page.png differ diff --git a/website/blog/releases/3.5/img/author-socials.png b/website/blog/releases/3.5/img/author-socials.png new file mode 100644 index 0000000000..7c2b011e44 Binary files /dev/null and b/website/blog/releases/3.5/img/author-socials.png differ diff --git a/website/blog/releases/3.5/img/social-card.png b/website/blog/releases/3.5/img/social-card.png new file mode 100644 index 0000000000..fa5bd91569 Binary files /dev/null and b/website/blog/releases/3.5/img/social-card.png differ diff --git a/website/blog/releases/3.5/index.mdx b/website/blog/releases/3.5/index.mdx new file mode 100644 index 0000000000..460222dc0f --- /dev/null +++ b/website/blog/releases/3.5/index.mdx @@ -0,0 +1,94 @@ +--- +title: Docusaurus 3.5 +authors: [slorber] +tags: [release] +image: ./img/social-card.png +date: 2024-08-09 +--- + +We are happy to announce **Docusaurus 3.5**. + +This release contains many **new exciting blog features**. + +Upgrading should be easy. Our [release process](/community/release-process) respects [Semantic Versioning](https://semver.org/). Minor versions do not include any breaking changes. + +![Docusaurus blog post social card](./img/social-card.png) + + + +## Highlights + +### Blog social icons + +In [#10222](https://github.com/facebook/docusaurus/pull/10222), we added the possibility to associate social links to blog authors, for inline authors declared in front matter or global through the `authors.yml` file. + +```yml title="blog/authors.yml" +slorber: + name: Sébastien Lorber + # other author properties... + # highlight-start + socials: + x: sebastienlorber + linkedin: sebastienlorber + github: slorber + newsletter: https://thisweekinreact.com + # highlight-end +``` + +![Author socials screenshot displaying `slorber` author with 4 social platform icons](./img/author-socials.png) + +Icons and handle shortcuts are provided for pre-defined platforms `x`, `linkedin`, `github` and `stackoverflow`. It's possible to provide any additional platform entry (like `newsletter` in the example above) with a full URL. + +### Blog authors pages + +In [#10216](https://github.com/facebook/docusaurus/pull/10216), we added the possibility for [global blog authors](/docs/blog#global-authors) (declared in `authors.yml`) to have their own dedicated page listing all the blog posts they contributed to. This feature is opt-in and mostly relevant for multi-author blogs. + +```yml title="blog/authors.yml" +slorber: + name: Sébastien Lorber + description: 'A freelance React and React-Native developer...' + # highlight-next-line + page: true # Turns the feature on +``` + +![Author page screenshot for `slorber` global author](./img/author-page.png) + +An author index page is also created, listing all the global authors having the feature turned on. + +![Author index page listing multiple authors](./img/author-index.png) + +### Blog styled feeds + +[#9252](https://github.com/facebook/docusaurus/pull/9252) feat(blog): add feed xlst options to render beautiful RSS and Atom feeds + +### Other blog improvements + +- [#10252](https://github.com/facebook/docusaurus/pull/10252) feat(blog): group sidebar items by year (`themeConfig.blog.sidebar.groupByYear`) ([@alicelovescake](https://github.com/alicelovescake)) +- [#10224](https://github.com/facebook/docusaurus/pull/10224) feat(blog): warn duplicate and inline authors ([@OzakIOne](https://github.com/OzakIOne)) +- onUntruncatedBlogPost + +## Translations + +- 🇪🇪 [#10339](https://github.com/facebook/docusaurus/pull/10339): Add Estonian theme translations. +- 🇮🇩 [#10325](https://github.com/facebook/docusaurus/pull/10325): Add Estonian theme translations. +- 🇪🇸 [#10360](https://github.com/facebook/docusaurus/pull/10360): Improve Spanish them translations. +- 🇩🇪 [#10235](https://github.com/facebook/docusaurus/pull/10235): Improve German them translations. +- 🇨🇳 [#10257](https://github.com/facebook/docusaurus/pull/10257): Improve Traditional Chinese (zh-Hant) them translations. + +## Other changes + +Other notable changes include: + +- [#10369](https://github.com/facebook/docusaurus/pull/10369): Add support for [pkg.pr.new](https://pkg.pr.new) continuous releases so that you can test any pull-request code in a StackBlitz playground. +- [#10376](https://github.com/facebook/docusaurus/pull/10376): Theme unlisted/draft banners are also shown in dev so that you don't forget to publish your content. +- [#10335](https://github.com/facebook/docusaurus/pull/10335): The Markdown top-level headings `# title` are automatically wrapped in `
` for consistency with front matter `title: Title`. +- [#10286](https://github.com/facebook/docusaurus/pull/10286): Allows Docusaurus plugins to self-disable by returning `null`. +- [#10241](https://github.com/facebook/docusaurus/pull/10241): Add support for [MDX processor `recmaPlugins` option](https://mdxjs.com/packages/mdx/#processoroptions) to modify the MDX Estree AST. +- [#10324](https://github.com/facebook/docusaurus/pull/10324): The docs autogenerated `_category_.json` accepts a new `description` property that gets displayed on generated index pages. +- [#10368](https://github.com/facebook/docusaurus/pull/10368): The CLI command `docusaurus --version` now actually returns the Docusaurus version. +- [#10240](https://github.com/facebook/docusaurus/pull/10240): Markdown `mdx-code-block` now supports indentation. +- [#10219](https://github.com/facebook/docusaurus/pull/10219): Fix `` support the for `className` prop. +- [#10313](https://github.com/facebook/docusaurus/pull/10313): Blog-related `@docusaurus/theme-common/internal` APIs have been moved to `@docusaurus/plugin-content-blog/client`. +- [#10316](https://github.com/facebook/docusaurus/pull/10316): Docs-related `@docusaurus/theme-common/internal` APIs have been moved to `@docusaurus/plugin-content-docs/client`. + +Check the **[3.5.0 changelog entry](/changelog/3.5.0)** for an exhaustive list of changes.