calibre - en to ms translation catalogue (33 entries)

en: Snippets
ms: Snippet

en: Not only that, the word ``filename`` will be selected, with the cursor placed over it, so that you can easily type in the real filename, using the editor's nifty :ref:`editor_auto_complete` feature. And once you are done typing the filename, press |ct| again and the cursor will jump to the position in between the ``<a>`` tags so you can easily type in the text for the link.
ms: Bukan hanya itu sahaja, perkataan ``filename`` akan dipilih, dengan kursor berada diatasnya, anda dapat menaip dalam nama fail sebenar, menggunakan fitur penyunting :ref:`editor_auto_complete`. Dan selesai menaip nama fail, tekan |ct| sekali lagi dan kursor akan lompat ke kedudukan diantara tag ``<a>`` supaya anda boleh taipkan teks untuk pautan dengan mudah.

en: The snippets system in the editor is very sophisticated, there are a few built-in snippets and you can create your own to suit your editing style.
ms: Sistem snippet dalam penyunting adalah sangat kompleks, terdapat beberapa snippet terbina-dalam dan anda boleh cipta sendiri untuk memenuhi gaya penyuntingan anda.

en: The following discussion of the built-in snippets should help illustrate the power of the snippets system.
ms: Penerangan snippet terbina-dalam berikut dapat mengilustrasikan kehebatan sistem snippet.

en: You can also use snippets in the text entry fields in the :guilabel:`Search & replace` panel, however, placeholders (using |ct| to jump around) will not work.
ms: Anda juga boleh guna snippet dalam medan masukan teks dalam panel :guilabel:`Gelintar dan Ganti', walaubagaimanapun, pemegang tempat atau placeholder (gunakan |ct| sebagai ganti) tidak akan berfungsi.

en: The built-in snippets
ms: Snippet terbina-dalam

en: The built-in snippets are described below. Note that you can override them by creating your own snippets with the same trigger text.
ms: Snippet terbina-dalam dijelaskan seperti di bawah. Perhatian, anda boleh batalkannya dengan mencipta snippet anda sendiri dengan teks pemicu yang sama.

en: Inserting filler text [Lorem]
ms: Menyisip teks pengisi [Lorem]

en: The first built-in snippet, and the simplest is used to insert filler text into a document. The filler text is taken from `De finibus bonorum et malorum <https://en.wikipedia.org/wiki/De_finibus_bonorum_et_malorum>`_ a philosophical work by Cicero (translated to English). To use it simply type ``Lorem`` in an HTML file and press |ct|. It will be replaced by a couple of paragraphs of filler.
ms: Snippet terbina-dalam pertama dan paling mudah digunakan untuk menyisip teks pengisi ke dalam dokumen. Teks pengisi diambil dari `De finibus bonorum et malorum <https://en.wikipedia.org/wiki/De_finibus_bonorum_et_malorum>`_ iaitu hasil kera oleh Cicero (diterjemah ke dalam bahasa Inggeris). Untuk gunakannya hanya taip ``Lorem`` dalam fail HTML dan tekan |ct|. Ia akan diganti dengan beberapa perenggan pengisi.

en: The definition of this snippet is very simple, the trigger text is defined as ``Lorem`` and the template is defined simply as the literal text to be inserted. You can easily customize it to use your favorite form of filler text.
ms: Takrifan snippet ini adalah sangat mudah, teks pemicu ditakrif sebagai ``Lorem`` dan templat ditakrif sebagai teks harfiah yang akan disisipkan. Anda boleh suai ia dengan mudah untuk guna bentuk teks pengisi kegemaran anda.

en: Inserting a self-closing HTML tag [<>]
ms: Menyisip tag HTML tertutup-kendiri [<>]

en: Now let's look at a simple example of the powerful concept of *placeholders*. Say you want to insert the self-closing tag ``<hr/>``. Just type ``<>``, and press |ct|, the editor will expand the snippet to::
ms: Sekarang cuba lihat contoh mudah konsep *placeholders*. Jika anda mahu menyisip tag tertutup-kendiri ``<hr/>``. Hanya taip ``<>``, kemudian tekan |ct|, penyunting akan kembangkan snippet menjadi::

en: Here, the ``|`` symbol represents the current cursor position. You can then type ``hr`` and press |ct| to move the cursor to after the end of the tag. This snippet is defined as::
ms: Di sini, simbol ``|`` mewakili kedudukan kursor tetikus semasa. Anda boleh taip ``hr`` kemudian tekan |ct| untuk gerak kursor dipenghujung tag. Snippet ini ditakrif sebagai::

en: Placeholders are simply the dollar ($) sign followed by a number. When the snippet is expanded by pressing |ct| the cursor is positioned at the first placeholder (the placeholder with the lowest number). When you press |ct| again the cursor jumps to the next placeholder (the placeholder with the next higher number).
ms: Pemegang-tempat adalah tanda dollar ($) yang diikuti dengan nombor. Bila snippet dikembangkan dengan menekan |ct| kursor diletak pada pemegang-tempat pertama (pepegang-tempat dengan nombor paling rendah). Bila anda tekan |ct| sekali lagi kursor lompat ke pemegang-tempat berikutnya (pemegang-tempat dengan nombor lebih tinggi berikutnya).

en: Inserting an HTML link tag [<a]
ms: Menyisip tag pautan HTML [<a]

en: HTML link tags all share a common structure. They have an ``href`` attribute and some text between the opening and closing tags. A snippet to make typing them more efficient will introduce us to some more features of placeholders. To use this snippet, simply type ``<a`` and press |ct|. The editor will expand this to::
ms: Tag pautan HTML kesemuanya berkongsi struktur umumnya. Mereka mempunyai atribut ``href`` dan beberapa teks diantara tag pembuka dengan tag penutup. Snippet menjadikan penaipan mereka lebih efisyen yang mana terdapat beberapa fitur pemegang-tempat. Untuk guna snippet ini, hanya taip ``<a`` dan tekan |ct|. Penyunting akan kembangkan seperti ini::

en: Not only that, the word ``filename`` will be selected, with the cursor placed over it, so that you can easily type in the real filename, using the editor's nifty :ref:`editor_auto_complete` feature. And once you are done typing the filename, press |ct| again and the cursor will jump to the position in between the ``<a>`` tags so you can easily type in the text for the link. After you are done typing the text, press |ct| again to jump to the point after the closing tag.  This snippet is defined as::
ms: Bukan hanya itu sahaja, perkataan ``filename`` akan dipilih, dengan kursor berada diatasnya, anda dapat menaip dalam nama fail sebenar, menggunakan fitur penyunting :ref:`editor_auto_complete`. Dan selesai menaip nama fail, tekan |ct| sekali lagi dan kursor akan lompat ke kedudukan diantara tag ``<a>`` supaya anda boleh taipkan teks untuk pautan dengan mudah. Selepas anda selesai menaip teks, tekan  |ct| sekali lagi untuk lompat ke kedudukan selepas tag penutup. Snippet ini ditakrif sebagai::

en: There are a couple of new features here. First the ``$1`` placeholder has become more complex. It now includes some *default text* (the word ``filename``). If a placeholder contains default text, the default text is substituted for the placeholder when the snippet is expanded. Also when you jump to a placeholder with default text using |ct|, the default text is selected. In this way, you can use default text to act as a reminder to you to fill in important parts of the template. You can specify default text for a placeholder by using the syntax: ``${<number>:default text}``.
ms: Terdapat beberapa pasangan fitur baharu di sini. Pertama, pemegang-tempat ``$1`` menjadi lebih kompleks. Ia kini menyertakan beberapa *teks lalai* (perkataan ``filename``). Jika pemegang-tempat mengandungi teks lalai, teks lalai adalah pengganti untuk pemegang-tempat jika snippet dikembangkan. Dan juga bila anda lompat ke pemegang-tempat dengan teks lalai menggunakan |ct|, teks lalai dipilih. Dengan cara ini, anda boleh guna teks lalai untuk bertindak sebagai peringatan pada anda untuk mengisi bahagian penting templat. Anda juga boleh nyatakan teks lalai untuk pemegang-tempat dengan menggunakan sintaks: ``${<number>:default text}``.

en: The other new feature is that the second placeholder has an asterisk after it (``${2*}``). This means that any text that was selected before expanding the template is substituted for the placeholder. To see this in action, select some text in the editor, press |ct|, type ``<a`` and press |ct| again, the template will be expanded to::
ms: Lain-lain fitur baharu ialah pemegang-tempat kedua yang mempunyai asterisk selepas ia (``${2*}``). Ini bermaksud mana-mana teks yang terpilih sebelum pengembangan templat digantikan untuk pemegang-tempat. Untuk melihat tindakan ini, pilih beberapa teks dalam penyunting, tekan |ct|, taip ``<a`` dan tekan |ct| sekali lagi, templat akan dikembangkan menjadi::

en: Inserting a HTML image tag [<i]
ms: Menyisip tag imej HTML [<i]

en: This is very similar to inserting an HTML link, as we saw above. It allows you to quickly input an ``<img src="filename" alt="description" />`` tag and jump between the ``src`` and ``alt`` attributes::
ms: Cara yang sama seperti menyisip pautan HTML, sepertimana di atas. Ia membolehkan anda masukkan tag ``<img src="filename" alt="description" />`` dengan pantas dan lompat diantara atribut ``src`` dengan ``alt``::

en: Insert an arbitrary HTML tag [<<]
ms: Menyisip tag HTML arbitari [<<]

en: This allows you to insert an arbitrary full HTML tag (or wrap previously selected text in the tag). To use it, simply type ``<<`` and press |ct|. The editor will expand it to::
ms: Ia membolehkan anda sisip tag HTML arbitari penuh (atau lilit teks terpilih terdahulu di dalam tag). Untuk gunakannya, hanya taip ``<<`` dan tekan |ct|.Penyunting akan kembangkannya menjadi::

en: Type the tag name, for example: ``span`` and press |ct|, that will result in::
ms: Taip nama tag, contohnya: ``span`` dan tekan |ct|, hasilnya::

en: You will note that the closing tag has been automatically filled with ``span``. This is achieved with yet another feature of placeholders, *mirroring*. Mirroring simply means that if you specify the sample placeholder more than once in a template, the second and all later positions will be automatically filled in with whatever you type in the first position, when you press |ct|. The definition for this snippet is::
ms: Anda akan dapati tagi penutup telah diisi secara automatik dengan ``span``. Ia dilakukan dengan satu lagi fitur pemegang-tempat, *mirroring*. Mirroring secara mudah jika anda nyatakan pemegang-tempat sampel lebih dari sekali dalam sesebuah templat, yang kedua dan semua kedudukan kemudian akan diisi secara automatik, bila anda tekan |ct|. Takrifan untuk snippet adalah::

en: As you can see, the first placeholder ($1) has been specified twice, the second time in the closing tag, which will simply copy whatever you type in the opening tag.
ms: Sepertimana yang anda lihat, pemegang-tempat pertama ($1) telah dinyatakan sebanyak dua kali, yang kedua dalam tag penutup, yang mana akan menyalin apa jua yang anda taip dalam tag pembukaan.

en: Inserting an arbitrary HTML tag with a class attribute [<c]
ms: Menyisip tag HTML arbitari dengan atribut kelas [<c]

en: This is very similar to the insert arbitrary tag example above, except that it assumes that you want to specify a class for the tag::
ms: Ia hampir serupa dengan contoh penyisipan tag arbitari di atas, kecuali ia menganggap anda mahu nyatakan kelas untuk tag::

en: This will allow you to first type the tag name, press |ct|, type the class name, press |ct| type the contents of the tag and press |ct| one last time to jump out of the tag. The closing tag will be auto-filled.
ms: Ia membolehkan anda taip dahulu nama tag, kemudian tekan |ct|, taip nama kelas, tekan |ct| taip kandungan tag dan seterusnya tekan |ct| sekali lagi untuk keluar dari tag. Tag penutup akan diisi secara automatik.

en: Creating your own snippets
ms: Mencipta snippet anda sendiri

en: Snippets really shine because you can create your own to suit your editing style. To create your own snippets go to :guilabel:`Edit->Preferences->Editor settings->Manage snippets` in the editor. This will pop-up an easy to use dialog to help you create your own snippets. Simply click the :guilabel:`Add snippet` button and you will see a dialog that looks like:
ms: Snippet menyenangkan kerana anda boleh cipta sendiri untuk memenuhi gaya penyuntingan anda. Untuk mencipta snippets anda sendiri, pergi ke :guilabel:`Sunting->Keutamaan->Tetapan penyunting->Urus snippet` dalam penyunting. Satu dialog timbul akan bantu anda menghasilkan snippet anda sendiri. Hanya klik pada butang :guilabel:`Tambah snippet` dan anda akan lihat satu dialog seperti berikut:

en: First give your snippet a name, something descriptive, to help identify the snippet in the future. Then specify the *trigger*. A trigger is simply the text that you have to type in the editor before pressing |ct| in order to expand the snippet.
ms: Mula-mula berikan nama snippet anda, yang dapat menjelaskan snippet tersebut. Kemudian nyatakan *trigger*. Trigger atau pemicu merupakan teks yang anda perlu taip dalam penyunting sebelum menekan |ct| untuk dapat kembangkan snippet.

en: The next step is to test your newly created snippet. Use the :guilabel:`Test` box at the bottom. Type in the trigger text and press |ct| to expand the snippet and jump between placeholders.
ms: Langkah seterusnya adalah menguji snippet yang baru anda cipta. Gunakan kotak :guilabel:`Uji` yang berada dibahagian bawah. Taipkan teks pemicu dan tekan |ct| untuk kembangkan snippet dan lompat diantara pemegang-tempat.
