fix(live-codeblock): render static codeblock server-side (#5754)

Co-authored-by: slorber <lorber.sebastien@gmail.com>

package.json

@@ -21,6 +21,7 @@
     "build:website:baseUrl": "yarn workspace website build:baseUrl",
     "build:website:blogOnly": "yarn workspace website build:blogOnly",
     "build:website:deployPreview": "cross-env NETLIFY=true CONTEXT='deploy-preview' yarn workspace website build",
+    "build:website:fast": "yarn workspace website build:fast",
     "build:website:en": "yarn workspace website build --locale en",
     "clear:website": "yarn workspace website clear",
     "serve:website": "yarn workspace website serve",

packages/docusaurus-theme-classic/src/theme/CodeBlock/index.tsx

@@ -101,7 +101,7 @@ const highlightDirectiveRegex = (lang: string) => {
 
 export default function CodeBlock({
   children,
-  className: languageClassName,
+  className: blockClassName,
   metastring,
   title,
 }: Props): JSX.Element {
@@ -141,6 +141,9 @@ export default function CodeBlock({
     highlightLines = rangeParser(highlightLinesRange).filter((n) => n > 0);
   }
 
+  const languageClassName = blockClassName
+    ?.split(' ')
+    .find((str) => str.startsWith('language-'));
   let language = languageClassName?.replace(/language-/, '') as Language;
 
   if (!language && prism.defaultLanguage) {
@@ -209,7 +212,11 @@ export default function CodeBlock({
       code={code}
       language={language}>
       {({className, style, tokens, getLineProps, getTokenProps}) => (
-        <div className={styles.codeBlockContainer}>
+        <div
+          className={clsx(
+            styles.codeBlockContainer,
+            blockClassName?.replace(/language-[^ ]+/, ''),
+          )}>
           {codeBlockTitle && (
             <div style={style} className={styles.codeBlockTitle}>
               {codeBlockTitle}

packages/docusaurus-theme-live-codeblock/src/theme/Playground/index.js

@@ -10,14 +10,20 @@ import {LiveProvider, LiveEditor, LiveError, LivePreview} from 'react-live';
 import clsx from 'clsx';
 import Translate from '@docusaurus/Translate';
 import useDocusaurusContext from '@docusaurus/useDocusaurusContext';
-import useIsBrowser from '@docusaurus/useIsBrowser';
+import BrowserOnly from '@docusaurus/BrowserOnly';
 import usePrismTheme from '@theme/hooks/usePrismTheme';
 import styles from './styles.module.css';
+import useIsBrowser from '@docusaurus/core/lib/client/exports/useIsBrowser';
 
 function Header({children}) {
   return <div className={clsx(styles.playgroundHeader)}>{children}</div>;
 }
 
+function LivePreviewLoader() {
+  // Is it worth improving/translating?
+  return <div>Loading...</div>;
+}
+
 function ResultWithHeader() {
   return (
     <>
@@ -28,14 +34,33 @@ function ResultWithHeader() {
           Result
         </Translate>
       </Header>
+      {/* https://github.com/facebook/docusaurus/issues/5747 */}
       <div className={styles.playgroundPreview}>
-        <LivePreview />
-        <LiveError />
+        <BrowserOnly fallback={<LivePreviewLoader />}>
+          {() => (
+            <>
+              <LivePreview />
+              <LiveError />
+            </>
+          )}
+        </BrowserOnly>
       </div>
     </>
   );
 }
 
+function ThemedLiveEditor() {
+  const isBrowser = useIsBrowser();
+  return (
+    <LiveEditor
+      // We force remount the editor on hydration,
+      // otherwise dark prism theme is not applied
+      key={isBrowser}
+      className={styles.playgroundEditor}
+    />
+  );
+}
+
 function EditorWithHeader() {
   return (
     <>
@@ -46,13 +71,12 @@ function EditorWithHeader() {
           Live Editor
         </Translate>
       </Header>
-      <LiveEditor className={styles.playgroundEditor} />
+      <ThemedLiveEditor />
     </>
   );
 }
 
 export default function Playground({children, transformCode, ...props}) {
-  const isBrowser = useIsBrowser();
   const {
     siteConfig: {
       themeConfig: {
@@ -65,8 +89,7 @@ export default function Playground({children, transformCode, ...props}) {
   return (
     <div className={styles.playgroundContainer}>
       <LiveProvider
-        key={isBrowser}
-        code={isBrowser ? children.replace(/\n$/, '') : ''}
+        code={children.replace(/\n$/, '')}
         transformCode={transformCode || ((code) => `${code};`)}
         theme={prismTheme}
         {...props}>

website/docusaurus.config.js

@@ -38,6 +38,9 @@ const isDev = process.env.NODE_ENV === 'development';
 const isDeployPreview =
   process.env.NETLIFY && process.env.CONTEXT === 'deploy-preview';
 
+// Used to debug production build issues faster
+const isBuildFast = !!process.env.BUILD_FAST;
+
 const baseUrl = process.env.BASE_URL || '/';
 
 // Special deployment for staging locales until they get enough translations
@@ -252,10 +255,11 @@ const config = {
           rehypePlugins: [katex],
           disableVersioning: isVersioningDisabled,
           lastVersion: isDev ? 'current' : undefined,
-          onlyIncludeVersions:
-            !isVersioningDisabled && (isDev || isDeployPreview)
-              ? ['current', ...versions.slice(0, 2)]
-              : undefined,
+          onlyIncludeVersions: isBuildFast
+            ? ['current']
+            : !isVersioningDisabled && (isDev || isDeployPreview)
+            ? ['current', ...versions.slice(0, 2)]
+            : undefined,
           versions: {
             current: {
               label: `${getNextBetaVersionName()} 🚧`,

website/package.json

@@ -16,6 +16,7 @@
     "build:baseUrl": "cross-env BASE_URL='/build/' yarn build",
     "start:blogOnly": "cross-env yarn start --config=docusaurus.config-blog-only.js",
     "build:blogOnly": "cross-env yarn build --config=docusaurus.config-blog-only.js",
+    "build:fast": "cross-env BUILD_FAST=true yarn build --locale en",
     "netlify:build:production": "yarn docusaurus write-translations && yarn netlify:crowdin:delay && yarn netlify:crowdin:uploadSources && yarn netlify:crowdin:downloadTranslations && yarn build",
     "netlify:build:deployPreview": "yarn docusaurus write-translations --locale fr --messagePrefix '(fr) ' && yarn build",
     "netlify:crowdin:delay": "node delayCrowdin.js",