Sphinx+翻訳 Hack-a-thon 2012.04に行ってきました。

connpass-Sphinx+翻訳 Hack-a-thon 2012.04に行ってきました。

[追記](2012/04/30 16:05)
当日の様子はこちら
Sphinx+翻訳 Hack-a-thon 2012.04 - Yukarin'Note

当日やったことリスト

Sphinxテーマのimpress.js弄った。

Sphinxプラグインのblockdiag触った。

MacにMercurial入れた。

bitbucket試した。

Sphinxテーマのimpress.js弄った。

今まではs6触ってて「これはシンプルでいいなー」と思ってましたが、
"impress.js"っていうのもアニメーションが効いてて良さそうと思ったので試しました。

sphinxjp.themes.impressjs 0.1.0 : Python Package Index
を参考にして、

pip install sphinxjp.themes.impressjs

した後、conf.pyに以下の設定を記述しました。

extensions = ['sphinxjp.themecore']
html_theme = 'impressjs'

そしたら何故か以下のようなエラーがでる……

Exception occurred:
  File "/Users/***/.virtualenvs/impressjs/lib/python2.7/site-packages/sphinx/jinja2glue.py", line 149, in get_source
    raise TemplateNotFound(template)
TemplateNotFound: genindex.html
The full traceback has been saved in /var/folders/cg/8n8k9bvj5vgbp65py_kxf52r0000gn/T/sphinx-err-l8t7JZ.log, if you want to report the issue to the developers.
Please also report this if it was a user error, so that a better error message can be provided next time.
Either send bugs to the mailing list at ,
or report them in the tracker at . Thanks!
make: *** [html] Error 1

エラーのログを見てみると以下のようになっているので、
「どこか設定ファイルの記述が間違っているのでは？」と予想。

exception jinja2.TemplateNotFound(name, message=None)
Raised if a template does not exist.

もう一つ出てきたサイト、
shkumagai/sphinxjp.themes.impressjs
を参考にして見ると、先の2行に加えて以下の1行を加える必要があることが判明。

html_use_index = False

設定を追記したら、あっさりmakeできました。

その後は、先のサイトのoutputと、inputを見比べながら進めて行きました。

他に参考にしたサイトは以下になります。
use No::Name; [log][sphinx][python][document]sphinxjp.themes.impressjs 0.1.2 リリースしました。
百式年賀状 powered by impress.js

その時四苦八苦している様子を@usaturnさんがまとめてくれています。
Sphinxのかっこいいスライド作成拡張「sphinxjp.themes.impressjs」 - Yukarin'Note

impress.jsでは以下の設定を記述して、魅せ方の調整を行うようです。

.. impressjs:: title
       :data-x: 0           横軸の設定
       :data-y: 0           縦軸の設定
       :data-z: -1000       奥行きの設定
       :data-rotate-x: -90  回転する角度の設定
       :data-scale: 4       表示するスライドの大きさの設定

これの意味が最初ちんぷんかんぷんで、
適当に数値を変えてみたら複数のスライドが重なって表示されました。

しっかりと意味あるものにするのには微妙な調整が必要のようです。
実際に試してみないと感覚がつかめないなと思いました。

Sphinxプラグインのblockdiag触った。

pip install sphinxcontrib-blockdiag

して、
Sphinx 拡張：sphinxcontrib-blockdiag — blockdiag 1.0 documentation
を一通り試して終了。

MacにMercurial入れた。

Mercurial binary packages for Mac OS X
から最新版をインストール。
ターミナルからhgを打ったら起動……しない。
あれ？と思って調べてみると、どうやらPATHが通っていない。
更に調べてみるとインストールされたはずの、
/usr/local/bin/以下にアクセスできなくなっていました。

アクセス権限を設定し直したらうまく行きましたが、
以前システム設定の共有の設定を弄った時に変えてからかな……
Mercurialに原因があったわけではありませんが少し気になります。

bitbucket試した。

完全に忘れていましたがアカウントは以前に作成してため、
まずはgithubと同様にdotfilesを上げてみました。
これからはちょくちょくこちらも弄っていきたいです。

まとめ

今月一回も勉強会にこれてなかったので、まずはこれてよかった。

やっぱりmake一発でプレゼン式のPDFなりPPTなりの出力する仕組みが欲しい。

来月もHack-a-thon参加します。