Cuando desee aprender y enseñar código, puede resultar útil escribir el código en un documento. Esto también es útil para la etapa de planificación de un proyecto. Puede pensar que acaba de poner comentarios en el código, pero eso podría ser problemático, ya que los comentarios deben mostrar cómo funciona este código. En el documento puede poner ideas de proyectos, planificación e ideas abstractas que no pertenecen al comentario del código. El documento también puede contener resultados de la ejecución, lo cual es poderoso para sacar conclusiones pero no tiene lugar en el código final.

Código en Emacs

Muchos desarrolladores usan Emacs para desarrollar software, es un poderoso editor de código. De hecho, muchos lo consideran un IDE, cuando se configura correctamente. Pero los documentos suelen estar separados del código. Si desea demostrar el código o planificar un nuevo proyecto, puede usar fragmentos de código. Para mostrar cómo cree que debe funcionar, puede escribir dicho documento. Una forma eficaz de hacer esto es crear un documento de la organización. Para agregar código a su documento, debe agregar un bloque de código. Un bloque de código es un conjunto estándar de código que puede ver a continuación.

# + begin_src javascript
const app, BrowserWindow = require ('electron')
ruta constante = require ('ruta')
# + end_src

El resultado puede ir al documento.

Este ejemplo no crea una salida, la forma más sencilla de obtener una salida es usar shell. Cuando desee ejecutar un comando y mostrar los resultados, debe agregar un parámetro de encabezado.

# + begin_src shell: exporta ambos
uname -a
# + end_src
uname -a
Alfombrillas Linux-Ubuntu 5.0.0-20-genérico # 21-Ubuntu SMP Lunes 24 de junio 09:32:09
UTC 2019 x86_64 x86_64 x86_64 GNU / Linux

Emacs agrega el resultado en el bloque debajo del código de ejecución. Si desea resultados más avanzados o desea combinar bloques, deberá nombrar su bloque de código fuente. Agregue la etiqueta opcional # + NAME:. Esta etiqueta funciona tanto para tablas como para código.

tabla 1.3.1:

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

Con el módulo calc, puede ingresar datos y mostrar los resultados en el documento.

# + begin_src calc: var x = 5: var y = 2: exporta ambos
2 + a * x ** y
# + end_src

Primero, se muestra el código, en la forma que especifique. Directamente debajo, se muestran los resultados.

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

Este es un ejemplo muy simple, con soporte para LaTeX puede obtener cualquier fórmula que desee con el resultado en un documento muy bien formateado. A

\ begin ecuación
x = \ sqrt b
\ end ecuación

Si produce gráficos con su código, puede mostrarlos dentro del documento. A continuación, puede ver un código muy simple que usa gnuplot para trazar el resultado de x2.

f (x) = x ** 2
trazar f (x)

Para que esto funcione, necesita tener gnuplot instalado en su sistema. Todas estas características se llaman desde el sistema y se presentan en Emacs. Lo mismo ocurre con todos los lenguajes de programación que soporta Emacs.

No todo el código es compatible, listo para usar

En aras de la eficiencia, no todos los lenguajes admitidos están activos en una instalación básica de Emacs. Para asegurarse de tenerlo activo, puede agregar código a su configuración de emacs, init.el es el archivo estándar.

'(org-babel-load-languages
(cita
((pitón . t)
(emacs-lisp . t)
(cáscara . t)
(js . t)
(sqlite . t)
(calc . t))))

El código anterior habilita seis idiomas configurándolos en 't'. la 't' es la forma común en Lisp de decir verdadero. También puede optar por establecer este valor con el método 'M-x personalizar-variable'. Cuando haga esto, debe escribir el nombre de la variable o el grupo. En este caso, la variable es 'org-babel-load-languages'. Cuando llegas a la página, puedes ver qué es compatible y activar los que quieras.

Agregar un idioma

Si su idioma no está en la lista, puede buscar el idioma en https: // orgmode.org / worg / org-contrib / babel / languages.Actualmente.html La lista de idiomas admitidos ya es larga y crece día a día. Tenga en cuenta aquí que solo se requiere soporte para un idioma para la evaluación. La visualización, la exportación y el enredo son compatibles sin él. En la página web mencionada, también ha contribuido con idiomas que requieren un poco más de trabajo para instalar. Si aún no puede ver su idioma, hay una plantilla para agregarlo usted mismo. Esto requiere algunas habilidades de programación lisp, pero si observa los otros lenguajes, debería poder agregarlo incluso con poca experiencia.

Conclusión

Este artículo solo ha arañado la superficie de lo que puede hacer con el modo org. Hay más funciones disponibles y llamar a Emacs editor simple no le hace ningún favor.