RandomThoughts

RandomThoughts

サブWikiの公開手順

Contents:
  1. SubWIkiサイトのサブディレクトリとして公開
  2. 古くなった手順

サブWikiより。

ディレクトリをgit-wikiとして公開する運用にしている。>GitWiki

SubWIkiサイトのサブディレクトリとして公開

最近はこの方法に移行した。

実際に新しいのを追加してみないとうまくいくかは分からないが、現時点の認識を書いておく。

  • 以下の三箇所にサブWIki名のディレクトリを追加
    • wiki_src
    • wiki
    • _includes/git-wiki/components/lists/
  • 一回wiki_srcにコピーした後conv.shする必要があるかも

古くなった手順

以下、以前のサブWiki一つにつき1レポジトリだった時代の公開手順を置いておく。RandomThoughtsなどの初期に公開したのはこのままなので。

以下、サブWikiをgit-wikiとして公開するための手順。

  • https://github.com/Drassil/git-wiki-skeletonからUse this templateで公開用の名前をつける。
  • _config.ymlの編集
    • baseurlの行を削除
    • title, descriptionを書く
    • blog_featureをfalseに
    • wiki_srcとscriptsのexcludeを足す
  • README.mdを編集(wiki下へのリンクはwiki/が必要っぽい)
  • sidebarのリンクをwiki/Home.mdに変更(_include/sidbar.htmlにあるっぽい)
  • レポジトリのsettingsからPagesのタブを選んで、Sourceを指定(masterでroot)してSave

これでwiki下にmarkdownを置けば勝手に公開される。以下はTeFWiki特有の作業

  • _includes/git-wiki 下をコピーする(タイトル、サイドバーのカスタマイズ)
  • wiki_srcというディレクトリを作る
  • scripts下をコピーする
  • copy.shのSUBWIKI_NAMEを編集

これらは以下の3つをするスクリプト。

  • scripts下にTeFWikiのmdをwiki_srcにコピーするスクリプトを置く
  • scripts下にwiki_srcからwikiへWikiLinkをコンバートするスクリプトを置く
  • recentsを生成する(GitWikiの「サイドバーのrecentsの日付が反映されていないのを修正」を参照)

これでscripts下でスクリプトを実行するとTeFWikiのサブディレクトリがコピーされて公開準備が整うので、git commitしてpushする。

タイトルのカスタマイズは、

  • titleタグを site.name/WikiName にする
  • ページ内のtocの上にh1でWikiNameを表示
  • tocの下にhrを挟む

という事をやっている。