kkimurak / ssl-rules-ja Goto Github PK

これまでasciidoctor-pdfで日本語版PDFを作成しようとすると日本語部分が正しく表示されず(いわゆる「豆腐」状態)、asciidoctor-pdf-cjk-kai_gen_gothicを使用してきました。
しばらく放っておいた間にasciidoctor-pdfのほうで対応が進んだようで、むしろkai_gen_gothicはメンテナンス終了となっていました。
よって公式の手順として紹介されているものに移行したいと思います:

$ asciidoctor-pdf -a scripts=cjk -a pdf-theme=default-with-fallback-font document.adoc

問題点

• 現状、travis.ymlに記述されたビルドでは、公式のasciidoctor-pdf dockerイメージを使用している。
• これは日本語に対応したフォントを利用しておらず、日本語のデータは埋め込まれるが日本語は表示されない。
• またデフォルトで~.github.io/ssl-rules-jp/index.htmlはリダイレクトを行う設定になっているが、これが/ssl-rules/sslrules.htmlのままになっているため404エラーとなる。

解決の方向性

• 日本語に対応したdockerイメージに切り替えてみる
• gh-pagesにあるindex.htmlのリダイレクト設定を書き換える

関連したコメント

• kkimurak/ssl-rules-ja_archived#2 (comment)

実際の手順

• travis.ymlの修正
• github-pagesブランチにあるindex.htmlに記述されたリダイレクトの修正(ssl-rules/sslrules.html -> ssl-rules-jp/sslrules.html)

これらは、それぞれが配置されたブランチが別々であることから別のPRを立てる必要があります。

• 翻訳(README_JPの作成)
• レイアウト不具合(#4 でいじったときに何かを消した?)
• 文面の修正(公式ルール→公式ルールの非公式日本語訳)

タイトルの通りです。あとできればcontributor的項目も作りたいと考えています。

memo

• 「これはRoboCup小型機リーグルールの非公式日本語訳である」といった文言を冒頭に加える
• 原文へのリンクを張る

Travis-CIの無償枠クレジットが底を尽き(てい)たため、CIによる自動アップロードが動作していません。
ひとまずは急ぎの案件については手動で対応しますが、有償枠の購入、GitHub Actionなど他サービスへの移行など検討します。

(memo)

• 日本語訳中に「ノーマルスタート」と「Normal start」が混在している
• Divisionとディヴィジョン
• Automatic Refereeとオートレフ
• Stopとストップと停止とストップゲーム

https://github.com/kkimurak/ssl-rules-jp/issues/31#issuecomment-605675714 で言及したものです。
以下引用

いま、adocのリンクの書き方を

<<翻訳したタイトル/Original Title, 文章中に表示される文字列>>

と書いていますが、どうやらこの,の次の半角スペースも表示される内容に含まれるようです。
よくわからない空白が出てきていると思ったら...
これも削除してしまおうと思います。

この作業はブランチを切って置換等で対処し、 #31 の作業ブランチにPRを出すものとします。

翻訳作業開始当初にprivateなリポジトリとして作ってしまったため、本リポジトリは robocup-ssl/ssl-rules のforkになっていません。
以下の手順でこの関係性を解消します。

1. ssl-rules-ja (本リポジトリ)の名称を適当なものに変更 (ssl-rules-ja_archivedとする)
2. ssl-rules-ja_archivedのgithub pageを無効化
3. forkしてある kkimurak/ssl-rules を kkimurak/ssl-rules-ja に名称変更
4. 新しくなったkkimurak/ssl-rules-jaにデータ一式をpush、github pages 有効化
5. (optional) transferできるissueを新しいリポジトリにtransfer
   調べた限りではPull Requestはできない模様(当然といえば当然)

翻訳作業から検証までを一人で回している都合上、公式ルールの変更に追従できるまでにタイムラグが生じてしまいます。
そのため、公式ルールとの差分表示をできると便利ではないかと考えた次第です。

検証用スクリプト

TODO:

• travisで検証スクリプトが動かない原因を探る (検証用スクリプトのリポジトリでは動いている)
• プルリクエスト限定で検証スクリプトがトリガされるように設定する

#26 や #27 に加え、そもそも2019の時点で翻訳が微妙な個所が見受けられたため、そこを修正していきたいです...

例

• 2.1.2 フィールドの表面/Field Surface
  • フィールドのさらに0.4m外側は
    -> フィールドの外周0.4mは

この辺をまとめて修正したfixupブランチを作成し、#26 や #27 の修正もこれにmergeして、2020のルール変更に関する最後のmerge requestとしたいと思います。

jpは国識別コードですので、言語識別コードのjaに変更したいと思います。

タイトルの通りです。
今出ているプルリクの作業をすべて通したら、いちど機械的なスペルチェッカーか何かで一括で処理してしまおうと思います。

Travis CIでgithub pagesを更新しているわけですが、master-jpブランチとmasterブランチにある.travis.yml で指定しているブランチが違うせいで、うっかりmaster-jpより後にmasterブランチを更新してpushしたりすると、github-pagesが英語版の内容で置き換えられてしまうようです。
運用上の問題なので、私がこの順序を守っていればいいだけなのですが...

「masterブランチは原則として本家の内容と完全に同一」として運用しているので、masterに変更を加えたくないのですよね...
もしくは、masterをmaster-enにしてmaster-jpをmasterにする、という解決策はあるかもしれません。