16

年の初めに Sphinx の使用を推奨した人はごくわずかでした。

Sphinx は最近かなり急速に発展しました。私は今日、Sage が LaTex による直接編集から Sphinx への変更を行ったことに言及しました。これは、Sage のチュートリアルに関する 4 月 2 日の William Stein の回答で明らかです。

チュートリアルはもはやラテックス ドキュメントではありません。PDFを出力できる全く別のSphinxドキュメントです。

スフィンクスは私に相応しいレベルにあるのではないかと示唆している。

マニュアルや本を書く上で、Sphinx は LaTex より優れていますか?

4

5 に答える 5

13

私たちはsphinxで本を書きましたが、Python スクリプトで生成されたtexファイルを微調整する必要がありました。

ブック構築ツールセクションのこのスレッドを見てください。

元の LaTeX ファイルに加えたいくつかの変更を次に示します。

  • documentclass = '本'
  • frontmattermainmatterbackmatterを追加
  • fncychap.styに新しいスタイルを追加しました
  • 1 列ではなく 2 列のインデックス
  • ページヘッダーのいくつかの変更
  • すべてが白黒
    • リンク
    • タイトル
    • 画像 (imagemagick を使用して画像をグレースケールに変換)
  • アイコン付きのより良いボックスに表示されるヒントとメモ
  • 使用されるスペースを最適化するための、ページ上のフロート配置の改善

book.clssphinx.styにも小さな変更を加えました。

これらすべての調整により、結果に非常に満足しています。

于 2009-04-08T11:00:21.180 に答える
4

さて、sphinx と rst2pdf を使用して印刷された本が少なくとも 1 冊あります。

sphinx および rst2pdf を介して生成されたサンプル ドキュメントは次のとおりです。

http://freedrive.com/folder/236385

そしてここ:

http://freedrive.com/folder/236380

特に python ライブラリ リファレンスと django book を確認してください。

これは開発ブランチからの出力であり、修正中のバグ (たとえば、TOC がページの反対側にあることが多いなど) があります。

于 2009-09-10T16:42:17.343 に答える
3

2 つの理由から、マニュアルの作成には Latex よりも Sphinx を好みます。

  1. 最小限の労力で、HTML、PDF、htmlhelp、および qthelp バージョンのマニュアルを作成できます。
  2. reST 構文はより速く書くことができ、覚えやすいと思います (より単純です)。

ただし、本は別の話かもしれません。印刷版と PDF 版しかなく、方程式と引用を含む本を書きたい場合は、ReST よりもはるかに成熟しており、カスタマイズも簡単だと思うので、Latex を使用します。

ところで。私はラテックスの使用経験が豊富です。

于 2010-03-12T08:05:54.347 に答える
1

本を書くためではなく、参照ドキュメントを作成するために適しています。

于 2009-04-07T13:52:50.463 に答える
1

Word は優れた文書作成ツールですか?

LaTeX (および TeX) は、そのようなことを行うプログラムがあり、それらに興味を持っていたことにほとんどの人が気付くよりもずっと前から存在しています。LaTeX が Sphinx (または Word) より優れていることはほぼ間違いありません。

  1. それはあなたにとってより良いですか?多分。

  2. それは私にとってより良いですか?ありそうもない。

  3. 平均的な人にとっては良いですか?「平均」を定義してから、ポイント 1 に進みます。

于 2009-04-08T11:24:15.600 に答える