ライブラリのリファレンス用のテンプレートみたいなものがほしい

Question

こんにちは．

PHPでライブラリを作ったのですが，
とても機能が多いので，単一ページで説明するには少し足りませんし，どうしても見づらくなってしまいます．

なので，リファレンスサイトを作ろうと思って，いろいろと試したのですが，なかなか良い物が見つかりません．

HTML&CSS&PHP&jQueryで作ると，一から作らなきゃいけなくて，大変です．デザインもセンスが悪くなってしまいがちで，管理も大変です．

WordpressなどのCMSを利用すると，リファレンスっぽくしたいので，テーマを作らなければいけませんが，ぼくはWordpressの知識がほとんどないので，できませんでした．

Wikiを使用しても，よく分かりませんでした（すみません）．

目的としては，
・コードをハイライト表示
・実行サンプルを設置
・すべての機能の説明を網羅したい（たくさんのページが必要）
です．

リファレンスサイトに特化したフレームワーク・CMS，
リファレンスサイトを作ることができるサービス，
独自でやる場合の方法など，
なんでもいいので，よろしくお願いしますm(_ _)m

Answer 1

PHP コードに doccomment を書いているのであれば下記などが有名です。

• phpDocumentor2
• apigen

あるいは GitHub にコードをホストしているのであれば GitHub の Wiki でもいいのではないでしょうか？
コードのハイライト表示も簡単にできますし、Markdown でさくさく書けますし、Wiki そのものを Git リポジトリとしてクローンできるので編集も楽です。

Comments

[ngyuki]

リファレンスサイトっぽいテンプレートという質問ですね・・・
質問の趣旨に会う回答になっていませんでした、すみません