Saat Anda ingin mempelajari dan mengajarkan kode, akan berguna untuk menulis kode dalam dokumen. Ini juga berguna untuk tahap perencanaan proyek. Anda mungkin berpikir bahwa Anda hanya memberikan komentar dalam kode tetapi itu bisa merepotkan karena komentar perlu menunjukkan cara kerja kode ini. Dalam dokumen Anda dapat memasukkan ide-ide proyek, perencanaan dan ide-ide abstrak yang tidak termasuk dalam komentar kode. Dokumen juga dapat berisi hasil eksekusi, yang sangat kuat untuk menarik kesimpulan tetapi tidak memiliki tempat dalam kode akhir.

Kode di Emacs

Banyak pengembang menggunakan Emacs untuk mengembangkan perangkat lunak, ini adalah editor kode yang hebat. Faktanya, banyak yang menganggapnya sebagai IDE, jika dikonfigurasi dengan benar. Tetapi dokumen biasanya terpisah dari kode. Jika Anda ingin mendemonstrasikan kode atau merencanakan proyek baru, Anda dapat menggunakan cuplikan kode. Untuk menunjukkan bagaimana Anda yakin itu perlu bekerja, Anda dapat menulis dokumen seperti itu. Salah satu cara ampuh untuk melakukannya adalah dengan membuat dokumen Org. Untuk menambahkan kode ke dokumen Anda, Anda perlu menambahkan blok kode. Blok kode adalah kumpulan kode standar yang dapat Anda lihat di bawah.

#+begin_src javascript
const aplikasi, BrowserWindow = membutuhkan('elektron')
jalur const = membutuhkan('jalur')
#+end_src

Hasilnya bisa masuk ke dokumen.

Contoh ini tidak membuat output, cara paling sederhana untuk mendapatkan output adalah dengan menggunakan shell. Saat Anda ingin menjalankan perintah dan menampilkan hasilnya, Anda perlu menambahkan parameter header.

#+begin_src shell :mengekspor keduanya
uname -a
#+end_src
uname -a
Linux mat-Ubuntu 5.0.0-20-generic #21-Ubuntu SMP Sen 24 Jun 09:32:09
UTC 2019 x86_64 x86_64 x86_64 GNU/Linux

Hasilnya ditambahkan oleh Emacs di blok di bawah kode eksekusi. Jika Anda ingin hasil yang lebih maju atau Anda ingin menggabungkan blok, Anda perlu memberi nama blok kode sumber Anda. Tambahkan tag #+NAME: opsional. Tag ini berfungsi untuk tabel dan juga kode.

Tabel 1.3.1:

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

Dengan modul calc, Anda dapat memasukkan data dan menampilkan hasilnya dalam dokumen.

#+begin_src calc :var x=5 :var y=2 :mengekspor keduanya
2+a*****y
#+end_src

Pertama, kode ditampilkan, dalam bentuk yang Anda tentukan. Langsung di bawah, hasilnya ditampilkan.

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

Ini adalah contoh yang sangat sederhana, dengan dukungan untuk LaTeX Anda bisa mendapatkan formula apa pun yang Anda inginkan dengan hasil dalam dokumen yang diformat dengan sangat baik. SEBUAH

\beginpersamaan
x=\sqrtb
\endpersamaan

Jika Anda menghasilkan plot dengan kode Anda, Anda dapat menampilkannya di dalam dokumen. Di bawah ini, Anda dapat melihat kode yang sangat sederhana yang menggunakan gnuplot untuk memplot hasil x2.

f(x) = x**2
petak f(x)

Agar ini berfungsi, Anda harus menginstal gnuplot di sistem Anda. Semua fitur ini dipanggil dari sistem dan disajikan di Emacs. Hal yang sama berlaku untuk semua bahasa pemrograman yang didukung Emacs.

Tidak semua kode didukung, di luar kotak

Demi efisiensi, tidak semua bahasa yang didukung aktif dalam instalasi vanilla Emacs. Untuk memastikan Anda mengaktifkannya, Anda dapat menambahkan kode ke konfigurasi emacs Anda, init.el adalah file standar.

'(org-babel-load-languages
(kutipan
((python . t)
(emacs-lisp . t)
(kulit . t)
(js . t)
(sqlite . t)
(kalkulasi . t))))

Kode di atas mengaktifkan enam bahasa dengan menyetelnya ke 't'. 't' adalah cara umum dalam Lisp untuk mengatakan benar. Anda juga dapat memilih untuk menyetel nilai ini dengan metode 'M-x variabel penyesuaian'. Ketika Anda melakukan ini, Anda perlu mengetikkan nama variabel, atau grup. Dalam hal ini variabelnya adalah 'org-babel-load-languages'. Ketika Anda datang ke halaman, Anda dapat melihat apa yang didukung dan mengaktifkan yang Anda inginkan.

Menambahkan bahasa

Jika bahasa Anda tidak ada dalam daftar, Anda dapat mencari bahasa di https://orgmode.org/worg/org-contrib/babel/languages.Saat ini.html Daftar bahasa yang didukung sudah panjang dan terus bertambah dari hari ke hari. Catatan di sini, dukungan untuk bahasa hanya diperlukan untuk evaluasi. Melihat, mengekspor, dan kusut didukung tanpa itu. Di halaman web yang disebutkan, Anda juga telah menyumbangkan bahasa yang memerlukan sedikit lebih banyak pekerjaan untuk dipasang. Jika Anda masih tidak dapat melihat bahasa Anda, ada template untuk menambahkannya sendiri. Ini membutuhkan beberapa keterampilan pemrograman cadel tetapi jika Anda melihat bahasa lain, Anda harus dapat menambahkannya bahkan dengan sedikit pengalaman.

Kesimpulan

Artikel ini hanya menggores permukaan dari apa yang dapat Anda lakukan dengan mode-org. Lebih banyak fitur tersedia dan menyebut Emacs sebagai editor sederhana merugikan diri Anda sendiri.