Debian Codegraph @

translations/manual/ko/creating_plugins.po

raw
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 # Junghee Lee <[email protected]>, 2022,2026
7 # Junghee Lee <[email protected]>, 2021-2022
8 msgid ""
9 msgstr ""
10 "Project-Id-Version: calibre\n"
11 "Report-Msgid-Bugs-To: \n"
12 "POT-Creation-Date: 2026-04-08 13:52+0000\n"
13 "PO-Revision-Date: 2014-06-17 08:35+0000\n"
14 "Last-Translator: Junghee Lee <[email protected]>, 2022,2026\n"
15 "Language-Team: Korean (http://app.transifex.com/calibre/calibre/language/ko/)\n"
16 "MIME-Version: 1.0\n"
17 "Content-Type: text/plain; charset=UTF-8\n"
18 "Content-Transfer-Encoding: 8bit\n"
19 "Language: ko\n"
20 "Plural-Forms: nplurals=1; plural=0;\n"
21
22 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:4
23 msgid "Writing your own plugins to extend calibre's functionality"
24 msgstr "직접 플러그인을 작성하여 calibre 기능 확장하기"
25
26 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:6
27 msgid ""
28 "calibre has a very modular design. Almost all functionality in calibre comes"
29 " in the form of plugins. Plugins are used for conversion, for downloading "
30 "news (though these are called recipes), for various components of the user "
31 "interface, to connect to different devices, to process files when adding "
32 "them to calibre and so on. You can get a complete list of all the built-in "
33 "plugins in calibre by going to :guilabel:`Preferences->Advanced->Plugins`."
34 msgstr "calibre는 매우 모듈화된 설계를 가지고 있습니다. calibre의 거의 모든 기능이 플러그인 형태로 제공됩니다. 플러그인은 변환, 뉴스 다운로드(이것은 레시피라고 합니다), 사용자 인터페이스의 다양한 구성 요소, 다양한 장치 연결, calibre에 파일 추가 시 파일 처리 등에 사용됩니다. :guilabel:`환경설정->고급->플러그인`으로 이동하여 calibre의 모든 내장 플러그인의 전체 목록을 확인할 수 있습니다."
35
36 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:8
37 msgid ""
38 "Here, we will teach you how to create your own plugins to add new features "
39 "to calibre."
40 msgstr "여기에서는 calibre에 새 기능을 추가하기 위해 직접 플러그인을 만드는 방법을 설명합니다."
41
42 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:13
43 msgid "Contents"
44 msgstr "목차"
45
46 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:15
47 msgid "This only applies to calibre releases >= 0.8.60"
48 msgstr "이것은 calibre 릴리스 >= 0.8.60에만 적용됩니다"
49
50 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:18
51 msgid "Anatomy of a calibre plugin"
52 msgstr "calibre 플러그인의 구조"
53
54 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:20
55 msgid ""
56 "A calibre plugin is very simple, it's just a ZIP file that contains some "
57 "Python code and any other resources like image files needed by the plugin. "
58 "Without further ado, let's see a basic example."
59 msgstr "calibre 플러그인은 매우 간단합니다. 일부 Python 코드와 플러그인에 필요한 이미지 파일과 같은 기타 리소스가 포함된 ZIP 파일일 뿐입니다. 바로 기본 예시를 살펴보겠습니다."
60
61 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:24
62 msgid ""
63 "Suppose you have an installation of calibre that you are using to self "
64 "publish various e-documents in EPUB and MOBI formats. You would like all "
65 "files generated by calibre to have their publisher set as \"Hello world\", "
66 "here's how to do it. Create a file named :file:`__init__.py` (this is a "
67 "special name and must always be used for the main file of your plugin) and "
68 "enter the following Python code into it:"
69 msgstr "EPUB 및 MOBI 형식의 다양한 전자 문서를 자체 발행하는 데 사용하는 calibre 설치가 있다고 가정합니다. calibre에서 생성된 모든 파일의 발행자를 \"Hello world\"로 설정하고 싶다면 다음 방법을 따르세요. :file:`__init__.py`라는 파일을 만드세요(이것은 특별한 이름이며 플러그인의 메인 파일에 항상 사용해야 합니다). 그리고 다음 Python 코드를 입력하세요:"
70
71 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:32
72 msgid ""
73 "That's all. To add this code to calibre as a plugin, simply run the "
74 "following in the folder in which you created :file:`__init__.py`::"
75 msgstr "이것이 전부입니다. 이 코드를 플러그인으로 calibre에 추가하려면 :file:`__init__.py`를 만든 폴더에서 다음을 실행하세요::"
76
77 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:38
78 msgid ""
79 "On macOS, the command line tools are inside the calibre bundle, for example,"
80 " if you installed calibre in :file:`/Applications` the command line tools "
81 "are in :file:`/Applications/calibre.app/Contents/MacOS/`."
82 msgstr "macOS에서는 명령줄 도구가 calibre 번들 안에 있습니다. 예를 들어, calibre를 :file:`/Applications`에 설치한 경우 명령줄 도구는 :file:`/Applications/calibre.app/Contents/MacOS/`에 있습니다."
83
84 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:42
85 msgid ""
86 "You can download the Hello World plugin from "
87 ":download_file:`helloworld_plugin.zip`."
88 msgstr ":download_file:`helloworld_plugin.zip`에서 Hello World 플러그인을 다운로드할 수 있습니다."
89
90 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:45
91 msgid ""
92 "Every time you use calibre to convert a book, the plugin's :meth:`run` "
93 "method will be called and the converted book will have its publisher set to "
94 "\"Hello World\". This is a trivial plugin, let's move on to a more complex "
95 "example that actually adds a component to the user interface."
96 msgstr "calibre를 사용하여 책을 변환할 때마다 플러그인의 :meth:`run` 메서드가 호출되고 변환된 책의 발행자가 \"Hello World\"로 설정됩니다. 이것은 간단한 플러그인이며, 이제 실제로 사용자 인터페이스에 구성 요소를 추가하는 더 복잡한 예시로 넘어가겠습니다."
97
98 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:50
99 msgid "A User Interface plugin"
100 msgstr "사용자 인터페이스 플러그인"
101
102 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:52
103 msgid ""
104 "This plugin will be spread over a few files (to keep the code clean). It "
105 "will show you how to get resources (images or data files) from the plugin "
106 "ZIP file, allow users to configure your plugin, how to create elements in "
107 "the calibre user interface and how to access and query the books database in"
108 " calibre."
109 msgstr "이 플러그인은 여러 파일에 걸쳐 있습니다(코드를 깔끔하게 유지하기 위해). 플러그인 ZIP 파일에서 리소스(이미지 또는 데이터 파일)를 가져오는 방법, 사용자가 플러그인을 구성할 수 있게 하는 방법, calibre 사용자 인터페이스에 요소를 만드는 방법, calibre의 책 데이터베이스에 접근하고 쿼리하는 방법을 보여줍니다."
110
111 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:57
112 msgid ""
113 "You can download this plugin from :download_file:`interface_demo_plugin.zip`"
114 msgstr ":download_file:`interface_demo_plugin.zip`에서 이 플러그인을 다운로드할 수 있습니다"
115
116 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:61
117 msgid ""
118 "The first thing to note is that this ZIP file has a lot more files in it, "
119 "explained below, pay particular attention to ``plugin-import-name-"
120 "interface_demo.txt``."
121 msgstr "먼저 이 ZIP 파일에는 아래 설명된 것처럼 더 많은 파일이 포함되어 있습니다. ``plugin-import-name-interface_demo.txt``에 특히 주의하세요."
122
123 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:64
124 msgid "**plugin-import-name-interface_demo.txt**"
125 msgstr "**plugin-import-name-interface_demo.txt**"
126
127 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:65
128 msgid ""
129 "An empty text file used to enable the multi-file plugin magic. This file "
130 "must be present in all plugins that use more than one .py file. It should be"
131 " empty and its filename must be of the form: ``plugin-import-"
132 "name-**some_name**.txt``. The presence of this file allows you to import "
133 "code from the .py files present inside the ZIP file, using a statement "
134 "like::"
135 msgstr "다중 파일 플러그인 기능을 활성화하는 데 사용되는 빈 텍스트 파일입니다. 이 파일은 하나 이상의 .py 파일을 사용하는 모든 플러그인에 있어야 합니다. 비어 있어야 하며 파일명은 ``plugin-import-name-**some_name**.txt`` 형식이어야 합니다. 이 파일이 있으면 다음과 같은 문을 사용하여 ZIP 파일 안에 있는 .py 파일에서 코드를 가져올 수 있습니다::"
136
137 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:71
138 msgid ""
139 "The prefix ``calibre_plugins`` must always be present. ``some_name`` comes "
140 "from the filename of the empty text file. ``some_module`` refers to "
141 ":file:`some_module.py` file inside the ZIP file. Note that this importing is"
142 " just as powerful as regular Python imports. You can create packages and "
143 "subpackages of .py modules inside the ZIP file, just like you would normally"
144 " (by defining __init__.py in each sub-folder), and everything should \"just "
145 "work\"."
146 msgstr "접두사 ``calibre_plugins``는 항상 있어야 합니다. ``some_name``은 빈 텍스트 파일의 파일명에서 옵니다. ``some_module``은 ZIP 파일 안의 :file:`some_module.py` 파일을 가리킵니다. 이 가져오기는 일반 Python 가져오기만큼 강력합니다. ZIP 파일 안에 .py 모듈의 패키지와 하위 패키지를 평소처럼(각 하위 폴더에 __init__.py를 정의하여) 만들 수 있으며, 모든 것이 \"그냥 작동\"해야 합니다."
147
148 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:76
149 msgid ""
150 "The name you use for ``some_name`` enters a global namespace shared by all "
151 "plugins, **so make it as unique as possible**. But remember that it must be "
152 "a valid Python identifier (only alphabets, numbers and the underscore)."
153 msgstr "``some_name``에 사용하는 이름은 모든 플러그인이 공유하는 전역 네임스페이스에 들어갑니다. **따라서 가능한 한 고유하게 만드세요**. 유효한 Python 식별자(알파벳, 숫자, 밑줄만 가능)여야 한다는 점을 기억하세요."
154
155 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:79
156 msgid "**__init__.py**"
157 msgstr "**__init__.py**"
158
159 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:80
160 msgid "As before, the file that defines the plugin class"
161 msgstr "이전과 같이, 플러그인 클래스를 정의하는 파일"
162
163 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:82
164 msgid "**main.py**"
165 msgstr "**main.py**"
166
167 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:83
168 msgid "This file contains the actual code that does something useful"
169 msgstr "이 파일에는 유용한 작업을 수행하는 실제 코드가 포함되어 있습니다"
170
171 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:85
172 msgid "**ui.py**"
173 msgstr "**ui.py**"
174
175 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:86
176 msgid "This file defines the interface part of the plugin"
177 msgstr "이 파일은 플러그인의 인터페이스 부분을 정의합니다"
178
179 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:88
180 msgid "**images/icon.png**"
181 msgstr "**images/icon.png**"
182
183 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:89
184 msgid "The icon for this plugin"
185 msgstr "이 플러그인의 아이콘"
186
187 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:91
188 msgid "**about.txt**"
189 msgstr "**about.txt**"
190
191 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:92
192 msgid "A text file with information about the plugin"
193 msgstr "플러그인에 대한 정보가 포함된 텍스트 파일"
194
195 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:94
196 msgid "**translations**"
197 msgstr "**번역**"
198
199 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:95
200 msgid ""
201 "A folder containing .mo files with the translations of the user interface of"
202 " your plugin into different languages. See below for details."
203 msgstr "플러그인의 사용자 인터페이스를 다양한 언어로 번역한 .mo 파일이 포함된 폴더입니다. 자세한 내용은 아래를 참조하세요."
204
205 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:99
206 msgid "Now let's look at the code."
207 msgstr "이제 코드를 살펴보겠습니다."
208
209 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:102
210 msgid "__init__.py"
211 msgstr "__init__.py"
212
213 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:104
214 msgid "First, the obligatory ``__init__.py`` to define the plugin metadata:"
215 msgstr "먼저, 플러그인 메타데이터를 정의하는 필수 ``__init__.py``입니다:"
216
217 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:109
218 msgid ""
219 "The only noteworthy feature is the field :attr:`actual_plugin`. Since "
220 "calibre has both command line and GUI interfaces, GUI plugins like this one "
221 "should not load any GUI libraries in __init__.py. The actual_plugin field "
222 "does this for you, by telling calibre that the actual plugin is to be found "
223 "in another file inside your ZIP archive, which will only be loaded in a GUI "
224 "context."
225 msgstr "유일하게 주목할 만한 기능은 :attr:`actual_plugin` 필드입니다. calibre에는 명령줄과 GUI 인터페이스가 모두 있으므로, 이와 같은 GUI 플러그인은 __init__.py에서 GUI 라이브러리를 로드하면 안 됩니다. actual_plugin 필드는 실제 플러그인이 ZIP 아카이브 안의 다른 파일에 있으며 GUI 컨텍스트에서만 로드된다는 것을 calibre에 알려줌으로써 이를 대신 처리합니다."
226
227 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:114
228 msgid ""
229 "Remember that for this to work, you must have a plugin-import-name-"
230 "some_name.txt file in your plugin ZIP file, as discussed above."
231 msgstr "이것이 작동하려면 위에서 설명한 것처럼 플러그인 ZIP 파일에 plugin-import-name-some_name.txt 파일이 있어야 합니다."
232
233 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:117
234 msgid ""
235 "Also there are a couple of methods for enabling user configuration of the "
236 "plugin. These are discussed below."
237 msgstr "또한 플러그인의 사용자 구성을 활성화하는 몇 가지 방법이 있습니다. 이러한 내용은 아래에서 설명합니다."
238
239 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:120
240 msgid "ui.py"
241 msgstr "ui.py"
242
243 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:122
244 msgid ""
245 "Now let's look at ui.py which defines the actual GUI plugin. The source code"
246 " is heavily commented and should be self explanatory:"
247 msgstr "이제 실제 GUI 플러그인을 정의하는 ui.py를 살펴보겠습니다. 소스 코드에 주석이 많이 달려 있어 자체적으로 설명이 될 것입니다:"
248
249 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:128
250 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:220
251 msgid "main.py"
252 msgstr "main.py"
253
254 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:130
255 msgid "The actual logic to implement the Interface Plugin Demo dialog."
256 msgstr "인터페이스 플러그인 데모 대화상자를 구현하는 실제 로직입니다."
257
258 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:136
259 msgid "Getting resources from the plugin ZIP file"
260 msgstr "플러그인 ZIP 파일에서 리소스 가져오기"
261
262 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:138
263 msgid ""
264 "calibre's plugin loading system defines a couple of built-in functions that "
265 "allow you to conveniently get files from the plugin ZIP file."
266 msgstr "calibre의 플러그인 로딩 시스템은 플러그인 ZIP 파일에서 파일을 편리하게 가져올 수 있는 몇 가지 내장 함수를 정의합니다."
267
268 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:140
269 msgid "**get_resources(name_or_list_of_names)**"
270 msgstr "**get_resources(name_or_list_of_names)**"
271
272 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:141
273 msgid ""
274 "This function should be called with a list of paths to files inside the ZIP "
275 "file. For example to access the file :file:`icon.png` in the folder images "
276 "in the ZIP file, you would use: ``images/icon.png``. Always use a forward "
277 "slash as the path separator, even on Windows. When you pass in a single "
278 "name, the function will return the raw bytes of that file or None if the "
279 "name was not found in the ZIP file. If you pass in more than one name then "
280 "it returns a dictionary mapping the names to bytes. If a name is not found,"
281 " it will not be present in the returned dictionary."
282 msgstr "이 함수는 ZIP 파일 안의 파일 경로 목록과 함께 호출해야 합니다. 예를 들어 ZIP 파일의 images 폴더에 있는 :file:`icon.png` 파일에 접근하려면 ``images/icon.png``를 사용하세요. Windows에서도 항상 정방향 슬래시를 경로 구분자로 사용하세요. 단일 이름을 전달하면 해당 파일의 원시 바이트를 반환하고, ZIP 파일에서 이름을 찾을 수 없으면 None을 반환합니다. 둘 이상의 이름을 전달하면 이름을 바이트에 매핑하는 딕셔너리를 반환합니다. 이름을 찾을 수 없으면 반환된 딕셔너리에 포함되지 않습니다."
283
284 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:150
285 msgid "**get_icons(name_or_list_of_names, plugin_name='')**"
286 msgstr "**get_icons(name_or_list_of_names, plugin_name='')**"
287
288 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:151
289 msgid ""
290 "A wrapper for get_resources() that creates QIcon objects from the raw bytes "
291 "returned by get_resources. If a name is not found in the ZIP file the "
292 "corresponding QIcon will be null. In order to support icon theme-ing, pass "
293 "in the human friendly name of your plugin as ``plugin_name``. If the user is"
294 " using an icon theme with icons for your plugin, they will be loaded "
295 "preferentially."
296 msgstr "get_resources()의 래퍼로, get_resources가 반환한 원시 바이트에서 QIcon 객체를 생성합니다. ZIP 파일에서 이름을 찾을 수 없으면 해당 QIcon은 null이 됩니다. 아이콘 테마를 지원하려면 플러그인의 사용자 친화적인 이름을 ``plugin_name``으로 전달하세요. 사용자가 플러그인용 아이콘이 포함된 아이콘 테마를 사용 중이면 해당 아이콘이 우선적으로 로드됩니다."
297
298 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:160
299 msgid "Enabling user configuration of your plugin"
300 msgstr "플러그인의 사용자 구성 활성화"
301
302 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:162
303 msgid ""
304 "To allow users to configure your plugin, you must define three methods in "
305 "your base plugin class, **is_customizable**, **config_widget** and "
306 "**save_settings** as shown below:"
307 msgstr "사용자가 플러그인을 구성할 수 있도록 하려면 기본 플러그인 클래스에 **is_customizable**, **config_widget**, **save_settings** 세 가지 메서드를 정의해야 합니다. 아래와 같습니다:"
308
309 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:173
310 msgid ""
311 "calibre has many different ways to store configuration data (a legacy of its"
312 " long history). The recommended way is to use the **JSONConfig** class, "
313 "which stores your configuration information in a .json file."
314 msgstr "calibre에는 구성 데이터를 저장하는 다양한 방법이 있습니다(오랜 역사의 유산). 권장되는 방법은 구성 정보를 .json 파일에 저장하는 **JSONConfig** 클래스를 사용하는 것입니다."
315
316 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:175
317 msgid ""
318 "The code to manage configuration data in the demo plugin is in config.py:"
319 msgstr "데모 플러그인에서 구성 데이터를 관리하는 코드는 config.py에 있습니다:"
320
321 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:180
322 msgid ""
323 "The ``prefs`` object is now available throughout the plugin code by a "
324 "simple::"
325 msgstr "이제 ``prefs`` 객체는 간단한 구문을 통해 플러그인 코드 전체에서 사용할 수 있습니다::"
326
327 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:185
328 msgid "You can see the ``prefs`` object being used in main.py:"
329 msgstr "main.py에서 ``prefs`` 객체가 사용되는 것을 확인할 수 있습니다:"
330
331 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:192
332 msgid "Edit book plugins"
333 msgstr "책 편집 플러그인"
334
335 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:194
336 msgid ""
337 "Now let's change gears for a bit and look at creating a plugin to add tools "
338 "to the calibre book editor. The plugin is available here: "
339 ":download_file:`editor_demo_plugin.zip`."
340 msgstr "이제 방향을 바꾸어 calibre 책 편집기에 도구를 추가하는 플러그인을 만드는 방법을 살펴보겠습니다. 플러그인은 여기서 다운로드할 수 있습니다: :download_file:`editor_demo_plugin.zip`."
341
342 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:198
343 msgid ""
344 "The first step, as for all plugins is to create the import name empty txt "
345 "file, as described :ref:`above <import_name_txt>`. We shall name the file "
346 "``plugin-import-name-editor_plugin_demo.txt``."
347 msgstr "모든 플러그인과 마찬가지로 첫 번째 단계는 :ref:`위 <import_name_txt>`에서 설명한 대로 가져오기 이름 빈 txt 파일을 만드는 것입니다. 파일명은 ``plugin-import-name-editor_plugin_demo.txt``로 하겠습니다."
348
349 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:202
350 msgid ""
351 "Now we create the mandatory ``__init__.py`` file that contains metadata "
352 "about the plugin -- its name, author, version, etc."
353 msgstr "이제 플러그인에 대한 메타데이터(이름, 저자, 버전 등)가 포함된 필수 ``__init__.py`` 파일을 만듭니다."
354
355 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:208
356 msgid ""
357 "A single editor plugin can provide multiple tools each tool corresponds to a"
358 " single button in the toolbar and entry in the :guilabel:`Plugins` menu in "
359 "the editor. These can have sub-menus in case the tool has multiple related "
360 "actions."
361 msgstr "하나의 에디터 플러그인은 여러 도구를 제공할 수 있으며, 각 도구는 툴바의 버튼 하나와 에디터의 `플러그인` 메뉴 항목 하나에 해당합니다. 도구에 여러 관련 작업이 있는 경우 하위 메뉴를 포함할 수 있습니다."
362
363 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:212
364 msgid ""
365 "The tools must all be defined in the file ``main.py`` in your plugin. Every "
366 "tool is a class that inherits from the "
367 ":class:`calibre.gui2.tweak_book.plugin.Tool` class. Let's look at "
368 "``main.py`` from the demo plugin, the source code is heavily commented and "
369 "should be self-explanatory. Read the API documents of the "
370 ":class:`calibre.gui2.tweak_book.plugin.Tool` class for more details."
371 msgstr "모든 도구는 플러그인의 ``main.py`` 파일에 정의되어야 합니다. 모든 도구는 :class:`calibre.gui2.tweak_book.plugin.Tool` 클래스를 상속하는 클래스입니다. 데모 플러그인의 ``main.py``를 살펴보겠습니다. 소스 코드에 주석이 많이 달려 있어 자체적으로 설명이 될 것입니다. 자세한 내용은 :class:`calibre.gui2.tweak_book.plugin.Tool` 클래스의 API 문서를 참조하세요."
372
373 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:222
374 msgid ""
375 "Here we will see the definition of a single tool that will multiply all font"
376 " sizes in the book by a number provided by the user. This tool demonstrates "
377 "various important concepts that you will need in developing your own "
378 "plugins, so you should read the (heavily commented) source code carefully."
379 msgstr "여기에서는 사용자가 제공한 숫자로 책의 모든 글꼴 크기를 곱하는 단일 도구의 정의를 볼 수 있습니다. 이 도구는 직접 플러그인을 개발하는 데 필요한 다양한 중요한 개념을 보여주므로 (주석이 많이 달린) 소스 코드를 주의 깊게 읽어야 합니다."
380
381 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:230
382 msgid ""
383 "Let's break down ``main.py``. We see that it defines a single tool, named "
384 "*Magnify fonts*. This tool will ask the user for a number and multiply all "
385 "font sizes in the book by that number."
386 msgstr "``main.py``를 분석해 보겠습니다. *글꼴 확대*라는 단일 도구를 정의하는 것을 볼 수 있습니다. 이 도구는 사용자에게 숫자를 요청하고 책의 모든 글꼴 크기를 해당 숫자로 곱합니다."
387
388 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:234
389 msgid ""
390 "The first important thing is the tool name which you must set to some "
391 "relatively unique string as it will be used as the key for this tool."
392 msgstr "첫 번째 중요한 것은 도구 이름입니다. 이 도구의 키로 사용되므로 비교적 고유한 문자열로 설정해야 합니다."
393
394 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:237
395 msgid ""
396 "The next important entry point is the "
397 ":meth:`calibre.gui2.tweak_book.plugin.Tool.create_action`. This method "
398 "creates the QAction objects that appear in the plugins toolbar and plugin "
399 "menu. It also, optionally, assigns a keyboard shortcut that the user can "
400 "customize. The triggered signal from the QAction is connected to the "
401 "ask_user() method that asks the user for the font size multiplier, and then "
402 "runs the magnification code."
403 msgstr "다음 중요한 진입점은 :meth:`calibre.gui2.tweak_book.plugin.Tool.create_action`입니다. 이 메서드는 플러그인 도구 모음과 플러그인 메뉴에 나타나는 QAction 객체를 생성합니다. 또한 선택적으로 사용자가 맞춤 설정할 수 있는 키보드 단축키를 할당합니다. QAction의 triggered 시그널은 사용자에게 글꼴 크기 배수를 요청한 다음 확대 코드를 실행하는 ask_user() 메서드에 연결됩니다."
404
405 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:245
406 msgid ""
407 "The magnification code is well commented and fairly simple. The main things "
408 "to note are that you get a reference to the editor window as ``self.gui`` "
409 "and the editor *Boss* as ``self.boss``. The *Boss* is the object that "
410 "controls the editor user interface. It has many useful methods, that are "
411 "documented in the :class:`calibre.gui2.tweak_book.boss.Boss` class."
412 msgstr "확대 코드는 주석이 잘 달려 있고 꽤 간단합니다. 주목할 점은 편집기 창의 참조를 ``self.gui``로, 편집기 *Boss*를 ``self.boss``로 얻는 것입니다. *Boss*는 편집기 사용자 인터페이스를 제어하는 객체입니다. :class:`calibre.gui2.tweak_book.boss.Boss` 클래스에 문서화된 많은 유용한 메서드를 가지고 있습니다."
413
414 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:251
415 msgid ""
416 "Finally, there is ``self.current_container`` which is a reference to the "
417 "book being edited as a "
418 ":class:`calibre.ebooks.oeb.polish.container.Container` object. This "
419 "represents the book as a collection of its constituent HTML/CSS/image files "
420 "and has convenience methods for doing many useful things. The container "
421 "object and various useful utility functions that can be reused in your "
422 "plugin code are documented in :ref:`polish_api`."
423 msgstr "마지막으로, 편집 중인 책에 대한 참조인 ``self.current_container``가 있습니다. :class:`calibre.ebooks.oeb.polish.container.Container` 객체입니다. 이것은 책을 구성하는 HTML/CSS/이미지 파일의 모음으로 표현하며, 많은 유용한 작업을 수행하는 편의 메서드를 가지고 있습니다. 컨테이너 객체와 플러그인 코드에서 재사용할 수 있는 다양한 유용한 유틸리티 함수는 :ref:`polish_api`에 문서화되어 있습니다."
424
425 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:259
426 msgid "Adding translations to your plugin"
427 msgstr "플러그인에 번역 추가"
428
429 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:261
430 msgid ""
431 "You can have all the user interface strings in your plugin translated and "
432 "displayed in whatever language is set for the main calibre user interface."
433 msgstr "플러그인의 모든 사용자 인터페이스 문자열을 Calibre 메인 사용자 인터페이스에 설정된 언어로 번역하여 표시할 수 있습니다."
434
435 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:264
436 msgid ""
437 "The first step is to go through your plugin's source code and mark all user "
438 "visible strings as translatable, by surrounding them in _(). For example::"
439 msgstr "첫 번째 단계는 플러그인의 소스 코드를 살펴보고 사용자에게 보이는 모든 문자열을 _()로 감싸 번역 가능하도록 표시하는 것입니다. 예::"
440
441 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:269
442 msgid ""
443 "Then use some program to generate .po files from your plugin source code. "
444 "There should be one .po file for every language you want to translate into. "
445 "For example: de.po for German, fr.po for French and so on. You can use the "
446 "`Poedit <https://poedit.net/>`_ program for this."
447 msgstr "그런 다음 프로그램을 사용하여 플러그인 소스 코드에서 .po 파일을 생성하세요. 번역하려는 각 언어마다 하나의 .po 파일이 있어야 합니다. 예: 독일어의 경우 de.po, 프랑스어의 경우 fr.po 등. 이를 위해 `Poedit <https://poedit.net/>`_ 프로그램을 사용할 수 있습니다."
448
449 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:274
450 msgid ""
451 "Send these .po files to your translators. Once you get them back, compile "
452 "them into .mo files. You can again use Poedit for that, or just do::"
453 msgstr "이 .po 파일을 번역자에게 보내세요. 번역이 완료되면 .mo 파일로 컴파일하세요. Poedit를 다시 사용하거나 다음을 실행하세요::"
454
455 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:279
456 msgid "Put the .mo files into the ``translations`` folder in your plugin."
457 msgstr ".mo 파일을 플러그인의 ``translations`` 폴더에 넣으세요."
458
459 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:281
460 msgid ""
461 "The last step is to simply call the function `load_translations()` at the "
462 "top of your plugin's .py files. For performance reasons you should only call"
463 " this function in those .py files that actually have translatable strings. "
464 "So in a typical User Interface plugin you would call it at the top of "
465 "``ui.py`` but not ``__init__.py``."
466 msgstr "마지막 단계는 플러그인의 .py 파일 상단에서 `load_translations()` 함수를 호출하는 것입니다. 성능상의 이유로 실제로 번역 가능한 문자열이 있는 .py 파일에서만 이 함수를 호출해야 합니다. 따라서 일반적인 사용자 인터페이스 플러그인에서는 ``ui.py`` 상단에서 호출하되 ``__init__.py``에서는 호출하지 않습니다."
467
468 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:287
469 msgid ""
470 "You can test the translations of your plugins by changing the user interface"
471 " language in calibre under :guilabel:`Preferences->Interface->Look & feel` "
472 "or by running calibre with the ``CALIBRE_OVERRIDE_LANG`` environment "
473 "variable set. For example::"
474 msgstr "calibre의 :guilabel:`환경설정->인터페이스->모양과 느낌`에서 사용자 인터페이스 언어를 변경하거나 ``CALIBRE_OVERRIDE_LANG`` 환경 변수를 설정하여 calibre를 실행하여 플러그인의 번역을 테스트할 수 있습니다. 예::"
475
476 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:293
477 msgid ""
478 "Replace ``de`` with the language code of the language you want to test."
479 msgstr "``de``를 테스트하려는 언어의 언어 코드로 바꾸세요."
480
481 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:295
482 msgid ""
483 "For translations with plurals, use the ``ngettext()`` function instead of "
484 "``_()``. For example::"
485 msgstr "복수형이 있는 번역의 경우 ``_()`` 대신 ``ngettext()`` 함수를 사용하세요. 예::"
486
487 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:301
488 msgid "The plugin API"
489 msgstr "플러그인 API"
490
491 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:303
492 msgid ""
493 "As you may have noticed above, a plugin in calibre is a class. There are "
494 "different classes for the different types of plugins in calibre. Details on "
495 "each class, including the base class of all plugins can be found in "
496 ":ref:`plugins`."
497 msgstr "위에서 눈치채셨겠지만, calibre의 플러그인은 클래스입니다. calibre에는 다양한 유형의 플러그인에 대한 서로 다른 클래스가 있습니다. 모든 플러그인의 기본 클래스를 포함한 각 클래스에 대한 세부 정보는 :ref:`plugins`에서 확인할 수 있습니다."
498
499 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:306
500 msgid ""
501 "Your plugin is almost certainly going to use code from calibre. To learn how"
502 " to find various bits of functionality in the calibre code base, read the "
503 "section on the calibre :ref:`code_layout`."
504 msgstr "플러그인은 거의 확실히 calibre의 코드를 사용하게 됩니다. calibre 코드베이스에서 다양한 기능을 찾는 방법을 알아보려면 calibre :ref:`code_layout` 섹션을 읽어보세요."
505
506 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:311
507 msgid "Debugging plugins"
508 msgstr "플러그인 디버깅"
509
510 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:313
511 msgid ""
512 "The first, most important step is to run calibre in debug mode. You can do "
513 "this from the command line with::"
514 msgstr "첫 번째이자 가장 중요한 단계는 디버그 모드에서 calibre를 실행하는 것입니다. 명령줄에서 다음을 실행할 수 있습니다::"
515
516 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:317
517 msgid ""
518 "Or from within calibre by right-clicking the :guilabel:`Preferences` button "
519 "or using the :kbd:`Ctrl+Shift+R` keyboard shortcut."
520 msgstr "You can have all the user interface strings in your plugin translated and displayed in whatever language is set for the main calibre user interface."
521
522 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:319
523 msgid ""
524 "When running from the command line, debug output will be printed to the "
525 "console, when running from within calibre the output will go to a txt file."
526 msgstr "명령줄에서 실행할 경우 디버그 출력은 콘솔에 표시되고, Calibre 내에서 실행할 경우 출력은 텍스트 파일에 저장됩니다."
527
528 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:321
529 msgid ""
530 "You can insert print statements anywhere in your plugin code, they will be "
531 "output in debug mode. Remember, this is Python, you really shouldn't need "
532 "anything more than print statements to debug ;) I developed all of calibre "
533 "using just this debugging technique."
534 msgstr "플러그인 코드 어디에나 print 문을 삽입할 수 있으며, 디버그 모드에서 출력됩니다. 기억하세요, 이것은 Python이므로 디버깅에 print 문 이상의 것이 필요하지 않습니다 ;) 저는 이 디버깅 기법만으로 calibre 전체를 개발했습니다."
535
536 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:323
537 msgid ""
538 "You can quickly test changes to your plugin by using the following command "
539 "line::"
540 msgstr "다음 명령줄을 사용하면 플러그인 변경 사항을 빠르게 테스트할 수 있습니다::"
541
542 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:328
543 msgid ""
544 "This will shutdown a running calibre, wait for the shutdown to complete, "
545 "then update your plugin in calibre and relaunch calibre."
546 msgstr "실행 중인 calibre를 종료하고, 종료가 완료될 때까지 기다린 다음, calibre에서 플러그인을 업데이트하고 calibre를 다시 시작합니다."
547
548 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:331
549 msgid "More plugin examples"
550 msgstr "더 많은 플러그인 예시"
551
552 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:333
553 msgid ""
554 "You can find a list of many sophisticated calibre plugins `here "
555 "<https://www.mobileread.com/forums/showthread.php?t=118764>`_."
556 msgstr "많은 정교한 calibre 플러그인 목록은 `여기 <https://www.mobileread.com/forums/showthread.php?t=118764>`_에서 확인할 수 있습니다."
557
558 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:336
559 msgid "Sharing your plugins with others"
560 msgstr "다른 사람과 플러그인 공유"
561
562 #: ../../../__w/calibre/calibre/manual/creating_plugins.rst:338
563 msgid ""
564 "If you would like to share the plugins you have created with other users of "
565 "calibre, post your plugin in a new thread in the `calibre plugins forum "
566 "<https://www.mobileread.com/forums/forumdisplay.php?f=237>`_."
567 msgstr "만든 플러그인을 calibre의 다른 사용자와 공유하고 싶다면 `calibre 플러그인 포럼 <https://www.mobileread.com/forums/forumdisplay.php?f=237>`_에 새 스레드로 플러그인을 게시하세요."