Mari Berbingkai: Mengoptimalkan Penggunaan Paket Bclogo

Anda sudah mengenali pengemasan tulisan seperti tampak pada gambar di samping ini? Bila Anda menyebut bclogo maka jawaban Anda benar. Paket bclogo memanjakan Anda dalam penggunaan ``kotak'' dengan latar berwarna dengan disertai ``logo'' dan judul untuk tullisan Anda.

Bayangkan, Anda akan menulis pada sebuah papan berwarna, yang dapat Anda warnai oleh suatu warna tertentu atau membiarkannya dalam warna bawaan (Putih). Pada tepi papan dapat Anda buat ``lis'' dengan ketebalan tertentu atau membiarkannya dalam ketebalan bawaan ($0.4\,\textrm{pt}$) atau bahkan Anda dapat menggunakan papan itu tanpa lis. Pada pojok atas-kiri, Anda dapat menempatkan sebuah logo yang telah disediakan dalam paket bclogo atau logo milik Anda sendiri (berupa berkas dalam bentuk *.jpg, *.png, atau *.eps). Pada sisi kiri papan (di bawah logo) dapat Anda hias oleh salah satu dari beragam ``penghias'' (mengambil tempat serupa batang/bar/persegi panjang) yang telah disediakan dalam paket bclogo, atau Anda gunakan yang lainnya sesuai dengan selera Anda. Kemudian di kanan logo (pada bagian atas papan) dapat Anda tuliskan judul untuk tulisan Anda. Sedangkan tulisan Anda akan termuat di bawah judul dan di kanan penghias tadi.

Baiklah, sebelum dilanjutkan, sebaiknya lebih dulu Anda buka dan baca buku pintarnya (dalam bahasa Prancis). 😀

Bagaimana Cara Menggunakan Paket Bclogo?

Perhatikan contoh minimal (minimal working example) berikut ini.

Itu adalah contoh penggunaan paket bclogo secara bawaan (tanpa opsi). Anda peroleh ``papan'' Putih dengan logo bunga dan bar di kiri berupa garis tebal. Anda ingin mengubahnya?

Seperti Anda lihat, pada mukadimah, Anda cantumkan paketnya.

\usepackage[tikz]{bclogo}

Kemudian tulisan Anda dimuat di dalam lingkup perintah (environment) bclogo sebagai berikut.

\begin{bclogo}[<opsi>{<judul>} 
<Tulisan Anda>
\end{bclogo}

Bila Anda menginginkan hasil cetak (tampilan) dari penggunaan paket bclogo sesuai dengan selera Anda, maka Anda harus mengisi beberapa opsi pendukungnya. Apa sajakah itu?

• couleur. Untuk mengubah warna papan (bidang tulisan), couleur=<nama warna>.
• couleurTexte. Untuk mengubah warna teks pada tulisan Anda (bukan judul), couleurTexte=<nama warna>. 
• couleurBord. Untuk mengubah warna garis tepi papan (lis), couleurBord=<nama warna>. 
• couleurBarre. Untuk mengubah warna bar pada sisi kiri tulisan, couleurBarre=<nama warna>. 
• epBord. Untuk mengatur ukuran/ketebalan garis tepi papan, epBord=<nilai>. Nilai itu diisi oleh ukuran ketebalan (untuk satuan pt) yang diinginkan, tanpa mencantumkan satuannya.
• arrondi. Untuk melengkungkan sudut-sudut papan, arrondi=<nilai>. Dalam desimal, nilai yang diisikan dalam kisaran $0\le\textrm{nilai}\le1$.
• noborder. Untuk meniadakan garis tepi papan (lis), cantumkan noborder=true.
• marge. Untuk mengatur lebar teks ke arah margin kanan halaman, marge=<bilangan bulat>, ketika opsi noborder=true digunakan. Nilai negatif akan menambah lebar teks.
• margeG. margeD. Untuk menambah/menyusutkan lebar papan dari margin halaman, margeG=<nilai>, margeD=<nilai>. Nilai itu untuk satuan cm, tanpa dicantumkan satuannya. G = Gauche = kiri dan D = Droite = kanan. Anda dapat mencantumkan salah satu atau kedua-duanya dan nilai itu boleh negatif. 
• cadreTitre. Untuk menempatkan judul di tengah-atas papan dan berbingkai kotak, cadreTitre. Secara bawaan, judul tercetak tebal, berukuran large, tanpa bingkai, dan tercetak dari kiri setelah logo, berkat perintah \renewcommand\bcStyleTitre[1]{\large\textbf{#1}}. Nah, Anda dapat memberikan perintah tambahan di dalam argumen wajib pada perintah bawaan itu sesuai dengan selera Anda. Misalnya, \renewcommand\bcStyleTitre[1]{\hspace*{3mm}\bfseries\large\textsl{#1}}. Dapat pula Anda perintah tikz (node) secara inline.
• sousTitre. Untuk menyertakan subjudul (di kanan judul), sousTitre=<subjudul>. Untuk mengatur subjudul, dapat Anda gunakan perintah (misalnya) \renewcommand\bcStyleSousTitre[1]{\hfill\textsl{#1}}.
• logo. Untuk mencantumkan logo (gambar) di atas-kiri papan, logo=<perintah logo>. Untuk memilih perintah logo yang Anda perlukan, silakan buka buku pintarnya pada halaman 11 s.d. 13. Jika ingin Anda gunakan logo sendiri, lebih dulu Anda tetapkan perintah (misalnya) \newcommand{\anu}{\includegraphics[width=\logowidth]{<nama berkas gambar>}}, sehingga dapat Anda gunakan opsi logo=\anu. Secara bawaan, lebar logo ditetapkan $17\,\textrm{pt}$. Bila diperlukan, Anda dapat mengaturnya oleh perintah \setlength{\logowidth}{<nilai>pt}.
• ombre. Untuk menunjukkan bayangan (shadow) papan, ombre=true. Secara bawaan, ombre=false. Anda juga dapat mengatur ketebalan bayangan, epOmbre=<nilai>. Nilai itu untuk satuan cm dan secara bawaan lebar bayangan adalah $0.2\,\textrm{cm}$. Warna bayangan juga dapat Anda atur, couleurOmbre=<nama warna>. Secara bawaan warnya adalah black!30. Anda juga dapat menggunakan bayangan dalam opsi blur bila didukung oleh \usepackage[tikz,blur]{bclogo}. 
• barre. Untuk membuat ``garis'' (bar) pada bidang persegi panjang di sisi kiri tulisan (di bawah logo), barre=<bentuk>. Secara bawaan, Anda diberikan bar berbentuk garis lurus sebagai barre=line. Silakan buka buku pintarnya untuk memilih jenis bar yang lainnya. Tampak bahwa Anda dapat membuat bar sendiri dengan menggunakan opsi bar motif, imageExt, atau imageClip. 

Bagaimana Contohnya?

Untuk kualitas dokumen yang baik, tentu Anda akan gunakan segala sumber daya yang tersedia agar dihasilkan kualitas dokumen secara optimal. Seperti Anda lihat pada gambar pertama di atas, dalam penggunaan paket bclogo untuk dokumen itu, penulis juga menggunakan pendukung lain seperti paket tcolorbox, paket fontawesome, gambar eksternal, jenis huruf, dan pewarnaan.

Secara khusus, dalam penggunaan paket bclogo, kearifan Anda dalam menetapkan opsi-opsinya akan membawakan hasil dokumen yang menawan. Berikut ini sekadar contoh dokumen dengan penggunaan paket bclogo yang dapat Anda kembangkan lebih lanjut.

\documentclass{article}
\usepackage[a4paper]{geometry} % untuk tata halaman
\usepackage[tikz]{bclogo} % paket utama
\usepackage{charter} % jenis huruf
\usepackage{fontawesome} % untuk penggunaan icon
\usepackage{lipsum} % untuk contoh paragraf
\begin{document}
\renewcommand\bcStyleTitre[1]{\hspace*{3mm}\bfseries\large\textsl{#1}}
\begin{bclogo}[couleur=yellow,arrondi=0,logo=\bcbombe,barre=motif, motifBarre=\faBraille,noborder=true]{Ini judul} 
\textbf{Di sini tulisan Anda}. \lipsum[6]
\end{bclogo}
\end{document}

Demikian semoga bermanfaat.

$\square$ Adjie Gumarang Pujakelana 2019

Mnemonik Identitas Trigonometri

Tulisan ini, baik dari gambar maupun penulisan modus matematikanya, tergagas oleh wikipedia. Kemudian saya memikirkan agar tampilan materi ini di dalam dokumen $\small\LaTeX$ tampak menarik.

Menurut Kamus Besar Bahasa Indonesia,

mnemonik/mne·mo·nik/ /mnémonik/ n 1 Komp sandi untuk mempermudah ingatan menyusun tata olah komputer dl bahasa rakitan; 2 Psi rumus atau ungkapan untuk membantu mengingat-ingat sesuatu

Nah, tinjauan kita kali ini adalah mnemonik yang berkaitan dengan identitas trigonometri. Ini merupakan salah satu pilihan untuk mengingat sebagian di antara berbagai rumus dalam trigonometri. Silakan perhatikan dokumen berikut ini.



Tampak bahwa dokumen tersebut "kaya warna", oleh karena itu saya awali dengan menunjukkan paket untuk pewarnaan beserta penentuan beberapa warna yang digunakan. 

\usepackage[dvipsnames,svgnames]{xcolor}
\definecolor{Steelblue4}{rgb}{0.21,0.39,0.54}
\definecolor{color1}{RGB}{249,179,72}
\definecolor{color2}{RGB}{80,0,20}

Berikutnya, untuk membuat bingkai yang memuat judul dan gambar, saya gunakan paket tcolorbox beserta perintah dan environment yang diperlukan.

\usepackage[skins,breakable,many]{tcolorbox}
\newtcolorbox{Layar}{
  width={\linewidth},
  breakable,
  enhanced,
  colback=Steelblue4!7.5,
  colframe=Steelblue4,
  arc=0pt, outer arc=0pt,
  boxrule=0pt,
  toprule=0pt,
  bottomrule=0pt,
  enlarge top by=5mm,
  overlay ={
    \draw[Steelblue4,thick] ([xshift=5mm]frame.north west)--([yshift=5mm]frame.north)--([xshift=-5mm]frame.north east);
    \draw[fill=Steelblue4] ([yshift=4.5mm]frame.north) circle(3pt);
    \draw[line width=3pt, Steelblue4, shorten >=-3pt, shorten < = -3pt] (frame.north west)--(frame.north east);
    \draw[line width=3pt, Steelblue4, shorten >=-3pt, shorten < = -3pt] (frame.south west)--(frame.south east);
  }
}
\newenvironment{Tancap}
{\par\centering\begin{Layar}}{\end{Layar}\par}

Penggunaannya dalam batang tubuh dokumen dinyatakan dengan

\begin{Tancap}
\centering
{\Large\bfseries Mnemonik Identitas Trigonometri}

\bigskip
\begin{tikzpicture}
---perintah untuk gambar dengan paket tikz---;
\end{tikzpicture}
\end{Tancap}

Selanjutnya, paket tcolorbox juga saya gunakan untuk membingkai tulisan dalam modus Matematika. Pengaturannya saya tetapkan dengan perintah

\tcbset{
  highlight math style={
    enhanced,
    colframe=DarkSlateGray,
    colback=Khaki!50,
    arc=4pt,
    boxrule=1pt,
    drop fuzzy shadow
  }
}

Kemudian saya gunakan pengaturan itu di dalam environment dari paket empheq. Dengan demikian, di dalam preamble saya muat

\usepackage{empheq}

dan contoh penggunaannya dalam dokumen adalah sebagai berikut.

\begin{empheq}[box=\tcbhighmath]{align*}
\sin^2 x + \cos^2 x &= 1\\
\tan^2 x + 1 &= \sec^2 x\\
1 + \cot^2 x &= \csc^ x
\end{empheq}

Hal lainnya, jenis huruf yang saya gunakan adalah fourier (untuk teks dan Matematika) sedangkan "tanda kotak-kecil" dalam butir uraian saya gunakan dari paket pifont, yaitu \ding{111} (dalam environment itemize).

Demikian semoga bermanfaat.
Dokumen tersebut saya susun melalui Online LaTeX Editor ShareLaTeX. 

Adjie Gumarang Pujakelana 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