TeXで書いて、ブラウザで講義する

TeXを保存しただけでは、完成済みのHTMLは変わりません。生成が成功したことを確認してから、ブラウザで開き直すか再読み込みします。

1. 初回準備

1編集キットを展開する

ZIPを右クリックして「すべて展開」し、展開先を開きます。scveamer.py、engine/、bundled/、このマニュアルなどの位置関係を保ってください。ZIPを開いて中を眺めたまま実行するのでなく、展開したフォルダで使います。

以前のキットを使っている場合は、新しいZIPを旧キットとは別のフォルダへ展開してください。前の原稿を続けて編集する方法は、下の「更新・移行」にあります。

2PythonとTeXを確認する

Python・TeX本体は、このソース版キットには含まれていません。必要な場合は Python公式サイトと TeX Live公式案内から導入します。Pythonの通常インストールで選択項目がある場合は、pipとTcl/Tk・IDLEを含めます。PythonのWindows向け説明

Tkinterの確認だけをしたい場合は、ターミナルで py -m tkinter を実行します。小さな確認画面が開けば使えます。公式説明

3編集画面を起動する

Windowsでは、展開したフォルダの START_WINDOWS.cmd をダブルクリックできます。初回のライブラリ準備だけを行う SETUP_WINDOWS.cmd も用意しました。以下のPythonコマンドからも同じ機能を使えます。

scveamer.py が見えているフォルダで、エクスプローラー上部のアドレス欄に powershell と入力して Enter を押します。開いたターミナルで、次の1行を入力してください。

py scveamer.py

py が使えず python が使える環境なら、先頭を python に替えます。Pythonファイルの関連付けが設定されていれば、scveamer.py のダブルクリックでも起動できます。うまく起動しないときは、ターミナルから実行するとエラーを読めます。

4自動で開いた原稿を確認する

初回は、内蔵の「集中講義１日目」が選ばれています。作業用コピーを初回だけ作り、その場所を画面の「作業先」欄に表示します。続けて「環境を確認」を押します。

画面の内蔵資料の選択欄から、「集中講義１日目」「テンプレートv2」「新規講演スターター」を切り替えられます。各原稿はそれぞれの作業先に保存され、再び選ぶとその続きを開きます。

実際の場所を開くには「フォルダを開く」を押します。TeX原稿と生成したHTML・PDFはこの作業先に置かれます。bundled/ やキット内の元見本を直接編集する必要はありません。

5pypdf・pypdfium2・Pillowを準備する

pypdf・pypdfium2・Pillowが未導入の場合は、「初回準備（ライブラリの導入）」を押します。キットの中に .venv という専用のPython環境を作り、pypdf 6.10.0・pypdfium2 5.14.0・Pillow 12.3.0を取得します。この操作にはネット接続が必要です。Python本体・TeX本体のインストールはしません。

準備が終わると、その環境で編集画面が起動し直します。次回も同じ py scveamer.py で起動できます。用意した .venv は自動で選ばれます。

このキットは専用環境のPythonを直接呼び出すため、Activate.ps1 を実行する手順はありません。仮想環境は移動先で作り直す仕組みなので、キットを別のPCへ移すときは .venv を配布せず、そのPCで初回準備を行います。Pythonのvenv説明

6TeXが見つからない場合だけ、場所を指定する

LuaLaTeXを自動で見つけられない場合は、「TeX実行ファイルのフォルダ」に、lualatex.exe のあるフォルダを指定します。TeX Liveなら、たとえば次のような場所です。年やドライブは、ご自身のインストール先に合わせてください。

C:\texlive\2026\bin\windows

lualatex.exe 自体や原稿フォルダではなく、それを含むフォルダを指定します。指定後にもう一度「環境を確認」を押してください。

7一度生成してみる

「TeXからHTMLを作成」を押します。ログに成功が出たら、「HTMLを開く」を押してください。TeXや必要なパッケージがそろっていれば、以後の通常の生成と, 通常のスライド・組込みゲーム・ローカル動画の閲覧はオフラインでできます. ウェブページの表示にはネット接続が必要です.

Font names database not found, generating new one.
This can take several minutes; please be patient.

2. 最初の編集を試す

初回に自動で開いた「集中講義１日目」で試せます。編集するのは workspace/day1/ の作業用コピーなので、内蔵の元見本はそのまま残ります。画面の「作業先」で編集先を確認してください。

1. 「原稿を編集」から talk.tex を開きます。お使いのTeXエディターで直接開いても構いません。
2. 副題の行を見つけ、たとえば次のようにします。

   \subtitle{多変数の複素解析（編集の練習）}

3. Ctrl + S で保存します。
4. 編集キットへ戻り、「TeXからHTMLを作成」を押します。
5. 成功したら「HTMLを開く」を押し、表紙の副題を確認します。開いていたタブを見る場合は再読み込みします。

これが普段の編集手順です。短い原稿から始めたい場合は、内蔵資料の選択欄を「新規講演スターター」に切り替えます。青テーマの6枚の原稿で、普通のBeamerページ、定理環境、\pause、固定例の挿入を試せます。この選択は、すでに編集しているスターターがあればその続きを開きます。

別の講演として、まっさらなスターターをもう一つ作りたい場合は、「新しい原稿を作る」を使います。空の新しいフォルダへ作り、名前と保存先はご自身で選びます。

スターターには、最初の見本として生成済みのHTML・PDFと、配色見本 THEMES.html、固定例一覧 EXAMPLES.html も入っています。まず見本を開いて確認でき、原稿を編集した後は同じ手順で再生成します。

更新・移行：以前の原稿を続けて編集する

version 1.5は、新しいZIPを旧キットとは別のフォルダに展開して使います。これまで編集した原稿は、その場所に保管したまま続けて使えます。

1. 新しいZIPを、旧キットとは別のフォルダへ「すべて展開」します。
2. START_WINDOWS.cmd、または新しいフォルダで py scveamer.py を実行します。
3. version 1.5の初回は、改訂済みの「集中講義１日目」を作業コピーへ複製して開きます。旧版で編集中の原稿を続ける場合は「自分の原稿フォルダを開く」で、以前の talk.tex が直接入っているフォルダを選びます。画面の「作業先」で実際の編集先を確認してください。
4. 「環境を確認」を押し、必要なら「初回準備（ライブラリの導入）」を実行します。専用環境 .venv はキットのフォルダごとに用意します。
5. 「TeXからHTMLを作成」を押し、成功後に「HTMLを開く」で確認します。従来のプレイヤー操作・曲面表示を保ち、PDFページをPNG方式で再生成します。

version 1.2より前の原稿に終了予定時刻を追加する場合は、原稿をフォルダごと複製してから、新キットの starter/theme/holotalk-games.sty を、その複製の theme/holotalk-games.sty へコピーします。そのうえで、次節の時刻・分数コマンドをTeXに加えます。原稿のテーマを独自に変更している場合は、元のファイルも保管してください。新しい内蔵資料には、対応するテーマが入っています。

PDF処理は1.4で採用した方式を引き継ぎます. 生成HTMLの製品バージョンは1.5です. 動画とウェブページを使う資料は1.5のプレイヤーで生成します. 新しい命令とテーマを旧原稿へ加える方法

旧名の holotalk_editor.py は互換用の入口です。通常は scveamer.py またはWindows用の起動ファイルを使ってください。

3. TeXのどこを編集するか

動画・ウェブページ・セクションの扉については, 1.5の追加機能を参照してください.

配色を選ぶ

talk.tex のプリアンブルで、次の1行を使います。blue・red・yellow から一つを指定します。

\holocolors{blue}

青は最初のHolomorphonautica配色、赤はホームページに合わせた赤紫、黄はもとのBeamerに寄せた黄橙の配色です。資料内の THEMES.html に見本があります。変更後は再生成してください。

普通のページと段階表示

数学のページは普段のBeamerと同じです。\pause の後は、HTMLでも次送りで表示されます。

\begin{frame}{ここで観察したいこと}
  \begin{itemize}
    \item まず、対象を式で定める。
    \pause
    \item 切り口を動かし、見え方を比べる。
    \pause
    \item 観察を判定条件と結び付ける。
  \end{itemize}
\end{frame}

定義・定理・証明

definition、theorem、lemma、proposition、corollary、example、remark、question、proof を使えます。

\begin{frame}{簡単な例}
  \begin{example}
    $u(z)=|z|^2$ は $\mathbb C$ 上の劣調和関数である。
  \end{example}
  \pause
  \begin{proof}
    $z=x+iy$ と書くと、$u(x+iy)=x^2+y^2$ だから
    $\Delta u=4>0$ である。
  \end{proof}
\end{frame}

固定例の対話UIを挿入する

基本は、TeX原稿に次の1行を入れるだけです。

\exploreframe{sh}{std-b03}{鞍型のグラフを観察する}

お渡しした講義原稿・テンプレート・スターターでは、この命令はすでに読み込まれています。この例では Subharmonic? のUIで、登録済みの関数 u(z)=Re(z²)=x²−y² を表示します。ランダムに出題せず、この関数を動かして観察し、「問題」と「解答・解説」を切り替えられます。

普通のスライドの間に置く

\begin{document} と \end{document} の間で、表示したい位置へ入れます。たとえば「式で導入 → 図を操作 → 式で確認」の3枚は、次のように書けます。

\begin{frame}{まず、関数を式で見る}
  $z=x+iy$ として
  \[
    u(z)=\operatorname{Re}(z^2)=x^2-y^2
  \]
  を考える。このグラフはどのような形だろうか。
\end{frame}

\exploreframe{sh}{std-b03}{鞍型のグラフを観察する}

\begin{frame}{観察したことを式で確認する}
  \[
    \Delta u=u_{xx}+u_{yy}=2-2=0.
  \]
  したがって、この関数は調和である。
\end{frame}

三つの引数の意味

\exploreframe{UIの種類}{例のID}{ページの見出し}

IDは大文字・小文字を区別します。たとえば N01 は n01 とは異なります。本マニュアル末尾の全例一覧、または資料フォルダの EXAMPLES.html から、UIの種類とIDを組にして選んでください。

そのまま使える8例

下は、１日目の講義で使った8例です。表示したいものの1行をコピーし、3番目の見出しだけ変えても使えます。

劣調和関数：sh

% Re(z²)=x²−y²：調和関数の鞍型
\exploreframe{sh}{std-b03}{鞍型のグラフを観察する}

% −|z|²：劣調和でない山型
\exploreframe{sh}{std-b02}{山型のグラフと円周平均}

% max(0,Re z)：折れ目のある劣調和関数
\exploreframe{sh}{std-i02}{折れ目があっても劣調和}

多重劣調和関数：psh

% |z|²+|w|²：狭義多重劣調和の基本例
\exploreframe{psh}{N01}{複素直線への制限を観察する}

% |z|²+|w|²−4Re(z w̄)：座標方向だけでは見落とす非例
\exploreframe{psh}{A03}{座標方向だけでは分からないこと}

領域の緑陰図：ryokuinzu

% C²の単位開球
\exploreframe{ryokuinzu}{lecture-ball}{開球の切り口を見る}

% C²の単位双円板
\exploreframe{ryokuinzu}{lecture-polydisc}{双円板の切り口を見る}

% Hartogs図形
\exploreframe{ryokuinzu}{n18}{Hartogs図形の切断を観察する}

lecture-ball と lecture-polydisc は１日目の講義用に追加した例です。現在の編集キットにはこれらのデータも含まれます。

問題中は式を隠したい場合

通常は、関数・領域の定義式を最初から示し、判定と理由を「解答・解説」で表示します。式も観察後に見せたい場合は、[formula=hide] を付けます。

\exploreframe[formula=hide]{sh}{std-b02}{この関数は劣調和だろうか}

英語のUIを使う場合は [lang=en]、両方を指定する場合は [formula=hide,lang=en] と書けます。

１日目の原稿：PDF用の静止図も指定する

１日目の talk.tex には、PDF用の図と説明を指定しやすくする \observeframe を定義してあります。

\observeframe{ryokuinzu}{lecture-ball}
  {開球：切り口の円板が縮む}{fibers-ball}

最初の三つは \exploreframe と同じです。4番目の fibers-ball は、PDF用本文 assets/print/fibers-ball.tex の名前です。例のIDをもう一度書く欄ではありません。この命令は、１日目の設定では次の書き方に相当します。

\exploreframe[formula=show,lang=ja,
  print={\input{assets/print/fibers-ball.tex}}
]{ryokuinzu}{lecture-ball}{開球：切り口の円板が縮む}

\observeframe は１日目の原稿で定義した専用の短縮命令です。また、旧テンプレートv2のスタイルには print={...} オプションがありません。旧v2へそのまま持ち込む場合は、まず共通の基本形 \exploreframe{UI}{ID}{見出し} を使ってください。

書いたあとは、保存してHTMLへ変換する

1. TeX原稿を保存します。
2. 画面の「作業先」が編集中の原稿の場所であることを確認し、「TeXからHTMLを作成」を押します。
3. 成功表示を確認してから、完成した index.html を開くか、ブラウザを再読み込みします。

lecture-plan.json を使っている場合は、対話UIのページも1枚のスライドとして数えます。ページを追加・削除・並べ替えしたら、メモや時間配分の slide 番号を合わせてください。同じ位置で例だけ替える場合も、説明メモは新しい例へ合わせます。調整中は補足データの使用を外して生成できます。TeXに直接書いた開始時刻・分数は、その設定とは独立して反映されます。詳しくは次の節をご覧ください。

4. 終了予定時刻と講師メモ

開始時刻と、1枚にかける時間をTeXに書く

version 1.5では、画面右下のメモ付近に現在のスライドを終える予定の時刻を常時表示できます。ボタンを押す必要はありません。まず talk.tex のプリアンブルで、テーマを読み込んだ後に開始時刻を1行書きます。

\scvstarttime{14:55}

普通のスライドでは、frame の中の最初に予定分数を書きます。

\begin{frame}{劣調和関数の定義}
  \scvminutes{3}
  定義をここに書く。
  \pause
  例をここに書く。
\end{frame}

固定例の操作ページでは、minutes オプションを使います。

\exploreframe[minutes=3,formula=show,lang=ja]
  {sh}{std-b02}{山型のグラフと円周平均}

このコマンド自体が1枚を作るので、frame 環境で囲みません。既に print={...} を指定している場合は、同じオプション欄へ minutes=3 を加えます。

開始時刻は24時間制の HH:MM、分数は0以上の数値です。これは計画上の終了時刻で、実際に話し始めた時刻を自動で記録したり、カウントダウンしたりする機能ではありません。開始が遅れたときは、プリアンブルの開始時刻を変更して再生成します。

講師メモを使う資料では

メモ機能は引き続き使えます。lecture-plan.json に各スライドの補足データを記述し、編集画面で「補足データを使用（見出し・問い・講師メモ）」を選びます。代表的な項目は次のとおりです。

補足データにスライド番号を書いた場合は、スライドを増減・並べ替えしたときに対応も直します。TeXの \scvminutes は本文と一緒に移動するため、その分数の番号を別ファイルで直す必要はありません。

資料ごとにメモを無効にするには、presentation.json に "speaker_notes": false を設定します。このときHTMLにはメモ本文を入れず、講師ガイドも作りません。開始時刻の表示は独立して使えます。メモを使う資料ではこの設定を省略するか true にします。

メモを有効にして計画を適用した資料では CURRENT_TEACHING_GUIDE.html を生成します。以前の TEACHING_GUIDE.html は自動更新しません。メモを無効にした後に古いガイドが残っていても、その内容を最新の原稿用とは扱わないでください。

下部の文字列を資料ごとに外す

PDFの各ページにある講義名などの文字列は、プリアンブルで \renewcommand{\holofooter}{} とすると空になります。ページ番号は残してください。HTML下部にはシステム名・スライドタイトル欄を常設しません. presentation.json の show_brand は旧設定を読み込むために残していますが, 1.5の表示には影響しません.

5. 編集画面のボタン

標準の生成物は、index.html（投影・操作用）と talk.pdf（Beamerの全表示段階）です。１日目の資料・新しいスターターなど、配布PDFの設定がある原稿では handout.pdf（各スライドの最終表示）も作ります。旧テンプレートv2の既定設定では、PDFは talk.pdf のみです。講師メモを有効にして補足データを使う場合は CURRENT_TEACHING_GUIDE.html も生成します。今回の１日目では生成しません。ファイル名の設定を変更した原稿では、その設定が使われます。

生成に失敗したときは、以前の完成ファイルを保つ仕組みです。画面に古い内容が見える場合は、まず最新の生成が成功しているかをログで確認します。

6. 普段の方法で作ったPDFから変換する

TeXのコンパイルを、いつものTeXエディターで行いたい場合に使う方法です。

1. 画面の「作業先」にある talk.tex を普段の方法でコンパイルし、同じ場所の talk.pdf を更新します。
2. 編集キットの「作業先」が、その原稿の場所であることを確認します。外部原稿の場合だけ「自分の原稿フォルダを開く」で選びます。
3. 「既存PDFからHTMLを作成」を押します。
4. 成功したら完成HTMLと、配布PDFを生成する設定の場合はそのPDFも確認します。

この操作はTeXをコンパイルしません。PDF自体が古ければ、HTMLも古い内容になります。また、対話UIに切り替わるページは、\exploreframe などがPDFへ埋め込んだ識別情報から判定します。普通のPDFを入れただけで、図が自動的に対話UIへ変わるわけではありません。

別の講演のPDFへ差し替える場合は、古い講師メモが別のページへ付かないよう、lecture-plan.json を新しい原稿へ合わせるか、講師計画を使う設定を外してください。

7. 任意：Windowsの実行ファイルにする

このキットはソース配布です。以下は実行ファイル化のための手順案であり、exeの作成・実行を確認済みという意味ではありません。実際に配布する際は、そのビルドの動作と同梱する第三者のライセンス表示を確認してください。

PythonプログラムをWindowsの .exe にする用途なら、PyInstallerが使えます。このキットにも専用の設定ファイルを用意しています。まずPython版で動作を確かめ、そのあと実行ファイル化する順番を勧めます。

PyInstallerは実行に必要なPythonとモジュールを同梱します。Windows向けはWindows上で作成します。PyInstaller公式説明

Windowsで作る手順

まずこのキットの初回準備を済ませ、Python版で生成できることを確認してください。その後、キットのフォルダでターミナルを開き、次の順に実行します。

.\.venv\Scripts\python.exe -m pip install -r requirements-build.txt
.\.venv\Scripts\python.exe -m PyInstaller --clean SCVeamer.spec

できた dist\SCVeamer\ の中にある SCVeamer.exe を起動します。この設定は、exeと補助ファイルを一つのフォルダへまとめる onedir方式です。exeだけを抜き出さず、フォルダ全体を保って使ってください。

デスクトップから使いたい場合は、exeを移動する代わりにショートカットを作れます。初回に内蔵資料の作業用コピーをexeの隣の workspace/ へ作ります。書き込めない場合はユーザーホーム内へ保存し、画面の「作業先」に実際の場所を表示します。

exe版にはPythonとpypdf・pypdfium2・Pillowを同梱するため、使用先でのPython用「初回準備」は不要です。起動すると内蔵資料が開くので、必要ならTeXの場所を指定して使います。exeを作った後でPythonソースを変更した場合は、exeももう一度作り直してください。

今回は、同梱ファイルを確認しやすいonedir方式にしています。1ファイルへまとめるonefile方式もPyInstallerにはありますが、このマニュアルの手順はonedir用です。設定・オプションの公式説明

画面を使わず、コマンドから実行する場合

同じ scveamer.py をコマンドからも使えます。下の C:\work\my-lecture は例なので、実際の資料フォルダに替えてください。空白や日本語を含むパスも、二重引用符で囲みます。

py scveamer.py --check --project "C:\work\my-lecture"
py scveamer.py --build --project "C:\work\my-lecture"
py scveamer.py --pdf-only --project "C:\work\my-lecture"

初回準備だけなら py scveamer.py --setup です。TeXの場所を指定する場合は --tex-bin "C:\texlive\2026\bin\windows"、JSONの補足データを使わない場合は --no-plan を加えます。この指定でも、TeXから読み取った開始時刻・分数は使われます。既存の日本語原稿ではLuaLaTeXを使います。

Windows用には、BUILD.cmd（TeXから変換）、PDF_TO_HTML.cmd（既存PDFから変換）もあります。ダブルクリック時は前回の有効な作業先を使用します。特定の原稿を指定する場合は、たとえば BUILD.cmd --project "C:\work\my-lecture" と実行します。

8. 困ったとき

エラーを確認する・ログを送る

TeXの処理で止まった場合は、エラー画面に出るTeXエラーの要約と、画面のログを確認します。詳しく調べるときは、「フォルダを開く」から現在の作業先を開き、.build/latest.log を、行った操作と一緒に送ってください。このログは再実行すると上書きされるので、送る分は先に別名で保存しておくと残せます。

新しいZIPのダウンロード自体が止まる場合は、検出名と対象ファイル名を確認してください。

9. 講義に持っていく・配布する

講義中は左右キー・Space・画面下のボタンでページを送れます。対話UIを操作したあと、スライド送りへ戻りたい場合は F2 を押します。全画面はプレイヤーのボタンかブラウザの F11 を使えます。

このマニュアルはSCVeamer version 1.5（2026年11月6日）の構成を説明しています. 今回の検証は1.5の検証記録を参照してください. 1.4のWindows 11での本人による利用確認は, 過去の公開用の補足記録に記載しています.