사이트 소개
Aquamarine의 개인 블로그에 오신 것을 환영합니다! 이 사이트는 강력한 Astro Fuwari 프레임워크를 기반으로 구축되었으며, 훌륭한 원본 디자인을 바탕으로 보다 포괄적이고 개인화된 요구에 맞는 개인 지식 베이스 및 쇼케이스 플랫폼을 만들기 위해 일련의 깊이 있는 커스터마이징과 기능 확장을 진행했습니다.
✨ 핵심 강화 기능
1. 🌐 더욱 강력해진 국제화(I18n) 지원
세계화 시대에 언어의 장벽을 넘는 소통과 기술 공유는 특히 중요합니다. 원본 버전을 바탕으로 국제화 라우팅 및 렌더링 로직을 전면적으로 리팩토링했습니다:
- 원활한 다국어 전환: 모든 언어 경로의 문서와 게시물을 지원합니다. 다른 언어 버전으로 전환할 때 현재 문서에 해당하는 대상 번역 버전으로 정확하게 이동합니다.
- 스마트 폴백(Fallback) 메커니즘: 대상 언어의 번역이 아직 제공되지 않은 경우, 시스템은 자동으로 기본 언어의 콘텐츠를 표시하고 상단에 친절한 안내를 제공하여 독자가 404 페이지에 직면하지 않도록 합니다.
- 유연한 디렉토리 구조: 문서가 특정 계층에 저장되어야 한다는 제한을 해제했습니다. 이제 루트 디렉토리나 각 언어 전용 폴더에서 Markdown 콘텐츠를 자유롭게 관리할 수 있습니다.
2. 📚 새로운 문서 (Docs) 시스템
타임라인 기반의 일반 블로그(Blog) 외에도, 이 사이트는 독립적인 Docs 시스템을 새롭게 도입했습니다:
- 트리형 다단계 내비게이션: 폴더 구조를 기반으로 사이드바에 트리 디렉토리를 자동으로 생성합니다. 시리즈 튜토리얼, 체계적인 기술 노트 또는 연재 콘텐츠를 작성하는 데 매우 적합합니다.
- 지식 체계의 축적: 파편화된 일상 블로그와 체계적인 하드코어 지식을 완벽하게 분리하여 장문의 기술 문서에 대해 더욱 집중적이고 몰입감 있는 독서 경험을 제공합니다.
- 전면적인 다국어 지원: Docs 시스템 역시 전역 I18n 라우팅 및 폴백 메커니즘을 완벽하게 상속합니다.
3. 🎵 전역 배경 음악(BGM) 플레이어
분위기 있고 몰입감 있는 독서 경험을 제공하기 위해 웹사이트에 전역 배경 음악 재생 기능을 추가했습니다:
- 끊김 없는 재생: Swup 기반의 SPA 부드러운 라우팅 메커니즘 덕분에 기사, 카테고리 또는 태그 페이지 사이를 어떻게 이동하든 배경 음악 재생이 예기치 않게 중단되지 않습니다.
- 개인화된 맞춤 설정: 향후 맞춤형 재생 목록을 지원하여 모든 방문자의 독서 시간에 음악이 함께할 수 있도록 할 예정입니다.
4. 📱 모바일 TOC 목차 최적화
긴 글과 문서에서 사이드바 목차(TOC)는 독서 경험을 향상시키는 핵심 요소입니다. 모바일 기기에서 원본 버전이 가질 수 있는 불편함을 해결하기 위해 이 사이트는 전용 반응형 최적화를 진행했습니다:
- 모바일 플로팅 목차: 스마트폰이나 태블릿 등 작은 화면의 기기에서는 문서의 개요 목차가 자동으로 접히고 우아한 플로팅 버튼으로 변합니다.
- 원터치 접근: 방문자는 긴 글을 읽을 때 언제든지 목차를 호출하여 관심 있는 섹션으로 빠르게 이동할 수 있으며, 긴 페이지를 이리저리 스크롤할 필요가 없어 모바일 사용자의 검색 효율성이 크게 향상됩니다.
5. 🗂️ Blog 및 Docs 분리형 아카이브 시스템
콘텐츠 검색을 더 명확하고 직관적으로 만들기 위해 아카이브(Archive) 페이지를 재구성하고 확장했습니다:
- 독립적인 타임라인: Blog 게시물과 Docs 문서를 위한 독립적인 아카이브 페이지를 각각 설정하여 서로 간섭하지 않도록 했습니다.
- 명확한 콘텐츠 정리: 과거의 에세이를 돌아보거나 특정 튜토리얼을 찾을 때, 각각의 전용 아카이브 페이지에서 한눈에 확인할 수 있습니다.
6. 🤝 우정 링크 (Friends) 시스템
인터넷에서의 만남은 아름다운 인연입니다. 새롭게 정교한 우정 링크(Friends) 페이지를 추가했습니다:
- 전용 친구 카드: 통일된 커스텀 UI 카드를 사용하여 블로거 친구들의 아바타, 닉네임, 소개 및 URL을 아름답게 표시합니다.
- 쉬운 확장 및 소통: 링크의 카테고리 분류를 지원하여 사이트를 더욱 인간미 있게 만들 뿐만 아니라, 서로의 사이트를 방문하며 소통하기 편하게 합니다.
🚀 오픈 소스 및 프로젝트 URL
이 블로그의 모든 맞춤형 코드와 새로운 기능은 GitHub에 오픈 소스로 공개되어 있습니다. 이러한 확장 기능이 마음에 드시거나 이를 기반으로 자신만의 강력한 다국어 개인 사이트를 구축하고 싶으시다면, 제 저장소를 방문하여 Star를 눌러주세요:
🙏 감사 및 저작권 정보
이 사이트의 기본 UI 프레임워크 및 핵심 영감의 출처:
- Astro Fuwari by saicaca
사이트 데모 및 기본 설정에 사용된 배경 이미지/일러스트 출처: