Kodu öğrenmek ve öğretmek istediğinizde, kodu bir belgeye yazmak faydalı olabilir. Bu aynı zamanda bir projenin planlama aşaması için de yararlıdır. Sadece koda yorum koyduğunuzu düşünebilirsiniz, ancak yorumların bu kodun nasıl çalıştığını göstermesi gerektiğinden bu zahmetli olabilir. Belgede kod yorumuna ait olmayan proje fikirleri, planlama ve soyut fikirleri koyabilirsiniz. Belge ayrıca, sonuç çıkarmak için güçlü olan ancak nihai kodda yeri olmayan yürütmenin sonuçlarını da içerebilir.

Emacs'ta kod

Birçok geliştirici, yazılım geliştirmek için Emacs kullanır, bu güçlü bir kod düzenleyicidir. Aslında, çoğu kişi doğru şekilde yapılandırıldığında bunu bir IDE olarak kabul eder. Ancak belgeler genellikle koddan ayrıdır. Kodu göstermek veya yeni bir proje planlamak istiyorsanız kod parçacıklarını kullanabilirsiniz. Nasıl çalışması gerektiğine inandığınızı göstermek için böyle bir belge yazabilirsiniz. Bunu yapmanın güçlü bir yolu, bir Org belgesi oluşturmaktır. Belgenize kod eklemek için bir kod bloğu eklemeniz gerekir. Kod bloğu, aşağıda görebileceğiniz standart bir kod kümesidir.

#+begin_src javascript
const app, BrowserWindow = require('elektron')
const yol = gerektirir('yol')
#+end_src

Sonuç belgeye gidebilir.

Bu örnek bir çıktı oluşturmaz, çıktı almanın en basit yolu kabuk kullanmaktır. Bir komutu çalıştırmak ve sonuçları göstermek istediğinizde, bir başlık parametresi eklemeniz gerekir.

#+begin_src kabuğu :her ikisini de dışa aktarır
unname -a
#+end_src
unname -a
Linux paspasları-Ubuntu 5.0.0-20-jenerik #21-Ubuntu SMP 24 Haz Pzt 09:32:09
UTC 2019 x86_64 x86_64 x86_64 GNU/Linux

Sonuç, yürütme kodunun altındaki blokta Emacs tarafından eklenir. Daha gelişmiş sonuçlar veya blokları birleştirmek istiyorsanız, kaynak kod bloğunuzu adlandırmanız gerekir. İsteğe bağlı #+NAME: etiketini ekleyin. Bu etiket, kod kadar tablolar için de çalışır.

tablo 1.3.1:

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

Calc modülü ile verileri girebilir ve sonuçların belgede görüntülenmesini sağlayabilirsiniz.

#+begin_src calc :var x=5 :var y=2 :her ikisini de dışa aktarır
2+a*x**y
#+end_src

İlk olarak kod, belirttiğiniz formda görüntülenir. Doğrudan aşağıda, sonuçlar gösterilir.

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

Bu çok basit bir örnek, LaTeX desteği ile istediğiniz formülü çok iyi biçimlendirilmiş bir belgede elde edebilirsiniz. bir

\begindenklem
x=\sqrtb
\enddenklem

Kodunuzla grafikler üretirseniz, bunu belgenin içinde görüntüleyebilirsiniz. Aşağıda, x2'nin sonucunu çizmek için gnuplot kullanan çok basit bir kod görebilirsiniz.

f(x) = x**2
arsa f(x)

Bunun çalışması için sisteminizde gnuplot kurulu olmalıdır. Bu özelliklerin tümü sistemden çağrılır ve Emacs'ta sunulur. Aynısı, Emacs'ın desteklediği tüm programlama dilleri için de geçerlidir.

Kutunun dışında tüm kodlar desteklenmez

Verimlilik adına, Emacs'in vanilya kurulumunda desteklenen tüm diller etkin değildir. Etkinleştirdiğinizden emin olmak için emacs yapılandırmanıza kod ekleyebilirsiniz, init.el standart dosyadır.

'(org-babel-load-diller
(alıntı
((piton . t)
(emacs-lisp . t)
(kabuk . t)
(js . t)
(sqlit . t)
(hesap . t))))

Yukarıdaki kod, 't' olarak ayarlayarak altı dili etkinleştirir. 't', Lisp'te doğru demenin yaygın yoludur. Bu değeri 'M-x özelleştir-değişken' yöntemiyle de ayarlamayı seçebilirsiniz. Bunu yaptığınızda, değişken adını veya grubunu yazmanız gerekir. Bu durumda değişken 'org-babel-load-languages' olur. Sayfaya geldiğinizde nelerin desteklendiğini görebilir ve istediklerinizi aktif hale getirebilirsiniz.

Dil ekleme

Diliniz listede yoksa https://orgmode adresinden dil arayabilirsiniz.org/worg/org-katkı/babel/diller.Şu anda.html Desteklenen dillerin listesi zaten uzun ve gün geçtikçe büyüyor. Burada not edin, dil desteği yalnızca değerlendirme için gereklidir. Görüntüleme, dışa aktarma ve karışıklık onsuz desteklenir. Bahsedilen web sayfasında, kurulumu biraz daha fazla çalışma gerektiren dillere de katkıda bulundunuz. Hala dilinizi göremiyorsanız, kendi dilinizi eklemek için bir şablon var. Bu, bazı lisp programlama becerileri gerektirir, ancak diğer dillere bakarsanız, küçük bir deneyimle bile ekleyebilmelisiniz.

Sonuç

Bu makale, kuruluş moduyla yapabileceklerinizin yalnızca yüzeyini çizdi. Daha fazla özellik mevcuttur ve Emacs'ı basit bir düzenleyici olarak adlandırmak kendinize zarar vermektir.