Sphinx + blockdiag による非プログラマのための使える図解の紹介 | Syojimの日記
はじめに こんにちは。Sphinx Advent Calendar 2012 の4日目のエントリです。@tk0miyaより受け取りました。 Sphinx を使い始めてまだ日が浅いですが実際に仕事で使ってみてすばらしいツールだと今更ながら気づき、Sphinx に特化したエントリというよりも Sphinx + blogckdiag を使って仕事に使えるダイアグラムの表現方法についてご紹介します。 非プログラマでも簡単に作成ができ修正も簡単、イライラしないでサクサクと図が書けます。 ソフトウェア開発プロジェクトで作成されるドキュメント(特にマニュアルで利用)は顧客に説明するための図解を多用します。これまでの経験で Word/Excel の描画ツールをつかってがんばって作った図 調整と編集がとても大変 Visio を使ってわかりやすく綺麗に作成されているが、Word/Excel/PowerPoin
(23日目) blockdiag の便利な使い方(サンプル集) - 2011-12-23 - Hack like a rolling stone
いま現在、blockdiag.com には使い方の例は書いてありますが、 どんな図が書けるのかというサンプルがほとんどありません。 これは単に僕の努力不足なのですが、たまには書きこまれた図をお見せしてみたいと思います。 画面遷移図 最初にご紹介するのは画面遷移図です。 もともと blockdiag を作り始めるきっかけは画面遷移図を書くことだったので、 blockdiag と画面遷移図は非常に相性がいいです。 どの画面からどの画面に遷移するのかを矢印(->)で書くだけで図が出来上がります。 ちょっとしたマスタ管理であれば、遷移だけを書いていけば図が出来上がります。 もちろん、途中で画面を追加したくなっても、画面が廃止になっても定義を書き換えるだけです。 blockdiag { トップページ -> メニューA, メニューB, メニューC; メニューA -> ○○一覧 -> ○○追加, ○○編
Home — Sphinx Advent Calendar 2012 (全部俺)
第13日目 Sphinxドキュメントを編集する その１０ 昨日は画像やファイルへのリンクについて説明しました。 今日は 索引(インデックス) について説明します。 索引(インデックス) 一般の技術書等には、大抵最後の方に索引が記載されていると思います。Sphinxでもドキュメントに .. index:: ディレクティブを記述する事により索引を作成する事ができます。
Sphinx-Users.jp :: ドキュメンテーションツール スフィンクス Sphinx-users.jp
Sphinx-Users.jp¶ Sphinx-Users.jp(略称#sphinxjp)は、美しいドキュメントを簡単に生成することができるドキュメンテーションツール、 Sphinx （スフィンクス）の普及を主眼としたコミュニティです。SphinxはPythonの公式ドキュメントだけでなく、このSphinx-Users.jpのサイトも含め多くのマニュアルやサイトで使用されており、詳細を Sphinxの歴史で紹介しています。 Sphinx-Users.jp は日本の Sphinx コミュニティです。 Sphinx-Users.jp では、日本で散らばっているSphinx関連情報を集めて、Webサイト、イベントを通じてSphinx情報を発信します。 slack のコミュニケーションや勉強会の開催などを通じて、ドキュメントをパワーアップしたい人、ドキュメントや翻訳で苦労している人、Sphinxの
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
