Skip to content

Commit

Permalink
i18n(ko-KR): update multiple pages (withastro#634)
Browse files Browse the repository at this point in the history
  • Loading branch information
@jsparkdev
jsparkdev committed Sep 2, 2023
1 parent 0e80c39 commit 46ae545
Show file tree
Hide file tree
Showing 11 changed files with 115 additions and 111 deletions.
32 changes: 16 additions & 16 deletions docs/src/content/docs/ko/environmental-impact.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ description: Starlight가 어떻게 친환경 문서 사이트를 구축하고
---

웹 산업이 기후에 미치는 영향에 대한 추정치는 [2%][sf] ~ [전 세계 탄소 배출량의 4%][bbc] 범위이며, 이는 항공 산업의 배출량과 비슷합니다.
웹 사이트의 생태학적 영향을 계산하는 데는 여러 복잡한 요소가 있지만 이 가이드에는 문서 사이트의 환경 영향을 줄이기 위한 몇 가지 팁이 포함되어 있습니다.
웹 사이트의 생태학적 영향을 계산하는 데는 여러 복잡한 요소가 있지만 이 가이드에는 문서 사이트의 환경적 영향을 줄이기 위한 몇 가지 팁이 포함되어 있습니다.

좋은 소식은 Starlight를 선택하는 것이 좋은 시작이라는 것입니다.
웹사이트 탄소 계산기에 따르면 이 사이트는 [테스트된 웹페이지의 99%보다 깨끗하며][sl-carbon] 페이지 방문당 0.01g의 CO2를 배출합니다.
Expand All @@ -14,24 +14,24 @@ description: Starlight가 어떻게 친환경 문서 사이트를 구축하고
웹페이지가 전송하는 데이터가 많을수록 더 많은 에너지 자원이 필요합니다.
2023년 4월, [HTTP 아카이브의 데이터][http]에 따르면 웹페이지 중앙값은 2,000KB 이상을 다운로드해야 했습니다.

Starlight는 가능한 한 가벼운 페이지를 구축합니다.
예를 들어, 첫 번째 방문 시 사용자는 50KB 미만의 압축 데이터를 다운로드하게 됩니다. 이는 HTTP 아카이브 중앙값의 2.5%에 불과합니다.
Starlight는 최대한 가벼운 페이지를 구축합니다.
예를 들어, 사용자는 첫 번째 방문 시 50KB 미만의 압축 데이터를 다운로드하게 됩니다. 이는 HTTP 아카이브 중앙값의 2.5%에 불과합니다.
좋은 캐싱 전략을 사용하면 후속 탐색에서 10KB 정도만 다운로드할 수 있습니다.

### 이미지

Starlight는 좋은 기준을 제공하지만 문서 페이지에 이미지를 추가하면 페이지 크기가 빠르게 늘어날 수 있습니다.
Starlight는 Astro의 [최적화된 자산 지원][assets]을 사용하여 Markdown 및 MDX 파일의 로컬 이미지를 최적화합니다.
Starlight는 좋은 기준을 제공하지만 문서 페이지에 이미지를 추가하면 페이지의 크기가 빠르게 증가할 수 있습니다.
Starlight는 Astro의 [최적화된 자산 지원][assets]을 사용하여 Markdown 및 MDX 파일에서 추가한 로컬 이미지를 최적화합니다.

### UI 컴포넌트

React 또는 Vue와 같은 UI 프레임워크로 구축된 컴포넌트는 페이지에 많은 양의 JavaScript를 쉽게 추가할 수 있습니다.
Starlight는 Astro 기반으로 구축되었고, 이와 같은 컴포넌트는 [Astro Islands][islands] 덕분에 **기본적으로 클라이언트 측 JavaScript가 전혀 로드되지 않습니다**.
React 또는 Vue와 같은 UI 프레임워크로 구축된 컴포넌트는 페이지에 많은 양의 JavaScript를 쉽게 추가합니다.
Starlight는 Astro 기반으로 구축되었고, Astro 자체 컴포넌트는 [Astro Islands][islands] 덕분에 **기본적으로 클라이언트 측 JavaScript가 전혀 로드되지 않습니다**.

### 캐싱

캐싱은 브라우저가 이미 다운로드한 데이터를 저장하고 재사용하는 기간을 제어하는 ​​데 사용됩니다.
좋은 캐싱 전략은 컨텐츠가 변경될 때 새 컨텐츠를 가능한 한 빨리 얻을 수 있도록 하며, 변경되지 않은 동일한 컨텐츠를 무의미하게 반복해서 다운로드하는 것을 방지합니다.
좋은 캐싱 전략은 콘텐츠가 변경될 때 새 콘텐츠를 최대한 빨리 얻을 수 있도록 하며, 변경되지 않은 동일한 콘텐츠를 무의미하게 반복해서 다운로드하는 것을 방지합니다.

캐싱을 구성하는 가장 일반적인 방법은 [`Cache-Control` HTTP 헤더][cache]를 사용하는 것입니다.
Starlight를 사용할 때 `/_astro/` 디렉토리의 모든 항목에 대해 긴 캐시 시간을 설정할 수 있습니다.
Expand All @@ -55,17 +55,17 @@ Cache-Control: public, max-age=604800, immutable

## 전력 소비

웹페이지가 구축되는 방식은 사용자 장치에서 실행하는 데 필요한 전력에 영향을 미칠 수 있습니다. Starlight는 최소한의 JavaScript를 사용하여 사용자의 휴대폰, 태블릿 또는 컴퓨터가 페이지를 로드하고 렌더링하는 데 필요한 전력을 줄입니다.
웹 페이지가 구축되는 방식은 사용자 장치를 실행하는 데 필요한 전력에 영향을 미칠 수 있습니다. Starlight는 최소한의 JavaScript를 사용하여 사용자의 휴대폰, 태블릿 또는 컴퓨터가 페이지를 로드하고 렌더링하는 데 필요한 전력을 감소시킵니다.

분석 추적 스크립트나 동영상 삽입과 같은 JavaScript 중심 콘텐츠를 추가할 때 페이지 전력 사용량이 증가할 수 있으므로 주의하세요.
분석 추적 스크립트나 동영상 삽입과 같은 JavaScript 중심 콘텐츠를 추가할 때 페이지의 전력 사용량이 증가할 수 있으므로 주의하세요.
분석이 필요한 경우 [Cabin][cabin], [Fathom][fathom] 또는 [Plausible][plausible]과 같은 경량 옵션을 선택하는 것이 좋습니다.
YouTube 및 Vimeo 동영상과 같은 삽입은 [사용자 상호 작용 시 동영상 로드][lazy-video]를 기다리면 개선될 수 있습니다.
YouTube 및 Vimeo와 같은 동영상 삽입은 [상호 작용 시 동영상 로드][lazy-video]를 기다리면 개선될 수 있습니다.
[`astro-embed`][embed]와 같은 패키지는 일반적인 서비스에 도움이 될 수 있습니다.

:::tip[알고 계셨나요?]

JavaScript를 분석하고 컴파일하는 것은 브라우저가 수행해야 하는 가장 비용이 많이 드는 작업 중 하나입니다.
동일한 크기의 JPEG 이미지를 렌더링하는 것을 비교해보면 [JavaScript는 처리하는 데 30배 이상 더 오래 걸릴 수 있습니다][cost-of-js].
JavaScript를 분석하고 컴파일하는 것은 브라우저가 수행해야 하는 비용이 가장 많이 드는 작업 중 하나입니다.
동일한 크기의 JPEG 이미지를 렌더링하는 것을 다른 언어들과 비교해보면 [JavaScript는 처리하는 데 30배 이상 더 오래 걸릴 수 있습니다][cost-of-js].

:::

Expand Down Expand Up @@ -131,11 +131,11 @@ JavaScript를 분석하고 컴파일하는 것은 브라우저가 수행해야
- [“더 친환경적인 웹 구축”](https://youtu.be/EfPoOt7T5lg), Michelle Barker의 강연
- [“조직 내의 지속 가능한 웹 개발 전략”](https://www.smashingmagazine.com/2022/10/sustainable-web-development-strategies-organization/), Michelle Barker의 기사
- [“모두를 위한 지속 가능한 웹”](https://2021.stateofthebrowser.com/speakers/tom-greenwood/), Tom Greenwood의 강연
- [“웹 컨텐츠가 전력 사용량에 미치는 영향”](https://webkit.org/blog/8970/how-web-content-can-affect-power-usage/), Benjamin Poulain 및 Simon Fraser의 기사
- [“웹 콘텐츠가 전력 사용량에 미치는 영향”](https://webkit.org/blog/8970/how-web-content-can-affect-power-usage/), Benjamin Poulain 및 Simon Fraser의 기사

[sf]: https://www.sciencefocus.com/science/what-is-the-carbon-footprint-of-the-internet/
[bbc]: https://www.bbc.com/future/article/20200305-why-your-internet-habits-are-not-as-clean-as-you-think
[http]: https://httparchive.org/reports/state-of-the-web
[assets]: https://docs.astro.build/en/guides/assets/
[islands]: https://docs.astro.build/en/concepts/islands/
[assets]: https://docs.astro.build/ko/guides/assets/
[islands]: https://docs.astro.build/ko/concepts/islands/
[wcc]: https://www.websitecarbon.com/
26 changes: 13 additions & 13 deletions docs/src/content/docs/ko/getting-started.mdx
View file
Original file line number Diff line number Diff line change
Expand Up @@ -45,13 +45,13 @@ yarn create astro --template starlight
[StackBlitz에서 템플릿 열기](https://stackblitz.com/github/withastro/starlight/tree/main/examples/basics).
:::

## Starlight로 컨텐츠 생성하기
## Starlight로 콘텐츠 생성하기

Starlight는 새로운 컨텐츠를 추가하거나 기존 파일을 가져올 준비가 되어 있습니다!
Starlight는 새로운 콘텐츠를 추가하거나 기존 파일을 가져올 준비가 되어 있습니다!

### 파일 형식

Starlight에서는 Markdown 및 MDX를 이용해 컨텐츠를 생성할 수 있습니다. (실험적 [Astro Markdoc 통합](https://docs.astro.build/en/guides/integrations-guide/markdoc/) 을 설치하여 Markdoc을 사용할 수도 있습니다.)
Starlight에서는 Markdown 및 MDX를 이용해 콘텐츠를 생성할 수 있습니다. (실험적 기능인 [Astro Markdoc 통합](https://docs.astro.build/ko/guides/integrations-guide/markdoc/)을 설치하여 Markdoc을 사용할 수도 있습니다.)

### 페이지 추가

Expand All @@ -64,22 +64,22 @@ src/content/docs/guides/faq.md => your-site.com/guides/faq

### 타입 안정성을 갖춘 frontmatter

모든 Starlight 페이지는 페이지 표시 방법을 제어하기 위한 사용자 지정 가능한 [공통 frontmatter 속성 세트](/ko/reference/frontmatter/) 를 공유합니다.
모든 Starlight 페이지는 페이지 표시 방법을 제어하기 위해 사용자가 원하는대로 변경 가능한 [공통 frontmatter 속성 세트](/ko/reference/frontmatter/)를 공유합니다.

```md
---
title: Hello, World!
description: This is a page in my Starlight-powered site
title: 안녕하세요!
description: Starlight 기반 웹 사이트의 페이지입니다.
---
```

중요한 것을 잊어버렸다면, Starlight가 알려줄 것입니다.

## Starlight 웹사이트 배포하기

Starlight 웹 사이트를 만들고 사용자 정의한 후에는 웹 서버 또는 Netlify, Vercel, GitHub Pages 등 원하는 호스팅 플랫폼에 배포할 수 있습니다.
Starlight로 웹 사이트를 만들고 모든 설정을 완료한 후에는 웹 서버 또는 Netlify, Vercel, GitHub Pages 등 원하는 호스팅 플랫폼에 배포할 수 있습니다.

[Astro 문서에서 Astro 웹 사이트를 배포하는 방법에 대해 알아보세요.](https://docs.astro.build/en/guides/deploy/)
[Astro 공식 문서에서 Astro 기반의 웹 사이트를 배포하는 방법에 대해 알아보세요.](https://docs.astro.build/ko/guides/deploy/)

## Starlight 업데이트

Expand Down Expand Up @@ -116,14 +116,14 @@ yarn upgrade @astrojs/starlight --latest
</TabItem>
</Tabs>

[Starlight 변경 로그](https://github.com/withastro/starlight/blob/main/packages/starlight/CHANGELOG.md) 에서 각 릴리스의 전체 변경 목록을 확인할 수 있습니다.
각 릴리스의 전체 변경 목록을 확인하기 위해 [Starlight 변경 로그](https://github.com/withastro/starlight/blob/main/packages/starlight/CHANGELOG.md)에 방문하세요.

## Starlight 문제 해결

Starlight [프로젝트 설정](/ko/reference/configuration/) 및 [개별 페이지 frontmatter 설정](/ko/reference/frontmatter/) 정보는 모두 이 웹 사이트의 참조 섹션에서 확인할 수 있습니다. 이 페이지를 통해 Starlight 웹 사이트가 제대로 설정되고 작동하는지 확인하세요.
Starlight의 [프로젝트 구성](/ko/reference/configuration/) 및 [개별 페이지의 frontmatter](/ko/reference/frontmatter/)에 대한 정보는 모두 이 웹 사이트의 참조 섹션에서 확인할 수 있습니다. 이 페이지를 통해 Starlight 웹 사이트가 제대로 구성되어 작동하는지 확인하세요.

컨텐츠 추가 및 Starlight 웹 사이트 사용자 지정에 대한 도움말은 사이드바에서 가이드 섹션을 참조하세요.
콘텐츠 추가 및 Starlight 사이트 설정에 대한 도움말은 사이드바의 가이드 섹션에서 확인할 수 있습니다.

이 문서에서 답변을 찾을 수 없는 경우, 완전한 Astro 문서를 읽기 위해 [전체 Astro 문서](https://docs.astro.build) 에 방문하세요. 당신의 질문에 대한 답변은 이 Starlight 테마 아래에서 Astro가 어떻게 작동하는지 이해함으로써 얻을 수 있을 것입니다.
이 문서에서 답변을 얻을 수 없는 경우, [Astro 공식 문서](https://docs.astro.build/ko/)에 방문하여 완전한 Astro 공식 문서를 확인하세요. 당신의 질문에 대한 답변은 이 Starlight 테마 아래에서 Astro가 어떻게 작동하는지 이해함으로써 얻을 수 있을 것입니다.

[Github issues](https://github.com/withastro/starlight/issues)에서 Starlight의 알려진 문제를 확인할 수 있으며, 활발하고 친근한 커뮤니티인 [Astro Discord](https://astro.build/chat)에서 도음을 받을수도 있습니다! 현재 진행되고 있는 개발이나 다른 주제에 대해 논의하기 위해 `#support` 포럼에 "starlight" 태그를 사용하여 질문을 게시하거나 `#starlight` 채널을 방문하세요.
[Github issues](https://github.com/withastro/starlight/issues)에서 Starlight의 알려진 문제를 확인할 수 있으며, 활발하고 친근한 커뮤니티인 [Astro Discord](https://astro.build/chat)에서 도음을 받을수도 있습니다! 현재 진행되고 있는 개발이나 다른 주제에 대해 논의하기 위해 `#support` 포럼에서 "starlight" 태그를 사용하여 질문을 게시하거나 `#starlight` 채널을 방문하세요.
26 changes: 13 additions & 13 deletions docs/src/content/docs/ko/guides/authoring-content.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -9,10 +9,10 @@ Starlight는 `.md` 파일에서 제목 및 설명과 같은 메타데이터를

## 인라인 스타일

텍스트는 **굵게**, _기울임꼴_ 또는 ~~취소선~으로 표시할 수 있습니다~~.
텍스트는 **굵게**, _기울임꼴_ 또는 ~~취소선~~으로 표시할 수 있습니다.

```md
텍스트는 **굵게**, _기울임꼴_ 또는 ~~취소선~으로 표시할 수 있습니다~~.
텍스트는 **굵게**, _기울임꼴_ 또는 ~~취소선~~으로 표시할 수 있습니다.
```

[다른 페이지로 링크](/ko/getting-started)할 수 있습니다.
Expand All @@ -39,7 +39,7 @@ Markdown 및 MDX는 스크린 리더 및 보조 기술에서 사용되는 대체
!["astro"라는 단어가 포함된 행성과 별 그림](https://raw.githubusercontent.com/withastro/docs/main/public/default-og-image.png)
```

프로젝트에 로컬로 저장된 이미지에 대한 상대 경로도 지원됩니다.
프로젝트 내 로컬 이미지 파일에 대한 상대 경로도 지원합니다.

```md
// src/content/docs/page-1.md
Expand All @@ -61,7 +61,7 @@ title: Markdown 가이드
description: Starlight에서 Markdown을 사용하는 방법
---

이 페이지에서는 Starlight에서 Markdown을 사용하는 방법을 설명합니다.
이 페이지는 Starlight에서 Markdown을 사용하는 방법을 설명합니다.

## 인라인 스타일

Expand All @@ -80,22 +80,22 @@ description: Starlight에 내장된 링크를 사용하는 방법

## 서론

[나의 결론](#결론)은 같은 페이지 하단에 링크할 수 있습니다.
[나의 결론](#결론)은 같은 페이지 하단에 링크될 수 있습니다.

## 결론

`https://my-site.com/page1/#introduction` 서론으로 바로 이동합니다.
`https://my-site.com/page1/#서론` 서론으로 바로 이동합니다.
```

레벨 2 (`<h2>`) 및 레벨 3 (`<h3>`) 제목이 페이지 목차에 자동으로 나타납니다.

## 주석

"admonitions" 또는 "callouts" 라고도 하는 주석은 페이지의 기본 콘텐츠 옆에 보조 정보를 표시하는 데 유용합니다.
주석은 "admonitions" 또는 "callouts" 라고도 하며, 페이지의 기본 콘텐츠 주변에 보조 정보를 표시하는 데 유용합니다.

Starlight는 주석 렌더링을 위한 사용자 정의 Markdown 구문을 제공합니다. 주석 블록은 내용을 감싸기 위해 세 개의 콜론 `:::`을 사용하며 `note`, `tip`, `caution` 또는 `danger` 유형일 수 있습니다.
Starlight는 주석 렌더링을 위한 사용자 정의 Markdown 구문을 제공합니다. 주석 블록은 내용을 감싸기 위해 세 개의 콜론 `:::`을 사용하며 `note`, `tip`, `caution` 또는 `danger` 타입일 수 있습니다.

다른 Markdown 콘텐츠를 주석 안에 중첩할 수 있지만 짧고 간결한 콘텐츠 덩어리에 가장 적합합니다.
다른 Markdown 콘텐츠를 주석 안에 중첩시킬 수도 있지만 짧고 간결한 콘텐츠 덩어리에 가장 적합합니다.

### Note 주석

Expand All @@ -122,7 +122,7 @@ npm create astro@latest -- --template starlight

### 사용자 정의 주석 제목

주석 유형 다음에 대괄호를 사용해 주석의 제목을 지정할 수 있습니다. `:::tip[알고 계셨나요?]`
주석 타입 다음에 대괄호를 사용해 주석의 제목을 지정할 수 있습니다. `:::tip[알고 계셨나요?]`

:::tip[알고 계셨나요?]

Expand All @@ -135,9 +135,9 @@ Astro는 ["Islands Architecture"](https://docs.astro.build/ko/concepts/islands/)
:::
```

### 더 많은 주석 유형
### 더 많은 주석 타입

Caution과 Danger 주석은 실수하기 쉬운 세부 사항에 대해 사용자를 집중시키는 데 도움이 됩니다. 이러한 기능을 많이 사용한다면, 문서화하고 있는 내용을 다시 디자인하는 것이 좋습니다.
Caution과 Danger 주석은 실수하기 쉬운 세부 사항에 대해 사용자를 집중시키는 데 도움이 됩니다. 이러한 기능을 많이 사용하고 있다면, 문서화중인 내용을 다시 디자인하는 것이 좋습니다.

:::caution
당신이 멋진 문서 사이트를 원하지 않는다면 [Starlight](../../)는 필요하지 않을 수도 있습니다.
Expand Down Expand Up @@ -202,7 +202,7 @@ var fun = function lang(l) {
````

```md
한 줄의 긴 코드 블록은 줄바꿈되어서는 안 됩니다. 너무 길면 가로로 스크롤해야 합니다. 이 줄은 이를 설명할 수 있을 만큼 길어야 합니다.
한 줄의 긴 코드 블록은 줄바꿈되어서는 안됩니다. 너무 길면 가로로 스크롤해야 합니다. 이 줄은 이를 설명할 수 있을 만큼 길어야 합니다.
```

## 기타 일반적인 Markdown 기능
Expand Down
Loading

0 comments on commit 46ae545

Please sign in to comment.