# Panduan Pluma

2015-2021
MATE Documentation Project
2007
GNOME Documentation Project
2002
2003
2004
Sun Microsystems
2000
Eric Baudais
Projek Dokumentasi MATE
Projek Dokumentasi GNOME

Keizinan diberi untuk menyalin, mengedar dan/atau mengubahsuai dokumen ini bawah terma Lesen Dokumentasi Bebas GNU (GDFL), bagi Versi 1.1 atau mana-mana versi terkemudian yang telah diterbitkan oleh Free Software Foundation tanpa Seksyen Tak Varian, tanpa Teks Muka-Hadapan, dan tanpa Teks Muka Belakang. Anda boleh temui satu salinan GFDL dalam pautan ini atau di dalam fail COPYING-DOCS yang disertakan bersama-sama panduan ini.

Panduan ini adalah sebahagian dari koleksi panduan MATE yang diedar bawah GFDL. Jika anda mahu edar panduan ini secara berasingan dari koleksi asalnya, anda boleh membuat sedemikian dengan menambah satu salinan lesen ke dalam panduan sepertimana yang dijelaskan dalam seksyen 6 lesen tersebut.

Kebanyakan nama digunakan oleh syarikat untuk membezakan produk dan perkhidmatan mereka dituntut sebagai tanda dagangan. Jika nama tersebut ada di dalam dokumentasi MATE, dan ahli-ahli Projek Dokumentasi MATE sedar akan tanda dagangan tersebut, kerana nama-nama tersebut telah di huruf besarkan atau huruf awalnya telah dihuruf besarkan.

DOKUMEN DAN VERSI UBAHSUAI DOKUMEN DISEDIAKAN BAWAH TERMA LESEN DOKUMENTASI BEBAS GNU DENGAN PERKARA BERIKUT:

1. DOKUMEN DISEDIAKAN SEBAGAI DASAR "SEBAGAIMANA ADANYA", TANPA JAMINAN ATAS APA JUA, SAMA ADA DIUNGKAP ATAU DILAKSANA, TERMASUKLAH, TANPA HAD, JAMINAN TERHADAP DOKUMEN ATAU VERSI UBAHSUAI DOKUMEN ADALAH BEBAS MASALAH KEBOLEHNIAGAAN. SESUAI ATAS TUJUAN TERTENTU ATAU BUKAN-PELANGGARAN. KESELURUHAN RISIKO ATAS KUALITI, KETEPATAN, DAN PRESTASI DOKUMEN ATAU VERSI UBAHSUAI DOKUMEN TERLETAK PADA DIRI ANDA. SEKIRANYA TERDAPAT MANA-MANA DOKUMEN ATAU VERSI UBAHSUAI DOKUMEN YANG BERMASALAH DALAM APA JUA BENTUK, ANDA (BUKAN PENULIS, PENGARANG ATAU MANA-MANA PENYUMBANG ASAL) MENANGGUNG KOS APA JUA PERKHIDMATAN, PEMBAIKAN ATAU PEMBETULAN YANG DIPERLUKAN. PENAFIAN JAMINAN INI TERBENTUK SEBAGAI BAHAGIAN PENTING LESEN INI. MAKA TIDAK PENGGUNAAN MANA-MANA DOKUMEN ATAU VERSI UBAHSUAI DOKUMEN DIIZINKAN KECUALI TERTAKLUK DI BAWAH PENAFIAN INI; DAN

2. TANPA DI BAWAH APA-APA KEADAAN DAN TEORI PERUNDANGAN, SAMA ADA DALAM TORT (TERMASUKLAH KECUAIAN), KONTRAK, ATAU SEUMPAMA DENGANNYA, SI PENGARANG, PENULIS ASAL, MANA-MANA PENYUMBANG, ATAU MANA-MANA PENGEDAR DOKUMEN ATAU VERSI UBAHSUAI DOKUMEN, ATAU MANA-MANA PEMBEKAL ATAS APA JUA KUMPULAN, JUGA PADA MANA-MANA INDIVIDU ATAS KEROSAKAN SECARA LANGSUNG ATAU TIDAK LANGSUNG, SECARA KHUSUS, TIDAK SENGAJA ATAU, KEROSAKAN LANJUTAN TERHADAP SESIAPA SAHAJA, TERMASUKLAH TANPA HAD BAGI KEROSAKAN NAMA BAIK, GANGGUAN KERJA, KEGAGALAN ATAU KEROSAKAN KOMPUTER, ATAU MANA-MANA MAHUPUN SEMUA KEROSAKAN LAIN BERKAITAN PENGGUNAAN DOKUMEN DAN VERSI UBAHSUAI DOKUMEN, WALAUPUN PIHAK TERSEBUT TELAH DIMAKLUMKAN ADANYA KEBARANGKALIAN KEROSAKAN SEBEGITU BOLEH BERLAKU.

## Maklumbalas

To report a bug or make a suggestion regarding the pluma application or this manual, follow the directions in the MATE Feedback Page.

Projek Dokumentasi MATE
Desktop MATE
Joachim
Noreiko
Projek Dokumentasi GNOME
GNOME
Hal
Canary
Tambah Jadual Kekunci Pintasan
Pasukan Dokumentasi Sistem Desktop Sun Java
Sun Microsystems
gdocteam@sun.com
Eric
Baudais
Projek Dokumentasi GNOME
baudais@okstate.edu
Baris
Cicek
Menyediakan maklumat daripada revisi aplikasi pluma yang lebih awal.
George
Ajit
Menyediakan maklumat berkenaan palam.
1.0
2000

Eric Baudais baudais@okstate.edu

Projek Dokumentasi GNOME

2.0
Mac 2002

Pasukan Dokumentasi Sun GNOME

Projek Dokumentasi GNOME

2.1
Jun 2002

Pasukan Dokumentasi Sun GNOME

Projek Dokumentasi GNOME

2.2
Ogos 2002

Pasukan Dokumentasi Sun GNOME

Projek Dokumentasi GNOME

2.3
September 2002

Pasukan Dokumentasi Sun GNOME

Projek Dokumentasi GNOME

2.4
Januari 2003

Pasukan Dokumentasi Sun GNOME

Projek Dokumentasi GNOME

2.5
Mac 2003

Pasukan Dokumentasi Sun GNOME

Projek Dokumentasi GNOME

2.6
September 2003

Pasukan Dokumentasi Sun GNOME

Projek Dokumentasi GNOME

2.7
Mac 2004

Pasukan Dokumentasi Sun GNOME

Projek Dokumentasi GNOME

2.8
Julai 2015

Pasukan Dokumentasi Sistem Desktop Sun Java

Projek Dokumentasi GNOME

2.9
Julai 2006

Pasukan Dokumentasi GNOME

Projek Dokumentasi GNOME

3.0
Julai 2015

Pasukan Dokumentasi MATE

Projek Dokumentasi MATE

Panduan ini menerangkan pluma versi 1.10.

## Pengenalan

Aplikasi Pluma membolehkan anda cipta dan sunting fail teks.

Matlamat pluma adalah untuk menjadi sebuah penyunting teks yang ringkas dan mudah digunakan. Banyak fitur-fitur hebat boleh didayakan dengan pelbagai Palam yang ditawarkan, memudahkan pelbagai tugasan berkaitan penyuntingan-teks.

## Membiasakan Diri

### Memulakan pluma

Anda boleh memulakan pluma dengan cara berikut:

Menu Aplikasi

  Pilih Aksesori Penyunting Teks Pluma .

Baris perintah

  Lakukan perintah berikut: `pluma`

Secara lalai, ketika anda membuka sebuah dokumen teks di dalam pengurus fail, pluma akan dimulakan, dan memaparkan dokumen tersebut.

### Tetingkap pluma

Ketika anda memulakan pluma, tetingkap berikut dipaparkan:

#### tetingkap pluma

Menujukkan tetingkap utama pluma.

Tetingkap pluma mengandungi elemen berikut:

Palang Menu

  Menu dalam palang menu mengandungi semua perintah yang anda perlu untuk mengendalikan imej dalam pluma.

Palang Alat

  Palang alat mengandungi satu subset perintah yang anda juga boleh capai melalui palang menu.

Kawasan paparan

  Kawasan paparan mengandungi teks fail yang anda suntingkan.

Palang Status

  Palang status memaparkan maklumat berkenaan aktiviti semasa pluma dan maklumat konteksual berkenaan item-item menu. Palang status juga memaparkan maklumat berikut:

  - Kedudukan kursor: nombor baris dan nombor lajur bagi lokasi kursor berada.

  - Mod sunting: Jika penyunting dalam mod sisip, palang status mengandungi teks INS. Jika penyunting dalam mod tulis-ganti, palang status mengandungi teks OVR. Tekan kekunci Insert untuk mengubah mod sunting.

Anak Tetingkap Sisi

  Anak tetingkap sisi memaparkan satu senarai dokumen yang telah dibuka, dan juga lain-lain maklumat yang bergantung pada palam yang dibenarkan.

  Secara lalai, anak tetingkap sisi tidak ditunjukkan. Untuk memaparkannya, pilih Lihat Anak Tetingkap Sisi .

Anak Tetingkap Bawah

  Anak tetingkap bawah digunakan oleh alatan pengaturcaraan seperti palam Konsol Python untuk memaparkan outputnya.

  Secara lalai, anak tetingkap bawah tidak ditunjukkan. Untuk memaparkannya, pilih Lihat Anak Tetingkap Bawah .

Ketika anda mengklik-kanan di dalam tetingkap pluma, aplikasi memaparkan satu menu timbul, Menu timbul mengandungi perintah penyuntingan teks yang paling umum.

Seperti lain-lain aplikasi MATE, tindakan di dalam pluma boleh dilakukan dengan beberapa cara: melalui menu, melalui palang alat, atau dengan kekunci pintasan. Kekunci pintasan umum untuk semua aplikasi tersenarai di dalam Panduan Pengguna.

### Menjalankan pluma melalui Baris Perintah

Anda boleh menjalankan pluma menerusi baris perintah dan dapat membuka satu atau berbilang fail. Untuk membuka berbilang fail melalui baris perintah, taip perintah berikut, kemudian tekan Return:

`pluma fail1.txt fail2.txt fail3.txt`

Selain itu, anda boleh nyatakan satu URI selain dari nama fail.

Sila rujuk laman panduan pluma 1 untuk ketahui maklumat lanjut berkenaan menjalankan pluma melalui baris perintah.

## Mengendalikan Fail

### Mencipta satu Dokumen Baharu

Untuk mencipta satu dokumen baharu, pilih Fail Baharu . Aplikasi akan memaparkan dokumen kosong baharu di dalam tetingkap pluma.

### Membuka sebuah Fail

Untuk membuka sebuah fail, pilih Fail Buka untuk memaparkan dialog Buka Fail. Pilih fail yang mahu dibuka, kemudian klik Buka. Fail akan terpapar di dalam tetingkap pluma.

Aplikasi merekod laluan dan nama fail bagi lima fail yang terkini disunting dan memaparkan fail sebagai item-item menu di dalam menu Fail . Anda juga boleh mengklik ikon Tunjuk ikon menu Fail Baru-Baru Ini. pada palang alat untuk memaparkan senarai fail baru-baru ini.

Anda juga boleh membuka berbilang fail dengan pluma. Aplikasi akan menambah satu tab untuk setiap fail yang dibuka di dalam tetingkap. Untuk maklumat lanjut, sila rujuk .

Anda boleh menaip lokasi fail dalam dialog Buka Fail. Untuk beralih antara masukan lokasi dan and breadcrumb, tekan Ctrl l, ., ~ atau /.

### Menyimpan sebuah Fail

Anda boleh menyimpan fail dengan cara-cara berikut:

- Untuk menyimpan perubahan yang dibuat pada fail sedia ada, pilih Fail Simpan .

- Untuk menyimpan satu fail baharu atau menyimpan fail sedia ada dengan nama fail baharu, pilih Fail Simpan Sebagai. Masukkan nama fail dalam dialog Simpan Sebagai, kemudian klik Simpan.

- Untuk menyimpan semua fail yang terbuka di dalam pluma, pilih Dokumen Simpan Semua .

Untuk menutup semua fail yang masih terbuka di dalam pluma, pilih Dokumen Tutup Semua .

### Mengendalikan Tab

Bila lebih daripada satu fail dibuka, pluma akan menunjukkan satu tab bagi setiap dokumen di atas kawasan paparan. Untuk beralih ke dokumen lain, klik pada tab yang dikehendaki.

Untuk mengalih satu dokumen ke tetingkap pluma yang lain, seret tab berkaitan fail itu ke tetingkap yang mahu diletakkannya.

Untuk mengalih satu dokumen ke dalam tetingkap pluma baharu, sama ada seret tab tersebut ke arah desktop, atau pilih Dokumen Alih ke Tetingkap Baharu .

## Mengendalikan Teks

### Menyunting Teks

Anda boleh menyunting teks sesebuah fail dengan cara-cara berikut:

- Taip teks baharu menggunakan papan kekunci. Kursor penyisipan yang berkelip menunjukkan lokasi teks baharu muncul. Untuk mengubahnya, guna kekunci anak panah pada papan kekunci atau klik dengan tetikus.

- Untuk menyalin teks terpilih ke dalam papan keratan, pilih Sunting Salin .

- Untuk memadam teks terpilih daripada fail dan alih teks tersebut ke dalam papan keratan, pilih Sunting Potong .

- Untuk memadam teks terpilih di dalam fail secara kekal, pilih Sunting Padam .

- Untuk menyisip isi kandungan papan keratan pada kedudukan kursor, pilih Sunting Tampal . Anda mesti potong atau salin teks sebelum menampalnya ke dalam fail, sama ada dari pluma atau lain-lain aplikasi.

- Untuk memilih semua teks di dalam fail, pilih Sunting Pilih Semua .

### Membuat Asal dan Membuat Semula Perubahan

Untuk membuat asal perubahan yang telah dibuat, pilih Sunting Buat Asal . Untuk menyongsangkan tindakan ini, pilih Sunting Buat Semula .

## Mencari dan Mengganti

Dengan pluma, terdapat dua cara menggelintar teks. Anda boleh gunakan dialog Cari untuk menggelintar cebisan teks yang dikehendaki, atau Gelintar Bertokok untuk menyorot teks sepadan ketika anda menaipnya.

### Mencari Teks

Untuk menggelintar satu fail yang ada rentetan teks yang dikehendaki, buat langkah-langkah berikut:

1. Pilih Gelintar Cari untuk memaparkan dialog Cari.

2. Taip rentetan yang mahu dicari dalam medan Gelintar untuk. Anda juga boleh masukkan aksara khas seperti line new atau tab: bolehlah merujuk .

3. Klik Cari untuk menggelintar rentetan pertama selepas lokasi kursor semasa anda. Jika pluma mencari rentetan, aplikasi akan memilih kemunculan pertama rentetan. Lain-lain kemunculan rentetan hanya disorotkan.

4. Untuk mencari kemunculan rentetan berikutnya, klik Cari atau pilih Gelintar Cari Berikutnya . Sebaliknya, untuk mencari kemunculan teks terdahulu, pilih Gelintar Cari Terdahulu .

Selepas anda menutup dialog Cari, anda masih boleh alih pemilihan ke kemunculan teks dengan memilih Gelintar Cari Berikutnya dan Gelintar Cari Terdahulu .

Untuk membuang sorotan teks, pilih Gelintar Kosongkan Sorotan .

Rujuk pada pcrepattern 3 untuk maklumat lanjut berkenaan sintaks dan semantik ungkapan nalar yang disokong oleh dialog Cari.

### Gelintar Bertokokan

Gelintar bertokokan menyorot teks sepadan di dalam teks bila anda menaipnya huruf demi huruf. (FItur ini serupa dengan fitur gelintar dalam beberapa pelayar sesawang.)

Untuk memulakan gelintar bertokokan, pilih Gelintar Gelintar Bertokokan . Kotak gelintar akan muncul di bahagian teratas kawasan paparan.

Taip teks yang dikehendaki, teks yang sepadan di dalam dokumen akan disorotkan. Kemunculan pertama selepas kedudukan kursor juga dipilih.

Untuk melanjutkan pemilihan ke padanan berikutnya tapi pada masa yang sama kotak gelintar masih terbuka, tekan Ctrl G . Tekan Ctrl Shift G untuk kembali ke padanan terdahulu.

Anda juga boleh gunakan kekunci anak panah atas dan bawah atau roda tetikus untuk beralih ke pemilihan yang lain.

### Menggantikan Teks

Untuk menggelintar satu fail atau rentetan, dan menggantikan terus rentetan itu dengan yang lain, buat langkah-langkah berikut:

1. Pilih Gelintar Ganti untuk memaparkan dialog Ganti.

2. Taip rentetan yang mahu dicari dalam medan Gelintar untuk. Anda juga boleh masukkan aksara khas seperti line new atau tab: bolehlah merujuk .

3. Taip rentetan yang mahu digunakan untuk menggantikan rentetan yang ditemui, dalam medan Ganti dengan.

Untuk memeriksa setiap kemunculan rentetan sebelum diganti yang baharu, klik Cari. Jika pluma menemuinya, ia akan memilih rentetan tersebut. Klik Ganti untuk menggantikan kemunculan terpilih rentetan yang dikehendaki. Seterusnya, untuk mencari kemunculan rentetan yang berikutnya, klik Cari sekali lagi.

Untuk menggantikan semua kemunculan rentetan di dalam dokumen secara serentak, klik Ganti Semua.

### Pilihan Cari dan Ganti

Kedua-dua dialog Cari dan dialog Ganti mempunyai piihan berikut:

- Pilih pilihan Padan kata untuk hanya mencari kejadian rentetan yang sepadan dengan perkataan yang anda taip. Contohnya, Padan kata yang dipilih, "TEXT" tidak akan sepadan dengan "text".

- Pilih pilihan Padan keseluruhan kata untuk hanya mencari kejadian rentetan yang sepadan dengan keseluruhan perkataan yang anda taip. Contohnya, Padan keseluruhan kata yang dipilih, "text" tidak akan sepadan dengan "texture".

- Pilih pilihan Gelintar mengundur untuk menggelintar secara mengundur ke permulaan dokumen.

- Pilih pilihan Lilit sekeliling untuk menggelintar sehingga ke penghujung dokumen dan kemudian terus menggelintar dari bahagian akhir fail.

### Aksara Khas

Anda boleh sertakan jujukan escape berikut di dalam teks untuk mencari dan menggantikan bagi aksara khas yang tunjukkan:

`\n`

  Nyatakan satu baris baharu.

`\t`

  Menyatakan satu aksara tab.

`\r`

  Specifies a carriage return.

`\\`

  The backslash character itself must be escaped if it is being searched for. For example, if you are looking for the "`\n`" literal, you will have to type "\\n" in the Search for field. Or if you are looking for a sequence of backslashes, you will have to double the number of searched backslashes.

### Meletak Kursor di atas Baris Tertentu

Untuk meletak kursor di atas baris tertentu dalam fail semasa, pilih Gelintar Pergi ke Baris . Kotak nombor baris muncul di bahagian teratas kawasan paparan.

Mula menaip nombor baris yang anda mahu alihkan kursor kepadanya dan dokumen akan ditatal ke baris yang dinyatakan.

Untuk menutup kotak dan mengalih kursor ke baris yang dinyatakan, tekan Return.

## Percetakan

### Menetapkan Pilihan Halaman

Untuk menetapkan pilihan halaman, pilih Fail Persediaan Halaman untuk memaparkan dialog Persediaan Halaman.

Dialog Persediaan Halaman membolehkan anda nyatakan piihan cetak berikut:

#### Seksyen Bertab Am

Cetak penyorotan sintaks

  Pilih pilihan ini untuk mencetak penyorotan sintaks. Untuk maklumat lanjut berkenaan penyorotan sintaks, sila rujuk .

Cetak pengepala halaman

  Pilih pilihan ini untuk menyertakan satu pengepala untuk setiap halaman yang dicetak. Anda tidak boleh mengkonfigur pengepala tersebut.

Nombor Baris

  Pilih pilihan Cetak nombor baris untuk sertakan nombor baris ketika anda mencetak satu fail.

  Guna kotak angka Nomborkan setiap ...baris untuk menyatakan berapa kekerapan cetak nombor baris, contohnya setiap 5 baris, setiap 10 baris, dan selanjutnya.

Pelilitan Teks

  Pilih pilihan Benarkan pelilitan teks untuk melilit teks ke baris berikutnya, pada aras satu aksara, ketika anda mencetak satu fail. Aplikasi mengira baris terlilit sebagai satu baris untuk tujuan pernomboran baris.

  Pilih pilihan Jangan pisahkan perkataan kepada dua baris untuk melilit teks ke baris berikutnya, pada aras satu perkataan ketika anda mencetak satu fail.

#### Fon

Badan

  Klik pada butang ini untuk memilih fon yang digunakan untuk mencetak teks badan sesebuah fail.

Nombor baris

  Klik pada butang ini untuk memilih fon yang digunakan untuk mencetak nombor baris.

Pengepala dan pengaki

  Klik pada butang ini untuk memilih fon yang digunakan untuk mencetak pengepala dan pengaki dalam sesebuah fail.

Untuk menetap semula fon ke fon lalai untuk mencetak satu fail melalui pluma, klik Pulih Fon Lalai.

### Mencetak satu Dokumen

Anda boleh menggunakan pluma untuk membuat operasi-operasi cetak berikut:

- Cetak satu dokumen dengan pencetak.

- Cetak output perintah cetak ke sebuah fail.

Jika anda mencetak ke sebuah fail, pluma dapat menghantar output fail ke fail format pra-cetakan. Kebanyakan format-format pra-cetak adalah PostScript dan Format Dokumen Mudah Alih (PDF).

Untuk melihat pratonton halaman yang mahu dicetak, pilih Fail Pratonton Cetak .

Untuk mencetak fail semasa dengan pencetak atau menjadi sebuah fail, pilih Fail Cetak untuk memaparkan dialog Cetak.

Dialog Cetak membolehkan anda nyatakan pilihan-pilihan cetak berikut:

#### Seksyen Bertab Kerja

Julat cetak

  Pilih salah satu dari pilihan berikut untuk tentukan berapa banyak halaman yang mahu dicetak:

  - Semua

    Pilih pilihan ini untuk mencetak semua halaman di dalam fail.

  - Baris

    Pilih pilihan ini untuk mencetak baris-baris yang dinyatakan sahaja. Guna kotak angka Dari dan Hingga untuk menyatakan julat baris.

  - Pemilihan

    Pilih pilihan ini untuk mencetak teks terpilih sahaja. Pilihan ini hanya tersedia jika anda memilih teks.

Salinan

  Guna kotak angka Bilangan salinan untuk menyatakan bilangan salinan fail yang mahu dicetakkan.

  Jika anda mencetak salinan berbilang sesebuah fail, pilih pilihan Kumpul Semak untuk mengumpul semak salinan bercetak.

#### Seksyen Bertab Pencetak

Pencetak

  Guna senarai tarik-turun ini untuk memilih pencetak yang anda mahu gunakan.

Tetapan

  Guna senarai tarik-turun ini untuk memilih tetapan pencetak.

  Untuk konfigurkan pencetak, klik Konfigur. Sebagai contoh, anda boleh benarkan atau lumpuhkan percetakan dupleks, atau jadualkan percetakan tertangguh, jika kefungsian ini disokong oleh pencetak.

Lokasi

  Guna senarai tarik-turun ini untuk memilih salah satu destinasi cetak berikut:

  CUPS

    Cetak fail dengan pencetak CUPS.

    Jika pencetak terpilih ialah pencetak CUPS, CUPS ialah satu-satunya masukan dalam senarai tarik-turun ini.

  lpr

    Cetak fail dengan pencetak.

  Fail

    Cetak fail dengan fail PostScript.

    Klik Simpan Sebagai untuk paparkan satu dialog yang boleh anda tentukan nama dan lokasi fail PostScript.

  Suai

    Guna perintah yang dinyatakan untuk mencetak fail.

    Taip nama perintah di dalam kotak teks. Termasuklah semua argumen baris-perintah.

Keadaan

  Kefungsian ini tidak disokong dalam versi pluma ini.

Jenis

  Kefungsian ini tidak disokong dalam versi pluma ini.

Ulasan

  Kefungsian ini tidak disokong dalam versi pluma ini.

#### Seksyen Bertab Kertas

Saiz kertas

  Guna senarai tarik-turun ini untuk memilih saiz kertas yang mahu digunakan untuk cetakan dokumen.

Lebar

  Guna kotak angka ini untuk tentukan lebar kertas. Guna senarai tarik-turun bersebelahan untuk mengubah unit pengukuran.

Tinggi

  Guna kotak angka untuk tentukan tinggi kertas.

Orientasi suapan

  Guna senarai tarik-turun ini untuk memilih orientasi kertas di dalam pencetak.

Orientasi halaman

  Guna senarai tarik-turun ini untuk memilih orientasi halaman.

Bentangan

  Guna senarai tarik-turun ini untuk memilih bentangan halaman. Satu pratonton bagi setiap bentangan yang anda pilih terpapar dalam kawasan Pratonton.

Talam kertas

  Guna senarai tarik-turun ini untuk memilih talam kertas.

## Fitur-Fitur Pengaturcaraan

Terdapat beberapa fitur pluma untuk tujuan pengaturcaraan yang disediakan melalui palam. Sebagai contoh, palam Senarai Tag menyediakan satu senarai tag-tag umum-digunakan bagi bahasa-bahasa penanda yang berbeza: sila rujuk .

### Penyorotan Sintaks

Penyorotan sintaks memudahkan pembacaan kod sumber dengan memaparkan bahagian-bahagian berbeza teks dalam warna-warna berlainan.

pluma memilih satu mod penyorotan sintaks yang sesuai berdasarkan jenis dokumen. Untuk membatalkan mod penyorotan sintaks, pilih Lihat Mod Sorot , kemudian pilih salah satu dari item-item menu berikut:

Biasa

  Jangan papar apa-apa penyorotan sintaks.

Sumber

  Papar penyorotan sintaks untuk menyunting kod sumber. Guna submenu Sumber untuk meilih jenis kod sumber.

Penanda

  Papar penyorotan sintaks untuk menyunting kod penanda. Guna submenu Penanda untuk meilih jenis kod penanda.

Skrip

  Papar penyorotan sintaks untuk menyunting kod skrip. Guna submenu Skrip untuk meilih jenis kod skrip.

Lain-lain

  Papar penyorotan sintaks untuk menyunting kod lain-lain. Guna submenu Lain-lain untuk meilih jenis kod lain-lain.

### Paipkan Output satu Perintah bagi sesebuah Fail

You can use pluma to pipe the output of a command to a text file. For example, to pipe the output of an `ls` command to a text file, type `ls | pluma`, then press Return.

Output bagi perintah `ls` dipaparkan dalam satu fail teks baharu di dalam tetingkap pluma.

Selain itu, anda boleh guna palam Alatan luar untuk salurkan output perintah ke dalam fail semasa.

## Kekunci Pintasan

Guna kekunci pintasan untuk membuat tugas-tugas umum lebih pantas berbanding tetikus dan menu. Jadual berikut menyenaraikan semua kekunci pintasan pluma.

Maklumat lanjut berkenaan kekunci pintasan, sila rujuk Panduan Pengguna Desktop./

Tab

Pintasan untuk tab:

Kekunci Pintasan | Perintah
--- | ---
Ctrl + Alt + PageUp | Beralih ke tab berikutnya di sebelah kiri.
Ctrl + Alt + PageDown | Beralih ke tab berikutnya di sebelah kanan.
Ctrl + W | Tutup tab.
Ctrl + Shift + L | Simpan semua tab.
Ctrl + Shift + W | Tutup semua tab.
Alt + n | Lompat ke tab n

Fail

Pintasan untuk mengendalikan fail:

Kekunci Pintasan | Perintah
--- | ---
Ctrl + N | Cipta satu dokumen baharu.
Ctrl + O | Buka satu dokumen.
Ctrl + S | Simpan dokumen semasa ke dalam cakera.
Ctrl + Shift + S | Simpan dokumen semasa dengan satu nama fail baharu.
Ctrl + P | Cetak dokumen semasa
Ctrl + Shift + P | Pratonton cetakan.
Ctrl + W | Tutup dokumen semasa.
Ctrl + Q | Keluar dari Pluma.

Sunting

Pintasan untuk menyunting dokumen:

Kekunci Pintasan | Perintah
--- | ---
Ctrl + Z | Buat asal tindakan terakhir.
Ctrl + Shift + Z | Buat semula tindakan belum selesai yang terakhir.
Ctrl + X | Potong teks atau kawasan terpilih dan letak ia ke dalam papan keratan.
Ctrl + C | Salin teks atau kawasan terpilih ke dalam papan keratan.
Ctrl + V | Tampal kandungan papan keratan.
Ctrl + A | Pilih semua.
Ctrl + D | Padam baris semasa.
Ctrl + U | Ubah huruf ke huruf besar.
Ctrl + L | Ubah huruf ke huruf kecil.
Alt + U | Togol hurus setiap aksara.
Alt + L | Huruf besar setiap perkataan.
Alt + Up | Alih baris terpilih naik satu baris.
Alt + Down | Alih baris terpilih turun satu baris.
Tab | Increase indent of the selected lines.
Shift + Tab | Decrease indent of the selected lines.

Lihat

Pintasan untuk pandangan semasa:

Kekunci Pintasan | Perintah
--- | ---
Ctrl + Y | Tunjuk/sembunyi nombor baris.

Anak Tetingkap

Pintasan untuk tunjuk dan sembunyi anak tetingkap:

Kekunci Pintasan | Perintah
--- | ---
F9 | Tunjuk/sembunyi anak tetingkap sisi.
Ctrl + F9 | Tunjuk/Sembunyi anak tetingkap bawah.

Gelintar

Pintasan untuk menggelintar:

Kekunci Pintasan | Perintah
--- | ---
Ctrl + F | Cari satu rentetan.
Ctrl + G | Cari tika rentetan yang berikutnya.
Ctrl + Shift + G | Cari tika rentetan yang terdahulu.
Ctrl + K | Gelintar berinteraktif.
Ctrl + H | Gelintar dan ganti.
Ctrl + Shift + K | Kosongkan sorotan.
Ctrl + I | Pergi ke baris.

Alatan

Pintasan untuk alatan:

Kekunci Pintasan | Perintah
--- | ---
Shift + F7 | Periksa ejaan (dengan palam).
Alt + F12 | Buang jarak berjela (dengan palam).
Ctrl + T | Engsot (dengan palam).
Ctrl + Shift + T | Buang Engsot (dengan palam).
F8 | Jalankan "make" dalam direktori semasa (dengan palam).
Ctrl + Shift + D | Penyenaraian direktori (dengan palam).

Bantuan

Pintasan untuk bantuan:

Kekunci Pintasan | Perintah
--- | ---
F1 | Buka panduan pengguna pluma.

## Keutamaan

Untuk mengkonfigur pluma, pilih Sunting Keutamaan. Dialog Keutamaan mengandungi kategori-kategori seperti berikut:

### Keutamaan Lihat

Pelilitan Teks

  Pilih pilihan Benarkan pelilitan teks supaya baris panjang teks membentuk perenggan selain dari terkeluar daripada tetingkap teks. Ia menghindari ditatal secara mengufuk

  Pilih pilihan Jangan pisahkan perkataan kepada dua barissupaya pilihan pelilitan teks dapat mengekalkan keseluruhan perkataan ketika teks dialirkan ke baris berikutnya. Ia memudahkan teks dibaca.

Nombor Baris

  Pilih pilihan Papar nombor baris untuk memaparkan nombor baris di sebelah kiri tetingkap pluma.

Baris Semasa

  Pilih pilihan Sorot baris semasa untuk menyorot baris yang ada kursor di atasnya.

Margin Kanan

  Pilih pilihan Papar margin kanan untuk memaparkan satu garis menegak yang menunjukkan margin kanan.

  Guna kotak angka Margin kanan pada lajur untuk menyatakan lokasi bagi baris menegak.

Pemadanan Kurungan

  Pilih pilihan Sorot kurungan sepadan untuk menyorot kurungan berkaitan ketika kursor berada di atas aksara kurungan.

### Keutamaan Penyunting

Tab

  Guna kotak angka Lebar tab untuk menyatakan lebar jarak yang pluma sisipkan ketika anda menekan kekunci Tab.

  Pilih pilihanSisip jarak selain tabuntuk menyatakan pluma menyisip jarak selain dari aksara tab ketika anda menekan kekunci Tab.

Indentasi Automatik

  Pilih pilihan Benarkan identasi automatik untuk menyatakan baris berikutnya bermula pada aras indentasi bagi baris semasa.

Fail Disimpan

  Pilih pilihan Cipta salinan sandar fail sebelum disimpan untuk mencipta satu salinan sandar bagi satu fail setiap kali anda menyimpan fail. Salinan sandar fail mengandungi tanda ~ dipenghujung nama fail.

  Pilih pilihan Simpan sendiri fail setiap ... minit untuk menyimpan fail semasa secara automatik pada sela tetap. Guna kotak angka untuk menyatakan kekerapan fail yang mahu disimpan.

### Keutamaan Fon & Warna

Fon

  Pilih pilihan Guna fon tema lalai untuk menggunakan fon sistem lalai bagi teks di dalam tetingkap teks pluma.

  Medan Fon penyunting memaparkan fon yang digunakan oleh pluma ketika memaparkan teks. Klik pada butang untuk menyatakan jenis, gaya, dan saiz fon yang digunakan.

Skema Warna

  Anda boleh memilih satu skema warna melalui senarai skema warna. Secara lalai, skema warna berikut yang dipasang:

  Klasik

    Skema warna klasik berdasarkan skema warna gvim.

  Kobalt

    Skema warna berasaskan biru.

  Kate

    Skema warna yang digunakan oleh penyunting teks Kate.

  Oblivion

    Skema warna gelap yang menggunakan palet warna Tango.

  Tango

    Skema warna yang menggunakan skema warna Tango.

  Anda boleh menambah satu skema warna baharu dengan mengklik butang Tambah..., dan kemudian memilih satu fail skema warna

  Anda juga boleh membuang skema warna dengan mengklik butang Tanggal

### Keutamaan Palam

Palam menambah fitur-fitur tambahan untuk pluma. Maklumat lanjut berkenaan palam dan cara penggunaan palam terbina-dalam, sila rujuk .

#### Membenarkan sebuah Palam

Untuk membenarkan sebuah palam pluma, buat langkah-langkah berikut:

1. Pilih Sunting Keutamaan.

2. Pilih tab Palam.

3. Pilih kotak tanda di sebelah nama palam yang mahu dibenarkan.

4. Klik Tutup untuk menutup dialog Keutamaan.

#### Melumpuhkan sebuah Palam

Sebuah palam kekal dibenarkan bila anda menutup pluma.

Untuk melumpuhkan sebuah palam pluma, buat langkah-langkah berikut:

1. Pilih Sunting Keutamaan.

2. Pilih tab Palam.

3. Nyah-pilih kotak tanda di sebelah nama pelama yang mahu dilumpuhkan.

4. Klik Tutup untuk menutup dialog Keutamaan.

## Palam

### Mengendalikan Palam

Anda boleh menambah fitur-fitur tambahan ke dalam pluma dengan membenarkan palam. Sebuah palam ialah satu program tambahan yang menambah baik kefungsian sesebuah aplikasi. Palam dapat menambah item-item baharu ke dalam menu pluma supaya fitur-fitur baharu dapat disediakan.

Terdapat beberapa palam telah terbina-dalam bersama-sama pluma.

Untuk membenarkan atau melumpuhkan palam, atau mahu melihat palam manakah dibenarkan, gunakan .

Palam-palam berikut telah terbina-dalam dengan pluma:

- menunjukkan nombor baris, perkataan, dan aksara di dalam dokumen.

- membolehkan anda melakukan perintah-perintah luar menerusi pluma.

- membolehkan anda layari fail dan folder anda dalam bentuk anak tetingkap sisi.

- menambah atau membuang pengensotan daripada baris-baris terpilih.

- menambah tarikh dan waktu semasa ke dalam sesebuah dokumen.

- membolehkan anda tetapkan keutamaan penyuntingan untuk dokumen secara individu, dan menyokong baris-mod atau modeline gaya-Emacs, Kate dan Vim.

- membolehkan anda jalankan perintah dalam bahasa pengaturcaraan python.

- membolehkan anda tanggalkan ruang putih berjela atau trailing whitespaces dalam dokumen anda selepas menyimpan.

- membolehkan anda simpan cebisan-cebisan teks yang kerap digunakan dan sisip ia dengan pantas ke dalam sesebuah dokumen.

- menyusun baris-baris terpilih teks dalam tertib berabjad.

- membetulkan ejaan teks terpilih, atau menanda ralat-ralat secara automatik di dalam dokumen.

- membolehkan anda sisipkan tag-tag yang umumnya-digunakan untuk HTML dan lain-lain bahasa melalui satu senarai dalam anak tetingkap sisi.

Untuk maklumat lanjut berkenaan penciptaan palam, sila rujuk .

### Palam Statistik Dokumen

Palam Statistik Dokumen mengira bilangan baris, perkataan, aksara berserta jarak, aksara tanpa jarak, dan bait dalam fail semasa. Palam memaparkan keputusan dalam satu dialog Statistik Dokumen. Untuk menggunakan palam Statistik Dokumen, buat langkah-langkah berikut:

1. Pilih Alatan Statistik Dokumen untuk memaparkan dialog Statistik Dokumen . Dialog Statistik Dokumenmemaparkan maklumat berikut berkenaan fail:

   - Bilangan baris dalam dokumen semasa.

   - Bilangan perkataan dalam dokumen semasa.

   - Bilangan aksara, termasuk jarak, dalam dokumen semasa.

   - Bilangan aksara, tidak termasuk jarak, dalam dokumen semasa.

   - Bilangan bait dalam dokumen semasa.

2. You can continue to update the pluma file while the Document Statistics dialog is open. To refresh the contents of the Document Statistics dialog, click Update.

### Palam Alatan Luar

Palam Alatan Luar membolehkan anda lakukan perintah-perintah luar menerusi pluma. Anda boleh paipkan beberapa kandungan ke dalam satu perintah dan eksploitasi outputnya (sebagai contoh, sed), atau lancarkan satu perintah pra-takrif (sebagai contoh, make).

Guna Pengurus Alatan Luar untuk mencipta dan menyunting perintah luar. Untuk menjalankan satu perintah luar, pilih ia melalui menu Alatan.

#### Perintah Terbina-dalam

Perintah-perintah berikut disediakan bersama-sama palam Alatan Luar:

Binaan

  Jalankan make dalam direktori dokumen semasa.

Penyenaraian Direktori

  Senaraikan isi kandungan direktori dokumen semasa dalam satu dokumen baharu.

Pembolehubah Persekitaran

  Papar senarai pembolehubah persekitaran dalam anak tetingkap bawah.

Grep

  Gelintar satu terma dalam semua fail di dalam direktori dokumen semasa, menggunakan padanan pola. Hasil yang ditunjukkan dalam anak tetingkap bawah.

Buang Jarak Mengekor

  Buang semua jarak daripada bahagian akhir baris di dalam dokumen.

#### Mentakrifkan satu Perintah

Untuk menambah satu perintah luar, pilih Alatan Alatan Luar .

Dalam tetingkap Pengurus Alatan Luar, klik Baharu. Kemudian, anda boleh menyatakan perincian berikut untuk perintah baharu:

Keterangan

  Keterangan ini ditunjukkan dalam palang status ketika perintah menu dipilih.

Pemecut

  Masukkan satu pintasan papan kekunci untuk perintah.

Perintah-perintah

  Perintah sebenar yang dijalankan. Beberapa pembolehubah persekitaran pluma boleh digunakan untuk melepasi kandungan ke perintah-perintah ini: sila rujuk .

Input

  Kandungan yang diberikan kepada perintah (seperti stdin): keseluruhan teks dokumen semasa, pemilihan, baris, atau perkataan semasa.

Output

  Apa yang hendak dibuat terhadap output-output perintah: papar pada anak tetingkap bawah, masukkan dalam satu dokumen baharu, atua letak ia dalam dokumen semasa, di bahagian akhir, pada kedudukan kursor, atau ganti pemilihan atau keseluruhan dokumen.

Kebolehgunaan

  Tentukan bagaimanakah dokumen boleh dipengaruhi oleh perintah, contohnya sama ada disimpan atau sebaliknya, dan secara setempat atau jauh

#### Menyunting dan Membuang Alatan

Untuk menyunting satu alat, pilih ia di dalam senarai dan buat perubahan terhadap sifat-sifatnya.

Untuk menamakan semula satu alat, klik ia sekali lagi dalam senarai.

Untuk memulihkan satu alat terbina-dalam yang anda mahu ubah, tekan Kembali.

Untuk membuang satu alat, pilih ia dalam senarai dan tekan Buang. Anda tidak boleh membuang alatan terbina-dalam, hanya alatan yang anda cipta sendiri.

#### Pembolehubah

Anda boleh guna pembolehubah-pembolehubah berikut di dalam medan Perintah berdasarkan takrifan perintah:

- PLUMA_CURRENT_DOCUMENT_URI

- PLUMA_CURRENT_DOCUMENT_NAME

- PLUMA_CURRENT_DOCUMENT_SCHEME

- PLUMA_CURRENT_DOCUMENT_PATH

- PLUMA_CURRENT_DOCUMENT_DIR

- PLUMA_DOCUMENTS_URI

- PLUMA_DOCUMENTS_PATH

### Palam Anak Tetingkap Pelayar Fail

Palam Anak Tetingkap Pelayar Fail menunjukkan fail dan folder anda di bahagian anak tetingkap sisi, yang memudahkan anda buka fail-fail dengan pantas.

Untuk melihat Pelayar Fail, pilih Lihat Anak Tetingkap Sisi kemudian klik pada tab bertanda ikon Pelayar Fail di bahagian bawah anak tetingkap sisi.

#### Melayari Fail-fail anda

Tab Pelayar Fail awalnya menunjukkan beberapa tanda buku pengurus fail anda. Untuk melayari kandungan apa jua item, dwi-klik kepadanya.

Untuk menunjukkan satu folder induk, pilih dari senarai tarik-turun, atau tekan anak panah atas pada palang alat Pelayar Fail.

Untuk melihat folder yang mengandungi dokumen semasa anda, klik-kanan dalam senarai dan pilih Tetapkan root kepada dokumen aktif.

#### Membuka sebuah Fail

Untuk membuka satu fail di dalam pluma, dwi-klik ia dalam senarai fail.

#### Mencipta Fail dan Folder

Untuk mencipta satu fail teks kosong, baharu di dalam folder semasa yang ditunjukkan dalam pelayar, klik-kanan dalam senarai fail kemudian pilih Fail Baharu.

Untuk mencipta satu folder baharu dalam folder semasa yang ditunjukkan dalam pelayar, klik-kanan dalam senarai fail kemudian pilih Folder Baharu.

### Palam Engsot Baris

Palam Engsot Baris menambah atau membuang jarak daripada permulaan barisan teks.

Untuk mengensot atau nyahengsot teks, ikuti langkah-langkah berikut.

1. Pilih baris yang mahu diengsotkan. Untuk engsot atau nyahengsot satu baris tunggal, letak kursor di mana-mana sahaja pada baris tersebut.

2. - Untuk mengensot teks, pilih Sunting Engsot .

   - Untuk membuang pengensotan, pilih Sunting Nyahengsot .

Amaun jarak yang digunakan, dan sama ada aksara tab atau aksara jarak digunakan, sebenarnya bergantung pada tetapan Hentian Tab dalam Keutamaan Penyunting: sila rujuk .

### Sisip Palam Tarikh/Waktu

Palam Sisip Tarikh/Waktu menyisip tarikh dan waktu semasa ke dalam sesebuah dokumen. Untuk menggunakan palam Sisip Tarikh/Waktu, buat langkah-langkah berikut:

1. Pilih Sunting Sisip Tarikh dan Waktu.

   If you have not configured the Insert Date/Time plugin to automatically insert the date/time without prompting you for the format, pluma displays the Insert Date and Time dialog. Select the appropriate date/time format from the list. Click Insert to close the Insert Date and Time dialog. pluma inserts the date/time at the cursor position in the current file.

   If you have configured pluma to use one particular date/time format, the Insert Date and Time dialog is not displayed. The date/time is automatically entered at the cursor position in the current file.

#### Mengkonfigur Palam Sisip Tarikh/Waktu

Untuk mengkonfigur palam Sisip Tarikh/Waktu, buat langkah-langkah berikut:

1. Pilih Sunting Keutamaan.

2. Pilih tab Palam.

3. Pilih palam Sisip Tarikh/Waktu.

4. Klik Konfigur Palam untuk memaparkan dialog Konfigur palam sisip tarikh/waktu.

5. Select one of the options, as follows:

   - To specify the date/time format each time you insert the date/time, select the Prompt for a format option.

   - To use the same pluma-provided date/time format each time you insert the date/time, select the Use the selected format option, then select the appropriate format from the list. When you select this option, pluma does not prompt you for the date/time format when you choose Edit Insert Date and Time .

   - To use the same customized date/time format each time you insert the date/time, select the Use custom format option, then enter the appropriate format in the text box. Refer to the strftime 3 for more information on how to specify a custom format. When you select this option, pluma does not prompt you for the date/time format when you choose Edit Insert Date and Time .

6. Klik OK untuk menutup dialog Konfigur palam sisip tarikh/waktu.

7. To close the Preferences dialog, click Close.

### Palam Baris-mod

The Modelines plugin allows you to set preferences for individual documents. A modeline is a line of text at the start or end of the document with settings that pluma recognizes.

Preferences set using modelines take precedence over the ones specified in the preference dialog.

You can set the following preferences with modelines:

- Tab width

- Indent width

- Insert spaces instead of tabs

- Pelilitan Teks

- Right margin width

Palam Baris-mod menyokong satu subset pilihan yang digunakan oleh penyunting teks lain seperti Emacs, Kate dan Vim.

#### Emacs Modelines

The first two lines of a document are scanned for Emacs modelines.

The Emacs options for tab-width, indent-offset, indent-tabs-mode and autowrap are supported. For more information, see the GNU Emacs Manual.

#### Kate Modelines

The first and last ten lines a document are scanned for Kate modelines.

The Kate options for tab-width, indent-width, space-indent, word-wrap and word-wrap-column are supported. For more information, see the Kate website.

#### Vim Modelines

The first and last three lines a document are scanned for Vim modelines.

The Vim options for et, expandtab, ts, tabstop, sw, shiftwidth, wrap, and textwidth are supported. For more information, see the Vim website.

### Palam Konsol Python

The Python Console Plugin allows you to run commands in the python programming language from pluma. Enabling the plugin adds a tab to the bottom pane. This shows recent output and a command prompt field.

Commands entered into the python console are not checked before they are run. It is therefore possible to hang pluma, for example by entering an infinite loop.

### Save Without Trailing Spaces Plugin

The Save Without Trailing Spaces Plugin removes whitespace characters such as space (`˽`), tab (`\t`), carriage returns (`\r`) etc. from the end of a line. To use the Save Without Trailing Spaces plugin, perform the following steps:

1. Enable the plugin as described in .

2. When your document is ready, save it.

3. You will see that any trailing whitespaces has been stripped after the document has been saved.

### Palam Cebisan

The Snippets plugin allows you to store frequently-used pieces of text, called snippets, and insert them quickly into a document.

Snippets are specific to the language syntax of the current document. For example, when you are working with an HTML document, you can choose from a list of snippets that are useful for HTML. In addition, some snippets are global, and are available in all documents.

A number of built-in snippets are installed with pluma, which can be modified.

#### Inserting Snippets

To insert a snippet into a document, type its tab trigger and press Tab. A snippet's tab trigger is usually the first few letters of the snippet, or something else that is short and easy to remember.

Alternatively, press Ctrl Space to see a list of snippets you can insert.

#### Adding Snippets

To create a new snippet, do the following:

1. Choose Tools Manage Snippets . The Snippets Manager window opens.

2. The list of snippets is grouped by language. Select the language you want to add a snippet to, or a snippet in that language group. To add a snippet for all languages, choose Global at the top of the list. The syntax of the document you are currently working with is shown by default.

3. Click New. A new snippet appears in the list.

4. Enter the following information for the new snippet:

   Nama

     Enter a name for the snippet in the text field within the snippet list. The name of a snippet serves only as a reminder of its purpose. You can change name of a snippet you create by clicking on it in the list.

   Snippet text

     Enter the text of the snippet in the Edit snippet text box. For special codes you can use, see .

     You can switch back to the document window to copy text without closing the Snippets Manager window.

   Tab Trigger

     Enter the tab trigger for the snippet. This is the text that you type before pressing Tab to insert the snippet.

     The tag must be either a single word comprising only letters, or any single character. The Tab trigger will highlight in red if an invalid tab trigger is entered.

   Shortcut key

     Type a shortcut key to use for inserting the snippet.

#### Editing and Removing Snippets

To edit a snippet, select it in the list and make changes to its text and activation properties.

To rename a snippet, click it again in the list.

To restore a built-in snippet that you have changed, press Revert.

To remove a snippet, select it in the list and press Remove. You can not remove built-in snippets, only those you have created yourself.

#### Snippet Substitutions

In addition to inserting stored text, a snippet can include customizable text, or mark spaces where you can add text once the snippet is inserted in your document.

You can use the following placeholder codes in snippet text:

Tab placeholders

  `$n` defines a tab placeholder, where `n` is any number from 1 upwards.

  `${n:default}` defines a tab placeholder with a default value.

  A tab placeholder marks a place in the snippet text where you can add extra text after the snippet is inserted.

  To use tab placeholders, insert the snippet as normal. The cursor is placed at the first tab placeholder. Type text, and press Tab to advance to the next tab placeholder. The number in the placeholder code defines the order in which tab advances to each place in the text.

  Press Shift Tab to return to the previous tab placeholder. Pressing Tab when there are no more tab placeholders moves the cursor to the end of the snippet text, or to the end placeholder if it exists.

Mirror placeholders

  A repeated tab placeholder will mirror the placeholder already defined. This allows you to type in text only once that you want to appear several times in the snippet.

End placeholder

  `$0` defines the end placeholder. This allows you to finish working with the snippet with the cursor at a point other than the end of the snippet text.

Environmental variables

  Environmental variable such as `$PATH` and `$HOME` are substituted in snippet text. The following variables specific to pluma can also be used:

  $PLUMA_SELECTED_TEXT

    The currently selected text.

  $PLUMA_FILENAME

    The full filename of the document, or an empty string if the document isn't saved yet.

  $PLUMA_BASENAME

    The basename of the filename of the document, or an empty string if the document isn't saved yet.

  $PLUMA_CURRENT_WORD

    The word at the cursor's location in the document. When this variable is used, the current word will be replaced by the snippet text.

Shell placeholders

  `$(cmd)` is replaced by the result of executing cmd in a shell.

  `$(n:cmd)` allows you to give this placeholder a reference, where n is any number from 1 upwards. Use `$n` to use the output from one shell placeholder as input in another.

Python placeholders

  `$<cmd>` is replaced by the result of evaluating cmd in the python interpreter.

  `$<a:cmd>` specifies another python placeholder as a dependency, where a gives its order in the snippet. This allows you to use python functions defined in another snippet. To specify several dependencies, separate the numbers with commas thus: `$<a,b:cmd>`

  To use a variable in all other python snippets, declare it as `global`.

### Palam Isih

Palam Isih menyusun baris-baris teks terpilih mengikut tertib berabjad.

Untuk menggunakan palam Isih, buat langkah-langkah berikut:

1. Select the lines of text you want to sort.

2. Choose Edit Sort . The Sort dialog opens.

3. Choose the options you want for the sort:

   - To arrange the text in reverse order, select Reverse order.

   - To delete duplicate lines, select Remove duplicates.

   - To ignore case sensitivity, select Ignore case.

   - To have the sort ignore the characters at the start of the lines, set the first character that should be used for sorting in the Start at column spin box.

4. To perform the sort operation, click Sort.

### Palam Pemeriksa Ejaan

Palam Pemeriksa Ejaan memeriksaan ejaan teks terpilih. Anda boleh konfigur pluma untuk memeriksa ejaan secara automatik, atau anda boleh memeriksa ejaan secara manual, berdasarkan bahasa tertentu. Tetapan bahasa, dan sifat-sifat ejaan berauto-semak, terap per dokumen. Untuk menggunakan palam Pemeriksa ejaan, buat langkah-langkah berikut:

1. Choose Tools Set Language to display the Set language dialog. Select the appropriate language from the list. Click OK to close the Set language dialog.

2. To check the spelling automatically, choose Tools Autocheck Spelling . To unset the automatic spell check, choose Tools Autocheck Spelling again. When automatic spell checking is set, an icon is displayed beside the Autocheck Spelling menu item. Automatic spell checking is unset by default, each time pluma starts.

   Unknown spellings are displayed in a different color, and underlined. Right-click on an unknown spelling, then select Spelling Suggestions from the popup menu:

   - To replace the unknown spelling with another spelling in the list, select the replacement spelling from the Spelling Suggestions popup menu.

   - To add the unknown spelling to your personal dictionary, select Spelling Suggestions Add .

   - To ignore all occurrences of the unknown spelling, so that they are no longer flagged as unknown but are not added to your personal dictionary, select Spelling Suggestions Ignore All . The unknown word is ignored in the current pluma session only.

3. To check the spelling manually, choose Tools Check Spelling .

   If there are no spelling errors, an Information dialog displays a message stating that the document does not contain misspelled words. Click OK to close the Information dialog.

   If there are spelling errors, the Check Spelling dialog is displayed:

   - The Misspelled word is displayed at the top of the dialog.

   - A suggested known spelling is displayed in the Change to text box. You can replace this with another known spelling by selecting a spelling from the Suggestions list, or you can enter text directly into the Change to text box.

   - To check the spelling of the text in the Change to text box, click Check Word. If this is a known word, the Suggestions list is replaced with the text `(correct spelling)`. If the word is not known, new entries appear in the Suggestions list.

   - To ignore the current occurrence of the unknown word, click Ignore. To ignore all occurrences of the unknown word, click Ignore All. The unknown word is ignored in the current pluma session only.

   - To change the current occurrence of the unknown word to the text in the Change to text box, click Change. To change all occurrences of the unknown word to the text in the Change to text box, click Change All.

   - To add the unknown word to your personal dictionary, click Add word.

   - To close the Check Spelling dialog, click Close.

### Palam Senarai Tag

Palam Senarai Tag membolehkan anda sisip tag-tag umum daripada satu senarai dalam anak tetingkap sisi.

Untuk menggunakan palam Senarai Tag, buat langkah-langkah berikut:

1. Choose View Side Pane .

2. By default, the side pane shows a tab containing a list of open documents. Click on the tab showing a + icon at the bottom of the side pane to show the tag list tab.

3. Select the appropriate tag category from the drop-down list. For example, HTML - Tags.

4. Scroll through the tag list to find the required tag.

5. To insert a tag at the cursor position in the current file, double-click on the tag in the tag list. You can also insert a tag as follows:

   - To insert a tag in the current file and change the focus from the side pane to the display area, press Return.

   - To insert a tag in the current file and maintain the focus on the Tag list plugin window, press Shift Return .