18-2 캐릭터 도감과 캐릭터 참조

소설 속 인물, 게임 세계관의 아이템과 몬스터… 창작 노트가 쌓일수록 "이 캐릭터 얼굴이 뭐였더라?" 하게 되죠. 옵시코는 노트의 프론트매터만으로 캐릭터 사전(도감) 을 만들고, 본문에서 <<만 치면 얼굴 아이콘과 함께 대사를 쓸 수 있게 해드려요! 🎭

← 홈으로: 옵시코 101 · 형제 글: 18-1 이북·웹소설 뷰어 · 18-3 메신저·비주얼노블 뷰

1분 요약 ⏱️

• 노트 프론트매터에 name + type + 이미지 속성을 넣으면 그 노트가 도감의 한 항목이 됩니다.
• 상단 도구바의 도감 버튼(⌘⇧K)으로 볼트 전체의 캐릭터·아이템·몬스터를 카드 갤러리로 한눈에!
• 본문에서 << 를 치면 등록된 이름들이 주르륵 → 이미지 → 정렬까지 자동완성. 결과는 얼굴 아이콘 칩으로 예쁘게 렌더돼요.
• 이 참조는 18-1 이북·웹소설 뷰어와 18-3 메신저·비주얼노블 뷰에서도 그대로 살아 움직입니다!

1. 캐릭터 등록하기 — 프론트매터가 곧 프로필 🪪

캐릭터(또는 아이템·몬스터…) 노트 하나를 만들고, 프론트매터에 이렇게 적으세요.

---
name: 서연
type: 캐릭터
portrait: assets/서연-기본.png
color: "#e91e63"
---

💡 type: 배경인 항목은 인물이 아니라 배경 이미지 모음이에요. 본문에서 참조하면 구분선(장면 전환)으로, 메신저에선 월페이퍼로, 비주얼노블에선 무대 배경으로 쓰입니다.

💡 우클릭 '프론트매터 삽입' 은 기본으로 title·type: note·created(오늘)를 채워요. note는 도감에 안 잡히는 일반 문서용 값이라, 도감 항목으로 만들려면 type 값의 ▾ 버튼으로 캐릭터·아이템 등으로 바꿔 주세요. 날짜 속성은 달력에서 바로 고를 수 있고 오늘 날짜가 미리 들어갑니다.

프론트매터 편집이 이렇게 편해요 🛠️

• 이미지 속성(portrait·background·image·cover 등) 줄에는 ‘+ 이미지 선택’ 버튼이 떠요. 누르면 볼트 안 이미지 목록(파일명 + 회색 폴더명)에서 검색해 고를 수 있고, 값이 이미 있어도 버튼이 남아 있어 여러 장을 계속 추가할 수 있답니다.
• 사이드바나 밖에서 이미지를 프론트매터 줄로 끌어다 놓으면 본문 삽입이 아니라 그 속성의 값으로 쏙 들어가요.
• 색상 속성(color 등)은 값 앞의 색 견본(스와치)을 클릭하면 팔레트가 떠서 바로 고를 수 있어요. 값이 비어 있어도 점선 스와치를 눌러 시작하면 됩니다.
• type·view처럼 정해진 값이 있는 속성은 ▾ 버튼으로 값 목록에서 선택!

얼굴 아이콘과 수동 크롭 ✂️

포트레이트는 곳곳에서 동그란 얼굴 아이콘으로 잘려 나오는데, 옵시코가 얼굴을 자동 인식해 눈이 가운데 오도록 잘라줘요. 인식이 어긋났다면 프론트매터의 아이콘을 클릭해 보세요 — 드래그·휠·슬라이더로 직접 크롭을 잡을 수 있고, ‘전체 적용’ 을 누르면 같은 폴더의 형제 이미지들에도 한 번에 적용됩니다.

2. 본문에서 부르기 — <<이름:이미지>> 참조 🎬

본문에서 << 를 입력하면 마법이 시작됩니다.

1. 이름 목록이 떠요(등록된 name들) → 고르면
2. 그 캐릭터의 이미지 목록(인물/배경 라벨 표시) → 고르면
3. 정렬(중앙(기본)·왼쪽·오른쪽) 까지 자동완성!

이미지 뒤에 ! 를 치면 감정 효과 목록(점프·흔들·끄덕)이 떠서, 고르면 바로 정렬로 이어져요 — <<서연:웃음.png!점프--|>> 처럼요. (효과는 메신저·비주얼노블 뷰에서 말풍선/캐릭터가 콩! 하고 움직이는 연출이 됩니다.)

완성된 <<서연:서연-기본.png>> 은 에디터에서 이렇게 렌더돼요. - 인물: 동그란 얼굴 아이콘 + 이름(이름색은 color) 칩 — 뒤에 바로 대사를 이어 쓰면 됩니다. - 배경: 가운데에 ‘이름 · 이미지명’ 이 든 구분선 — 장면 전환 표시로 딱!

<<배경:골목길-밤.png>>
<<서연:서연-기본.png>> 늦어서 미안! 많이 기다렸지?
<<민준:민준-웃음.png--|>> 방금 왔어. 들어가자.

정렬 접미사(|--=왼쪽, --|=오른쪽)는 18-3 메신저·비주얼노블 뷰에서 말풍선 방향·캐릭터 위치가 돼요. 커서를 칩 위로 옮기면 원래 구문이 나타나 바로 고칠 수 있습니다.

뷰어에서는 이렇게 보여요 👀

• 이북·웹소설 뷰(18-1 이북·웹소설 뷰어): 인물 참조는 이름 없이 얼굴 아이콘 + “쌍따옴표 대사”, 배경 참조는 구분선 그대로. 단독 첨부한 음악은 배경음으로 흘러나옵니다. 🎵
• 메신저·비주얼노블 뷰: 참조가 곧 대본이 됩니다 — 자세한 건 18-3 메신저·비주얼노블 뷰에서!

3. 도감 뷰 — 내 세계관 카드 갤러리 🗂️

상단 도구바의 도감 버튼(또는 ⌘⇧K, 명령 팔레트에서 ‘도감’)을 누르면 메인 화면이 도감 탭으로 바뀝니다.

• 카테고리 탭: 전체 · 캐릭터 · 배경 · 아이템 · 이벤트 · 몬스터 · 스킬 — 프론트매터 type대로 자동 분류.
• 내 마음대로 카테고리 🗃️: 노트에 type: 세력처럼 새 값을 쓰면 그 이름의 탭이 자동 생성돼요(단, note·wiki 같은 문서 분류용 값은 제외되고, name이나 이미지 속성이 있는 노트만). 탭 줄 끝의 ⚙ 버튼에서 카테고리 표시/숨김·이름 바꾸기·순서 변경을 하고, 직접 새 카테고리를 추가할 수도 있습니다(추가하면 프론트매터 type ▾ 선택지에도 나타나요). 설정은 볼트별로 기억됩니다.
• 카드: 대표 이미지(image → portrait → background 순), 이름, 한 줄 설명. 검색과 정렬(이름/등장 횟수)도 됩니다.
• 새 항목 추가: 각 카테고리 목록 맨 끝의 + 타일을 누르면 그 분류에 맞는 프론트매터가 미리 채워진 새 노트가 생겨요(캐릭터면 portrait:, 배경이면 background:…).
• 우상단 ? 버튼을 누르면 도감 사용법 요약이 떠요. 보던 카테고리·정렬은 다음에 열 때도 기억!

카드를 누르면 — 상세 보기 🔎

• 이미지 갤러리: 등록된 모든 이미지를 그룹별로. 각 썸네일에서 ⧉ 참조 구문 복사, ↳ 본문에 삽입, 🔍 참조 보기 패널로 크게 열기가 한 번에!
• 등장 위치: 이 이름이 <<참조>>로 쓰인 노트·줄 목록 — 클릭하면 그 줄로 바로 점프.
• 함께 등장: 같은 노트에 자주 나오는 다른 인물 칩 — 관계망이 한눈에.
• 이미지 파일이 사라졌다면 카드·갤러리에 깨짐 표시가 떠서 정리하기도 쉬워요.

🧙 꿀팁: AI 에이전트(16 AI 에이전트)에게 "등장인물 노트마다 name/type/portrait 프론트매터를 채워줘"라고 부탁하면 기존 원고에서 도감을 순식간에 세울 수 있어요! 에이전트는 <<참조>> 문법도 알고 있어서 "이 소설을 메신저 대본으로 바꿔줘" 같은 요청도 됩니다(18-3 메신저·비주얼노블 뷰).

← 이전: 18-1 이북·웹소설 뷰어 · 처음으로 · 다음: 18-3 메신저·비주얼노블 뷰 →