Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

i18n(ko-KR): update images.mdx #11091

Merged
merged 3 commits into from
Feb 28, 2025
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 3 additions & 5 deletions src/content/docs/ko/guides/images.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -64,8 +64,6 @@ import localBirdImage from '../../images/subfolder/localBirdImage.png';
- `src/` 폴더에 있는 로컬 이미지
- 인증된 소스에서 가져오는 [구성된 원격 이미지](#원격-이미지-승인)

`public/` 폴더에 있는 이미지와 프로젝트에 특별히 구성되지 않은 원격 이미지도 이미지 컴포넌트와 함께 사용할 수 있지만 처리되지는 않습니다.

`<Image />`는 표시된 이미지를 제어하기 위해 로컬 또는 인증된 원격 이미지의 크기, 파일 유형 및 품질을 변환할 수 있습니다. 결과 `<img>` 태그에는 `alt`, `loading``decoding` 속성이 포함되며 CLS (Cumulative Layout Shift)를 방지하기 위해 이미지 크기를 유추합니다.

:::note[Cumulative Layout Shift란 무엇입니까?]
Expand Down Expand Up @@ -279,7 +277,7 @@ export default defineConfig({

## Markdown 파일의 이미지

`.md` 파일에 표준 Markdown `![alt](src)` 구문을 사용하세요. 이 구문은 Astro의 [이미지 서비스 API](/ko/reference/image-service-reference/)와 함께 작동하여 `src/`에 저장된 로컬 이미지를 최적화합니다. 원격 이미지와 `public/` 폴더에 저장된 이미지는 최적화되지 않습니다.
`.md` 파일에 표준 Markdown `![alt](src)` 구문을 사용하세요. 이 구문은 Astro의 [이미지 서비스 API](/ko/reference/image-service-reference/)와 함께 작동하여 `src/`에 저장된 로컬 이미지와 원격 이미지를 최적화합니다. `public/` 폴더에 저장된 이미지는 절대 최적화되지 않습니다.

```md
<!-- src/pages/post-1.md -->
Expand All @@ -299,9 +297,9 @@ export default defineConfig({
![Astro](https://example.com/images/remote-image.png)
```

로컬 이미지에는 `<img>` 태그가 지원되지 않으며 `.md` 파일에서는 `<Image />``<Picture />` 컴포넌트를 사용할 수 없습니다.
HTML `<img>` 태그는 `public/`에 저장된 이미지 또는 원격 이미지를 이미지 최적화나 처리 없이 표시하는 데 사용할 수도 있습니다. 하지만 `<img>``src`에 있는 로컬 이미지에 대해서는 지원되지 않습니다.

이미지 속성에 대한 더 많은 제어가 필요한 경우, [Astro의 MDX 통합](/ko/guides/integrations-guide/mdx/)을 사용하여 `.mdx` 파일 형식에 대한 지원을 추가하는 것이 좋습니다. MDX를 사용하면 Markdown에 컴포넌트를 추가할 수 있으며, [MDX에서 사용할 수 있는 추가 이미지 옵션](#mdx-파일의-이미지)도 제공됩니다.
`<Image />``<Picture />` 컴포넌트는 `.md` 파일에서 사용할 수 없습니다. 이미지 속성을 보다 세밀하게 제어해야 하는 경우, [Astro의 MDX 통합](/ko/guides/integrations-guide/mdx/)을 사용하여 `.mdx` 파일 형식에 대한 지원을 추가하는 것을 권장합니다. MDX는 컴포넌트와 Markdown 구문을 결합하는 것을 포함하여 [MDX의 이미지 옵션](#mdx-파일의-이미지)을 추가로 사용할 수 있도록 합니다.

## MDX 파일의 이미지

Expand Down