ヘルプ: アプリごとの使い方の頁・メニューの整理・元の SRC のヘルプのアーカイブ by 7474 · Pull Request #1445 · 7474/SRC

7474 · 2026-11-03T08:37:34Z

概要

ヘルプ（https://srch.7474.jp/ ）を、次の 5 点で整理します。

アプリごとの使い方の頁を揃える
メニューを並べ直す
メニューを 1 か所で管理する
元の SRC（VB 版、Ver2.2.33）のヘルプを、独立した場所に WinHelp に似せた画面のアーカイブとして置く
元の SRC のヘルプのポップアップ（CHM にしたときに失われていたもの）を、アーカイブと SRC# のヘルプの両方で扱う

変更

1. アプリごとの使い方の頁を揃える

「SRC#Webの使い方」を加えました。
- 書いた内容: シナリオ選択の画面、シナリオ・素材の追加、セーブデータ、タッチ操作、仮想パッド、システムメニュー、設定、元の SRC・ほかの SRC# との違い。
- これまで SRC#Web の操作は、開発者向けの docs/gui/web.md にしか書いていませんでした。docs/gui/web.md の冒頭から、この頁へリンクしています。
「SRC#Formの使い方」を加えました。
- 書いた内容: 起動の画面、srcs.json で変える設定、ログ、ほかの SRC# との違い。
「SRC#のインストール」から、各アプリの使い方の頁へリンクしました。SRC#Web の入手先に https://src.koudenpa.net/ も加えています。

2. メニューを並べ直す

区分	頁
お使いになる前に	はじめに・動作環境・使用条件・SRCとの互換性
遊ぶ	SRC#のインストール・SRC#Web／Avalonia／Form の使い方・SRCの起動・サンプルシナリオをプレイする・他のシナリオをプレイする・更新インストール・アンインストール
シナリオ・素材の用意	SRCのインストール・インストールの手順・MIDIファイルのインストール
困ったとき	インストール時のエラーへの対処・ログ
操作方法	ゲームの流れ以降（これまでどおり）
元の SRC について	「元のSRCのヘルプ」（アーカイブへの入口）を加えました

頁のファイル名は変えていません。srcsharp help が、頁をファイル名で引くためです。

3. メニューを 1 か所で管理する

menu.yml を正とし、menu.md は tools/help_menu.py で作ります。
CI の build-help で --check を動かし、次を確かめます。
- menu.md が menu.yml と合っていること
- リンク先の頁があること
- 頁の title とメニューの名前が同じこと
2 つのファイルにあった食い違いは、menu.yml に合わせました。
- menu.md にだけ載っていた未対応の Flash のコマンド（ClearFlash・PlayFlash）は外しました。頁そのものは残しています。
- menu.yml にだけあった「オートプレイ」「更新履歴(v2.3)」が、menu.md にも載ります。

4. 元の SRC のヘルプのアーカイブ（https://srch.7474.jp/vb/ ）

tools/vb_help_archive.py が、SRC/HelpChm（HTML・画像・目次・索引）と SRC/Help（WinHelp のプロジェクト Src.hdp・SHG）から、SRC.Sharp.Help/src/vb/ を作ります。作ったものはコミットしています。
見た目: Windows 95 のヘルプ（WinHelp）に似せました（tools/vb_help_archive/winhelp.css・winhelp.js）。
- 上に、ボタンの列（目次・表紙・戻る・<<・>>）を置きました。
- 左に「ヘルプトピック」の欄（目次のツリー・キーワード・検索のタブ）を置きました。狭い画面では引き出しになります。
- 本文の下に、前後の頁へのリンク（目次の順）を置きました。
- アーカイブの説明は、表紙にだけ出します。
本文: UTF-8 にし、CHM 用の ActiveX を除きました。ほかは元のままです。
目次に無い頁: 352 頁は目次の頁の写しなので、目次の頁と同じ位置として扱い、検索には目次の頁だけを出します。
front matter が無いので、Jekyll はそのまま配信します。SRC# のヘルプの見た目・検索・srcsharp help とは独立しています。生成物は linguist-generated にしました。

5. 元の SRC のヘルプのポップアップ

元の WinHelp には 2 種類のポップアップがありました。

本文の中の用語: Src.hdp の {\ul 語}{\v 飛び先} で、「ユニットＩＤ」「気力」など 20 語、256 か所です。
図の押せる場所: ステータスウインドウの図（StatusWindow.shg、29 か所）と MapEdit の図（MapEdit.shg、7 か所）です。

CHM にしたときに用語は普通のリンクになり、図の押せる場所は失われていました。説明の頁（HLP000164 など 42 頁）は、どこからも辿れなくなっていました。

	アーカイブ	SRC# のヘルプ
用語	押すと、頁を移らずに小さな窓（WinHelp のポップアップ風）で説明を出します。リンクは点線の下線です	頁へのリンクのまま、説明の最初の一文を `title` で付けました（124 頁・298 か所）
図の押せる場所	SHG から読んだ座標で image map を作り、押すと小さな窓で説明を出します	図に押せる場所を付け、図の下に「項目と説明」の表を置きました（ステータスウインドウ・マップデータ・反撃）
説明の 42 頁	「ステータスウインドウ: パイロットの名称」のような題を付けました	独立した頁としての価値が無いので消し、呼び出し元の頁の表に取り込みました

SRC# のヘルプの頁を引く処理（SRCHelpSearch の HelpTopic）にあった、「題が HLP000xxx の頁は本文の太字を題にする」処理も外しました。対象の頁が無くなったためです。あわせてテストも直しています。

確かめたこと

python3 tools/help_menu.py --check が OK になりました。
SRCAuthoringTests は 69 件すべて成功しました（ヘルプのテストを含む）。
アーカイブを Chromium で確かめました（パソコン 1280×800・スマートフォン 390×844）。
- 目次のツリーに今の頁の印が付き、前後の頁へ移れること。
- キーワードと検索で頁が見つかること。
- 図の押せる場所と用語のポップアップが出て、Esc や窓の外を押すと閉じること。
- コンソールにエラーが出ないこと。
Jekyll の組み立ては、手元の Ruby の版が違うため、CI の build-help で確かめます。

関連

元の SRC のヘルプとの照らし合わせの残り: ヘルプ: 元の SRC から移したままの頁（390 頁）を SRC# の動作と照らし合わせる #1446
シナリオのフォルダの設定ファイル: シナリオのフォルダの設定ファイルを読み込む（今は未実装） #1447

🤖 Generated with Claude Code

https://claude.ai/code/session_016o9WHY8U3cQ2HiDnotdcP6

- 「SRC#Webの使い方」「SRC#Formの使い方」の頁を加える。SRC#Web の操作（シナリオ選択・アーカイブと素材の追加・セーブデータ・仮想パッド・システムメニュー・設定）は docs/gui/web.md にしか無かった - メニューを「遊ぶ」（入手・各アプリの使い方・起動）・「シナリオ・素材の用意」・「困ったとき」・「操作方法」（ゲームの中）に並べ直す。頁のファイル名は変えない（srcsharp help が引く名前のため） - menu.md は tools/help_menu.py で menu.yml から作る。CI（build-help）で、合っているか・リンク先の頁があるか・頁の title とメニューの名前が同じかを確かめる。menu.md にだけ載っていた未対応の Flash のコマンドは外し、menu.yml にだけあったオートプレイ・更新履歴(v2.3) が menu.md にも載る - 「SRC#のインストール」から各アプリの使い方へリンクし、SRC#Web の入手先に src.koudenpa.net を加える Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016o9WHY8U3cQ2HiDnotdcP6

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016o9WHY8U3cQ2HiDnotdcP6

github-actions · 2026-11-03T08:39:02Z

Azure Static Web Apps: Your stage site is ready! Visit it here: https://yellow-pebble-0ddb1c400-1445.eastasia.azurestaticapps.net

- tools/vb_help_archive.py が SRC/HelpChm から SRC.Sharp.Help/src/vb/ を作る - 767 頁を UTF-8 にし（元は Shift_JIS で、文字コードの宣言も誤っていた）、CHM 用の ActiveX を除き、上にアーカイブであることの帯（目次・検索、SRC# のヘルプへのリンク、作者）を付ける - 目次（src.hhc）と、ブラウザの中で探す検索（search.json。全角・半角と大文字・小文字の違いは無視、空白で区切った語をすべて含む頁）の頁 index.html - front matter が無いので Jekyll はそのまま配信し、SRC# のヘルプの見た目・検索・srcsharp help とは独立する - メニューの「元の SRC について」に「元のSRCのヘルプ」の頁を加え、アーカイブへの入口にする - 生成物は .gitattributes で linguist-generated にする Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016o9WHY8U3cQ2HiDnotdcP6

各頁の上の帯はうるさいので外す。説明（アーカイブであること・SRC# のヘルプへのリンク・作者）は index.html にだけ出す。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016o9WHY8U3cQ2HiDnotdcP6

github-actions · 2026-11-03T08:44:18Z

Azure Static Web Apps: Your stage site is ready! Visit it here: https://yellow-pebble-0ddb1c400-1445.eastasia.azurestaticapps.net

github-actions · 2026-11-03T08:45:45Z

Azure Static Web Apps: Your stage site is ready! Visit it here: https://yellow-pebble-0ddb1c400-1445.eastasia.azurestaticapps.net

- 各頁を Windows 95 のヘルプ（WinHelp）に似せた枠に入れる（tools/vb_help_archive/winhelp.css・winhelp.js） - 上にボタンの列（目次・表紙・戻る・<<・>>） - 左に「ヘルプトピック」の欄（目次のツリー・キーワード・検索のタブ）。広い画面では出しておき、狭い画面では「目次」のボタンで引き出す。目次は今の頁までの本を開き、印を付ける - 本文の下に前後の頁へのリンク（目次の順） - キーワードのタブは元のヘルプの索引（SRC.hhk、722 語） - 目次に無い頁のうち 352 頁は、目次の頁と題も本文も同じ写し。目次の頁と同じ位置として扱い（前後の頁・目次の印）、検索の結果には目次の頁だけを出す - アーカイブの説明は表紙（index.html）にだけ出す Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016o9WHY8U3cQ2HiDnotdcP6

github-actions · 2026-11-03T08:59:36Z

Azure Static Web Apps: Your stage site is ready! Visit it here: https://yellow-pebble-0ddb1c400-1445.eastasia.azurestaticapps.net

7474 · 2026-11-03T08:56:53Z

 ## SRC#Web（ブラウザ）

-1. https://7474.github.io/SRC/web/ を開きます。
+1. https://src.koudenpa.net/ か https://7474.github.io/SRC/web/ を開きます。


Suggested change

1. https://src.koudenpa.net/ か https://7474.github.io/SRC/web/ を開きます。

1. https://src.koudenpa.net/ を開きます。

GitHub Pagesは開発作業に使っているものなのでヘルプとしては提示しない。

7474 · 2026-11-03T08:58:54Z

+
+### 仮想パッド
+
+キーボードの無い端末向けに、画面の下にゲームパッドの形のボタンを出せます。タッチの端末でははじめから出ます。


主目的はマウスなどのポインティングデバイスが無いタッチデバイス（要はスマートフォン）向け。

7474 · 2026-11-03T09:10:12Z

+</head>
+<body data-root="">
+<div class="wh-window">
+<header class="wh-titlebar"><span class="wh-titleicon" aria-hidden="true"></span><span>SRC ヘルプ（元の SRC のヘルプのアーカイブ）</span></header>


Suggested change

<header class="wh-titlebar"><span class="wh-titleicon" aria-hidden="true"></span><span>SRC ヘルプ（元の SRC のヘルプのアーカイブ）</span></header>

<header class="wh-titlebar"><span class="wh-titleicon" aria-hidden="true"></span><span>SRC ヘルプ</span></header>

タイトルにイチイチ括弧書きがあるのは鬱陶しいので取ってください。

7474 · 2026-11-03T09:10:32Z

+</aside>
+<main class="wh-topic">
+<div class="wh-content">
+<h1>元の SRC のヘルプ（アーカイブ）</h1>


Suggested change

<h1>元の SRC のヘルプ（アーカイブ）</h1>

<h1>SRC（Simulation RPG Construction）のヘルプ（アーカイブ）</h1>

7474 · 2026-11-03T09:11:34Z

+<main class="wh-topic">
+<div class="wh-content">
+<h1>元の SRC のヘルプ（アーカイブ）</h1>
+<p>元の SRC（VB 版、Ver2.2.33）に付いていたヘルプを、ブラウザで読めるようにしたものです。データ・イベントの書き方を元の SRC と比べるときなどに使ってください。</p>


Suggested change

<p>元の SRC（VB 版、Ver2.2.33）に付いていたヘルプを、ブラウザで読めるようにしたものです。データ・イベントの書き方を元の SRC と比べるときなどに使ってください。</p>

<p>SRC（Ver2.2.33）のヘルプを、ブラウザで読めるようにしたものです。</p>

シンプルに書く。

元の SRC のヘルプ（WinHelp）には 2 種類のポップアップがあり、CHM にしたときに失われていた。 - 本文の中の用語（Src.hdp の {\ul 語}{\v 飛び先}。ユニットＩＤ・気力など 20 語、256 か所） - 図の押せる場所（SRC/Help の StatusWindow.shg・MapEdit.shg。36 か所）。説明の頁（HLP000164 など）はどこからも辿れなくなっていたアーカイブ（/vb/） - 用語のリンクと図の押せる場所（SHG から読んだ座標で image map を作る）を押すと、頁を移らずに小さな窓（WinHelp のポップアップ風）で説明を出す。窓から説明の頁も開ける。用語のリンクは点線の下線にする - 図の説明の頁に「ステータスウインドウ: パイロットの名称」のような題を付ける SRC# のヘルプ - 図の説明の 42 頁（HLP000164〜HLP000285）は独立した頁としての価値が無いので消し、呼び出し元の頁（ステータスウインドウ・マップデータ・反撃）に、図の押せる場所と「項目と説明」の表として取り込む - 用語の 20 語へのリンク（124 頁・298 か所）に、説明の最初の一文を title で付ける（指すと出る） - HLP000xxx の頁の見出しを本文の太字にする処理（SRCHelpSearch の HelpTopic）を外し、テストを直す Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016o9WHY8U3cQ2HiDnotdcP6

github-actions · 2026-11-03T09:14:05Z

Azure Static Web Apps: Your stage site is ready! Visit it here: https://yellow-pebble-0ddb1c400-1445.eastasia.azurestaticapps.net

- SRC#Web の入手先は src.koudenpa.net だけにする（GitHub Pages は開発用のため出さない） - 仮想パッドの説明を、ポインティングデバイスの無いタッチの端末（スマートフォン）向けであることが分かるようにする - アーカイブ（/vb/）のタイトルバーを「SRC ヘルプ」だけにし、表紙の見出しと説明を簡潔にする Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016o9WHY8U3cQ2HiDnotdcP6

github-actions · 2026-11-03T09:15:53Z

Azure Static Web Apps: Your stage site is ready! Visit it here: https://yellow-pebble-0ddb1c400-1445.eastasia.azurestaticapps.net

github-actions · 2026-11-03T09:19:20Z

Azure Static Web Apps: Your stage site is ready! Visit it here: https://icy-coast-005428600-1445.eastasia.azurestaticapps.net

claude added 2 commits November 3, 2026 08:36

docs: SRC#Web の文書から、遊ぶ人向けのヘルプの頁へリンクする

0fbf25c

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016o9WHY8U3cQ2HiDnotdcP6

7474 deployed to SRC#Help dev November 3, 2026 08:37 — with GitHub Actions

View deployment

7474 had a problem deploying to SRC#Help dev November 3, 2026 08:42 — with GitHub Actions Error

7474 changed the title ~~ヘルプ: アプリごとの使い方の頁を揃え、メニューを並べ直し、menu.md を menu.yml から作る~~ ヘルプ: アプリごとの使い方の頁・メニューの整理・元の SRC のヘルプのアーカイブ Nov 3, 2026

7474 deployed to SRC#Help dev November 3, 2026 08:44 — with GitHub Actions

View deployment

7474 deployed to SRC#Help dev November 3, 2026 08:58 — with GitHub Actions

View deployment

7474 commented Nov 3, 2026

View reviewed changes

7474 had a problem deploying to SRC#DataViewer dev November 3, 2026 09:12 — with GitHub Actions Error

7474 deployed to SRC#Help dev November 3, 2026 09:12 — with GitHub Actions

View deployment

7474 deployed to SRC#Help dev November 3, 2026 09:14 — with GitHub Actions

View deployment

7474 deployed to SRC#DataViewer dev November 3, 2026 09:15 — with GitHub Actions

View deployment

7474 marked this pull request as ready for review November 3, 2026 09:30

7474 merged commit f9b347c into master Nov 3, 2026
19 checks passed

7474 deleted the claude/laughing-archimedes-grogzk branch November 3, 2026 09:30

7474 deployed to SRC#DataViewer dev November 3, 2026 09:30 — with GitHub Actions Active

7474 deployed to SRC#Help dev November 3, 2026 09:30 — with GitHub Actions Active

	1. https://src.koudenpa.net/ か https://7474.github.io/SRC/web/ を開きます。
	1. https://src.koudenpa.net/ を開きます。


		### 仮想パッド

		キーボードの無い端末向けに、画面の下にゲームパッドの形のボタンを出せます。タッチの端末でははじめから出ます。

	<header class="wh-titlebar"><span class="wh-titleicon" aria-hidden="true"></span><span>SRC ヘルプ（元の SRC のヘルプのアーカイブ）</span></header>
	<header class="wh-titlebar"><span class="wh-titleicon" aria-hidden="true"></span><span>SRC ヘルプ</span></header>

	<h1>元の SRC のヘルプ（アーカイブ）</h1>
	<h1>SRC（Simulation RPG Construction）のヘルプ（アーカイブ）</h1>

	<p>元の SRC（VB 版、Ver2.2.33）に付いていたヘルプを、ブラウザで読めるようにしたものです。データ・イベントの書き方を元の SRC と比べるときなどに使ってください。</p>
	<p>SRC（Ver2.2.33）のヘルプを、ブラウザで読めるようにしたものです。</p>

Conversation

7474 commented Nov 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

概要

変更

1. アプリごとの使い方の頁を揃える

2. メニューを並べ直す

3. メニューを 1 か所で管理する

4. 元の SRC のヘルプのアーカイブ（https://srch.7474.jp/vb/ ）

5. 元の SRC のヘルプのポップアップ

確かめたこと

関連

Uh oh!

github-actions Bot commented Nov 3, 2026

Uh oh!

github-actions Bot commented Nov 3, 2026

Uh oh!

github-actions Bot commented Nov 3, 2026

Uh oh!

github-actions Bot commented Nov 3, 2026

Uh oh!

7474 Nov 3, 2026

Choose a reason for hiding this comment

Uh oh!

7474 Nov 3, 2026

Choose a reason for hiding this comment

Uh oh!

7474 Nov 3, 2026

Choose a reason for hiding this comment

Uh oh!

7474 Nov 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

7474 Nov 3, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot commented Nov 3, 2026

Uh oh!

github-actions Bot commented Nov 3, 2026

Uh oh!

github-actions Bot commented Nov 3, 2026

Uh oh!

Uh oh!

This branch was successfully deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

7474 commented Nov 3, 2026 •

edited

Loading

7474 Nov 3, 2026 •

edited

Loading