평가 보고서 — Open Graph 및 파비콘 작업

프로젝트: 2-somin.github.io
평가 일자: 2026-06-04
평가 범위: OG 메타데이터 구성, 파비콘 리디자인, SEO 템플릿 개선

1. 작업 목표 달성도

2. 기술 품질 평가

2-1. OG 메타데이터

잘된 점

• 6개 필수 OG 태그 모두 출력되도록 구성
• og:type을 일반 페이지(website)와 포스트(article) 자동 분기 처리
• og:image:width, og:image:height 명시로 크롤러가 이미지를 미리 알 수 있게 함
• locale을 ko_KR로 설정하여 국내 SNS 크롤러 대응

개선 여지

• 포트폴리오 개별 페이지(_portfolio/)에 description 프론트매터가 없으면 OG description이 본문 첫 줄로 채워질 수 있음 → 각 포트폴리오 항목에 description 추가 권장

2-2. OG 이미지

잘된 점

• 1200×630px — 카카오톡, Facebook, Twitter(X) 모두 대응하는 표준 사이즈
• 사진 미사용, SVG 캔버스 드로잉 → 텍스트 선명도 보장, 저작권 이슈 없음
• 브랜드 컬러(#1a1a2e, #c9a97a) 일관 적용
• 파일 용량 50KB — 크롤러 로딩 부담 없음

개선 여지

• 서버 렌더링 환경에 따라 한글 폰트(Apple SD Gothic Neo, Noto Sans KR)가 적용되지 않을 수 있음. 영문 이름(Lee Somin)으로 변경하여 폰트 의존성 최소화한 것은 올바른 판단이었음
• 향후 Node.js 환경이 아닌 Jekyll 빌드 프로세스 내에서 자동 생성되도록 자동화 고려 가능

2-3. 파비콘

잘된 점

• SVG + PNG 4종(32px, 192px, 512px, 180px) 모두 제공 — 브라우저·기기별 완전 대응
• theme-color 메타태그를 브랜드 다크 색상으로 통일
• 이 글자 단일 캐릭터 아이콘 — 작은 사이즈에서도 식별 용이

개선 여지

• favicon.ico는 구버전 브라우저 대응용인데 현재 기존 파일 유지 중. PNG 기반으로 교체하면 완전히 통일 가능

2-4. 버그 수정 품질

og:image URL 이중 prepend 버그

• 원인 파악 정확: Liquid 필터 체인에서 base_path(완전 URL 포함)와 site.url을 중복 prepend하는 구조적 오류
• 수정 방식 적절: 불필요한 | prepend: site.url 제거로 최소 변경
• 파급 범위 없음: JSON-LD 블록 내 동일 패턴도 함께 수정

og:description 오출력 버그

• 원인 파악 정확: Jekyll의 page.excerpt 우선순위가 site.og_description보다 높아 발생
• 수정 방식 적절: about.md 프론트매터에 description 명시 — 가장 직접적인 해결

3. 종합 평가

총평

이번 작업은 초기 구성에서 OG 이미지 URL이 깨지는 구조적 버그와 description 오출력 문제가 있었으나, 원인을 정확히 진단하여 최소 변경으로 수정하였다. OG 이미지와 파비콘 모두 포트폴리오 브랜드 정체성과 일관된 디자인으로 제작되었으며, 카카오톡 공유 시 정상적인 미리보기가 출력될 수 있는 기반이 마련되었다.

4. 후속 권장 작업

1. 포트폴리오 개별 페이지 OG 보완: _portfolio/ 내 각 파일에 description 프론트매터 추가
2. 카카오 공유 디버거 확인: https://developers.kakao.com/tool/debugger/sharing 에서 실제 출력 검증
3. favicon.ico 교체: 현재 구버전 아이콘 파일을 신규 브랜드 아이콘 기반으로 교체