본문으둜 κ±΄λ„ˆλ›°κΈ°
버전: 2.0.1

πŸ“¦ plugin-content-pages

λ„νμ‚¬μš°λ£¨μŠ€μ˜ κΈ°λ³Έ νŽ˜μ΄μ§€ ν”ŒλŸ¬κ·ΈμΈμž…λ‹ˆλ‹€. ν΄λž˜μ‹ ν…œν”Œλ¦Ώμ—λŠ” κΈ°λ³Έ μ„€μ •μœΌλ‘œ ν”ŒλŸ¬κ·ΈμΈμ΄ ν¬ν•¨λ˜μ–΄ μžˆμŠ΅λ‹ˆλ‹€. νŽ˜μ΄μ§€ λ§Œλ“€κΈ° κΈ°λŠ₯을 μ œκ³΅ν•˜λŠ” ν”ŒλŸ¬κ·ΈμΈμž…λ‹ˆλ‹€.

μ„€μΉ˜β€‹

npm install --save @docusaurus/plugin-content-pages
팁

@docusaurus/preset-classic을 μ„€μΉ˜ν•œ κ²½μš°μ—λŠ” ν”ŒλŸ¬κ·ΈμΈμ„ λ”°λ‘œ μ„€μΉ˜ν•  ν•„μš”λŠ” μ—†μŠ΅λ‹ˆλ‹€.

μ—¬λŸ¬λΆ„μ€ 프리셋 μ˜΅μ…˜μ„ μ‚¬μš©ν•΄ ν”ŒλŸ¬κ·ΈμΈμ„ μ„€μ •ν•  수 μžˆμŠ΅λ‹ˆλ‹€.

섀정​

μ„€μ •ν•  수 μžˆλŠ” ν•„λ“œ

μ˜΅μ…˜λͺ…νƒ€μž…κΈ°λ³Έκ°’μ„€λͺ…
pathstring'src/pages'μ‚¬μ΄λ“œ 디렉토리에 μƒλŒ€μ μΈ 파일 μ‹œμŠ€ν…œμ˜ 데이터 κ²½λ‘œμž…λ‹ˆλ‹€. 디렉토리 λ‚΄ μ»΄ν¬λ„ŒνŠΈλŠ” μžλ™μœΌλ‘œ νŽ˜μ΄μ§€λ‘œ λ³€ν™˜λ©λ‹ˆλ‹€.
routeBasePathstring'/'μ‚¬μ΄νŠΈ νŽ˜μ΄μ§€ μ„Ήμ…˜μ— λŒ€ν•œ URL 라우트 트레일링 μŠ¬λž˜μ‹œλ₯Ό ν¬ν•¨ν•˜μ§€ λ§ˆμ„Έμš”.
includestring[]['**/*.{js,jsx,ts,tsx,md,mdx}']μΌμΉ˜ν•˜λŠ” 파일이 ν¬ν•¨λ˜μ–΄ μ²˜λ¦¬λ©λ‹ˆλ‹€.
excludestring[]μ„€μ • μ˜ˆμ‹œλ₯Ό μ°Έμ‘°ν•˜μ„Έμš”μΌμΉ˜ν•˜λŠ” νŒŒμΌμ— λŒ€ν•œ λΌμš°νŠΈκ°€ μƒμ„±λ˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€.
mdxPageComponentstring'@theme/MDXPage'각 MDX νŽ˜μ΄μ§€μ—μ„œ μ‚¬μš©ν•˜λŠ” μ»΄ν¬λ„ŒνŠΈ
remarkPlugins[]any[]MDX에 μ „λ‹¬λœ Remark ν”ŒλŸ¬κ·ΈμΈ
rehypePlugins[]any[]MDX에 μ „λ‹¬λœ Rehype ν”ŒλŸ¬κ·ΈμΈ
beforeDefaultRemarkPluginsany[][]κΈ°λ³Έ λ„νμ‚¬μš°λ£¨μŠ€ Remark ν”ŒλŸ¬κ·ΈμΈλ³΄λ‹€ λ¨Όμ € MDX에 μ „λ‹¬λœ μ‚¬μš©μž 지정 Remark ν”ŒλŸ¬κ·ΈμΈ
beforeDefaultRehypePluginsany[][]κΈ°λ³Έ λ„νμ‚¬μš°λ£¨μŠ€ Rehype ν”ŒλŸ¬κ·ΈμΈλ³΄λ‹€ λ¨Όμ € MDX에 μ „λ‹¬λœ μ‚¬μš©μž 지정 Rehype ν”ŒλŸ¬κ·ΈμΈ

μ„€μ • μ˜ˆμ‹œβ€‹

프리셋 μ˜΅μ…˜μ΄λ‚˜ ν”ŒλŸ¬κ·ΈμΈ μ˜΅μ…˜μ—μ„œ ν”ŒλŸ¬κ·ΈμΈμ„ μ„€μ •ν•  수 μžˆμŠ΅λ‹ˆλ‹€.

팁

λŒ€λΆ€λΆ„μ˜ λ„νμ‚¬μš°λ£¨μŠ€ μ‚¬μš©μžλŠ” 프리셋 μ˜΅μ…˜μ„ μ‚¬μš©ν•΄ ν”ŒλŸ¬κ·ΈμΈμ„ μ„€μ •ν•©λ‹ˆλ‹€.

If you use a preset, configure this plugin through the preset options:

docusaurus.config.js
module.exports = {
presets: [
[
'@docusaurus/preset-classic',
{
pages: {
path: 'src/pages',
routeBasePath: '',
include: ['**/*.{js,jsx,ts,tsx,md,mdx}'],
exclude: [
'**/_*.{js,jsx,ts,tsx,md,mdx}',
'**/_*/**',
'**/*.test.{js,jsx,ts,tsx}',
'**/__tests__/**',
],
mdxPageComponent: '@theme/MDXPage',
remarkPlugins: [require('remark-math')],
rehypePlugins: [],
beforeDefaultRemarkPlugins: [],
beforeDefaultRehypePlugins: [],
},
},
],
],
};

i18n​

i18n μ†Œκ°œ λ¬Έμ„œλ₯Ό λ¨Όμ € ν™•μΈν•΄μ£Όμ„Έμš”.

λ²ˆμ—­ 파일 μœ„μΉ˜β€‹

  • Base 경둜: website/i18n/[locale]/docusaurus-plugin-content-pages
  • λ©€ν‹° μΈμŠ€ν„΄μŠ€ 경둜: website/i18n/[locale]/docusaurus-plugin-content-pages-[pluginId]
  • JSON 파일: docusaurus write-translations λͺ…λ Ή μ‹€ν–‰ ν›„ λ§Œλ“€μ–΄μ§„ 파일
  • λ§ˆν¬λ‹€μš΄ 파일: website/i18n/[locale]/docusaurus-plugin-content-pages

파일 μ‹œμŠ€ν…œ ꡬ쑰 μ˜ˆβ€‹

website/i18n/[locale]/docusaurus-plugin-content-pages
β”‚
β”‚ # translations for website/src/pages
β”œβ”€β”€ first-markdown-page.md
└── second-markdown-page.md