LaTeX週次レポート作成環境

このリポジトリは、DockerとLaTeXを利用した週次レポート作成のための環境です。being24/latex-dockerイメージを使用して、一貫した環境でレポート作成ができます。

必要なもの

• Docker
• Git（オプション）
• VSCode（推奨、拡張機能「Remote - Containers」「LaTeX Workshop」）

フォルダ構成

project-root/
├── .devcontainer/     # Docker環境設定
│   ├── devcontainer.json
│   └── Dockerfile
├── .latexmkrc         # LaTeXビルド設定
├── .vscode/           # VSCode設定
├── classes/           # カスタムクラスファイル（必要に応じて）
│   └── report.cls
├── week1/             # 第1週レポート
│   ├── report.tex
│   ├── images/        # 画像ファイル
│   └── scripts/       # Pythonファイル
├── week2/             # 第2週レポート
│   ├── report.tex
│   ├── images/
│   └── scripts/
├── compile.sh         # コンパイル用スクリプト
└── README.md          # このファイル

基本的な使い方

コマンドラインでのコンパイル

レポートをコンパイルするには次のコマンドを使用します：

docker run -u $(id -u):$(id -g) --rm -v $PWD:/workdir ghcr.io/being24/latex-docker latexmk -pdf report.tex

compile.shスクリプトの使用

より簡単に利用するために、プロジェクトにはcompile.shスクリプトが含まれています：

# スクリプトに実行権限を付与（初回のみ）
chmod +x compile.sh

# デフォルトでreport.texをコンパイル
./compile.sh

# 特定のファイルをコンパイル
./compile.sh week1/report.tex

週次レポートの作成

新しい週のレポートを作成

# 新しい週フォルダを作成
mkdir -p weekX/images weekX/scripts

# テンプレートをコピー
cp week1/report.tex weekX/

report.texの構成例

\documentclass{report}  % または jsreport（日本語）

\title{第X週レポート}
\author{氏名}
\date{\today}

\begin{document}
\maketitle

\section{目的}
本実験の目的は...

\section{実験方法}
...

\section{結果と考察}
% 画像の挿入
\begin{figure}[htbp]
  \centering
  \includegraphics[width=0.8\linewidth]{images/result1}
  \caption{実験結果1}
  \label{fig:result1}
\end{figure}

% Pythonコードの挿入
\begin{verbatim}
import numpy as np
import matplotlib.pyplot as plt

# データ処理コード
...
\end{verbatim}

\end{document}

VSCodeとの連携

1. VSCodeでプロジェクトフォルダを開く
2. Remote - Containersの機能を使ってコンテナ内で開く
3. LaTeX Workshopの機能を使って編集・プレビュー

トラブルシューティング

PDFが生成されない場合

• .latexmkrcの設定を確認
• 手動でDVIからPDFへの変換を試す：

  dvipdfmx report.dvi

• latexmkに-pdfオプションを明示的に指定

日本語が表示されない場合

• 日本語用のドキュメントクラス（jsarticle, jsreport）を使用しているか確認
• TeXLiveに日本語パッケージがインストールされているか確認

スクリプトの例

以下は compile.sh スクリプトの例です：

#!/bin/bash

# 引数の処理（デフォルトはreport.tex）
TEXFILE=${1:-report.tex}

# LaTeXコンパイルの実行
docker run -u $(id -u):$(id -g) --rm -v $PWD:/workdir ghcr.io/being24/latex-docker latexmk -pdf "$TEXFILE"

参考

• being24/latex-docker
• being24/latex-template-ja