Skip to content

fix(seo): 필터 URL 수집을 줄이고 주요 글 탐색 개선 - #248

Merged
devy1540 merged 2 commits into
mainfrom
feat/seo-crawl-discovery
Oct 28, 2026
Merged

devy1540 merged 2 commits into
mainfrom
feat/seo-crawl-discovery

Conversation

@devy1540

@devy1540 devy1540 commented Oct 28, 2026 •

Copy link
Copy Markdown
Owner

목적

태그·시리즈 필터가 110개의 별도 쿼리 URL로 노출되고, 홈에서 이전 주요 글을 찾기 어려운 구조를 개선합니다. 현재 사이트맵의 112개 문서는 수집 가능하게 유지하면서 필터 변형의 반복 수집을 줄이고 글로 이어지는 경로를 늘립니다.

내용(의도 포함)

  • 목록·태그·시리즈 필터를 #filters: fragment로 전환했습니다. 기존 쿼리 링크는 계속 동작하며, robots.txt는 해당 목록의 쿼리 주소만 제한합니다. 글 본문·쿼리 없는 목록·사이트맵 URL은 모두 허용합니다. Google의 필터 탐색 가이드를 따랐습니다.
  • 한국어·영어 홈에 여섯 주제별 읽기 안내와 언어별 주요 글 12개의 직접 링크를 초기 HTML로 제공합니다.
  • 페이지 진입 후 다른 다섯 화면을 자동 다운로드하던 처리를 제거하고 링크에 포인터·포커스·터치가 있을 때만 미리 읽습니다.
  • Soft 404로 보고된 국제화 킬스위치 글의 한국어·영어 본문에 로케일 결정표, 캐시·기존 화면의 롤백 한계, 검증 예제와 후속 글 링크를 보강했습니다. 실제 바뀐 글과 고정 페이지에만 수정일을 기록했습니다.
  • Mermaid의 DOMPurify 의존성을 3.4.17로 고정해 배포 보안 검사를 막던 취약점을 해소했습니다. 다른 의존성 버전은 유지합니다.
  • URL 변경 후에도 뒤로 가기·새로고침·언어 전환·SSR hydration·목차 스크롤이 유지되는지 검증했습니다. 홈 링크가 추가되어 모호해진 기존 댓글 테스트의 대상을 해당 읽기 안내로 한정했습니다.

성공기준

  • pnpm audit --prod --audit-level high: high/critical 0개(낮음 1개·보통 1개는 남아 있음)
  • pnpm build, pnpm type-check, pnpm lint 통과
  • SEO 12개, sitemap-lastmod 6개, post-dates 6개, rendering 5개, loading 9개, analytics 6개, charts 6개 검사 통과
  • pnpm test:browser --workers 2: 전체 65개 통과, 한영 홈의 모바일·데스크톱 스크린샷 확인
  • pnpm check:internal-links: 74개 파일 검사 통과
  • 빌드 HTML에서 필터 쿼리 목적지 110개 → 0개, fragment 목적지 110개, 한영 홈 각각 글 직접 링크 12개 확인
  • 사이트맵 112개 전체가 robots 허용·HTTP용 HTML indexable·self canonical을 유지함을 검사

이 변경은 수집 경로와 콘텐츠를 개선합니다. 기존 Search Console 제외 목록의 즉시 삭제나 Google의 실제 색인 완료를 의미하지 않습니다.

@github-actions github-actions Bot added documentation Improvements or additions to documentation target: main PR targets the main branch area: content Blog post content changes area: blog Blog listing, post rendering, search, tags, or series area: ui Shared UI, layout, or styling area: i18n Localization and translations area: seo SEO metadata, prerendering, or public site metadata area: build Build, tooling, or project configuration labels Oct 28, 2026
@github-actions github-actions Bot added the dependencies Dependency manifest or lockfile changes label Oct 28, 2026
@devy1540
devy1540 merged commit 72e1f1b into main Oct 28, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: blog Blog listing, post rendering, search, tags, or series area: build Build, tooling, or project configuration area: content Blog post content changes area: i18n Localization and translations area: seo SEO metadata, prerendering, or public site metadata area: ui Shared UI, layout, or styling dependencies Dependency manifest or lockfile changes documentation Improvements or additions to documentation target: main PR targets the main branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant