← 목록
기타 2026-05-20 3KB 읽기 2분

docs.crowny.org 서버 고도화 v3 — UI 전면 개선 + 카테고리 완성

개요

docs.crowny.org (CrownyDoc Server) 360개 문서의 목록/상세 페이지 UI를 전면 개선. 카테고리 "기타" 21→0건 달성 (360개 전량 분류).

1. 카테고리 완성 — "기타" 0건

추가 키워드 (v2 대비)

  • 오피스: office, benchmark, sheet-, editor-, slide-, toolbar, footnote, spacing, powertools, compat, xlsx, docx, pptx
  • 비디오: cvf
  • 솔루션: 솔루션, hcompany, kira, 대관
  • 협업: taskworld, msteams
  • 도구: omni
  • 컴파일러: 중첩인덱싱, 필드할당, 해시

2. 문서 목록 페이지 개선

통계 대시보드

  • 서버사이드 렌더링 4개 카드 (총 문서, 이번 주, 카테고리 수, 용량)
  • 즉시 표시 (API 호출 없음)

실시간 검색 고도화

  • 검색어 <mark> 하이라이트
  • "N개 문서 발견" 결과 수 표시
  • URL ?q= 파라미터 → 검색 결과 공유 링크

정렬 토글

  • 4종: 최신순 / 오래된순 / 이름순 / 크기순
  • DOM 재정렬 (서버 호출 없음)

카테고리 뱃지

  • 각 카테고리 버튼에 문서 수 표시 (예: "한선씨 38")

3. 문서 상세 페이지 개선

목차 사이드바 (TOC)

  • ##/### 자동 파싱 → sticky 우측 사이드바
  • IntersectionObserver로 현재 섹션 하이라이트
  • 제목 2개 미만이면 미표시

메타 정보 바

  • 카테고리 뱃지, 날짜, 파일 크기, 읽기 시간 (글자수÷500분)

이전/다음 네비게이션

  • 날짜순 기준, 카드 스타일

관련 문서 추천

  • 같은 카테고리 문서 최대 5개

복사/인쇄 버튼

  • 마크다운 원본 클립보드 복사
  • @media print CSS (다크→화이트 전환)

4. 반응형 레이아웃

  • 1200px 2컬럼 (본문 + TOC)
  • 900px 이하 1컬럼으로 collapse

관련 파일

  • 서버: /Users/ef/CrownyDoc/server-docs.js
  • 한선씨 동반:
  • /Users/ef/CrownyDoc/한선씨/서버/카테고리매핑.한선 (갱신)
  • /Users/ef/CrownyDoc/한선씨/서버/문서목록UI.한선 (신규)
  • /Users/ef/CrownyDoc/한선씨/서버/문서상세UI.한선 (신규)
  • 검증 결과

    항목결과
    서버 재시작정상 (포트 4100)
    /docs/ 응답200 OK
    통계 카드10개 stat-card 확인
    정렬 버튼9개 sort-btn 확인
    검색 하이라이트highlight 함수 확인
    TOC 사이드바27개 toc 요소 확인
    메타 바2개 meta-bar 확인
    이전/다음14개 nav 요소 확인
    카테고리 "기타"0건
    문법 검증node --check 통과