⚡ 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 dan TikzJax 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.
• 📄 Export to PDF (Satu Klik): Ubah hasil pratinjau Anda menjadi dokumen PDF berukuran A4 yang sempurna langsung dari layar Webview tanpa instalasi TeX Live sama sekali!
• 🧠 Language Server Penuh: Dilengkapi dengan fitur bawaan Auto-Completion, Snippets pintar, Syntax Highlighting kustom untuk file .tex, resolusi banyak file (\input), dan Pratinjau Sorot (Hover Preview) untuk blok rumus matematika.

🚀 Penggunaan (Usage)

1. Buka berkas dengan ekstensi .tex di editor VS Code Anda.
2. Tekan pintasan (shortcut): Ctrl+Shift+L (Atau Cmd+Shift+L di Mac).
3. 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 mendukung berbagai perintah LaTeX modern untuk kebutuhan penulisan harian Anda:

• Rumus Matematika & Kimia: Inline Math ($...$, \(...\)), Display Math ($$...$$, \[...\]), hingga dukungan rumus kimia lanjutan (\ce{H2O}) berkat KaTeX mhchem.
• Struktur Dokumen & Multi-File: Halaman sampul, Heading (\section, \subsection), serta dukungan penyertaan file berlapis menggunakan \input{...}.
• Daftar Isi & Referensi Otomatis: Perintah \tableofcontents akan otomatis men-generate hierarki link, serta dukungan Cross-References penuh (\label dan \ref).
• Grafik TikZ Instan: Blok \begin{tikzpicture} akan langsung diproses dan digambar ulang dalam hitungan milidetik oleh mesin WebAssembly TikzJax!
• Pemformatan Teks & Kotak Kustom: Bold, Italic, Monospace, hingga environment kustom populer seperti tcolorbox, formulabox, notebox, dan mdframed dengan gaya CSS bawaan yang elegan.

(Catatan: Package grafis yang membutuhkan kompilasi biner kompleks seperti integrasi daftar pustaka eksternal (Biber) berada di luar lingkup, namun mayoritas kebutuhan drafting harian sudah tertutup sempurna).

📖 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.