NVDAが使っているドキュメントツール txt2tags の Python 3 対応をやってみた話 すごい広島 with Python 2018年12月26日 西本卓也 (shuaruta) 24motz / nishimotz

1. まだ Python 2 で消耗してるの？
2018-12-26
Takuya Nishimoto (shuaruta)
@nishimotz or @24motz

3. アンナ（Chief Sniffing Officer）
• 5歳（人間年齢36歳）

4. Python

5. NVDA日本語チーム（東京）

6. NonVisual Desktop Access
• オープンソース GPL v2 のスクリーンリーダー
• Windows 対応
• 音声合成による読み上げ
• 点字ディスプレイへの出力
• 日本語ユーザーには「NVDA日本語版」で対応
• アクセシビリティ検証ツールとしても普及
• Focus Highlight
• 開発開始 2006年
• 現在は3か月ごとのリリース
• この数年間 Python 2.7 ベース

7. NVDA + Python 3
• 2018年
• wxPython 4 への移行を完了
• 有志が py3000 ブランチを作成、評価
• 重要な機能の多くが欠落
• インストーラー
• 音声エンジン
• ドキュメント
• アドオンの互換性チェック機能を実装中（2019.1予定）
• 2019年
• 4回のリリースで Python 3.7(?) に移行

8. ドキュメント
• txt2tags
• ReST や MarkDown に似ている
• 拡張子 t2t
• 2008年ごろまで積極的に開発されていた
• NVDAでは
• 互換性の都合で 2.5 （最終版のすこし手前）を使用
• ビルドツール (scons) から使用
• Python で処理をカスタマイズしている
• バージョン番号の埋め込み
• ユーザーガイドからコマンドリファレンスを抽出

9. NVDA 本家の議論
• txt2tags にかわるツールが必要
• 検討
• Python markdown
• pandoc
• 課題
• 目次の自動生成
• NVDA 独自の作りこみへの対応
• 40以上の各国の翻訳チームの移行コスト

10. 思ったこと
• txt2tags を modernize すれば動くんじゃね？
• NVDA で必要な処理だけカバーすればいいのでは
• HTML 生成だけやる
• 生成結果が完全一致することを確認すればいい
• Python 2.7 と Python 3.7
• ドキュメント関連の貢献は手を出しやすい
• 日本語で動けば I18N 対応を示せる
• 見える人がやれば改行コードなどもチェックしやすい

14. 文字列の join
Python 2.7.15 (v2.7.15:ca079a3ea3, Apr 30 2018, 16:22:17)
[MSC v.1500 32 bit (Intel)] on win32
Type "help", "copyright", "credits" or "license" for more
information.
>>> import string
>>> string.join(['a','b','c'], ':') # 昔の書き方
'a:b:c'
>>> ':'.join(['a','b','c']) # 現在の書き方
'a:b:c'

15. リンク集
• https://github.com/nvdajp/txt2tags
• https://github.com/nvaccess/nvda/issues/8734
• https://python-modernize.readthedocs.io