執筆中のPythonプロフェッショナルプログラミング第2版でsphinxを使っている話
システム開発や保守、運用の現場においてドキュメントは必須のものです。 しかし、ドキュメントの作成・維持には多くのパワーがかかるため、ドキュ メントが存在しない、資料が古いままになっているなどといった現状を多く 耳にします。 本勉強会ではこれらのドキュメントでよく利用される「図」にフォーカスし、 みるみるうちに図を作成できる「blockdiag」をご紹介します。 「blockdiag」はシンプルなテキスト記述からブロック図、ネットワーク図などの 画像ファイルを出力可能なオープンソースの画像生成ツールです。書き やすさ、メンテナンスしやすさを中心にデザインされており、図を作るのに 配置や並べ替えに苦労する必要はありません。 blockdiagのサンプルはこちら このような特徴を持つ「blockdiag」と、シンプルな記述でドキュメントを作成 するツール「Sphinx」を組み合わせることによって
SphinxをMarkdownで使い隊
Sphinxを、MercurialとPandocを組み合わせて Markdown記法で運用できるようにしたお話。
Sphinx ではじめるドキュメント生活 2012 #pyconjp #sphinxconjp
わかる！metadata.managedFields / Kubernetes Meetup Tokyo 48
虎猫飯店 - ざれごと : #qpstudy 06 に行ってきた事。 by togakushi
前回の記事が qpstudy 05 の話か。。。最近140文字未満しか書かなくなったなｗ 今回も LT してきました。 他の人のを全部書くとスゴイことになるので割愛。 ところどころ記憶も曖昧だし。 お題は最近どっぷりハマっている Sphinx について。 「ドキュメント書くのが好きな人」って聞いてみたら誰も手を上げなくて、 「じゃあ、キライな人」って聞いたらほぼ全員が手を上げたのはビックリしたｗ 自分はドキュメント書くの好きですよ。 Sphinx で書いていいなら。 Office とかはキライですが。 何人かの方には興味持ってもらえたし、「Sphinxイイネ！」って声もたくさん聞けたので超満足。 発表資料はコチラこれも Sphinx(要テーマ拡張) で書いてます。JavaScript 有効にして見てね。 相変わらず祭りの qpstudy マジ愛してる。 そしてニフティさんマジ
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
