Dépot GitHub LaTeX

[Marting]

Hello,

J'ai un petit peu boss� aujourd'hui dessus. Je viens de cr�er un d�p�t
sur github pour y mettre les sources :
https://github.com/Framartin/Framabook-Eloquent-Javascript
Le contenu correspond � une version de la traduction de d�but juillet
(le LaTeX a �t� g�n�r� � partir du html de fr.eloquentjavascript ). La
mauvaise nouvelle c'est qu'il faudra reporter toutes les modifs faites
depuis � la main... :(
Vous verrez, la conversion de pandoc est *tr�s* imparfaite. Je me suis
d�j� occup� notamment de refaire les notes de bas de page (que pandoc
avait converti n'importe comment), et des caract�res ins�cables apr�s
"�" et avant "�" (� ne pas remplacer automatiquement parce qu'il ne faut
pas le faire dans le code JS inclus dans le bouquin). De plus, il faudra
adapter la maquette g�n�rique framabook � nos besoins.

Questions :
1) la coloration syntaxique laisse � d�sirer. J'ai l'impression qu'elle
est configur�e sur du java et non du JS.
2) la pr�sentation du code vous convient-elle ? num�rotation des lignes,
alin�a quand une m�me ligne est coup�e (les joies du A5 !), etc.

Si vous avez des interrogations, n'h�sitez pas !
Martin.

[Marting]

> 1) la coloration syntaxique laisse � d�sirer. J'ai l'impression qu'elle
> est configur�e sur du java et non du JS.

Oui c'est bien �a... listings ne supporte pas la coloration du
Javascript. J'ai trouv� une autre piste :
http://lenaherrmann.net/2010/05/20/javascript-syntax-highlighting-in-the-latex-listings-package

Martin.

[Maxime]

Bonsoir,

Je viens de regarder ton dépôt, et cela m'amène à diverses suggestions :

1) Refléchir à un classement des modifications du source LaTeX en plusieurs catégories, par exemple :

 a) les corrections de formatages LaTeX, qui n'ont pas d'impact sur la version interactive, par exemple en mettant un préfixe (latex) dans le message du commit :
"(latex) retouche des notes de bas de page aux chapitres 1,2 et 3"

 b) les reports des corrections que nous faisons pandark et moi dans le dépot de la version interactive :
"(report) correctifs du 10/09/2012 au 30/09/2012"

 c) les modifications "éditoriales" : orthographe, grammaire, typos, etc... qui devront être reportées dans l'autre sens, vers la version interactive, par exemple
"(edition) fautes d'orthographe des chapitres 4,5 et 6"

2) Il faut mettre en balance la quantité de travail entre :

 a) le fait de reporter à la main les modifications apportées à la version interactive dans le source LaTeX depuis le moment ou avez fait la conversion avec pandoc.

 b) relancer pandoc pour reprendre automatiquement ces mêmes modifications mais devoir reprendre à la main les corrections apportées au formatage LaTeX.

3) Au niveau du formatage du code javascript dans le pdf, est-il possible de séparer plus clairement les numéros de ligne du code lui-même, par exemple en encadrant le code et en laisant les numéros de ligne à l'extérieur du cadre, ou au contraire en 'grisant' la colonne contenant les numéros ?

Enfin, je n'oublie pas la question des images, il faudrait l'aide d'un graphiste, j'en ai contacté un qui cherchait à rendre service sur la mailing-list mozfr, sans réponse pour l'instant. Je n'oublie pas non plus la question de la console javascript sans récit.

Je ne cache pas que j'avais imaginé une solution à la fois plus automatique mais aussi plus longue à démarrer, à savoir convertir automatiquement le fichier source en LaTeX, mais je me range aux conseils de Christophe. Dans l'immédiat, j'ai repris la vérification du chapitre 7.

Maxime

[Martin G.]

Hello,

Pour le 1), je dis totalement oui ! C'est une très bonne idée, et ce sera effectivement plus que nécessaire pour s'y retrouver. Merci ! Je vais l'ajouter au descriptif du dépôt.
Pour le 2), à mon avis c'est juste pas trop possible de ré-automatiser la chose. Christophe était déjà passé après pandoc, et moi aussi. On sera beaucoup plus safe en reportant les modifs faites sur le dépôt principal de pandark, que de repasser derrière une nouvelle correction de pandoc.
Enfin, concernant le point 3, je ne suis pas assez compétant en LaTeX pour le faire. A mon avis, tout est possible, c'est juste une question de temps ;) Je vais voir directement avec Christophe.
Sur le fond, tu as raison, je ne suis pas non plus satisfait de cette présentation du code.
Merci pour le graphiste ! Il nous sera j'en suis sûr d'une grande utilité ! :)

A plus,
Martin.