Является ли 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.