debian-open-logo-nd東京エリアDebian勉強会

発表資料更新/提出方法

本ドキュメントは、Debian Bookwormを用いて東京エリアDebian勉強会資料を更新/提出する方法となります。また、紹介されるgitのリポジトリに対してコミット権を持っていない人を対象に記載しております。すでにコミット権をお持ちの方は直接コミット出来ますし、慣れているかと思いますので、gitコマンド、publishの実行は適当にお願いします。

更新方法

0. Git と Latex の設定をします。

課題作成に必要なパッケージを導入します。

# apt-get install \
    git \
    locales \
    lv \
    make \
    poppler-data \
    python3-pygments \
    texlive-lang-japanese \
    texlive-latex-extra \
    texlive-latex-recommended \
    texlive-fonts-recommended \
    texlive-plain-generic \
    texlive-science \
    fonts-morisawa-bizud-gothic \
    ghostscript-x
# apt-get install \
    inkscape \
    evince

(お好みでPDFフォント埋め込みの設定を行います。しなくても動きます)

# kanji-config-updmap-sys ipaex

gitを設定します。

課題を作成するユーザに戻り、gitにメールアドレスや名前を設定します。

$ git config --global user.email foo@example.com
$ git config --global user.name "Tarou Debian"

1. 勉強会資料のリポジトリを持ってない人は、git clone コマンドを使ってコピーします。

(既に持っている人は2. から読んでください。)

$ git clone https://salsa.debian.org/tokyodebian-team/monthly-report.git
Cloning into 'monthly-report'...
remote: Counting objects: 20185, done.
remote: Compressing objects: 100% (8119/8119), done.
......
Checking out files: 100% (3480/3480), done.

2. ディレクトリに移動し、取得したファイルをビルドします。

$ cd monthly-report
$ cp -p git-pre-commit.sh .git/hooks/pre-commit
$ make
$ make clean

makeコマンドを実行すると過去のtexファイルをすべてpdfファイルにビルドします。すべてのpdfファイルをビルドするにはおそらく1時間以上かかるでしょう。

【備考】pdfのリポジトリのコミット権限を持っている場合は、make cleanコマンドを実行しましょう。pdfファイルをコミット済みと同じ状態に設定されます。これで古いpdfファイルをpublishしないようになります。

3. 現在チェックアウトしているローカルブランチを確認します。

$ git branch
* 201511
  master
もし、master の前にアスタリスク( * )がついていない場合、masterローカルブランチをチェックアウトします。
$ git checkout master

再度、masterローカルブランチをチェックアウトしているか確認します。

$ git branch
  201511
* master

4. リモートリポジトリからリポジトリ情報を取得します。

$ git pull

5. 発表資料を作成する年月(2015年12月の場合は201512) のローカルブランチを作成します。

$ git branch 201512

6. 作成したローカルブランチをチェックアウトします。

$ git checkout 201512
Switched to branch '201512'

7. 発表予定の資料に発表内容を記載します。

資料はdebianmeetingresume<YYYYMM>.tex(事前資料)、debianmeetingresume<YYYYMM>-presentation.tex(当日プレゼン用資料)となります。 利用するエディタはお好きなものをどうぞ。また、画像はimage<YYYYMM>/以下に置いて下さい。

$ vi debianmeetingresume201512.tex
$ git add image201512/foo.png (画像を登録などあったら)

image<YYYYMM>/以下のファイルはMakefileの依存対象となっていないため、 対応するdebianmeetingresume<YYYYMM>.texの更新日付など変更して再コンパイルしてください。

$ touch debianmeetingresume201512.tex
$ make

8. 発表資料を書いたら、変更をローカルブランチにコミットします。

$ git commit -m "Add nozzy article" -a

9. 変更をパッチで出力します。

$ git format-patch -o /tmp HEAD~
/tmp/0001-Add-nozzy-article.patch

/tmp/0001-Add-nozzy-article.patch がパッチです。

10. パッチをdebian-devel@debian.or.jpメーリングリストに投稿します。

真のgit使いは git send-email コマンドを使いますが、各々が使っている MUA を使って送るのがいいでしょう。

11 . メーリングリストに投稿できたら、masterローカルブランチをチェックアウトします。

$ git checkout master
Switched to branch 'master'