Almanac

Almanac

Full Calendar형 메인 뷰(월/주) + 컴팩트 사이드바 + 데일리/회의록/일정 추가를 하나의 플러그인으로. Journals · Full Calendar · QuickAdd · Commander를 전부 대체합니다.

폴더 구성

almanac/
├── main.js          ← 플러그인 본체
├── manifest.json    ← 플러그인 정보
├── styles.css       ← 디자인
├── templates/       ← 기본 템플릿 md 파일 3종
└── README.md

---

설치

일반 설치 (인터넷 환경)

방법 1 — BRAT 플러그인 사용 (권장)

커뮤니티 플러그인 마켓에서 아직 공개되지 않은 플러그인을 손쉽게 설치할 수 있는 방법입니다.

1. 옵시디언 → 설정 → 커뮤니티 플러그인 → BRAT 검색 후 설치 및 활성화
2. BRAT 설정 → Add Beta plugin → 이 저장소의 GitHub URL 입력
3. BRAT가 main.js · manifest.json · styles.css를 자동으로 내려받아 설치
4. templates/ 안의 **daily.md · meeting.md · event.md**를 볼트의 Templates/ 폴더에 복사
   • Templates/ 폴더가 없으면 볼트 루트에 직접 만들면 됩니다.
5. 설정 → 커뮤니티 플러그인 → Almanac 활성화

방법 2 — 수동 설치

1. 이 저장소에서 main.js · manifest.json · styles.css · templates/ 폴더를 내려받습니다.
   • 폐쇄망/VDI: 파일을 미리 받아 두거나 USB 등으로 옮겨 온 뒤 2단계부터 진행합니다.
2. 볼트 안에 .obsidian/plugins/almanac/ 폴더를 만듭니다.
   • .obsidian/ 폴더는 운영체제에서 숨김 처리되어 있을 수 있습니다. (Mac: Cmd+Shift+. 으로 토글)
3. main.js · manifest.json · styles.css 3개를 그 폴더에 복사합니다.
4. templates/ 안의 **daily.md · meeting.md · event.md**를 볼트의 Templates/ 폴더에 복사합니다.
   • Templates/ 폴더가 없으면 볼트 루트에 직접 만들면 됩니다.
5. 옵시디언 → 설정 → 커뮤니티 플러그인 → 제한 모드 해제 → Almanac 활성화

제한 모드 해제가 필요한 이유: 옵시디언은 보안상 커뮤니티 플러그인을 기본 차단합니다. 수동 설치 플러그인을 쓰려면 이 설정을 한 번만 해제하면 됩니다.

---

두 가지 뷰

전체 캘린더 (메인)

리본의 calendar 아이콘 또는 커맨드 팔레트에서 열 수 있습니다.

• 월간 뷰: 큰 칸에 일정이 이름과 함께 표시됩니다.
  • 빈 칸 클릭 → 「일정 추가 / 회의록 추가」 선택 메뉴
  • 날짜 숫자 클릭 → 데일리 노트 열기
  • 일정 막대를 다른 날로 끌어 이동 가능
• 주간 뷰: 시간 그리드(시작/끝 시각은 설정에서 변경 가능)
  • 빈 시간대 클릭 또는 드래그 → 「일정 추가 / 회의록 추가」 선택 메뉴 → 해당 시간으로 생성 모달
  • 드래그 시 선택한 시간 범위가 유지된 채로 메뉴가 표시됨
  • 요일 헤더 클릭 → 「일정 추가 / 회의록 추가」 선택 메뉴
  • 이벤트 블록을 끌어 시간·요일 이동, 블록 위/아래 가장자리로 길이 조절
  • 30분 단위 스냅, 종료가 시작보다 빠르면 시작+30분으로 자동 보정
  • startTime이 없거나 allDay: true인 일정은 맨 위 종일 줄에 표시됩니다.

사이드바 (컴팩트)

리본의 panel-right 아이콘으로 열 수 있습니다.

• 외곽선 없는 작은 달력, 날짜마다 이벤트 색점 표시
• 날짜 클릭 → 데일리 노트 열기
• 아래에 예정된 일정·회의 목록 표시 (기본 앞으로 2주치, 설정에서 일수 변경 가능)

---

리본 아이콘

옵시디언 창 맨 왼쪽 세로 아이콘 막대에 5개가 추가됩니다. (설정에서 각각 숨김 가능)

---

커맨드 팔레트 명령어

Ctrl+P (Mac: Cmd+P)에서 Almanac으로 검색하면 모든 기능을 단축키 없이 바로 실행할 수 있습니다.

• 캘린더(전체) 열기 — 월/주 전환 가능한 메인 캘린더
• 캘린더(사이드바) 열기 — 컴팩트 미니 캘린더 + 예정 목록
• 회의록 추가 — 회의록 생성 모달 바로 열기
• 일정 추가 — 일정 생성 모달 바로 열기
• 오늘 데일리 노트 — 오늘 날짜의 데일리 노트 열기(없으면 생성)

---

우클릭 메뉴

일정·회의록 막대(또는 블록)에서 오른쪽 클릭 시:

• 노트 열기 — 해당 노트를 엽니다.
• 복제 — 같은 날짜·시간·본문 그대로 사본 1개를 만듭니다. (파일명에 2 등 자동 부여)
• 삭제 — 노트를 휴지통으로 보냅니다. (옵시디언 휴지통 설정에 따라 복구 가능)

---

추가 모달

제목 + 날짜 + 시작/종료 시간 드롭다운 → [만들기]

• 회의록은 회의록/, 일정은 Events/ 폴더에 생성됩니다. (폴더는 없으면 자동 생성)
• 달력에 바로 반영됩니다.
• 만든 일정·회의는 그날 데일리 노트의 백링크에 자동으로 나타납니다.
  (frontmatter에 daily: "[[날짜]]" 가 기록되어, 그 데일리 노트를 열면 백링크 패널에 표시됨)

---

기존 노트 인식 조건

Almanac은 설정된 폴더 안의 마크다운 파일을 자동으로 읽어 캘린더에 표시합니다.
기존에 다른 플러그인으로 만든 노트도 아래 조건을 만족하면 그대로 인식됩니다.

Events/ · 회의록/ · Daily/ 폴더의 기존 노트는 frontmatter 형식이 같다면 수정 없이 그대로 읽힙니다.

---

템플릿

템플릿은 Templates/ 폴더의 md 파일을 읽어서 사용합니다.
md 파일을 수정하면 다음 생성부터 바로 반영됩니다. (플러그인 설정에서 별도 입력 불필요)

• 파일 위치/이름은 설정 → Almanac → 템플릿에서 변경 가능
• 파일이 없으면 내장 기본 템플릿 자동 사용
• 사용 가능한 치환 변수: {{title}} {{date}} {{startTime}} {{endTime}} {{weekday}}
• 회의록·일정 생성 시 플러그인이 daily(백링크) 필드를 템플릿과 무관하게 자동 추가합니다.
• 회의록 모달에서 입력한 참석자는 attendees 필드에 위키링크 배열로 자동 기록됩니다.

---

설정