From e287d6fe158ac6d590d0371fa9cf6ffe83cc02e2 Mon Sep 17 00:00:00 2001 From: jspark Date: Mon, 21 Aug 2023 20:15:43 +0900 Subject: i18n(ko-KR): translate `getting-started.mdx` (#540) Co-authored-by: Chris Swithinbank --- docs/src/content/docs/ko/getting-started.mdx | 134 +++++++++++++++++++++++++++ 1 file changed, 134 insertions(+) create mode 100644 docs/src/content/docs/ko/getting-started.mdx diff --git a/docs/src/content/docs/ko/getting-started.mdx b/docs/src/content/docs/ko/getting-started.mdx new file mode 100644 index 00000000..c4c0bc06 --- /dev/null +++ b/docs/src/content/docs/ko/getting-started.mdx @@ -0,0 +1,134 @@ +--- +title: 시작하기 +description: Astro의 Starlight를 이용해 최신 문서 웹사이트를 만드는 방법을 배워보세요. +--- + +import { Tabs, TabItem } from '@astrojs/starlight/components'; + +:::caution[개발 중] +Starlight는 현재 초기 개발 단계에 있습니다. +버그를 발견했다면, [GitHub issues](https://github.com/withastro/starlight/issues/new/choose) 또는 [Discord](https://astro.build/chat) 를 통해 저희에게 알려주세요. +::: + +## 새 프로젝트 시작하기 + +Starlight는 [Astro](https://astro.build) 프레임워크 위에 구축된 모든 기능을 갖춘 문서 테마입니다. + +다음 명령을 사용하여 새로운 Astro + Starlight 프로젝트를 만들 수 있습니다. + + + + +```sh +# npm을 사용해 새로운 프로젝트 생성 +npm create astro@latest -- --template starlight +``` + + + + +```sh +# pnpm을 사용해 새로운 프로젝트 생성 +pnpm create astro --template starlight +``` + + + + +```sh +# yarn을 사용해 새로운 프로젝트 생성 +yarn create astro --template starlight +``` + + + + +이렇게 하면 웹 사이트에 필요한 파일들과 설정을 갖춘 새로운 [프로젝트 디렉토리](/ko/guides/project-structure/) 가 생성됩니다. + +:::tip[시도해보기] +브라우저에서 Starlight 시작하기: +[StackBlitz에서 템플릿 열기](https://stackblitz.com/github/withastro/starlight/tree/main/examples/basics). +::: + +## Starlight로 컨텐츠 생성하기 + +Starlight는 새로운 컨텐츠를 추가하거나 기존 파일을 가져올 준비가 되어 있습니다! + +### 파일 형식 + +Starlight에서는 Markdown 및 MDX를 이용해 컨텐츠를 생성할 수 있습니다. (실험적 [Astro Markdoc 통합](https://docs.astro.build/en/guides/integrations-guide/markdoc/) 을 설치하여 Markdoc을 사용할 수도 있습니다.) + +### 페이지 추가 + +`src/content/docs/` 에 `.md` 또는 `.mdx` 파일을 추가하여 웹 사이트에 새로운 페이지를 추가할 수 있습니다. 파일을 구성하고 여러 경로 세그먼트를 생성하기 위해 하위 폴더를 추가하세요. + +``` +src/content/docs/hello-world.md => your-site.com/hello-world +src/content/docs/guides/faq.md => your-site.com/guides/faq +``` + +### 타입 안정성을 갖춘 frontmatter + +모든 Starlight 페이지는 페이지 표시 방법을 제어하기 위한 사용자 지정 가능한 [공통 frontmatter 속성 세트](/ko/reference/frontmatter/) 를 공유합니다. + +```md +--- +title: Hello, World! +description: This is a page in my Starlight-powered site +--- +``` + +중요한 것을 잊어버렸다면, Starlight가 알려줄 것입니다. + +## Starlight 웹사이트 배포하기 + +Starlight 웹 사이트를 만들고 사용자 정의한 후에는 웹 서버 또는 Netlify, Vercel, GitHub Pages 등 원하는 호스팅 플랫폼에 배포할 수 있습니다. + +[Astro 문서에서 Astro 웹 사이트를 배포하는 방법에 대해 알아보세요.](https://docs.astro.build/en/guides/deploy/) + +## Starlight 업데이트 + +:::tip +Starlight는 베타 소프트웨어이기 때문에 자주 업데이트되고 개선될 것입니다. Starlight를 정기적으로 업데이트하세요! +::: + +Starlight는 Astro 통합이며 `@astrojs/*` 통합처럼 업데이트됩니다. + + + + +```sh +# npm으로 Starlight 업데이트 +npm install @astrojs/starlight@latest +``` + + + + +```sh +# pnpm으로 Starlight 업데이트 +pnpm upgrade @astrojs/starlight --latest +``` + + + + +```sh +# yarn으로 Starlight 업데이트 +yarn upgrade @astrojs/starlight --latest +``` + + + + +[Starlight 변경 로그](https://github.com/withastro/starlight/blob/main/packages/starlight/CHANGELOG.md) 에서 각 릴리스의 전체 변경 목록을 확인할 수 있습니다. + +## Starlight 문제 해결 + +Starlight [프로젝트 설정](/ko/reference/configuration/) 및 [개별 페이지 frontmatter 설정](/ko/reference/frontmatter/) 정보는 모두 이 웹 사이트의 참조 섹션에서 확인할 수 있습니다. 이 페이지를 통해 Starlight 웹 사이트가 제대로 설정되고 작동하는지 확인하세요. + +컨텐츠 추가 및 Starlight 웹 사이트 사용자 지정에 대한 도움말은 사이드바에서 가이드 섹션을 참조하세요. + +이 문서에서 답변을 찾을 수 없는 경우, 완전한 Astro 문서를 읽기 위해 [전체 Astro 문서](https://docs.astro.build) 에 방문하세요. 당신의 질문에 대한 답변은 이 Starlight 테마 아래에서 Astro가 어떻게 작동하는지 이해함으로써 얻을 수 있을 것입니다. + +활발하고 친근한 커뮤니티인 [Astro Discord](https://astro.build/chat/) 에서 도움을 받을 수도 있습니다! `#support` 포럼에 질문을 게시하거나 `#starlight` 채널에 방문하여 현재 개발 등에 대해 토론할 수도 있습니다! -- cgit