タグ

sphinxに関するhagino_3000のブックマーク (8)

  • Docker

  • Sphinxでmscgen / graphviz | Go for it!

    Sphinxでドキュメントを書いたりしています。 以前からシーケンス図やブロック図を描くのに それぞれ mscgen や graphviz といったツールを使っています。 これらのソフトウェアは、テキスト形式で定義を記述する(dot形式というらしい)と画像を生成してくれます。 単純に画像を作るだけならMicrosoft VisioやOmniGraffleでいいのですが、 テキストベースでドキュメントを書いている場合、いろんなアプリケーションを 横断しなくてはならず、ちょっと面倒なんですよね。 mscgenやgraphvizを使えばテキストファイルのみで管理することができるというわけです。 で、題。 Sphinxにはこれらの拡張が用意されています(標準ではないです)。 拡張を導入することでSphinxドキュメント内にdot記述をすることが出来るようになります。 http://package

    hagino_3000
    hagino_3000 2012/02/13
    ドキュメント
  • (13日目) Jenkins + bitbucket.org で Sphinx で作られた Web サイトを自動公開する - Hack like a rolling stone

    12日目の記事をかいてからまだそんなに時間が経っていませんが、 勢いで 13日目の記事も作ってしまいました。 今日は Jenkins + bitbucket.org + Sphinx の組み合わせで、Web サイトを自動的に公開する仕組みをご紹介します。 この仕組みは実際に blockdiag.com の更新に使われているもので、僕自身もこの仕組みによってかなり楽できているものです。 一応用語説明しておきます。 Jenkins Java で作られた CI (継続的インテグレーションツール) 今回は Sphinx ドキュメントの更新を検知して、勝手にビルド・公開してくれるために使う 以前は Hudson って名前だった bitbucket.org バージョン管理システム Mercurial のホスティングサービス。git における github みたいなもの。 Sphinx 素敵なドキュメン

    (13日目) Jenkins + bitbucket.org で Sphinx で作られた Web サイトを自動公開する - Hack like a rolling stone
  • GitHub - michaeljones/sphinx-to-github: Sphinx extension & script to prepare Sphinx html output for github pages.

    Sphinx to GitHub ATTENTION! This project is designed to help you get around the github-pages Jekyll behaviour of ignoring top level directories starting with an underscore. This is solved in a much neater way by creating a .nojekyll in the root of you github-pages which will disable Jekyll as described here and here. This makes this project largely useless! Thank you to acdha for making me aware o

    GitHub - michaeljones/sphinx-to-github: Sphinx extension & script to prepare Sphinx html output for github pages.
  • Bitbucket | Git solution for teams using Jira

    With best-in-class Jira integration, and built-in CI/CD, Bitbucket Cloud connects developer workflows from planning to incident management. Join millions of developers who choose to build on Bitbucket.

    Bitbucket | Git solution for teams using Jira
    hagino_3000
    hagino_3000 2011/06/17
    ブロックダイアグラムが作れる
  • Overview — Sphinx v1.0 (hg) documentation

    ダウンロード このドキュメントはバージョン1.0 (hg)のためのものです。まだリリースされていません。 Mercurialリポジトリのコードを利用するか、Python Package Indexにあるリリースバージョンを探してください。 疑問? 意見? Googleグループへの参加: もしくは、FreeNodeの#python-docsチャンネルへどうぞ 何か気づいたことがあれば、issue trackerを使用して通知することもできます。 Sphinxは知的で美しいドキュメントを簡単に作れるようにするツールです。Georg Brandlによって開発され、BSDライセンスのもとで公開されています。 このツールはもともと、新しいPythonのドキュメントの変換のために作られました。そして、今までに数々のPythonや、他の言語で開発されているプロジェクトに対して、すばらしいドキュメンテーシ

  • Python ドキュメント生成システム Sphinx : 紹介マニア

    Python で作られた ドキュメント生成システム Sphinx に関して。 この文書は Sphinx バージョン 0.6.3 に基づいて記述しています。 概要 Sphinx は Python の公式ドキュメント 等Pythonプロジェクトで良く利用されるようになってきている Python で作成されたドキュメント生成システムです。 reStructuredText (reST) で記述することで目次やクロスリファレンスが付いた HTMLHTML Help、LaTeXPDFを生成することが可能です。 文書の階層構造を容易に作成できたり、Pygments_ を利用することでソースコードの色付けも行なえます。 Python を利用して拡張することも比較的容易にできます。 Sphinx を利用しているプロジェクトを Projects using Sphinx にて見ることができますのでどの

  • 概要 — Tornado v0.2 documentation

    概要¶ FriendFeedでは、Pythonで書かれた、比較的シンプルで、ノンブロッキング実装のされたウェブサーバを使用しています。FriendFeedアプリケーションは、web.pyや、Googleのwebappに良く似たウェブのフレームワークを使用して書かれていますが、このノンブロッキングウェブサーバと周辺ツールを利用することによるアドバンテージを生かして、追加のツールや最適化が行われています。 Tornadoはこのウェブサーバと、私たちがFriendFeedで頻繁に使用しているツールのうちのいくつかを含んだ、オープンソースバージョンです。このフレームワークはノンブロッキングで、適切な速さを備えているということで、主流となっている、ほとんどのウェブサーバフレームワーク(特に、ほとんどのPythonのフレームワーク)とは異なっています。速さの理由としては、ノンブロッキングで、なおかつe

  • 1