Tee's Novel View

.txt ファイルを小説として閲覧するための、閲覧専用の「小説ビュー」を追加する VS Code 拡張機能です。

• 「小説家になろう」形式のルビ表記を、実際のルビとして表示
• 会話文「」・心の声（）・『』内・数字（漢数字を含む）の色分け、正規表現による任意のカラーリング（個別に ON/OFF 可）
• 1行あたりの表示文字数、行番号、カーソルと範囲選択、ミニマップ
• 物語ファイル一覧（アクティビティバー）と前話・次話への移動
• ブックマーク（名前付き・一覧から移動・F2 で移動）
• ステータスバーに文字数（ルビ・改行・空白を除く）とカーソル行を表示
• 文字色・背景色は VS Code のテーマに追従

インストール

VS Code の拡張機能ビュー（Ctrl+Shift+X）で「Tee's Novel View」を検索してインストールするか、次のコマンドを実行します。

code --install-extension Tees-software.tees-novel-view

動作環境: VS Code 1.75 以降

使い方

ショートカットは Windows / Linux の表記です。Mac では Ctrl を Cmd に読み替えてください。

小説ビューとソースは同じ場所で切り替わり、読んでいた位置とカーソル・選択範囲が引き継がれます（未保存の変更がある場合、ソースのタブは閉じずに残ります）。横に開いた場合は、編集内容が小説ビューにリアルタイムで反映され、エディターのスクロールにも追従します。

カーソルと選択

小説ビューは閲覧専用ですが、クリックした位置にカーソルが表示されます。

• ← → ↑ ↓ で移動、Shift を押しながらで範囲選択
• Home / End で表示上の行頭・行末、Ctrl+Home / Ctrl+End で先頭・末尾
• Ctrl+A で全文選択、Ctrl+C でコピー（ルビの読みは含まれません）

物語ファイル一覧

左端のアクティビティバーの本のアイコンから、物語ファイルの一覧を表示できます。

• ファイルを選択すると、エディターで表示中の小説ビューがあればそこに置き換えて表示し、無ければ新しい小説ビューで開きます
• 一覧の右上のボタンで、クリックしたときの開き方を切り替えられます（本のアイコン: 小説ビューで開く / テキストファイルのアイコン: 元のテキストファイルをエディターで開く。設定 teesNovelView.stories.openInNovelView）
• 一覧はフォルダーごとのツリーで、番号順（第2話 → 第10話）に並びます
• ファイルの先頭が「第〇話　タイトル」の形式なら、ファイル名の右にタイトル（話数を除いた部分。ルビ記法はそのまま）を表示します（例: 第01話 旅立ち）
• 表示中の小説ビューのファイルは、一覧で選択状態になります
• エクスプローラーと同じく、Git の状態（変更あり・未追跡など）に応じて色と記号が付きます
• ファイルの追加・削除・保存に合わせて自動で更新されます（右上のボタンで手動の再読み込みも可能）

物語ファイルの自動検知: 探すフォルダー内の .txt のうち、次のいずれかに当てはまるものを物語ファイルとみなします（UTF-8 / Shift_JIS）。

• ルビ 《》 がある
• 会話文 「」 『』 や心の声（行頭の （…））が 2 つ以上ある
• 全角スペースで字下げした行が 3 行以上ある

さらに、物語ファイルは他のファイルと分けて 1 か所にまとめられている前提で、物語ファイルが見つかったフォルダーの .txt はすべて物語ファイルとして扱います（内容から判定できない短いファイルやメモも含まれます）。

• 親フォルダーの中身（サブフォルダーを含む）が .txt だけなら、親フォルダーも対象に広げます。小説/第1章/・小説/第2章/ のように章ごとに分けていても、どこか 1 か所で見つかれば 小説/ 全体が対象になります
• .ts や .md など別の種類のファイルがある階層で止まるので、物語以外の場所には広がりません
• 対象フォルダーの下のサブフォルダーは、中身が .txt だけのものを対象にします

検知されない場合や、別の場所を参照したい場合は、次の設定で調整できます。

ブックマーク

小説ビューで、カーソルのある行をブックマークできます。

• 名前はその行の冒頭の文章で自動的に付きます。一覧では行番号を名前の前に 12: その日、少年は王都の外れにある古い… の形で表示します（行番号は編集に合わせて常に最新）。名前は一覧の「名前を変更」で変えられます。同じ行でもう一度操作すると削除します
• ブックマークした行は、行番号の左（行番号が非表示のときは行の左の余白）に青い栞のマークが表示されます。マークにマウスを乗せると名前が表示されます
• 一覧から選ぶと、表示中の小説ビューがあればそこに、無ければ新しい小説ビューでその行を開きます
• ソースを編集して行が増減しても、ブックマークは同じ文章についていきます。ファイル名の変更にも追従します
• ブックマークはワークスペース（開いているフォルダー）ごとに保存され、VS Code を閉じても残ります。保存先は VS Code の内部なので、フォルダーの中にファイルは作られません
• F2 / Shift+F2 は、既定では表示中のファイルの中だけで移動します。ファイルをまたぐ移動を ON にすると、一覧の並び順で次のファイルのブックマークへ進みます（設定 teesNovelView.bookmarks.crossFile）

ステータスバー

文字数はルビ記法（| 《》 とルビの読み）を除いた、表示される文字の数です。改行と空白（半角・全角スペース、タブなど）は数えません。

前話・次話

ファイル名の番号（既定では最後の数字。半角・全角どちらも可）を前後させたファイルを、同じタブで開きます。

• 同じフォルダーの .txt のうち、番号より前の部分が同じファイルが対象です（第01話_旅立ち.txt → 第02話_森の中で.txt のように、番号の後ろのタイトルは違っていても構いません）
• 番号が飛んでいる場合は、その方向で最も近い番号のファイルを開きます
• 前後の話が無い場合、アイコンは押せない状態になります
• 前話・次話のアイコンの右のボタンで、移動の仕方を切り替えられます（設定 teesNovelView.episode.followStoryList）
  • フォルダーのアイコン（既定）: 同じフォルダーの中から、ファイル名の番号で前後を探します
  • ツリーのアイコン: 物語ファイル一覧の並び順で前後へ移動します。章ごとのフォルダー（第1章/第03話 → 第2章/第04話）や、あとがき のように番号の付け方が違うファイルもまたいで移動できます。表示中のファイルが一覧に無い場合は、ファイル名の番号で探します
• 番号の取り出し方は teesNovelView.episode.numberPattern（正規表現）で変更できます。キャプチャグループがあれば1番目のグループを番号とみなします（例: 第([0-9０-９]+)話）

ルビ表記

親文字は20文字、ルビは10文字まで。これを超える場合はルビにせずそのまま表示します。

対応していない書き方

次の書き方はルビ（や傍点などの装飾）として扱わず、書かれた文字をそのまま表示します。

設定

物語ファイル一覧の探し方の設定（teesNovelView.stories.roots など）は、物語ファイル一覧 を参照してください。

漢数字は前後の文字で「数として使われているか」を判定します。直前が漢字（接頭語を除く）、または直後が助数詞以外の漢字の場合は熟語の一部とみなして色を付けません（例: 三人・二十一歳・第三話・一つ → 色付け / 統一・一緒・九州・八百屋 → 色なし）。

各グループは enabled（ON/OFF）・color（CSS の色指定）を持ち、括弧グループは brackets（開き・閉じの2文字）で対象の括弧を変更できます。

優先順位は 正規表現ルール > 数字 > 括弧（括弧が入れ子の場合は内側が優先）です。

正規表現ルールの例

"teesNovelView.highlight.customRules": [
  { "name": "隅付き括弧", "pattern": "【[^】]*】", "color": "#C586C0" },
  { "name": "主人公", "pattern": "アリス", "color": "#F48771", "enabled": false }
]

flags に i m s u を指定できます（g は自動付与）。後に書いたルールほど優先されます。

開発

開発者向けの情報（ビルド・テスト・.vsix の作成など）は CONTRIBUTING.md を参照してください。

注意

• Shift_JIS などのファイルは VS Code が認識したエンコーディングで読み込まれます。文字化けする場合は files.autoGuessEncoding を有効にするか、エディターでエンコーディングを指定して開き直してください。

ライセンス

MIT