groff_me(7)

الاسم
groff_me - حزمة وحدات ماكرو “me” لتنسيق مستندات roff

موجز
groff -me [option ...] [file ...]
groff -m me [option ...] [file ...]

الوصف
يُعد تطبيق GNU لحزمة وحدات ماكرو me جزءًا من نظام تنسيق المستندات groff. توفر حزمة me لتعريفات وحدات الماكرو للغة roff وسيلة ملائمة لإعداد الأوراق التقنية بتنسيقات مختلفة. تعتمد هذه النسخة على me الموزعة مع 4.4BSD ويمكن استخدامها مع منسق GNU troff بالإضافة إلى المنسقات المشتقة من AT&T troff.

تؤثر بعض طلبات المنسق على تخطيط الصفحة بشكل غير متوقع عند استخدامها مع هذه الحزمة؛ ومع ذلك، يمكن استخدام ما يلي دون خوف بعد أول استدعاء لوحدة ماكرو فقرات مثل lp أو pp. بعض المعطيات اختيارية؛ انظر groff(7) للتفاصيل، لا سيما الطلبات التي تُحدد قائمة معطياتها بحذف. تُميز النجمة * امتدادات groff.

ad | c | ضبط وضع ضبط النص على c
af | r f | تعيين التنسيق f للمسجل r
am | m e | إلحاق بوحدة الماكرو m حتى يُستدعى e
as | s t | إلحاق بقية السطر t بالسلسلة s
bp | n | بدء صفحة رئيسة مرقمة بـ n
br |  | كسر سطر الخرج
ce | n | توسيط أسطر المدخلات المنتجة n التالية
cp | n | تفعيل/تعطيل وضع توافق AT&T troff*
de | m e | تعريف وحدة الماكرو m حتى يُستدعى e
do | t | تفسير المدخلات t مع إيقاف وضع التوافق*
ds | s t | تعريف بقية السطر t كسلسلة نصية s
el | t | تفسير t إذا كانت p لوحدة ie المقابلة خاطئة
fc | c d | ضبط محدد الحقل c وعلامة الحشو d
fi |  | تفعيل الملء
hc | c | ضبط محرف الوصل على c
hy | m | ضبط وضع الوصل الآلي على m
ie | p t | مثل if، ولكن تفعيل تفسير el اللاحقة
if | p t | إذا تحقق الشرط p، فسر بقية السطر t
in | h | ضبط الإزاحة البادئة على المسافة h
lc | c | ضبط علامة تكرار القائد على c
ls | n | ضبط تباعد الأسطر على n
mc | c h | ضبط علامة الهامش (الأيمن) على c عند المسافة h
mk | r | تحديد الموضع العمودي في المسجل r
na |  | تعطيل ضبط النص
ne | v | الحاجة لمساحة عمودية بمسافة v
nf |  | تعطيل الملء
nh |  | تعطيل الوصل الآلي
nr | r n i | تعيين القيمة n للمسجل r مع زيادة آلية بمقدار i
ns |  | بدء وضع عدم المساحة
pl | v | ضبط طول الصفحة على v
pn | n | ضبط رقم الصفحة التالية على n
po | h | ضبط إزاحة الصفحة على h
rj | n | حاذِ لليمين n من أسطر الإدخال المنتجة التالية*
rm | m | أزل الماكرو، أو السلسلة، أو الطلب m
rn | m n | غيّر اسم الماكرو، أو السلسلة، أو الطلب m إلى n
rr | r | أزل السجل r
rs |  | استأنف التباعد (أنهِ وضع 'لا مسافات')
rt | v | عُد إلى الموضع العمودي المحدد بواسطة mk، أو v
so | f | ضمّن (استيفاء) ملف الإدخال f
sp | n | أدرج n من الأسطر من المسافة العمودية
ta | ... | اضبط علامات التبويب
tc | c | اضبط محرف تكرار التبويب إلى c
ti | h | اضبط الإزاحة المؤقتة (للسطر التالي فقط) إلى h
tl | ... | أخرج عنواناً من ثلاثة أجزاء
tr | ... | ترجم المحارف
ul | n | ضع خطاً تحت n من أسطر الإدخال المنتجة التالية

باستثناء صفحات العناوين (التي تُنتج باستدعاء tp)، يعطل me إخراج المسافة العمودية في أعلى الصفحات (بعد إخراج أي ترويسة صفحة)؛ وبالتالي فإن طلب sp لا يعمل هناك. يمكنك بدلاً من ذلك استدعاء bl أو تضمين طلب التباعد المطلوب في تحويلة، على سبيل المثال باستدعاء (b و )b. يعترض me أيضاً طلب ll؛ راجع “دليل مرجع me” للتفاصيل.

  نطاق الأسماء
تتبع الكائنات في me اصطلاح تسمية صارماً. لتجنب التعارض، يجب أن تكون أي أسماء سجلات أو سلاسل أو ماكرو يحددها المستخدم أرقاماً مفردة أو أحرفاً كبيرة، أو أي تسلسل أطول من الأحرف والأرقام يحتوي على حرف كبير واحد على الأقل. (للقابلية للنقل بين BSD و groff me، قيد الأسماء بحرفين، وتجنب الاسم [ (القوس المربع الأيسر).) يجب أيضاً عدم إعادة استخدام الأسماء التي تستخدمها أي معالجات مسبقة قيد الاستخدام.

  ماكرو
$0 | خطاف ما بعد عنوان القسم
$1 | خطاف ما قبل القسم بعمق 1
$2 | خطاف ما قبل القسم بعمق 2
$3 | خطاف ما قبل القسم بعمق 3
$4 | خطاف ما قبل القسم بعمق 4
$5 | خطاف ما قبل القسم بعمق 5
$6 | خطاف ما قبل القسم بعمق 6
$C | خطاف ما بعد عنوان الفصل
$H | خطاف ترويسة الصفحة/العمود
$c | أخرج رقم الفصل وعنوانه
$f | أخرج التذييل
$h | أخرج الترويسة
$p | أخرج عنوان القسم
$s | أخرج فاصل منطقة الحاشية السفلية
(b | ابدأ الكتلة
(c | ابدأ كتلة موسطة
(d | ابدأ نصاً مؤجلاً
(f | ابدأ حاشية سفلية
(l | ابدأ قائمة
(q | ابدأ اقتباساً طويلاً
(x | ابدأ مدخل فهرس
(z | ابدأ حفظاً عائماً
)b | أنهِ الكتلة
)c | أنهِ الكتلة الموسطة
)d | أنهِ النص المؤجل
)f | أنهِ الحاشية السفلية
)l | أنهِ القائمة
)q | أنهِ الاقتباس الطويل
)x | أنهِ مدخل الفهرس
)z | إنهاء الحفظ العائم
++ | تعيين نوع قطعة المستند
+c | بدء فصل
1c | إنهاء تخطيط الأعمدة المتعددة
2c | بدء تخطيط الأعمدة المتعددة
EN | إنهاء معادلة eqn
EQ | بدء معادلة eqn
GE | إنهاء صورة grn مع جعل موضع الرسم في الأسفل
GF | إنهاء صورة grn مع جعل موضع الرسم في الأعلى
GS | بدء صورة grn
IE | إنهاء صورة ideal مع جعل موضع الرسم في الأسفل
IF | إنهاء صورة ideal مع جعل موضع الرسم في الأعلى
IS | بدء صورة ideal
PE | إنهاء صورة pic مع جعل موضع الرسم في الأسفل
PF | إنهاء صورة pic مع جعل موضع الرسم في الأعلى
PS | بدء صورة pic
TE | إنهاء جدول tbl
TH | إنهاء ترويسة جدول tbl متعدد الصفحات
TS | بدء جدول tbl
b | جعل المعطى عريضًا
ba | تعيين الإزاحة الأساسية
bc | بدء عمود جديد
bi | جعل المعطى عريضًا ومائلًا
bx | وضع المعطى في صندوق
ef | تعيين تذييل الصفحة زوجية الرقم
eh | تعيين ترويسة الصفحة زوجية الرقم
ep | إنهاء الصفحة
fo | تعيين التذييل
he | تعيين الترويسة
hl | رسم خط أفقي
hx | كبح ترويسات/تذييلات الصفحة التالية
i | جعل المعطى مائلًا
ip | بدء فقرة مزاحة
ld | إعادة ضبط مسجلات وسلاسل التوطين والتاريخ *
ll | تعيين طول السطر
lp | بدء فقرة محاذات لليسار بالكامل
np | بدء فقرة مرقمة
of | تعيين تذييل الصفحة فردية الرقم
oh | تعيين ترويسة الصفحة فردية الرقم
pd | إخراج النص المؤجل
pp | بدء فقرة مزاحة في السطر الأول
q | اقتباس المعطى
r | تعيين المعطى بالخط الروماني
re | إعادة ضبط علامات الجدولة
sh | بدء قسم مرقم
sm | تعيين المعطى بحجم خط أصغر
sx | تغيير عمق القسم
sz | تعيين حجم الخط والتباعد العمودي
tp | بدء صفحة العنوان
u | تسطير المعطى
uh | بدء قسم غير مرقم
xl | ضبط طول السطر (للبيئة الحالية فقط)
xp | إخراج الفهرس

تُوفر بعض وحدات الماكرو للتوافق مع roff(1) "القديم". يصف "me دليل المرجع" بدائل للمستندات الحديثة.

ar | استخدام الأرقام العربية لأرقام الصفحات
bl | إدراج مسافة (حتى في أعلى الصفحة؛ قارن sp)
ix | ضبط الإزاحة بدون فاصل
m1 | ضبط المسافة من أعلى الصفحة إلى الترويسة
m2 | ضبط المسافة من الترويسة إلى النص
m3 | ضبط المسافة من النص إلى التذييل
m4 | ضبط المسافة من التذييل إلى أسفل الصفحة
n1 | بدء ترقيم أسطر المخرجات
n2 | إنهاء أو تغيير ترقيم أسطر المخرجات
pa | بدء الصفحة
ro | استخدام الأرقام الرومانية لأرقام الصفحات
sk | تخطي الصفحة التالية

  المسجلات
$0 | عمق القسم
$1 | مكون رقم القسم الأول
$2 | مكون رقم القسم الثاني
$3 | مكون رقم القسم الثالث
$4 | مكون رقم القسم الرابع
$5 | مكون رقم القسم الخامس
$6 | مكون رقم القسم السادس
$c | رقم العمود الحالي
$d | رقم النص المؤجل
$f | رقم الحاشية
$i | الإزاحة الأساسية للفقرة
$l | عرض العمود
$m | عدد الأعمدة المتاحة
$p | رقم الفقرة المرقمة
$s | تباعد الأعمدة (الإزاحة)
bi | إزاحة العرض (الكتلي)
bm | المسافة من منطقة النص إلى أسفل الصفحة
bs | المسافة قبل/بعد العرض (الكتلي)
bt | عتبة الكتلة للاحتفاظ
ch | رقم الفصل الحالي
df | خط العرض
dv | التباعد العمودي للنص المعروض (كنسبة مئوية)*
es | المسافة قبل/بعد المعادلة
ff | خط الحاشية
fi | إزاحة الحاشية (السطر الأول فقط)
fm | هامش التذييل
fp | حجم خط الحاشية بالنقاط
fs | المسافة قبل الحاشية
fu | إزاحة الحاشية العكسية (الإزاحة اليمنى)
hm | هامش الترويسة
ii | إزاحة الفقرة المزاحة
no | إزاحة ترقيم الأسطر*
pf | خط الفقرة
pi | إزاحة الفقرة
po | إزاحة الصفحة
pp | حجم خط الفقرة بالنقاط
ps | المسافة قبل الفقرة
qi | إزاحة الاقتباس الطويل يساراً/يميناً
qp | حجم خط الاقتباس الطويل بالنقاط
qs | المسافة قبل/بعد الاقتباس الطويل
sf | خط عنوان القسم
si | إزاحة القسم لكل مستوى عمق
so | إزاحة إضافية لعنوان القسم
sp | حجم خط عنوان القسم بالنقاط
ss | المسافة البادئة للقسم
sx | زيادة ارتفاع سطر الكتابة الفوقية/التحتية*
tf | خط العنوان
tm | المسافة من أعلى الصفحة إلى منطقة النص
tp | حجم خط العنوان بالنقاط
tv | التباعد العمودي للنص (كنسبة مئوية)*
xs | المسافة البادئة لمدخلة الفهرس
xu | سحب الفهرس (إزاحة يمنى)
y2 | سنة القرن*
y4 | السنة*
yr | السنة ناقص 1900
zs | المسافة قبل/بعد حفظ العناصر العائمة

  سلاسل نصية
# | علامة النص المؤجل
$n | رقم القسم المتسلسل
* | علامة الحاشية السفلية
- | وصلة طويلة (em dash)
< | بدء الكتابة التحتية
> | إنهاء الكتابة التحتية
dw | اسم يوم الأسبوع
lq | علامة الاقتباس المزدوجة اليسرى
شهور | اسم الشهر
rq | علامة الاقتباس المزدوجة اليمنى
td | التاريخ
wa | مصطلح “الملحق” المستخدم بواسطة .$c*
wc | مصطلح “الفصل” المستخدم بواسطة .$c*
{ | بدء الكتابة الفوقية
} | إنهاء الكتابة الفوقية

الملفات

/usr/share/groff/1.24.1/tmac/e.tmac
    تُنفذ الحزمة.

/usr/share/groff/1.24.1/tmac/refer-me.tmac
    تُنفذ دعم refer(1) لـ me.

/usr/share/groff/1.24.1/tmac/me.tmac
    هو غلاف يُمكن من تحميل الحزمة بالخيار “-m me”.

ملاحظات
حصرت بعض حزم ماكرو roff المبكرة أسماءها في حرف واحد، يتبع خيار المنسق m، مما نتج عنه “أسماء” مثل -mm و -ms و -mv و -mn. يرمز حرف “e” في me إلى “Eric P. Allman”، مؤلف حزمة الماكرو الأصلية والأوراق التقنية التي توثقها.

انظر أيضاً
يتوفر دليلان في شكل مصدر وشكل مُصيّر. قد تكون مضغوطة على نظامك و/أو متوفرة بتنسيقات إضافية.

/usr/share/doc/groff-1.24.1/meintro.me
/usr/share/doc/groff-1.24.1/meintro.ps
    هو “كتابة الأوراق باستخدام Groff باستعمال -me”، بقلم Eric P. Allman، طوّعه لـ groff James Clark.

/usr/share/doc/groff-1.24.1/meref.me
/usr/share/doc/groff-1.24.1/meref.ps
    هو “دليل مرجع me”، بقلم Eric P. Allman، طوّعه لـ groff كل من James Clark و G. Branden Robinson.

Groff: The GNU Implementation of troff، من تأليف Trent A. Fisher و Werner Lemberg، هو دليل groff الأساسي. يمكنك تصفحه تفاعليًا باستخدام “info groff”.

للمعالجات المسبقة التي تدعمها me، انظر eqn(1), و grn(1), و pic(1), و refer(1), و tbl(1).

groff(1), troff(1), groff(7)

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

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

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