Sphinx + 翻訳 hack-a-thon 2018.08 #sphinxjp¶
久々にhack-a-thon参加blog.
SphinxのHack-a-thonイベントに参加してきました。
今日のオヤツ. @usaturn++¶
- イベント:
- 参加者:
@tk0miya, @shimizukawa, @cocoatomo, nskgch, @usaturn
- 会場:
タイムインターメディア社（曙橋）
自己紹介、やること¶
やること¶
@tk0miya: 「Sphinx-1.7.7と1.8.0b1のリリースに向けてコード書きます。」
@shimizukawa「Sphinx-1.7.7リリースに向けてIssue/PR確認を手伝います」
@cocoatomo: 「 Python公式ドキュメント の翻訳と関連チケットの確認をやります。疲れたらpipenvの翻訳、飽きたらdocutilsの型付け。逃げ道をたくさん用意してます。」
nskgch: 「Sphinxドキュメント翻訳の手伝いをしてます。今日もやります」
@usaturn: 「」
自分がやったこと¶
用事で15時に帰らないといけなくなったため、朝10時くらいから近所でhackしてました。@tk0miya が会場をはやく開けてくれたので、12時すぎくらいから現地でhack開始。
pre- sphinx hack-a-thon!! #sphinxjp (@ Starbucks Coffee 北の丸スクエア店 - @starbucks_j in 千代田区, 東京都) https://t.co/3UkT5YdSvc pic.twitter.com/CYYMBGnKoN
— Takayuki Shimizukawa (@shimizukawa) 2018年8月19日
PRをいくつかレビューして、Issue見ました
https://github.com/sphinx-doc/sphinx/pull/5312
sphinx-quickstartコマンドをPowerShellで使うと、質問文の文字色が背景色と同じで読めない、という問題への対処。purpleをやめてboldにするPRを実際にWindows PowerShell で動作検証した。結局、
boldっていってもコンソール上ではフォントを変えて文字を太くできるわけではないので、デフォルトの文字色をちょっとくすんだ色にして、bold指定が来たらハッキリした色で表示するように、ターミナルのカラースキーマが設定されています。この確認のために、purpleとは何か、boldとは何か、みたいなのを把握する必要がありました。 ANSIのエスケープコードを使って文字色を変えるんだけど、黒なら
30m、白なら37m、白のボールドなら1;37mで白の標準色なら0;37mみたいに指定する。各エスケープコードで実際にどんな色を表示するかはターミナルのカラースキーム設定に依存しているので、PowerShellでの出力を把握するために Windows Console Colortool を使ってみました。
Sphinxの文字出力と Windows Console Colortool¶
残念ながらPowerShellでは実際のANSIエスケープコードでの表示色とは異なる色を提示しているみたい。cmd.exe向けなのかな。
このときの結論としては、PowerShellでboldというと黄色で出力される。背景色とかぶらない方がよいので、Windowsでは質問文をpurpleではなくboldで表示する、ということにしました。
