.\" -*- coding: UTF-8 -*- .\" Process this file with .\" groff -man -Tascii linuxdoc.1 .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH LINUXDOC 1 "2 أبريل 2025" .SH الاسم linuxdoc \- محول SGML لنمط DTD الخاص بـ LinuxDoc إلى صيغ إخراج أخرى .SH موجز \fBlinuxdoc\fP \fB\-\-backend=\fP\fIصيغة\fP .br \fB[\-\-papersize=\fP\fIحجم\fP\fB]\fP \fB[\-\-language=\fP\fIلغة\fP\fB]\fP \fB[\-\-charset=\fP\fIحرف\fP\fB]\fP \fB[\-\-style=\fP\fIملف\fP\fB]\fP \fB[\-\-debug]\fP \fB[\-\-define\fP\fI\ سمة=قيمة\fP\fB]\fP \fB[\-\-include\fP\fI\ كيان\fP\fB]\fP \fB[خيارات\-الخلفية...]\fP \fIملف(.sgml)\fP .PP أو (استخدام قديم ومهمل) .br \fBsgmlxxxx [خيارات\-عامة...] [خيارات\-الخلفية...] \ \ \fP\fIملف(.sgml)\fP .SH الوصف مجموعة \fBlinuxdoc\fP هي مجموعة من منسقات النصوص التي تفهم ملف مصدر SGML بنمط DTD الخاص بـ LinuxDoc. كل منسقة (أو "خلفية") تعرض الملف المصدر إلى مجموعة متنوعة من صيغ الإخراج، بما في ذلك HTML وTeX وDVI وPostScript والنص العادي ومصدر \fBgroff\fP(1) بصيغة صفحة دليل. تُوفر مجموعة linuxdoc للتوافق مع الإصدارات السابقة، لأنه لا تزال هناك العديد من المستندات المفيدة المكتوبة بمصدر sgml بنمط DTD الخاص بـ LinuxDoc. .LP لغة (لغات) الترميز المقبولة من قبل هذه المنسقات موصوفة في \fIدليل\fP مستخدم \fILinuxdoc\-Tools\fP. هي متغيرات من تعريف نوع مستند SGML صُمم أصلاً بواسطة Matt Welsh لتوثيق Linux. .SH "الخيارات العامة" معظم خيارات سطر الأوامر مقبولة من قبل جميع الخلفيات. بعض الخلفيات لديها خيارات محددة إضافية للتحكم في العرض إلى صيغة الإخراج الخاصة بها. إليك الخيارات الشائعة: .IP "\-\-backend=\fIصيغة\fP, \-B" يضبط الخلفية للصيغة المحددة. المبدئي هو لا شيء من الصيغة الفعلية، بل فقط إخراج استخدام هذه المجموعات. الصيغ المتاحة هي: html, info, latex, lyx, rtf, txt, check. .IP "\-\-papersize=\fIحجم\fP, \-p" يضبط حجم الورق. المبدئي هو \*(lqa4\*(rq (ورق أوروبي 297x210 مم). يمكنك أيضًا تحديد حجم \*(lqletter\*(rq. .IP "\-\-language=\fIلغة\fP, \-l" يحدد لغة المستند (قد يغير هذا ملفات النمط المستخدمة للتنسيق بواسطة خلفية). اللغة المبدئية هي الإنجليزية. شغّل أمر LinuxDoc\-tools بدون وسائط لرؤية قائمة رموز اللغات الصالحة. .IP "\-\-charset=\fIأحرف\fP, \-c" يحدد ترميز الأحرف للإخراج. المبدئي هو \*(lqascii\*(rq لاختيار مجموعة ASCII؛ يمكنك تحديد "latin" لتحديد مجموعة الأحرف ISO 8859\-1 (Latin\-1). أيضًا، \*(lqnippon\*(rq و\*(lqeuc\-kr\*(rq مطلوبان للتعامل مع ملف sgml المشفر بـ euc\-jp وeuc\-kr. \*(lqutf\-8\*(rq مقبول أيضًا، على الرغم من أنه مدعوم جزئياً فقط. .IP "\-\-style=\fIملف\fP, \-S" يضمّن DTD مساعد (تعريف نوع مستند) من /usr/share/linuxdoc\-tools/dtd. .IP "\-\-tabsize=\fIن\fP, \-t" يضبط تباعد الجدولة المفترض لتوليد مستند الإخراج. تباعد الجدولة المبدئي هو 8. .IP "\-\-debug, \-d" لا تحذف الملفات الوسيطة (مثل ملفات .TeX المولدة في الطريق إلى .dvi، أو ملفات \&.man المحذوفة في الطريق إلى النص العادي). .IP "\-\-define, \-D" يمرر أزواج سمة/قيمة لمطابقتها مع الشرطيات "if" و"unless". انظر دليل المستخدم لمناقشة موسعة لهذه الميزة. هذه الشرطية تُعالج بواسطة أمر sgmlpre. انظر sgmlpre(1) وكذلك دليل المستخدم. .IP "\-\-include, \-i" يمرر خيار \-i إلى \fBnsgmls\fP(1). يمكن استخدام هذا للإدراج الشرطي. انظر صفحة دليل \fBnsgmls\fP(1) للتفاصيل. .IP "\-\-pass, \-P" يمرر سلسلة خيارات إلى الخلفية. الدلالات الدقيقة لهذا الخيار تعتمد على الخلفية ويجب شرحها في صفحات الدليل الفردية لكل منها. .IP file ملف مصدر SGML بامتداد \fI.sgml\fP، مسمى إما \fIملف\fP أو \fIملف.sgml\fP. يجب أن يستخدم DTD الخاص بـ linuxdoc. DTDs الأخرى غير مدعومة. .LP تشغيل خلفية بدون وسائط سيتسبب في سرد جميع خياراتها (رسالة الخطأ حول "no filenames given" يمكن تجاهلها بأمان في هذه الحالة). الخلفيات المتاحة تشمل (الأسماء بين قوسين هي صيغة قديمة ومهملة): .IP linuxdoc\ \-B\ html\ (sgml2html) ترجمة إلى HTML .IP linuxdoc\ \-B\ info\ (sgml2info) ترجمة إلى معلومات GNU .IP linuxdoc\ \-B\ lyx\ (sgml2lyx) ترجمة إلى وحدات Lyx الكلية .IP linuxdoc\ \-B\ latex\ (sgml2latex) ترجمة إلى LaTeX 2e .IP linuxdoc\ \-B\ rtf\ (sgml2rtf) ترجمة إلى تنسيق النص الغني لـ Microsoft .IP linuxdoc\ \-B\ txt\ (sgml2txt) ترجمة إلى نص عادي أو ترميز صفحة دليل Unix .LP هناك أيضًا أداة \fBlinuxdoc\fP\-B\fBcheck\fP (sgmlcheck) متاحة للتحقق من صحة بناء جملة SGML وفقًا لـ DTD Linuxdoc في نصوص الوثائق دون إنشاء نسخة مترجمة فعليًّا. .SH "برامج تشغيل النهاية الخلفية" فيما يلي وصف كل برنامج تشغيل نهاية خلفية: .LP **************************************************** .LP \fBlinuxdoc \-B html \fP (sgml2html) يحول ملف مصدر SGML لـ LinuxDoc DTD إلى مخرجات HTML. تظهر المخرجات في ملف المستوى الأعلى \fIfile.html\fP و \fIfile\-n.html\fP لكل قسم (إجراء مبدئي، لكن يمكن تغييره بواسطة خيار)، حيث \fIfile\fP هو اسم ملف مصدر SGML و \fIn\fP هو اسم القسم. .LP زوج السمة/القيمة "output=html" مضبوط للشروط. .LP \fBlinuxdoc \-B html\fP يقبل الخيارات التالية: \fB[\-\-split\fP \fI0|1|2\fP \fB] [\-\-dosnames] [\-\-imagebuttons]\fP \fB[\-\-toc\fP \fI0|1|2\fP \fB]\fP .LP معانيها هي: .IP "\-\-split, \-s" مستوى تقسيم المستندات المصدر. 0 = لا تقسيم، 1 = تقسيم حسب الأقسام الرئيسية، 2 = تقسيم حسب الأقسام الفرعية. .IP "\-\-toc, \-T" ما هو المستوى المطلوب لإنشاء جدول المحتويات؟ 0 = عدم إنشاء جدول المحتويات على الإطلاق, 1 = تضمين الأقسام الرئيسية (/الفصول/الأجزاء)، 2 = تضمين الأقسام الفرعية. .IP "\-\-dosnames, \-h" استخدم ".htm" بدلا من ".html" كامتداد لملفات html. .IP "\-\-imagebuttons, \-I" استخدم أيقونات صور الأسهم "التالي" و "السابق" و "المحتويات" المضمنة في /usr/share/linuxdoc\-tools كأزرار تنقل. .IP "\-\-footer, \-F" استخدم الملف المحدد كتذييل في كل ملف html ناتج. التذييل المبدئي هو مجرد نص عادي .nh .nf .ad l \en \en .hy .fi .IP "\-\-header, \-H" استخدم الملف المحدد كالجزء العلوي من الترويسة في كل ملف html ناتج. لاحظ أن هذا ليس الجزء الكامل من الترويسة، أي أن العنوان والروابط (التالي، السابق، المحتويات) في الترويسة المبدئية محفوظة. المبدئي هو .nh .nf .ad l \en \en \en .hy .fi .IP "\-\-rtldirection, \-r" اضبط اتجاه من اليمين إلى اليسار في ملف html. .LP **************************************************** .LP \fBlinuxdoc \-B info \fP (sgml2info) يحول ملف مصدر SGML لـ LinuxDoc DTD إلى تنسيق GNU info. سيظهر المخرج في \fIfile.info\fP حيث \fIfile\fP هو اسم ملف مصدر SGML. .LP ضُبط زوج السمة/القيمة "output=info" للشروط. .LP \fBlinuxdoc \-B info\fP ليس لديه خيارات خاصة بالنهاية الخلفية. .LP **************************************************** .LP \fBlinuxdoc \-B latex \fP (sgml2latex) يحول ملف مصدر SGML لـ LinuxDoc DTD إلى مخرج LaTeX، باستخدام المحلل \fBnsgmls\fP(1) أو \fBonsgmls\fP(1)، والمترجم \fBsgmlsasp\fP(1). باستخدام مخرج LaTeX، ومُنسق النص \fBlatex\fP(1)، يمكنك بعد ذلك إنشاء مخرج DVI، ومخرج PostScript باستخدام المحول \fBdvips\fP(1). سيظهر المخرج في \fIfile.tex\fP لمخرج LaTeX، أو \fIfile.dvi\fP لمخرج DVI، أو \fIfile.ps\fP لمخرج PostScript، حيث \fIfile\fP هو اسم ملف مصدر SGML. .LP باستخدام مخرج LaTeX، ومُنسق النص \fBpdflatex\fP(1)، يمكنك بعد ذلك إنشاء مخرج PDF جميل، مناسب للعرض باستخدام عارضي PDF مثل \fBxpdf\fP(1)، \fBacroread\fP(1) أو \fBghostview\fP(1). .LP زوج السمة/القيمة "output=latex2e" مضبوط للشروط. .LP \fBlinuxdoc \-B latex\fP يقبل الخيارات الخاصة بالنهاية الخلفية التالية: \fB[\-\-output=\fP\fItex\fP\fB|\fP\fIdvi\fP\fB|\fP\fIps\fP\fB|\fP\fIpdf]\fP \fB[\-\-bibtex] [\-\-makeindex]\fP \fB[\-\-pagenumber=\fP\fIn\fP\fB]\fP \fB\-\-quick\fP \fB[\-\-latex=\fP\fIlatex\fP\fB|\fP\fIhlatexp\fP\fB|\fP\fIplatex\fP\fB|\fP\fIjlatex]\fP \fB[\-\-dvips=\fP\fIdvips\fP\fB|\fP\fIdvi2ps]\fP \fB[\-\-verbosity=n]\fP .LP معانيها هي: .IP "\-\-output=\fIfmt\fP, \-o" حدد تنسيق المخرج المطلوب. المُحدد \fIfmt\fP قد يكون \*(lqtex\*(rq، \*(lqdvi\*(rq، \*(lqps\*(rq، أو \*(lqpdf\*(rq. .PP ملاحظة: هذا الإصدار لا يكتب فوق/يزيل الملفات الوسيطة: ملف tex لمخرج dvi، أو ملفات tex/dvi لمخرج ps. هذا سلوك مختلف عن SGML\-Tools الأصلي 1.0.9، لذا أنت محذر هنا. .IP "\-\-bibtex, \-b" عالج TeX المُنشأ باستخدام \fBbibtex\fP(1). .IP "\-\-makeindex, \-m" أنشئ ملف فهرس TeX مناسب للمعالجة باستخدام \fBmakeindex\fP(1) من وسوم و الموجودة في مصدر SGML. .IP "\-\-pagenumber, \-n" اضبط رقم الصفحة الابتدائي في ملف المخرج DVI أو PS. .IP "\-\-quick, \-q" قم بتمريرة واحدة فقط من تنسيق LaTeX. هذا غالبًا غير كافٍ لإنتاج المخرج النهائي (بسبب المراجع، إلخ) ولكنه مفيد لاكتشاف أخطاء TeX ومشاكل الضبط. .IP "\-\-pass, \-P" وسيطة خيار التمريرة تُدرج مباشرة بعد ديباجة LaTeX المُنشأة بواسطة وسم نوع المستند. حدد تنسيق المخرج المطلوب. المُحدد \fIfmt\fP قد يكون \*(lqtex\*(rq، \*(lqdvi\*(rq، \*(lqps\*(rq، أو \*(lqpdf\*(rq. .IP "\-\-latex=\fIalternate_latex_command\fP, \-x" هذا الخيار مخصص حاليًا للغتين الكورية واليابانية. يمكن أن يكون \fIalternate_latex_command\fP إما \*(lqlatex'’ (الافتراضي)، أو \*(lqhlatexp‘' (لللغة الكورية)، أو \*(lqplatex\*(rq أو \*(lqjlatex\*(rq (لللغة اليابانية). يمكن استخدام هذا الخيار لعرض المستندات الكورية باستخدام HLaTeXp، أو لعرض المستندات اليابانية باستخدام pLaTeX/jLaTeX. وإلا، يجب تثبيت HLaTeX لعرض المستندات الكورية. من ناحية أخرى، يمكن عرض المستندات اليابانية باستخدام jLaTeX (وهو الإعداد الافتراضي عند تحديد \*(lq\-c nippon\*(rq)، لذا إذا كان لديك jLaTeX بالفعل، فقد لا تحتاج إلى تثبيت pLaTeX. .IP "\-\-dvips=\fIalternate_dvips_command\fP, \-s" هذا الخيار حاليًا لليابانية. يمكن أن يكون \fIalternate_dvips_command\fP \*(lqdvips\*(rq أو \*(lqdvi2ps\*(rq. إذا كنت لا تعرف هذا، فقد لا تحتاج هذا. .IP "\-\-verbosity، \-V" ضبط مستوى الإفصاح. \[aq]0\[aq] (مبدئي) يعرض معلومات حول تشغيل LaTeX فقط في حالة الأخطاء. \[aq]1\[aq] يعرض دائماً معلومات لآخر تشغيل. \[aq]2\[aq] يعرض معلومات لجميع التشغيلات. .LP **************************************************** .LP \fBlinuxdoc \-B lyx \fP (sgml2lyx) يحول ملف مصدر SGML بنظام DTD الخاص بـ LinuxDoc إلى مخرجات LyX. يظهر المخرج في \fIfile.lyx\fP حيث \fIfile\fP هو اسم ملف مصدر SGML. .LP زوج السمة/القيمة "output=lyx" مضبوط للشروط. .LP \fBlinuxdoc \-B lyx\fP ليس لديه خيارات خاصة بالخلفية. .LP **************************************************** .LP \fBlinuxdoc \-B rtf \fP (sgml2rtf) يحول ملف مصدر SGML بنظام DTD الخاص بـ LinuxDoc إلى RTF، تنسيق النص الغني المستخدم في نظام المساعدة في Microsoft Windows. يظهر المخرج في الملف الرئيسي \fIfile.rtf\fP و \fIfile\-n.rtf\fP لكل قسم، حيث \fIfile\fP هو اسم ملف مصدر SGML. مخرج RTF مخصص للتجميع بواسطة مترجم مساعدة Windows (hc31.exe). .LP زوج السمة/القيمة "output=rtf" مضبوط للشروط. .LP \fBlinuxdoc \-B rtf\fP يقبل \fB[\-\-twosplit]\fP كخيار خاص بالخلفية. فيما يلي معنى هذا الخيار: .IP "\-\-twosplit، \-2" يقسم الملفات عند الأقسام n. والأقسام الفرعية n.m. .LP **************************************************** .LP \fBlinuxdoc \-B txt \fP (sgml2txt) يحول ملف مصدر SGML بنظام DTD الخاص بـ LinuxDoc إلى مخرجات ASCII أو ISO\-8859\-1 أو EUC\-JP. يظهر المخرج في \fIfile.txt\fP حيث \fIfile\fP هو اسم ملف مصدر SGML. .LP ضُبط زوج السمة/القيمة "output=txt" للشروط. .LP \fBlinuxdoc \-B txt\fP يقبل خيارات الخلفية التالية: \fB[\-\-manpage] [\-\-filter] [\-\-blanks=\fP\fIn\fP\fB]\fP .LP معنى هذه الخيارات هو: .IP "\-\-manpage, \-m" يخرج ملف مصدر groff، مناسب للتنسيق باستخدام \fBgroff \-man\fP لصفحات الدليل .IP "\-\-filter, \-f" إزالة الكتابة الفوقية بمسافة للخلف من النموذج الوسيط المولد بواسطة \fBgroff\fP(1). .IP "\-\-pass, \-P" يُضاف معامل خيار التمرير (pass) إلى خيارات سطر الأوامر المسلمة إلى \fBgroff\fP(1). .IP "\-\-blanks=\fIn\fP، \-b" اضبط حد الأسطر الفارغة المتتالية لتوليد مستند المخرجات. الحد المبدئي هو 3. إذا حُدد 0 (صفر)، فستحتوي النتيجة على العديد من الأسطر الفارغة المتتالية. .LP **************************************************** .LP \fBlinuxdoc \-B check \fP (sgmlcheck) يشغل تحليل SGML على مصدر المستند المحدد. تُبلغ أي أخطاء إلى المخرج القياسي. لا يُنتج نسخة منسقة من المصدر. .LP لاحظ أن \fBlinuxdoc \-B check\fP يقوم بمعالجة مسبقة لمصدر SGML الخاص بـ LinuxDoc DTD، حيث يقوم بتطبيق الشروط المحددة بواسطة أي علامات <#if> و <#unless>. ستؤدي مصادر المستندات التي تحتوي على هذه العلامات إلى إرباك محلل SGML المستقل. \fBlinuxdoc \-B check\fP لا يحتوي على خيارات خاصة بالخلفية. **************************************************** .SH الملفات تُستخدم العديد من الملفات والملفات التنفيذية في /usr/share/linuxdoc\-tools و /usr/bin. .SH العلل ربما بقي بعضها. لا تتردد في إرسال تقريرك إلى المشرف الحالي. .SH الصائن تمت صيانة هذا بواسطة Cees de Groot في SGML\-Tools (v1) و Taketoshi Sano لـ Linuxdoc\-Tools. يُصان حالياً بواسطة Agustin Martin . .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .