Sphinxでmscgen / graphviz | Go for it!
Sphinxでドキュメントを書いたりしています。 以前からシーケンス図やブロック図を描くのに それぞれ mscgen や graphviz といったツールを使っています。 これらのソフトウェアは、テキスト形式で定義を記述する（dot形式というらしい）と画像を生成してくれます。 単純に画像を作るだけならMicrosoft VisioやOmniGraffleでいいのですが、 テキストベースでドキュメントを書いている場合、いろんなアプリケーションを 横断しなくてはならず、ちょっと面倒なんですよね。 mscgenやgraphvizを使えばテキストファイルのみで管理することができるというわけです。 で、本題。 Sphinxにはこれらの拡張が用意されています（標準ではないです）。 拡張を導入することでSphinxドキュメント内にdot記述をすることが出来るようになります。 http://package
PyCon mini JPに参加した＆LTした - YAMAGUCHI::weblog
当日のプログラムはこちら 関連リンク PyCon mini JP リンク集 #pyconjp - aodag's posterous PyCon mini JP ☆20110129 - Togetter 初LTしました 大勢の前でLTするのは何気にはじめてで、緊張してめちゃくちゃ早口になってしまったのでかなりあっという間に終わってしまいましたが、とても楽しかったです！またLTしたい！ [20110129] sphinx theme collection 2011春View more presentations from Yoshifumi YAMAGUCHI. 感想など 各発表者の方々が各自のサイトでスライドの掲載および、解説をしてくださっているので、自分は感想等を簡単に載せておきます。 開会宣言 増田さん（@whosaysni）による開会の挨拶。日本のPythonコミュニティの現状と、世
PyCon Mini JP 「お前、誰よ」まとめ
昨日、 PyCon Mini JP にSphinx 1.1 の i18n 機能について発表しました。 Python コミュニティの偉い石本さんが 日本の Pythonコミュニティの歴史について、いいキーノートを発表してくれたけれども、いろなPython 開発者がみんな集まる PyCon みたいなイベントが珍しいので、最初は固くて、重たい気持ちを感じました。 清水川さんや、鈴木さんがアイスブレークしようとしましたが、固い雰囲気が続いてしまった。 私はスタッフさんから無理やりアイスブレークをするのが非常に難しいと認識した。もし、スタッフさんがよく頑張ってくれたのに、みんなさんがあまり楽しめずに終わってしまったら、非常に残念なことになるなと思った。発表が受けられるために、以前にいろいろ考えて資料を作ったが、もうちょっと軽い気持ちをさせるため、発表する前に、ギリギリな時間に #bucho の写真の
Sphinx WebSupportを使ってみる - そこはかとなく書くよ。
Python Web フレームワーク アドベントカレンダー2010のバトンが回ってきましたので、書いてみます。 Sphinx version 1.1から、WebSupportというものが入りました。これは、sphinxのドキュメントをWebサーバにつなぎ、コメントや変更の提案、投票といった機能を追加してくれます。 これ単体だとWebフレームワークとは言い切れませんが、まあ誤差の範囲ということで許してください。 概要把握: 動作している様子 WebSupport開発者のJacob Masonさんが提供しているデモサイトです。これを見て雰囲気を掴んでください。 http://www.jacobmason.com/demo/contents ちなみにこのソースはbitbucketで公開されています。 必要なライブラリ WebSupportはコメントなどをsqliteのDBに保存しますので、それを
bitbucket + Sphinx + Google App Engineで自動更新サイトを作成する - YAMAGUCHI::weblog
動機 Sphinxを使って翻訳作業をしたりしているんですが、いちいち自分でビルドして、サイトに公開するのが面倒。そこで WebSocketのRFCの日本語訳を公開した時と同様にGoogle App Engineへ定期的にSphinxでビルどしたhtmlディレクトリをupするという方法を試してみた。 出来たもの とりあえずいまはこんな感じで動いています。 404 Not Found プロジェクト作成 まずはGoogle App Engine（以下GAE）のプロジェクト作成をする準備。今回はUbuntu 9.04上で環境を作ってみる。自分は一回作ったアプリケーションがあるのでいいけど、0から始める場合はまずアプリケーションの登録から。 Welcome to Google App Engine まずダッシュボードで適当にアプリケーション作成。アプリケーション作ったらSDKをダウンロード $ wg
SphinxでかんたんePubファイル作成
警告 この記事は古い為 easy_install の使用等、現在では非推奨の説明があります。インストール周りについては Windowsへのインストールの手順を参照してください。 日時: 2010/05/21 作者: 渋川よしき 最終更新: 2021/02/12 Sphinxの1.0からは、ePubファイルのビルドができるようになります。ePubファイルというのは、iPadやソニーの電子ブックリーダーなどで利用できる、電子ブックのフォーマットです。原理的にはHTMLに、決まった形式のメタデータを含むファイルを追加して、zipで固めて拡張しをepubにしたものですが、Sphinxを使えば簡単に出力することができます。
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の
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の
Sphinx の Blogger 原稿用拡張を作ってみました
Bloggerの原稿をいちいち手で書くのが面倒だったので（特にリストとかpreとか）、Sphinxを使ってBloggerの原稿を書く拡張を作ってみることにしました。 参考にしたページはこちら。 http://sphinx.shibu.jp/ ■サンプルとダウンロード githubにアップしてみましたので、こちらからご利用いただけます。 http://github.com/akisute/sphinx_rst2blogger 実際に変換させてみたサンプルをこちらに用意してみました。 http://gist.github.com/317478 ■設定 完全に私の個人使用向けになっているので、そのままではたぶん使いにくいと思います。まずはMakefileの以下の部分をご自身の環境に合わせて書き換えてください。blogger: $(SPHINXBUILD) -b blogger $(ALLSPHI
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
