サブ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を挟む
という事をやっている。