Skip to content

Commit c9a690d

Browse files
김김
authored andcommitted
docs(kr): refine intro wording in Astro guide
1 parent f5dc46a commit c9a690d

1 file changed

Lines changed: 5 additions & 7 deletions

File tree

src/content/docs/kr/docs/guides/tech/with-astro.mdx

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -6,13 +6,11 @@ sidebar:
66

77
import { FileTree } from '@astrojs/starlight/components';
88

9-
Astro와 FSD는 같은 `src/pages` 폴더를 다른 용도로 사용해 충돌이 발생합니다.
9+
Astro와 FSD는 모두 `pages`라는 명칭을 사용하지만, 의미는 다릅니다.
10+
Astro에서 `📁 src/pages`는 파일 기반 라우팅을 위한 폴더이고, FSD에서 `pages`는 페이지 단위를 나타내는 layer입니다.
11+
FSD의 `pages` layer를 Astro 폴더 구조에 반영하면 `📁 src/pages`를 사용하게 되는데, Astro도 같은 경로를 파일 기반 라우팅에 사용하므로 두 구조가 충돌합니다.
12+
이를 구분하기 위해 FSD의 `pages` layer는 `📁 src/_pages`에 두고, `📁 src/pages`는 Astro의 파일 기반 라우팅 전용으로 유지합니다.
1013

11-
- **Astro**: `src/pages`는 라우트 폴더입니다. Astro가 이 폴더에서 라우트 파일을 찾습니다.
12-
- **FSD**: `pages`는 layer 이름입니다. page 단위 코드를 이 layer에 둡니다.
13-
14-
이 문제를 피하려면 FSD의 pages Layer는 `📁 src/_pages`에 두고, `📁 src/pages`는 라우팅에만 사용합니다.
15-
이렇게 하면 Astro 라우팅은 `src/pages`에서 처리하고, FSD의 페이지 코드는 `src/_pages`에서 관리할 수 있습니다.
1614

1715
<FileTree>
1816
- src
@@ -36,7 +34,7 @@ import { HomePage } from '@/_pages/home';
3634
<HomePage />
3735
```
3836

39-
## 경로 별칭 설정하기
37+
## Setting up path aliases
4038

4139
`src` 아래 파일을 `@/`로 불러오려면 `tsconfig.json`에 경로 별칭을 추가합니다.
4240

0 commit comments

Comments
 (0)