Unisquads Docs

v0.9.3

차세대 블록 기반 위지윅(WYSIWYG) 위키 시스템 구축

🏗 위키 패러다임의 변화: 블록 기반 편집 도입

기존의 불편한 텍스트 문법 중심 위키에서 벗어나, 누구나 직관적으로 문서를 구성할 수 있는 현대적인 블록 기반 위지윅(WYSIWYG) 시스템을 구축했습니다.

1. 강력한 슬래시 커맨드 (Slash Commands)

문서 어디서든 / 키를 입력하여 복잡한 레이아웃과 요소를 즉시 삽입할 수 있습니다.

  • 기본 요소: 제목(H1~H3), 체크리스트, 인용구 등
  • 고급 레이아웃:
    • 탭(Tabs): 여러 주제를 한 곳에 모아 관리하는 탭 시스템
    • 플렉스 및 그리드: 벤토 그리드(Bento Grid) 스타일 등 자유로운 레이아웃 구성 가능
    • 테이블: 직관적인 UI로 행/열을 추가하고 편집하는 표 시스템
  • 인터랙티브 요소:
    • 제목 토글(Toggle Headings): 클릭 시 내용이 펼쳐지는 접이식 제목
    • 미디어: 이미지(R2 기반), 유튜브/트위치 동영상, 외부 서비스 임베드 지원

2. 마크다운 단축키 (Markdown Shortcuts)

키보드만으로 빠른 편집이 가능하도록 단축 키워드를 지원합니다.

  • # + Space: 제목(H1) 자동 변환
  • ## + Space: 제목 토글(Toggle Heading) 자동 변환 등 다양한 단축어 지원

3. 컨텍스트 기반 우측 설정 사이드바

편집 중인 블록의 종류에 따라 우측 사이드바가 실시간으로 변합니다.

  • 선택한 이미지의 크기 및 정렬 설정
  • 테이블의 스타일 및 구조 관리
  • 탭 항목 추가/삭제 및 순서 변경 등
  • 각 위젯별 최적화된 설정 기능을 통해 편집 효율을 극대화했습니다.

🔍 투명한 기여 및 버전 관리 시스템

1. 블록 단위 리비전 및 디프(Diff)

문서 전체를 텍스트로 비교하던 기존 방식에서 벗어나, 블록 단위로 생성, 수정, 삭제된 요소를 추적합니다.

  • 어떤 블록이 추가되었고, 어떤 내용이 변경되었는지 시각적으로 명확하게 파악할 수 있습니다.

2. Blame 및 기여 분석

  • Blame 페이지: 특정 문장의 마우스를 올리면 해당 블록을 누가, 언제 기여했는지 개별적으로 확인할 수 있습니다.
  • 되돌리기(Restore): 과거 특정 시점의 리비전으로 문서를 즉시 복구할 수 있는 기능을 제공합니다.

📂 특수 네임스페이스 및 체계화된 분류

1. 분류(Category:) 페이지 구현

  • 단순한 문서 목록을 넘어, 분류 페이지 자체가 하나의 위키 문서로서 내용을 가질 수 있습니다.
  • 상위/하위 분류 계층을 시각적으로 관리하는 도구를 통해 방대한 위키 데이터를 체계화합니다.

2. 파일(File:) 페이지 구현

  • 업로드된 미디어 파일의 메타데이터, 사용처, 역사 등을 관리하는 전용 페이지가 도입되었습니다.
  • 이미지 및 동영상 자산을 중앙에서 효율적으로 관리할 수 있습니다.