-
Notifications
You must be signed in to change notification settings - Fork 2
/
Copy pathMakefile
174 lines (142 loc) · 6 KB
/
Makefile
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
# ----------------------------------------------------------------
# Rules for pandoc-doc-ja (pandoc and sphinx-intl)
# ----------------------------------------------------------------
SHELL := /bin/bash
################################################
# 変数
################################################
# jgm/pandocのbranch or tag（チェックアウトしたいバージョン番号を指定する）
# 環境変数として与えること (Dockerfileで定義、またはコマンドで直接与える)
PANDOC_VER := ""
# jgm/pandoc のローカルGitリポジトリ（submoduleで管理）
PANDOC_DIR := ./jgm/pandoc
# Pandocバージョンを格納するファイル
PANDOC_VER_LOCK_FILE := ./jgm/ja-pandoc-version-lock
# ターゲットの原文 (.txt/Pandoc's Markdown)
SRC_MD_DIR := src-md
SRC_MD := $(PANDOC_DIR)/MANUAL.txt # ユーザーズガイド原文 (jgm/pandocのMANUAL.txt)
SRC_MD += $(PANDOC_DIR)/doc/epub.md # EPUB
SRC_MD += $(PANDOC_DIR)/doc/filters.md # JSONフィルタの解説
SRC_MD += $(PANDOC_DIR)/doc/getting-started.md # 初心者向けチュートリアル
SRC_MD += $(PANDOC_DIR)/doc/lua-filters.md # Luaフィルタの解説
SRC_MD += $(PANDOC_DIR)/doc/using-the-pandoc-api.md # Pandoc API (Haskell)
# ターゲットの原文：ワイルドカード版（MANUAL.txt -> users-guide.md の変換が終わった前提）
SRC_MD_ALL := src-md/*.md
################################################
# ターゲット：まとめて実行
################################################
# make ja-update-src
# アップデート作業をまとめてする
# (users-guide-rst -> intl-update -> tx-push-pot)
# 要環境変数
.PHONY: ja-update-src
ja-update-src: users-guide-rst intl-update tx-push-pot
# make ja-build
# Transifex: 翻訳ファイル(po)をpullし、そのままビルドする
# 要環境変数
.PHONY: ja-build
ja-build: tx-pull ja-html
# make ja-build-local
# ローカル環境のみ：アップデート・ビルド作業をまとめてする
# (users-guide-rst -> intl-update -> ja-html)
.PHONY: ja-build-local
ja-build-local: users-guide-rst intl-update ja-html
################################################
# ターゲット：Pandocバージョン関連
################################################
# make jgm-pandoc-version
# 元リポジトリPandocバージョンを表示する (pandoc/pandoc.cabalのversionを参照)
.PHONY: jgm-pandoc-version
jgm-pandoc-version:
bash ./scripts/pandoc-version.sh
# make ja-pandoc-version
# 翻訳対象Pandocバージョンを表示する (./ja-pandoc-version-lock ファイルを参照)
.PHONY: ja-pandoc-version
ja-pandoc-version:
cat $(PANDOC_VER_LOCK_FILE)
# make ja-pandoc-version-lock
# 翻訳対象Pandocバージョンをjgm/pandocのものに固定する (ファイルに書き出すだけ)
.PHONY: ja-pandoc-version-lock
ja-pandoc-version-lock:
bash ./scripts/pandoc-version.sh $(PANDOC_DIR) > $(PANDOC_VER_LOCK_FILE)
################################################
# ターゲット：リポジトリ・原文アップデート系
# (jgm/pandoc: MANUAL.txt のアップデートと翻訳ファイルの更新)
################################################
# make ja-init
# git submodule を初期化する
.PHONY: ja-init
ja-init:
git submodule update -i
# make jgm-pandoc-checkout PANDOC_VER=バージョン番号
# jgm/pandocを特定バージョンでチェックアウト
.PHONY: jgm-pandoc-checkout
jgm-pandoc-checkout:
if [ -z $(PANDOC_VER) ]; then \
echo "[ERROR] specify version: make pandoc-checkout PANDOC_VER=<VERSION>" && exit 1; \
fi
cd $(PANDOC_DIR) && git checkout $(PANDOC_VER)
make ja-pandoc-version-lock
make jgm-copy-src-md
# make jgm-copy-src-md
# jgm/pandocの MANUAL.txt および doc/ の特定ドキュメント(md) をコピーする（翻訳対象のみ）
# 注意: MANUAL.txt のみ users-guide.md にリネーム（既にこの名前で公開済のため）
.PHONY: jgm-copy-src-md
jgm-copy-src-md:
rm -rf $(SRC_MD_DIR)
mkdir -p $(SRC_MD_DIR)
cp -f $(SRC_MD) $(SRC_MD_DIR)
cd $(SRC_MD_DIR) && mv MANUAL.txt users-guide.md
# make users-guide-rst
# Pandoc: src-md のMarkdownファイルをすべて、ヘッダ付きでrstに変換する
.PHONY: users-guide-rst
users-guide-rst:
ls $(SRC_MD_ALL) | xargs -I {} bash ./scripts/generate-rst.sh {}
################################################
# ターゲット：Sphinx系（単品）
################################################
# make intl-update
# users-guide.rst (原文) を更新するときに、翻訳ファイル (pot/po) を更新する
.PHONY: intl-update
intl-update:
make gettext
sphinx-intl update -p _build/gettext -l ja
# make ja-html
# Sphinx: htmlをビルドする
.PHONY: ja-html
ja-html:
make -e SPHINXOPTS="-D language='ja'" html
################################################
# ターゲット：Transifex系
################################################
# make tx-push-pot
# Transifex: 【翻訳前pot】手元の更新後ソースファイル(pot)をpushする
.PHONY: tx-push-pot
tx-push-pot:
tx push -s --skip
# make tx-pull
# Transifex: 【翻訳後po】Transifexから最新の翻訳ファイル(po)をpullする
.PHONY: tx-pull
tx-pull:
tx pull -l ja
# make tx-push-local-po
# Transifex: 【翻訳後po】手元の翻訳ファイル(po)をpushする
.PHONY: tx-push-local-po
tx-push-local-po:
tx push -t -l ja
# ----------------------------------------------------------------
# Rules for Sphinx
# ----------------------------------------------------------------
# You can set these variables from the command line.
SPHINXOPTS =
SPHINXBUILD = sphinx-build
SOURCEDIR = .
BUILDDIR = _build
# Put it first so that "make" without argument is like "make help".
help:
@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
.PHONY: help Makefile
# Catch-all target: route all unknown targets to Sphinx using the new
# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
%: Makefile
@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)