styledoccoのドキュメント少なすぎだろ

styledoccoを使ってみてすげーハマったので覚書

本家サイト

ドキュメント乗ってなさすぎだろっていう

インストールやらの手順

ここに書いてあるとおり。コマンド一発ですね

sudo npm install -fg styledocco

はまったこと

htmlが認識しない

ちょっと変更して動かしてみたけれど一向にCSSが反映されないと思ったら、改行がないとhtmlを認識してくれないっぽい。改行の位置は重要。

/*
## もっと見る
各種リストのもっと見るボタンです。commonに移動したほうがいいかも
<-- ここに改行がないと認識しない --> 
	<div class="more">
		もっと見る
	</li>
*/
.more {
	line-height: 2;
	text-align: center;
}
.more.tap {
	background-color: #ddd;
}

stylusが認識しない

以下のコマンドで動くかなぁと思ったが動いてくれない。どこみてもsass使った例しか書いてないしstylusにこだわる必要ないからsassに変更した。

styledocco –preprocessor “stylus”

compassが認識しない

preprocessorの指定に以下を追加することで動く

–preprocessor “sass –compass”

まとめ

ドキュメントの自動生成でstyledoccoは綺麗だからいいんだけど、ドキュメントがなさすぎる。本家サイトのdocumentが404pageに行くってどうなのよ。。。もうちょっとつかってみてダメだったら違う奴に変更しようかなぁ。