Debian Codegraph @

translations/manual/ko/develop.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
7 # Junghee Lee <[email protected]>, 2021-2022
8 # Junghee Lee <[email protected]>, 2022
9 msgid ""
10 msgstr ""
11 "Project-Id-Version: calibre\n"
12 "Report-Msgid-Bugs-To: \n"
13 "POT-Creation-Date: 2026-04-29 04:37+0000\n"
14 "PO-Revision-Date: 2014-06-17 08:34+0000\n"
15 "Last-Translator: Junghee Lee <[email protected]>, 2022\n"
16 "Language-Team: Korean (http://app.transifex.com/calibre/calibre/language/ko/)\n"
17 "MIME-Version: 1.0\n"
18 "Content-Type: text/plain; charset=UTF-8\n"
19 "Content-Transfer-Encoding: 8bit\n"
20 "Language: ko\n"
21 "Plural-Forms: nplurals=1; plural=0;\n"
22
23 #: ../../../__w/calibre/calibre/manual/develop.rst:4
24 msgid "Setting up a calibre development environment"
25 msgstr "캘리버 개발 환경 설정"
26
27 #: ../../../__w/calibre/calibre/manual/develop.rst:6
28 msgid ""
29 "calibre is completely open source, licensed under the `GNU GPL v3 "
30 "<https://www.gnu.org/licenses/gpl.html>`_. This means that you are free to "
31 "download and modify the program to your heart's content. In this section, "
32 "you will learn how to get a calibre development environment set up on the "
33 "operating system of your choice. calibre is written primarily in `Python "
34 "<https://www.python.org>`_ with some C/C++ code for speed and system "
35 "interfacing. Note that calibre requires at least Python 3.8."
36 msgstr "캘리버는 `GNU GPL v3 <https://www.gnu.org/licenses/gpl.html>`_에 따라 완전히 오픈 소스로 라이선스되어 있습니다. 이는 프로그램을 자유롭게 다운로드하고 원하는 대로 수정할 수 있다는 의미입니다. 이 섹션에서는 선택한 운영 체제에 캘리버 개발 환경을 설정하는 방법을 배웁니다. 캘리버는 주로 `Python <https://www.python.org>`_으로 작성되었으며, 속도와 시스템 인터페이스를 위해 일부 C/C++ 코드가 포함되어 있습니다. 캘리버에는 최소 Python 3.8이 필요합니다."
37
38 #: ../../../__w/calibre/calibre/manual/develop.rst:14
39 msgid "Contents"
40 msgstr "목차"
41
42 #: ../../../__w/calibre/calibre/manual/develop.rst:17
43 msgid "Design philosophy"
44 msgstr "설계 철학"
45
46 #: ../../../__w/calibre/calibre/manual/develop.rst:19
47 msgid ""
48 "calibre has its roots in the Unix world, which means that its design is "
49 "highly modular. The modules interact with each other via well defined "
50 "interfaces. This makes adding new features and fixing bugs in calibre very "
51 "easy, resulting in a frenetic pace of development. Because of its roots, "
52 "calibre has a comprehensive command line interface for all its functions, "
53 "documented in :doc:`generated/en/cli-index`."
54 msgstr "캘리버는 Unix 세계에 뿌리를 두고 있어 설계가 매우 모듈화되어 있습니다. 모듈들은 잘 정의된 인터페이스를 통해 서로 상호작용합니다. 이로 인해 캘리버에 새로운 기능을 추가하고 버그를 수정하기가 매우 쉬워 빠른 개발 속도를 유지할 수 있습니다. 이러한 뿌리 덕분에 캘리버는 모든 기능에 대한 포괄적인 명령줄 인터페이스를 갖추고 있으며, 이는 :doc:`generated/ko/cli-index`에 문서화되어 있습니다."
55
56 #: ../../../__w/calibre/calibre/manual/develop.rst:24
57 msgid ""
58 "The modular design of calibre is expressed via ``Plugins``. There is a "
59 ":ref:`tutorial <customize>` on writing calibre plugins. For example, adding "
60 "support for a new device to calibre typically involves writing fewer than "
61 "100 lines of code in the form of a device driver plugin. You can browse the "
62 "`built-in drivers "
63 "<https://github.com/kovidgoyal/calibre/tree/master/src/calibre/devices>`_. "
64 "Similarly, adding support for new conversion formats involves writing "
65 "input/output format plugins. Another example of the modular design is the "
66 ":ref:`recipe system <news>` for fetching news. For more examples of plugins "
67 "designed to add features to calibre, see the `Index of plugins "
68 "<https://www.mobileread.com/forums/showthread.php?p=1362767#post1362767>`_."
69 msgstr "캘리버의 모듈식 설계는 ``플러그인``을 통해 표현됩니다. 캘리버 플러그인 작성에 대한 :ref:`튜토리얼 <customize>`이 있습니다. 예를 들어, 캘리버에 새로운 장치 지원을 추가하는 것은 일반적으로 장치 드라이버 플러그인 형태로 100줄 미만의 코드를 작성하는 것과 관련됩니다. `내장 드라이버 <https://github.com/kovidgoyal/calibre/tree/master/src/calibre/devices>`_를 둘러볼 수 있습니다. 마찬가지로, 새로운 변환 형식 지원을 추가하는 것은 입출력 형식 플러그인을 작성하는 것을 포함합니다. 모듈식 설계의 또 다른 예는 뉴스를 가져오기 위한 :ref:`레시피 시스템 <news>`입니다. 캘리버에 기능을 추가하기 위해 설계된 플러그인의 더 많은 예는 `플러그인 색인 <https://www.mobileread.com/forums/showthread.php?p=1362767#post1362767>`_을 참조하십시오."
70
71 #: ../../../__w/calibre/calibre/manual/develop.rst:34
72 msgid "Code layout"
73 msgstr "코드 구성"
74
75 #: ../../../__w/calibre/calibre/manual/develop.rst:36
76 msgid ""
77 "All the calibre Python code is in the ``calibre`` package. This package "
78 "contains the following main sub-packages"
79 msgstr "모든 캘리버 Python 코드는 ``calibre`` 패키지에 있습니다. 이 패키지는 다음과 같은 주요 하위 패키지를 포함합니다"
80
81 #: ../../../__w/calibre/calibre/manual/develop.rst:38
82 msgid ""
83 "devices - All the device drivers. Just look through some of the built-in "
84 "drivers to get an idea for how they work."
85 msgstr "devices - 모든 장치 드라이버. 일부 내장 드라이버를 살펴보면 작동 방식을 이해할 수 있습니다."
86
87 #: ../../../__w/calibre/calibre/manual/develop.rst:40
88 msgid ""
89 "For details, see: ``devices.interface`` which defines the interface "
90 "supported by device drivers and ``devices.usbms`` which defines a generic "
91 "driver that connects to a USBMS device. All USBMS based drivers in calibre "
92 "inherit from it."
93 msgstr "자세한 내용은: 장치 드라이버가 지원하는 인터페이스를 정의하는 ``devices.interface``와 USBMS 장치에 연결하는 일반 드라이버를 정의하는 ``devices.usbms``를 참조하십시오. 캘리버의 모든 USBMS 기반 드라이버는 이것을 상속합니다."
94
95 #: ../../../__w/calibre/calibre/manual/develop.rst:43
96 msgid ""
97 "e-books - All the e-book conversion/metadata code. A good starting point is"
98 " ``calibre.ebooks.conversion.cli`` which is the module powering the "
99 ":command:`ebook-convert` command. The conversion process is controlled via "
100 "``conversion.plumber``. The format independent code is all in ``ebooks.oeb``"
101 " and the format dependent code is in ``ebooks.format_name``."
102 msgstr "e-books - 모든 전자책 변환/메타데이터 코드. 좋은 출발점은 :command:`ebook-convert` 명령을 구동하는 모듈인 ``calibre.ebooks.conversion.cli``입니다. 변환 과정은 ``conversion.plumber``를 통해 제어됩니다. 형식 독립적 코드는 모두 ``ebooks.oeb``에 있고, 형식 종속적 코드는 ``ebooks.format_name``에 있습니다."
103
104 #: ../../../__w/calibre/calibre/manual/develop.rst:47
105 msgid ""
106 "Metadata reading, writing, and downloading is all in ``ebooks.metadata``"
107 msgstr "메타데이터 읽기, 쓰기, 다운로드는 모두 ``ebooks.metadata``에 있습니다"
108
109 #: ../../../__w/calibre/calibre/manual/develop.rst:48
110 msgid ""
111 "Conversion happens in a pipeline, for the structure of the pipeline, see "
112 ":ref:`conversion-introduction`. The pipeline consists of an input plugin, "
113 "various transforms and an output plugin. The code that constructs and drives"
114 " the pipeline is in :file:`plumber.py`. The pipeline works on a "
115 "representation of an e-book that is like an unzipped epub, with manifest, "
116 "spine, toc, guide, html content, etc. The class that manages this "
117 "representation is OEBBook in ``ebooks.oeb.base``. The various "
118 "transformations that are applied to the book during conversions live in "
119 ":file:`oeb/transforms/*.py`. And the input and output plugins live in "
120 ":file:`conversion/plugins/*.py`."
121 msgstr "변환은 파이프라인에서 이루어지며, 파이프라인의 구조는 :ref:`conversion-introduction`을 참조하십시오. 파이프라인은 입력 플러그인, 다양한 변환, 출력 플러그인으로 구성됩니다. 파이프라인을 구성하고 구동하는 코드는 :file:`plumber.py`에 있습니다. 파이프라인은 압축 해제된 epub과 类似的 전자책 표현에서 작동하며, 매니페스트, 스파인, 목차, 가이드, html 콘텐츠 등이 포함됩니다. 이 표현을 관리하는 클래스는 ``ebooks.oeb.base``의 OEBBook입니다. 변환 중 책에 적용되는 다양한 변환은 :file:`oeb/transforms/*.py`에 있습니다. 그리고 입력 및 출력 플러그인은 :file:`conversion/plugins/*.py`에 있습니다."
122
123 #: ../../../__w/calibre/calibre/manual/develop.rst:58
124 msgid ""
125 "E-book editing happens using a different container object. It is documented "
126 "in :ref:`polish_api`."
127 msgstr "전자책 편집은 다른 컨테이너 객체를 사용하여 이루어집니다. 이는 :ref:`polish_api`에 문서화되어 있습니다."
128
129 #: ../../../__w/calibre/calibre/manual/develop.rst:61
130 msgid ""
131 "db - The database back-end. See :ref:`db_api` for the interface to the "
132 "calibre library."
133 msgstr "db - 데이터베이스 백엔드. 캘리버 라이브러리에 대한 인터페이스는 :ref:`db_api`를 참조하십시오."
134
135 #: ../../../__w/calibre/calibre/manual/develop.rst:63
136 msgid "Content server: ``srv`` is the calibre Content server."
137 msgstr "콘텐츠 서버: ``srv``는 캘리버 콘텐츠 서버입니다."
138
139 #: ../../../__w/calibre/calibre/manual/develop.rst:65
140 msgid ""
141 "gui2 - The Graphical User Interface. GUI initialization happens in "
142 "``gui2.main`` and ``gui2.ui``. The e-book-viewer is in ``gui2.viewer``. The "
143 "e-book editor is in ``gui2.tweak_book``."
144 msgstr "gui2 - 그래픽 사용자 인터페이스. GUI 초기화는 ``gui2.main``과 ``gui2.ui``에서 이루어집니다. 전자책 뷰어는 ``gui2.viewer``에 있습니다. 전자책 편집기는 ``gui2.tweak_book``에 있습니다."
145
146 #: ../../../__w/calibre/calibre/manual/develop.rst:67
147 msgid ""
148 "If you want to locate the entry points for all the various calibre "
149 "executables, look at the ``entry_points`` structure in `linux.py "
150 "<https://github.com/kovidgoyal/calibre/blob/master/src/calibre/linux.py>`_."
151 msgstr "모든 다양한 캘리버 실행 파일의 진입점을 찾으려면 `linux.py <https://github.com/kovidgoyal/calibre/blob/master/src/calibre/linux.py>`_에서 ``entry_points`` 구조를 확인하십시오."
152
153 #: ../../../__w/calibre/calibre/manual/develop.rst:71
154 msgid ""
155 "If you need help understanding the code, post in the `development forum "
156 "<https://www.mobileread.com/forums/forumdisplay.php?f=240>`_ and you will "
157 "most likely get help from one of calibre's many developers."
158 msgstr "코드 이해에 도움이 필요하다면 `개발 포럼 <https://www.mobileread.com/forums/forumdisplay.php?f=240>`_에 게시하면 캘리버의 많은 개발자 중 한 명에게 도움을 받을 수 있을 것입니다."
159
160 #: ../../../__w/calibre/calibre/manual/develop.rst:75
161 msgid "Getting the code"
162 msgstr "코드 가져오기"
163
164 #: ../../../__w/calibre/calibre/manual/develop.rst:77
165 msgid ""
166 "You can get the calibre source code in two ways, using a version control "
167 "system or directly downloading a :website_base:`tarball <dist/src>`."
168 msgstr "캘리버 소스 코드를 두 가지 방법으로 얻을 수 있습니다: 버전 제어 시스템을 사용하거나 :website_base:`tarball <dist/src>`을 직접 다운로드하는 것입니다."
169
170 #: ../../../__w/calibre/calibre/manual/develop.rst:80
171 msgid ""
172 "calibre uses `Git <https://www.git-scm.com/>`_, a distributed version "
173 "control system. Git is available on all the platforms calibre supports. "
174 "After installing Git, you can get the calibre source code with the command::"
175 msgstr "캘리버는 분산 버전 제어 시스템인 `Git <https://www.git-scm.com/>`_을 사용합니다. Git은 캘리버가 지원하는 모든 플랫폼에서 사용할 수 있습니다. Git을 설치한 후 다음 명령으로 캘리버 소스 코드를 얻을 수 있습니다::"
176
177 #: ../../../__w/calibre/calibre/manual/develop.rst:86
178 msgid ""
179 "On Windows you will need the complete path name, that will be something like"
180 " :file:`C:\\\\Program Files\\\\Git\\\\git.exe`."
181 msgstr "Windows에서는 전체 경로 이름이 필요하며, :file:`C:\\\\Program Files\\\\Git\\\\git.exe`와 같은 형태가 됩니다."
182
183 #: ../../../__w/calibre/calibre/manual/develop.rst:88
184 msgid ""
185 "calibre is a very large project with a very long source control history, so "
186 "the above can take a while (10 mins to an hour depending on your internet "
187 "speed)."
188 msgstr "캘리버는 매우 긴 소스 제어 기록을 가진 매우 큰 프로젝트이므로, 위 명령은 시간이 걸릴 수 있습니다 (인터넷 속도에 따라 10분에서 1시간)."
189
190 #: ../../../__w/calibre/calibre/manual/develop.rst:91
191 msgid ""
192 "If you want to get the code faster, the source code for the latest release "
193 "is always available as an :website_base:`archive <dist/src>`."
194 msgstr "코드를 더 빠르게 얻고 싶다면, 최신 릴리스의 소스 코드는 항상 :website_base:`아카이브 <dist/src>`로 사용할 수 있습니다."
195
196 #: ../../../__w/calibre/calibre/manual/develop.rst:94
197 msgid "To update a branch to the latest code, use the command::"
198 msgstr "브랜치를 최신 코드로 업데이트하려면 다음 명령을 사용하십시오::"
199
200 #: ../../../__w/calibre/calibre/manual/develop.rst:98
201 msgid ""
202 "You can also browse the code at `GitHub "
203 "<https://github.com/kovidgoyal/calibre>`_."
204 msgstr "`GitHub <https://github.com/kovidgoyal/calibre>`_에서도 코드를 둘러볼 수 있습니다."
205
206 #: ../../../__w/calibre/calibre/manual/develop.rst:101
207 msgid "Submitting your changes to be included"
208 msgstr "변경 사항 제출하여 포함시키기"
209
210 #: ../../../__w/calibre/calibre/manual/develop.rst:103
211 msgid ""
212 "If you only plan to make a few small changes, you can make your changes and "
213 "create a \"merge directive\" which you can then attach to a ticket in the "
214 "calibre `bug tracker <https://bugs.launchpad.net/calibre>`_. To do this, "
215 "make your changes, then run::"
216 msgstr "작은 변경 사항만 만들 계획이라면, 변경 사항을 만들고 \"병합 지시문\"을 생성한 후 캘리버 `버그 트래커 <https://bugs.launchpad.net/calibre>`_의 티켓에 첨부할 수 있습니다. 이렇게 하려면 변경 사항을 만든 후 다음을 실행하십시오::"
217
218 #: ../../../__w/calibre/calibre/manual/develop.rst:111
219 msgid ""
220 "This will create a :file:`my-changes` file in the current folder, simply "
221 "attach that to a ticket on the calibre `bug tracker "
222 "<https://bugs.launchpad.net/calibre>`_. Note that this will include *all* "
223 "the commits you have made. If you only want to send some commits, you have "
224 "to change ``origin/master`` above. To send only the last commit, use::"
225 msgstr "이렇게 하면 현재 폴더에 :file:`my-changes` 파일이 생성되며, 캘리버 `버그 트래커 <https://bugs.launchpad.net/calibre>`_의 티켓에 첨부하기만 하면 됩니다. 여기에는 수행한 *모든* 커밋이 포함됩니다. 일부 커밋만 보내려면 위의 ``origin/master``를 변경해야 합니다. 마지막 커밋만 보내려면 다음을 사용하십시오::"
226
227 #: ../../../__w/calibre/calibre/manual/develop.rst:119
228 msgid ""
229 "To send the last *n* commits, replace *1* with *n*, for example, for the "
230 "last 3 commits::"
231 msgstr "마지막 *n*개의 커밋을 보내려면 *1*을 *n*으로 바꾸십시오. 예를 들어, 마지막 3개 커밋의 경우::"
232
233 #: ../../../__w/calibre/calibre/manual/develop.rst:124
234 msgid "Be careful to not include merges when using ``HEAD~n``."
235 msgstr "``HEAD~n``을 사용할 때 병합을 포함하지 않도록 주의하십시오."
236
237 #: ../../../__w/calibre/calibre/manual/develop.rst:126
238 msgid ""
239 "If you plan to do a lot of development on calibre, then the best method is "
240 "to create a `GitHub <https://github.com>`__ account. Below is a basic guide "
241 "to setting up your own fork of calibre in a way that will allow you to "
242 "submit pull requests for inclusion into the main calibre repository:"
243 msgstr "캘리버에 많은 개발을 할 계획이라면 `GitHub <https://github.com>`__ 계정을 만드는 것이 가장 좋은 방법입니다. 아래는 기본 캘리버 저장소에 포함되도록 풀 요청을 제출할 수 있는 방식으로 캘리버의 자체 포크를 설정하는 기본 안내입니다:"
244
245 #: ../../../__w/calibre/calibre/manual/develop.rst:131
246 msgid ""
247 "Setup git on your machine as described in this article: `Setup Git "
248 "<https://help.github.com/articles/set-up-git>`_"
249 msgstr "이 문서의 설명에 따라 컴퓨터에서 git 설정: `Git 설정 <https://help.github.com/articles/set-up-git>`_"
250
251 #: ../../../__w/calibre/calibre/manual/develop.rst:132
252 msgid ""
253 "Setup ssh keys for authentication to GitHub, as described here: `Generating "
254 "SSH keys <https://help.github.com/articles/generating-ssh-keys>`_"
255 msgstr "여기에 설명된 대로 GitHub 인증을 위한 ssh 키 설정: `SSH 키 생성 <https://help.github.com/articles/generating-ssh-keys>`_"
256
257 #: ../../../__w/calibre/calibre/manual/develop.rst:133
258 msgid ""
259 "Go to https://github.com/kovidgoyal/calibre and click the :guilabel:`Fork` "
260 "button."
261 msgstr "https://github.com/kovidgoyal/calibre로 이동하여 :guilabel:`포크` 버튼을 클릭하십시오."
262
263 #: ../../../__w/calibre/calibre/manual/develop.rst:134
264 msgid "In a Terminal do::"
265 msgstr "터미널에서 다음을 수행::"
266
267 #: ../../../__w/calibre/calibre/manual/develop.rst:139
268 msgid ""
269 "Replace <username> above with your GitHub username. That will get your fork "
270 "checked out locally."
271 msgstr "위의 <username>을 GitHub 사용자 이름으로 바꾸십시오. 이렇게 하면 포크가 로컬에 체크아웃됩니다."
272
273 #: ../../../__w/calibre/calibre/manual/develop.rst:140
274 msgid ""
275 "You can make changes and commit them whenever you like. When you are ready "
276 "to have your work merged, do a::"
277 msgstr "원할 때마다 변경하고 커밋할 수 있습니다. 작업을 병합할 준비가 되면 다음을 수행합니다::"
278
279 #: ../../../__w/calibre/calibre/manual/develop.rst:144
280 msgid ""
281 "and go to ``https://github.com/<username>/calibre`` and click the "
282 ":guilabel:`Pull Request` button to generate a pull request that can be "
283 "merged."
284 msgstr "그리고 ``https://github.com/<username>/calibre``로 이동하여 :guilabel:`풀 요청` 버튼을 클릭하면 병합 가능한 풀 요청이 생성됩니다."
285
286 #: ../../../__w/calibre/calibre/manual/develop.rst:145
287 msgid ""
288 "You can update your local copy with code from the main repo at any time by "
289 "doing::"
290 msgstr "다음을 수행하여 언제든지 기본 저장소의 코드로 로컬 복사본을 업데이트할 수 있습니다::"
291
292 #: ../../../__w/calibre/calibre/manual/develop.rst:150
293 msgid ""
294 "You should also keep an eye on the calibre `development forum "
295 "<https://www.mobileread.com/forums/forumdisplay.php?f=240>`_. Before making "
296 "major changes, you should discuss them in the forum or contact Kovid "
297 "directly (his email address is all over the source code)."
298 msgstr "캘리버 `개발 포럼 <https://www.mobileread.com/forums/forumdisplay.php?f=240>`_도 주시해야 합니다. 주요 변경을 하기 전에 포럼에서 논의하거나 Kovid에게 직접 연락해야 합니다 (그의 이메일 주소는 소스 코드 전체에 있습니다)."
299
300 #: ../../../__w/calibre/calibre/manual/develop.rst:156
301 msgid "Windows development environment"
302 msgstr "Windows 개발 환경"
303
304 #: ../../../__w/calibre/calibre/manual/develop.rst:158
305 #: ../../../__w/calibre/calibre/manual/develop.rst:192
306 #: ../../../__w/calibre/calibre/manual/develop.rst:229
307 msgid ""
308 "You must also get the calibre source code separately as described above."
309 msgstr "위에서 설명한 대로 캘리버 소스 코드도 별도로 가져와야 합니다."
310
311 #: ../../../__w/calibre/calibre/manual/develop.rst:160
312 msgid ""
313 "Install calibre normally, using the `Windows installer <https://calibre-"
314 "ebook.com/download_windows>`__. Then open a Command Prompt and change to the"
315 " previously checked out calibre code folder. For example::"
316 msgstr "`Windows 설치 프로그램 <https://calibre-ebook.com/download_windows>`__을 사용하여 캘리버를 정상적으로 설치하십시오. 그런 다음 명령 프롬프트를 열고 이전에 체크아웃한 캘리버 코드 폴더로 이동하십시오. 예를 들어::"
317
318 #: ../../../__w/calibre/calibre/manual/develop.rst:165
319 #: ../../../__w/calibre/calibre/manual/develop.rst:241
320 msgid "calibre is the folder that contains the src and resources sub-folders."
321 msgstr "calibre는 src 및 resources 하위 폴더를 포함하는 폴더입니다."
322
323 #: ../../../__w/calibre/calibre/manual/develop.rst:167
324 msgid ""
325 "The next step is to set the environment variable ``CALIBRE_DEVELOP_FROM`` to"
326 " the absolute path of the src folder. So, following the example above, it "
327 "would be ``C:\\Users\\kovid\\work\\calibre\\src``. `Here is a short guide "
328 "<https://docs.python.org/using/windows.html#excursus-setting-environment-"
329 "variables>`_ to setting environment variables on Windows."
330 msgstr "다음 단계는 환경 변수 ``CALIBRE_DEVELOP_FROM``을 src 폴더의 절대 경로로 설정하는 것입니다. 따라서 위 예시를 따르면 ``C:\\Users\\kovid\\work\\calibre\\src``가 됩니다. Windows에서 환경 변수를 설정하는 방법에 대한 `간단한 안내 <https://docs.python.org/using/windows.html#excursus-setting-environment-variables>`_가 있습니다."
331
332 #: ../../../__w/calibre/calibre/manual/develop.rst:172
333 msgid ""
334 "Once you have set the environment variable, open a new command prompt and "
335 "check that it was correctly set by using the command::"
336 msgstr "환경 변수를 설정한 후 새 명령 프롬프트를 열고 다음 명령을 사용하여 올바르게 설정되었는지 확인하십시오::"
337
338 #: ../../../__w/calibre/calibre/manual/develop.rst:177
339 #: ../../../__w/calibre/calibre/manual/develop.rst:260
340 msgid ""
341 "Setting this environment variable means that calibre will now load all its "
342 "Python code from the specified location."
343 msgstr "이 환경 변수를 설정하면 캘리버가 이제 지정된 위치에서 모든 Python 코드를 불러옵니다."
344
345 #: ../../../__w/calibre/calibre/manual/develop.rst:179
346 msgid ""
347 "That's it! You are now ready to start hacking on the calibre code. For "
348 "example, open the file :file:`src\\\\calibre\\\\__init__.py` in your "
349 "favorite editor and add the line::"
350 msgstr "이제 됐습니다! 이제 캘리버 코드 수정을 시작할 준비가 되었습니다. 예를 들어, 즐겨 사용하는 편집기에서 :file:`src\\\\calibre\\\\__init__.py` 파일을 열고 다음 줄을 추가하십시오::"
351
352 #: ../../../__w/calibre/calibre/manual/develop.rst:184
353 #: ../../../__w/calibre/calibre/manual/develop.rst:267
354 msgid ""
355 "near the top of the file. Now run the command :command:`calibredb`. The very"
356 " first line of output should be ``Hello, world!``."
357 msgstr "파일 상단 근처에. 이제 :command:`calibredb` 명령을 실행하십시오. 출력의 첫 번째 줄이 ``Hello, world!``여야 합니다."
358
359 #: ../../../__w/calibre/calibre/manual/develop.rst:186
360 msgid ""
361 "You can also setup a calibre development environment inside the free "
362 "Microsoft Visual Studio, if you like, following the instructions `here "
363 "<https://www.mobileread.com/forums/showthread.php?t=251201>`_."
364 msgstr "원한다면 무료 Microsoft Visual Studio 안에서도 캘리버 개발 환경을 설정할 수 있습니다. `여기 <https://www.mobileread.com/forums/showthread.php?t=251201>`_의 안내를 따르십시오."
365
366 #: ../../../__w/calibre/calibre/manual/develop.rst:190
367 msgid "macOS development environment"
368 msgstr "macOS 개발 환경"
369
370 #: ../../../__w/calibre/calibre/manual/develop.rst:194
371 msgid ""
372 "Install calibre normally using the `provided .dmg <https://calibre-"
373 "ebook.com/download_osx>`__. Then open a Terminal and change to the "
374 "previously checked out calibre code folder, for example::"
375 msgstr "제공된 `.dmg <https://calibre-ebook.com/download_osx>`__를 사용하여 캘리버를 정상적으로 설치하십시오. 그런 다음 터미널을 열고 이전에 체크아웃한 캘리버 코드 폴더로 이동하십시오. 예를 들어::"
376
377 #: ../../../__w/calibre/calibre/manual/develop.rst:199
378 msgid ""
379 "calibre is the folder that contains the src and resources sub-folders. The "
380 "calibre command line tools are found inside the calibre app bundle, in "
381 ":file:`/Applications/calibre.app/Contents/MacOS` you should add this folder "
382 "to your PATH environment variable, if you want to run the command line tools"
383 " easily."
384 msgstr "calibre는 src 및 resources 하위 폴더를 포함하는 폴더입니다. 캘리버 명령줄 도구는 캘리버 앱 번들 안에 있으며, :file:`/Applications/calibre.app/Contents/MacOS`에 있습니다. 명령줄 도구를 쉽게 실행하려면 이 폴더를 PATH 환경 변수에 추가해야 합니다."
385
386 #: ../../../__w/calibre/calibre/manual/develop.rst:205
387 msgid ""
388 "The next step is to create a bash script that will set the environment "
389 "variable ``CALIBRE_DEVELOP_FROM`` to the absolute path of the src folder "
390 "when running calibre in debug mode."
391 msgstr "다음 단계는 디버그 모드에서 캘리버를 실행할 때 환경 변수 ``CALIBRE_DEVELOP_FROM``을 src 폴더의 절대 경로로 설정하는 bash 스크립트를 만드는 것입니다."
392
393 #: ../../../__w/calibre/calibre/manual/develop.rst:208
394 msgid "Create a plain text file::"
395 msgstr "일반 텍스트 파일 만들기::"
396
397 #: ../../../__w/calibre/calibre/manual/develop.rst:214
398 msgid ""
399 "Save this file as :file:`/usr/local/bin/calibre-develop`, then set its "
400 "permissions so that it can be executed::"
401 msgstr "이 파일을 :file:`/usr/local/bin/calibre-develop`로 저장한 다음 실행할 수 있도록 권한을 설정하십시오::"
402
403 #: ../../../__w/calibre/calibre/manual/develop.rst:218
404 msgid "Once you have done this, run::"
405 msgstr "이 작업을 완료한 후, 실행::"
406
407 #: ../../../__w/calibre/calibre/manual/develop.rst:222
408 msgid ""
409 "You should see some diagnostic information in the Terminal window as calibre"
410 " starts up, and you should see an asterisk after the version number in the "
411 "GUI window, indicating that you are running from source."
412 msgstr "캘리버가 시작될 때 터미널 창에 일부 진단 정보가 표시되어야 하며, GUI 창에서 버전 번호 뒤에 별표가 표시되어 소스에서 실행 중임을 나타내야 합니다."
413
414 #: ../../../__w/calibre/calibre/manual/develop.rst:227
415 msgid "Linux development environment"
416 msgstr "Linux 개발 환경"
417
418 #: ../../../__w/calibre/calibre/manual/develop.rst:231
419 msgid ""
420 "calibre is primarily developed on Linux. You have two choices in setting up "
421 "the development environment. You can install the calibre binary as normal "
422 "and use that as a runtime environment to do your development. This approach "
423 "is similar to that used in Windows and macOS. Alternatively, you can install"
424 " calibre from source. Instructions for setting up a development environment "
425 "from source are in the INSTALL file in the source tree. Here we will address"
426 " using the binary as a runtime, which is the recommended method."
427 msgstr "캘리버는 주로 Linux에서 개발됩니다. 개발 환경을 설정하는 데 두 가지 선택지가 있습니다. 캘리버 바이너리를 정상적으로 설치하고 런타임 환경으로 사용하여 개발할 수 있습니다. 이 접근 방식은 Windows와 macOS에서 사용하는 것과 유사합니다. 또는 소스에서 캘리버를 설치할 수도 있습니다. 소스에서 개발 환경을 설정하는 방법은 소스 트리의 INSTALL 파일에 있습니다. 여기서는 권장 방법으로 바이너리를 런타임으로 사용하는 방법을 다루겠습니다."
428
429 #: ../../../__w/calibre/calibre/manual/develop.rst:237
430 msgid ""
431 "Install calibre using the `binary installer <https://calibre-"
432 "ebook.com/download_linux>`_. Then open a terminal and change to the "
433 "previously checked out calibre code folder, for example::"
434 msgstr "`바이너리 설치 프로그램 <https://calibre-ebook.com/download_linux>`_을 사용하여 캘리버를 설치하십시오. 그런 다음 터미널을 열고 이전에 체크아웃한 캘리버 코드 폴더로 이동하십시오. 예를 들어::"
435
436 #: ../../../__w/calibre/calibre/manual/develop.rst:243
437 msgid ""
438 "The next step is to set the environment variable ``CALIBRE_DEVELOP_FROM`` to"
439 " the absolute path of the src folder. So, following the example above, it "
440 "would be ``/home/kovid/work/calibre/src``. How to set environment variables "
441 "depends on your Linux distribution and what shell you are using."
442 msgstr "다음 단계는 환경 변수 ``CALIBRE_DEVELOP_FROM``을 src 폴더의 절대 경로로 설정하는 것입니다. 따라서 위 예시를 따르면 ``/home/kovid/work/calibre/src``가 됩니다. 환경 변수를 설정하는 방법은 Linux 배포판과 사용 중인 셸에 따라 다릅니다."
443
444 #: ../../../__w/calibre/calibre/manual/develop.rst:248
445 msgid ""
446 "It is recommended to use the binary installer provided from upstream. Should"
447 " you insist on using a package provided by your distribution, use the "
448 "``CALIBRE_PYTHON_PATH`` and ``CALIBRE_RESOURCES_PATH`` variables instead. "
449 "You can get these by running ``calibre-debug --paths``. But note that "
450 "distribution calibre packages are often terminally broken and are completely"
451 " unsupported."
452 msgstr "상류에서 제공하는 바이너리 설치 프로그램을 사용하는 것이 좋습니다. 배포판에서 제공하는 패키지를 사용하려는 경우, 대신 ``CALIBRE_PYTHON_PATH`` 및 ``CALIBRE_RESOURCES_PATH`` 변수를 사용하십시오. ``calibre-debug --paths``를 실행하여 이를 얻을 수 있습니다. 하지만 배포판 캘리버 패키지는 종종 완전히 깨져 있으며 완전히 지원되지 않는다는 점에 유의하십시오."
453
454 #: ../../../__w/calibre/calibre/manual/develop.rst:255
455 msgid ""
456 "Once you have set the environment variable, open a new terminal and check "
457 "that it was correctly set by using the command::"
458 msgstr "환경 변수를 설정한 후 새 터미널을 열고 다음 명령을 사용하여 올바르게 설정되었는지 확인하십시오::"
459
460 #: ../../../__w/calibre/calibre/manual/develop.rst:262
461 msgid ""
462 "That's it! You are now ready to start hacking on the calibre code. For "
463 "example, open the file :file:`src/calibre/__init__.py` in your favorite "
464 "editor and add the line::"
465 msgstr "이제 됐습니다! 이제 캘리버 코드 수정을 시작할 준비가 되었습니다. 예를 들어, 즐겨 사용하는 편집기에서 :file:`src/calibre/__init__.py` 파일을 열고 다음 줄을 추가하십시오::"
466
467 #: ../../../__w/calibre/calibre/manual/develop.rst:270
468 msgid ""
469 "Having separate \"normal\" and \"development\" calibre installs on the same "
470 "computer"
471 msgstr "동일한 컴퓨터에 별도의 \"일반\" 및 \"개발\" 캘리버 설치 갖기"
472
473 #: ../../../__w/calibre/calibre/manual/develop.rst:272
474 msgid ""
475 "The calibre source tree is very stable and rarely breaks, but if you feel "
476 "the need to run from source on a separate test library and run the released "
477 "calibre version with your everyday library, you can achieve this easily "
478 "using .bat files or shell scripts to launch calibre. The example below shows"
479 " how to do this on Windows using .bat files (the instructions for other "
480 "platforms are the same, just use a shell script instead of a .bat file)"
481 msgstr "캘리버 소스 트리는 매우 안정적이며 거의 깨지지 않지만, 별도의 테스트 라이브러리에서 소스로 실행하고 일상 라이브러리에서는 릴리스된 캘리버 버전을 실행해야 한다고 느끼면, .bat 파일이나 셸 스크립트를 사용하여 캘리버를 시작하면 쉽게 이를 달성할 수 있습니다. 아래 예시는 .bat 파일을 사용하여 Windows에서 이 작업을 수행하는 방법을 보여줍니다 (다른 플랫폼에 대한 안내는 동일하며, .bat 파일 대신 셸 스크립트를 사용하십시오)"
482
483 #: ../../../__w/calibre/calibre/manual/develop.rst:277
484 msgid "To launch the release version of calibre with your everyday library:"
485 msgstr "일상 라이브러리로 캘리버 릴리스 버전을 시작하려면:"
486
487 #: ../../../__w/calibre/calibre/manual/develop.rst:279
488 msgid "calibre-normal.bat::"
489 msgstr "calibre-normal.bat::"
490
491 #: ../../../__w/calibre/calibre/manual/develop.rst:283
492 msgid "calibre-dev.bat::"
493 msgstr "calibre-dev.bat::"
494
495 #: ../../../__w/calibre/calibre/manual/develop.rst:290
496 msgid "Debugging tips"
497 msgstr "디버깅 팁"
498
499 #: ../../../__w/calibre/calibre/manual/develop.rst:292
500 msgid ""
501 "Python is a dynamically typed language with excellent facilities for "
502 "introspection. Kovid wrote the core calibre code without once using a "
503 "debugger. There are many strategies to debug calibre code:"
504 msgstr "Python은 훌륭한 내성(introspection) 기능을 가진 동적 타입 언어입니다. Kovid는 디버거를 한 번도 사용하지 않고 캘리버 핵심 코드를 작성했습니다. 캘리버 코드를 디버깅하는 여러 전략이 있습니다:"
505
506 #: ../../../__w/calibre/calibre/manual/develop.rst:297
507 msgid "Using print statements"
508 msgstr "print 문 사용하기"
509
510 #: ../../../__w/calibre/calibre/manual/develop.rst:299
511 msgid ""
512 "This is Kovid's favorite way to debug. Simply insert print statements at "
513 "points of interest and run your program in the terminal. For example, you "
514 "can start the GUI from the terminal as::"
515 msgstr "이것은 Kovid가 가장 좋아하는 디버깅 방법입니다. 관심 지점에 print 문을 삽입하고 터미널에서 프로그램을 실행하기만 하면 됩니다. 예를 들어, 터미널에서 GUI를 시작할 수 있습니다::"
516
517 #: ../../../__w/calibre/calibre/manual/develop.rst:304
518 msgid "Similarly, you can start the E-book viewer as::"
519 msgstr "마찬가지로, 전자책 뷰어를 시작할 수 있습니다::"
520
521 #: ../../../__w/calibre/calibre/manual/develop.rst:308
522 msgid "The e-book editor can be started as::"
523 msgstr "전자책 편집기는 다음과 같이 시작할 수 있습니다::"
524
525 #: ../../../__w/calibre/calibre/manual/develop.rst:313
526 msgid "Using an interactive Python interpreter"
527 msgstr "대화형 Python 인터프리터 사용하기"
528
529 #: ../../../__w/calibre/calibre/manual/develop.rst:315
530 msgid ""
531 "You can insert the following two lines of code to start an interactive "
532 "Python session at that point::"
533 msgstr "다음 두 줄의 코드를 삽입하여 해당 지점에서 대화형 Python 세션을 시작할 수 있습니다::"
534
535 #: ../../../__w/calibre/calibre/manual/develop.rst:320
536 msgid ""
537 "When running from the command line, this will start an interactive Python "
538 "interpreter with access to all locally defined variables (variables in the "
539 "local scope). The interactive prompt even has :kbd:`Tab` completion for "
540 "object properties and you can use the various Python facilities for "
541 "introspection, such as :func:`dir`, :func:`type`, :func:`repr`, etc."
542 msgstr "명령줄에서 실행하면 로컬로 정의된 변수(로컬 범위의 변수)에 접근할 수 있는 대화형 Python 인터프리터가 시작됩니다. 대화형 프롬프트는 객체 속성에 대한 :kbd:`Tab` 완성 기능도 갖추고 있으며, :func:`dir`, :func:`type`, :func:`repr` 등과 같은 다양한 Python 내성 기능을 사용할 수 있습니다."
543
544 #: ../../../__w/calibre/calibre/manual/develop.rst:326
545 msgid "Using the Python debugger as a remote debugger"
546 msgstr "Python 디버거를 원격 디버거로 사용하기"
547
548 #: ../../../__w/calibre/calibre/manual/develop.rst:328
549 msgid ""
550 "You can use the builtin Python debugger (pdb) as a remote debugger from the "
551 "command line. First, start the remote debugger at the point in the calibre "
552 "code you are interested in, like this::"
553 msgstr "내장 Python 디버거(pdb)를 명령줄에서 원격 디버거로 사용할 수 있습니다. 먼저 관심 있는 캘리버 코드 지점에서 원격 디버거를 시작하십시오. 예를 들어::"
554
555 #: ../../../__w/calibre/calibre/manual/develop.rst:335
556 msgid ""
557 "Then run calibre, either as normal, or using one of the calibre-debug "
558 "commands described in the previous section. Once the above point in the code"
559 " is reached, calibre will freeze, waiting for the debugger to connect."
560 msgstr "그런 다음 캘리버를 정상적으로 실행하거나 이전 섹션에서 설명한 calibre-debug 명령 중 하나를 사용하여 실행하십시오. 코드의 위 지점에 도달하면 캘리버가 중단되어 디버거가 연결되기를 기다립니다."
561
562 #: ../../../__w/calibre/calibre/manual/develop.rst:339
563 msgid ""
564 "Now open a terminal or command prompt and use the following command to start"
565 " the debugging session::"
566 msgstr "이제 터미널이나 명령 프롬프트를 열고 다음 명령을 사용하여 디버깅 세션을 시작하십시오::"
567
568 #: ../../../__w/calibre/calibre/manual/develop.rst:344
569 msgid ""
570 "You can read about how to use the Python debugger in the `Python stdlib docs"
571 " for the pdb module <https://docs.python.org/library/pdb.html#debugger-"
572 "commands>`_."
573 msgstr "`Python 표준 라이브러리 문서의 pdb 모듈 <https://docs.python.org/library/pdb.html#debugger-commands>`_에서 Python 디버거 사용 방법에 대해 읽을 수 있습니다."
574
575 #: ../../../__w/calibre/calibre/manual/develop.rst:348
576 msgid ""
577 "By default, the remote debugger will try to connect on port 4444. You can "
578 "change it, by passing the port parameter to both the set_trace() and the "
579 "cli() functions above, like this: ``set_trace(port=1234)`` and "
580 "``cli(port=1234)``."
581 msgstr "기본적으로 원격 디버거는 포트 4444에 연결을 시도합니다. 위의 set_trace()와 cli() 함수 모두에 port 매개변수를 전달하여 이를 변경할 수 있습니다: ``set_trace(port=1234)`` 및 ``cli(port=1234)``."
582
583 #: ../../../__w/calibre/calibre/manual/develop.rst:354
584 msgid ""
585 "The Python debugger cannot handle multiple threads, so you have to call "
586 "set_trace once per thread, each time with a different port number."
587 msgstr "Python 디버거는 여러 스레드를 처리할 수 없으므로, 각 스레드마다 한 번씩 set_trace를 호출해야 하며, 매번 다른 포트 번호를 사용해야 합니다."
588
589 #: ../../../__w/calibre/calibre/manual/develop.rst:358
590 msgid "Using the debugger in your favorite Python IDE"
591 msgstr "즐겨 사용하는 Python IDE에서 디버거 사용하기"
592
593 #: ../../../__w/calibre/calibre/manual/develop.rst:360
594 msgid ""
595 "It is possible to use the builtin debugger in your favorite Python IDE, if "
596 "it supports remote debugging. The first step is to add the calibre src "
597 "checkout to the ``PYTHONPATH`` in your IDE. In other words, the folder you "
598 "set as ``CALIBRE_DEVELOP_FROM`` above, must also be in the ``PYTHONPATH`` of"
599 " your IDE."
600 msgstr "즐겨 사용하는 Python IDE에서 내장 디버거를 사용할 수 있습니다 (원격 디버깅을 지원하는 경우). 첫 번째 단계는 캘리버 src 체크아웃을 IDE의 ``PYTHONPATH``에 추가하는 것입니다. 즉, 위에서 ``CALIBRE_DEVELOP_FROM``으로 설정한 폴더가 IDE의 ``PYTHONPATH``에도 있어야 합니다."
601
602 #: ../../../__w/calibre/calibre/manual/develop.rst:365
603 msgid ""
604 "Then place the IDE's remote debugger module into the :file:`src` sub-folder "
605 "of the calibre source code checkout. Add whatever code is needed to launch "
606 "the remote debugger to calibre at the point of interest, for example in the "
607 "main function. Then run calibre as normal. Your IDE should now be able to "
608 "connect to the remote debugger running inside calibre."
609 msgstr "그런 다음 IDE의 원격 디버거 모듈을 캘리버 소스 코드 체크아웃의 :file:`src` 하위 폴더에 넣으십시오. 관심 지점에서 (예: 기본 함수에서) 캘리버에 원격 디버거를 시작하는 데 필요한 코드를 추가하십시오. 그런 다음 캘리버를 정상적으로 실행하십시오. 이제 IDE가 캘리버 내부에서 실행 중인 원격 디버거에 연결할 수 있어야 합니다."
610
611 #: ../../../__w/calibre/calibre/manual/develop.rst:372
612 msgid "Executing arbitrary scripts in the calibre Python environment"
613 msgstr "캘리버 Python 환경에서 임의 스크립트 실행하기"
614
615 #: ../../../__w/calibre/calibre/manual/develop.rst:374
616 msgid ""
617 "The :command:`calibre-debug` command provides a couple of handy switches to "
618 "execute your own code, with access to the calibre modules::"
619 msgstr ":command:`calibre-debug` 명령은 캘리버 모듈에 접근할 수 있는 자체 코드를 실행하기 위한 몇 가지 편리한 스위치를 제공합니다::"
620
621 #: ../../../__w/calibre/calibre/manual/develop.rst:379
622 msgid ""
623 "is great for testing a little snippet of code on the command line. It works "
624 "in the same way as the -c switch to the Python interpreter::"
625 msgstr "명령줄에서 약간의 코드 조각을 테스트하는 데 유용합니다. Python 인터프리터에 대한 -c 스위치와 동일한 방식으로 작동합니다::"
626
627 #: ../../../__w/calibre/calibre/manual/develop.rst:383
628 msgid ""
629 "can be used to execute your own Python script. It works in the same way as "
630 "passing the script to the Python interpreter, except that the calibre "
631 "environment is fully initialized, so you can use all the calibre code in "
632 "your script. To use command line arguments with your script, use the form::"
633 msgstr "자신의 Python 스크립트를 실행하는 데 사용할 수 있습니다. 캘리버 환경이 완전히 초기화되어 스크립트의 모든 캘리버 코드를 사용할 수 있다는 점을 제외하고는 Python 인터프리터에 스크립트를 전달하는 것과 같은 방식으로 작동합니다. 스크립트와 함께 명령줄 인수를 사용하려면 다음 형식을 사용합니다::"
634
635 #: ../../../__w/calibre/calibre/manual/develop.rst:388
636 msgid ""
637 "The ``--`` causes all subsequent arguments to be passed to your script."
638 msgstr "``--``는 이후의 모든 인수를 스크립트에 전달합니다."
639
640 #: ../../../__w/calibre/calibre/manual/develop.rst:392
641 msgid "Using calibre in your projects"
642 msgstr "프로젝트에서 캘리버 사용하기"
643
644 #: ../../../__w/calibre/calibre/manual/develop.rst:394
645 msgid ""
646 "It is possible to directly use calibre functions/code in your Python "
647 "project. Two ways exist to do this:"
648 msgstr "Python 프로젝트에서 직접 캘리버 함수/코드를 사용할 수 있습니다. 두 가지 방법이 있습니다:"
649
650 #: ../../../__w/calibre/calibre/manual/develop.rst:397
651 msgid "Binary install of calibre"
652 msgstr "캘리버 바이너리 설치"
653
654 #: ../../../__w/calibre/calibre/manual/develop.rst:399
655 msgid ""
656 "If you have a binary install of calibre, you can use the Python interpreter "
657 "bundled with calibre, like this::"
658 msgstr "캘리버의 바이너리 설치가 있는 경우, 다음과 같이 캘리버와 함께 번들로 제공되는 Python 인터프리터를 사용할 수 있습니다::"
659
660 #: ../../../__w/calibre/calibre/manual/develop.rst:404
661 msgid "Source install on Linux"
662 msgstr "Linux에서 소스 설치"
663
664 #: ../../../__w/calibre/calibre/manual/develop.rst:406
665 msgid ""
666 "In addition to using the above technique, if you do a source install on "
667 "Linux, you can also directly import calibre, as follows::"
668 msgstr "위의 기술을 사용하는 것 외에도, Linux에서 소스 설치를 수행하면 다음과 같이 직접 캘리버를 가져올 수도 있습니다::"
669
670 #: ../../../__w/calibre/calibre/manual/develop.rst:414
671 msgid ""
672 "It is essential that you import the init_calibre module before any other "
673 "calibre modules/packages as it sets up the interpreter to run calibre code."
674 msgstr "다른 캘리버 모듈/패키지보다 먼저 init_calibre 모듈을 가져오는 것이 필수적입니다. 이 모듈이 인터프리터를 캘리버 코드를 실행하도록 설정하기 때문입니다."
675
676 #: ../../../__w/calibre/calibre/manual/develop.rst:418
677 msgid "API documentation for various parts of calibre"
678 msgstr "캘리버 다양한 부분의 API 문서"