My jekyll blog search logic report

Jekyll 블로그 검색 기능 분석 보고서

📋 개요

본 보고서는 Jekyll 기반 블로그의 클라이언트 사이드 검색 기능에 대한 상세 분석을 제공합니다. 현재 구현된 검색 시스템의 작동 원리, 검색 기준, 그리고 향후 개선 방안에 대해 다룹니다.

---

🔍 검색 기능 현황

검색 대상 데이터

현재 검색 시스템은 Jekyll의 Liquid 템플릿을 통해 생성된 4가지 데이터 속성을 대상으로 합니다:

검색 대상	데이터 속성	소스	전처리 과정
포스트 제목	data-title	post.title	소문자 변환, 공백 제거, HTML 이스케이프
포스트 내용	data-content	post.excerpt	HTML 태그 제거, 줄바꿈 제거, 소문자 변환
태그	data-tags	post.tags	공백으로 연결, 소문자 변환
카테고리	data-categories	post.categories	공백으로 연결, 소문자 변환

검색 알고리즘

// 검색 로직 (OR 조건)
const isMatch = title.includes(searchTerm) || 
               content.includes(searchTerm) || 
               tags.includes(searchTerm) ||
               categories.includes(searchTerm);

특징:

• 부분 문자열 매칭: String.includes() 메서드 사용
• OR 조건: 4개 영역 중 하나라도 일치하면 결과에 포함
• 대소문자 무시: 모든 데이터가 소문자로 정규화
• 실시간 검색: 300ms 디바운싱 적용

---

📊 검색 성능 분석

장점

✅ 빠른 응답 속도

• 클라이언트 사이드 검색으로 서버 요청 없음
• 메모리 내 데이터 처리로 즉시 결과 제공

✅ 사용자 친화적 인터페이스

• 실시간 검색 결과 업데이트
• 검색 결과 개수 표시
• 검색어 지우기 기능

✅ 다양한 검색 범위

• 제목, 내용, 태그, 카테고리 통합 검색
• 부분 매칭으로 높은 검색 정확도

제한사항

❌ 검색 범위 제한

• 전체 포스트 내용이 아닌 excerpt만 검색
• 긴 포스트의 경우 누락 가능성

❌ 고급 검색 기능 부재

• AND/NOT 연산자 미지원
• 정확한 구문 검색(“구문”) 불가
• 검색어 하이라이팅 없음

❌ 성능 한계

• 포스트 수 증가 시 초기 로딩 시간 증가
• 브라우저 메모리 사용량 증가

---

🎯 검색 정확도 평가

검색 시나리오별 결과

검색어	예상 결과	실제 동작	정확도
“wel”	“welcome” 포함 포스트	✅ 정상 매칭	높음
“javascript”	JS 관련 포스트	✅ 태그/내용 매칭	높음
“자바스크립트”	한글 JS 포스트	✅ 한글 지원	높음
“js tutorial”	공백 포함 검색	⚠️ 부분 매칭만	중간
”"exact phrase"”	정확한 구문	❌ 미지원	낮음

검색 누락 사례

1. 긴 포스트 내용: excerpt 범위를 벗어난 내용
2. 복합 검색어: “A AND B” 형태의 조건부 검색
3. 특수 문자: 정규식 특수 문자 처리 미흡

---

🚀 개선 권장사항

단기 개선 방안 (Low-effort, High-impact)

1. 전체 내용 검색 지원

data-content=""

2. 검색어 하이라이팅

function highlightSearchTerm(text, term) {
    return text.replace(new RegExp(term, 'gi'), `<mark>$&</mark>`);
}

3. 검색 결과 정렬

• 제목 매칭 > 태그 매칭 > 내용 매칭 순으로 가중치 적용

중기 개선 방안 (Medium-effort, High-impact)

1. 고급 검색 연산자

// AND 검색: "javascript AND tutorial"
// NOT 검색: "javascript NOT beginner"
// 구문 검색: "javascript tutorial"

2. 검색 자동완성

• 인기 검색어 제안
• 태그 기반 자동완성

3. 검색 히스토리

• 최근 검색어 저장 (localStorage)
• 자주 검색한 키워드 제안

장기 개선 방안 (High-effort, High-impact)

1. 전문 검색 엔진 통합

• Algolia DocSearch 연동
• Elasticsearch 구축

2. AI 기반 의미 검색

• 유사 의미 검색 지원
• 콘텐츠 기반 추천

3. 다국어 검색 최적화

• 형태소 분석기 적용
• 동의어 사전 구축

---

📈 구현 우선순위

Phase 1: 즉시 적용 가능 (1-2주)

1. 전체 포스트 내용 검색 범위 확장
2. 검색어 하이라이팅 기능 추가
3. 검색 결과 가중치 정렬 구현

Phase 2: 단기 개선 (1개월)

1. AND/OR 검색 연산자 지원
2. 검색 자동완성 기능
3. 모바일 최적화

Phase 3: 장기 계획 (3-6개월)

1. 외부 검색 엔진 연동 검토
2. 성능 최적화 (lazy loading, indexing)
3. 사용자 행동 분석 및 개선

---

💡 결론 및 제언

현재 Jekyll 블로그의 검색 기능은 기본적인 요구사항을 충족하는 수준으로 평가됩니다. 클라이언트 사이드 검색의 장점을 활용하여 빠른 응답성을 제공하고 있으나, 고급 검색 기능과 정확도 측면에서 개선의 여지가 있습니다.

즉시 권장사항:

• 전체 포스트 내용 검색 범위 확장
• 검색어 하이라이팅으로 사용자 경험 개선
• 검색 결과 정렬 알고리즘 도입

장기적으로는 포스트 수가 증가함에 따라 전문 검색 솔루션 도입을 검토할 필요가 있으며, 사용자 행동 분석을 통한 지속적인 개선이 필요합니다.

---

보고서 작성일: 2025년 6월 9일
분석 대상: Jekyll 블로그 클라이언트 사이드 검색 시스템
문서 버전: v1.0