SEO 설정
Yundera Docs(Docusaurus 기반)는 SEO 기능을 기본 제공합니다. 이 가이드는 설정된 내용과 커스터마이즈 방법을 설명합니다.
기본 포함 사항
구조화 데이터 (JSON-LD)
사이트는 세 가지 Schema.org 구조화 데이터를 자동 삽입합니다:
| 스키마 | 목적 |
|---|---|
| Organization | Yundera를 발행자로 식별 (이름, 로고, 소셜 링크) |
| WebSite | Google 지식 패널을 위한 문서 사이트 식별 |
| FAQPage | Google 검색에서 FAQ 리치 결과 활성화 (드롭다운 Q&A) |
사이트맵
sitemap.xml이 빌드 시 자동 생성됩니다. 모든 문서 페이지와 마지막 수정일이 포함됩니다.
robots.txt
robots.txt 파일이 모든 크롤러를 허용하고 사이트맵을 가리킵니다.
메타 태그
각 페이지에 포함:
- Open Graph 태그 (
og:title,og:description,og:image,og:type) - Twitter Card 태그 (
twitter:card,twitter:site) - 지리 태그 (
geo.region,geo.placename) - Keywords 메타 태그
- 모바일 브라우저용 테마 색상
페이지별 SEO
각 Markdown 문서는 frontmatter에서 SEO 필드를 재정의할 수 있습니다:
---
title: 내 페이지 제목
description: 검색 엔진을 위한 명확한 설명 (155자 권장).
keywords: [키워드1, 키워드2, 키워드3]
image: /img/my-custom-social-card.png
---
FAQ 리치 결과
사이트에는 Google이 검색 결과에서 FAQ 드롭다운을 직접 표시할 수 있는 FAQPage 구조화 데이터 스키마가 포함됩니다. 새 FAQ를 추가하려면:
docs/faq/에 새 문서 생성- Markdown 파일에 질문과 답변 추가
docusaurus.config.js의FAQPage스키마에 동일한 Q&A 쌍 추가- 사이트 리빌드
Google 리치 결과 테스트로 FAQ 스키마를 테스트하세요.
테스트
- Google 리치 결과 테스트: search.google.com/test/rich-results
- Schema.org 검증기: validator.schema.org
- Google Search Console: 사이트맵을 제출하여 색인