Lorsque vous souhaitez apprendre et enseigner du code, il peut être utile d'écrire le code dans un document. Ceci est également utile pour la phase de planification d'un projet. Vous pensez peut-être que vous venez de mettre des commentaires dans le code, mais cela pourrait être gênant car les commentaires doivent montrer comment ce code fonctionne. Dans le document, vous pouvez mettre des idées de projet, des idées de planification et des idées abstraites qui n'appartiennent pas au commentaire du code. Le document peut également contenir les résultats de l'exécution, ce qui est puissant pour tirer des conclusions mais n'a pas sa place dans le code final.

Coder dans Emacs

De nombreux développeurs utilisent Emacs pour développer des logiciels, c'est un puissant éditeur de code. En fait, beaucoup le considèrent comme un IDE, lorsqu'il est correctement configuré. Mais les documents sont généralement séparés du code. Si vous souhaitez démontrer du code ou planifier un nouveau projet, vous pouvez utiliser des extraits de code. Pour montrer comment vous pensez que cela doit fonctionner, vous pouvez écrire un tel document. Un moyen puissant de le faire est de créer un document d'organisation. Pour ajouter du code à votre document, vous devez ajouter un bloc de code. Un bloc de code est un ensemble standard de code que vous pouvez voir ci-dessous.

#+begin_src javascript
const app, BrowserWindow = require('electron')
const chemin = require('chemin')
#+fin_src

Le résultat peut aller au document.

Cet exemple ne crée pas de sortie, le moyen le plus simple d'obtenir une sortie est d'utiliser le shell. Lorsque vous souhaitez exécuter une commande et afficher les résultats, vous devez ajouter un paramètre d'en-tête.

#+begin_src shell : exporte les deux
uname -a
#+fin_src
uname -a
Tapis Linux-Ubuntu 5.0.0-20-générique #21-Ubuntu SMP Lun 24 juin 09:32:09
UTC 2019 x86_64 x86_64 x86_64 GNU/Linux

Le résultat est ajouté par Emacs en bloc sous le code d'exécution. Si vous souhaitez des résultats plus avancés ou si vous souhaitez combiner des blocs, vous devrez nommer votre bloc de code source. Ajoutez la balise facultative #+NAME :. Cette balise fonctionne pour les tableaux ainsi que le code.

Tableau 1.3.1:

X	oui	z
0	1	4
1	3	6
2	4	8

Avec le module calc, vous pouvez saisir des données et afficher les résultats dans le document.

#+begin_src calc :var x=5 :var y=2 :exporte les deux
2+a*****y
#+fin_src

Tout d'abord, le code s'affiche, sous la forme que vous spécifiez. Juste en dessous, les résultats sont affichés.

2+a*****y
25 a + 2

Ceci est un exemple très simple, avec le support de LaTeX vous pouvez obtenir n'importe quelle formule que vous voulez avec le résultat dans un document très bien formaté. UNE

\beginéquation
x=\sqrtb
\endéquation

Si vous produisez des tracés avec votre code, vous pouvez l'afficher à l'intérieur du document. Ci-dessous, vous pouvez voir un code très simple qui utilise gnuplot pour tracer le résultat de x2.

f(x) = x**2
tracé f(x)

Pour que cela fonctionne, vous devez avoir gnuplot installé sur votre système. Ces fonctionnalités sont toutes appelées depuis le système et présentées dans Emacs. Il en va de même pour tous les langages de programmation supportés par Emacs.

Tous les codes ne sont pas pris en charge, prêts à l'emploi

Par souci d'efficacité, toutes les langues prises en charge ne sont pas actives dans une installation vanille d'Emacs. Pour vous assurer qu'il est actif, vous pouvez ajouter du code à votre configuration emacs, init.el est le fichier standard.

'(org-babel-load-languages
(citation
((python . t)
(emacs-lisp . t)
(coquille . t)
(js . t)
(sqlite . t)
(calcul . t))))

Le code ci-dessus active six langues en les définissant sur « t ». le 't' est la façon courante en Lisp de dire vrai. Vous pouvez également choisir de définir cette valeur avec la méthode 'M-x customiser-variable'. Lorsque vous faites cela, vous devez saisir le nom de la variable ou du groupe. Dans ce cas, la variable est 'org-babel-load-languages'. Lorsque vous arrivez sur la page, vous pouvez voir ce qui est pris en charge et activer ceux que vous voulez.

Ajout d'une langue

Si votre langue n'est pas dans la liste, vous pouvez rechercher une langue sur https://orgmode.org/worg/org-contrib/babel/langues.Actuellement.html La liste des langues supportées est déjà longue et s'allonge de jour en jour. Notez ici que la prise en charge d'une langue n'est requise que pour l'évaluation. La visualisation, l'exportation et l'enchevêtrement sont pris en charge sans cela. Sur la page Web mentionnée, vous avez également contribué des langues qui nécessitent un peu plus de travail à installer. Si vous ne voyez toujours pas votre langue, il existe un modèle pour l'ajouter vous-même. Cela nécessite des compétences en programmation lisp, mais si vous regardez les autres langages, vous devriez pouvoir l'ajouter même avec une expérience mineure.

Conclusion

Cet article n'a fait qu'effleurer la surface de ce que vous pouvez faire avec le mode org. Plus de fonctionnalités sont disponibles et appeler Emacs un simple éditeur vous rend un mauvais service.