사용 안내서
사이트 설정
src/config.ts에서 제목, 기본 작성자, 다국어 사이트 설명, favicon 파일, 대표 URL, 언어, 페이지당 글 수, 손글씨 글꼴, 탐색 메뉴를 설정합니다. 사이트 설명은 홈, SEO 메타데이터, RSS에서 함께 사용하며 favicon 경로는 public/ 안의 파일을 가리킵니다. 글의 author는 기본값을 덮어씁니다. 탐색 항목에는 기본 페이지 이름이나 다국어 이름을 가진 외부 링크를 쓸 수 있습니다.
콘텐츠 추가
글은 src/content/blog/<언어>/, 고정 페이지는 src/content/pages/<언어>/에 두며 번역본은 같은 파일명을 사용합니다. draft: true 글은 개발 환경에 보이고 프로덕션 빌드에서는 제외됩니다.
title: 글 제목
description: 짧은 설명
author: 선택 작성자
pubDate: 2026-11-14
updatedDate: 2026-11-15
draft: true
pin: 1
category: 산문
tags: [Astro, 글쓰기]
title, description, pubDate는 필수이고 나머지는 선택 사항입니다. pin을 1에서 99로 두면 글이 홈 목록 맨 위에 고정되고, 숫자가 클수록 더 위에 옵니다. 생략하거나 0이면 날짜순입니다.
Markdown과 MDX
일반 글은 .md, 컴포넌트가 필요하면 .mdx를 사용합니다.
import Callout from '../../../components/content/Callout.astro'
<Callout title="참고">MDX에서는 Astro 컴포넌트를 표시할 수 있습니다.</Callout>
컴포넌트는 기본적으로 정적 HTML이 됩니다. 브라우저 상호작용이 필요할 때만 client:*를 사용하세요. astro dev --background으로 미리 보고, astro dev logs로 오류를 확인한 뒤 게시 전에 검사와 프로덕션 빌드를 실행합니다.