ymotongpoo / erlang-in-anger Goto Github PK

This project forked from heroku/erlang-in-anger

A little guide about how to be the Erlang medic in a time of war. It is first and foremost a collection of tips and tricks to help understand where failures come from, and a dictionary of different code snippets and practices that helped developers debug production systems that were built in Erlang.

License: Other

TeX 86.58% Erlang 0.88% PostScript 10.50% HTML 1.57% Makefile 0.17% Perl 0.02% Dockerfile 0.29%

erlang-in-anger's Introduction

README

Erlang in Angerの翻訳用レポジトリです。オリジナルのREADMEはこちらを参照してください。

Contribution

雰囲気

自分一人でやるのはしんどいのでpull-requestください。翻訳するときはオリジナルのものをコメントアウトする形でやっていきます。詳しくは NNN-foobar-ja.tex で翻訳済みになっているファイルを参照してください。

手順

注意メインブランチは japanese です。 master はupstreamの追従用です。

参加する旨を @ymotongpoo に言う (Collaboratorsに追加します)
割り振り表の「担当」のカラムで自分がやりたいところに記名する。(節単位で担当するのが望ましい。)
featureブランチ(japanese 以外に適当にブランチ)を切ってそこで作業する。(自分のアカウントにフォークしてから作業してもらっても構いません)
担当部分が終わったら japanese ブランチにmerge。心配ならpull-requestを出してください。(みんなでレビューしましょう)
以下2-4の繰り返し。

また、pull-requestを出してCIに通った場合はGitHub ActionsのArtifactsとしてZIP圧縮済みのPDFを得ることができます。

レビュー

訳がおかしいなと思ったら適宜Issueを立ててください。(TODO: Issueテンプレートの作成)

Build

TeX Liveをとりあえずインストールしてビルド。オリジナルはpdfLaTeXを使って生成しています。 Latexmkを使ってビルドできるようになっているので各々次のようにビルドします。

$ make english   # -> text.pdf: original English version
$ make japanese  # -> text-ja.pdf: Japanese translation version

また、Docker環境がある場合は次のコマンドでコンパイルすることもできます。

$ docker-compose up

ビルドに成功すると、text-ja.pdf が作成されているはずです。

ビルド対象の追加

どの tex ファイルを読み込むかは text-ja.tex ファイルの \include 行で指定します。例えば 109-tracing-ja.tex を追加する場合、下記のように記載します。

\include{109-tracing-ja}

進捗

Tips

ダッシュ(―)は --- (ハイフン3つ)とすると表示が崩れない

erlang-in-anger's People

Contributors

Stargazers

Watchers

Forkers

hayabusa333 hykw ohr486 ma2gedev rinosamakanata mookjp sylph01 spinute masashiyokota

erlang-in-anger's Issues

テスト

ういぃ〜

Travis CIのUbuntu18.04化に伴う秘密鍵更新

Erlang in AngerのTravis CIまわりをアップデートしていたら、OpenSSLがUbuntu 18.04で1.1系となってしまって軽くしらべた限りではこれまでのオプションではPDFをプッシュする秘密鍵を復号できなくなってしまった 😇
- scala-text/scala_text_pdf#5 👈 こういうことが必要

$ ./travis/deploy_pdf.sh
+[[ linux == \l\i\n\u\x ]]
+[[ japanese == \j\a\p\a\n\e\s\e ]]
+[[ false == \f\a\l\s\e ]]
+echo -e 'Host github.com\n\tStrictHostKeyChecking no\nIdentityFile ~/.ssh/deploy.key\n'
+openssl aes-256-cbc -k [secure] -in ./travis/deploy_key.enc -d -a -out deploy.key
+cp deploy.key /home/travis/.ssh/
+chmod 600 /home/travis/.ssh/deploy.key
+git config --global user.email [email protected]
+git config --global user.name 'Yuu Yoshimura'
+git fetch origin gh-pages:gh-pages
From https://github.com/ymotongpoo/erlang-in-anger
 * [new branch]      gh-pages   -> gh-pages
+git stash -a
Saved working directory and index state WIP on (no branch): 5bf7219 101: ビルドを失敗させる箇所を修正
+git checkout gh-pages
Previous HEAD position was 5bf7219... 101: ビルドを失敗させる箇所を修正
Switched to branch 'gh-pages'
+rm text-ja.pdf
rm: cannot remove ‘text-ja.pdf’: No such file or directory

一度pushに失敗してgh-pagesが空になった後はPDFが上げられない形になっているのが原因と思われる。

erlang-in-anger-pdf-compile_1  | Latexmk: Use the -f option to force complete processing,
erlang-in-anger-pdf-compile_1  |  unless error was exceeding maximum runs, or warnings treated as errors.
erlang-in-anger-pdf-compile_1  | === TeX engine is 'LuaTeX'
erlang-in-anger-pdf-compile_1  | Latexmk: Errors, so I did not complete making targets
erlang-in-anger-pdf-compile_1  | make: *** [Makefile:21: text-ja.pdf] Error 12
erlang-in-anger_erlang-in-anger-pdf-compile_1 exited with code 2

https://travis-ci.org/ymotongpoo/erlang-in-anger/builds/393904383