wakeyi-git obsidian-card-navigator-plugin .cursorrules file for TypeScript (stars: 15)

Card Navigator

Card Navigator는 노트를 시각화하고 탐색하는 독특한 방법을 제공하는 Obsidian 플러그인입니다. 노트를 가로 또는 세로로 스크롤 가능한 카드 형태로 표시하여 콘텐츠를 더 쉽게 탐색하고 관리할 수 있습니다.

기능
1. 기본 기능
  - 사용자 지정 가능한 정보(파일 이름, 첫 번째 헤더, 내용)로 노트를 카드로 표시
  - 가로 또는 세로 스크롤 뷰
  - 뷰당 카드 수 사용자 지정 가능
  - 균일한 모양을 위한 카드 높이 정렬
  - 사용자 지정 가능한 카드 외관(글꼴 크기, 내용 길이 등)
  - 다양한 기준(이름, 생성 날짜, 수정 날짜)으로 카드 정렬
  - 현재 폴더 내 검색 기능
  - 쉬운 노트 연결을 위한 드래그 앤 드롭 지원
  - 특정 폴더의 카드 보기를 위한 폴더 선택
  - 카드 내용을 HTML로 렌더링하는 옵션

2. 프리셋
Card Navigator는 이제 프리셋을 지원하여 다양한 설정을 저장하고 빠르게 전환할 수 있습니다. 이 기능은 노트를 보고 상호작용하는 방식에 유연성을 제공하여 워크플로우를 향상시킵니다.
 - 사용자 정의 프리셋 생성: 현재 Card Navigator 설정을 이름이 지정된 프리셋으로 저장하여 나중에 사용할 수 있습니다.
 - 전역 프리셋: 모든 폴더에 적용되는 기본 프리셋을 설정할 수 있습니다(폴더별 설정으로 재정의되지 않는 한).
 - 폴더별 프리셋: 특정 폴더에 다른 프리셋을 할당하여 폴더 구조에 따라 맞춤형 뷰를 제공합니다.
 - 프리셋 자동 적용: 폴더 간 이동 시 적절한 프리셋을 자동으로 적용합니다.
 - 프리셋 가져오기/내보내기: 프리셋 파일을 가져오거나 내보내 프리셋을 공유하거나 설정을 백업할 수 있습니다.
 - 프리셋 관리: 설정 패널에서 직접 기존 프리셋을 편집, 복제 또는 삭제할 수 있습니다.
프리셋 사용 방법
 - 프리셋 생성:
   - Card Navigator 설정으로 이동
   - 원하는 설정을 구성
   - 프리셋 관리 섹션에서 "+" 버튼 클릭
   - 프리셋 이름을 지정하고 선택적으로 설명 추가
 - 프리셋 적용:
   - 전역: 전역 기본값으로 사용할 프리셋 토글
   - 폴더별: 폴더 프리셋 섹션에서 특정 폴더에 프리셋 할당
 - 프리셋 자동 적용:
   - 설정에서 "프리셋 자동 적용" 활성화
   - Card Navigator가 현재 폴더에 따라 적절한 프리셋으로 자동 전환
 - 프리셋 가져오기/내보내기:
   - 프리셋 관리 섹션의 가져오기/내보내기 버튼 사용
   - 내보낸 프리셋은 쉽게 공유하거나 백업할 수 있는 JSON 파일로 저장됨
   - 프리셋을 사용하면 보관함의 다른 부분이나 다른 유형의 노트에 맞게 Card Navigator의 동작을 조정할 수 있어 생산성과 노트 작성 경험을 향상시킬 수 있습니다.

3. 키보드 내비게이션
Card Navigator는 포괄적인 키보드 내비게이션 지원을 제공하여 마우스를 사용하지 않고도 효율적으로 노트를 탐색하고 상호 작용할 수 있습니다. 키보드 내비게이션 기능 사용법은 다음과 같습니다:
Card Navigator 포커싱:
 - 할당된 단축키를 사용하여 Card Navigator에 포커스(Obsidian의 단축키 설정에서 구성 가능).
 - 포커스되면 현재 카드가 강조 표시됩니다.
카드 간 이동:
 - 화살표 키를 사용하여 카드 간 이동:
 - 왼쪽/오른쪽: 카드 간 수평 이동
 - 위/아래: 카드 간 수직 이동
 - PageUp/PageDown: 한 페이지의 카드를 위 또는 아래로 스크롤
 - Home: 첫 번째 카드로 이동
 - End: 마지막 카드로 이동
카드와 상호 작용:
 - Enter: Obsidian에서 포커스된 카드 열기
 - 컨텍스트 메뉴 키 또는 사용자 지정 단축키: 포커스된 카드의 컨텍스트 메뉴 열기
컨텍스트 메뉴 작업:
 - 컨텍스트 메뉴가 열려 있을 때, 화살표 키를 사용하여 메뉴 항목 탐색
 - Enter: 강조 표시된 메뉴 항목 선택
Card Navigator 포커스 종료:
 - Tab을 누르거나 Card Navigator 외부를 클릭하여 포커스 모드 종료
 - 키보드 내비게이션은 모든 레이아웃 옵션(자동, 리스트, 그리드, 메이슨리)과 원활하게 작동하며, 현재 레이아웃에 따라 동작을 조정합니다.

4. 다양한 레이아웃 옵션: 자동, 리스트, 그리드, 메이슨리
Card Navigator는 이제 사용자의 선호도에 맞는 다양한 레이아웃 옵션을 제공합니다:
 - 자동: 사용 가능한 공간에 따라 리스트와 그리드 레이아웃 사이를 자동으로 조정
 - 리스트: 카드를 단일 열로 표시, 세로 또는 가로로 표시 가능
 - 그리드: 카드를 고정 열 그리드 레이아웃으로 배열
 - 메이슨리: 카드의 높이가 다양할 수 있는 동적 그리드 생성
레이아웃을 변경하려면:
 - Card Navigator 설정 열기
 - "레이아웃 설정" 섹션으로 이동
 - "기본 레이아웃" 드롭다운에서 원하는 레이아웃 선택
 - 각 레이아웃 유형에 특정한 추가 설정 조정(예: 그리드 및 메이슨리 레이아웃의 열 수)

5. 영어와 한국어 다국어 지원
Card Navigator는 이제 다음 언어를 지원합니다:
 - 영어
 - 한국어
플러그인은 지원되는 경우 자동으로 Obsidian 인터페이스 언어를 사용합니다.

설치
1. Obsidian을 열고 설정으로 이동합니다.
2. 커뮤니티 플러그인으로 이동하여 안전 모드를 비활성화합니다.
3. 커뮤니티 플러그인 탐색에서 "card navigator"를 검색하여 설치합니다.
4. 플러그인을 활성화합니다.

사용법
1. 설치 후, 다음과 같은 방법으로 Card Navigator 뷰를 열 수 있습니다:
 - 왼쪽 사이드바의 Card Navigator 아이콘 클릭
 - 명령 팔레트를 사용하여 "Open Card Navigator" 검색

2. 기본 탐색
 - 스크롤 휠이나 트랙패드를 사용하여 카드 간 이동
 - 카드를 클릭하여 해당 노트 열기
 - 툴바의 검색 바를 사용하여 카드 필터링

3. 사용자 지정
 - Card Navigator 툴바의 설정 아이콘 클릭
 - 뷰당 카드 수, 카드 외관, 표시 옵션 등의 설정 조정
 - 빠른 설정 전환을 위한 프리셋 생성 및 관리

4. 키보드 단축키
Card Navigator는 다양한 탐색 키보드 단축키를 지원합니다:
 - Card Navigator 플러그인 열기
 - Card Navigator로 포커스 이동(포커스 이동 후 아래의 키로 탐색)
  - 위/아래 화살표: 카드 간 수직 이동
  - 왼쪽/오른쪽 화살표: 카드 간 수평 이동
  - Enter: 포커스된 카드 열기
 - 컨텍스트 메뉴 키 또는 Cmd/Ctrl + E: 포커스된 카드의 컨텍스트 메뉴 열기
Obsidian의 단축키 설정에서 이러한 단축키를 사용자 지정할 수 있습니다. 이 작업에 대한 단축키를 설정하려면:
 - 설정 → 단축키로 이동
 - "Card Navigator" 검색
 - 각 작업에 원하는 키 조합 할당

5. 설정
Card Navigator는 다양한 사용자 지정 옵션을 제공합니다:
 - 프리셋: 다양한 구성 저장 및 불러오기
 - 컨테이너 설정: 소프 폴더, 카드 정렬 방법 선택
 - 레이아웃: 자동, 리스트, 그리드, 메이슨리 레이아웃 중 선택
 - 카드 내용 설정: 카드에 표시되는 정보 사용자 지정(파일 이름, 첫 번째 헤더, 내용)
 - 카드 스타일 설정: 다양한 카드 요소의 글꼴 크기 설정

파일 구조
Card Navigator/
├── src/
│   ├── common/
│   │   ├── IPresetManager.ts
│   │   │   └── 프리셋 관리 인터페이스를 정의하는 파일입니다.
│   │   ├── ISettingsManager.ts
│   │   │   └── 설정 관리 인터페이스를 정의하는 파일입니다.
│   │   ├── keyboardNavigator.ts
│   │   │   └── 키보드 내비게이션을 처리하는 클래스가 포함된 파일입니다.
│   │   ├── types.ts
│   │   │   └── 공통 타입 정의가 포함된 파일입니다.
│   │   └── utils.ts
│   │       └── 유틸리티 함수들이 포함된 파일입니다.
│   │
│   ├── locales/
│   │   ├── en.json
│   │   │   └── 영어 번역 리소스가 포함된 파일입니다.
│   │   └── ko.json
│   │       └── 한국어 번역 리소스가 포함된 파일입니다.
│   │
│   ├── main.ts
│   │   └── 플러그인의 메인 엔트리 포인트 파일입니다.
│   │
│   ├── ui/
│   │   ├── cardContainer/
│   │   │   ├── cardContainer.ts
│   │   │   │   └── 카드 컨테이너를 관리하는 클래스가 포함된 파일입니다.
│   │   │   └── cardMaker.ts
│   │   │       └── 카드 생성 로직이 포함된 파일입니다.
│   │   │
│   │   ├── cardNavigator.ts
│   │   │   └── 카드 네비게이터 뷰를 정의하는 파일입니다.
│   │   │
│   │   ├── layouts/
│   │   │   ├── gridLayout.ts
│   │   │   │   └── 그리드 레이아웃 전략을 구현한 파일입니다.
│   │   │   ├── layoutStrategy.ts
│   │   │   │   └── 레이아웃 전략 인터페이스를 정의한 파일입니다.
│   │   │   └── listLayout.ts
│   │   │       └── 리스트 레이아웃 전략을 구현한 파일입니다.
│   │   │
│   │   └── settings/
│   │       ├── PresetManager.ts
│   │       │   └── 프리셋 관리 로직이 포함된 파일입니다.
│   │       ├── cardContentSettings.ts
│   │       │   └── 카드 내용 설정을 추가하는 함수가 포함된 파일입니다.
│   │       ├── cardStyleSettings.ts
│   │       │   └── 카드 스타일 설정을 추가하는 함수가 포함된 파일입니다.
│   │       ├── components/
│   │       │   ├── Error.ts
│   │       │   │   └── 오류 처리 로직이 포함된 파일입니다.
│   │       │   ├── FolderSuggest.ts
│   │       │   │   └── 폴더 제안 기능을 구현한 파일입니다.
│   │       │   ├── Log.ts
│   │       │   │   └── 로그 관련 기능이 포함된 파일입니다.
│   │       │   ├── PresetSuggest.ts
│   │       │   │   └── 프리셋 제안 기능을 구현한 파일입니다.
│   │       │   ├── Utils.ts
│   │       │   │   └── 설정 관련 유틸리티 함수들이 포함된 파일입니다.
│   │       │   └── suggest.ts
│   │       │       └── 제안 기능을 구현한 파일입니다.
│   │       ├── containerSettings.ts
│   │       │   └── 컨테이너 설정을 추가하는 함수가 포함된 파일입니다.
│   │       └── settingsTab.ts
│   │           └── 설정 탭을 정의하는 파일입니다.
│
└── styles.css
    └── Card Navigator의 스타일을 정의하는 CSS 파일입니다.