九州産業大学理工学部下川研用の汎用LaTeXテンプレートです。研究ノート、レポート、実験記録など様々な用途に活用できる軽量で使いやすいテンプレートです。
- シンプルな構造: jsarticleベースで軽量・高速
- 汎用性: 研究ノート、レポート、実験記録に最適
- 自動PDF生成: プルリクエスト時にPDFプレビューを自動作成
- 日本語完全対応: uplatex + 日本語フォントで最適化
- 即座の利用: 複雑な設定不要で即座に文書作成開始
├── main.tex # メイン文書（jsarticle形式）
└── .github/workflows/ # 自動ビルド設定
以下のソフトウェアがインストール済みであること：
- Docker Desktop - LaTeX 環境の実行に必要
- GitHub Desktop - リポジトリ管理・同期に必要
- GitHub CLI (gh) - リポジトリ作成スクリプトの実行に必要
GitHub CLI の認証を完了してください：
gh auth login注意: gh コマンドが見つからない場合は インストール方法 を参照してください。
thesis-management-toolsの自動セットアップスクリプトを使用：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/smkwlab/thesis-management-tools/v1/create-repo/setup.sh)" bash latex💡
v1は安定版（最新の v1 系）を指す移動タグです。最新の開発版を試す場合は URL のv1をmainに置き換えてください。
実行手順:
- 上記コマンドを実行（macOS のターミナルまたは Windows の WSL 内）
- 学籍番号・文書名を入力
- 自動でリポジトリ作成・セットアップ完了（リポジトリ名:
学籍番号-文書名）
INDIVIDUAL_MODE=true /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/smkwlab/thesis-management-tools/v1/create-repo/setup.sh)" bash latex実行手順:
- 上記コマンドを実行（macOS のターミナルまたは Windows の WSL 内）
- 文書名を入力
- 自動でリポジトリ作成・セットアップ完了（リポジトリ名:
文書名）
- このテンプレートから新しいリポジトリを作成
- 下記手順で文書作成を開始
`main.tex` を編集して文書を作成：
- 直接編集: mainブランチで直接編集可能
- 構造: section/subsection でシンプルに整理
- 数式・図表: 基本LaTeX機能をすぐに利用
- 自動生成: プッシュ時に自動でPDFが生成
- 確認方法: GitHub Actionsタブで状況確認
- ダウンロード: Artifactsから生成PDFを取得
```bash
uplatex main.tex dvipdfmx main.dvi
latexmk main.tex ```
main.tex を編集して文書を作成：
\section{章タイトル}
本文の内容...
\subsection{節タイトル}
詳細な説明...
\subsubsection{項タイトル} % 必要に応じて
さらに詳細な内容...数式:
% インライン数式
テキスト中の数式: $E = mc^2$
% 独立した数式
\begin{equation}
(x - a)^2 + (y - b)^2 = r^2
\label{eq:circle}
\end{equation}
% 式番号なし
\begin{equation*}
\sum_{i=1}^{n} x_i = 0
\end{equation*}箇条書きと番号付きリスト:
% 箇条書き
\begin{itemize}
\item 項目1
\item 項目2
\begin{itemize}
\item サブ項目
\end{itemize}
\end{itemize}
% 番号付きリスト
\begin{enumerate}
\item 手順1
\item 手順2
\end{enumerate}図表の挿入:
% 図の挿入
\begin{figure}[htbp]
\centering
\includegraphics[width=0.8\textwidth]{図ファイル名.pdf}
\caption{図のキャプション}
\label{fig:example}
\end{figure}
% 表の作成
\begin{table}[htbp]
\centering
\caption{表のキャプション}
\label{tab:example}
\begin{tabular}{|l|c|r|}
\hline
左寄せ & 中央 & 右寄せ \\
\hline
データ1 & データ2 & データ3 \\
\hline
\end{tabular}
\end{table}VS Code でファイル保存時に下記の latexmk が実行される 開発環境での確認用：
# latexmk使用（推奨）
latexmk main.tex
# uplatex使用（なんらかの理由で個別に実行したい場合）
uplatex main.tex
dvipdfmx main.dvi
## クリーンアップ
rm -f *.aux *.log *.dvi *.tocGitHub Actionsにより以下のタイミングで自動的にPDFが生成される。
プルリクエスト時（プレビュー）:
- ブランチを作成して変更をコミット
- プルリクエストを作成
- 自動的にPDFが生成され、ActionsのArtifactsからダウンロード可能
- レビュー・修正のサイクルが効率化
mainブランチへのプッシュ時:
- 自動的にPDFをビルドして検証
- エラーがある場合はActionsログで確認可能
タグ作成時（正式リリース）:
git tag v1.0.0
git push origin v1.0.0- 自動的にGitHubリリースが作成
- 完成版PDFがリリースに添付
- バージョン管理された文書の保管
- 研究ノート: 日々の研究記録やアイデア整理
- 実験記録: 実験手順、結果、考察の詳細記録
- 技術レポート: 調査・分析結果のまとめ
- 学習ノート: 勉強内容の体系的な整理
- 個人文書: 備忘録、プロトタイプ文書
| 項目 | 下川研学生向け | それ以外の皆さん向け（INDIVIDUAL_MODE） |
|---|---|---|
| 対象ユーザー | 学生 | 教員・研究者・一般ユーザー |
| 学籍番号 | 必須 | 不要 |
| リポジトリ名 | k21rs001-research-note |
research-note |
| 作成先 | smkwlab組織 | 個人アカウント |
| 管理体制 | 組織管理下 | 個人管理 |
| 使用例 | 学生の課題・研究 | 教員の研究文書・個人プロジェクト |
- TeXLive 2025: 最新の日本語LaTeX環境
- uplatex: Unicode対応の日本語文書処理エンジン
- jsarticle: 軽量で汎用的な日本語文書クラス
- textlint: 日本語文章の自動校正
- 自動構文チェック: LaTeX構文エラーの検出
- 依存関係更新: TeXLive環境の自動更新チェック
- PDF生成: プッシュ時の自動ビルド
- アーティファクト管理: プレビュー版と正式版の自動管理
.github/workflows/latex-build.yml の files パラメータを編集：
files: main, custom1, custom2デフォルトでは main.tex のみビルドされます。
同ファイル内の latex_options を調整：
latex_options: -pdf -halt-on-error- GitHub Actionsのログを確認
- ローカル環境での構文チェック
- 文字エンコーディング（UTF-8）の確認
.texファイル名がfilesパラメータと一致しているか確認- ファイルの構文エラーがないか確認
- GitHub Actionsの実行権限を確認
- 文字エンコーディングがUTF-8であることを確認
- 必要なパッケージ（
\usepackage{...}）の記述確認
このテンプレートは研究・教育目的での利用を想定しています。