Releases: facebook/docusaurus
Releases · facebook/docusaurus
v2.0.0-alpha.36
💥 Breaking Change
docusaurus-init,docusaurus-plugin-content-blog,docusaurus-theme-classic
🚀 New Feature
docusaurus-plugin-content-docs,docusaurus-theme-classic
🐛 Bug Fix
docusaurusdocusaurus-theme-classic
💅 Polish
docusaurus-theme-classic
🏠 Internal
docusaurusdocusaurus-mdx-loader,docusaurus-plugin-ideal-image- Other
📝 Documentation
Committers: 3
v1.14.2
v1.14.1
🐛 Bug Fix
- #2022 fix(v1): markdown content and toc should render the same (@endiliey)
- #2020 fix(v1): docusaurus-start should work even if path contain 'pages' word (@endiliey)
- #2019 fix(v1): consistent slug & hash-link generation (@endiliey)
- #1869 fix(v1): fix page title render issue when referred by search result (@parvezakkas)
- #1895 fix(v1): mobile safari search input misalignment in header (@sarneeh)
- #1871 misc(v1): use primary color for hovered items in table of contents (@blitz137)
🏠 Internal
- #1920 misc(v1): use Node.js lts version for docker (@gengjiawen)
📝 Documentation
- #1998 docs(v1): showcase user collective (@kenning)
- #1961 docs(v1): remove exclusive language (@ericcarboni)
- #1873 docs: showcase user Amphora (@xtellurian)
- #1918 docs(v1): showcase user Reactive Interaction Gateway (@mmacai)
- #1911 docs: updating configcat user link (@mr-sige)
- #1902 misc: update URLs to non-HTML versions (@ikrydev)
- #1901 docs(v1): remove broken link for user Vasern (@ikrydev)
See CHANGELOG.md for more details.
v2.0.0-alpha.35
🚀 New Feature
🐛 Bug Fix
docusaurus-mdx-loader,docusaurus-theme-classicdocusaurus-theme-classic- #1999 fix(v2): remove hashbang when click on category (@lex111)
- #1962 fix(v2): make not clickable post title on post item page (@lex111)
- #1980 fix(v2): remove invalid label attribute of footer links (@lex111)
- #1978 fix(v2): use regular div instead of main tag for wrapper layout page (@lex111)
- #1975 fix(v2): move header inside article tag in doc page (@lex111)
- #1974 fix(v2): remove invalid attributes of nav links (@lex111)
- #1963 fix(v2): remove empty containers when no data in blog pages (@lex111)
- #1966 fix(v2): remove duplicate meta tags (@lex111)
docusaurus-plugin-content-docs
💅 Polish
docusaurus-theme-search-algoliadocusaurus-theme-classic- #1991 fix(v2): remove accessible anchors via keyboard (@lex111)
- #1987 refactor(v2): replace h1 tag with h2 in blog list pages (@lex111)
- #1981 fix(v2): use tag time for showing last update of doc item (@lex111)
- #1977 feat(v2): add aria-label to read more links for a11y (@lex111)
- #1964 fix(v2): use tag time for showing post item date (@lex111)
docusaurus-plugin-content-docs- Other
docusaurus-initdocusaurus-plugin-content-blog
📝 Documentation
- Other
- #1988 docs(v2): fix syntax highlighting for YML code blocks (@lex111)
- #1976 docs(v2): Add section to blog document about feed location (@vinnytheviking)
- #1970 docs(v2): update configureWebpack utility functions (@jamiedavenport)
docusaurus-1.x- #1961 docs(v1): remove exclusive language (@ericcarboni)
🏠 Internal
- Other
docusaurus-initdocusaurus-1.x,docusaurus-init-1.x,docusaurus-init,docusaurus-plugin-content-docs,docusaurus-plugin-ideal-image,docusaurus-types,docusaurus
🏃♀️ Performance
Committers: 6
- Alexey Pyltsyn (@lex111)
- Endi (@endiliey)
- Eric Carboni (@ericcarboni)
- Jamie Davenport (@jamiedavenport)
- Nick McCormick (@kenning)
- Vincent van der Walt (@vinnytheviking)
v2.0.0-alpha.34
🚀 New Feature
💥 Breaking Change
docusaurus-plugin-content-docs
🐛 Bug Fix
docusaurus-theme-classic
💅 Polish
docusaurus-plugin-content-docs,docusaurus
📝 Documentation
🏠 Internal
docusaurus-1.x,docusaurus-plugin-content-blog,docusaurus-plugin-content-docs,docusaurus-theme-classic,docusaurus-theme-search-algolia,docusaurus-types,docusaurus-utils,docusaurus- Other
🏃♀️ Performance
docusaurus-plugin-content-docs,docusaurus-utils,docusaurus
Committers: 3
v2.0.0-alpha.33
Features
- Table of contents is now highlighted depending on current active headings. (thanks to awesome @SantiagoGdaR) #1896
- Official blog plugin can now generate feed for blog posts. (thanks to awesome @moozzyk) #1916
- BREAKING
prismThemeis renamed tothemeas part newprismobject inthemeConfigfield in yourdocusaurus.config.js. Eg:themeConfig: { - prismTheme: require('prism-react-renderer/themes/dracula'), + prism: { + theme: require('prism-react-renderer/themes/dracula'), + }, }, - Added new
prismoptiondefaultLanguagethat is used if the language is not specified in code blocks.
#1910
Fixes
- Fix babel/env not picking the correct browserslist configuration during development. When running
docusaurus start,process.env.NODE_ENVis now consistently set todevelopment. - Ensure routes config generation to be more consistent in ordering. Nested routes should be placed last in routes.js. This will allow user to create
src/pages/docs.jsto create custom docs page for/docsor evensrc/pages/docs/super.jsto create page for/docs/super/; - Fix watcher does not trigger reload on windows.
- Fix build compilation error if exists only one code tab.
- Add minor padding to docs container so that hash-link won't be cut off.
Others
- Misc dependency upgrades.
- Stability improvement (more tests) & refactoring on docs plugin to prevent regression.
Upgrading
// package.json
{
dependencies: {
+ "@docusaurus/core": "^2.0.0-alpha.33",
+ "@docusaurus/preset-classic": "^2.0.0-alpha.33",
- "@docusaurus/core": "^2.0.0-alpha.32",
- "@docusaurus/preset-classic": "^2.0.0-alpha.32",
}
}v2.0.0-alpha.32
2.0.0-alpha.32
Features
- Add
<Redirect>component for easy client side redirect.
Example Usage:
import React from 'react';
import {Redirect} from '@docusaurus/router';
function Home() {
return <Redirect to="/docs/test" />;
}- Allow user to add custom HTML to footer items. #1905
- Added code block line highlighting feature (thanks @lex111)! If you have previously swizzled the
CodeBlocktheme component, it is recommended to update your source code to have this feature.
(#1860)
Bug Fixes
- Fix
@theme/Tabscomponent to be able to create tabs with only one item. - Fix MDX
@theme/Headingcomponent. If there is no id, it should not create anchor link. - Fixed a bug in which if
themeConfig.algoliais not defined, the custom searchbar won't appear.
If you've swizzled AlgoliaSearchBarcomponent before, please update your source code otherwise CSS might break. See #1909 for reference.
- <Fragment>
+ <div className="navbar__search" key="search-box">- Slightly adjust search icon position to be more aligned on small width device. (#1893)
- Fix algolia styling bug, previously search suggestion result is sometimes hidden. (#1915)
- Changed the way we read the
USE_SSHenv variable during deployment to be the same as in v1. - Fix accessing
docs/or/docs/xxxxthat does not match any existing doc page should return 404 (Not found) page, not blank page. (#1903) - Prioritize
@docusaurus/coredependencies/ node_modules over user's node_modules. This fix a bug whereby if user has core-js@3 on its own node_modules but docusaurus depends on core-js@2, we previously encounterModule not found: core-js/modules/xxxx(because core-js@3 doesn't have that). - Fix a bug where docs plugin add
/docsroute even if docs folder is empty. We also improved docs plugin test coverage to 100% for stability before working on docs versioning. (#1912)
Performance Improvement
- Reduce memory usage consumption. (#1900)
- Significantly reduce main bundle size and initial HTML payload on production build. Generated files from webpack is also shorter in name. (#1898)
- Simplify blog metadata. Previously, accessing
/blog/post-xxxwill request for next and prev blog post metadata too aside from target post metadata. We should only request target post metadata.
(#1908)
Others
v2.0.0-alpha.31
2.0.0-alpha.31
- Footer is now sticky/ pinned to the bottom of the viewport in desktop browsers.
- Footer is now also displayed in docs page for consistency.
- Remove empty doc sidebar container if sidebar for a particular doc page does not exist. Otherwise, it will cause an additional empty space.
- Default PostCSS loader now only polyfills stage 3+ features (previously it was stage 2) like Create React App. Stage 2 CSS is considered relatively unstable and subject to change while Stage 3 features will likely become a standard.
- Fix search bar focus bug. When you put the focus on search input, previously the focus will remain although we have clicked to other area outside of the search input.
- New themeConfig option
sidebarCollapsible. It is on by default. If explicitly set tofalse, all doc items in sidebar is expanded. Otherwise, it will still be a collapsible sidebar. - Disable adding hashes to the generated class names of CSS modules in dev mode. Generating unique identifiers takes some time, which can be saved since including paths to files in class names is enough to avoid collisions.
- Fix showing sidebar category with empty items.
- Update infima from 0.2.0-alpha.2 to 0.2.0-alpha.3
- Fix pagination nav and right sidebar color contrast ratio
- Fix sidebar arrow color in dark mode
- Fix footer mobile issue
- Increase sidebar width
- etc
v2.0.0-alpha.30
2.0.0-alpha.30
- Fix babel transpilation include/exclude logic to be more efficient. This also fix a very weird bug
TypeError: Cannot assign to read only property 'exports' of object '#<Object>'if your website path containsdocusaurusword in it.(#1868)
If you are still encountering the error. Please check whether you use module.exports for your .js file instead of doing export (mixing CJS and ES). See webpack/webpack#4039 (comment) and webpack/webpack#4039 (comment) for more context.
v2.0.0-alpha.29
2.0.0-alpha.29
HOTFIX for 2.0.0-alpha.28.
- Fix missing
core-jsdependencies on@docusaurus/core. - Fix wrong
@babel/envpreset configuration that causes build compilation error. - Improved UI for webpack compilation progress bar.