Unduh IguanaTex - Unduh kode sumber IguanaTex

IguanaTex

Kode sumber lainnya

v1.61

Unduh

IguanaTex

(C) Jonathan Le Roux dan Zvika Ben-Haim (Windows), Tsung-Ju Chiang dan Jonathan Le Roux (Mac)

Situs web: https://www.jonathanleroux.org/software/iguanatex/

IguanaTex adalah add-in PowerPoint yang memungkinkan Anda memasukkan persamaan LaTeX ke dalam presentasi PowerPoint Anda di Windows dan Mac. Ini didistribusikan sepenuhnya gratis, bersama dengan kode sumbernya.

Repositori ini menampung kode sumber dalam bentuk yang dapat dengan mudah dilacak, dibagikan, dan didiskusikan (kode VBA diekspor menggunakan makro EksporVBA).

Persyaratan Sistem

jendela

OS: Windows 2000 atau lebih baru (32 atau 64-bit).
PowerPoint:
- IguanaTex telah diuji dengan PowerPoint 2010, 2013, 2016, 2019 (32 dan 64 bit), Office 365, dan PowerPoint 2003. Kemungkinan juga berfungsi di PowerPoint 2000 dan 2007.
- Dukungan SVG tersedia untuk Office 365 dan PowerPoint versi ritel terbaru. Dukungan dikonfirmasi untuk PowerPoint 2021 setidaknya untuk versi 2108 dan yang lebih baru, dan kemungkinan besar (walaupun belum dikonfirmasi) untuk PowerPoint 2019 dan bahkan mungkin PowerPoint 2016 untuk versi yang sama. Perhatikan bahwa versi berlisensi volume, yaitu versi 1808 pada Agustus 2023, tidak mendukung konversi SVG ke Shape, yang diperlukan oleh IguanaTex.
LaTeX: TeXLive atau MiKTeX
GhostScript (jika versi terbaru menimbulkan masalah, coba gs9.26)
GambarMagick
(Opsional) TeX2img, digunakan untuk keluaran grafik vektor melalui EMF (Unduh).

Mac

Intel atau Apple Silicon Mac
- Pada Mac berbasis Apple Silicon, PowerPoint perlu dijalankan dengan pengaturan "Buka menggunakan Rosetta."
PowerPoint untuk Mac:
- Powerpoint 2019 atau Office 365
- PowerPoint 2016 (Versi 16.16.7 190210 atau lebih baru) (harus dikonfirmasi; beberapa fitur, misalnya SVG, mungkin tidak berfungsi)
MacTeX: Pastikan Anda menginstal libgs untuk dukungan SVG, dengan memilih "Sesuaikan" pada langkah "Jenis Instalasi" pada penginstal MacTex. (Saya belum menemukan cara untuk menginstal libgs melalui TexLive setelah instalasi awal, jika Anda mengetahuinya tolong beri tahu saya)

Unduh dan Instal

jendela

Unduh file add-in .ppam dari halaman Rilis repositori ini, atau dari halaman Unduh IguanaTex, dan simpan di Lokasi Tepercaya (lihat artikel Microsoft ini), seperti %appdata%MicrosoftAddins (yaitu, C:Usersuser_nameAppdataRoamingMicrosoftAddins ).
Muat add-in : di "File" > "Options" > "Add-Ins" > "Manage:" (bagian bawah jendela), pilih "PowerPoint Add-Ins" di kotak pilihan. Lalu tekan "Go...", lalu klik "Tambah Baru", pilih file .ppam di folder tempat Anda mendownloadnya, lalu "Tutup" (jika Anda mendownload sumber .pptm dan menyimpannya sebagai .ppam , maka akan berada di folder Add-In default).
Membuat dan mengatur folder file sementara : IguanaTex memerlukan akses ke folder dengan izin baca/tulis untuk menyimpan file sementara.
- Standarnya adalah "C:Temp". Jika Anda memiliki izin menulis di bawah "C:", buat folder "C:Temp". Anda sudah siap.
- Jika Anda tidak dapat membuat folder ini, pilih atau buat folder dengan izin menulis di lokasi lain mana pun. Di tab IguanaTex, pilih "Pengaturan Utama" dan masukkan path ke folder pilihan Anda. Anda juga dapat menggunakan jalur relatif di bawah folder presentasi (misalnya, "." untuk folder presentasi itu sendiri).
Instal dan setel jalur ke GhostScript dan ImageMagick (diperlukan untuk keluaran Gambar, kecuali jika menggunakan mesin "Lateks (DVI)"):
- Diperlukan untuk mengonversi file PDF perantara menjadi PNG sebelum dimasukkan ke dalam PowerPoint sebagai objek Gambar. Dalam proses pembuatan Gambar, semua mesin LaTeX kecuali "Lateks (DVI)" menghasilkan file PDF. Bahkan saat membuat Bentuk, sering kali lebih baik membuat Gambar terlebih dahulu lalu mengonversinya ke Bentuk: Pembuatan Gambar lebih cepat dan lebih kuat, sehingga akan lebih mudah untuk mengerjakan tampilan dalam mode Gambar lalu melakukan konversi akhir ke Bentuk, sambil mempertahankan ukurannya.
- Tetapkan path lengkap ke gswin32c.exe atau gswin64c.exe (perhatikan " c "!) dan ke magick.exe ImageMagick di jendela "Pengaturan Utama".
- Cara terbaik untuk memastikan jalurnya benar adalah dengan menggunakan tombol "..." di samping setiap jalur dan menavigasi ke file yang benar.
- Beberapa jalur default termasuk %USERPROFILE% . Disarankan untuk mengklik "..." untuk memastikan jalur dikonversi dengan benar ke jalur profil pengguna sebenarnya.
(Opsional) Instal dan setel jalur ke TeX2img :
- Hanya diperlukan untuk dukungan grafik vektor melalui EMF (dibandingkan dengan SVG, kelebihan EMF adalah: tersedia di semua versi PowerPoint, bentuk dapat dimodifikasi sepenuhnya; kekurangan: beberapa tampilan mengalami distorsi secara acak)
- Unduh dari tautan ini (detail lebih lanjut tentang TeX2img di repo Github mereka)
- Setelah membongkar TeX2img di suatu tempat di mesin Anda, jalankan TeX2img.exe sekali agar secara otomatis mengatur berbagai jalur ke lateks/ghostscript, kemudian mengatur jalur lengkap ke TeX2imgc.exe (perhatikan " c "!) di jendela "Pengaturan Utama" .
(Opsional) Instal metadata LaTeXiT :
- Diperlukan untuk mengonversi tampilan yang dihasilkan dengan LaTeXiT di Mac menjadi tampilan IguanaTex
- Unduh LaTeXiT-metadata-Win.zip dari halaman Rilis, unzip, dan atur jalur ke LaTeXiT-metadata.exe di jendela "Pengaturan Utama".
- Metadata LaTeXiT disiapkan dengan baik oleh Pierre Chatelier, penulis LaTeXiT, atas permintaan saya. Terima kasih banyak padanya!
- Kode sumber sekarang bersifat publik.

Pengaturan lainnya :

Jika Anda memiliki instalasi LaTeX non-standar, Anda dapat menentukan di Pengaturan Utama folder tempat file executable disertakan.
Jika Anda ingin memiliki opsi untuk menggunakan editor eksternal, misalnya, saat melakukan debug kode sumber LaTeX, Anda dapat menentukan jalur ke editor tersebut di Pengaturan Utama. Jika Anda ingin menggunakan editor tersebut secara default pada jendela edit IguanaTex, centang kotak "gunakan sebagai default".

Mac

Instalasi otomatis dengan Homebrew

Jika Anda menggunakan Homebrew, instalasinya sesederhana:

brew tap tsung-ju/iguanatexmac
brew install --cask --no-quarantine iguanatexmac latexit-metadata

Kemudian ikuti 5. Verifikasi bahwa jalur telah diatur dengan benar dalam petunjuk instalasi Manual di bawah.

Untuk rincian lebih lanjut (misalnya, cara meningkatkan atau mencopot pemasangan ), silakan lihat petunjuk Homebrew Tsung-Ju.

Instalasi manual

Unduh zip "file bawaan untuk Mac" dari halaman Rilis repositori ini
Ada 3 file untuk diinstal:
- IguanaTex.scpt : File AppleScript untuk menangani akses file dan folder
- libIguanaTexHelper.dylib : perpustakaan untuk membuat tampilan teks asli; kode sumber disertakan dalam repo git, di bawah "IguanaTexHelper/"
- IguanaTex_v1_XX_Y.ppam : file tambahan utama
Instal IguanaTex.scpt

mkdir -p ~ /Library/Application  Scripts/com.microsoft.Powerpoint
cp ./IguanaTex.scpt ~ /Library/Application  Scripts/com.microsoft.Powerpoint/IguanaTex.scpt

Instal libIguanaTexHelper.dylib

sudo mkdir -p ' /Library/Application Support/Microsoft/Office365/User Content.localized/Add-Ins.localized '
sudo cp ./libIguanaTexHelper.dylib ' /Library/Application Support/Microsoft/Office365/User Content.localized/Add-Ins.localized/libIguanaTexHelper.dylib '

Muat add-in : Mulai PowerPoint (mulai ulang jika dijalankan saat menginstal dylib). Dari bilah menu, pilih Alat > Add-in PowerPoint... > '+' , dan pilih IguanaTex_v1_XX_Y.ppam
- Pertama kali Anda mengklik salah satu tombol add-in, Anda mungkin diberi tahu bahwa libIguanaTexHelper.dylib diblokir. Buka Pengaturan Mac, lalu Keamanan dan Privasi, dan klik "Izinkan Saja".
Verifikasi bahwa jalur disetel dengan benar :
- Klik pada "Pengaturan Utama" di tab pita IguanaTex, dan verifikasi bahwa jalur ke GhostScript, biner LaTeX, dan libgs.9.dylib (digunakan dalam konversi SVG) diatur dengan benar dengan mengklik setiap tombol "..." di sebelah mereka: jika jalurnya benar, ini akan membawa Anda ke lokasinya; jika tidak, Anda harus menavigasi ke jalur yang relevan. Standarnya harus sesuai dengan lokasi instalasi MacTex, tetapi instalasi Anda mungkin berbeda.
- Jika Anda tidak dapat menemukannya atau jika IguanaTex mengeluh bahwa perintah tidak kembali, buka terminal dan gunakan locate gs , locate pdflatex , dan locate libgs .
(Opsional) Instal metadata LaTeXiT :
- Diperlukan untuk mengonversi tampilan yang dihasilkan dengan LaTeXiT di Mac menjadi tampilan IguanaTex
- Unduh LaTeXiT-metadata-macos dari halaman Rilis, tambahkan izin yang dapat dieksekusi, dan atur jalur ke lokasinya di jendela "Pengaturan Utama" atau salin ke folder tambahan yang aman:
  chmod 755 ./LaTeXiT-metadata-macos
  sudo cp ./LaTeXiT-metadata-macos '/Library/Application Support/Microsoft/Office365/User Content.localized/Add-Ins.localized/'
- Saat pertama kali LaTeXiT-metadata-macos dipanggil oleh IguanaTex, Mac OS mungkin memblokirnya. Buka Pengaturan Mac, lalu Keamanan dan Privasi, dan klik "Izinkan Saja".
- Eksekusinya dikompilasi pada Mac OS 10.13 tetapi dapat berfungsi pada semua versi. Tolong beri tahu saya jika Anda memiliki masalah apa pun.
- Metadata LaTeXiT disiapkan dengan baik oleh Pierre Chatelier, penulis LaTeXiT, atas permintaan saya. Terima kasih banyak padanya!
- Kode sumber sekarang bersifat publik.

Trik yang tidak jelas

Penggunaan IguanaTex seharusnya cukup jelas, namun ada beberapa tip dan trik yang mungkin tidak.

Tombol akselerator (yaitu pintasan keyboard): banyak perintah IguanaTex ("Hasilkan", "Batal", dll) dapat diakses dengan menggunakan kombinasi tombol pengubah dan satu huruf. Cari huruf yang digarisbawahi pada teks/label tombol yang bersangkutan.
Windows: Alt + huruf. Misalnya, daripada mengeklik " G tombol enerate", Anda dapat menggunakan Alt + g . (Ini adalah perilaku standar Office di Windows)
Mac: Ctrl + Cmd + huruf. Misalnya, daripada mengeklik " G tombol enerate", Anda dapat menggunakan Ctrl + Cmd + g . (Tombol akselerator tidak tersedia di Office standar untuk Mac, ini dikodekan khusus oleh Tsung-Ju untuk IguanaTex)

Masalah yang Diketahui

Tampilan "Gambar" yang dibuat di Mac (yang disisipkan PDF) memiliki margin tambahan kecil di sekelilingnya sehingga tidak tampak terpotong di Windows. Pada versi sebelumnya, tidak ada margin tetapi tampilan akan tampak terpotong. Tampaknya ini merupakan bug pada cara PowerPoint menangani beberapa PDF di Mac, menyimpannya secara internal sebagai file EMF. Namun, PDF yang dibuat oleh LaTeXiT tidak memiliki masalah tersebut, jadi mungkin ada cara untuk menghindari bug ini di versi IguanaTex yang akan datang.
Makro IguanaTex tidak dapat ditambahkan ke Quick Access Toolbar di Mac: ini adalah bug umum yang diduga sedang dikerjakan oleh Microsoft.
Mungkin ada beberapa masalah penskalaan saat mengubah format file (Gambar <-> Bentuk, atau bahkan dalam berbagai format Bentuk SVG dan EMF). Cara terbaik untuk mengatasinya adalah dengan menggunakan fungsi "Konversi ke Bentuk"/"Konversi ke Gambar", yang membuat ulang tampilan dalam format yang diinginkan sambil menjaga ukurannya tetap. Seseorang kemudian dapat memodifikasi konten lebih lanjut jika diperlukan, dan penskalaannya akan tepat.
Untuk tampilan Bentuk (yaitu grafik vektor), disarankan menggunakan default "SVG via DVI w/ dvisvgm" karena masalah yang terkadang terjadi pada mode lain:
- Beberapa tampilan yang diperoleh melalui "EMF w/ TeX2img" atau "EMF w/ pdfiumdraw" tampak terdistorsi. Ini adalah bug PowerPoint yang terkadang terjadi saat memisahkan file EMF ke dalam objek Shape.
- Beberapa tampilan yang diperoleh dengan "SVG via PDF w/ dvisvgm" memiliki simbol atau bagian simbol yang hilang. Hal ini karena garis tertentu direpresentasikan dalam PDF dengan jalur terbuka dengan lebar garis tertentu, bukan jalur tertutup, dan oleh karena itu ditangani secara berbeda oleh PowerPoint saat mengonversi ke objek Bentuk. Lihat diskusi ini untuk lebih jelasnya.