Documentation 3D

[maurice]

Bonjour,
J'ai trouvé un truc (utile et sympa ?) ici en bas de page.

Tous les commentaires seront les bienvenus !
Soyez indulgent avec l'auteur qui n' a pas encore soufflé sa première bougie d'asymptote mais sur qu'il doit y avoir des imprécisions et qu'il doit rester pas mal de coquilles malgré de nombreuses relectures.

Maurice alias Bruno (ou le contraire je ne sais plus).

[GMaths]

Qui a dit qu'il n'y avait pas de doc sur Asymptote ? C'est une pluie de docs en ce moment.

Bravo Bruno !

J'ai survolé très rapidement, ri à la lecture de certains passages...
... et j'étudierai cela de plus près aux prochaines vacances.

Encore bravo et merci de nous faciliter l'aide à ceux qui débutent.

[Romain Janvier]

Merci beaucoup pour ce document qui a l'air très complet. Je vais justement refaire mes figures de 3e, donc ca tombe bien. Je pensais les faire en "2D" en trichant un peu, mais peut-etre qu'avec ta doc je vais les faire en vraie 3D. Et il faut que je creuse la possibilité d'inclure une figure interactive, parce que ca le fait pas mal.

Sinon, il me semble que Fedora ne prends pas d'accent, meme en francais. Et j'ai vu que tu utilisais la version rawhide de asymptote. Elle est vraiment stable ? Parce que deja que j'utilise deja texlive 2010 avec le depot special, donc je me demande si ca vaut le coup de prendre la derniere version de asymptote.

[Francky]

Énorme :clapping: :yikes:

[rebouxo]

Super. Le document est une torture pour les imprimantes... Un document indispensable pour commencer avec Asymptote.

Une c'htite coquille page 12, juste en dessous du premier encadré :
le fichier .pdf .... peut alors être manipulé. Sans e
page 37, première ligne : Il manque un mot : ... pour les paths ont des versions. Segments est-il bien choisi ? En fait c'est bien choisi, puisque l'on dit segment de droite, c'est qu'il y a des segments d'autres choses. J'ai de plus l'impression qu'il y a une petite différence entre nœud et point.
J'aurais bien mis les mots anglais en italique (et je pense que je les aurais traduits, mais bon on n'est pas obligé de penser comme moi).
Olivier

[chellier]

Et dire que quand je t'ai proposé de faire la partie 3D tu m'as dit que tu n'y connaissais pas grand chose ! Bravo, super boulot, super documentation :D

Christophe

[maurice]

Bonsoir, et merci pour ces premières réactions !

Super. Le document est une torture pour les imprimantes...

sans doute, j'ai testé une fois au lycée, ça a pris du temps ...
Ce n'est pas forcément fait pour ...

Une c'htite coquille page 12, juste en dessous du premier encadré :
le fichier .pdf .... peut alors être manipulé. Sans e
page 37, première ligne : Il manque un mot : ... pour les paths ont des versions.

Sinon, il me semble que Fedora ne prends pas d'accent, meme en francais.

Tout cela sera corrigé dans la version 1.01 prochainement ...
S'il y a d'autres coquilles du même ordre n'hésitez pas ...

J'aurais bien mis les mots anglais en italique (et je pense que je les aurais traduits, mais bon on n'est pas obligé de penser comme moi).
Olivier

Normalement, les mots du langage (comme path) aurait du être en gras mais là j'ai oublié (j'ai utilisé \lstinline{ } de listings). Utiliser les mots du langage en anglais ou les traduire, c'est une question que je me suis posé tout au long de la rédaction. Mettre des mots en anglais dans une doc en français, c'est vrai que c'est pas très joli mais si ce sont des commandes je ne vois pas comment faire (comment traduire zaxis3 ou ylimits lorsque l'on parle de la commande ?). J'aurais pu mettre "pour le type path" ou du genre ...

Et j'ai vu que tu utilisais la version rawhide de asymptote. Elle est vraiment stable ? Parce que deja que j'utilise deja texlive 2010 avec le depot special, donc je me demande si ca vaut le coup de prendre la derniere version de asymptote.

Je n'utilise pas la version rawhide d'asymptote :

Code : Tout sélectionner

$ yum list asymptote
Modules complémentaires chargés : presto, refresh-packagekit
Paquets disponibles
asymptote.x86_64                       2.04-1.fc14                        fedora

$ yum --enablerepo=rawhide list asymptote
Modules complémentaires chargés : presto, refresh-packagekit
Paquets disponibles
asymptote.x86_64                       2.04-1.fc15                       rawhide

Comme tu peux le voir elle n'a rien d'instable et date même un peu en ce moment. C'est en général, la dernière version stable qui est là la 2.08 ne devrait pas tarder à être dans le dépot rawhide).
En réalité, je compile les sources (en ce moment 2.08) ; ca me permet d'avoir une version plus récente et d'avoir pu installer texlive 2010 avec le DVD.
Regarde dans quelques semaines, cela devrait être actualisé dans rawhide.
Après je ne crois pas que ça ait jamais posé trop de problèmes de prendre la dernière version (même svn).

Et dire que quand je t'ai proposé de faire la partie 3D tu m'as dit que tu n'y connaissais pas grand chose !

C'était vrai mais une fois qu'on a mis les mains dans le cambouis, c'est difficile de s'en passer.
Merci encore pour ton aide.

maurice

[MB]

Superbe document, bravo pour le travail !

[GMaths]

Le document est une torture pour les imprimantes...

Certaines couleurs trop foncées devront peut-être être changées pour la version "light" ou "pale". Et, ce ne sera peut-être pas suffisant : un éclairage modifié de certaines figures pourra permettre aussi de tendre vers des couleurs moins sombres, qui nécessiteront moins d'encre.

[rebouxo]

Bonsoir, et merci pour ces premières réactions !

Super. Le document est une torture pour les imprimantes...

sans doute, j'ai testé une fois au lycée, ça a pris du temps ...
Ce n'est pas forcément fait pour ...

Ben alors pourquoi avoir fait un document A4 ?
Mais moi, je suis pas un fan des docs en ligne. Les wikis de Ph. Ivaldi ou de Gaëtan sont très bien sauf qu'ils manquent trop d'explications pour le néophyte que je suis. Ils sont certainement utiles quand tu possèdes les bases du langage. De plus, j'apprends beaucoup mieux (et il paraît que je ne suis pas le seul dans ce cas là) avec un document externe à l'ordi. C'est beaucoup plus pratique pour faire l'aller retour entre ton code et la référence, que de changer de fenêtre.

Bravo à tous pour tout ce travail sur asymptote.

[GMaths]

Mais moi, je suis pas un fan des docs en ligne. Les wikis de Ph. Ivaldi ou de Gaëtan sont très bien sauf qu'ils manquent trop d'explications pour le néophyte que je suis. Ils sont certainement utiles quand tu possèdes les bases du langage. De plus, j'apprends beaucoup mieux (et il paraît que je ne suis pas le seul dans ce cas là) avec un document externe à l'ordi. C'est beaucoup plus pratique pour faire l'aller retour entre ton code et la référence, que de changer de fenêtre.

Dans la même minute, j'ai lancé un sujet totalement à l'opposé.
Les goûts et les couleurs...

[chellier]

De plus, j'apprends beaucoup mieux (et il paraît que je ne suis pas le seul dans ce cas là) avec un document externe à l'ordi. C'est beaucoup plus pratique pour faire l'aller retour entre ton code et la référence, que de changer de fenêtre.

Je suis tout à fait d'accord avec toi, je trouve ça beaucoup plus pratique aussi !

Christophe

[OG]

Bonjour

Félicitations. En peu de temps deux doc sur Asymptote, ça bouge.
Pas encore le temps de lire les deux doc par contre.

Question format, etc, l'idéal est d'avoir les deux (une html, une pdf) comme celle officielle d'asymptote écrite en texinfo. La contrepartie est une présentation pdf sans chichi qui peut rendre certains ronchonchons.

Pour le message de Gaëtan, je me rappelle avoir eu une discussion avec Philippe là dessus. Écrire le code et à l'intérieur la description des routines. Cela permet de naviguer à travers le code source ou presque. C'est complémentaire d'une documentation où on explique plus en détails avec comme c'est un logiciel graphique des illustrations.

O.G.

[rebouxo]

Mais moi, je suis pas un fan des docs en ligne. Les wikis de Ph. Ivaldi ou de Gaëtan sont très bien sauf qu'ils manquent trop d'explications pour le néophyte que je suis. Ils sont certainement utiles quand tu possèdes les bases du langage. De plus, j'apprends beaucoup mieux (et il paraît que je ne suis pas le seul dans ce cas là) avec un document externe à l'ordi. C'est beaucoup plus pratique pour faire l'aller retour entre ton code et la référence, que de changer de fenêtre.

Dans la même minute, j'ai lancé un sujet totalement à l'opposé.
Les goûts et les couleurs...

:D
Par contre je ne vois pas trop ce que tu cherches à faire.

Olivier

[maurice]

Bonjour,

Le document est une torture pour les imprimantes...

Certaines couleurs trop foncées devront peut-être être changées pour la version "light" ou "pale". Et, ce ne sera peut-être pas suffisant : un éclairage modifié de certaines figures pourra permettre aussi de tendre vers des couleurs moins sombres, qui nécessiteront moins d'encre.

C'est quelque chose auquel je n'ai pas pensé. J'ai arrêté d'imprimer les doc, il y a déjà quelque temps...
Néanmoins, que faudrait-il pour que cette doc soit plus digeste pour l'imprimante ?
Une doc en noir et blanc ?
Merci de vos avis.

Par ailleurs, j'ai déjà corrigé pas mal de boulettes, une version devrait être mis sur le site la semaine prochaine.

Bon week end.
Maurice

[GMaths]

Néanmoins, que faudrait-il pour que cette doc soit plus digeste pour l'imprimante ?
Une doc en noir et blanc ?

Non, comme je l'ai dit : des couleurs pastelles. C'est ce qui nécessitera le moins d'encre... puisqu'elles sont obtenues en laissant des points blancs entre les points de couleurs : sauf pour des imprimantes qui ajoutent une ou deux cartouches de couleurs pastelles en plus des trois couleurs primaires (de la méthodes soustractive), pour un meilleur rendu.

Je suppose que quand tu disais "en noir et blanc", tu pensais à des nuances de gris pour colorer les surfaces. Cela consommera beaucoup de noir alors... ce n'est pas mieux, il me semble.
Il y aura toujours la possibilité d'imprimer en nuances de gris... et des couleurs seront plus agréables à l'écran.

[chellier]

Non, comme je l'ai dit : des couleurs pastelles. C'est ce qui nécessitera le moins d'encre...

Oui, mais ça risque d'être un peu moins beau non, même si les goûts et les couleurs...

Sinon pour ceux qui veulent imprimer, ne suffit-il pas d'imprimer en mode "économie", ou en core en niveaux de gris ?

Christophe

[GMaths]

en niveaux de gris ?

L'image précédente en niveau de gris va donner du ... noir ?
Je crois vraiment que le bleu doit-être plus clair et l'éclairage tel que le contraste soit moins fort... sinon je crains fort que l'impression en niveaux de gris sera décevante.

[chellier]

L'image précédente en niveau de gris va donner du ... noir ?

Oui, en effet... :)
Il reste le mode économie, ou brouillon. Mais revoir toutes les figures de la doc pour changer les couleurs, c'est encore un sacré boulot pour Maurice

Christophe

[rebouxo]

J'ai imprimé la doc sur une imprimante laser (en faite le photocopieur de mon lycée). Le rendu des images n'est pas mon principal soucis je dois dire. J'ai juste constaté que c'était très long (bon c'est une vieillerie l'ordi ) et j'ai du recommencé à partir de la page 37...
Ce qui m'intéresse c'est plutôt le texte que les images ne soient pas très lisibles une fois imprimées ne me pose aucun problème.

Olivier