Menambahkan Table Of Contents (toc) di Org Mode

Pasti ada aja yang baru di Emacs, makanya ndak heran kalau ada yang bilang learning curve Emacs itu paling berat jika dibanding text editor lain. Kali ini saya akan sedikit share cara menambahkan Table of Contents atau daftar isi secara otomatis di dokumen Org di Emacs.

membuat toc otomatis di org emacs
TOC otomatis di org mode

Untuk membuatnya TOC otomatis, kita butuh install package toc-org dengan cara M-x package-list-packages, kemudian search (C-s) paket toc-org, tandai dengan menekan i, terus tekan x untuk execute.

Setelah paket berhasil dipasang, selanjutnya kita tambahkan setting berikut di .emacs kita.

;; toc-org mode                                                   
(if (require 'toc-org nil t)                                      
    (progn                                                        
      (add-hook 'org-mode-hook 'toc-org-mode))                    
                                                                  
                                                                  
  ;; enable in markdown, too                                      
  (add-hook 'markdown-mode-hook 'toc-org-mode)                    
  (define-key my-markdown-mode-map (kbd "\C-c\C-o") 'toc-org-markdown-follow-thing-at-point)                                       
  (warn "toc-org not found"))

Selanjutnya, buat heading baru dan di sebelah kanan nama heading kita tambahkan :TOC: kemudian kita tekan C-s, dan secara otomatis daftar isi akan muncul dokumen kita. ๐Ÿ˜‹

#+TITLE: cara buat toc                                                                
#+AUTHOR: kholidfu                                                                    
                                                                                      
* Daftar Isi                                                            :TOC:         
- Pendahuluan                                                                         
- Latar Belakang Masalah                                                              
  - Latar 1                                                                           
  - Latar 2                                                                           
                                                                                      
* Pendahuluan                                                                         
* Latar Belakang Masalah                                                              
** Latar 1                                                                            
** Latar 2

Apabila berkas Org ini kita host di Github, maka TOC ini akan otomatis tampil juga, dan berfungsi dengan normal.

Dokumen yang menggunakan toc-org tidak bisa di-export ke HTML/PDF, selalu muncul error. Artinya, kalau mau export ke PDF, TOC nya di hapus dulu.

Atau, ya berkas Org yang menggunakan toc-org ini memang khusus untuk org saja (misal mau untuk dokumentasi di github), tidak untuk di export ke HTML atau PDF.

Baca Juga: Tutorial Emacs untuk Pemula