鉄は熱いうちに打て

Markdownにmetaタグを入れる

Sphinx使ってますか?私は結構使っています。

今日はHTMLの全ページにmetaタグを入れた話です。

HTMLには目に見えている以外にその文書の情報を持たせられます。それがmetaタグです。 前ページに その文書の説明(description) をもたせようと思いました。

同僚に聞いたら、 rst_prolog というのがあるみたいです。ファイルの先頭に指定した文字列を追加してくれます。 しかし、実行しても reSturucturedText ファイルにしか追加されません。

調べると、 Use rst_prolog and rst_epilog only for rst files? #2445

Sphinxでスライドを作りたい

入社してから会社でSphinxを使って文書を書くことが増えたので、reStructuredTextもついでに覚えようと思いました。 でも仕事中にいろいろ試している時間はないので、勉強会とかでLTするスライドとかブログに使えばいいじゃない。と考えて、使い始めました。

ここ3,4年ほどはMarkdown一筋だったんですが、reStructuredTextも慣れるといろいろ微調整できて便利です。

なんとなく2年間使ってきたんですが、せっかくPython製なのでもうちょっと勉強しようかなと思って、Sphinx ユーザーコミュニティのSlackに入りました。

久しぶりにSphinxでスライドを作ろうとしたら完全に迷子

Sphinxでスライドが作れたよねーと思って作ったら、困ったのでメモ

結論

sphinxjp.themes.s6 0.3.0を見よう!

このリンク先の通りにやれば間違いないです。

困ったこと

適当に検索してたら、conf.pyを下のように書くのだというサイトがいくつか出てきて、コンパイルしたら、「'sphinxjp.themecore'」はもう書かなくていいよぉぉぉ。とか出てくるし。

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

正解はこっちでした。

ブログをWordpressからSphinxに乗り換えた話

私とブログ

  • 1995年にパソコン購入。同時にパソコン通信(niftyサーブ)開始。
  • 1999年当時のプロバイダだったInfoWeb(現@nifty)からホームページスペースを与えられたので、htmlを自分で書いてブログスタート。
  • 2004年html書くのめんどくさくなって、どっかのブログサービスでブログ開始。
  • 2006年フリーランスになったので、勉強のために自分でCMSを運営しようとhetemlと契約。Nucleus CMSにブログを乗り換え。
  • 2010年Wordpressの仕事が増えて、プラグインを作ったりしていた。Nucleus CMSの更新がほぼなくなり、hetemlがサポートするPHPのバージョンと合わなくなってくる。hetemlにWordpress簡単インストールというサービスができた機にWordpressに乗り換え。