ドキュメンテーションを加速するストレスフリーの作図ツール『blockdiag』 jus2011年6月勉強会
システム開発や保守、運用の現場においてドキュメントは必須のものです。 しかし、ドキュメントの作成・維持には多くのパワーがかかるため、ドキュ メントが存在しない、資料が古いままになっているなどといった現状を多く 耳にします。 本勉強会ではこれらのドキュメントでよく利用される「図」にフォーカスし、 みるみるうちに図を作成できる「blockdiag」をご紹介します。 「blockdiag」はシンプルなテキスト記述からブロック図、ネットワーク図などの 画像ファイルを出力可能なオープンソースの画像生成ツールです。書き やすさ、メンテナンスしやすさを中心にデザインされており、図を作るのに 配置や並べ替えに苦労する必要はありません。 blockdiagのサンプルはこちら このような特徴を持つ「blockdiag」と、シンプルな記述でドキュメントを作成 するツール「Sphinx」を組み合わせることによって
YAML+MarkdownからHTMLプレゼン生成·Luminescence MOONGIFT
LuminescenceはPython製のオープンソース・ソフトウェア。数年前からHTMLでプレゼンテーションを作るのが一般化されており、勉強会などで数多く見かけるようになってきた。作成の手軽さはもちろん、発表後のオンラインでの公開も手軽だ。 生成されたHTMLファイル HTMLで作成する際に、素のHTMLファイルをごりごりと書く人はまずいないだろう。何らかのテキストフォーマットから変換するのが一般的ではないだろうか。他のフォーマットへの変換も考えるならYAMLをベースにするLuminescenceは良い選択かも知れない。 LuminescenceはYAMLファイルを使ってプレゼンテーションを生成するソフトウェアだ。内容についてはMarkdown機能が利用できる。コマンドラインで使うソフトウェアで、YAMLファイルとアウトプットするHTMLファイル名を指定して実行する。 YAMLの内容 背
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
