docusaurus

Easy to maintain open source documentation websites.

MIT License

Downloads
30.8M
Stars
56K
Committers
1.2K

Bot releases are hidden (Show)

docusaurus - v1.14.4

Published by yangshun almost 5 years ago

Rest in Peace @endiliey

It is with great sadness to announce that our primary external Docusaurus contributor, Endilie Yacop Sucipto (@endiliey), passed away on Jan 5th after battling cancer and illnesses for years. We have written a blog post in memory of him.


πŸ› Bug Fix

  • docusaurus-1.x
    • #2196 fix(v1): fix JSX highlighting by passing language to Prism (@gaearon)

🏠 Internal

Committers: 6

docusaurus - v2.0.0-alpha.40

Published by endiliey almost 5 years ago

πŸš€ New Feature

  • docusaurus-theme-classic
    • #2117 feat(v2): auto switch theme depending on the system theme (@lex111)
    • #2055 feat(v2): hide navbar on scroll (@lex111)

πŸ› Bug Fix

  • docusaurus
    • #2145 fix(v2): remove style-loader, use minicssextract in both dev & prod (@endiliey)
    • #2122 fix(v2): dont collapse whitespace in minified html (@endiliey)
  • docusaurus-mdx-loader, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs
    • #2105 fix(v2): move metadata export after compiling MDX to avoid weird MDX parsing error. (@endiliey)
  • docusaurus-theme-classic
    • #2113 fix(v2): set stored theme only if it exists (@lex111)

πŸ’… Polish

  • docusaurus-theme-classic
    • #2129 fix(v2): disable scroll while mobile menu open (@lex111)
  • docusaurus-theme-classic, docusaurus
    • #2127 refactor(v2): toggle data-theme with vanilla js instead of react helmet (@endiliey)
  • docusaurus-theme-search-algolia, docusaurus
    • #2125 feat(v2): lazy load algolia css so its not render blocking (@endiliey)

πŸ“ Documentation

  • Other
  • docusaurus-theme-classic, docusaurus-theme-live-codeblock
    • #2114 fix(v2): add syntax highlight to generated colors (@lex111)

🏠 Internal

  • Other
  • docusaurus-init
  • docusaurus
  • docusaurus-1.x, docusaurus-init, docusaurus-mdx-loader, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-ideal-image, docusaurus-theme-live-codeblock, docusaurus

πŸƒβ€β™€οΈ Performance

Committers: 6

docusaurus - v2.0.0-alpha.39

Published by endiliey almost 5 years ago

πŸ› Bug Fix

  • docusaurus
  • docusaurus-plugin-content-blog, docusaurus-plugin-content-docs
    • #2095 fix(v2): metadata error if markdown does not have ending line (@endiliey)

🏠 Internal

  • Other
    • #2100 chore(ci): test docusaurus build on Windows with GitHub actions (@endiliey)
  • docusaurus

Committers: 1

docusaurus - v2.0.0-alpha.38

Published by endiliey almost 5 years ago

πŸ’₯ Breaking Change

  • docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-content-pages, docusaurus-theme-classic, docusaurus-utils
    • #2088 perf(v2): smaller bundlesize by embedding metadata to content (@endiliey)

If you have swizzled any Docs/Blog component that depends on metadata, you'll have to update. If you haven't, no action is needed.

For example, if you've swizzled @theme/DocItem. You'll have to update

- const {metadata, content: DocContent} = props;
+ const {content: DocContent} = props;
+ const {metadata} = DocContent;

πŸ› Bug Fix

  • docusaurus
  • docusaurus-plugin-ideal-image
    • #2074 fix(v2): fix plugin-ideal-image breaking website (exports not defined) (@endiliey)

πŸ’… Polish

  • docusaurus-mdx-loader

🏠 Internal

  • docusaurus-1.x
  • docusaurus
    • #2081 refactor(v2): move scripts/stylesheets injection to server side (@endiliey)
    • #2080 refactor(v2): minor code refactoring on component creator (@endiliey)

πŸƒβ€β™€οΈ Performance

  • docusaurus-utils
    • #2089 perf(v2): improve dev build time by not overwriting file if possible (@endiliey)
  • docusaurus-theme-search-algolia
    • #2079 perf(v2): algolia search result no longer cause full page refresh (@endiliey)
    • #2076 perf(v2): load algolia JS only when user interacts with search (@endiliey)

Committers: 4

docusaurus - v2.0.0-alpha.37

Published by endiliey almost 5 years ago

πŸ’₯ Breaking Change

  • docusaurus-init, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-content-pages, docusaurus-theme-classic, docusaurus-theme-live-codeblock, docusaurus-theme-search-algolia, docusaurus-utils, docusaurus
    • #2045 breaking(v2): minimum required nodejs version 8.9-> 8.10 so we can use es2017 (@endiliey)

πŸš€ New Feature

  • docusaurus-theme-classic, docusaurus
    • #2069 feat(v2): support prefers-color-scheme & fix dark mode FOUC on refresh (@endiliey)
  • docusaurus-plugin-content-blog
    • #2000 feat(v2): add meta RSS/Atom feed links to head (@lex111)
  • docusaurus-plugin-content-docs, docusaurus-types, docusaurus
    • #2057 feat(v2): injectHtmlTags API to inject head and/or body html tags (@endiliey)
  • docusaurus-mdx-loader, docusaurus-plugin-content-docs, docusaurus-plugin-sitemap, docusaurus-theme-classic, docusaurus
    • #2032 feat(v2): allow non sidebar category to be first item of sidebar (@endiliey)
  • docusaurus-plugin-content-docs, docusaurus-theme-classic, docusaurus-types, docusaurus

πŸ› Bug Fix

  • docusaurus-theme-classic, docusaurus
    • #2069 feat(v2): support prefers-color-scheme & fix dark mode FOUC on refresh (@endiliey)
  • docusaurus-mdx-loader
    • #2067 fix(v2): toc should not be broken for heading with html inline code (@endiliey)
  • docusaurus-theme-classic
    • #2064 fix(v2): markdown reference to file should not be page not found (@endiliey)
    • #2061 fix(v2): fix docs sidebar highlighting if link is partially matched (@endiliey)
  • docusaurus
    • #2042 fix(v2): remove css order warning if css imports are not sorted (@endiliey)

πŸ’… Polish

  • docusaurus-theme-classic

πŸ“ Documentation

🏠 Internal

  • docusaurus-plugin-content-blog
  • docusaurus
    • #2060 fix(v2): clean generated manifest from previous build so we dont use the wrong one (@endiliey)
    • #2033 refactor(v2): move unused generated files out from build folder (@endiliey)
  • docusaurus-types, docusaurus
  • docusaurus-mdx-loader, docusaurus-plugin-ideal-image, docusaurus-types, docusaurus
  • docusaurus-init, docusaurus-mdx-loader, docusaurus-plugin-content-docs, docusaurus

πŸƒβ€β™€οΈ Performance

  • docusaurus-plugin-google-analytics, docusaurus-plugin-google-gtag
    • #2070 perf(v2): more performant gtag and analytics plugin (@endiliey)
  • docusaurus
    • #2046 perf(v2): use webpack future version of asset emitting logic to free memory (@endiliey)
    • #2039 perf(v2): replace unnecessary json stringify(string) with inline string (@endiliey)
    • #2035 perf(v2): use @babel/runtime plugin to reduce codesize (@endiliey)
  • docusaurus-plugin-content-docs
    • #2054 perf(v2): unblock metadata processing when possible (@endiliey)

Committers: 5

docusaurus - v1.14.3

Published by endiliey almost 5 years ago

πŸ› Bug Fix

  • docusaurus-1.x

🏠 Internal

  • docusaurus-1.x

Committers: 2

docusaurus - v2.0.0-alpha.36

Published by endiliey almost 5 years ago

πŸ’₯ Breaking Change

  • docusaurus-init, docusaurus-plugin-content-blog, docusaurus-theme-classic

πŸš€ New Feature

  • docusaurus-plugin-content-docs, docusaurus-theme-classic

πŸ› Bug Fix

  • docusaurus
    • #2007 feat(v2): only create one css file to avoid code-split css loading problem (@endiliey)
  • docusaurus-theme-classic
    • #2005 fix(v2): adjust first-level heading offset (@lex111)

πŸ’… Polish

  • docusaurus-theme-classic
    • #2013 refactor(v2): split out dark mode toggle so it is easily swizzle-able (@endiliey)
    • #2017 feat(v2): style right sidebar scrollbar when overflow (@endiliey)
    • #2003 refactor(v2): improve semantic markup of blog (@lex111)

🏠 Internal

  • docusaurus
    • #2024 test(v2): babel exclude transpilation logic to prevent regression (@endiliey)
    • #2014 feat(v2): add meta generator docusaurus (@endiliey)
  • docusaurus-mdx-loader, docusaurus-plugin-ideal-image
  • Other

πŸ“ Documentation

Committers: 3

docusaurus - v1.14.2

Published by endiliey almost 5 years ago

πŸ› Bug Fix

  • docusaurus-1.x
    • #2028 fix(v1): apply negative margin to docs heading only (@yangshun)

πŸ“ Documentation

docusaurus - v1.14.1

Published by endiliey almost 5 years ago

πŸ› 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

πŸ“ Documentation

See CHANGELOG.md for more details.

docusaurus - v2.0.0-alpha.35

Published by endiliey almost 5 years ago

πŸš€ New Feature

  • docusaurus-theme-classic
    • #1965 feat(v2): add ability specify link in footer logo (@lex111)

πŸ› Bug Fix

  • docusaurus-mdx-loader, docusaurus-theme-classic
    • #1992 fix(v2): static phrasing content should be rendered correctly in TOC (@endiliey)
  • docusaurus-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
    • #1994 fix(v2): throw error if first level item of a sidebar is not category (@endiliey)

πŸ’… Polish

  • docusaurus-theme-search-algolia
  • docusaurus-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
    • #1994 fix(v2): throw error if first level item of a sidebar is not category (@endiliey)
  • Other
    • #1986 fix(v2): remove obsolete iframe attributes (@lex111)
  • docusaurus-init
  • docusaurus-plugin-content-blog

πŸ“ Documentation

🏠 Internal

  • Other
    • #2002 fix(v2): fix browser window menu icon on smaller screen (@lex111)
    • #1986 fix(v2): remove obsolete iframe attributes (@lex111)
  • docusaurus-init
  • docusaurus-1.x, docusaurus-init-1.x, docusaurus-init, docusaurus-plugin-content-docs, docusaurus-plugin-ideal-image, docusaurus-types, docusaurus

πŸƒβ€β™€οΈ Performance

  • docusaurus
    • #1979 perf(v2): reduce main bundle size by using es5 if possible (@endiliey)

Committers: 6

docusaurus - v2.0.0-alpha.34

Published by endiliey almost 5 years ago

πŸš€ New Feature

  • docusaurus-theme-classic
    • #1956 feat(v2): add ability hide dark mode toggle (@lex111)

πŸ’₯ Breaking Change

  • docusaurus-plugin-content-docs
    • #1958 breaking(v2): editUrl should point to website instead of docsDir (@endiliey)

πŸ› Bug Fix

  • docusaurus-theme-classic
    • #1959 fix(v2): useTOC hooks should not be called in each nested children (@endiliey)

πŸ’… Polish

  • docusaurus-plugin-content-docs, docusaurus
    • #1957 refactor(v2): avoid synchronous/ blocking operation when possible (@endiliey)

πŸ“ 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
    • #1951 perf(v2): skip runtime fileHash cache in prod & get timestamp asynchronously (@endiliey)
    • #1950 perf(v2): more efficient hot reload & consistent filegen (@endiliey)

Committers: 3

docusaurus - v2.0.0-alpha.33

Published by endiliey almost 5 years ago

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 prismTheme is renamed to theme as part new prism object in themeConfig field in your docusaurus.config.js. Eg:
     themeConfig: {
    -   prismTheme: require('prism-react-renderer/themes/dracula'),
    +   prism: {
    +     theme: require('prism-react-renderer/themes/dracula'),
    +   },
    },
    
  • Added new prism option defaultLanguage that 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_ENV is now consistently set to development.
  • 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.js to create custom docs page for /docs or even src/pages/docs/super.js to 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",
  }
}
docusaurus - v2.0.0-alpha.32

Published by endiliey almost 5 years ago

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 CodeBlock theme component, it is recommended to update your source code to have this feature.
    (#1860)

Bug Fixes

  • Fix @theme/Tabs component to be able to create tabs with only one item.
  • Fix MDX @theme/Heading component. If there is no id, it should not create anchor link.
  • Fixed a bug in which if themeConfig.algolia is not defined, the custom searchbar won't appear.
    If you've swizzled Algolia SearchBar component 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_SSH env variable during deployment to be the same as in v1.
  • Fix accessing docs/ or /docs/xxxx that does not match any existing doc page should return 404 (Not found) page, not blank page. (#1903)
  • Prioritize @docusaurus/core dependencies/ 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 encounter Module not found: core-js/modules/xxxx (because core-js@3 doesn't have that).
  • Fix a bug where docs plugin add /docs route 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-xxx will request for next and prev blog post metadata too aside from target post metadata. We should only request target post metadata.
    (#1908)

Others

  • Convert sitemap plugin to TypeScript. (#1894)
  • Refactor dark mode toggle into a hook. (#1899)
docusaurus - v2.0.0-alpha.31

Published by endiliey almost 5 years ago

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 to false, 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
docusaurus - v2.0.0-alpha.30

Published by endiliey almost 5 years ago

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 contains docusaurus word 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 https://github.com/webpack/webpack/issues/4039#issuecomment-477779322 and https://github.com/webpack/webpack/issues/4039#issuecomment-273804003 for more context.

docusaurus - v2.0.0-alpha.29

Published by endiliey almost 5 years ago

2.0.0-alpha.29

HOTFIX for 2.0.0-alpha.28.

  • Fix missing core-js dependencies on @docusaurus/core.
  • Fix wrong @babel/env preset configuration that causes build compilation error.
  • Improved UI for webpack compilation progress bar.
docusaurus - v2.0.0-alpha.28

Published by endiliey almost 5 years ago

2.0.0-alpha.28

  • BREAKING withBaseUrl is renamed to useBaseUrl because its a React Hooks. Make sure you import/rename it correctly. Eg: import useBaseUrl from '@docusaurus/useBaseUrl;
  • Further reduce memory usage to avoid heap memory allocation failure.
  • Fix keywords frontmatter for SEO not working properly.
  • Fix swizzle command not passing context properly to theme packages.
  • Add extendCli api for plugins. This will allow plugin to further extend Docusaurus CLI.
  • Fix swizzle command not being able to swizzle single js file.
  • Fix logo URL in footer to be appended with baseUrl automatically.
  • Add the option --no-open for start command.
  • Set @babel/env useBuiltins to usage. This will automatically use browserlist and import polyfills required.
  • Modified TerserWebpackPlugin terserOptions for better cross-browser compatibility.
  • Fix potential security vulnerability because we're exposing the directory structure of the host machine.
  • Upgrade dependencies.
docusaurus - v1.14.0

Published by yangshun almost 5 years ago

Added

  • feat: allow specifying meta desc in front matter (#1859)

See CHANGELOG.md for more details.

docusaurus - v2.0.0-alpha.27

Published by endiliey about 5 years ago

  • Add @theme/Tabs which can be used to implement multi-language code tabs.
  • Implement custom_edit_url and hide_title markdown header for docusaurus v1 feature parity.
  • Reduce memory usage and slightly faster production build.
  • Misc dependency upgrades.
docusaurus - v2.0.0-alpha.26

Published by endiliey about 5 years ago

2.0.0-alpha.26

  • Docs, pages plugin is rewritten in TypeScript
  • Docs improvements and tweaks
    • Improved metadata which results in smaller bundle size.
    • Docs sidebar can now be more than one level deep, theoretically up to infinity
    • Collapsible docs sidebar!
    • Make doc page title larger
    • Add editUrl option (URL for editing) to docs plugin. If this field is set, there will be an "Edit this page" link for each doc page. Example: 'https://github.com/facebook/docusaurus/edit/master/docs'
    • Add showLastUpdateTime and showLastUpdateAuthor options to docs plugin to further achieve v1 parity of showing last update data for a particular doc
  • Slight tweaks to the Blog components - blog title is larger now
  • Code Blocks
    • Change default theme from Night Owl to Palenight
    • Slight tweaks to playground/preview components
  • Add scripts and stylesheets field to docusaurus.config.
  • More documentation on https://v2.docusaurus.io

See CHANGELOG for more info.