dを試してみる

dとは

複数のmarkdown形式のファイルからプロジェクトのドキュメントを簡単に作成するためのツールです
オフィシャルのドキュメントがdでできてます

http://sjl.bitbucket.org/d/

インストール

pip install d

使い方

プロジェクトに任意の名称のドキュメント用フォルダを作成します

cd my_project
mkdir docs


ドキュメント用フォルダにはmarkdownでドキュメントを記述します

cd docs
touch index.markdown
touch installation.markdown
touch usage.markdown

cat <<EOF > index.markdown
This is great tool
EOF

cat <<EOF > installation.markdown
Installation
============

Here's how to install my project.

If you just want to see how to use it, take a look at the [samples][] page.

[samples]: /samples/

[TOC]

Linux
-----

Use your package manager.

Windows
-------

It depends on what version of Windows you have.

### Windows XP

...

### Windows Vista

...

### Windows 7

...
EOF


docsでdコマンド実行すると、buildディレクトリが作成され、ドキュメントができてます

d
cd build
python -m SimpleHTTPServer

見てみましょう
http://localhost:8000


問題点

残念ながら日本語(マルチバイト文字)が通らないみたいです。致命的ですけど
内部でmarkdownを使ってるからなんですが、フォークしてmisakaを使うように修正している方がいるので、そっちだったら通るのかも

https://github.com/honza/d