Skip to content

feat: provide social cover fallbacks, llms.txt and RSS - #94

Merged
ooMia merged 6 commits into
mainfrom
quality/social-discovery
Oct 16, 2026
Merged

ooMia merged 6 commits into
mainfrom
quality/social-discovery

Conversation

@ooMia

@ooMia ooMia commented Oct 16, 2026 •

Copy link
Copy Markdown
Owner

Docs preview가 없는 글에서도 공유 이미지가 나오도록 Article의 대표 이미지를 정적 PNG로 제공합니다. canonical 콘텐츠를 찾을 수 있는 llms.txt와 RSS를 추가하고 robots의 MIME·sitemap 경로를 명시합니다.

  • 검증된 Docs PNG가 우선입니다. 없으면 기존 대표 SVG를 비율을 유지한 1200px PNG로 변환하며, 새 글도 기존 ArticleVisual renderer로 fallback을 생성합니다. URL·MIME·실제 이미지 치수를 OG/X metadata와 일치시킵니다. 외부 capture/provider를 실행하거나 Docs 산출물을 쓰지 않습니다.
  • robots/llms endpoint는 UTF-8 text/plain을 반환합니다. llms는 공식 제안의 제목·소개·목록 형식이며, 같은 Article visibility와 순서를 사용해 원문 canonical 링크만 수록합니다.
  • 공식 @astrojs/rss로 원문별 제목·설명·날짜·태그·canonical URL을 제공하며 head/footer에 구독 링크를 연결했습니다. 본문을 재파싱하거나 영문 fallback을 중복 수록하지 않습니다.

검증: check, unit 148개, Astro check, network-blocked immutable fixture 통과. Docs 5a2eaff17e6a8136d32c4eb9a32211adde0b9317의 root 전체 11글 및 /publishing + draft filtering 1글 빌드에서 이미지 bytes/metadata·crawler URL·feed를 확인했습니다. 별도 읽기 검토에서도 회귀를 찾지 못했습니다.

남은 경계: 정적 출력의 실제 공개 MIME·HTTPS·외부 OG 서비스 재검사는 병합/배포 후 수행해야 합니다. title/description을 정해진 글자 수로 부풀리지 않았으며 원문 설명 교정은 Docs PR #40입니다. 기존 Gravatar의 build-time network 제거는 PR #81입니다.

Refs #84
Refs #90
Refs #91
Refs #92

통합 검증: 최신 main의 native rendering 검사에서 공용 RSS head가 필요로 하는 Astro.site가 fixture 설정에 빠져 빌드가 실패했습니다. fixture에 기준 URL 한 줄을 추가했으며 제품 코드는 우회하지 않았습니다. 수정한 head 5edc747의 기존 CI 전체 통과를 확인했습니다.

@ooMia
ooMia marked this pull request as ready for review October 16, 2026 12:02
@ooMia
ooMia merged commit 829351c into main Oct 16, 2026
1 check passed
@ooMia
ooMia deleted the quality/social-discovery branch October 16, 2026 17:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant