Tinkererへのインストール

../../_images/tinkerer.png

Tinkerer はSphinxをベースにしたブログシステムです。Sphinxよりも柔軟なサイドバーのテンプレートが使えるので、OktaviaとTinkererを一緒に使うのはSphinxよりも簡単です。Sphinxにもサイドバーをカスタマイズする機能はありますが、既存のサイドバーのコンテンツをすべて消してしまいます。Tinkererははじめからこの機能を利用しているため、消えることを心配する必要はありません。

githubのリポジトリ に含まれているTinkerer向けのテンプレートを参照してください。

  1. After creating a project folder (by using tinker), copy needed files into a _static folder.

    • oktavia-search.js もしくは oktavia-*-search.js
    • oktavia-jquery-ui.js
    • searchstyle.css

    Tinkererはすでにキーワードハイライト機能を持っているため、 oktavia-jquery-highlight.js を追加する必要はありません。

  2. oktaviasearch.html_templates フォルダに追加します。

  3. conf.py のサイドバーの設定を変更します。

    oktaviasearch.html` を追加して、既存の検索フォームの ``search.html を削除しましょう。

    html_sidebars = {
       "**": ["oktaviasearch.html", "install.html", "recent.html", "tags.html"]
    }