概要

GitHub Actions を使って「タグを push したら TeX のコンパイルと PDF 化を実行＆リリース」し，タグ名を含めることでリリース名をわかりやすくする．拙著の続きのような内容である．

詳細

下記の通りファイルを用意する．同じものがこのリポジトリにある．

ファイルツリーは前回の拙著と変わらない．

.
│  main.tex
│
└─.github
    ├─actions
    │  └─latex
    │          Dockerfile
    │          entrypoint.sh
    │
    └─workflows
            main.yml

Dockerfile も特に変更点はない．

Dockerfile

FROM ubuntu:latest

RUN apt-get update \
  && apt-get install -y --no-install-recommends \
    curl \
    python3 \
    latexmk \
    lmodern \
    texlive \
    texlive-latex-extra \
    texlive-lang-japanese \
  && rm -rf /var/lib/apt/lists/*

RUN mktexlsr && mkdir -p /app
WORKDIR /app

ADD entrypoint.sh /entrypoint.sh
RUN ["chmod", "+x", "/entrypoint.sh"]
ENTRYPOINT ["/entrypoint.sh"]

entrypoint.sh は \"tag_name\" と \"name\" に渡す値が変わっている．タグを push した場合，GITHUB_REF には refs/tags/v1.0.0 のような値が入るので，そこからタグ名を取り出している．これについては下記を参照した．

continuous integration - Get the current pushed tag in Github Actions - Stack Overflow

entrypoint.sh

#!/bin/bash
set -eux

# build pdf (change if necessary)
ptex2pdf -l -ot -kanji=utf8 main.tex

# create release
res=`curl -H "Authorization: token $GITHUB_TOKEN" -X POST https://api.github.com/repos/$GITHUB_REPOSITORY/releases \
-d "
{
  \"tag_name\": \"$(echo ${GITHUB_REF:10})\",
  \"target_commitish\": \"$GITHUB_SHA\",
  \"name\": \"main.pdf $(echo ${GITHUB_REF:10})\",
  \"draft\": false,
  \"prerelease\": false
}"`

# extract release id
rel_id=`echo ${res} | python3 -c 'import json,sys;print(json.load(sys.stdin)["id"])'`

# upload built pdf
curl -H "Authorization: token $GITHUB_TOKEN" -X POST https://uploads.github.com/repos/$GITHUB_REPOSITORY/releases/${rel_id}/assets?name=main.pdf\
  --header 'Content-Type: application/pdf'\
  --upload-file main.pdf

main.yml では，新たにトリガーの条件として tags: v*.*.* を付け加えている．

main.yml

name: LaTeX to PDF

on:
  push:
    paths: main.tex
    tags: v*.*.*

jobs:
  build:
    name: Build
    runs-on: ubuntu-latest
    steps:
      - name: Set up Git repository
        uses: actions/checkout@v1
      - name: Build docker image
        uses: denkiuo604/tex-to-pdf-with-tags/.github/actions/latex@master
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

これで v*.*.* 形式のタグを push すれば PDF が自動生成され，main.pdf v*.*.* という名前でリリースされる．

GitHub Actions で TeX をコンパイル・PDF 化してタグ付きリリースする話

概要

詳細

参考