18-2 キャラクター図鑑とキャラクター参照

小説の登場人物、ゲーム世界観のアイテムやモンスター…創作ノートが増えるほど「このキャラの顔、どんなだったっけ?」となりがちですよね。ObsiKOならノートのフロントマターだけでキャラクター辞典(図鑑)が作れて、本文で << と打つだけで顔アイコンとセリフを一緒に書けるようになります!🎭

← ホームへ: ObsiKO 101 · 関連記事: 18-1 電子書籍・ウェブ小説ビューア · 18-3 メッセンジャー・ビジュアルノベルビュー

1分で分かる要点 ⏱️

ノートのフロントマターに name + type + 画像プロパティを入れると、そのノートが図鑑の1項目になります。
上部ツールバーの図鑑ボタン(⌘⇧K)で、ボルト全体のキャラクター・アイテム・モンスターをカードギャラリーで一目に!
本文で << と打つと、登録した名前がずらりと出てきて → 画像 → 配置まで自動補完されます。結果は顔アイコンのチップとして綺麗にレンダリングされます。
この参照は 18-1 電子書籍・ウェブ小説ビューアと 18-3 メッセンジャー・ビジュアルノベルビューでもそのまま生きて動きます!

1. キャラクターを登録する — フロントマターがそのままプロフィール 🪪

キャラクター(またはアイテム・モンスターなど)のノートを1つ作り、フロントマターにこう書いてください。

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

プロパティ	役割
`name`	図鑑・自動補完に使われる名前(なければノートのタイトルを使用)。複数登録OK — `name: [ジス, Jisoo]` のように書くと最初が代表名、残りは別名になり、`<<参照>>`にどの名前を使っても同じキャラクターとして認識されます!
`type`	分類 — キャラクター・背景・アイテム・イベント・モンスター・スキル(英語表記の `character`/`item`… もOK)
`portrait`	人物画像(複数枚登録可能 — 表情・衣装違い用)
`background`	背景画像(`type` が背景のノートで使用、複数枚可)
`image`	アイテム・イベント・モンスター・スキルなどの代表画像
`color`	名前の表示色(エディタのチップ・メッセンジャーの名前・ビジュアルノベルの名前に反映)

💡 type: 배경 の項目は人物ではなく背景画像のコレクションです。本文で参照すると区切り線(場面転換)として、メッセンジャーでは壁紙として、ビジュアルノベルでは舞台背景として使われます。

💡 右クリックの「フロントマターを挿入」は、既定で title・type: note・created(今日)を入力します。note は図鑑に含まれない一般文書用の値なので、図鑑の項目にしたい場合は type 値の▾ボタンでキャラクター・アイテムなどに変更してください。日付プロパティはカレンダーからすぐ選べて、今日の日付が最初から入っています。

フロントマターの編集がこんなに楽 🛠️

画像プロパティ(portrait・background・image・cover など)の行には「+ 画像を選択」ボタンが表示されます。押すとボルト内の画像一覧(ファイル名+グレーのフォルダ名)から検索して選べ、すでに値が入っていてもボタンは残るので何枚でも追加できます。
サイドバーや外部から画像をフロントマターの行にドラッグ&ドロップすると、本文への挿入ではなくそのプロパティの値としてすっと入ります。
色プロパティ(color など)は、値の前のカラースウォッチをクリックするとパレットが開いて、すぐ選べます。値が空でも点線のスウォッチを押せば始められます。
type・view のように決まった値がある属性は、▾ボタンで値の一覧から選択!

顔アイコンと手動クロップ ✂️

ポートレートはあちこちで丸い顔アイコンとして切り出されますが、ObsiKOが顔を自動認識して目が中央にくるように切り抜いてくれます。認識がずれていたら、フロントマターのアイコンをクリックしてみてください — ドラッグ・ホイール・スライダーで手動でクロップを調整でき、「すべてに適用」を押すと同じフォルダにある兄弟画像にも一括で適用されます。

2. 本文で呼び出す — `<<名前:画像>>` 参照 🎬

本文で << と入力すると、魔法が始まります。

名前の一覧が表示されます(登録した name) → 選ぶと
そのキャラクターの画像一覧(人物/背景ラベル表示) → 選ぶと
配置(中央(既定)・左・右)まで自動補完!

画像の後ろに ! と打つと感情エフェクトの一覧(ジャンプ・シェイク・うなずき)が表示され、選ぶとそのまま配置の選択に続きます — <<서연:웃음.png!점프--|>> のように。(エフェクトはメッセンジャー・ビジュアルノベルビューで、吹き出しやキャラクターがぴょこん!と動く演出になります。)

完成した <<서연:서연-기본.png>> は、エディタでこのようにレンダリングされます。 - 人物: 丸い顔アイコン + 名前(名前の色は color)のチップ — その後ろにそのままセリフを続けて書けます。 - 背景: 中央に「名前・画像名」が入った区切り線 — 場面転換の表示にぴったり!

<<배경:골목길-밤.png>>
<<서연:서연-기본.png>> 遅れてごめん!随分待った?
<<민준:민준-웃음.png--|>> 今来たとこ。入ろう。

配置サフィックス(|--=左、--|=右)は 18-3 メッセンジャー・ビジュアルノベルビューで吹き出しの向き・キャラクターの位置になります。カーソルをチップの上に移動すると元の構文が表示され、すぐに修正できます。

ビューアではこう見えます 👀

電子書籍・ウェブ小説ビュー(18-1 電子書籍・ウェブ小説ビューア): 人物参照は名前なしで顔アイコン + 「かぎかっこ付きのセリフ」、背景参照は区切り線のまま。単独で添付した音楽はBGMとして流れます。🎵
メッセンジャー・ビジュアルノベルビュー: 参照がそのまま台本になります — 詳しくは 18-3 メッセンジャー・ビジュアルノベルビューで!

3. 図鑑ビュー — 自分の世界観をカードギャラリーで 🗂️

上部ツールバーの図鑑ボタン(または ⌘⇧K、コマンドパレットで「図鑑」)を押すと、メイン画面が図鑑タブに切り替わります。

カテゴリタブ: 全体・キャラクター・背景・アイテム・イベント・モンスター・スキル — フロントマターの type に沿って自動分類。
好きなカテゴリを作れる 🗃️: ノートに type: 세력 のように新しい値を書くと、その名前のタブが自動で作られます(ただし note・wiki のような文書分類用の値は除外され、name か画像プロパティがあるノートのみが対象)。タブ行の端の⚙ボタンでカテゴリの表示/非表示・名前の変更・並べ替えができ、直接新しいカテゴリを追加することもできます(追加すると、フロントマターの type ▾ の選択肢にも表示されます)。設定はボルトごとに記憶されます。
カード: 代表画像(image → portrait → background の順)、名前、一行の説明。検索と並べ替え(名前/登場回数)もできます。
新規項目の追加: 各カテゴリ一覧の一番端にある+タイルを押すと、その分類に合ったフロントマターがあらかじめ入力された新しいノートが作られます(キャラクターなら portrait:、背景なら background:…)。
右上の?ボタンを押すと図鑑の使い方の要約が表示されます。見ていたカテゴリ・並べ替えは次に開いたときも記憶されます!

カードを押すと — 詳細ビュー 🔎

画像ギャラリー: 登録されたすべての画像をグループ別に。各サムネイルで⧉ 参照構文をコピー、↳ 本文に挿入、🔍 参照ビューパネルで大きく開くが一度に!
登場箇所: この名前が <<参照>> として使われたノート・行の一覧 — クリックするとその行にすぐジャンプします。
共演: 同じノートによく登場する他の人物のチップ — 関係性が一目で分かります。
画像ファイルが消えていたら、カード・ギャラリーに破損マークが表示されるので整理もしやすいです。

🧙 豆知識: AIエージェントに「登場人物のノートごとに name/type/portrait のフロントマターを埋めて」と頼めば、既存の原稿から図鑑をあっという間に構築できます!エージェントは <<参照>> の文法も理解しているので、「この小説をメッセンジャー台本に変えて」といった依頼も可能です(18-3 メッセンジャー・ビジュアルノベルビュー)。

← 前へ: 電子書籍・ウェブ小説ビューア · 最初へ · 次へ: メッセンジャー・ビジュアルノベルビュー →