Browse Source

NETTOYAGE 1 DU NIVEAU 14

EMACSFREEMAN 5 years ago
parent
commit
1226b8fca5
1 changed files with 56 additions and 24 deletions
  1. 56 24
      orgguide_fr.org

+ 56 - 24
orgguide_fr.org

@@ -1852,37 +1852,58 @@ Le mode Org fournit de nombreuses options pour travailler avec le code
 source, incluant l'édition de blocs de code dans leurs mode majeurs natifs,
 l'évaluation de blocs de code, l'enchevêtrement de blocs de code, et 
 l'exportation de blocs de code et leurs résultats en plusieurs formats.
-*** Structure des blocs de code
+
+*Structure des blocs de code*
+
 La structure d'un bloc de code est la suivante :
+
+#+begin_quote
 =#+NAME: <nom>=
+
 =#+BEGIN_SRC <langage><switches><header arguments>=
+
 = <corps>=
+
 =#+END_SRC=
+#+end_quote
+
 Où =<nom> est une chaîne utilisée pour nommer un bloc de code, =<langage>=
 précise le langage du bloc de code (par exemple =emacs-lisp=, =shell=, 
-=python=,etc ...), =<switches>=peut être utilisé pour contrôler 
-l'exportation du bloc de code, =<header arguments>=peut être utilisé pour
+=python=,etc ...), =<switches>= peut être utilisé pour contrôler 
+l'exportation du bloc de code, =<header arguments>= peut être utilisé pour
 contrôler beaucoup d'aspects du comportement du bloc de code tels que 
-présentés ci-dessous, et =<corps>=contient en fait le code source.
-*** Edition du code source
-Utiliser =C-c '= pour éditer le bloc de code actuel. Cela amène à éditer
+présentés ci-dessous, et =<corps>= contient en fait le code source.
+
+*Edition du code source*
+
+Utiliser =C-c=' pour éditer le bloc de code actuel. Cela amène à éditer
 un buffer en mode majeur du langage contenant le corps du bloc de code. La
 sauvegarde de ce buffer écrira les nouveaux contenus de retour dans le tampon
-Org. Utiliser =C-c '= encore pour sortir du tampon d'édition.
-*** Evalutation des blocs de code
+Org. Utiliser =C-c=' encore pour sortir du tampon d'édition.
+
+*Evalutation des blocs de code*
+
 L'utilisation de =C-c C-c= évalue le bloc de code actuel et insère les
 résultats dans le tampon en mode Org. Par défaut, l'évaluation est 
 seulement activée pour des blocs de code =emacs-lisp=, toutefois il est
 possible d'évaluer des blocs de code dans beaucoup de langages. Pour une
 liste complète des langages évaluables consulter le manuel. Ce qui suit
 montre un bloc de code et son résultat. 
+
+#+begin_quote
 =#+BEGIN_SRC emacs-lisp=
+
 = (+ 1 2 3 4) =
+
 =#+END_SRC=
 
-=#+RESULTS:=
+=#+RESULTS:
+=
 =:10=
-*** Extraction de code source
+#+end_quote
+
+*Extraction de code source*
+
 Utiliser =C-c C-v t= pour créer des fichiers de code source par
 extraction de code depuis des blocs source dans le tampon actuel. Cela
 se réfère comme "enchevêtrement"---un terme adopté de la littérature de la
@@ -1891,56 +1912,67 @@ leurs corps sont développés en utilisant =org-babel-expand-src-block=
 qui peut développer à la fois les variables et les styles de références 
 "noweb". Afin d'enchevêtrer un bloc de code il doit y avoir un header
 argument =:tangle=, voir le manuel pour plus de détails.
-*** Bibliothèque de Babel
+
+*Bibliothèque de Babel*
+
 Utiliser =C-c C-v l= pour charger les blocs de code depuis des fichiers en
 mode Org dans la "Bibliothèque de Babel", ces blocs peuvent alors être 
 évalués depuis n'importe quel tampon en mode Org. Une collection blocs de
 code généralement utiles est distribuée avec le mode Org dans 
 =contrib/library-of-babel.org=.
-*** Header Arguments
+
+*Header Arguments*
+
 Beaucoup d'aspects de l'évaluation et de l'exportation de blocs de code sont
 controlés via les header arguments. Ils peuvent être spécifiés globalement,
 au niveau du fichier, au niveau d'une grande ligne de l'arborescence, et au
 niveau du bloc de code indiviuel. Les lignes suivantes décrivent quelques 
 header arguments.
-=:var=L'argument =:var=est utilisé pour passer des arguments de blocs de
+
+- =:var= L'argument =:var= est utilisé pour passer des arguments de blocs de
        code. Les valeurs passées en arguments peuvent être des valeurs
        littérales, des valeurs depuis des tables et des exemples de blocs
        en mode Org, ou les résultats d'autres blocs de code nommés.
-=:results=L'argument =:results=contrôle la /collection/, le /type/, et 
+- =:results= L'argument =:results= contrôle la /collection/, le /type/, et 
            la /manipulation/ des résultats des blocs de code. Les valeurs
-	   de = output= ou =value=(par défaut) précisent comment les 
+	   de = output= ou =value= (par défaut) précisent comment les 
 	   résultats sont collectés depuis l'évaluation d'un bloc de code.
 	   Les valeurs de =vector=, =scalar file raw html latex=et =code=
 	   précisent le type des résultats du bloc de code qui dicte comment
 	   ils doivent être incorporés dans le tampon en mode Org. Les 
-	   valeurs =silent=, =replace=, =prepend=, et =append=précisent
+	   valeurs =silent=, =replace=, =prepend=, et =append= précisent
 	   la manipulation des résultats des blocs de code, spécialement
 	   si et comment les résultats devraient être insérés dans un 
 	   tampon en mode Org.
-=:session=Un argument =:session=provoquera l'évaluation du bloc de code
+- =:session= Un argument =:session= provoquera l'évaluation du bloc de code
            dans un processus intéractif persistant dans Emacs. Cela permet
 	   la persistance entre évaluations de bloc de code, et l'inspection
 	   manuelle des résultats de l'évaluation.
-=:exports=Toute combinaison de /code/ ou de /résultats/ d'un bloc peut être
+- =:exports= Toute combinaison de /code/ ou de /résultats/ d'un bloc peut être
            retenu à l'exportation, cela est précisé dans la configuration de
-	   l'argument =:results=à =code results non= ou =both=.
-=:tangle= L'argument =:tangle yes=provoquera l'enchevêtrement du contenu
+	   l'argument =:results= à =code results non= ou =both=.
+- =:tangle= L'argument =:tangle yes=provoquera l'enchevêtrement du contenu
            du bloc de code avec un fichier nommé après le nom de fichier
 	   du tampon en mode Org. Un nom de fichier alternatif peut être
 	   précisé avec =:tangle filename=.
-=:cache=  L'argument =:cache yes=provoquera l'association du hachage de
+- =:cache=  L'argument =:cache yes=provoquera l'association du hachage de
            la partie développée du bloc de code avec les résultats, veille
 	   à ce que les blocs de code soient seulement ré-exécuté lorsque 
 	   leurs entrées ont changé.
-=:noweb=  L'argument =:noweb yes=développera les références de style 
+- =:noweb=  L'argument =:noweb yes= développera les références de style 
            "noweb" pour l'évaluation et l'enchevêtrement.
-=:file=   Les blocs de code dont les résultats sont dans des fichiers (par
+- =:file=   Les blocs de code dont les résultats sont dans des fichiers (par
            exemple des graphiques, des diagrammes et des figures) peuvent
-	   accepter un argument =:file filename=dans ce cas les résultats
+	   accepter un argument =:file filename= dans ce cas les résultats
            sont enregistrés dans le fichier nommé, et un lien vers le fichier
 	   est inséré dans le tampon en mode Org. 
 
+*Approfondissements*
+
+[[http://orgmode.org/manual/Literal-examples.html#Literal-examples][Chapitre 11.3 du manuel]]
+
+[[http://orgmode.org/worg/org-contrib/babel/index.html][Le site de Babel sur Worg]]
+
 * Divers 
 ** Complétion
 Org comprend dans le tampon la complétion avec =M-TAB=. Ce type de