CakePHP3のチュートリアルサイトでの日本語版PDF生成について


お世話になります。
今回、CakePHP3のチュートリアルサイト(https://book.cakephp.org/3.0/ja/index.html)で「クックブックがどこでも読める」というエリアにて
ドキュメントのリンク「PDF(英語)」がございます。
このリンクをクリックすると英語のCakePHP3の使い方の説明がでてきます。

ここで質問なのですが、このようなPDF形式でのチュートリアルを日本語で生成できるような方法がございましたらご助言いただければと思っています。

個人的に「PDF(英語)」のドキュメントファイルようなデザインレイアウトで日本語のPDFを見れたらと思っております。

githubのページ(https://github.com/cakephp/docs)にドキュメントの作成方法(?)のようなことを探していたのですが、正直なところ
どのようにドキュメントファイルをPDFにして作成できる分かりません。
ファイルを作成するまでの手順を教えていただけれると幸いです。

ぜひご助言いただければ幸いです。
よろしくお願いいたします。

回答の条件
  • 1人1回まで
  • 登録:
  • 終了:2018/01/01 13:15:06
※ 有料アンケート・ポイント付き質問機能は2023年2月28日に終了しました。

ベストアンサー

id:a-kuma3 No.1

回答回数4973ベストアンサー獲得回数2154

ポイント100pt

make コマンドを使います。
ルートにある Makefile を見ると、

% make pdf

で、全ての言語(後述)、

% make pdf-ja

で、日本語のドキュメント(PDF を出力するための LaTeX ファイル)を作るようです。

ルートの Makefile には、以下のコメントがあります。

# Languages that can be built.
LANGS = en es fr ja pt zh tr ru

# pdflatex does not like ja, zh & tr for some reason.
PDF_LANGS = en es fr pt

全ての言語を対象にドキュメントを生成する場合に、日本語、中国語、トルコ語は、敢えて外している様子。
きれいにできないんですかね(想像)。

一括生成では外されていますが、ja/Makefile には PDF 用の LaTeX ファイルを作るターゲットは定義されているので、コマンドとしては動くのだと思います。
LaTeX のドキュメントを作るには sphinx-build というコマンドを使っているようです。
http://www.sphinx-doc.org/ja/stable/man/sphinx-build.html

GitHub にある Makefile を読んだ感じでは sphinx-build コマンドを実行すると、(多分)別の Makefile が作られて、それをまた実行すると LaTeX から PDF を作るところまでやってくれるみたいな感じで書いてあります。
ただ、その Makefile の中身が分からないので、その先が読み取れません。

ja ディレクトリの Makefile で latex ターゲットを指定して実行すると、LaTeX のファイルだけを作るようになってます。

% cd ja
% make latex LANG=ja

build/latex/ja に作られる LaTeX ファイルを、PDF の仮想Writer に向けて印刷すれば PDF が手に入るはずです。

id:nagato-yuki

ご回答ありがとうございます!
とても参考になる説明も書いていただき感謝申し上げます。

回答を参考に検討してみたいと思います!
機会がありましたらまたよろしくお願いいたします。

2017/12/26 14:35:48

コメントはまだありません

この質問への反応(ブックマークコメント)

「あの人に答えてほしい」「この質問はあの人が答えられそう」というときに、回答リクエストを送ってみてましょう。

これ以上回答リクエストを送信することはできません。制限について

回答リクエストを送信したユーザーはいません