summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJunseong Park2024-09-07 20:35:33 +0900
committerGitHub2024-09-07 13:35:33 +0200
commitaa64236954291e5f728d3fc1c430b7dd0bcb59bf (patch)
tree7a3eeddcfda88a52fdfadb1128c508d412f70713
parent21b59325b1d45372d229c596e04bea2ed4ca94b7 (diff)
downloadIT.starlight-aa64236954291e5f728d3fc1c430b7dd0bcb59bf.tar.gz
IT.starlight-aa64236954291e5f728d3fc1c430b7dd0bcb59bf.tar.bz2
IT.starlight-aa64236954291e5f728d3fc1c430b7dd0bcb59bf.zip
i18n(ko-KR): update `authoring-content.mdx` (#2300)
-rw-r--r--docs/src/content/docs/ko/guides/authoring-content.mdx (renamed from docs/src/content/docs/ko/guides/authoring-content.md)115
1 files changed, 115 insertions, 0 deletions
diff --git a/docs/src/content/docs/ko/guides/authoring-content.md b/docs/src/content/docs/ko/guides/authoring-content.mdx
index 929deff0..4b640e93 100644
--- a/docs/src/content/docs/ko/guides/authoring-content.md
+++ b/docs/src/content/docs/ko/guides/authoring-content.mdx
@@ -390,3 +390,118 @@ Starlight๋Š” ๋ชฉ๋ก ๋ฐ ํ…Œ์ด๋ธ”๊ณผ ๊ฐ™์€ ๋‹ค๋ฅธ ๋ชจ๋“  Markdown ์ž‘์„ฑ ๊ตฌ๋ฌธ
## ๊ณ ๊ธ‰ Markdown ๋ฐ MDX ๊ตฌ์„ฑ
Starlight๋Š” remark ๋ฐ rehype๋ฅผ ๊ธฐ๋ฐ˜์œผ๋กœ ๊ตฌ์ถ•๋œ Astro์˜ Markdown ๋ฐ MDX ๋ Œ๋”๋Ÿฌ๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. Astro ๊ตฌ์„ฑ ํŒŒ์ผ์— `remarkPlugins` ๋˜๋Š” `rehypePlugins`๋ฅผ ์ถ”๊ฐ€ํ•˜์—ฌ ์‚ฌ์šฉ์ž ์ •์˜ ๊ตฌ๋ฌธ ๋ฐ ๋™์ž‘์— ๋Œ€ํ•œ ์ง€์›์„ ์ถ”๊ฐ€ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์ž์„ธํ•œ ๋‚ด์šฉ์€ Astro ๋ฌธ์„œ์˜ [Markdown ๋ฐ MDX ๊ตฌ์„ฑ](https://docs.astro.build/ko/guides/markdown-content/#configuring-markdown-and-mdx)์„ ์ฐธ์กฐํ•˜์„ธ์š”.
+
+## Markdoc
+
+Starlight๋Š” ์‹คํ—˜์ ์ธ [Astro Markdoc ํ†ตํ•ฉ](https://docs.astro.build/ko/guides/integrations-guide/markdoc/)๊ณผ Starlight Markdoc ํ”„๋ฆฌ์…‹์„ ์‚ฌ์šฉํ•˜์—ฌ Markdoc์œผ๋กœ ์ฝ˜ํ…์ธ ๋ฅผ ์ž‘์„ฑํ•  ์ˆ˜ ์žˆ๋„๋ก ์ง€์›ํ•ฉ๋‹ˆ๋‹ค.
+
+### Markdoc์œผ๋กœ ์ƒˆ ํ”„๋กœ์ ํŠธ ๋งŒ๋“ค๊ธฐ
+
+`create astro`๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ์‚ฌ์ „ ๊ตฌ์„ฑ๋œ Markdoc์ด ํฌํ•จ๋œ ์ƒˆ Starlight ํ”„๋กœ์ ํŠธ๋ฅผ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค:
+
+import { Tabs, TabItem, Steps } from '@astrojs/starlight/components';
+
+<Tabs syncKey="pkg">
+<TabItem label="npm">
+
+```sh
+npm create astro@latest -- --template starlight/markdoc
+```
+
+</TabItem>
+<TabItem label="pnpm">
+
+```sh
+pnpm create astro --template starlight/markdoc
+```
+
+</TabItem>
+<TabItem label="Yarn">
+
+```sh
+yarn create astro --template starlight/markdoc
+```
+
+</TabItem>
+</Tabs>
+
+### ๊ธฐ์กด ํ”„๋กœ์ ํŠธ์— Markdoc ์ถ”๊ฐ€ํ•˜๊ธฐ
+
+์ด๋ฏธ Starlight ์‚ฌ์ดํŠธ๊ฐ€ ์žˆ๊ณ  Markdoc์„ ์ถ”๊ฐ€ํ•˜๋ ค๋Š” ๊ฒฝ์šฐ ๋‹ค์Œ ๋‹จ๊ณ„๋ฅผ ๋”ฐ๋ฅด์„ธ์š”.
+
+<Steps>
+
+1. Astro์˜ Markdoc ํ†ตํ•ฉ์„ ์ถ”๊ฐ€ํ•˜์„ธ์š”:
+
+ <Tabs syncKey="pkg">
+
+ <TabItem label="npm">
+
+ ```sh
+ npx astro add markdoc
+ ```
+
+ </TabItem>
+
+ <TabItem label="pnpm">
+
+ ```sh
+ pnpm astro add markdoc
+ ```
+
+ </TabItem>
+
+ <TabItem label="Yarn">
+
+ ```sh
+ yarn astro add markdoc
+ ```
+
+ </TabItem>
+
+ </Tabs>
+
+2. Starlight Markdoc ํ”„๋ฆฌ์…‹์„ ์„ค์น˜ํ•ฉ๋‹ˆ๋‹ค:
+
+ <Tabs syncKey="pkg">
+
+ <TabItem label="npm">
+
+ ```sh
+ npm install @astrojs/starlight-markdoc
+ ```
+
+ </TabItem>
+
+ <TabItem label="pnpm">
+
+ ```sh
+ pnpm add @astrojs/starlight-markdoc
+ ```
+
+ </TabItem>
+
+ <TabItem label="Yarn">
+
+ ```sh
+ yarn add @astrojs/starlight-markdoc
+ ```
+
+ </TabItem>
+
+ </Tabs>
+
+3. `markdoc.config.mjs`์— Markdoc ๊ตฌ์„ฑ ํŒŒ์ผ์„ ๋งŒ๋“ค๊ณ  Starlight Markdoc ํ”„๋ฆฌ์…‹์„ ์‚ฌ์šฉํ•˜์„ธ์š”:
+
+ ```js
+ import { defineMarkdocConfig } from '@astrojs/markdoc/config';
+ import starlightMarkdoc from '@astrojs/starlight-markdoc';
+
+ export default defineMarkdocConfig({
+ extends: [starlightMarkdoc()],
+ });
+ ```
+
+</Steps>
+
+Markdoc ๊ตฌ๋ฌธ ๋ฐ ๊ธฐ๋Šฅ์— ๋Œ€ํ•œ ์ž์„ธํ•œ ๋‚ด์šฉ์€ [Markdoc ๋ฌธ์„œ](https://markdoc.dev/docs/syntax) ๋˜๋Š” [Astro Markdoc ํ†ตํ•ฉ ๊ฐ€์ด๋“œ](https://docs.astro.build/ko/guides/integrations-guide/markdoc/)๋ฅผ ์ฐธ์กฐํ•˜์„ธ์š”. \ No newline at end of file