Является ли Sphinx лучше, чем LaTex, при написании руководств/книг?

Только несколько человек рекомендовали использовать Sphinx в начале года.

Недавно Sphinx развился довольно быстро. Сегодня я отметил, что Sage внесла изменения в прямое редактирование с LaTex до Sphinx. Это видно в ответ Уильяма Штейна 2 апреля о учебнике Sage

Учебник больше не является латексным документом. Это полностью другой документ Sphinx, который может выводить pdf.

Это говорит о том, что Сфинкс может быть на таком уровне, который подходит мне.

Является ли Sphinx лучше, чем LaTex, при написании руководств/книг?

Ответ 1

Мы написали книгу со сфинксом, но нам пришлось подстроить файл tex, созданный с помощью Python script.

Взгляните на thread в разделе инструмента для создания книг

Вот некоторые изменения, внесенные нами в исходный файл LaTeX:

documentclass= 'book'
добавлена основная масса, материнство и обратное воздействие.
добавлен новый стиль в fncychap.sty
индекс двух столбцов вместо одного столбца
некоторые изменения в заголовке страницы
все черное и белое
- ссылки
- заголовки
- изображения (с помощью imagemagick для преобразования изображений в оттенках серого)
подсказки и заметки, отображаемые в более удобном поле со значком
лучше разместить float на страницах для оптимизации используемого пространства

Мы также внесли незначительные изменения в book.cls и sphinx.sty

При всех этих настройках мы очень довольны результатом.

Ответ 2

Хорошо, есть хотя бы одна книга, напечатанная с использованием sphinx и rst2pdf

Некоторые примеры документов, сгенерированных с помощью sphinx и rst2pdf здесь:

http://freedrive.com/folder/236385

И здесь:

http://freedrive.com/folder/236380

Специально проверьте ссылку на библиотеку python и книгу django.

Это выводится из ветки разработки и имеет ошибки (например, TOC часто находится на неправильной стороне страницы), которые фиксируются.

Ответ 3

Я предпочитаю Sphinx to Latex для написания руководств по двум причинам:

С минимальными усилиями вы можете создавать хорошие HTML, PDF, htmlhelp и qthelp версии руководства.
Синтаксис reST быстрее записывается, и мне легче запомнить (это проще)

Однако книга может быть другой. Если бы я хотел написать книгу, в которой есть только печатная версия и версия в формате pdf, а также содержит уравнения и цитаты, я бы пошел с Latex, потому что я думаю, что он намного более зрелый, чем reST, и мне легко настроить его.

Btw. У меня гораздо больше опыта использования латекса.

Ответ 4

Это лучше для создания справочной документации, а не для написания книг.

Ответ 5

Является ли Word лучшим инструментом для создания документов?

LaTeX (и TeX) были дольше, чем большинство из нас понимают, что существуют программы для такого рода вещей, и мы их интересовали. LaTeX почти наверняка лучше, чем Sphinx (или Word).

Это лучше для вас? Может быть.
Это лучше для меня? Вряд ли.
Это лучше для обычного человека? Определите "среднее", затем перейдите к пункту 1.