Our docsys-pyfes-2012-11
-
Upload
keiichirou-shikano -
Category
Travel
-
view
1.341 -
download
0
Transcript of Our docsys-pyfes-2012-11
![Page 1: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/1.jpg)
. . . . . .
おれたちが考えた最強の出版システム
Python Developers Festa 2012.11
鹿野桂一郎[email protected]
@golden_lucky
2012年11月24日
![Page 2: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/2.jpg)
. . . . . .
�� ��広告
![Page 3: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/3.jpg)
. . . . . .
「おれたち」のご紹介1. 同僚H
I ドキュメントシステムマニア(IdeoType)I diff主義者(docdiff)
2. 同僚CI ヘンシュウコウセイ・ニンジャ、スゴイ!I『脱オタクファッションガイド』『はじめてでも安心コスプレ入門』の仕掛人
3. 私I TeX芸人 5級I 本を手にしたら索引からチェック派
![Page 4: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/4.jpg)
. . . . . .
意見が一致するところ
「ソフトウェア業界の方法は出版業界にも使える」
![Page 5: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/5.jpg)
. . . . . .
レガシーな本の作り方
I 著者のデータ上の作業は編集者に渡す時点で打ち止めI 編集者のデータ上の作業は組版に渡す時点で打ち止めI 組版してから必要になった修正は組版担当者が泣く
![Page 6: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/6.jpg)
. . . . . .
難点
I「商品に近い形を見てからの手戻り」が絶望的に困難
I 紙に赤字とか無理I デグレッションの危険性大I 時間的制約
![Page 7: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/7.jpg)
. . . . . .
理想
I 紙に赤字を入れる以上の作業が最後の最後までできるべき
I いつ誰がどこを修正したのかが最後の最後まで透明であるべき
I 執筆の最中から最終形態を意識できるようにすべき
![Page 8: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/8.jpg)
. . . . . .
根底
![Page 9: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/9.jpg)
. . . . . .
結論
バージョン管理下の原稿から、直接、毎回コマンド一発で、「印刷所に入稿できるデータ」
が生成できるべき
![Page 10: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/10.jpg)
. . . . . .
現在
![Page 11: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/11.jpg)
. . . . . .
最近では珍しい話ではない
I オライリージャパンさんI 達人出版会さんI(ほかにもあったら教えてください)
![Page 12: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/12.jpg)
. . . . . .
FAQ
![Page 13: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/13.jpg)
. . . . . .
Q1.
reSTで書ける?
![Page 14: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/14.jpg)
. . . . . .
関連したよくある質問
I Wiki記法で本を書ける?I Markdownで本を書ける?I オレの作ったドキュメントシステムがある!
![Page 15: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/15.jpg)
. . . . . .
Short Answer
執筆にはいいと思います!まずは脳内をダンプすること
が優先です。
![Page 16: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/16.jpg)
. . . . . .
大切な話なので、もうちょっと掘り下げ。
![Page 17: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/17.jpg)
. . . . . .
ドキュメント形式には指向性がある
注意! この図は主観に基づいて大胆な簡略を施したものです
![Page 18: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/18.jpg)
. . . . . .
充実したツール、安直な逃げ道があるか(バスナンバーは高いか)
注意! この図は主観に基づいて大胆な簡略を施したものです
![Page 19: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/19.jpg)
. . . . . .
出力の仕様が硬いか、処理系は枯れているか(重版時も安心か)
注意! この図は主観に基づいて大胆な簡略を施したものです
![Page 20: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/20.jpg)
. . . . . .
過去に reSTを出版に使おうとして制約になってきたところ(Docutilsの制約?)
I 構造と出力に対する仕様の将来的な安定性の心配を払拭し、表現力を拡張するには、編集部にPythonハッカーが必要
I 日本語LaTeXでの組版には(まだ)不都合あり
I たとえばSphinxをそのまま出版システムに使いたいという提案が通るかは微妙。
![Page 21: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/21.jpg)
. . . . . .
reSTが適してると思われる最終出力
I Webが主なターゲットだけど紙も出したいドキュメント
I 定形の書類、冊子、マニュアルなどI 記述しやすいので、こういう用途には
Sphinxとか使って楽をしたい
![Page 22: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/22.jpg)
. . . . . .
Q2.
どんなファイル形式を使ってるの?
![Page 23: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/23.jpg)
. . . . . .
Short Answer
いろいろ。「HTMLっぽい何か」
または「翻訳の原書データ」で運用することが多い。
![Page 24: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/24.jpg)
. . . . . .
HTML、いいポジションじゃない?
注意! この図は主観に基づいて大胆な簡略を施したものです
![Page 25: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/25.jpg)
. . . . . .
HTMLっぽい何かの利点
I タグに属性を詰め込もうとせず、インデントを適切に設定してれば、人間の読み書きも楽。
I パーズしやすいので出版に耐えるLaTeXやEPUBへの変換が楽。
I 執筆データや翻訳の原書データからの変換も楽。
I アドホックに拡張してもバスナンバー高い。I CSSを用意しておけばブラウザで簡易レビューもできる。
![Page 26: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/26.jpg)
. . . . . .
Q3.
EPUBは?
![Page 27: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/27.jpg)
. . . . . .
Short Answer
対応中です。
![Page 28: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/28.jpg)
. . . . . .
�� ��広告
LATEXが原稿。Haskell+Gaucheで EPUB化、kindlegenしたmobiを入稿。
Miran Lipovaca著田中英行・村主崇行共訳2012年 10月 25日amazon.co.jpにて発売開始
![Page 29: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/29.jpg)
. . . . . .
心の叫び
「ワンソースマルチアウトプットなんて幻想だったんや!」
![Page 30: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/30.jpg)
. . . . . .
EPUB対応の課題
I デザイン(Kindle向けならまだいいけど……)
I 相互参照I 索引(全文検索があればなくてもいいわけがない)
I 参考文献I ソースからの完全自動生成
![Page 31: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/31.jpg)
. . . . . .
FAQおしまい
![Page 32: Our docsys-pyfes-2012-11](https://reader031.fdocuments.us/reader031/viewer/2022020306/558b3ddfd8b42a05058b46d8/html5/thumbnails/32.jpg)
. . . . . .
まとめ
I 紙本中心な編集者の視点でドキュメントシステムを模索し続けてたらこうなった(プレゼンのタイトルはブラフですよ?)
I 万能のドキュメント形式はないI 電子本へのチューンは粛々と進行中I TeX & LaTeXアドベントカレンダーで「生LaTeXを捨ててSphinxへ」みたいな記事が読みたい!