¿Es Sphinx mejor que LaTex al escribir manuales/libros?

Question

Solo a few people recommended para usar Sphinx a principios de año.

Sphinx se ha desarrollado bastante rápido recientemente. Noté hoy que Sage ha cambiado la edición directa de LaTex a Sphinx. Esto es evidente en William Stein's answer el 2 de abril sobre el tutorial de Sage

El tutorial ya no es un documento de látex. Es un documento totalmente diferente de Sphinx que puede generar PDF.

Me sugiere que Sphinx puede estar en un nivel tal que sea adecuado para mí.

¿Es Sphinx mejor que LaTex en la escritura de manuales/libros?

Answer 1

Nos escribió un libro con esfinge pero tuvimos que modificar el archivo tex producido con un script en Python.

Tome un vistazo a este thread, en la herramienta de construcción de libro sección

Aquí un algunos cambios que hemos hecho en el fichero LaTeX Original:

• documentclass = 'libro'
• añadido frontmatter, mainmatter y Backmatter
• añade un nuevo estilo a fncychap.sty
• índice de dos columnas en lugar de uno columnas
• algunos cambios en el encabezado de la página
• todo es negro & blancos
  • enlaces
  • títulos
  • imágenes (usando imagemagick para convertir las imágenes en escala de grises)
• consejos y notas que aparecen en un cuadro más agradable con el icono
• mejor colocación en las páginas de flotación para optimizar el espacio utilizado

También hicimos cambios menores a book.cls y sphinx.sty

Con todos estos ajustes, estamos muy contentos con el resultado.

Answer 2

Es mejor para crear documentación de referencia, no para escribir libros.

Answer 3

¿Es Word una mejor herramienta de producción de documentos?

LaTeX (y TeX) han existido por más tiempo que la mayoría de nosotros nos damos cuenta de que hay programas para hacer ese tipo de cosas y que estamos interesados ​​en ellas. LaTeX es casi seguro mejor que Sphinx (o Word).

1. ¿Es mejor para usted? Tal vez.

2. ¿Es mejor para mí? Improbable.

3. ¿Es mejor para una persona normal? Definir el 'medio' y luego vaya al punto 1.

Answer 4

Bueno, no se imprime al menos un libro utilizando la esfinge y rst2pdf

Algunos ejemplos de documentos generados a través de la esfinge y rst2pdf aquí:

http://freedrive.com/folder/236385

Y aquí:

http://freedrive.com/folder/236380

Compruebe especialmente la referencia de la biblioteca python y el libro django.

Esto se emite desde la rama de desarrollo y tiene errores (por ejemplo, el TOC suele estar en el lado equivocado de la página) que se están reparando.

Answer 5

prefiero Esfinge de látex para escribir manuales por dos razones:

1. Usted puede construir buenas versiones en HTML, PDF, HTMLHelp y qthelp del manual con el mínimo esfuerzo.
2. sintaxis resto es más rápido para escribir y me resulta más fácil de recordar (es más sencilla)

Un libro, sin embargo, podría ser una historia diferente. Si quisiera escribir un libro que solo tiene una versión impresa y una versión en pdf y contiene ecuaciones y citas, me gustaría ir con Latex, porque creo que es mucho más maduro que reST y me resulta fácil de personalizar.

Btw. Tengo mucha más experiencia en el uso de Latex.