Showing posts with label minted. Show all posts
Showing posts with label minted. Show all posts

Saturday, January 28, 2017

Minted: Pilihan yang "Mahal"

Mukadimah

Bekerja dalam TeX Live dengan penyunting TeXworks sesekali menemui hal yang "ngeri-ngeri sedap", seperti ketika mengkompilasi dokumen yang memuat paket asymptote atau paket minted. Hal itu disebabkan adanya penggunaan pendukung yang diperoleh dari luar sistem TeX Live.
Paket minted memfasilitasi dalam hal menyoroti (high­light­ing) sintaks pada dokumen $\small\LaTeX$ secara ekspresif berkat dukungan dari kepustakaan pygments yang kuat. Paket minted juga menyediakan pilihan untuk menyesuaikan tampilan kode yang disorot dalam bentuk verbatim berhiaskan warna. Anda dapat melihat ulasan sebelumnya tentang hal ini di sini dan di sana. Nah, pygments inilah yang tidak tersedia di dalam TeX Live.
Di forum terdapat beberapa petunjuk untuk menyiasati agar paket minted dapat digunakan di dalam TeX Live, tetapi (hingga saat ini) saya belum berhasil melakukannya. Akhirnya pilihan saya jatuh kepada Anaconda3-4.2.0, meskipun saya harus "membayar mahal" senilai 341MB untuk memasangnya pada Windows 8.1 versi x86.

Apa yang Harus Dilakukan?

Dua hal yang harus kita lakukan agar kita dapat menggunakan paket minted di dalam TeX Live.
  1. Memasang Anaconda3-4.2.0 pada komputer. Silakan unduh dulu di situ kemudian ikuti petunjuk pemasangan yang muncul hingga pemasangannya selesai.
  2. Mengatur penyunting TeXworks untuk menggunakan fitur shell escape.
Untuk hal kedua dilakukan sebagai berikut.
Buka penyunting TeXworks, kemudian klik "Edit" lalu klik "Preferences ...".
Berikutnya, pada jendela popup yang muncul klik "Typesetting" lalu pada menu Processing tools klik "pdfLaTeX" kemudian klik "Edit".
Pada kotak Name kita dapat mengisinya sesuai dengan selera kita, misalnya "pdfLaTeX+shell escape". Sekarang klik tombol bertanda plus, kemudian tuliskan "--shell-escape". Setelah itu klik tanda panah ke atas untuk menggeser tulisan tadi satu langkah ke atas agar berada di atas $fullname. Terakhir, klik "OK".

Contoh Penggunaan

Sekarang kita sudah dapat menggunakan paket minted di dalam TeX Live. Tentu terdapat beberapa fitur dan opsi di dalam paket minted yang dapat kita pilih dan gunakan sesuai dengan keperluannya. Untuk mempelajari hal itu, silakan buka dokumentasinya. Sebagai contoh, silakan Anda salin dan kompilasi sintaks dokumen berikut ini. Hasilnya akan terlihat seperti gambar pertama di atas.
\documentclass[12pt]{article}
\usepackage[a4paper,margin=2cm]{geometry}
\usepackage{xcolor}
\usepackage{minted}
\definecolor{bistre}{RGB}{133, 109, 77}

\begin{document}

\begin{minted}[
    frame=lines,
    framerule=1pt,
    framesep=5pt,
    rulecolor=\color{bistre}
            ]{latex}
\documentclass[border=3pt]{standalone}
\usepackage{qrcode}
\begin{document}
\qrcode[height=5cm]{Matematika Nusantara}
\end{document}
\end{minted}

\end{document}

Penutup

Selain untuk menyoroti kode $\small\LaTeX$, paket minted juga dapat digunakan untuk menyoroti kode python di dalam dokumen $\small\LaTeX$.
Demikian semoga bermanfaat.

$\square$ Adjie Gumarang Pujakelana 2017

Sunday, June 26, 2016

Menampilkan Pengkodean dalam Dokumen LaTeX

Mukadimah

Untuk suatu keperluan tertentu, kita kadang ingin menunjukkan kepada pembaca tentang suatu pengkodean yang menghasilkan teks/gambar yang dihasilkan. Meskipun demikian, memang masih diperlukan keterangan tambahan secara terpisah tentang paket dll yang digunakan untuk itu, baik di dalam mukadimah (preamble) maupun di dalam badan dokumen (main body).
Bagaimana cara menunjukkan kepada pembaca tentang pengkodean untuk gambar di samping ini? Ada beberapa cara yang dapat dilakukan untuk itu, tetapi kali ini akan saya tunjukkan empat cara, yaitu dengan menggunakan
  1. lingkup perintah (environment) verbatim 
  2. paket listings 
  3. paket minted 
  4. paket showexpl 

Menampilkan Kode dengan Menggunakan Verbatim

Lingkup perintah verbatim telah disediakan oleh $\small\LaTeX$, oleh karena itu kita dapat langsung menggunakannya dengan menuliskan
\begin{verbatim} 
Tulis kode di sini 
\end{verbatim}
Dengan menggunakan lingkup perintah verbatim, kode untuk gambar tersebut dapat diperlihatkan oleh
\begin{verbatim}
\begin{tikzpicture}
\node (a) at (0,0) {$\tan x$};
\node (b) at (4,0) {$\sec^2 x$};
\draw[-latex,bend left,blau]  (a) edge (b) ;
\draw[-latex,bend left,Tomato]  (b) edge (a);
\path[blau] (a) -- (b) node[midway,above,yshift=.8cm] {\small diferensial};
\path[Tomato] (b) -- (a) node[midway,below,yshift=-.8cm] {\small integral};
\end{tikzpicture}
\end{verbatim}
Hasilnya seperti ini


Menampilkan Kode dengan Menggunakan Paket Listings

Seperti terlihat di atas, hasil dari lingkup perintah verbatim tampak ``biasa'' saja. Mungkin akan tampak lebih menarik bila, misalnya, kode itu diletakkan di dalam suatu bingkai (frame) dan dilatari oleh suatu warna. Kita dapat melakukan itu dengan menggunakan paket listings. Lebih dulu, dalam mukadimah kita muat paket listings beserta pengaturan dalam penggunaannya, misalnya
\usepackage{listings}
\lstset{
basicstyle=\ttfamily,frame=lines,
framexleftmargin=0.5em,framexrightmargin=0.5em,
backgroundcolor=\color{LemonChiffon}
}
kemudian kita menuliskan kodenya dan mengatur lebar bingkainya, misalnya
\begin{lstlisting}[linewidth=10cm]
Tulis kode di sini
\end{lstlisting}
Hasilnya seperti ini
Hal-hal lainnya sehubungan dengan penggunaan paket listings dapat dipelajari dalam dokumentasinya.


Menampilkan Kode dengan Menggunakan Paket Minted

Seperti telihat di atas, meskipun paket listing dapat menampilkan kode berbingkai disertai oleh pewarnaan pada latarnya tetapi teks yang dihasilkan berwarna dasar (hitam). Mungkin akan tampak lebih menarik bila digunakan warna berbeda pada teks tersebut. Inilah yang dilakukan oleh paket minted. Lebih dulu, dalam mukadimah kita muat \usepackage{minted} kemudian kita menuliskan kodenya, misalnya, sebagai berikut.
\begin{minted}[
    frame=lines,
    framerule=1pt,
    framesep=5pt,
    rulecolor=\color{bistre}
            ]{latex}
Tuliskan kode di sini
\end{minted}
Dengan menggunakan paket minted, kode untuk gambar tersebut dapat diperlihatkan oleh
\begin{minted}[
    frame=lines,
    framerule=1pt,
    framesep=5pt,
    rulecolor=\color{bistre}
            ]{latex}
\begin{tikzpicture}
\node (a) at (0,0) {$\tan x$};
\node (b) at (4,0) {$\sec^2 x$};
\draw[-latex,bend left,blau]  (a) edge (b) ;
\draw[-latex,bend left,Tomato]  (b) edge (a);
\path[blau] (a) -- (b) node[midway,above,yshift=.8cm] {\small diferensial};
\path[Tomato] (b) -- (a) node[midway,below,yshift=-.8cm] {\small integral};
\end{tikzpicture}
\end{minted}
Hasilnya seperti ini
Hal-hal lainnya sehubungan dengan penggunaan paket minted dapat dipelajari dalam dokumentasinya.


Menampilkan Kode dengan Menggunakan Showexpl

Sesuai dengan namanya, kelebihan dari paket showexpl adalah dapat menunjukkan gambar yang dibuat sekaligus dengan menunjukkan kodenya, disertai dengan penomoran pada tiap barisnya. Pada opsinya, kita juga dapat memberinya garis bingkai dan warna pada latarnya, sedangkan teks hanya dalam satu warna. Lebih dulu, dalam mukadimah kita muat paket showexpl beserta pengaturan dalam penggunaannya, misalnya 
\usepackage{showexpl}
\lstdefinestyle{gayaku}{
    backgroundcolor=\color{BurlyWood!15},
    numberstyle=\footnotesize, 
    numbersep=5pt,
    rframe=
}
kemudian kita menuliskan kodenya dan mengatur lebar bingkainya, misalnya
\begin{LTXexample}[style=gayaku,width=.3\linewidth,pos=l]
Tuliskan kode di sini
\end{LTXexample}
Opsi tersebut memerintahkan $\small\LaTeX$ untuk menggunakan pengaturan ``gayaku'' yang telah ditetapkan dalam mukadimah, ``kolom'' halaman terbagi atas 30% untuk gambar dan 70% untuk kodenya, kemudian gambar diletakkan di kiri (l = left). Perhatikan contoh penggunaannya berikut ini.
\begin{LTXexample}[style=gayaku,width=.3\linewidth,pos=l]
\begin{tikzpicture}
\node (a) at (0,0) {$\tan x$};
\node (b) at (4,0) {$\sec^2 x$};
\draw[-latex,bend left,blau]  (a) edge (b) ;
\draw[-latex,bend left,Tomato]  (b) edge (a);
\path[blau] (a) -- (b) 
node[midway,above,yshift=.8cm] {\small diferensial};
\path[Tomato] (b) -- (a) 
node[midway,below,yshift=-.8cm] {\small integral};
\end{tikzpicture}
\end{LTXexample}
Hasilnya seperti ini

Penutup

Demikianlah sesuai dengan keperluannya kita menunjukkan kode atas hasil gambar (atau teks) yang kita buat dengan menggunakan salah satu dari keempat pilihan tersebut.
Semoga tulisan ini bermanfaat.

$\square$ Adjie Gumarang Pujakelana 2016

Sunday, March 22, 2015

Minted

Ketika saya menulis atau menggambar sesuatu, saya ingin pembaca dokumen yang saya susun itu dapat melakukan hal yang sama dengan mengikuti pengkodean yang saya tunjukkan. Secara umum, saya dapat melakukannya dengan menggunakan environment verbatim atau (untuk yang ringkas) saya nyatakan dalam \verb!...! atau dalam {\ttfamily ...}. Bagaimana kalau sintaks pengkodean itu saya soroti (highlighting) dengan "taburan" warna, seperti tampak pada gambar di samping?

Inilah hal baru (bagi saya) yang saya peroleh ketika sedang bekerja dalam menerjemahkan dokumentasi paket tkz-euclide, sebuah paket dari Alain Matthes yang merupakan alat untuk menggambar Geometri Euclides. Perhatikan contoh berikut ini.
Anda, pembaca, yang sedang membaca dokumen yang memuat gambar tersebut mungkin bertanya, "Bagaimana cara membuat gambar itu?". Nah, agar pembaca mengetahui pengkodeannya, saya tunjukkan
Lalu, bagaimana caranya untuk menunjukkan itu?
Tentu berbeda dengan menunjukkan berbagai pengkodean yang telah saya lakukan dalam blog ini. Karena ini dimaksudkan agar tampak dalam dokumen yang disusun, maka di sinilah saya memerlukan paket minted. Paket minted berguna untuk menyoroti (highlighting) kode sumber dalam $\small\LaTeX$, yang memudahkan penyorotan sintaks secara tepat dan jelas berkat digunakannya library Pygments yang kuat. Paket ini juga menyediakan pilihan untuk menyesuaikan penampakkan kode sumber yang disorot dengan menerapkan paket fancyvrb.

Untuk menunjukkan sintaks pengkodean tersebut, dalam preamble saya muat
\usepackage{minted}
\usepackage{tcolorbox}
\usepackage{etoolbox}
\BeforeBeginEnvironment{minted}{\begin{tcolorbox}}%
\AfterEndEnvironment{minted}{\end{tcolorbox}}%
Paket tcolorbox dan etoolbox beserta pengaturan environment-nya disiapkan untuk pengkotakkannya. Dalam penggunaannya, environment tersebut dinyatakan dengan
\begin{minted}{latex}
...
\end{minted}
Untuk menampakkan pengkodean seperti ditunjukkan oleh gambar pertama, yang mengawali tulisan ini, saya muat
\usepackage{minted}
\definecolor{bistre}{RGB}{133, 109, 77}
dalam preamble dan dalam penggunaan environment-nya dinyatakan
\begin{minted}[frame=lines,framerule=1pt,framesep=5pt,rulecolor=\color{bistre}]{latex}
...
\end{minted}
Demikianlah contoh-contoh pembuatan gambar di atas saya susun melalui Online LaTeX Editor ShareLaTeX. 
Demikian semoga bermanfaat.

Adjie Gumarang Pujakelana 2015 


Related Posts Plugin for WordPress, Blogger...