Almanac

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

폴더 구성

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

설치

일반 설치 (인터넷 환경)

방법 1 — 커뮤니티 플러그인 마켓 (공식 · 권장)

옵시디언 공식 커뮤니티 플러그인 마켓에 등록되어 있어 별도 도구 없이 바로 설치할 수 있습니다.

• 마켓 페이지: https://community.obsidian.md/plugins/almanac
• 옵시디언 안에서: 설정 → 커뮤니티 플러그인 → 제한 모드 해제 → 둘러보기(Browse) → Almanac 검색 → 설치 → 사용(Enable)

템플릿을 쓰려면, templates/ 안의 **daily.md · meeting.md · event.md**를 볼트의 Templates/ 폴더에 복사하세요. (없어도 내장 기본 템플릿으로 동작합니다.)

방법 2 — 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 활성화

방법 3 — 수동 설치

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 등 자동 부여)
• 삭제 — 노트를 휴지통으로 보냅니다. (옵시디언 휴지통 설정에 따라 복구 가능)

추가 모달

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

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

기존 노트 인식 조건

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

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

템플릿

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

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

설정