Transformasi teks tersimpan

Transformasi adalah sekumpulan aturan cari dan ganti yang disimpan sekali lalu dijalankan saat Anda memilihnya, misalnya untuk merapikan teks tempelan, mengurutkan daftar, menghapus spasi di akhir baris, atau mengapit blok dengan penanda blok kode. Pilih transformasi dari menu Format, lihat pratinjau perubahannya, lalu tentukan apakah akan diterapkan.

Settings menjelaskannya sebagai berikut: "Aturan cari/ganti tersimpan dan beberapa operasi teks bawaan. Ini bukan skrip: Varlig tidak pernah menjalankan perintah shell, plugin, atau permintaan jaringan untuk transformasi, dan tidak pernah menerapkannya secara otomatis — baik saat mengimpor, menempelkan, maupun membuka catatan. Anda memilih transformasi dari Format ▸ Transformations dan melihat perubahannya sebelum diterapkan."

Lokasi penyimpanan

Settings › Editor › Text Transformations menyimpan daftar, dan kosong untuk memulai: sampai Anda menambahkannya, Format › Transformations menunjukkan No Transformations dan tidak ada yang berjalan di mana pun.

Add Transformation membuat transformasi baru bernama Transformation dengan satu aturan Find and Replace. Setiap transformasi memiliki:

Setiap baris dalam daftar juga memiliki tombol untuk menduplikasinya dan satu lagi untuk menghapusnya.

Transformasi yang belum lengkap — tanpa nama, tanpa aturan, atau dengan pola yang gagal dikompilasi — ditandai beserta alasannya di Settings. Transformasi tersebut tidak ditampilkan di Format › Transformations hingga diperbaiki.

Transformasi teks tersimpan disinkronkan antara Mac, iPhone, dan iPad melalui iCloud. Di Mac, aktifkan Sync notes with iCloud. Setiap perangkat menyimpan salinan lokal dalam preferensinya, sehingga transformasi tetap bekerja luring; transformasi tidak disertakan dalam ekspor catatan atau cadangan pustaka.

Aturannya

Aturan dijalankan berurutan, masing-masing menggunakan hasil aturan sebelumnya. Tidak ada kondisi maupun percabangan.

Aturan berupa daftar nilai, bukan kode. Ekspresi reguler dikompilasi dan diperiksa oleh mesin yang sama dengan Edit › Find and Replace (Advanced)…. Pola yang gagal dikompilasi ditandai di Settings sebelum dapat diterapkan.

Menerapkan transformasi

Di Mac, jalankan transformasi dari Format › Transformations › name. Di iPhone dan iPad, gunakan menu Transformations pada editor. Transformasi tidak memiliki pintasan papan ketik dan tidak pernah berjalan otomatis saat Anda membuka catatan, mengimpor, menempelkan teks, atau membiarkan aplikasi di latar belakang.

Dengan Applies to diatur ke Selection, pilih teks terlebih dahulu. Dengan Whole Note, catatan keseluruhan adalah ruang lingkup.

Varlig menjalankan aturan pada salinan dan menampilkan panel pratinjau dengan daftar Removes 4 lines dan Inserts 4 lines. Daftar hanya mencakup bagian yang benar-benar berubah, hingga 40 baris pada masing-masing sisi, disertai pemberitahuan jika masih ada baris lain. Di bagian bawah tertulis, "Penerapan dapat dibatalkan dengan satu langkah. Tidak ada yang berubah sebelum Anda menekan Apply." Cancel membiarkan catatan tetap seperti semula; Apply menerapkan perubahan sebagai satu pengeditan yang dapat dibatalkan dengan Edit › Undo (⌘Z).

Jika catatan berubah setelah pratinjau dibuat, Apply menolak menerapkan perubahan dan meminta Anda menjalankan transformasi lagi agar teks yang lebih baru tidak tertimpa.

Saat transformasi tidak dapat dijalankan

Setiap kegagalan meninggalkan catatan persis seperti apa adanya — Anda tidak pernah mendapatkan transformasi yang setengah diterapkan. Masing-masing mengatakan apa yang terjadi alih-alih mengubah apa pun:

• "Transformasi tidak dijalankan pada catatan yang dilindungi, hanya baca, atau berada di Trash." Ketentuan yang sama berlaku untuk pustaka hanya baca.
• "Lebih dari 10.000 kecocokan dalam satu aturan. Persempit cakupan transformasi."
• "Transformasinya terlalu lama. Sederhanakan aturannya atau gunakan cakupan yang lebih kecil."
• "Transformasi ini tidak mengubah apa pun di sini."
• Pesan menjelaskan masalah secara spesifik: pola aturan tidak valid, grup tangkapan tidak ditemukan, teks yang akan dicari belum diisi, transformasi tidak memiliki nama atau aturan, atau transformasi Selection dijalankan tanpa memilih teks.

Batasan

Tidak ada uji coba di beberapa catatan: untuk mengubah banyak catatan sekaligus, gunakan Edit › Replace in Notes…, yang menampilkan pratinjau perubahan setiap catatan secara terpisah.

Transformasi hanya menghasilkan Markdown biasa. Hasilnya tidak memakai format khusus Varlig, sehingga editor lain membaca persis apa yang disimpan Varlig.