タグ

StyleDoccoに関するaya_mtsdのブックマーク (2)

  • StyleDoccoでstyleguideを作成

    フロントエンドの開発で業務を引き継ぐと面倒なのがスタイルシートの仕様の把握です。 スタイルガイドがあるとメンテナンスやアップデートも非常に行いやすいのですが、スタイルガイドを作成するのは結構面倒。 そんなこんなでcssのコメントで対応してたが、そろそろキチンとしよう思い、styleguide document generatorを検討してみた。 styleguide document generatorについて有名どころの StyleDocco と kss があるので、今回はStyleDoccoについて。 StyleDocco generates style guide documents from your stylesheets by parsing your stylesheet comments through Markdown. You can write HTML snippe

  • スタイルガイドを生成する「StyleDocco」の使用感 - Mach3.laBlog

    この記事は賞味期限切れです。(更新から1年が経過しています) 先日スタイルガイドを制作する機会がありまして、 せっかくなので、スタイルガイドの生成に利用したStyleDoccoの使用感などをまとめておきます。 スタイルガイドについて ざっくり言うとスタイルシートのドキュメントです。 自分一人で完結するその場限りのページなら良いのですが、 複数人のチームで組み込んでいたり、メンテナンス担当が他の方だったりする場合、 プロジェクトCSSをドキュメント化しておく必要が出てきますね。例えば、 どのような命名規則や方針で書かれていて どこになにがあり どのようなモジュールがどこで使えて そのモジュールはどうするとどのような挙動を起こすのか 等をまとめておく文書になると思います。 規模によってはかなり骨な作業になりそうです。 StyleDoccoとは StyleDocco StyleDocco ge

    スタイルガイドを生成する「StyleDocco」の使用感 - Mach3.laBlog
  • 1