Une doc pour débuter

Tout ce qui concerne l'utilisation ou l'installation d'Asymptote.

Modérateur: gdm_asy

Règles du forum
Merci d'éviter le style SMS dans vos messages et de penser à utiliser la fonction Recherche avant de poster un message. Pour joindre des fichiers à vos messages, consulter ce sujet.
> Penser à utiliser les balises Code pour poster du code.

Une doc pour débuter

Messagepar chellier » Vendredi 26 Novembre 2010, 21:40

Bonjour,

J'ai commencé à écrire une documentation pour débutants (notamment pour essayer de convertir quelques collègues). C'est très incomplet et c'est vraiment pour débuter (sauf peut-être les annexes).
Il y a un grand absent : la 3D. C'est prévu, mais devant l'ampleur du boulot, je fais une pause. Alors, plutôt que ce document moisisse plusieurs mois (années :roll: :?: ) dans mon disque dur, je l'ai mis en ligne ici.

Voilà, j'espère que je n'ai pas écrit trop de bêtises, si c'est le cas, j'accepte toutes les remarques :wink:

Christophe

PS : OG reconnais-tu la coloration syntaxique ?
chellier
Modérateur
 
Messages: 355
Inscription: Samedi 25 Juillet 2009, 11:25
Localisation: Le Creusot
Statut actuel: Actif et salarié | Enseignant

Publicité

Re: Une doc pour débuter

Messagepar OG » Vendredi 26 Novembre 2010, 21:53

chellier a écrit:
PS : OG reconnais-tu la coloration syntaxique ?


Oui, c'est pygments !

Bravo pour la doc. Je lirai plus tard...

O.G.
OG
Modérateur
 
Messages: 2285
Inscription: Lundi 12 Mars 2007, 11:20
Localisation: Rouen
Statut actuel: Actif et salarié | Maître de conférence

Re: Une doc pour débuter

Messagepar Arnaud » Vendredi 26 Novembre 2010, 22:03

Merci pour la doc, elle va me servir.
J'aime beaucoup la présentation des exemples ( que je n'ai pas lus en détail pour le moment ... )

J'ai cependant deux remarques :

- peut-être que je suis trop dépendant à la commande man, mais je trouve que les options de la commande asy méritent un peu plus d'espacements.
- je n'ai rien trouvé dans la doc de latexmk à propos de ta remarque "il faut une installation suffisamment récente de perl". Tu pourrais nous donner une indication en précisant ta version actuelle ?
Arnaud

Un peu d'info - Pyromaths
LaTeX - Exemples de formules LaTeX

Pas d'aide en MP (non plus)
Arnaud
Modérateur
 
Messages: 7115
Inscription: Lundi 28 Août 2006, 12:18
Localisation: Allemagne
Statut actuel: Actif et salarié | Enseignant

Re: Une doc pour débuter

Messagepar OG » Vendredi 26 Novembre 2010, 22:12

Arnaud a écrit:- je n'ai rien trouvé dans la doc de latexmk à propos de ta remarque "il faut une installation suffisamment récente de perl". Tu pourrais nous donner une indication en précisant ta version actuelle ?


J'ai survolé rapidement latexmk (install, readme, le code). Mis à part une allusion à Windows et la version 5.18 et Solaris v 5.05, pas grand chose sur la version de perl.
Par contre il faut une version récente de latexmk pour prendre en compte asymptote. Une distribution linux de 1 an ne contient pas la bonne version je pense.

O.G.
OG
Modérateur
 
Messages: 2285
Inscription: Lundi 12 Mars 2007, 11:20
Localisation: Rouen
Statut actuel: Actif et salarié | Maître de conférence

Re: Une doc pour débuter

Messagepar Arnaud » Vendredi 26 Novembre 2010, 22:15

Code: Tout sélectionner
22:16 arnaud@centre ~% dpkg -l | grep latexmk       
ii  latexmk                                       1:4.13a-1                            Perl script for running LaTeX the correct number of times


C'est bon ?
Arnaud

Un peu d'info - Pyromaths
LaTeX - Exemples de formules LaTeX

Pas d'aide en MP (non plus)
Arnaud
Modérateur
 
Messages: 7115
Inscription: Lundi 28 Août 2006, 12:18
Localisation: Allemagne
Statut actuel: Actif et salarié | Enseignant

Re: Une doc pour débuter

Messagepar chellier » Vendredi 26 Novembre 2010, 22:17

Arnaud a écrit:Merci pour la doc, elle va me servir.
J'aime beaucoup la présentation des exemples ( que je n'ai pas lus en détail pour le moment ... )

Merci
Arnaud a écrit:J'ai cependant deux remarques :

- peut-être que je suis trop dépendant à la commande man, mais je trouve que les options de la commande asy méritent un peu plus d'espacements

Oui, c'est vrai, faudra que j'aère tout ça !

Arnaud a écrit:- je n'ai rien trouvé dans la doc de latexmk à propos de ta remarque "il faut une installation suffisamment récente de perl". Tu pourrais nous donner une indication en précisant ta version actuelle ?

C'est la v5.10.1, celle des dépôts d'Ubuntu 10.04. Il me semble juste que quelqu'un avait eu un problème avec une version trop ancienne (mais je ne me rappelle plus où j'ai vu ça), mais j'ai peut-être confondu avec latexmk :( .

Sinon la coloration c'est bien celle de pygments (faite par OG faut-il le rappeler ? :wink: )

Christophe
chellier
Modérateur
 
Messages: 355
Inscription: Samedi 25 Juillet 2009, 11:25
Localisation: Le Creusot
Statut actuel: Actif et salarié | Enseignant

Re: Une doc pour débuter

Messagepar Arnaud » Vendredi 26 Novembre 2010, 22:26

chellier a écrit:C'est la v5.10.1


Ok, c'est bon pour moi alors ;)
Arnaud

Un peu d'info - Pyromaths
LaTeX - Exemples de formules LaTeX

Pas d'aide en MP (non plus)
Arnaud
Modérateur
 
Messages: 7115
Inscription: Lundi 28 Août 2006, 12:18
Localisation: Allemagne
Statut actuel: Actif et salarié | Enseignant

Re: Une doc pour débuter

Messagepar maurice » Vendredi 26 Novembre 2010, 22:38

Salut Christophe,
Bravo pour tes exemples !
A plus
Maurice
Asymptote :
----> Démarrage rapide : http://cgmaths.fr/Atelier/Asymptote/Asymptote.html
----> Documentation 3D : http://www.mathco.tuxfamily.org et si ça ne marche pas, essayez la version pdf
maurice
Méga-utilisateur
 
Messages: 399
Inscription: Jeudi 25 Mars 2010, 13:49
Statut actuel: Actif et salarié | Enseignant

Re: Une doc pour débuter

Messagepar OG » Vendredi 26 Novembre 2010, 22:41

Re

Merci d'utiliser pygments et le lexer asymptote. Tu dois être le seul mis à part moi (le temps de le faire). Il y aurait d'ailleurs des mises à jour pour les mots clefs. Comme je veux mettre à jour le document "guide d'intégration ..." et que rest, pygments et sphinx permettent de faire une version html et une version latex, j'ai quasi fini l'écriture d'une directive python (en adaptant une directive de matplotlib) qui dans un document au format rst te permet d'avoir

Code: Tout sélectionner
.. plot:: asysrc/venn.asy
   :include-source:


.. plot::
   :include-source:

   size(100,0);
   draw(unitsquare);
   draw(unitcircle);


et sphinx gère la création des figures (compilation d'asymptote), l'inclusion ou non du code qui suit ou issu d'un fichier.
Mais en ce moment j'ai d'autres priorités (une soutenance d'hdr par exemple).

O.G.
OG
Modérateur
 
Messages: 2285
Inscription: Lundi 12 Mars 2007, 11:20
Localisation: Rouen
Statut actuel: Actif et salarié | Maître de conférence

Re: Une doc pour débuter

Messagepar Francky » Vendredi 26 Novembre 2010, 22:53

Magnifique, merci.
Linux Mint | TeXLive - TexMaker - asymptote | Python3 & C - Geany - Project Euler - SPOJ
Entia non sunt multiplicanda praeter necessitatem
Francky
Giga-utilisateur
 
Messages: 683
Inscription: Dimanche 11 Avril 2010, 13:01
Statut actuel: Actif et salarié | Enseignant

Re: Une doc pour débuter

Messagepar gilles » Samedi 27 Novembre 2010, 09:38

Super travail, Christophe !
Félicitations, et ... bon courage pour la suite !

Gilles
gilles
Hecto-utilisateur
 
Messages: 55
Inscription: Dimanche 04 Octobre 2009, 19:36
Localisation: Bordeaux
Statut actuel: Actif et salarié | Enseignant

Re: Une doc pour débuter

Messagepar rebouxo » Samedi 27 Novembre 2010, 09:58

gilles a écrit:Super travail, Christophe !
Félicitations, et ... bon courage pour la suite !


+1.
Je vais enfin pouvoir me mettre sérieusement à Asymptote.

Olivier
A line is a point that went for a walk. Paul Klee
Par solidarité, pas de MP
rebouxo
Modérateur
 
Messages: 6949
Inscription: Mercredi 15 Février 2006, 13:18
Localisation: le havre
Statut actuel: Actif et salarié | Enseignant

Re: Une doc pour débuter

Messagepar guiguiche » Samedi 27 Novembre 2010, 10:05

Ah ben je ne vais plus avoir d'excuse pour ne pas regarder de plus près asymptote.
Pas d'aide par MP : les questions sont publiques, les réponses aussi.
Tu as apprécié l'aide qui t'a été fournie ? Alors n'hésite pas à rendre la pareille à quelqu'un d'autre.
Un peu d'autopromotion.
guiguiche
Modérateur
 
Messages: 8071
Inscription: Vendredi 06 Janvier 2006, 15:32
Localisation: Le Mans
Statut actuel: Actif et salarié | Enseignant

Re: Une doc pour débuter

Messagepar MB » Samedi 27 Novembre 2010, 12:26

Très bonne idée ça !
Ca me fait d'ailleurs penser qu'il faut vraiment que je me mette à utiliser latexmk qui me semble bien pratique.
MB (Pas d'aide en Message Privé)
Merci d'utiliser $\LaTeX$ (voir ici) et d'éviter le style SMS pour la lisibilité des messages.
MB
Administrateur
 
Messages: 6890
Inscription: Samedi 28 Mai 2005, 13:23
Localisation: Créteil
Statut actuel: Actif et salarié | Enseignant

Re: Une doc pour débuter

Messagepar projetmbc » Samedi 27 Novembre 2010, 13:17

Bonjour;
merci pour ce document. Je vais "zyeuter" cela.

PS : serait-il possible d'avoir accès au code LaTeX ou à défaut à un bout de code LaTeX montrant comment tu as mis en forme tout ceci car c'est très agréable à lire ?
projetmbc
Péta-utilisateur
 
Messages: 1897
Inscription: Samedi 29 Décembre 2007, 00:58
Statut actuel: Actif et salarié | Enseignant

Re: Une doc pour débuter

Messagepar OG » Samedi 27 Novembre 2010, 16:46

guiguiche a écrit:Ah ben je ne vais plus avoir d'excuse pour ne pas regarder de plus près asymptote.

Ah, tu avais une excuse ?

O.G.
OG
Modérateur
 
Messages: 2285
Inscription: Lundi 12 Mars 2007, 11:20
Localisation: Rouen
Statut actuel: Actif et salarié | Maître de conférence

Re: Une doc pour débuter

Messagepar chellier » Samedi 27 Novembre 2010, 18:11

OG a écrit:Re

Merci d'utiliser pygments et le lexer asymptote. Tu dois être le seul mis à part moi (le temps de le faire). Il y aurait d'ailleurs des mises à jour pour les mots clefs. Comme je veux mettre à jour le document "guide d'intégration ..." et que rest, pygments et sphinx permettent de faire une version html et une version latex, j'ai quasi fini l'écriture d'une directive python (en adaptant une directive de matplotlib) qui dans un document au format rst te permet d'avoir

Code: Tout sélectionner
.. plot:: asysrc/venn.asy
   :include-source:


.. plot::
   :include-source:

   size(100,0);
   draw(unitsquare);
   draw(unitcircle);


et sphinx gère la création des figures (compilation d'asymptote), l'inclusion ou non du code qui suit ou issu d'un fichier.

Intéressant tout ça ! Faudra nous en reparler :D

OG a écrit:Mais en ce moment j'ai d'autres priorités (une soutenance d'hdr par exemple).

O.G.

Bon courage ! (je ne sais pas ce que c'est mais ça doit représenter du boulot :!: )

Christophe
chellier
Modérateur
 
Messages: 355
Inscription: Samedi 25 Juillet 2009, 11:25
Localisation: Le Creusot
Statut actuel: Actif et salarié | Enseignant

Re: Une doc pour débuter

Messagepar chellier » Samedi 27 Novembre 2010, 18:19

projetmbc a écrit:Bonjour;
merci pour ce document. Je vais "zyeuter" cela.

PS : serait-il possible d'avoir accès au code LaTeX ou à défaut à un bout de code LaTeX montrant comment tu as mis en forme tout ceci car c'est très agréable à lire ?

La coloration syntaxique est faite par pygments qui permet un export LaTeX. Un script me crée un fichier de coloration .colpyg (je sais, c'est nul ,mais je suis pas doué pour trouver des noms :mrgreen: ) à partir du fichier .asy. Ensuite la commande suivante (bricolée à partir d'un code trouvé sur le forum) m'insère tout ça :
Code: Tout sélectionner
\newcommand{\codeAsy}[2][1]
  {\refstepcounter{co}
   \begin{minipage}[b]{#1\linewidth}
   \hfill\includegraphics[scale=1.]{#2}\hfill
   \medskip

   \begin{tikzpicture}
   \node [fill=purple!10,rectangle,inner xsep=10pt,inner ysep=10pt] (box)
      {\begin{minipage}{\dimexpr\linewidth-21.66pt\relax}
      \VerbatimInput[commandchars=\\\{\},fontfamily=tt,fontsize=\small]{Figures/#2.colpyg}
      \end{minipage}
      };
   \node[text=white,fill=purple,rectangle, shading=ball, ball color=purple, above right] (title) at ($(box.north west)+(-0.03,0)$){\textbf{CODE \theco}};
   \draw[color=purple!50!black,very thick] (box.north west)--(box.south west)--(box.south east);
   \end{tikzpicture}
   \end{minipage}}


Le reste est plutôt basique, je ne suis pas un spécialiste de LaTeX :oops:

Christophe
chellier
Modérateur
 
Messages: 355
Inscription: Samedi 25 Juillet 2009, 11:25
Localisation: Le Creusot
Statut actuel: Actif et salarié | Enseignant

Re: Une doc pour débuter

Messagepar projetmbc » Samedi 27 Novembre 2010, 22:23

Merci.

La page de garde est aussi très sympa.

chellier a écrit:La coloration syntaxique est faite par pygments qui permet un export LaTeX.

Seul souci avec cette méthode, c'est le code LaTeX qui est affreux, si mes souvenirs sont bons... Dans le livre "LaTeX, l'essentiel-2e Edition" de Denis Bitouzé, il y a tout ce qu'il faut pour ajouter de la coloration syntaxique pour n'importe quel langage.
projetmbc
Péta-utilisateur
 
Messages: 1897
Inscription: Samedi 29 Décembre 2007, 00:58
Statut actuel: Actif et salarié | Enseignant

Re: Une doc pour débuter

Messagepar OG » Samedi 27 Novembre 2010, 22:46

projetmbc a écrit:Merci.

La page de garde est aussi très sympa.

chellier a écrit:La coloration syntaxique est faite par pygments qui permet un export LaTeX.

Seul souci avec cette méthode, c'est le code LaTeX qui est affreux, si mes souvenirs sont bons... Dans le livre "LaTeX, l'essentiel-2e Edition" de Denis Bitouzé, il y a tout ce qu'il faut pour ajouter de la coloration syntaxique pour n'importe quel langage.


Ok, tu ne pourras pas modifier le code produit pour agrémenter la présentation du code avec des symboles
par exemple, un caractère spécial pour introduire du code LaTeX, etc. Avec pygments code affreux
et pas de personnalisation : tu craches du code en LaTeX, html.
Cependant je doute que tu obtiennes la même chose avec listings, du point de vue distinction entre mot clef à la fois type et fonction, pas
d'expression régulière avec listings. Une fois tes codes transformés en LaTeX, la compilation sera plus rapide qu'avec listings qui doit s'avaler les codes
à chaque compilation.
Avec asymptote la liste des mots clefs est longue, mais ça peut toujours être intéressant d'ajouter
ce langage car manier LaTeX et pygments demande du travail.

O.G.
OG
Modérateur
 
Messages: 2285
Inscription: Lundi 12 Mars 2007, 11:20
Localisation: Rouen
Statut actuel: Actif et salarié | Maître de conférence

Suivante

Retourner vers Asymptote

 


  • Articles en relation
    Réponses
    Vus
    Dernier message

Qui est en ligne

Utilisateurs parcourant ce forum: Aucun utilisateur enregistré et 1 invité