Sphinx est-il meilleur que LaTex pour écrire des manuels/livres?

Question

Seulement a few people recommended pour utiliser Sphinx au début de l'année.

Sphinx a développé assez rapidement ces derniers temps. J'ai noté aujourd'hui que Sage a fait un changement de l'édition directe avec LaTex à Sphinx. Ceci est évident dans William Stein's answer le 2 avril sur le tutoriel de Sage

Le tutoriel n'est plus un document latex. C'est un document Sphinx entièrement différent qui peut sortir le pdf.

Il me suggère que Sphinx peut être à un niveau tel qu'il me convient.

Est Sphinx mieux que LaTex dans les manuels d'écriture/livres?

Answer 1

Nous avons écrit un livre avec sphynx mais nous avons dû modifier le fichier tex produit avec un script Python.

Jetez un oeil à ce thread, dans l'outil de construction du livre section

Voici un quelques changements apportés au fichier LaTeX d'origine:

• documentclass 'livre' =
• ajouté frontmatter, mainmatter et backmatter
• a ajouté un nouveau style à fncychap.sty
• index deux colonnes au lieu d'une des colonnes
• quelques changements dans l'en-tête de la page
• tout est noir & blanc
  • liens
  • titres
  • images (en utilisant ImageMagick pour convertir les images en niveaux de gris)
• conseils et des notes affichées dans une boîte plus agréable avec l'icône
• meilleur placement flottant sur les pages afin d'optimiser l'espace utilisé

Nous avons également apporté des modifications mineures à book.cls et sphinx.sty

avec tous ces réglages, nous sommes très heureux du résultat.

Answer 2

Il est préférable pour la création de documents de référence, non pas pour écrire des livres.

Answer 3

Est-ce mot un meilleur document outil de production?LaTeX (et TeX) existent depuis plus longtemps que la plupart d'entre nous se rendent compte qu'il y avait des programmes pour faire ce genre de chose et que nous étions intéressés par eux. LaTeX est presque certainement meilleur que Sphinx (ou Word).

1. Est-ce que c'est mieux pour vous? Peut être.

2. Est-ce mieux pour moi? Improbable.

3. Est-il préférable pour la personne moyenne? Définir le terme 'moyen' puis passez au point 1.

Answer 4

Eh bien, il y a au moins un livre imprimé à l'aide sphynx et rst2pdf

Quelques exemples de documents générés par sphynx et rst2pdf ici:

http://freedrive.com/folder/236385

Et ici:

http://freedrive.com/folder/236380

Vérifiez particulièrement la référence de la bibliothèque python et le livre django.

Ceci est généré par la branche de développement et comporte des bogues (par exemple, la table des matières est souvent du mauvais côté de la page) qui sont en cours de correction.

Answer 5

Je préfère Sphinx au latex pour les manuels d'écriture pour deux raisons:

1. Vous pouvez construire de belles HTML, PDF, HTMLHelp et versions qthelp du manuel avec un minimum d'effort.
2. syntaxe est plus rapide reST à écrire et je trouve plus facile à retenir (il est plus facile)

Cependant, un livre, peut-être une autre histoire. Si je voulais écrire un livre qui n'a qu'une version imprimée et une version pdf et contient des équations et des citations j'irais avec Latex, parce que je pense qu'il est beaucoup plus mature que reST et je trouve qu'il est facile de personnaliser.

Btw. J'ai beaucoup plus d'expérience dans l'utilisation du latex.