본문으로 건너뛰기
에이든의 블로그
뒤로가기

AstroPaper 4.0

안녕하세요 여러분! 새해 복 많이 받으세요! 2024년에도 좋은 일만 가득하시길 바랍니다! AstroPaper v4 출시를 기쁘게 알려드립니다. 블로깅 경험을 한 단계 높여줄 다양한 새 기능, 개선 사항, 버그 수정이 포함된 중요한 업데이트입니다. 버전 4를 가능하게 해준 모든 기여자분들의 소중한 의견과 노력에 진심으로 감사드립니다!

AstroPaper v4

목차

주요 변경 사항

Astro v4로 업그레이드 #202

AstroPaper는 이제 Astro v4의 강력한 기능과 성능을 활용합니다. 다만 점진적인 업그레이드이므로 대부분의 Astro 사용자에게 호환성 문제는 없을 것입니다.

postSlug을 Astro Content의 slug으로 대체 #197

블로그 콘텐츠 스키마의 postSlug은 AstroPaper v4에서 더 이상 사용할 수 없습니다. 초기에 Astro에는 slug 메커니즘이 없었기 때문에 직접 구현해야 했습니다. Astro v3부터 콘텐츠 컬렉션과 slug 기능을 지원하게 되었으므로, 이제 Astro의 기본 slug 기능을 채택할 때가 되었다고 판단했습니다.

파일: src/content/blog/astro-paper-4.md

---
author: Sat Naing
pubDatetime: 2024-01-01T04:35:33.428Z
title: AstroPaper 4.0
slug: "astro-paper-v4" # slug을 지정하지 않으면 'astro-paper-4'(파일명)가 사용됩니다.
# slug: "" ❌ 빈 문자열은 사용할 수 없습니다
---

slug의 동작이 약간 달라졌습니다. 이전 버전의 AstroPaper에서는 블로그 글(마크다운 파일)에 postSlug이 지정되지 않으면 해당 블로그 글의 제목이 slugify되어 slug으로 사용되었습니다. 그러나 AstroPaper v4에서는 slug 필드가 지정되지 않으면 마크다운 파일명이 slug으로 사용됩니다. 한 가지 주의할 점은 slug 필드는 생략할 수 있지만 빈 문자열은 사용할 수 없다는 것입니다(slug: "" ❌).

AstroPaper를 v3에서 v4로 업그레이드하는 경우, src/content/blog/*.md 파일의 postSlugslug으로 변경해야 합니다.

새로운 기능

콘텐츠 작성을 위한 코드 스니펫 추가 #206

AstroPaper에 이제 새 블로그 글을 위한 VSCode 스니펫이 포함되어 frontmatter와 콘텐츠 구조(목차, 제목, 발췌 등)를 수동으로 복사/붙여넣기할 필요가 없어졌습니다.

VSCode 스니펫에 대한 자세한 내용은 여기에서 확인할 수 있습니다.

블로그 글에 수정 일시 추가 #195

블로그 글에 수정 일시를 표시하여 독자들에게 최신 업데이트 정보를 전달하세요. 이를 통해 글의 최신성에 대한 사용자 신뢰도를 높이고 블로그의 SEO 개선에도 기여합니다.

AstroPaper의 최종 수정일 기능

블로그 글을 수정한 경우 modDatetime을 추가할 수 있습니다. 이제 글의 정렬 방식이 약간 달라졌습니다. 모든 글은 pubDatetimemodDatetime 모두를 기준으로 정렬됩니다. 글에 pubDatetimemodDatetime이 모두 있는 경우 modDatetime에 의해 정렬 위치가 결정됩니다. 그렇지 않으면 pubDatetime만 글의 정렬 순서를 결정하는 데 고려됩니다.

맨 위로 가기 버튼 구현 #188

새로 구현된 맨 위로 가기 버튼으로 블로그 상세 글에서의 사용자 탐색 경험을 향상시킵니다.

AstroPaper의 맨 위로 가기 버튼

태그 글에 페이지네이션 추가 #201

태그 글에 페이지네이션을 추가하여 콘텐츠 구성과 탐색을 개선했습니다. 이를 통해 사용자가 관련 콘텐츠를 더 쉽게 탐색할 수 있습니다. 태그에 많은 글이 있는 경우 독자가 모든 태그 관련 글에 압도되지 않도록 보장합니다.

robots.txt 동적 생성 #130

AstroPaper v4는 이제 robots.txt 파일을 동적으로 생성하여 검색 엔진 인덱싱과 웹 크롤링을 더 세밀하게 제어할 수 있습니다. 또한 robot.txt 파일 내에 사이트맵 URL도 추가됩니다.

Docker-Compose 파일 추가 #174

Docker-Compose 파일이 추가되어 AstroPaper 환경 관리가 그 어느 때보다 쉬워졌으며, 배포와 구성이 간소화됩니다.

리팩터링 및 버그 수정

Slugify된 제목을 원래 태그 이름으로 대체 #198

명확성, 사용자 경험, SEO 개선을 위해 태그 페이지의 제목(Tag: some-tag)이 더 이상 slugify되지 않고 원래 형태로 표시됩니다(Tag: Some Tag).

Slugify 해제된 태그 이름

최소 높이에 100svh 적용 (79d569d)

body의 최소 높이를 100svh로 업데이트하여 모바일 사용자에게 더 나은 UX를 제공합니다.

사이트 URL을 단일 진실 공급원(Single Source of Truth)으로 업데이트 #143

사이트 URL이 이제 단일 진실 공급원으로 설정되어 구성을 간소화하고 불일치를 방지합니다. 자세한 내용은 이 PR과 관련 이슈를 참고하세요.

라이트 모드에서 코드 블록 텍스트가 보이지 않는 문제 해결 #163

라이트 모드에서 코드 블록 텍스트가 보이지 않는 문제를 수정했습니다.

Breadcrumb에서 태그의 마지막 부분이 이제 디코딩되어 영어가 아닌 유니코드 문자가 더 잘 표시됩니다.

LOCALE 설정을 전체 로케일 범위로 업데이트 (cd02b04)

LOCALE 설정이 더 넓은 범위의 로케일을 지원하도록 업데이트되어 더 다양한 사용자를 위한 환경을 제공합니다.

마무리

이러한 업데이트가 AstroPaper 경험을 크게 향상시킬 것이라 확신합니다. 기여해 주시고, 이슈를 해결해 주시고, AstroPaper에 별을 남겨 주신 모든 분들께 감사드립니다. AstroPaper v4로 여러분이 만들어 낼 멋진 콘텐츠를 기대합니다!

즐거운 블로깅 되세요!

Sat Naing
AstroPaper 제작자