Back

블로그 운영 메모

콘텐츠 경로와 설정 파일 안내

글 쓰기#

블로그 글은 src/content/blog/<slug>/index.md(또는 .mdx)에 둡니다. 상단에 title, description, publishDate는 필수입니다.

사이트 설정#

  • src/site.config.ts — 제목, 푸터, 헤더 메뉴, 댓글·링크 등
  • astro.config.ts — site URL, 어댑터, 마크다운 옵션

문서 더 넣기#

이 파일처럼 src/content/docs/ 아래에 두면 /docs/... 경로로 노출됩니다. 폴더 첫 세그먼트가 setup, integrations, advanced일 때 사이드 목록에 카테고리로 묶입니다.

AdSense#

사이트 소유권 확인#

  1. AdSense 안내 ↗에 따라 메타 태그 방식을 선택합니다.
  2. 콘솔에서 받은 content="..." 안의 문자열만 Vercel(또는 로컬) 환경 변수 PUBLIC_GOOGLE_SITE_VERIFICATION에 넣습니다.
  3. 배포한 뒤 실제 사이트 HTML <head>에 google-site-verification 메타가 있는지 확인하고, 콘솔에서 확인을 완료합니다.
    이 단계는 integ.adsense.enabled가 false여도 메타만 있으면 진행할 수 있습니다.

AdSense가 google-adsense-account 메타(content에 ca-pub-...)만 안내하는 경우, PUBLIC_ADSENSE_CLIENT에 동일한 출판사 ID를 넣으면 빌드 시 그 메타가 자동으로 들어갑니다. 광고 스크립트는 enabled: true일 때만 로드됩니다.

광고 스크립트·슬롯#

src/site.config.ts의 integ.adsense에서 켜고 끕니다.

  • enabled: true이고 PUBLIC_ADSENSE_CLIENT(또는 clientId)가 있을 때만 adsbygoogle.js가 로드됩니다.
  • autoAds: 기본은 false(수동 슬롯만). 자동 광고를 쓰려면 true로 켠 뒤, AdSense 콘솔 ↗에서 자동 광고도 활성화하세요.
  • showSlotPlaceholders: 수동 슬롯 ID가 없을 때 점선 박스를 보일지. 레이아웃만 맞추고 싶을 때 true.

슬롯 ID는 .env의 PUBLIC_ADSENSE_SLOT_*로 넣을 수 있습니다.

DOCS