Debian Codegraph @

translations/manual/ar/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 # Usama Khalil, 2025
7 # Usama Khalil, 2025
8 # Usama Khalil, 2025
9 msgid ""
10 msgstr ""
11 "Project-Id-Version: calibre\n"
12 "Report-Msgid-Bugs-To: \n"
13 "POT-Creation-Date: 2026-02-17 16:44+0000\n"
14 "PO-Revision-Date: 2014-06-17 08:34+0000\n"
15 "Last-Translator: Usama Khalil, 2025\n"
16 "Language-Team: Arabic (http://app.transifex.com/calibre/calibre/language/ar/)\n"
17 "MIME-Version: 1.0\n"
18 "Content-Type: text/plain; charset=UTF-8\n"
19 "Content-Transfer-Encoding: 8bit\n"
20 "Language: ar\n"
21 "Plural-Forms: nplurals=6; plural=n==0 ? 0 : n==1 ? 1 : n==2 ? 2 : n%100>=3 && n%100<=10 ? 3 : n%100>=11 && n%100<=99 ? 4 : 5;\n"
22
23 #: ../../../__w/calibre/calibre/manual/develop.rst:4
24 msgid "Setting up a calibre development environment"
25 msgstr "إعداد بيئة تطوير Calibre"
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 "calibre هو برنامج مفتوح المصدر بالكامل، مرخص بموجب `ترخيص جنو العمومي العام الإصدار 3 <https://www.gnu.org/licenses/gpl.html>`_. هذا يعني أنك حر في تنزيل وتعديل البرنامج حسب رغبتك. في هذا القسم، ستتعلم كيفية إعداد بيئة تطوير calibre على نظام التشغيل الذي تختاره. calibre مكتوب بشكل أساسي بلغة `بايثون <https://www.python.org>`_ مع بعض أكواد C/C++ للسرعة وواجهة النظام. لاحظ أن calibre يتطلب بايثون 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 "تتجذر calibre في عالم يونكس، مما يعني أن تصميمها معياري للغاية. تتفاعل الوحدات مع بعضها البعض عبر واجهات محددة جيدًا. هذا يجعل إضافة ميزات جديدة وإصلاح الأخطاء في calibre سهلاً للغاية، مما يؤدي إلى وتيرة تطوير سريعة. بسبب جذورها، يحتوي calibre على واجهة سطر أوامر شاملة لجميع وظائفه، موثقة في :doc:`generated/ar/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 ""
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 "جميع أكواد بايثون لـ calibre موجودة في حزمة ``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`` الذي يحدد الواجهة المدعومة بواسطة برامج تشغيل الأجهزة و ``devices.usbms`` الذي يحدد برنامج تشغيل عام يتصل بجهاز USBMS. جميع برامج التشغيل المستندة إلى USBMS في calibre ترث منه."
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 - جميع أكواد تحويل/بيانات الكتب الإلكترونية. نقطة انطلاق جيدة هي ``calibre.ebooks.conversion.cli`` \nوهي الوحدة التي تشغل الأمر :command:`ebook-convert`. يتم التحكم في عملية التحويل عبر ``conversion.plumber``. \nالكود المستقل عن التنسيق موجود بالكامل في ``ebooks.oeb`` والكود المعتمد على التنسيق موجود في ``ebooks.\nformat_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، وما إلى ذلك. الفئة التي تدير هذا التمثيل هي OEBBook في ``ebooks.oeb.base``. التحويلات المختلفة التي يتم تطبيقها على الكتاب أثناء التحويلات موجودة في :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` لواجهة مكتبة calibre."
134
135 #: ../../../__w/calibre/calibre/manual/develop.rst:63
136 msgid "Content server: ``srv`` is the calibre Content server."
137 msgstr "خادم المحتوى: ``srv`` هو خادم محتوى calibre."
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 - واجهة المستخدم الرسومية. تتم تهيئة واجهة المستخدم الرسومية في ``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 "إذا كنت ترغب في تحديد نقاط الدخول لجميع ملفات calibre التنفيذية المختلفة، فانظر إلى بنية ``entry_points`` في `linux.py <https://github.com/kovidgoyal/calibre/blob/master/src/calibre/linux.py>`_."
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>`_ وستحصل على المساعدة على الأرجح من أحد مطوري calibre العديدين."
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 "يمكنك الحصول على الكود المصدري لـ calibre بطريقتين، باستخدام نظام التحكم في الإصدارات أو بتنزيل مباشر لـ :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 "يستخدم calibre `Git <https://www.git-scm.com/>`_، وهو نظام تحكم في الإصدارات موزع. يتوفر Git على جميع الأنظمة الأساسية التي يدعمها calibre. بعد تثبيت Git، يمكنك الحصول على الكود المصدري لـ calibre بالأمر::"
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 "calibre هو مشروع كبير جدًا بتاريخ تحكم في المصدر طويل جدًا، لذا قد يستغرق الأمر بعض الوقت (من 10 دقائق إلى ساعة حسب سرعة الإنترنت لديك)."
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 "إذا كنت تخطط لإجراء بعض التغييرات الصغيرة فقط، يمكنك إجراء تغييراتك وإنشاء \"تعليمات دمج\" يمكنك بعد ذلك إرفاقها بتذكرة في متتبع أخطاء calibre `هنا <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` في المجلد الحالي، ما عليك سوى إرفاقه بتذكرة على `متتبع الأخطاء الخاص بـ calibre <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 "إذا كنت تخطط للقيام بالكثير من التطوير على calibre، فإن أفضل طريقة هي إنشاء حساب `GitHub <https://github.com>`__. فيما يلي دليل أساسي لإعداد نسختك الخاصة من calibre بطريقة تسمح لك بإرسال طلبات سحب لتضمينها في مستودع calibre الرئيسي:"
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 "إعداد مفاتيح ssh للمصادقة على GitHub، كما هو موضح هنا: `إنشاء مفاتيح 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:`Fork`."
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 "يجب عليك أيضًا مراقبة `منتدى تطوير calibre <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 "بيئة تطوير ويندوز"
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 "يجب عليك أيضًا الحصول على الكود المصدري لـ calibre بشكل منفصل كما هو موضح أعلاه."
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 "قم بتثبيت calibre بشكل طبيعي، باستخدام `مثبت Windows <https://calibre-ebook.com/download_windows>`__. ثم افتح موجه الأوامر وانتقل إلى مجلد كود calibre الذي تم سحبه مسبقًا. على سبيل المثال::"
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``. `هنا دليل قصير <https://docs.python.org/using/windows.html#excursus-setting-environment-variables>`_ لتعيين متغيرات البيئة على Windows."
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 "تعيين متغير البيئة هذا يعني أن calibre سيقوم الآن بتحميل جميع أكواد بايثون الخاصة به من الموقع المحدد."
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 "هذا كل شيء! أنت الآن جاهز للبدء في تعديل كود calibre. على سبيل المثال، افتح الملف :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 "يمكنك أيضًا إعداد بيئة تطوير calibre داخل برنامج 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 "قم بتثبيت calibre بشكل طبيعي باستخدام `ملف .dmg الموفر <https://calibre-ebook.com/download_osx>`__. ثم افتح Terminal وانتقل إلى مجلد كود calibre الذي تم سحبه مسبقًا، على سبيل المثال::"
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. توجد أدوات سطر أوامر calibre داخل حزمة تطبيق calibre، في :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 "الخطوة التالية هي إنشاء نص برمجي (bash script) يقوم بتعيين متغير البيئة ``CALIBRE_DEVELOP_FROM`` إلى المسار المطلق لمجلد src عند تشغيل calibre في وضع التصحيح."
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 "يجب أن ترى بعض معلومات التشخيص في نافذة Terminal عند بدء تشغيل calibre، ويجب أن ترى نجمة بعد رقم الإصدار في نافذة واجهة المستخدم الرسومية، مما يشير إلى أنك تقوم بالتشغيل من المصدر."
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 "يتم تطوير calibre بشكل أساسي على نظام Linux. لديك خياران في إعداد بيئة التطوير. يمكنك تثبيت ثنائي calibre كالمعتاد واستخدامه كبيئة تشغيل للقيام بتطويرك. هذا النهج مشابه لما هو مستخدم في Windows و macOS. بدلاً من ذلك، يمكنك تثبيت calibre من المصدر. توجد تعليمات إعداد بيئة التطوير من المصدر في ملف 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 "قم بتثبيت calibre باستخدام `المثبت الثنائي <https://calibre-ebook.com/download_linux>`_. ثم افتح طرفية وانتقل إلى مجلد كود calibre الذي تم سحبه مسبقًا، على سبيل المثال::"
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 التي تستخدمها وأي shell تستخدمه."
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 ""
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 "هذا كل شيء! أنت الآن جاهز للبدء في تعديل كود calibre. على سبيل المثال، افتح الملف :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 "امتلاك تثبيتات calibre \"عادية\" و \"تطوير\" منفصلة على نفس الكمبيوتر"
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 "شجرة مصادر calibre مستقرة جدًا ونادرًا ما تتعطل، ولكن إذا شعرت بالحاجة إلى التشغيل من المصدر على مكتبة اختبار منفصلة وتشغيل إصدار calibre الذي تم إصداره مع مكتبتك اليومية، يمكنك تحقيق ذلك بسهولة باستخدام ملفات .bat أو نصوص shell لتشغيل calibre. يوضح المثال أدناه كيفية القيام بذلك على نظام Windows باستخدام ملفات .bat (التعليمات للمنصات الأخرى هي نفسها، فقط استخدم نص shell بدلاً من ملف .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 "لتشغيل إصدار calibre الرسمي مع مكتبتك اليومية:"
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 "بايثون هي لغة ذات كتابة ديناميكية مع إمكانيات ممتازة لـ الاستبطان. كتب كوفيد الكود الأساسي لـ calibre دون استخدام مصحح أخطاء مرة واحدة. هناك العديد من الاستراتيجيات لتصحيح أخطاء كود calibre:"
505
506 #: ../../../__w/calibre/calibre/manual/develop.rst:297
507 msgid "Using print statements"
508 msgstr "استخدام عبارات الطباعة"
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 "هذه هي الطريقة المفضلة لكوفيد للتصحيح. ببساطة أدخل عبارات الطباعة في النقاط المهمة وقم بتشغيل برنامجك في الطرفية. على سبيل المثال، يمكنك بدء الواجهة الرسومية من الطرفية كالتالي::"
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 "استخدام مترجم بايثون تفاعلي"
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 "يمكنك إدراج السطرين التاليين من الكود لبدء جلسة بايثون تفاعلية عند تلك النقطة::"
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 "عند التشغيل من سطر الأوامر، سيؤدي هذا إلى بدء مترجم بايثون تفاعلي مع إمكانية الوصول إلى جميع المتغيرات المعرفة محليًا (المتغيرات في النطاق المحلي). حتى موجه الأوامر التفاعلي لديه إكمال :kbd:`Tab` لخصائص الكائن ويمكنك استخدام مرافق بايثون المختلفة للاستبطان، مثل :func:`dir`، :func:`type`، :func:`repr`، إلخ."
543
544 #: ../../../__w/calibre/calibre/manual/develop.rst:326
545 msgid "Using the Python debugger as a remote debugger"
546 msgstr "استخدام مصحح أخطاء بايثون كمصحح أخطاء عن بعد"
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 "يمكنك استخدام مصحح أخطاء بايثون المدمج (pdb) كمصحح أخطاء عن بعد من سطر الأوامر. أولاً، ابدأ مصحح الأخطاء عن بعد عند النقطة في كود calibre التي تهتم بها، هكذا::"
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، إما بشكل طبيعي، أو باستخدام أحد أوامر calibre-debug الموضحة في القسم السابق. بمجرد الوصول إلى النقطة المذكورة أعلاه في الكود، سيتوقف calibre، في انتظار اتصال المصحح."
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 "يمكنك قراءة كيفية استخدام مصحح أخطاء بايثون في `وثائق مكتبة بايثون القياسية لوحدة pdb <https://docs.python.org/library/pdb.html#debugger-commands>`_."
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() أعلاه، كالتالي: ``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 "لا يستطيع مصحح أخطاء بايثون التعامل مع سلاسل متعددة، لذا يجب عليك استدعاء set_trace مرة واحدة لكل سلسلة، في كل مرة برقم منفذ مختلف."
588
589 #: ../../../__w/calibre/calibre/manual/develop.rst:358
590 msgid "Using the debugger in your favorite Python IDE"
591 msgstr "استخدام مصحح الأخطاء في بيئة التطوير المتكاملة (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 "من الممكن استخدام مصحح الأخطاء المدمج في بيئة التطوير المتكاملة (IDE) المفضلة لديك في بايثون، إذا كانت تدعم تصحيح الأخطاء عن بُعد. الخطوة الأولى هي إضافة مجلد src الخاص بـ calibre إلى ``PYTHONPATH`` في بيئة التطوير المتكاملة الخاصة بك. بعبارة أخرى، يجب أن يكون المجلد الذي عينته كـ ``CALIBRE_DEVELOP_FROM`` أعلاه، موجودًا أيضًا في ``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` من نسخة الكود المصدري لـ calibre. أضف أي كود مطلوب لتشغيل مصحح الأخطاء عن بعد إلى calibre عند النقطة المهمة، على سبيل المثال في الدالة الرئيسية. ثم قم بتشغيل calibre كالمعتاد. يجب أن تكون بيئة التطوير المتكاملة الخاصة بك الآن قادرة على الاتصال بمصحح الأخطاء عن بعد الذي يعمل داخل calibre."
610
611 #: ../../../__w/calibre/calibre/manual/develop.rst:372
612 msgid "Executing arbitrary scripts in the calibre Python environment"
613 msgstr "تنفيذ نصوص برمجية عشوائية في بيئة بايثون لـ calibre"
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` بعض المفاتيح المفيدة لـ تنفيذ الكود الخاص بك، مع الوصول إلى وحدات calibre::"
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 "رائع لاختبار مقتطف صغير من الكود في سطر الأوامر. يعمل بنفس طريقة مفتاح -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 "يمكن استخدامه لتنفيذ نص بايثون الخاص بك. يعمل بنفس الطريقة التي يتم بها تمرير النص إلى مترجم بايثون، باستثناء أن بيئة calibre مُهيأة بالكامل، لذلك يمكنك استخدام جميع أكواد calibre في النص الخاص بك. لاستخدام وسائط سطر الأوامر مع النص الخاص بك، استخدم الشكل::"
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 "استخدام calibre في مشاريعك"
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 "من الممكن استخدام دوال/أكواد calibre مباشرة في مشروع بايثون الخاص بك. توجد طريقتان للقيام بذلك:"
649
650 #: ../../../__w/calibre/calibre/manual/develop.rst:397
651 msgid "Binary install of calibre"
652 msgstr "تثبيت calibre الثنائي"
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 "إذا كان لديك تثبيت ثنائي لـ calibre، يمكنك استخدام مترجم بايثون المضمن مع calibre، كالتالي::"
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، يمكنك أيضًا استيراد calibre مباشرة، كالتالي::"
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 قبل أي وحدات/حزم calibre أخرى لأنها تهيئ المترجم لتشغيل كود calibre."
675
676 #: ../../../__w/calibre/calibre/manual/develop.rst:418
677 msgid "API documentation for various parts of calibre"
678 msgstr "توثيق API لأجزاء مختلفة من calibre"