⚡ ZenTeX
Instant, lightweight, zero-config LaTeX live preview for Visual Studio Code.
ZenTeX adalah ekstensi Visual Studio Code yang menghadirkan pengalaman pratinjau (live preview) dokumen LaTeX secepat kilat. Terinspirasi dari kesederhanaan pratinjau Markdown bawaan, ZenTeX memungkinkan Anda melihat hasil draf LaTeX secara instan tanpa perlu menginstal compiler TeX eksternal (seperti TeX Live atau MiKTeX) yang berukuran raksasa.
Sempurna untuk mahasiswa, penulis teknis, akademisi pemula, atau siapa pun yang ingin sekadar memvalidasi penulisan rumus matematika dan draf struktur dokumen LaTeX mereka dengan cepat dan hemat memori.
✨ Fitur Unggulan
- 🚀 Zero Configuration: Instal dan langsung gunakan. Tidak ada environment variables, tidak ada pengaturan compiler eksternal. Semua berjalan murni dari dalam ekstensi.
- ⚡ Performa Render Instan (< 500ms): Ditenagai oleh KaTeX di dalam VS Code Webview, ZenTeX merender dokumen Anda secara real-time ke HTML tanpa kompilasi PDF biner di latar belakang.
- 🔄 Live Sync & Debounce: Pratinjau akan langsung diperbarui saat Anda menyimpan dokumen (
Ctrl+S), atau secara real-time saat Anda mengetik (dengan algoritma debounce untuk menghemat penggunaan CPU).
- 🎨 Integrasi Tema Dinamis: ZenTeX secara otomatis menyesuaikan warna latar belakang dan teks dokumen agar selaras dengan warna tema editor VS Code yang sedang Anda gunakan (Dark/Light/High-Contrast Mode).
🚀 Penggunaan (Usage)
- Buka berkas dengan ekstensi
.tex di editor VS Code Anda.
- Tekan pintasan (shortcut):
Ctrl+Shift+L (Atau Cmd+Shift+L di Mac).
- Panel pratinjau ZenTeX akan langsung terbuka berdampingan (beside) dengan teks editor Anda, menampilkan visualisasi instan dari dokumen tersebut.
(Alternatif: Buka Command Palette dengan Ctrl+Shift+P, lalu ketik dan jalankan perintah ZenTeX: Show LaTeX Instant Preview).
⚙️ Konfigurasi Ekstensi
ZenTeX menyediakan beberapa pengaturan yang bisa Anda ubah di settings.json VS Code Anda:
| Pengaturan |
Default |
Deskripsi |
zentex.preview.liveSyncMode |
"onSave" |
Pilih "onSave" untuk update saat file disimpan, atau "typing" untuk update otomatis secara live saat mengetik. |
zentex.preview.debounceDelay |
300 |
(Dalam ms). Jeda waktu sebelum pratinjau di-render ulang saat Anda mengetik (hanya berlaku jika liveSyncMode diatur ke "typing"). |
zentex.preview.fontSize |
15 |
Ukuran font dasar yang digunakan pada panel pratinjau Webview. |
📚 Apa Saja yang Didukung?
ZenTeX berfokus untuk menjadi perangkat pembuat draf. Karena tidak menggunakan compiler PDF sejati, berikut adalah hal-hal yang didukung:
- Rumus Matematika: Inline Math (
$...$, \(...\)) dan Display Math ($$...$$, \[...\], \begin{equation}, dll) berkat dukungan KaTeX yang luar biasa.
- Struktur Dasar: Halaman sampul (
\begin{titlepage}), Heading (\section, \subsection), Paragraphs, Abstracts.
- Daftar & Tabel:
itemize, enumerate, dan dukungan tabel (tabular, \toprule) dasar.
- Pemformatan Teks: Font grup (
{\bfseries ...}, {\Large ...}), Bold (\textbf), Italic (\textit), Monospace (\texttt), garis baru dengan jarak khusus (\\[0.3cm]), dll.
- Kotak Kustom & Catatan: Mendukung environment
tcolorbox, formulabox, notebox, dan mdframed dengan gaya CSS bawaan yang modern.
- Referensi & Lainnya: Tautan
\url, Daftar Isi placeholder (\tableofcontents), dan daftar rujukan thebibliography.
(Catatan: Package grafis yang membutuhkan kompilasi biner kompleks seperti integrasi daftar pustaka eksternal (Biber) atau pembuatan gambar vektor menggunakan TikZ berada di luar lingkup (out-of-scope) dan akan dirender sebagai visual placeholder elegan dalam pratinjau ZenTeX).
📖 Dokumentasi Pengembang
Untuk mengetahui lebih lanjut terkait dokumen bisnis dan spesifikasi teknis arsitektur proyek, silakan navigasi ke kumpulan dokumentasi di folder docs/:
👉 Buka Indeks Dokumentasi (docs/README.md)
🤝 Kontribusi
Kami sangat menyambut kontribusi (Pull Requests)! Anda dapat merujuk pada dokumen spesifikasi kebutuhan (SRS) di folder docs/ untuk memahami arsitektur Webview dan skema perpesanan IPC yang kami gunakan.
📜 Lisensi
Proyek ZenTeX ini dirilis di bawah lisensi MIT. Anda bebas menggunakan, memodifikasi, dan mendistribusikan perangkat lunak ini.
