Sphinx+翻訳 Hack-a-thon 2012.04に行ってきました。¶
[追記](2012/04/30 16:05)
当日の様子はこちら
当日やったことリスト
* Sphinxテーマのimpress.js弄った。
* Sphinxプラグインのblockdiag触った。
* MacにMercurial入れた。
* bitbucket試した。
Sphinxテーマのimpress.js弄った。
今まではs6触ってて「これはシンプルでいいなー」と思ってましたが、
“impress.js”っていうのもアニメーションが効いてて良さそうと思ったので試しました。
を参考にして、
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.
html_use_index = False
設定を追記したら、あっさりmakeできました。
他に参考にしたサイトは以下になります。
その時四苦八苦している様子を@usaturnさんがまとめてくれています。
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
MacにMercurial入れた。
から最新版をインストール。
ターミナルからhgを打ったら起動……しない。
あれ？と思って調べてみると、どうやらPATHが通っていない。
更に調べてみるとインストールされたはずの、
/usr/local/bin/以下にアクセスできなくなっていました。
アクセス権限を設定し直したらうまく行きましたが、
以前システム設定の共有の設定を弄った時に変えてからかな……
Mercurialに原因があったわけではありませんが少し気になります。
bitbucket試した。
完全に忘れていましたがアカウントは以前に作成してため、
まずはgithubと同様にdotfilesを上げてみました。
これからはちょくちょくこちらも弄っていきたいです。
まとめ
今月一回も勉強会にこれてなかったので、まずはこれてよかった。
やっぱりmake一発でプレゼン式のPDFなりPPTなりの出力する仕組みが欲しい。
来月もHack-a-thon参加します。