Org-mode partie 2 - Exécuter le code

Org-mode partie 2 - Exécuter le code
Lorsque vous souhaitez apprendre et enseigner le 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 pouvez penser 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, une 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, qui est puissant pour tirer des conclusions mais n'a pas sa place dans le code final.

Code 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 distincts du code. Si vous souhaitez démontrer le code ou planifier un nouveau projet, vous pouvez utiliser des extraits de code. Pour montrer comment vous croyez qu'il doit fonctionner, vous pouvez écrire un tel document. Une façon puissante de le faire est de créer un document Org. Pour ajouter du code à votre document, vous devez ajouter un bloc de code. Un bloc de code est un ensemble de code standard que vous pouvez voir ci-dessous.

# + begin_src javascript
const app, browserwindow = require ('electron')
const path = require ('path')
# + end_src

Le résultat peut aller au document.

Cet exemple ne crée pas de sortie, le moyen le plus simple d'obtenir la 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: exportations
uname -a
# + end_src
uname -a
Linux Mats-Ubuntu 5.0.0-20-Générique # 21-UBUNTU SMP LON 24 juin 09:32:09
UTC 2019 x86_64 x86_64 x86_64 GNU / Linux

Le résultat est ajouté par Emacs dans le bloc sous le code d'exécution. Si vous voulez des résultats plus avancés ou si vous souhaitez combiner des blocs, vous devrez nommer votre bloc de code source. Ajouter le nom # + facultatif: balise. Cette balise fonctionne pour les tables ainsi que pour le code.

Tableau 1.3.1:

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

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

# + begin_src calc: var x = 5: var y = 2: exports les deux
2 + a * x ** y
# + end_src

Tout d'abord, le code s'affiche, dans le formulaire que vous spécifiez. Directement ci-dessous, les résultats sont indiqués.

2 + a * x ** y
25 A + 2

Ceci est un exemple très simple, avec le support pour le latex, vous pouvez obtenir n'importe quelle formule que vous souhaitez avec le résultat dans un document très bien formaté. UN

\ begin équation
x = \ sqrt b
\ end équation

Si vous produisez des parcelles 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
Terrain F (x)

Pour que cela fonctionne, vous devez faire installer GnupLot sur votre système. Ces fonctionnalités sont toutes appelées du système et présentées dans EMACS. Il en va de même pour tous les langages de programmation que prend en charge EMACS.

Tout le code n'est pas pris en charge, hors de la boîte

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

'(Org-babel-wanguages
(citation
((python . t)
(Emacs-Lisp . t)
(coquille . t)
(JS . t)
(Sqlite . t)
(Calc . t))))

Le code ci-dessus permet à six langues en les définissant de «t». Le «T» est le moyen courant dans Lisp de dire vrai. Vous pouvez également choisir de définir cette valeur avec la méthode «M-X Persustrize-Variable». Lorsque vous faites cela, vous devez saisir le nom de la variable ou le groupe. Dans ce cas, la variable est «Org-Babel-wadhanguages». Lorsque vous venez sur la page, vous pouvez voir ce qui est pris en charge et activer ceux que vous voulez.

Ajouter une langue

Si votre langue n'est pas dans la liste, vous pouvez rechercher la langue sur https: // orgmode.org / worg / org-contrib / babel / langues La liste des langues prises en charge est déjà longue et se développe de jour en jour. Remarque ici, la prise en charge d'une langue n'est requise que pour l'évaluation. La visualisation, l'exportation et l'empinet sont soutenues sans elle. Sur la page Web mentionnée, vous avez également contribué des langues qui nécessitent un peu plus de travail à installer. Si vous ne pouvez toujours pas voir 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 langues, vous devriez pouvoir l'ajouter même avec une expérience mineure.

Conclusion

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