Sphinx+翻訳 Hack-a-thon 2017.3に参加しました #sphinxjp

ここ数年で最多の人数だったようです。自分も3年4カ月ぶりくらいの参加らしいです。

当日のイベントページ

やったこと

  • BitBucket.orgでホスティングしてたBlogをGitHub.ioに移行
  • Blogの細々としたUpdate作業

BitBucket.org→GitHub.ioに移行

いつの間にか bitbucket.org ではなく、 bitbucket.io に移行してました。 そのため既存のhogehoge.bitbucket.orgのリンクを踏むと、 bitbucket.orgのトップページにリダイレクトされるようになってしまいました。(悲しい……)

そこでBlogの全部のリンクを直すくらいならいっそのことGitHubに移行してしまおうと思い立ち、 この機会に全て移行しました。

具体的にした作業としては以下になります。

  • .nojekyllファイルの作成(空ファイル)
  • URLがbitbuketになっているものをgithubに変更する。
  • RSS対応(feedburner)
  • google analytics対応

単純作業なので面倒でしたが、 Documentation — Tinkerer を見ながら行けば普通にいけますね。

注意点としては.nojekyllファイルを作成し忘れないようにすることですね。 .nojekyllファイルがないとGitHubはTinkererでなくJekillを実行してしまい、 _staticのようにアンダースコアで始まるファイルやフォルダを無視してしまいます。

(2017/03/20追記)

Sphinx1.4の頃から、conf.pyのextensionsにsphinx.ext.githubpagesを追加するだけで済むようになっていたようです。清水川せんせーご指導いただきありがとうございます!

Blogの細々としたUpdate作業

GitHubには移行できたので、前々から気にはなっていたのですが放置してしまっていた点を対応しました。

  • リンク先変更(about.meなど)
  • 検索システムをJanomeに変更→日本語検索もいい感じに!
  • レイアウト整える。(画像の比率や反転など)
    • CSSの調整
    • “image”ディレクティブでscaleオプションの使い方に一部誤りがあったので修正
    • 元画像に不備があるものが混じっていたので修正

おかげでスマホでBlogを閲覧時に出ていた不備が改善できました。

成果発表

  • @usaturn : Sphinxのissue対応。Sphinx本の改定作業(Sphinxのインストール方法について)
  • nskgch : Sphinx 1.6の翻訳
  • @jbking : Blogシステムをアップデートして日本語検索をJanomeに対応。ビルドシステム(gulp)の直し。
  • @kashew_nuts : 上記参照
  • @shimizukawa : Sphinx本の改定。文法マニュアル作成。
  • @tk0miya : Sphinxのバグを直してました。
  • @youske : 前回Sphinx-user.jpでmake.htmlでホームページのひな形を作ったので、 ドキュメントを強化(リストや罫線,強調,写真,etc)するためのあれこれを試してた。
  • @pashango : Qtを使ってSphinxのGUIツールを作ってた。