Когато искате да научите и преподавате код, може да е полезно да напишете кода в документ. Това е полезно и за етапа на планиране на даден проект. Може да си помислите, че просто сте поставили коментари в кода, но това може да е обезпокоително, тъй като коментарите трябва да покажат как работи този код. В документа можете да поставите идеи за проекти, планиране и абстрактни идеи, които не принадлежат към коментара на кода. Документът може също да съдържа резултати от изпълнението, което е мощно за извеждане на заключения, но няма място в окончателния код.

Код в Emacs

Много разработчици използват Emacs за разработване на софтуер, той е мощен редактор на код. Всъщност мнозина го смятат за IDE, когато е правилно конфигуриран. Но документите обикновено са отделни от кода. Ако искате да демонстрирате код или да планирате нов проект, можете да използвате кодови фрагменти. За да покажете как смятате, че трябва да работи, можете да напишете такъв документ. Един от мощните начини да направите това е да създадете Org документ. За да добавите код към вашия документ, трябва да добавите блок с код. Кодовият блок е стандартен набор от кодове, който можете да видите по-долу.

# + begin_src javascript
const приложение, BrowserWindow = изисква ('електрон')
const path = require ('path')
# + end_src

Резултатът може да отиде в документа.

Този пример не създава изход, най-простият начин за получаване на изход е да се използва черупка. Когато искате да изпълните команда и да покажете резултатите, трябва да добавите параметър на заглавката.

# + begin_src черупка: експортира и двете
uname -a
# + end_src
uname -a
Linux подложки-Ubuntu 5.0.0-20-generic # 21-Ubuntu SMP Mon Mon 24 юни 09:32:09
UTC 2019 x86_64 x86_64 x86_64 GNU / Linux

Резултатът се добавя от Emacs в блок под изпълняващия код. Ако искате по-разширени резултати или искате да комбинирате блокове, ще трябва да назовете вашия блок с изходен код. Добавете незадължителния маркер # + NAME:. Този маркер работи както за таблици, така и за код.

маса 1.3.1:

х	у	z
0	1	4
1	3	6
2	4	8

С модула calc можете да въвеждате данни и резултатите да се показват в документа.

# + begin_src calc: var x = 5: var y = 2: експортира и двете
2 + a * x ** y
# + end_src

Първо, кодът се показва под формата, която сте посочили. Точно по-долу са показани резултатите.

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

Това е много прост пример, с поддръжката на LaTeX можете да получите произволна формула с резултата в много добре форматиран документ. A

\ начало уравнение
x = \ sqrt b
\ end уравнение

Ако създавате графики с вашия код, можете да покажете това в документа. По-долу можете да видите много прост код, който използва gnuplot за начертаване на резултата от x2.

f (x) = x ** 2
парцел f (x)

За да работи това, трябва да имате инсталиран gnuplot на вашата система. Всички тези функции се извикват от системата и се представят в Emacs. Същото важи и за всички програмни езици, които Emacs поддържа.

Не всички кодове се поддържат извън кутията

За по-голяма ефективност не всички поддържани езици са активни във ванилова инсталация на Emacs. За да сте сигурни, че сте го активирали, можете да добавите код към вашата конфигурация на emacs, init.el е стандартният файл.

'(org-babel-load-languages
(цитат
((python . T)
(emacs-lisp . T)
(черупка . T)
(js . T)
(sqlite . T)
(изчислено . T))))

Горният код дава възможност на шест езика, като ги задава на „t“. „t“ е често срещаният начин в Lisp да се каже вярно. Можете също да изберете да зададете тази стойност с метода 'M-x customize-variable'. Когато направите това, трябва да въведете името на променливата или групата. В този случай променливата е „org-babel-load-languages“. Когато стигнете до страницата, можете да видите какво се поддържа и да активирате тези, които искате.

Добавяне на език

Ако езикът ви не е в списъка, можете да потърсите език на https: // orgmode.org / worg / org-contrib / babel / languages.Понастоящем.html Списъкът на поддържаните езици вече е дълъг и се увеличава с всеки изминал ден. Забележете тук, поддръжка за език се изисква само за оценката. Преглеждането, експортирането и заплитането се поддържа без него. На споменатата уеб страница вие също сте добавили езици, които изискват малко повече работа за инсталиране. Ако все още не можете да видите езика си, има шаблон за самото му добавяне. Това изисква известни умения за програмиране, но ако погледнете останалите езици, трябва да можете да го добавите дори и с незначителен опит.

Заключение

Тази статия само е надраскала повърхността на това, което можете да правите с org-режим. Налични са повече функции и призоваването на Emacs като прост редактор ви прави лоша услуга.