view release on metacpan or  search on metacpan

docs/src/xlate.gpt5-AR.pod  view on Meta::CPAN

=encoding utf-8

=head1 NAME

App::Greple::xlate - وحدة دعم الترجمة لأداة greple

=head1 SYNOPSIS

    greple -Mxlate::deepl --xlate pattern target-file

    greple -Mxlate::gpt5 --xlate pattern target-file

    greple -Mxlate --xlate-engine gpt5 --xlate pattern target-file

=head1 VERSION

Version 1.0202

=head1 DESCRIPTION

B<Greple> B<xlate> تعثر الوحدة على كتل النص المطلوبة وتستبدلها بالنص المترجم. حاليًا تم تنفيذ DeepL (F<deepl.pm>) ووحدة GPT-5.5 (F<gpt5.pm>) كمحرك خلفي.

إذا كنت تريد ترجمة كتل نصية عادية في مستند مكتوب بأسلوب POD الخاص بلغة Perl، فاستخدم أمر B<greple> مع الوحدة C<xlate::deepl> وC<perl> بهذا الشكل:

    greple -Mxlate::deepl -Mperl --pod --re '^([\w\pP].*\n)+' --all foo.pm

في هذا الأمر، تعني سلسلة النمط C<^([\w\pP].*\n)+> أسطرًا متتالية تبدأ بحروف وأرقام وعلامات ترقيم. يعرض هذا الأمر المنطقة المراد ترجمتها مميّزة. ÙŠÙ...

=for html <p>
<img width="750" src="https://raw.githubusercontent.com/kaz-utashiro/App-Greple-xlate/main/images/select-area.png">
</p>

ثم أضف الخيار C<--xlate> لترجمة المنطقة المحددة. عندها سيعثر على الأقسام المطلوبة ويستبدلها بمخرجات أمر B<deepl>.

افتراضيًا، يُطبع النص الأصلي والمُترجَم بصيغة "علامات التعارض" المتوافقة مع L<git(1)>. باستخدام صيغة C<ifdef> يمكنك الحصول على الجزء المطلوب بواØ...

=for html <p>
<img width="750" src="https://raw.githubusercontent.com/kaz-utashiro/App-Greple-xlate/main/images/format-conflict.png">
</p>

إذا كنت تريد ترجمة النص بالكامل، فاستخدم الخيار B<--match-all>. هذا اختصار لتحديد النمط C<(?s).+> الذي يطابق النص بأكمله.

يمكن عرض بيانات تنسيق علامات التعارض بأسلوب جنبًا إلى جنب بواسطة أمر L<sdif|App::sdif> مع الخيار C<-V>. ولأنه لا معنى للمقارنة على أساس كل سطر على حد...

    sdif -V --no-filename --no-tc --no-cdif data_shishin.deepl-EN-US.cm

=for html <p>
<img width="750" src="https://raw.githubusercontent.com/kaz-utashiro/App-Greple-xlate/main/images/sdif-cm-view.png">
</p>

=head1 NORMALIZATION

تُجرى المعالجة بوحدات محددة، ولكن في حالة تسلسل من عدة أسطر من نص غير فارغ، تُحوَّل معًا إلى سطر واحد. تُنفَّذ هذه العملية على النحو التال...

=over 2

=item *

أزل المسافات البيضاء من بداية ونهاية كل سطر.

=item *

إذا انتهى السطر بعلامة ترقيم بعرض كامل، فادمجه مع السطر التالي.

=item *

إذا انتهى السطر بمحرف بعرض كامل وبدأ السطر التالي بمحرف بعرض كامل، فادمج السطرين.

=item *

إذا لم يكن أحد طرفي السطر (النهاية أو البداية) محرفًا بعرض كامل، فادمجهما بإدراج مسافة.

=back

تُدار بيانات التخزين المؤقت بناءً على النص المُطَبَّع، لذا حتى إذا أُجريت تعديلات لا تؤثر في نتائج التطبيع، ستظل بيانات الترجمة المخبأة ...

تُجرى عملية التطبيع فقط للنمط الأول (ذي الفهرس 0) والأنماط ذات الأرقام الزوجية. لذلك، إذا تم تحديد نمطين كما يلي، فسيُعالَج النص المطابق Ù„Ù...

    greple -Mxlate -E normalized -E not-normalized

لذا استخدم النمط الأول للنص الذي سيُعالَج بضمّ عدة أسطر إلى سطر واحد، واستخدم النمط الثاني للنص مُسبق التنسيق. إذا لم يكن هناك نص يطابق ال...

=head1 MASKING

أحيانًا توجد أجزاء من النص لا تريد ترجمتها. على سبيل المثال، الوسوم في ملفات Markdown. تقترح DeepL في مثل هذه الحالات تحويل الجزء المراد استثناؤÙ...

    --xlate-setopt maskfile=MASKPATTERN

سيتم تفسير كل سطر من الملف C<MASKPATTERN> كتعبير منتظم، وترجمة السلاسل المطابقة له، ثم الرجوع عن التغييرات بعد المعالجة. يتم تجاهل الأسطر التي ت...

يمكن كتابة نمط معقد على عدة أسطر مع إخفاء سطر جديد بواسطة الشرطة المائلة العكسية.

يمكن رؤية كيفية تحويل النص بواسطة الحجب عبر خيار B<--xlate-mask>.

هذا الواجهة تجريبية وقابلة للتغيير في المستقبل.

=head1 OPTIONS

=over 7

=item B<--xlate>

=item B<--xlate-color>

=item B<--xlate-fold>

=item B<--xlate-fold-width>=I<n> (Default: 70)

docs/src/xlate.gpt5-AR.pod  view on Meta::CPAN

=item --xlate-cache=I<strategy>

=over 4

=item C<auto> (Default)

حافظ على ملف التخزين المؤقت إذا كان موجودًا.

=item C<create>

أنشئ ملف تخزين مؤقت فارغًا ثم اخرج.

=item C<always>, C<yes>, C<1>

حافظ على ذاكرة التخزين المؤقت على أي حال طالما أن الهدف ملف عادي.

=item C<clear>

امسح بيانات ذاكرة التخزين المؤقت أولاً.

=item C<never>, C<no>, C<0>

لا تستخدم ملف ذاكرة التخزين المؤقت مطلقًا حتى إذا كان موجودًا.

=item C<accumulate>

وفقًا للسلوك الافتراضي، تتم إزالة البيانات غير المستخدمة من ملف ذاكرة التخزين المؤقت. إذا كنت لا تريد إزالتها وتريد الاحتفاظ بها في الملÙ...

=back

=item B<--xlate-update>

يفرض هذا الخيار تحديث ملف ذاكرة التخزين المؤقت حتى إذا لم يكن ذلك ضروريًا.

=back

=head1 COMMAND LINE INTERFACE

يمكنك استخدام هذه الوحدة بسهولة من سطر الأوامر باستخدام أمر C<xlate> المُضمَّن في التوزيعة. راجع صفحة الدليل C<xlate> للاستخدام.

يدعم الأمر C<xlate> خيارات طويلة بأسلوب GNU مثل C<--to-lang> وC<--from-lang> وC<--engine> وC<--file>. استخدم C<xlate -h> لرؤية جميع الخيارات المتاحة.

يعمل أمر C<xlate> بالتنسيق مع بيئة Docker، لذا حتى إذا لم يكن لديك أي شيء مُثبّت محليًا، يمكنك استخدامه طالما أن Docker متاح. استخدم خيار C<-D> أو C<-C>.

تتم إدارة عمليات Docker بواسطة L<App::dozo>، والذي يمكن استخدامه أيضًا كأمر مستقل. يدعم أمر C<dozo> ملف الإعدادات C<.dozorc> لإعدادات الحاوية الدائمة.

أيضًا، نظرًا لتوفّر ملفات make لأنماط مستندات متنوعة، فإن الترجمة إلى لغات أخرى ممكنة دون مواصفات خاصة. استخدم خيار C<-M>.

يمكنك أيضًا الجمع بين خياري Docker وC<make> بحيث يمكنك تشغيل C<make> في بيئة Docker.

التشغيل مثل C<xlate -C> سيؤدي إلى إطلاق صدفة مع ربط مستودع git العامل الحالي.

اقرأ المقال الياباني في قسم L</SEE ALSO> للتفاصيل.

=head1 EMACS

حمّل ملف F<xlate.el> المُضمَّن في المستودع لاستخدام أمر C<xlate> من محرر Emacs. تقوم دالة C<xlate-region> بترجمة المنطقة المحددة. اللغة الافتراضية هي C<EN-US> ÙˆÙ...

=for html <p>
<img width="750" src="https://raw.githubusercontent.com/kaz-utashiro/App-Greple-xlate/main/images/emacs.png">
</p>

=head1 ENVIRONMENT

=over 7

=item DEEPL_AUTH_KEY

عيّن مفتاح المصادقة لخدمة DeepL.

=item OPENAI_API_KEY

مفتاح مصادقة OpenAI.

=back

=head1 INSTALL

=head2 CPANMINUS

    $ cpanm App::Greple::xlate

=head2 TOOLS

عليك تثبيت أدوات سطر الأوامر لكل من DeepL وChatGPT.

L<https://github.com/DeepLcom/deepl-python>

L<https://github.com/tecolicom/App-gpty>

=head1 SEE ALSO

=head2 MODULES

L<App::Greple::xlate::deepl>, L<App::Greple::xlate::gpt5>

L<App::dozo> - مشغّل Docker عام يُستخدم بواسطة xlate لعمليات الحاويات

=head2 RELATED MODULES

=over 2

=item * L<App::Greple>

راجع دليل B<greple> للتفاصيل حول نمط نص الهدف. استخدم الخيارات B<--inside> وB<--outside> وB<--include> وB<--exclude> لتقييد منطقة المطابقة.

=item * L<App::Greple::update>

يمكنك استخدام وحدة C<-Mupdate> لتعديل الملفات بنتيجة أمر B<greple>.

=item * L<App::sdif>

استخدم B<sdif> لإظهار تنسيق علامات التعارض جنبًا إلى جنب مع خيار B<-V>.

=item * L<App::Greple::stripe>

تُستخدم وحدة Greple B<stripe> بواسطة خيار B<--xlate-stripe>.

=back