3pp-mirror/docusaurus
1
0
Fork 0
mirror of https://github.com/facebook/docusaurus.git synced 2025-06-12 07:42:34 +02:00
Code Issues Projects Releases Packages Wiki Activity

refactor(theme-classic): add comments to Prism setup; minor refactor (#6391)

Browse source
This commit is contained in:
Joshua Chen 2022-01-18 19:46:22 +08:00 • committed by GitHub
parent 7bab9ba46d
commit 1d7827d572
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 16 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

9
packages/docusaurus-theme-classic/src/index.ts
View file

@ -18,13 +18,13 @@ import type {Plugin as PostCssPlugin} from 'postcss';
import rtlcss from 'rtlcss';
import {readDefaultCodeTranslationMessages} from '@docusaurus/theme-translations';
import type {Options} from '@docusaurus/theme-classic';
import type webpack from 'webpack';
const requireFromDocusaurusCore = createRequire(
require.resolve('@docusaurus/core/package.json'),
);
const ContextReplacementPlugin = requireFromDocusaurusCore(
'webpack/lib/ContextReplacementPlugin',
);
const ContextReplacementPlugin: typeof webpack.ContextReplacementPlugin =
requireFromDocusaurusCore('webpack/lib/ContextReplacementPlugin');
// Need to be inlined to prevent dark mode FOUC
// Make sure that the 'storageKey' is the same as the one in `/theme/hooks/useTheme.js`
@ -172,6 +172,9 @@ export default function docusaurusThemeClassic(
return {
plugins: [
// This allows better optimization by only bundling those components
// that the user actually needs, because the modules are dynamically
// required and can't be known during compile time.
new ContextReplacementPlugin(
/prismjs[\\/]components$/,
new RegExp(`^./(${prismLanguages})$`),

13
packages/docusaurus-theme-classic/src/theme/prism-include-languages.ts
View file

@ -12,14 +12,21 @@ import type * as PrismNamespace from 'prismjs';
const prismIncludeLanguages = (PrismObject: typeof PrismNamespace): void => {
if (ExecutionEnvironment.canUseDOM) {
const {
themeConfig: {prism = {}},
themeConfig: {prism},
} = siteConfig;
const {additionalLanguages = []} = prism as {additionalLanguages: string[]};
const {additionalLanguages} = prism as {additionalLanguages: string[]};
// Prism components work on the Prism instance on the window, while
// prism-react-renderer uses its own Prism instance. We temporarily mount
// the instance onto window, import components to enhance it, then remove it
// to avoid polluting global namespace.
// You can mutate this object: registering plugins, deleting languages... As
// long as you don't re-assign it
window.Prism = PrismObject;
additionalLanguages.forEach((lang) => {
require(`prismjs/components/prism-${lang}`); // eslint-disable-line
// eslint-disable-next-line global-require, import/no-dynamic-require
require(`prismjs/components/prism-${lang}`);
});
delete (window as Window & {Prism?: typeof PrismNamespace}).Prism;