diff options
author | Junseong Park | 2024-09-07 20:35:33 +0900 |
---|---|---|
committer | GitHub | 2024-09-07 13:35:33 +0200 |
commit | aa64236954291e5f728d3fc1c430b7dd0bcb59bf (patch) | |
tree | 7a3eeddcfda88a52fdfadb1128c508d412f70713 | |
parent | 21b59325b1d45372d229c596e04bea2ed4ca94b7 (diff) | |
download | IT.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 |