Sphinx で日本語を含む PDF 出力をする - 憧れ駆動開発
PDF を納める必要があったのでやった。Sphinx というか reST での日本語出力には若干の難があるらしい。けど、これも先人のとおりにやったら簡単にできた。 rst2pdf 方式 (8日目) Sphinx から PDF を生成してみよう (rst2pdf 編) - Hack like a rolling stone をまず参考にやってみた。pip install rst2pdf, PIL 環境構築, VLゴシックのようなフォントをいれる。 ja.json を作成して読み込ませる。PIL 環境の構築はハマりやすいから http://atasatamatara.hatenablog.jp/entry/20120803/1344001904 を参考にするといい。 結果としてはうまくいかなかった。後述の日本語のなんらかのパッチのはいった Sphinx だったらできたかもしれないけど、一部が文
sphinxで Wordファイル(docx)出力する．(Windows)
ここ最近，sphinx で仕様書などを書いて，HTML/epub で出力，内容確認． ブラウザで見たほうが軽く動かせたり，閲覧する環境を変えることで見落としていた考え方が浮かんできたりするので，多様な方法で文章を精査する方法を好んでます．なので最近はスマートフォンやタブレット上でepub 閲覧が多いというスタイルです． その後，内容がだいたいOKなら，latex 出力して，PDF変換して，チーム内回覧という使い方をしてました．が，結局，今いる職場は，非IT技術者の方ばかりなので，追記できるようにword/excel でよこせと言われるわけです． そのため，その度にPDFから文章コピペ，word に貼りつけ・整形としていたわけですがやはり非効率． もう少しいい方法ないかなぁと思いつつ，文章を書くという割りと面倒な作業の敷居を低くしてくれるsphinx を使用していたわけですが，twitter
ドキュメンテーションを加速するストレスフリーの作図ツール『blockdiag』 jus2011年6月勉強会
システム開発や保守、運用の現場においてドキュメントは必須のものです。 しかし、ドキュメントの作成・維持には多くのパワーがかかるため、ドキュ メントが存在しない、資料が古いままになっているなどといった現状を多く 耳にします。 本勉強会ではこれらのドキュメントでよく利用される「図」にフォーカスし、 みるみるうちに図を作成できる「blockdiag」をご紹介します。 「blockdiag」はシンプルなテキスト記述からブロック図、ネットワーク図などの 画像ファイルを出力可能なオープンソースの画像生成ツールです。書き やすさ、メンテナンスしやすさを中心にデザインされており、図を作るのに 配置や並べ替えに苦労する必要はありません。 blockdiagのサンプルはこちら このような特徴を持つ「blockdiag」と、シンプルな記述でドキュメントを作成 するツール「Sphinx」を組み合わせることによって
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
Has anyone used Sphinx to document a C++ project?
sphinx + blockdiag で始めるドキュメント生活 2011/05 yokohama.pm
ひとりsphinx
