Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/wakeyi-git/obsidian-card-navigator-plugin

Obsidian Navigator displays notes in card form
https://github.com/wakeyi-git/obsidian-card-navigator-plugin

markdown note-taking obsidian obsidian-plugin productivity

Last synced: 9 days ago
JSON representation

Obsidian Navigator displays notes in card form

Awesome Lists containing this project

README 

        
# Card Navigator



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



## 기능



- 사용자 지정 가능한 정보(파일 이름, 첫 번째 헤더, 내용)로 노트를 카드로 표시

- 가로 또는 세로 스크롤 뷰

- 뷰당 카드 수 사용자 지정 가능

- 다양한 기준(이름, 생성 날짜, 수정 날짜)으로 카드 정렬

- 키보드 단축키를 사용한 빠른 카드 간 탐색

- 현재 폴더 내 검색 기능

- 쉬운 노트 연결을 위한 드래그 앤 드롭 지원

- 사용자 지정 가능한 카드 외관(글꼴 크기, 내용 길이 등)

- 다양한 설정 간 빠른 전환을 위한 프리셋 관리 (1.0.1)

- 특정 폴더의 카드 보기를 위한 폴더 선택

- 카드 내용을 HTML로 렌더링하는 옵션

- 균일한 모양을 위한 카드 높이 정렬

- 접근성 향상을 위한 키보드 내비게이션 지원 (1.0.2)

- 카드에 대한 빠른 작업을 위한 컨텍스트 메뉴 (1.0.2)

- 영어와 한국어 다국어 지원

- 다양한 레이아웃 옵션: 자동, 리스트, 그리드, 메이슨리 (1.0.3)



![alt text]()

![alt text]()



## 설치



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 저장소](https://github.com/wakeyi-git/obsidian-card-navigator-plugin)를 방문하여 이슈를 열거나 프로젝트에 기여해 주세요.



## 라이선스



[MIT](LICENSE)