Card Navigator

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

기능

• 사용자 지정 가능한 정보(파일 이름, 첫 번째 헤더, 내용)로 노트를 카드로 표시
• 가로 또는 세로 스크롤 뷰
• 뷰당 카드 수 사용자 지정 가능
• 다양한 기준(이름, 생성 날짜, 수정 날짜)으로 카드 정렬
• 키보드 단축키를 사용한 빠른 카드 간 탐색
• 현재 폴더 내 검색 기능
• 쉬운 노트 연결을 위한 드래그 앤 드롭 지원
• 사용자 지정 가능한 카드 외관(글꼴 크기, 내용 길이 등)
• 다양한 설정 간 빠른 전환을 위한 프리셋 관리 (1.0.1)
• 특정 폴더의 카드 보기를 위한 폴더 선택
• 카드 내용을 HTML로 렌더링하는 옵션
• 균일한 모양을 위한 카드 높이 정렬
• 접근성 향상을 위한 키보드 내비게이션 지원 (1.0.2)
• 카드에 대한 빠른 작업을 위한 컨텍스트 메뉴 (1.0.2)
• 영어와 한국어 다국어 지원
• 다양한 레이아웃 옵션: 자동, 리스트, 그리드, 메이슨리 (1.0.3)

설치

1. 이 플러그인은 아직 Obsidian의 검토 과정을 통과하지 않았습니다.
2. Releases 섹션에서 main.js, manifest.json, styles.css 파일을 다운로드합니다.
3. .obsidian/plugins/ 폴더 안에 적절한 이름의 새 폴더를 만들고 2단계에서 다운로드한 파일들을 그 안에 붙여넣습니다.
4. Obsidian을 열고 설정으로 이동합니다.
5. 커뮤니티 플러그인으로 이동하여 안전 모드를 비활성화합니다.
6. 플러그인을 활성화합니다.

사용법

설치 후, 다음과 같은 방법으로 Card Navigator 뷰를 열 수 있습니다:

1. 왼쪽 사이드바의 Card Navigator 아이콘 클릭
2. 명령 팔레트를 사용하여 "Open Card Navigator" 검색

기본 탐색

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

사용자 지정

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

키보드 단축키

Card Navigator는 다양한 탐색 키보드 단축키를 지원합니다:

• 카드 위로 스크롤
• 카드 아래로 스크롤
• 카드 왼쪽으로 스크롤
• 카드 오른쪽으로 스크롤
• 페이지 위/왼쪽으로 스크롤
• 페이지 아래/오른쪽으로 스크롤
• 활성 카드 중앙 정렬
• Card Navigator 포커스 (1.0.2)
• 위/아래 화살표: 카드 간 수직 이동 (1.0.2)
• 왼쪽/오른쪽 화살표: 카드 간 수평 이동 (1.0.2)
• Enter: 포커스된 카드 열기 (1.0.2)
• 컨텍스트 메뉴 키 또는 Cmd/Ctrl + E: 포커스된 카드의 컨텍스트 메뉴 열기 (1.0.2)

Obsidian의 단축키 설정에서 이러한 단축키를 사용자 지정할 수 있습니다. 이 작업에 대한 단축키를 설정하려면:

1. 설정 → 단축키로 이동
2. "Card Navigator" 검색
3. 각 작업에 원하는 키 조합 할당

설정

Card Navigator는 다양한 사용자 지정 옵션을 제공합니다:

• 컨테이너 설정: 뷰당 카드 수 및 카드 정렬 조정
• 카드 설정: 카드에 표시되는 정보 사용자 지정 (파일 이름, 첫 번째 헤더, 내용)
• 외관: 다양한 카드 요소의 글꼴 크기 설정
• 정렬: 카드의 기본 정렬 방법 선택
• 폴더 선택: 활성 파일의 폴더 또는 선택한 폴더 사용 옵션
• 프리셋: 다양한 구성 저장 및 불러오기
• 레이아웃: 자동, 리스트, 그리드, 메이슨리 레이아웃 중 선택 (1.0.3)

다국어 지원

Card Navigator는 이제 다음 언어를 지원합니다:

• 영어
• 한국어

플러그인은 지원되는 경우 자동으로 Obsidian 인터페이스 언어를 사용합니다. GitHub 저장소에 풀 리퀘스트를 제출하여 다른 언어의 번역에 기여할 수 있습니다.

프리셋

Card Navigator는 이제 프리셋을 지원하여 다양한 설정을 저장하고 빠르게 전환할 수 있습니다. 이 기능은 노트를 보고 상호작용하는 방식에 유연성을 제공하여 워크플로우를 향상시킵니다.

주요 기능

1. 사용자 정의 프리셋 생성: 현재 Card Navigator 설정을 이름이 지정된 프리셋으로 저장하여 나중에 사용할 수 있습니다.

2. 전역 프리셋: 모든 폴더에 적용되는 기본 프리셋을 설정할 수 있습니다 (폴더별 설정으로 재정의되지 않는 한).

3. 폴더별 프리셋: 특정 폴더에 다른 프리셋을 할당하여 폴더 구조에 따라 맞춤형 뷰를 제공합니다.

4. 프리셋 자동 적용: 폴더 간 이동 시 적절한 프리셋을 자동으로 적용합니다.

5. 프리셋 가져오기/내보내기: 프리셋 파일을 가져오거나 내보내 프리셋을 공유하거나 설정을 백업할 수 있습니다.

6. 프리셋 관리: 설정 패널에서 직접 기존 프리셋을 편집, 복제 또는 삭제할 수 있습니다.

프리셋 사용 방법

1. 프리셋 생성:

   • Card Navigator 설정으로 이동
   • 원하는 설정을 구성
   • 프리셋 관리 섹션에서 "+" 버튼 클릭
   • 프리셋 이름을 지정하고 선택적으로 설명 추가

2. 프리셋 적용:

   • 전역: 전역 기본값으로 사용할 프리셋 토글
   • 폴더별: 폴더 프리셋 섹션에서 특정 폴더에 프리셋 할당

3. 프리셋 자동 적용:

   • 설정에서 "프리셋 자동 적용" 활성화
   • Card Navigator가 현재 폴더에 따라 적절한 프리셋으로 자동 전환

4. 프리셋 가져오기/내보내기:

   • 프리셋 관리 섹션의 가져오기/내보내기 버튼 사용
   • 내보낸 프리셋은 쉽게 공유하거나 백업할 수 있는 JSON 파일로 저장됨

프리셋을 사용하면 보관함의 다른 부분이나 다른 유형의 노트에 맞게 Card Navigator의 동작을 조정할 수 있어 생산성과 노트 작성 경험을 향상시킬 수 있습니다.

키보드 내비게이션 (1.0.2)

Card Navigator는 이제 포괄적인 키보드 내비게이션 지원을 제공하여 마우스를 사용하지 않고도 효율적으로 노트를 탐색하고 상호 작용할 수 있습니다. 키보드 내비게이션 기능 사용법은 다음과 같습니다:

1. Card Navigator 포커싱:

   • 할당된 단축키를 사용하여 Card Navigator에 포커스 (Obsidian의 단축키 설정에서 구성 가능).
   • 포커스되면 현재 카드가 강조 표시됩니다.

2. 카드 간 이동:

   • 화살표 키를 사용하여 카드 간 이동:
     • 왼쪽/오른쪽: 카드 간 수평 이동
     • 위/아래: 카드 간 수직 이동
   • PageUp/PageDown: 한 페이지의 카드를 위 또는 아래로 스크롤
   • Home: 첫 번째 카드로 이동
   • End: 마지막 카드로 이동

3. 카드와 상호 작용:

   • Enter: Obsidian에서 포커스된 카드 열기
   • 컨텍스트 메뉴 키 또는 사용자 지정 단축키: 포커스된 카드의 컨텍스트 메뉴 열기

4. 컨텍스트 메뉴 작업:

   • 컨텍스트 메뉴가 열려 있을 때, 화살표 키를 사용하여 메뉴 항목 탐색
   • Enter: 강조 표시된 메뉴 항목 선택

5. Card Navigator 포커스 종료:

   • Tab을 누르거나 Card Navigator 외부를 클릭하여 포커스 모드 종료

키보드 내비게이션은 모든 레이아웃 옵션(자동, 리스트, 그리드, 메이슨리)과 원활하게 작동하며, 현재 레이아웃에 따라 동작을 조정합니다.

레이아웃 옵션 (1.0.3)

Card Navigator는 이제 사용자의 선호도에 맞는 다양한 레이아웃 옵션을 제공합니다:

1. 자동: 사용 가능한 공간에 따라 리스트와 그리드 레이아웃 사이를 자동으로 조정
2. 리스트: 카드를 단일 열로 표시, 세로 또는 가로로 표시 가능
3. 그리드: 카드를 고정 열 그리드 레이아웃으로 배열
4. 메이슨리: 카드의 높이가 다양할 수 있는 동적 그리드 생성

레이아웃을 변경하려면:

1. Card Navigator 설정 열기
2. "레이아웃 설정" 섹션으로 이동
3. "기본 레이아웃" 드롭다운에서 원하는 레이아웃 선택
4. 각 레이아웃 유형에 특정한 추가 설정 조정 (예: 그리드 및 메이슨리 레이아웃의 열 수)

피드백 및 지원

문제가 발생하거나 개선을 위한 제안이 있으면 GitHub 저장소를 방문하여 이슈를 열거나 프로젝트에 기여해 주세요.

라이선스

MIT