1# SOME DESCRIPTIVE TITLE.
2# Copyright (C) Kovid Goyal
3# This file is distributed under the same license as the calibre package.
4#
5# Translators:
6# Maidur, 2016,2020
7msgid ""
8msgstr ""
9"Project-Id-Version: calibre\n"
10"Report-Msgid-Bugs-To: \n"
11"POT-Creation-Date: 2021-10-07 03:23+0000\n"
12"PO-Revision-Date: 2021-10-06 16:17+0000\n"
13"Last-Translator: Kovid Goyal <kovid@kovidgoyal.net>\n"
14"Language-Team: Estonian (http://www.transifex.com/calibre/calibre/language/et/)\n"
15"MIME-Version: 1.0\n"
16"Content-Type: text/plain; charset=UTF-8\n"
17"Content-Transfer-Encoding: 8bit\n"
18"Language: et\n"
19"Plural-Forms: nplurals=2; plural=(n != 1);\n"
20
21#: ../../__w/calibre/calibre/manual/snippets.rst:2
22msgid "Snippets"
23msgstr "Katked"
24
25#: ../../__w/calibre/calibre/manual/snippets.rst:6
26msgid ""
27"The calibre E-book editor supports *snippets*. A snippet is a piece of text "
28"that is either re-used often or contains a lot of redundant text. The editor"
29" allows you to insert a snippet with only a few key strokes. For example, "
30"suppose you often find yourself inserting link tags when editing HTML files,"
31" then you can simply type ``<a`` in the editor and press |ct|. The editor "
32"will expand it to::"
33msgstr "calibre E-raamatute redaktor toetab *katkeid*. Katke on tekstijupp, mida kasutatakse tihti või sisaldab sisaldab palju liigset teksti. Redaktor lubab sul katke sisestada ainult mõne klahvivajutusega. Näiteks kui avastad end HTML-faile muutes tihti lingisilte sisestamas, võid redaktorisse sisestada lihtsalt ``<a`` ning vajutada klahvikombinatsiooni |ct|. Redaktor laiendab selle siis selliseks::"
34
35#: ../../__w/calibre/calibre/manual/snippets.rst:15
36msgid ""
37"Not only that, the word ``filename`` will be selected, with the cursor "
38"placed over it, so that you can easily type in the real filename, using the "
39"editor's nifty :ref:`editor_auto_complete` feature. And once you are done "
40"typing the filename, press |ct| again and the cursor will jump to the "
41"position in between the ``<a>`` tags so you can easily type in the text for "
42"the link."
43msgstr ""
44
45#: ../../__w/calibre/calibre/manual/snippets.rst:21
46msgid ""
47"The snippets system in the editor is very sophisticated, there are a few "
48"built-in snippets and you can create your own to suit your editing style."
49msgstr ""
50
51#: ../../__w/calibre/calibre/manual/snippets.rst:24
52msgid ""
53"The following discussion of the built-in snippets should help illustrate the"
54" power of the snippets system."
55msgstr ""
56
57#: ../../__w/calibre/calibre/manual/snippets.rst:28
58msgid ""
59"You can also use snippets in the text entry fields in the :guilabel:`Search "
60"& replace` panel, however, placeholders (using |ct| to jump around) will not"
61" work."
62msgstr ""
63
64#: ../../__w/calibre/calibre/manual/snippets.rst:33
65msgid "The built-in snippets"
66msgstr "Sisseehitatud katked"
67
68#: ../../__w/calibre/calibre/manual/snippets.rst:35
69msgid ""
70"The built-in snippets are described below. Note that you can override them "
71"by creating your own snippets with the same trigger text."
72msgstr ""
73
74#: ../../__w/calibre/calibre/manual/snippets.rst:39
75msgid "Inserting filler text [Lorem]"
76msgstr "Täiteteksti sisestamine [Lorem]"
77
78#: ../../__w/calibre/calibre/manual/snippets.rst:41
79msgid ""
80"The first built-in snippet, and the simplest is used to insert filler text "
81"into a document. The filler text is taken from `De finibus bonorum et "
82"malorum <https://en.wikipedia.org/wiki/De_finibus_bonorum_et_malorum>`_ a "
83"philosophical work by Cicero (translated to English). To use it simply type "
84"``Lorem`` in an HTML file and press |ct|. It will be replaced by a couple of"
85" paragraphs of filler."
86msgstr ""
87
88#: ../../__w/calibre/calibre/manual/snippets.rst:48
89msgid ""
90"The definition of this snippet is very simple, the trigger text is defined "
91"as ``Lorem`` and the template is defined simply as the literal text to be "
92"inserted. You can easily customize it to use your favorite form of filler "
93"text."
94msgstr ""
95
96#: ../../__w/calibre/calibre/manual/snippets.rst:53
97msgid "Inserting a self-closing HTML tag [<>]"
98msgstr "Isesulguva HTML-sildi sisestamine [<>]"
99
100#: ../../__w/calibre/calibre/manual/snippets.rst:55
101msgid ""
102"Now let's look at a simple example of the powerful concept of "
103"*placeholders*. Say you want to insert the self-closing tag ``<hr/>``. Just "
104"type ``<>``, and press |ct|, the editor will expand the snippet to::"
105msgstr ""
106
107#: ../../__w/calibre/calibre/manual/snippets.rst:61
108msgid ""
109"Here, the ``|`` symbol represents the current cursor position. You can then "
110"type ``hr`` and press |ct| to move the cursor to after the end of the tag. "
111"This snippet is defined as::"
112msgstr ""
113
114#: ../../__w/calibre/calibre/manual/snippets.rst:68
115msgid ""
116"Placeholders are simply the dollar ($) sign followed by a number. When the "
117"snippet is expanded by pressing |ct| the cursor is positioned at the first "
118"placeholder (the placeholder with the lowest number). When you press |ct| "
119"again the cursor jumps to the next placeholder (the placeholder with the "
120"next higher number)."
121msgstr ""
122
123#: ../../__w/calibre/calibre/manual/snippets.rst:75
124msgid "Inserting an HTML link tag [<a]"
125msgstr "HTML-lingi sildi sisestamine [<a]"
126
127#: ../../__w/calibre/calibre/manual/snippets.rst:77
128msgid ""
129"HTML link tags all share a common structure. They have an ``href`` attribute"
130" and some text between the opening and closing tags. A snippet to make "
131"typing them more efficient will introduce us to some more features of "
132"placeholders. To use this snippet, simply type ``<a`` and press |ct|. The "
133"editor will expand this to::"
134msgstr ""
135
136#: ../../__w/calibre/calibre/manual/snippets.rst:85
137msgid ""
138"Not only that, the word ``filename`` will be selected, with the cursor "
139"placed over it, so that you can easily type in the real filename, using the "
140"editor's nifty :ref:`editor_auto_complete` feature. And once you are done "
141"typing the filename, press |ct| again and the cursor will jump to the "
142"position in between the ``<a>`` tags so you can easily type in the text for "
143"the link. After you are done typing the text, press |ct| again to jump to "
144"the point after the closing tag.  This snippet is defined as::"
145msgstr ""
146
147#: ../../__w/calibre/calibre/manual/snippets.rst:96
148msgid ""
149"There are a couple of new features here. First the ``$1`` placeholder has "
150"become more complex. It now includes some *default text* (the word "
151"``filename``). If a placeholder contains default text, the default text is "
152"substituted for the placeholder when the snippet is expanded. Also when you "
153"jump to a placeholder with default text using |ct|, the default text is "
154"selected. In this way, you can use default text to act as a reminder to you "
155"to fill in important parts of the template. You can specify default text for"
156" a placeholder by using the syntax: ``${<number>:default text}``."
157msgstr ""
158
159#: ../../__w/calibre/calibre/manual/snippets.rst:105
160msgid ""
161"The other new feature is that the second placeholder has an asterisk after "
162"it (``${2*}``). This means that any text that was selected before expanding "
163"the template is substituted for the placeholder. To see this in action, "
164"select some text in the editor, press |ct|, type ``<a`` and press |ct| "
165"again, the template will be expanded to::"
166msgstr ""
167
168#: ../../__w/calibre/calibre/manual/snippets.rst:114
169msgid "Inserting a HTML image tag [<i]"
170msgstr "HTML-pildi sildi sisestamine [<i]"
171
172#: ../../__w/calibre/calibre/manual/snippets.rst:116
173msgid ""
174"This is very similar to inserting an HTML link, as we saw above. It allows "
175"you to quickly input an ``<img src=\"filename\" alt=\"description\" />`` tag"
176" and jump between the ``src`` and ``alt`` attributes::"
177msgstr ""
178
179#: ../../__w/calibre/calibre/manual/snippets.rst:124
180msgid "Insert an arbitrary HTML tag [<<]"
181msgstr "Tühja HTML-sildi sisestamine [<<]"
182
183#: ../../__w/calibre/calibre/manual/snippets.rst:126
184msgid ""
185"This allows you to insert an arbitrary full HTML tag (or wrap previously "
186"selected text in the tag). To use it, simply type ``<<`` and press |ct|. The"
187" editor will expand it to::"
188msgstr ""
189
190#: ../../__w/calibre/calibre/manual/snippets.rst:132
191msgid ""
192"Type the tag name, for example: ``span`` and press |ct|, that will result "
193"in::"
194msgstr "Sisesta sildi nimi, näiteks ``span`` ja vajuta klahvikombinatsiooni |ct|, see annab tulemuseks::"
195
196#: ../../__w/calibre/calibre/manual/snippets.rst:136
197msgid ""
198"You will note that the closing tag has been automatically filled with "
199"``span``. This is achieved with yet another feature of placeholders, "
200"*mirroring*. Mirroring simply means that if you specify the sample "
201"placeholder more than once in a template, the second and all later positions"
202" will be automatically filled in with whatever you type in the first "
203"position, when you press |ct|. The definition for this snippet is::"
204msgstr ""
205
206#: ../../__w/calibre/calibre/manual/snippets.rst:146
207msgid ""
208"As you can see, the first placeholder ($1) has been specified twice, the "
209"second time in the closing tag, which will simply copy whatever you type in "
210"the opening tag."
211msgstr ""
212
213#: ../../__w/calibre/calibre/manual/snippets.rst:151
214msgid "Inserting an arbitrary HTML tag with a class attribute [<c]"
215msgstr "Tühja HTML-sildi koos klassi atribuudiga sisestamine [<c]"
216
217#: ../../__w/calibre/calibre/manual/snippets.rst:153
218msgid ""
219"This is very similar to the insert arbitrary tag example above, except that "
220"it assumes that you want to specify a class for the tag::"
221msgstr ""
222
223#: ../../__w/calibre/calibre/manual/snippets.rst:159
224msgid ""
225"This will allow you to first type the tag name, press |ct|, type the class "
226"name, press |ct| type the contents of the tag and press |ct| one last time "
227"to jump out of the tag. The closing tag will be auto-filled."
228msgstr ""
229
230#: ../../__w/calibre/calibre/manual/snippets.rst:165
231msgid "Creating your own snippets"
232msgstr "Oma katkete loomine"
233
234#: ../../__w/calibre/calibre/manual/snippets.rst:167
235msgid ""
236"Snippets really shine because you can create your own to suit your editing "
237"style. To create your own snippets go to "
238":guilabel:`Edit->Preferences->Editor settings->Manage snippets` in the "
239"editor. This will pop-up an easy to use dialog to help you create your own "
240"snippets. Simply click the :guilabel:`Add snippet` button and you will see a"
241" dialog that looks like:"
242msgstr ""
243
244#: ../../__w/calibre/calibre/manual/snippets.rstNone
245msgid "The create your own snippets tool"
246msgstr ""
247
248#: ../../__w/calibre/calibre/manual/snippets.rst:178
249msgid ""
250"First give your snippet a name, something descriptive, to help identify the "
251"snippet in the future. Then specify the *trigger*. A trigger is simply the "
252"text that you have to type in the editor before pressing |ct| in order to "
253"expand the snippet."
254msgstr ""
255
256#: ../../__w/calibre/calibre/manual/snippets.rst:183
257msgid ""
258"Then specify the snippet template. You should start with one of the examples"
259" above and modify it to suit your needs. Finally, specify which file types "
260"you want the snippet to be active for. This way you can have multiple "
261"snippets with the same trigger text that work differently in different file "
262"types."
263msgstr ""
264
265#: ../../__w/calibre/calibre/manual/snippets.rst:188
266msgid ""
267"The next step is to test your newly created snippet. Use the "
268":guilabel:`Test` box at the bottom. Type in the trigger text and press |ct| "
269"to expand the snippet and jump between placeholders."
270msgstr ""
271