GS(1)

الاسم
gs - ‏Ghostscript (مفسر ومعاين للغتي PostScript و PDF)

موجز
gs [ الخيارات ] [ الملفات ] ...

الوصف
يستدعي الأمر gs برنامج Ghostscript، وهو مفسر للغتي PostScript(tm) و Portable Document Format (PDF) من شركة Adobe Systems. يقرأ gs "الملفات" بالتسلسل وينفذها كبرامج Ghostscript. بعد القيام بذلك، يقرأ المزيد من المدخلات من تدفق الإدخال القياسي (عادةً لوحة المفاتيح)، مفسرًا كل سطر على حدة ويخرجه إلى جهاز إخراج (قد يكون ملفًا أو معاينة نافذة X11، انظر أدناه). يخرج المفسر بسلام عندما يواجه أمر "quit" (سواء في ملف أو من لوحة المفاتيح)، أو عند نهاية الملف، أو عند إشارة مقاطعة (مثل Control-C من لوحة المفاتيح).

يتعرف المفسر على العديد من مبدلات الخيارات، ويوصف بعضها أدناه. يُرجى مراجعة توثيق الاستخدام للحصول على معلومات كاملة. قد تظهر المبدلات في أي مكان في سطر الأوامر وتطبق على كافة الملفات التي تليها. يؤدي استدعاء Ghostscript بالمبدل -h أو -? إلى إنتاج رسالة تعرض عدة مبدلات مفيدة، وجميع الأجهزة المعروفة لذلك الملف التنفيذي، ومسار البحث عن الخطوط؛ كما يعرض في Unix موقع التوثيق المفصل.

قد يُبنى Ghostscript لاستخدام العديد من أجهزة الإخراج المختلفة. لرؤية الأجهزة التي يتضمنها ملفك التنفيذي، شغل "gs -h".

ما لم تحدد جهازًا معينًا، يفتح Ghostscript عادةً الجهاز الأول منها ويوجه الإخراج إليه.

إذا ثبت حزمة ghostscript-x في Debian وكنت تستخدم X، فإن الجهاز المبدئي هو نافذة X11 (للمعاينة)، وإلا فسيستخدم ghostscript جهاز bbox ويطبع أبعاد ملف postscript على المخرج القياسي (stdout).

لذا إذا كان الجهاز الأول في القائمة هو الذي تريد استخدامه، فما عليك سوى إصدار الأمر

	gs myfile.ps

يمكنك أيضًا التحقق من مجموعة الأجهزة المتاحة من داخل Ghostscript: استدعِ Ghostscript واكتب

	devicenames ==

ولكن قد لا يكون الجهاز الأول في القائمة الناتجة هو الجهاز المبدئي الذي حددته باستخدام "gs -h". لتحديد "AbcXyz" كجهاز إخراج أولي، ضمن المبدل

	-sDEVICE=AbcXyz

على سبيل المثال، للإخراج إلى طابعة Epson قد تستخدم الأمر

	gs -sDEVICE=epson myfile.ps

يجب أن يسبق المبدل "-sDEVICE=" أول ذكر لملف يراد طباعته، ولن يكون للمبدل أثر إلا عند استخدامه لأول مرة.

أخيرًا، يمكنك تحديد جهاز مبدئي في متغير البيئة GS_DEVICE. ترتيب الأسبقية لهذه البدائل من الأعلى إلى الأدنى (يستخدم Ghostscript الجهاز المعرف في أعلى القائمة) هو:

   setpagedevice
   (سطر الأوامر)
   GS_DEVICE
   (أول جهاز في قائمة البناء)

تدعم بعض الأجهزة دقات (كثافات) مختلفة. لتحديد الدقة على مثل هذا الجهاز، استخدم المبدل "-r":

	gs -sDEVICE=<الجهاز> -r<دقة_س>x<دقة_ص>

على سبيل المثال، في طابعة متوافقة مع Epson ذات 9 دبابيس، ستحصل على وضع الكثافة الأدنى (الأسرع) عبر

	gs -sDEVICE=epson -r60x72

ووضع الكثافة الأعلى (أفضل جودة إخراج) عبر

	gs -sDEVICE=epson -r240x72.

إذا اخترت طابعة كجهاز إخراج، يسمح لك Ghostscript أيضًا باختيار المكان الذي يرسل إليه Ghostscript المخرجات -- في أنظمة Unix، تكون عادةً إلى ملف مؤقت. لإرسال المخرجات إلى ملف باسم "foo.xyz"، استخدم المبدل

	-sOutputFile=foo.xyz

قد ترغب في طباعة كل صفحة على حدة. للقيام بذلك، أرسل المخرجات إلى سلسلة من الملفات "foo1.xyz, foo2.xyz, ..." باستخدام المبدل "-sOutputFile=" مع "%d" في قالب اسم الملف:

	-sOutputFile=foo%d.xyz

يستقبل كل ملف ناتج صفحة واحدة من المخرجات، وتُرقم الملفات في تسلسل. "%d" هو توصيف تنسيق printf؛ يمكنك أيضًا استخدام بديل مثل "%02d".

يمكنك أيضًا إرسال المخرجات إلى أنبوب. على سبيل المثال، لتوجيه المخرجات إلى أمر "lpr" (الذي يوجهها إلى طابعة في العديد من أنظمة Unix)، استخدم الخيار

	-sOutputFile=%pipe%lpr

يمكنك أيضًا إرسال المخرجات إلى الخرج القياسي:

	-sOutputFile=-
أو
	-sOutputFile=%stdout%

في هذه الحالة يجب عليك أيضًا استخدام المبدل -q لمنع Ghostscript من كتابة الرسائل إلى الخرج القياسي.

لاختيار حجم ورق محدد، استخدم مبدل سطر الأوامر

	-sPAPERSIZE=<حجم_الورق>

على سبيل المثال

	-sPAPERSIZE=a4
أو
	-sPAPERSIZE=legal

تُعرف معظم أحجام الورق التابعة لـ ISO و US. انظر توثيق الاستخدام للقائمة الكاملة، أو التعريفات في ملف التهيئة "gs_statd.ps".

يمكن لبرنامج Ghostscript القيام بأشياء كثيرة غير طباعة أو عرض ملفات PostScript و PDF. على سبيل المثال، إذا كنت تريد معرفة الإطار المحيط (bounding box) لملف PostScript (أو EPS)، يوفر Ghostscript "جهازًا" خاصًا يطبع هذه المعلومات فقط.

على سبيل المثال، باستخدام أحد ملفات الأمثلة الموزعة مع Ghostscript،

	gs -sDEVICE=bbox golfer.ps

يطبع

	%%BoundingBox: 0 25 583 732
	%%HiResBoundingBox: 0.808497 25.009496 582.994503 731.809445

الخيارات

-- filename arg1 ...
    يأخذ المعامل التالي كاسم ملف كالمعتاد، ولكنه يأخذ جميع المعاملات المتبقية (حتى لو كان لها الشكل النحوي للمبدلات) ويعرف الاسم "ARGUMENTS" في "userdict" (وليس "systemdict") كمصفوفة من تلك السلاسل، قبل تشغيل الملف. عندما ينتهي Ghostscript من تنفيذ الملف، يخرج عائدًا إلى الـ صدفة.

-Dname=token
-dname=token
    يعرف اسمًا في "systemdict" بالتعريف المعطى. يجب أن تكون الرمزية (token) رمزية واحدة بالضبط (كما هو معرف بواسطة معامل "token") ولا يجوز أن تحتوي على مسافات بيضاء.

-Dname
-dname
    يعرف اسمًا في "systemdict" بقيمة خالية (null).

-Sname=string
-sname=string
    يعرف اسمًا في "systemdict" بسلسلة معطاة كقيمة. هذا يختلف عن -d. على سبيل المثال، -dname=35 يعادل قطعة البرنامج التالية
      /name 35 def
    بينما -sname=35 يعادل
      /name (35) def

-P  يجعل Ghostscript يبحث أولاً في الدليل الحالي عن ملفات المكتبة. آليًا، لم يعد Ghostscript يبحث في الدليل الحالي، إلا إذا كان الدليل الأول المزود صراحة هو "." في -I. انظر أيضًا قسم ملفات التهيئة أدناه، وملف Use.htm المرفق لمناقشة مفصلة حول مسارات البحث وكيفية عثور Ghostscript على الملفات.

-q  بدء تشغيل هادئ: يكتم رسائل بدء التشغيل العادية، ويقوم أيضًا بما يعادل -dQUIET.

-gnumber1xnumber2
    يعادل -dDEVICEWIDTH=number1 و -dDEVICEHEIGHT=number2. هذا مخصص للأجهزة (مثل نوافذ X11) التي تتطلب (أو تسمح) بتحديد العرض والارتفاع.

-rnumber
-rnumber1xnumber2
    يعادل -dDEVICEXRESOLUTION=number1 و -dDEVICEYRESOLUTION=number2. هذا مخصص للأجهزة مثل الطابعات التي تدعم دقات X و Y متعددة. إذا أُعطي رقم واحد فقط، فسيُستخدم لكل من دقتي X و Y.

-Idirectories
    يضيف قائمة الأدلة المحددة في مقدمة مسار البحث عن ملفات المكتبة.

-   هذا ليس مبدلاً فعليًا، ولكنه يشير لـ Ghostscript أن الدخل القياسي قادم من ملف أو أنبوب وليس بشكل تفاعلي من سطر الأوامر. يقرأ Ghostscript من الدخل القياسي حتى يصل إلى نهاية الملف، وينفذه كأي ملف آخر، ثم يواصل معالجة سطر الأوامر. عندما يُعالج سطر الأوامر بالكامل، يخرج Ghostscript بدلاً من الدخول في وضعه التفاعلي.

لاحظ أن ملف التهيئة العادي "gs_init.ps" يجعل "systemdict" للقراءة فقط، لذا لا يمكن تغيير قيم الأسماء المعرفة بـ -D أو -d أو -S أو -s (على الرغم من أنه يمكن بالطبع استبدالها بتعريفات في "userdict" أو قواميس أخرى).

أسماء خاصة

-dNOCACHE
    يعطل عمل الـ خبيئة للمحارف. مفيد فقط لأغراض الـ تنقيح.

-dNOBIND
    يعطل المعامل "bind". مفيد فقط لأغراض الـ تنقيح.

-dNODISPLAY
    يكتم التهيئة العادية لجهاز الإخراج. قد يكون هذا مفيدًا عند الـ تنقيح.

-dNOPAUSE
    يعطل المطالبة والتوقف المؤقت عند نهاية كل صفحة. قد يكون هذا مرغوبًا للتطبيقات حيث يقوم برنامج آخر بقيادة Ghostscript.

-dNOPLATFONTS
    يعطل استخدام الخطوط المزودة من قبل المنصة الأساسية (مثل X11). قد يكون هذا مطلوبًا إذا كانت خطوط المنصة تبدو مختلفة بشكل غير مرغوب فيه عن الخطوط القابلة للتوسيع.

-dSAFER
    يُقيّد عمليات الملفات التي يمكن للمهمة تنفيذها. أصبح هذا هو الوضع المبدئي للتشغيل حاليًا.

-dWRITESYSTEMDICT
    يترك "systemdict" قابلًا للكتابة. هذا ضروري عند تشغيل برامج أدوات خاصة، لكن لا يُنصح به بشدة لأنه يتجاوز تدابير أمان Postscript العادية.

-sDEVICE=الجهاز
    يختار جهاز إخراج مبدئي بديل، كما هو موضح أعلاه.

-sOutputFile=اسم_الملف
    يختار ملف إخراج بديل (أو أنبوب) لجهاز الإخراج المبدئي، كما هو موضح أعلاه.

الوضع الأكثر أمانًا (SAFER)

يُقيّد الخيار -dSAFER الوصول إلى نظام الملفات في تلك الملفات والدلائل المسموح بها بواسطة متغيرات البيئة ذات الصلة (مثل GS_LIB) أو بواسطة معاملات سطر الأوامر (راجع https://ghostscript.com/doc/current/Use.htm لمزيد من التفاصيل).

أصبح وضع SAFER الآن هو وضع التشغيل المبدئي. لذا عند تشغيل برامج تحتاج إلى فتح ملفات أو ضبط معاملات مقيدة، يجب عليك تمرير خيار سطر الأوامر -dNOSAFER أو مرادفه -dDELAYSAFER.

إن التشغيل باستخدام NOSAFER/DELAYSAFER (كما يوحي الاسم) يُخفف من الأمان، وبالتالي يُنصح به فقط لأغراض التنقيح أو في تدفقات العمل الخاضعة لرقابة شديدة، ولا يُنصح به بشدة في أي ظروف أخرى.

الملفات

تُصرّف مواقع العديد من ملفات Ghostscript في وقت التشغيل داخل الملف التنفيذي عند بنائه. شغّل "gs -h" للعثور على موقع وثائق Ghostscript في نظامك، والتي يمكنك من خلالها الحصول على مزيد من التفاصيل. في نظام Debian، توجد هذه الملفات في /usr.

/usr/share/ghostscript/[0-9]*.[0.9]*/*
    ملفات البدء، والأدوات، وتعاريف الخطوط الأساسية (حيث [0-9]*.[0.9]* هو إصدارة ghostscript)

/usr/share/fonts/type1/gsfonts/*
    المزيد من تعاريف الخطوط من حزمة gsfonts

/usr/share/doc/ghostscript/examples/*
    ملفات Ghostscript التوضيحية (إذا كانت حزمة ghostscript-doc مثبتة)

/usr/share/doc/ghostscript/*
    ملفات وثائق متنوعة (قد تحتاج إلى تثبيت حزمة ghostscript-doc)

ملفات التهيئة
عند البحث عن ملفات التهيئة "gs_*.ps"، أو الملفات المتعلقة بالخطوط، أو ملف معامل "run"، يحاول Ghostscript أولاً فتح الملف بالاسم المعطى، مستخدمًا دليل العمل الحالي إذا لم يُحدد دليل. إذا فشل ذلك، ولم يحدد اسم الملف دليلاً أو محرك أقراص صريحًا (على سبيل المثال، لا يحتوي على "/" في أنظمة Unix)، فسيحاول Ghostscript تجربة الدلائل بهذا التسلسل:

1.  الدلائل المحددة بواسطة مفاتيح -I في سطر الأوامر، إن وجدت؛

2.  الدلائل المحددة بواسطة متغير البيئة GS_LIB، إن وجدت؛

3.  الدلائل المحددة بواسطة ماكرو GS_LIB_DEFAULT في ملف makefile الخاص بـ Ghostscript عند بناء الملف التنفيذي. ويكون GS_LIB_DEFAULT هو "/usr/share/ghostscript/[0-9]*.[0-9]*/lib" في نظام Debian حيث تمثل "[0-9]*.[0-9]*" رقم إصدارة Ghostscript

كل من هذه (معاملات GS_LIB_DEFAULT و GS_LIB و -I) قد يكون إما دليلاً واحدًا أو قائمة من الدلائل مفصولة بـ ":".

البيئة

GS_OPTIONS
    سلسلة نصية من الخيارات تُعالج قبل خيارات سطر الأوامر

GS_DEVICE
    يُستخدم لتحديد جهاز إخراج

GS_FONTPATH
    أسماء المسارات المستخدمة للبحث عن الخطوط

GS_LIB
    أسماء المسارات لملفات التهيئة والخطوط

TEMP
    مكان إنشاء الملفات المؤقتة

موارد X
يبحث Ghostscript، أو بشكل أدق جهاز عرض X11، عن الموارد التالية تحت اسم البرنامج "Ghostscript":

borderWidth
    عرض الحدود بالبكسل (المبدئي = 1).

borderColor
    اسم لون الحدود (المبدئي = أسود).

geometry
    حجم النافذة وموضعها، WxH+X+Y (المبدئي هو NULL).

xResolution
    عدد بكسلات x لكل بوصة (يُحسب المبدئي من WidthOfScreen و WidthMMOfScreen).

yResolution
    عدد بكسلات y لكل بوصة (يُحسب المبدئي من HeightOfScreen و HeightMMOfScreen).

useBackingPixmap
    يحدد ما إذا كان سيُستخدم التخزين الاحتياطي لحفظ نافذة العرض (المبدئي = true).

راجع مستند الاستخدام للحصول على قائمة أكثر اكتمالاً للموارد. لضبط هذه الموارد على Unix، ضعها في ملف مثل /fI~/.Xresources/fR بالشكل التالي:

	Ghostscript*geometry:	 612x792-0+0
	Ghostscript*xResolution: 72
	Ghostscript*yResolution: 72

ثم ادمج هذه الموارد في قاعدة بيانات موارد خادم X:

	% xrdb -merge ~/.Xresources

انظر أيضًا
ملفات وثائق Ghostscript المتنوعة (أعلاه)، وخاصة Use.htm. في نظام Debian، قد تحتاج إلى تثبيت ghostscript-doc قبل قراءة الوثائق.

العلل
انظر http://bugs.ghostscript.com/ ومجموعة أخبار يوزنت comp.lang.postscript.

الإصدارة
نُقح هذا المستند لآخر مرة لإصدار Ghostscript رقم 10.04.0.

المؤلف
تُعد شركة Artifex Software, Inc. هي القائم الرئيس على صيانة Ghostscript. ورسل جيه لانج (Russell J. Lang)، عبر gsview at ghostgum.com.au، هو مؤلف معظم كود MS Windows في Ghostscript.

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.