obsidian-blog 개선

01_Inbox
공유하기:

🚀 블로그 시스템 개발 완료 리포트 (v1.2)

지금까지 진행된 블로그 고도화 작업 내역을 정리한 리포트입니다.

1. UI/UX 고도화 (Ant Design 마이그레이션)

  • 디자인 시스템 교체: antd 라이브러리 전면 도입으로 컴포넌트 전문성 확보
  • 3단 레이아웃 리팩토링: 좌측(카테고리/태그), 중앙(콘텐츠), 우측(캘린더/그래프) 구조 최적화
  • 인터랙티브 컴포넌트:
    • 년/월 선택 기능이 포함된 내비게이션 캘린더 위젯
    • 현재 문서를 자동으로 추적하고 포커싱하는 지능형 지식 그래프
    • 10페이지 단위 노출 로직이 포함된 페이징 시스템
  • 반응형 최적화: 모바일 환경에서의 카드 레이아웃 및 텍스트 오버플로우 전면 수정

2. 성능 및 대규모 데이터 최적화

  • 10,000개 이상 노트 대응:
    • PostSummary 도입: 메타데이터와 본문을 분리하여 목록 로딩 속도 비약적 향상
    • Redis 영구 캐싱: 서버 재부팅 후에도 0.1초 내외의 빠른 첫 화면 로딩 보장
    • 정합성(Consistency) 엔진: Obsidian에서의 파일 삭제/이동을 실시간 감지하여 캐시 자동 갱신
  • 빌드 최적화: 도커 이미지 빌드 시 아키텍처(linux/amd64) 지정 및 용량 최적화 가이드 수립

3. 기능 개선 및 버그 수정

  • 데이터 정합성: Frontmatter의 date 속성이 파일 생성일보다 높은 우선순위를 갖도록 로직 수정
  • 링크 시스템: 슬래시(/)가 포함된 태그 지원([...tag] 루팅) 및 양방향 위키링크 호환성 강화
  • 안정성 확보: 리액트 하이드레이션(Hydration) 에러 및 인라인 태그 파싱 오류 전수 해결

4. 배포 및 문서화

  • 나스(NAS) 배포: Portainer 전용 Stack 설정 가이드(DEPLOYMENT_NAS.md) 최신화
  • 깃허브 관리: 100MB 초과 대용량 파일 방지 및 한글 커밋 메시지 가이드(GITHUB_GUIDE.md) 작성
  • 프로젝트 대문: 주요 강점과 기술 스택을 강조한 README.md 전면 개편

5. 기능개선

  • 관리자 로그인 기능
    • 삼선메뉴
    • 관리자 계정은 docker 등록시 메일계정 파라미터로 등록
    • URL 을 입력하면 분석 후 정리해주는 기능
    • redis 재처리
  • 구글 ad 추가
  • tags / 기준 계층화
  • 문서명, title 속성에 ' 가 들어간 케이스 확인
  • 본문하단 공유하기 기능 추가
  • 다국어 기능
  • 댓글기능 추가 (giscus)
    • 등록 후 내역이 보이지 않음
  • 배포 자동화
    • docker hub upload
    • github action
    • portainer webhook
  • 모바일용 삼선메뉴
    • 테마설정, 사이드위젯, 어드민 접근
  • 어드민
    • 글쓰기/수정/상태변경
    • 노트이동하기
    • 파일업로드 기능
    • 노트삭제 (노트없는 카테고리 삭제기능 포함)
    • 백링크 프리뷰
    • 에디터 이미지 업로드 및 프리뷰
    • 글쓰기 기능 개선
      • 글의 상단에 --- 으로 시작해서 끝나는 경우 속성으로 인식
      • , 기준으로 키워드 입력시 템플릿 기반으로 글 작성