xzrのブックマーク - はてなブックマーク

Sphinxのバージョンアップ（Windows） - torutkのブログ
以前WindowsマシンにセットアップしたSphinxのバージョンアップメモです。 Sphinxでドキュメント生成（Windowsでの始め方） - torutkの日記 Sphinxでドキュメント生成-図を描く（Windowsでの始め方） - torutkの日記 Sphinxは、Pythonのモジュールとして作られています。インストールには、setup.py を使いましたが、バージョンアップに際して削除といった機能はないようです。そこで、いったん前のバージョンを削除し、新しいバージョンをインストールするという操作を行います。古いバージョンのアンインストール方法 setup.py でインストールした場合 Pythonのsite-packageディレクトリから削除する eggを使ってインストールした場合 site-packageディレクトリにある<モジュール名>-<バージョン>-.eggディ
xzr 2011/12/27
Sphinx

windows
リンク
Sphinxでドキュメント生成-PDF（Windowsでの始め方）（続） - torutkのブログ
昨日の日記の続きです。 Sphinxでドキュメント生成-PDF（Windowsでの始め方） - torutkの日記 Sphinxで、PDFを生成（rst2pdf）するためには、ドキュメント・プロジェクトをquickstartで作成する毎に、conf.pyの修正、make.batの修正、ja.jsonのコピーをする必要があります。ちょっと面倒ですね。そこで、quickstartでプロジェクトを作成するときに、デフォルトでPDFの設定を入れられるよういじってみました。 sphinx-quickstartで実行される処理はquickstart.py Sphinxをインストールすると、以下のディレクトリにSphinxのスクリプトが置かれます。 \Lib\site-packages\Sphinx-1.0.7-py2.6.egg/sphinx/ quickstart.py そこで、このquickst
xzr 2011/12/27
Sphinx

Windows
リンク
Sphinxでドキュメント生成-PDF（Windowsでの始め方） - torutkのブログ
昨日の日記の続きです。 Sphinxでドキュメント生成（Windowsでの始め方） - torutkの日記今日は、SphinxでPDF形式のドキュメント生成を行います。PDF形式に出力するには、TeX経由で行う方法とSphinxのrst2pdf拡張で行う方法があるようです。 SphinxでPDFファイル作成 — Python製ドキュメンテーションビルダー、Sphinxの日本ユーザ会(Sphinx日本ユーザー会ドキュメントより）上記ドキュメントの比較によると、rst2pdfがよさそうなので、これを使ってPDF出力の仕組みをWindowsに整えます。なお、昨日同様、インターネットに接続していないPCでも環境を整えられるよう、必要なものをダウンロードしインストールします。 Windows上でrst2pdfを用意する PythonのReportLab Toolkitモジュール rst2pdfが
xzr 2011/06/15
Sphinx
リンク
Sphinxでドキュメント生成（Windowsでの始め方） - torutkのブログ
プログラミング関連でドキュメントを作成する場合、章節構成を持つ文章を書き、随所に箇条書き、図表、ソースコードや画面をちりばめることが多いです。また、文書の書式は、HTMLやPDFなど複数の形式で出せると便利です。 Smartdoc、docbookが候補に挙がりますが、両者ともXML文書形式で記述するので、ソース文書作成が慣れないと手間ですし、慣れてもXMLタグ混じりの文章は見やすいものではありません。 Wikiは、ドキュメントを配布する、というときには不向きですし、文書作成がブラウザ上、というのも苦痛です。また、Wikiのサーバーがないところで原稿作成もできません。そんなとき、Sphinxと呼ばれるツールの存在を知りました。 http://sphinx-users.jp/ ざっと見ると、reStructuredTextと呼ばれるテキスト形式で文書を記述し、コマンドでHTMLを生成するもの
xzr 2011/06/15
Sphinx
リンク
1