Syntax Highlighting: Menampilkan Baris-baris Kode LaTeX pada Tulisan di Blog Tanpa Ribet

 Mukadimah

Mungkin Anda sudah terbiasa bahwa ketika Anda menulis dokumen $\LaTeX$, Anda menunjukkan kode tertentu yang perlu diketahui oleh pembaca dokumen Anda. Untuk hal itu, Anda memiliki beberapa pilihan antara lain lingkup perintah bawaan (default) $\LaTeX$, yaitu verbatim, paket showexpl, atau paket minted.

Untuk tulisan Anda di blog atau situs, Anda menggunakan cara tertentu yang berbeda dan khas. Salah satunya adalah cara termudah, yaitu salin-tempel. Jika Anda sering berkunjung ke blog ini maka (tentu) Anda sudah banyak melihat contohnya. Sekadar untuk memastikan, berikut ini salah satu contohnya.

Tampak bahwa Anda (pembaca) dapat melihat baris-baris kode beserta nomornya yang ingin saya tunjukkan. Berikut ini beberapa pilihan yang dapat Anda ambil untuk melakukan hal itu.

Pastebin

Demi kenyamanan dan keamanan, lebih dulu silakan Anda mendaftar di sini. Kemudian halaman Pastebin Anda akan terbuka seperti ini

Setiap kali Anda buat sintaks, klik tombol +paste. Kemudian tempelkan baris-baris kode Anda pada kotak New Paste. Atur kotak-kotak bernomor itu seperti yang ditunjukkan. Pada kotak bernomor 7, namai sesuai dengan nama yang Anda inginkan. Akhirnya, klik tombol Create New Paste. Hasilnya akan tampak seperti ini.

Klik tombol embed. Kemudian salin skrip dari JavaScript Embedding.

Selanjutnya tempelkan ke dalam tulisan Anda dalam modus HTML.

Gist dari Github

Lebih dulu silakan Anda mendaftarkan diri di sini. Halaman Gist Anda akan terbuka seperti ini. 

Isi kotak bernomor 1 oleh nama yang Anda inginkan. Kemudian tempelkan baris-baris kode Anda pada kotak bernomor 2. Anda akan menekan tombol bernomor 3. Dapat Anda pilih, apakah Gist Anda akan dibuat bersifat sendiri (rahasia) atau untuk umum. Hasilnya tampak seperti ini.

Dalam opsi Embed, salin skrip yang dihasilkan dan tempelkan ke dalam tulisan Anda dalam modus HTML.

Tohtml

Jika Anda ingin menyalin dan menempelkan sintaks secara langsung, tohtml dapat menjadi salah satu pilihan Anda.

Tempelkan baris-baris kode Anda pada kotak Source code, pilih Style yang diinginkan, dan pilih Type scripts: TeX. Kemudian klik tombol Highlight.

Selanjutnya klik tombol Copy to clipboard dan tempelkan ke dalam tulisan Anda di blog.

Situs-situs sejenis yang dapat melayani Anda untuk keperluan ini antara lain pinetools, hilite.me, dan emn178. 

Ajblk

Yang satu ini sengaja penulis pisahkan tersendiri hanya karena memiliki pengaturan lanjutan yang berbeda dengan situs-situs yang telah disebutkan di atas. 

Tempelkan baris-baris kode Anda pada kotak 1, atur konfigurasinya pada kotak 2, 3, dan 4. Kemudian klik tombol Get Formatted HTML. Akhirnya Anda secara langsung dapat menyalin baris-baris kode beserta penomorannya dari kotak 6 untuk ditempelkan ke dalam tulisan Anda di blog.

Situs ajblk.github.io ini memang tidak menyediakan bahasa $\TeX$ maupun $\LaTeX$, namun Anda masih dapat memilih bahasa Perl. Selain itu, berkat opsi Show Gutter, Anda dapat menampilkan nomor baris pada kode dan garis tegak penyekatnya.

Penutup

Demikianlah Anda memiliki beberapa pilihan untuk menunjukkan baris-baris kode $\LaTeX$ di dalam tulisan Anda di blog, baik tanpa maupun dengan penomorannya. Anda dapat memilihnya sesuai dengan yang Anda perlukan. 

Demikian semoga bermanfaat. Bila Anda berminat untuk mempelajari $\LaTeX$ secara khusyuk, silakan bergabung ke Indonesia Digital Teacher atau hubungi @Kalakay via Telegram. 

$\square$ Adjie Gumarang Pujakelana 2020

Membuat Tabel: Multirow dan Rowcolor

Mukadimah

Anda tahu, suatu tabel dapat dibuat dengan atau tanpa menggunakan paket. Suatu tabel dibuat dengan menggunakan lingkup perintah. Dalam tulisan ini Anda akan berkonsentrasi pada lingkup perintah bawaan $\LaTeX$, yaitu tabular.

Contoh di atas menunjukkan bahwa Anda membuat tabel dalam tiga kolom. Kolom 1 diatur rata-kiri (l=left), kolom 2 diatur rata-tengah (c=center), dan kolom 3 diatur rata-kanan (r=right). Pada isi tabel, kolom-kolom itu disekat oleh lambang ampersand (&). Berikut ini beberapa hal yang layak Anda pertimbangkan ketika membuat tabel.

1. Sebaiknya tabel dibuat oleh paket booktabs, kecuali ketika Anda menggunakan pewarnaan pada baris-baris tabel. Paket booktabs menggunakan hanya garis mendatar pada tabel. Lazimnya garis mendatar itu, di atas kepala tabel dibuat oleh perintah \toprule; di bawah baris dibuat oleh \midrule; dan di bawah baris terakhir dibuat oleh \bottomrule; sedangkan untuk menggaris bawahi beberapa kolom tertentu dibuat oleh \cmidrule{...}.
2. Untuk pewarnaan pada tabel, sediakan paket xcolor dengan mencantumkan opsi table, selain opsi lainnya. \usepackage[table]{xcolor}.
3. Sediakan paket array untuk pengaturan ketinggian baris, pewarnaan baris, dan ketebalan garis.
4. Jika Anda akan menggunakan penggandaan (dua atau lebih) baris maka sediakan paket multirow.
5. Gunakan lingkup perintah minipage ketika Anda memuat daftar butir (enumarate atau itemize) atau ketika sel memuat teks yang cukup panjang.
6. Garis tegak | pada tabel dibuat dengan menekan tombol shift dan | yang terletak diatas tombol enter.
7. Penggandaan kolom dibuat oleh perintah \multicolumn{<banyak kolom>}{<perataan>}{<isi sel>}.
8. Penggandaan baris dibuat oleh perintah \multirow{<banyak baris>}{*}[opsi]{<isi sel>}.
9. Jika penggandaan kolom dan penggandaan baris dilakukan sekaligus maka letakkan perintah multirow sebagai isi sel di dalam perintah multicolumn, \multicolumn{...}{...}{\multirow{...}{*}[...]{...}}.
10. Gunakan paket caption, dengan menetapkan beberapa opsi yang diperlukan, jika Anda ingin membuat keterangan pada tabel.
11. Sebagai pilihan, Anda dapat menggunakan paket dan lingkup perintah tabularx, juga paket makecell (silakan pelajari dokumentasinya).

Menerapkan Penggandaan Kolom dan Penggandaan Baris

Misalkan Anda akan membuat tabel terdiri dari 7 kolom sebagai berikut. (Argumen *{7}c menyatakan bahwa Anda membuat 7 kolom dengan pengaturan yang sama, yaitu rata-tengah.)

Perhatikan Tabel 2. Sekarang Anda ingin menggunakan dua baris pertama untuk kepala tabel. Pada baris pertama Anda ingin menyatukan tiga kolom, yaitu kolom 3, 4, dan 5. Sedang pada masing-masing kolom 1, 2, 6, dan 7 Anda ingin menyatukan dua baris. Untuk hal itu Anda atur sebagai berikut.

Penggandaan Kolom, Penggandaan Baris, dan Pewarnaan Baris, Sel, dan Garis pada Tabel

Sekarang Anda ingin membuat tabel ``yang sebenarnya'' dan menggunakan pewarnaan, seperti tampak pada tabel 4. Untuk hal ini Anda lakukan seperti ketika membuat Tabel 3 tetapi cukup menggunakan perintah bawaan $\LaTeX$, bukan perintah dari paket booktabs.

Agar isi-isi sel ``dapat bernapas lega'', lebih dulu Anda dapat mengatur ketinggian baris dari semula $1$ menjadi (misalnya) $1.25$ oleh \renewcommand{\arraystretch}{1.25}. Anda juga dapat menetapkan jenis kolom tertentu untuk mengatur perataan dan lebarnya, \newcolumntype{C}{>{\centering\arraybackslash}m{5mm}} dengan C sebagai nama kolom, \centering\arraybackslash agar isi sel rata-tengah, dan m{...} berisi ukuran lebar kolom dan mengatur isi sel berada di tengah baris (m=middle). 

Perhatikan pembuatan Tabel 5.

Tampak bahwa isi sel pada kolom 1, 2, 6, dan 7 tertutupi oleh pewarnaan terhadap baris 2. Di sinilah Anda gunakan trik. Dalam perintah multirow dengan pewarnaan baris, letakkan perintah untuk isi sel pada keempat kolom itu di baris 8 (baris kedua dari penggandaan dua baris), bukan pada baris 7. Kemudian gunakan opsi (pada perintah multirow) untuk ``mengangkat'' isi sel pada keempat kolom tersebut dengan nilai positif yang sesuai. Misalnya, $4.5\,\textrm{mm}$. Perhatikan baris 8.

Penutup

Seperti halnya menggambar, membuat tabel memang memenuhi tantangan karena (dalam hal tertentu) cukup menyita kecerdikan dalam menyiasatinya. Meskipun tulisan ini sekadar menampilkan contoh kasus, semoga juga membawakan gagasan kepada Anda ketika membuat tabel lainnya. 

Demikian semoga bermanfaat. Bila Anda berminat untuk mempelajari $\LaTeX$ secara khusyuk, silakan bergabung ke Indonesia Digital Teacher atau hubungi @Kalakay via Telegram. 

$\square$ Adjie Gumarang Pujakelana 2020