github pages に Sphinx で生成したドキュメントを公開する。 - kuma8の雑記帳
Github Pages にSphinxで生成したドキュメントを公開するほうほうです。 Github Pages では各リポジトリごとにプロジェクトページを作成することができます。 各プロジェクトごとにページを作成することでマニュアルなどの公開が便利にできます。 Sphinx で生成したドキュメントをそのまま公開すると、スタイルシートなど静的ファイルへのリンクが切れてしまいます。 静的ファイルは、ルートからのパスを想定しているためです。 html 生成時にリンクを修正してくれるプラグインが公開されています。 sphinxtogithub を利用すると、 Github Pages 用のリンクに修正してくれます。 利用方法 1. sphinxtogithub をインストールする。 $ easy_install -ZU sphinxtogithub2. conf.py で、プラグインを有効にする
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
Sphinxの国際化機能を使って複数言語用ドキュメントを用意する方法（概要） - 2011-05-31 - ククログ
YARDのことの続きを書きたいと思いつつもなかなか辿りつきません。今回はPython製のドキュメントツールSphinxの話です。groongaのケースを例にしてSphinxで複数言語用のドキュメントを生成する方法の概要を紹介します。書いていたら長くなったので、具体的にどうするかというのは次の機会にします。 5/29にgroonga 1.2.2がリリースされました。今後は日本だけではなく世界でも使ってもらえるように、英語でも情報を発信していく方向になりました。そこで、今回のリリースに合わせてサイトデザインをリニューアルし、英語のページも用意しました。ただし、すでにあった日本語のコンテンツを今回のリリースで全部英語にした、というものではありません。今回のリリースでやったのは「日本語と英語という複数の言語で情報を発信する仕組み」を作るところまでです。せっかくなので、今回のリリースで導入した、Sp
Overview — Sphinx v1.0.7 documentation
Sphinx makes it easy to create intelligent and beautiful documentation. Here are some of Sphinx’s major features: Output formats: HTML (including Windows HTML Help), LaTeX (for printable PDF versions), ePub, Texinfo, manual pages, plain text Extensive cross-references: semantic markup and automatic links for functions, classes, citations, glossary terms and similar pieces of information Hierarchic
Welcome — Sphinx documentation
Sphinx makes it easy to create intelligent and beautiful documentation. Here are some of Sphinx’s major features: Output formats: HTML (including Windows HTML Help), LaTeX (for printable PDF versions), ePub, Texinfo, manual pages, plain text Extensive cross-references: semantic markup and automatic links for functions, classes, citations, glossary terms and similar pieces of information Hierarchic
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
Sphinxjp.themes.s6 を使ってプレゼンする — docs v0.1 documentation
rst2pdf拡張を使ったPDFファイル作成 — Python製ドキュメンテーションビルダー、Sphinxの日本ユーザ会
Welcome — Sphinx documentation
Jinja — Jinja Documentation (3.1.x)