タグ

2011年7月22日のブックマーク (5件)

  • layer8.sh

    This domain may be for sale!

  • Sphinxの歴史

    Sphinxを作っている, pocooというグループでは、さまざまなソフトウェアを提供していますが、その中に、 Werkzeug というウェブアプリケーションのフレームワークがあります。 Werkzeugのバージョン0.1では、品質の高いドキュメントを作るために、手書きでドキュメントが作成されましたが、とても大変だったそうです。そのため、バージョン0.2では、この2つの手法の良い所を組み合わせた方式を取り入れました。Werkzeugの0.2がリリースされたのが2008年の2月14日。その時に使われたツールを機能アップし、汎用的に使えるツールとして、2008年の3月21日に最初のバージョンがリリースされました。 Python標準のドキュメントツールに¶ その後は機能拡張されて、 Pythonの2.6以降のドキュメント (日語)を生成するためのツールとしても使われるようになり、それまで使われ

    Sphinxの歴史
  • Sphinxでドキュメントを生成する - rabbit2goのブログ

    最近、Sphinxを使ってドキュメントを書いている。元々、Wordのようにチマチマと自分で文字のレイアウトや装飾を指定するタイプは好きではなく、LaTeXのように「プレーンテキストで文章を書いて、コマンド一発で出力を生成。レイアウト等は一切お任せ」型のシステムが好きなので、Sphinxはまさに好みのタイプと言える。 Sphinxのメリットを自分なりにまとめると次のようになる。 文書はプレーンテキストへ書く。実際の出力形態はSphinxへお任せ。 別ファイルに用意しておいた画像ファイルも取り込める。 HTML形式だけではなく、PDF形式等での出力も可能。 blockdiagやseqdiagなど、テキストで書いたコマンドで図面を生成して取り込み可能。 Windowsでの導入方法については下記のエントリが詳しい。 Sphinxでドキュメント生成-図を描く(Windowsでの始め方) - toru

    Sphinxでドキュメントを生成する - rabbit2goのブログ
  • Sphinxをはじめよう

    Sphinxをはじめよう¶ Sphinxを使って、かんたんな書籍紹介のドキュメントを作っていきます。 Sphinxのインストール¶ SphinxはPythonで書かれているため、Sphinxのインストールにあたっては、Pythonのセットアップと、Sphinxのインストールの両方が必要になります。 プロジェクトの作成¶ Sphinxでドキュメントを作るには、まずはドキュメントのプロジェクトを作ります。 Ruby on Rails のScaffoldや、 Djangoプロジェクトと似ていて、コマンドラインから、いくつかの質問に答えるとできあがります。 このひな形の作成と、ドキュメントのツリー構造の説明を行っていきます。

  • 死ぬまでに一度は訪れたい世界の名所29ヶ所

    世界には様々な観光名所がありますが、中にはとても地球の風景とは思えないような驚くべき自然の神秘を目にすることができる場所や、人間の文化歴史を肌で感じることができるような美しい町並みなどが存在しています。以下に掲載するのは、そんな死ぬまでに一度は行ってみたい29ヶ所の世界の名所です。 Amazing Places Around The World You Need To Visit Before You Die 1.プレーケストーレン(ノルウェー) ノルウェーのフィヨルドにある、水面からの高さが約600mもある一枚岩。頂上がおよそ25メートル四方の正方形を成すことから、「演説台」を意味する「Preikestolen(英:Preachers Rock)」と呼ばれています。 2.青の洞窟(ギリシャ) 「青の洞窟」と呼ばれる名所は、イタリアのカプリ島のものが特に有名ですが、世界各地に同じような洞

    死ぬまでに一度は訪れたい世界の名所29ヶ所