Di halaman ini

Menyesuaikan Tombol Bilah Kontrol

Ringkasan

Bilah Kontrol dibagi menjadi dua bagian:

  • Kiri (tingkat berkas): Integrasi dengan aplikasi eksternal dan tindakan cepat (misalnya, "Buka dengan...", "Tampilkan di File Explorer"). Bagian ini dapat dikonfigurasi di Pengaturan - Kontrol.
  • Kanan (tingkat pratinjau): Kontrol viewport pratinjau (misalnya, putar, bisukan, perbesar).

Panduan ini berfokus pada perluasan bagian Kiri.

Menambahkan Kontrol

Di Pengaturan - Kontrol, Anda dapat mengelola tombol bawaan, membuat tindakan kustom, atau memasang plugin kontrol.

1. Tindakan Kustom

  1. Klik + di bawah daftar tindakan dan pilih program atau skrip yang ingin dijalankan.
  2. Konfigurasikan detail tindakan di panel kanan:
    • Nama: Nama tampilan yang ditampilkan di tooltip.
    • Executable: Jalur ke file yang dapat dieksekusi tujuan (.exe).
    • Argumen: Argumen baris perintah. Gunakan placeholder seperti "${input_file}" untuk meneruskan jalur berkas.
    • Format File: Ekstensi file target (misalnya, png, zip) atau Token Khusus (misalnya, ${type_folder}).
    • Tutup jendela setelah peluncuran berhasil: Menutup jendela pratinjau setelah program eksternal berhasil diluncurkan. Seer tidak menunggu program selesai berjalan.

2. Plugin Kontrol

Plugin kontrol menyediakan paket tindakan siap pakai. Ini terpisah dari tindakan kustom yang menggunakan program atau skrip yang sudah Anda miliki.

Plugin Kontrol Resmi

Paket plugin kontrol resmi telah dikumpulkan di pusat unduhan. Silakan kunjungi Unduhan Plugin - Kontrol untuk mengunduh paket .zip. Paket dapat diimpor langsung tanpa diekstrak.

Pasang Berkas Unduhan

  1. Di Pengaturan > Kontrol, klik + di bawah daftar.
  2. Pilih berkas .zip yang diunduh secara langsung, atau pilih plugin.json dari paket yang diekstrak lengkap.
  3. Tinjau format dan perilaku tindakan yang diimpor di panel detail.
  4. Klik Oke untuk menyimpan dan menggunakannya. Klik Batal untuk membatalkan impor.

Jika suatu paket menyediakan fungsi yang berbeda, Seer akan membawa Anda ke halaman pengaturan yang sesuai.

Mengelola Tindakan

  • Ubah Urutan: Seret dan lepas item dalam daftar untuk mengatur ulang urutan tombol pada Bilah Kontrol.
  • Aktifkan/Nonaktifkan: Pilih tindakan dan ubah opsi Diaktifkan di detailnya, lalu simpan pengaturan.
  • Kustomisasi: Untuk plugin terpasang, Anda dapat menyesuaikan format file yang cocok dan argumen CLI, atau menyetel ulang ke default kapan saja.
  • Tombol Bawaan: Tindakan bawaan (Buka dengan Aplikasi Default, Tampilkan di File Explorer, Navigasi Tipe Sama) dapat diaktifkan atau dinonaktifkan satu per satu.

Placeholder dan Token Khusus

1. Placeholder Baris Perintah

Seer menyediakan token bawaan yang diselesaikan secara dinamis saat runtime saat meluncurkan alat eksternal:

Placeholder Deskripsi Contoh
${input_file} Jalur absolut dari file atau folder yang dipratinjau. C:\Users\Username\Documents\file.zip
${7z} Jalur absolut ke 7z.exe yang disertakan. Juga diterima di bidang Executable. C:\Program Files\Seer\plugins\7z.exe
${seer_exe} Jalur absolut ke Seer.exe. C:\Program Files\Seer\Seer.exe
${seerviewer_exe} Jalur absolut ke SeerViewer.exe. C:\Program Files\Seer\SeerViewer.exe
${seer_dir} Direktori yang berisi Seer.exe. C:\Program Files\Seer
${screenshot} Jalur absolut ke tangkapan layar PNG sementara dari tampilan saat ini. C:\Users\Username\AppData\Local\Temp\Seer\screenshot\view_1.png

Jika jalur mungkin berisi spasi, apit placeholder dengan tanda petik ganda: "${input_file}".

Menulis plugin kontrol Anda sendiri? Lihat Pengembangan & Implementasi Plugin untuk matriks placeholder dan token pencocokan lengkap, termasuk placeholder mana yang didukung oleh setiap kemampuan plugin.

2. Token Khusus Format File

Gunakan token ini di bidang Format File untuk mencocokkan tipe file atau folder non-standar:

Token Deskripsi
${type_folder} Mencocokkan direktori dan folder.
${type_file} Mencocokkan semua file (termasuk file tanpa ekstensi).
${type_all} Mencocokkan semuanya (file dan folder).
${type_pdf} Cocok dengan dokumen PDF.
${type_image} Cocok dengan berkas gambar, diklasifikasikan seperti penampil gambar bawaan.
${type_media} Cocok dengan berkas audio/video, diklasifikasikan seperti penampil media bawaan.
${type_web} Cocok dengan halaman web (HTML dan Markdown), diklasifikasikan seperti penampil HTML bawaan.
${type_text} Cocok dengan berkas teks/kode, diklasifikasikan seperti penampil teks bawaan.
${type_none} Cocok dengan berkas yang tidak termasuk kategori mana pun di atas (mis. arsip, program).

Catatan: Token tidak peka huruf besar/kecil dan dapat digabungkan dengan ekstensi file menggunakan spasi atau koma (misalnya, png jpg ${type_folder}).

Token kategori ${type_*} mengklasifikasikan berkas berdasarkan ekstensi menggunakan tabel yang sama dengan penampil bawaan; hanya cocok dengan berkas — gabungkan dengan ${type_folder} jika folder juga diperlukan.

3. Contoh Konfigurasi: Mengekstrak Arsip dengan 7-Zip

Untuk menambahkan tombol yang mengekstrak arsip menggunakan 7-Zip bawaan:

  1. Executable: ${7z} (atau telusuri file 7z.exe Anda sendiri).
  2. Argumen: x "${input_file}" -r -y -o"C:\Output\Path\"
  3. Format File: zip rar 7z tar gz

Rincian Parameter: * x: Ekstrak dengan jalur lengkap. * "${input_file}": File arsip target. * -r: Rekursi ke subdirektori. * -y: Mengasumsikan Ya pada semua kueri (timpa file). * -o"...": Direktori output tujuan.