Sphinx 1.2 preview 2013/2/23

おまえ、誰よ

_images/face.png
  • http://清水川.jp/ @shimizukawa

  • Sphinxの活動:
    • Sphinxメンテナー、Sphinx-users.jp会長
  • その他の活動:
    • Zope/Plone系, pyspa系, XP系
  • 言語:
    • C++/C/8086 -> Python/Rails
_images/sphinxusers.jpg

Sphinx 1.2 のリリース時期

_images/sphinx-1.2-release-day.png
_images/sphinx-1.2-release-day2.png
  • そろそろ旧正月も明けたよね!

Sphinx 1.2 の追加機能

  • Python3.3対応(要docutils0.10)

  • sphinx.ext.linkcode拡張

    (function等からソースへリンク)

  • reST読み取り後の内部データをXML出力

  • Sphinx開発者向けガイドドキュメント

  • 日本語Dir/File名を使用可能

  • 翻訳機能の対象を拡大(または不具合修正)

  • texinfo機能の大幅強化

  • autodocのデバッグ効率向上

翻訳機能の対象拡大(不具合?)

  • 画像(figure)のキャプション
  • 脚注(footnote)のcite
  • 用語定義(definition)の用語
  • 用語集(glossary)の用語
  • 索引(index)の用語
  • 翻訳文章中のリンクが壊れる問題
  • docfield, versionadd系

Sphinx 1.2 の修正機能

  • make latexpdfja 日本語PDF出力の更新版を取り込み
  • make text で日本語だと文字幅がガタガタになる問題
  • intersphinxのマッピングが期待順にならない問題(py33)
  • etc. etc...

Sphinx 1.2 言語カタログ追加

  • Norwegian bokmaal
  • Slovak
  • Hungarian
  • Basque
  • Hebrew
  • 現在: 32言語

公式ドキュメント多言語化計画

  • 日本語公式ドキュメントは今まで直接書き換えていました:

    .. Available builders
    .. ==================
    
    利用可能なビルダー
    ==================
    
  • 今後は翻訳作業を Transifex でやります

  • Sphinx i18n機能の モデルケース

  • 翻訳のお手伝い募集中です!

おまけ: Sphinx本アンケート