.TH "GROFF" "1" "مه ۲۰۲۵" "groff" "دستورهای کاربری"
.\" Define fallback for groff 1.23's MR macro if the system lacks it.
.nr do-fallback 0
.if !\n(.f           .nr do-fallback 1 \" mandoc
.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
.if \n[do-fallback]  \{\
.  de MR
.    ie \\n(.$=1 \
.      I \%\\$1
.    el \
.      IR \%\\$1 (\\$2)\\$3
.  .
.\}
.rr do-fallback
.
.\" Define a string for the TeX logo.
.ie t .ds TeX T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X
.el   .ds TeX TeX
.
.SH "نام (NAME)"
groff \- رابط اصلی و پیشخوان سامانه حروفچینی متنی GNU roff
.
.SH "خلاصه دستور (SYNOPSIS)"
\fBgroff\fP [ \fIگزینهها\fP... ] [ \fIفایل\fP... ]
.
.SH "توضیحات (DESCRIPTION)"
دستور \fBgroff\fR رابط و اجراکننده اصلی سامانه حروفچینی و قالببندی مستندات GNU roff است.
.PP
سامانه
.I GNU roff
یک سیستم حروفچینی پیشرفته است که فایل‌های متنی ساده حاوی دستورات قالب‌بندی را خوانده و خروجی‌هایی در قالب‌های
PostScript،
PDF،
HTML،
DVI
یا دیگر قالب‌ها، و یا برای نمایش مستقیم در ترمینال تولید می‌کند.
.PP
دستورات قالب‌بندی می‌توانند دستورات پایه و اولیه حروفچینی (primitives)،
ماکروهای تعریف‌شده در بسته‌های استاندارد، یا ماکروهای سفارشی نوشته‌شده توسط کاربر باشند.
می‌توان هر سه روش را با یکدیگر ترکیب کرد.
.PP
اگر هیچ عملوند
.I فایلی
مشخص نشده باشد، یا مقدار
.I فایل
برابر با
.RB \[lq] \- \[rq]
باشد،
.I groff
جریان ورودی استاندارد (stdin) را پردازش می‌کند.
.PP
به عنوان یک پیاده‌سازی نوین و گسترش‌یافته از سیستم حروفچینی AT&T Unix،
برنامه
.I groff
به دلیل پیوند تاریخی و کهن خود با اسناد و صفحات راهنمای یونیکس، تقریباً در تمامی سیستم‌های سازگار با POSIX حضور دارد.
این نرم‌افزار و سامانه‌های پیشین آن نقش به‌سزایی در حروفچینی و انتشار چندین عنوان از پرفروش‌ترین کتاب‌های مرجع مهندسی نرم‌افزار جهان داشته‌اند.
.I groff
قادر است مستنداتی با نهایت ظرافت و کیفیت تایپوگرافی تولید کند، در حالی که کمترین میزان از حافظه و پردازش سیستم را مصرف می‌نماید.
.PP
فرمان
.I groff
وظیفه مدیریت و هماهنگی اجرای پیش‌پردازنده‌ها، تبدیل اسناد ورودی به یک زبان توصیف صفحه مستقل از دستگاه، و در نهایت تولید خروجی نهایی از آن زبان را بر عهده دارد.
.
.SH "گزینه‌ها (OPTIONS)"
.B \-h
و
.B \-\-help
پیام راهنمای استفاده از دستور را نمایش داده و خارج می‌شوند.
.PP
از آنجا که هدف از طراحی
.I groff
پوشش و مدیریت اکثر فراخوانی‌های مستقیم قالب‌بند
.MR \%troff 1
توسط کاربران است، این دو برنامه گزینه‌های مشترک متعددی دارند.
با این حال،
.I groff
دارای گزینه‌هایی اختصاصی است که در
.I \%troff
وجود ندارند، و گزینه‌هایی دیگر را نیز به شکلی متفاوت تفسیر می‌کند.
در عین حال، تمامی گزینه‌های معتبر
.I \%troff
را نمی‌توان مستقیماً به
.I groff
ارسال کرد.
.
.SS "گزینه‌های اختصاصی groff (groff-specific options)"
گزینه‌های زیر یا در
.I troff
گنو وجود ندارند یا توسط
.I groff
به شکلی متمایز تفسیر می‌شوند.
.
.TP
.BI \-D\~ enc
تنظیم کدگذاری ورودی جایگزین (fallback) مورد استفاده توسط
.MR preconv 1
به
.IR enc ؛
به صورت خودکار گزینه
.B \-k
را فعال می‌سازد.
.
.TP
.B \-e
اجرای پیش‌پردازنده فرمول‌های ریاضی
.MR \%eqn 1 .
.
.TP
.B \-g
اجرای پیش‌پردازنده نمودارهای گرملین
.MR \%grn 1 .
.
.TP
.B \-G
اجرای پیش‌پردازنده نمودارهای آماری
.MR grap 1 ؛
به صورت خودکار گزینه
.B \-p
را فعال می‌سازد.
.
.TP
.BI \-I\~ dir
مشابه گزینه
.I \%troff
عمل می‌کند (پایین‌تر توضیح داده شده است)، اما علاوه بر آن گزینه‌های
.B \-g
و
.B \-s
را نیز فعال می‌کند.
همچنین این مقدار به
.MR \%soelim 1
و درایور خروجی فرستاده می‌شود و پیش‌پردازنده
.I \%grn
نیز گزینه
.B \-M
را با شناسه
.I dir
دریافت می‌کند.
.
.TP
.B \-j
اجرای پیش‌پردازنده ساختارهای شیمیایی
.MR \%chem 1 ؛
به صورت خودکار گزینه
.B \-p
را فعال می‌سازد.
.
.TP
.B \-k
اجرای پیش‌پردازنده تبدیل کدگذاری
.MR preconv 1 .
در صورتی که هیچ‌یک از گزینه‌های
.B \-K
یا
.B \-D
تعیین نشده باشند، به صفحه راهنمای این ابزار مراجعه فرمایید تا از رفتار پیش‌فرض آن آگاه شوید.
.
.TP
.BI \-K\~ enc
تنظیم کدگذاری ورودی مورد استفاده توسط
.MR preconv 1
به
.IR enc ؛
به صورت خودکار گزینه
.B \-k
را فعال می‌سازد.
.
.TP
.B \-l
ارسال خروجی به یک برنامه اسپولر (spooler) جهت چاپ کاغذی.
دستور
.RB \[lq] print \[rq]
در فایل توصیف دستگاه، فرمان پیش‌فرض مورد استفاده برای چاپ را مشخص می‌کند؛ به
.MR groff_font 5
مراجعه کنید.
اگر چنین دستوری برای دستگاه خروجی تعریف نشده باشد، خروجی به برنامه
.MR lpr 1
فرستاده می‌شود.
گزینه‌های
.B \-L
و
.B \-X
را نیز ببینید.
.
.TP
.BI \-L\~ arg
ارسال شناسه
.I arg
به برنامه اسپولر چاپ.
اگر چندین شناسه مورد نیاز است، هر شناسه را با یک گزینه
.B \-L
جداگانه ارسال فرمایید.
برنامه
.I groff
پیش از ارسال
.I arg
به برنامه اسپولر، خط تیره سوییچ به آن اضافه نمی‌کند.
.
.TP
.B \-M
مشابه گزینه
.I \%troff
عمل می‌کند (پایین‌تر توضیح داده شده است)، اما علاوه بر آن به برنامه‌های
.MR \%eqn 1 ،
.MR grap 1
و
.MR \%grn 1
نیز فرستاده می‌شود.
.
.TP
.B \-N
ممنوعیت خطوط جدید (newline) میان جداکننده‌های
.IR eqn :
گزینه
.B \-N
را به
.MR \%eqn 1
ارسال می‌نماید.
.
.TP
.B \-p
اجرای پیش‌پردازنده رسم تصاویر و دیاگرام‌های
.MR \%pic 1 .
.
.TP
.BI \-P\~ arg
ارسال آرگومان
.I arg
به پس‌پردازنده (postprocessor).
اگر ارسال چندین آرگومان لازم باشد، هر یک را با یک گزینه
.B \-P
جداگانه مشخص کنید.
برنامه
.I groff
پیش از ارسال
.I arg
به پس‌پردازنده، خط تیره سوییچ به ابتدای آن اضافه نمی‌کند.
.
.TP
.B \-R
اجرای پیش‌پردازنده ارجاعات کتاب‌شناسی
.MR \%refer 1 .
هیچ سازوکاری برای ارسال آرگومان به
.I \%refer
تعبیه نشده است، زیرا بیشتر گزینه‌های
.I \%refer
دارای عناصر دستوری معادل در خود زبان هستند که می‌توان مستقیماً درون سند مشخص کرد.
.
.TP
.B \-s
اجرای پیش‌پردازنده الحاق فایل‌ها
.MR \%soelim 1 .
.
.TP
.B \-S
فعال‌سازی حالت «امن‌تر» (safer mode)؛ برای حالت معکوس آن به گزینه
.B \-U
در پایین مراجعه کنید.
به دلایل امنیتی، حالت امن به طور پیش‌فرض فعال است.
.
.TP
.B \-t
اجرای پیش‌پردازنده جدول‌های
.MR \%tbl 1 .
.
.TP
.BI \-T\~ dev
هدایت
.I \%troff
به قالب‌بندی ورودی برای دستگاه خروجی
.IR dev .
سپس
.I groff
یک درایور خروجی را جهت تبدیل خروجی
.I \%troff
به قالبی متناسب با
.I dev
فراخوانی می‌کند؛ به بخش «دستگاه‌های خروجی» در ادامه مراجعه کنید.
.
.TP
.B \-U
کار در حالت ناامن (unsafe): ارسال گزینه
.B \-U
به
.I \%pic
و
.IR \%troff .
.
.TP
.B \-v
.TQ
.B \-\-version
نوشتن اطلاعات نسخه
.I groff
و تمامی ابزارهای اجراشده توسط آن در جریان خروجی استاندارد؛ به این معنا که خط فرمان مانند روال معمول پردازش شده و گزینه
.B \-v
به قالب‌بند و هر یک از پیش‌پردازنده‌ها یا پس‌پردازنده‌های فراخوانی‌شده ارسال می‌گردد.
.
.TP
.B \-V
چاپ خط لوله (pipeline) دستوراتی که
.I groff
قصد اجرای آن‌ها را دارد در خروجی استاندارد، بدون اجرای واقعی آن‌ها.
اگر این گزینه بیش از یک بار درج شود،
.I groff
هم خط لوله را در خروجی می‌نویسد و هم آن را به مرحله اجرا درمی‌آورد.
.
.TP
.B \-X
استفاده از
.MR gxditview 1
به جای پس‌پردازنده معمولی برای پیش‌نمایش سند در یک نمایشگر گرافیکی X11.
ترکیب این گزینه با
.B \-Tps
از ویژگی‌ها و مقیاس‌های قلم دستگاه PostScript بهره می‌برد، در حالی که گزینه‌های
.B \-TX75
و
.B \-TX100
از مقیاس‌های قلم‌های سیستم پنجره‌ای X11 استفاده می‌کنند.
.
.TP
.B \-Z
غیرفعال‌سازی مرحله پس‌پردازش.
خروجی میانی
.I \%troff
مستقیماً در جریان خروجی استاندارد قرار می‌گیرد (مگر آنکه با گزینه
.B \-z
سرکوب شده باشد)؛ برای شرح این قالب به
.MR groff_out 5
مراجعه فرمایید.
.
.SS "گزینه‌های مستقیم (Transparent options)"
گزینه‌های زیر مستقیماً و بدون تغییر به برنامه قالب‌بند
.MR \%troff 1
منتقل می‌شوند و جزئیات دقیق‌تر آن‌ها در صفحه راهنمای آن آمده است.
.
.TP
.B \-a
تولید یک تقریب متنی ساده (plain text) از خروجی حروفچینی‌شده.
.
.TP
.B \-b
نوشتن ردگیری پشته (backtrace) در جریان خطای استاندارد به هنگام بروز هر خطا یا هشدار.
.
.TP
.B \-c
شروع فرآیند با غیرفعال بودن خروجی رنگی.
.
.TP
.B \-C
فعال‌سازی حالت سازگاری با
.I troff
شرکت AT&T؛ به طور خودکار گزینه
.B \-c
را فعال می‌کند.
.
.TP
.BI \-d\~ cs
.TQ
.BI \-d\~ name = string
تعریف یک متغیر رشته‌ای (string).
.
.TP
.B \-E
جلوگیری از نمایش پیام‌های خطای
.IR \%troff ؛
به طور خودکار گزینه
.B \-Ww
را فعال می‌کند.
.
.TP
.BI \-f\~ fam
تعیین خانواده قلم (font family) پیش‌فرض.
.
.TP
.BI \-F\~ dir
جستجو در دایرکتوری
.I dir
برای یافتن دایرکتوری توصیف قلم‌ها و مشخصات دستگاه خروجی انتخاب‌شده.
.
.TP
.B \-i
پردازش ورودی استاندارد پس از اتمام پردازش فایل‌های ورودی مشخص‌شده.
.
.TP
.BI \-I\~ dir
جستجو در دایرکتوری
.I dir
برای یافتن فایل‌های ورودی.
.
.TP
.BI \-m\~ name
پردازش فایل ماکروی
.RI name .tmac
پیش از پردازش فایل‌های ورودی.
.
.TP
.BI \-M\~ dir
جستجو در دایرکتوری
.I dir
برای یافتن فایل‌های ماکرو.
.
.TP
.BI \-n\~ num
شماره‌گذاری صفحه نخست سند به عنوان
.IR num .
.
.TP
.BI \-o\~ list
تولید خروجی تنها برای صفحاتی که شماره آن‌ها در فهرست
.I list
آمده است.
.
.TP
.BI \-r\~ cnumeric-expression
.TQ
.BI \-r\~ register = numeric-expression
تعریف مقدار یک رجیستر عددی.
.
.TP
.BI \-w\~ name
.TQ
.BI \-W\~ name
فعال‌سازی
.RB ( \-w )
یا جلوگیری از
.RB ( \-W )
صدور هشدارهای متعلق به دسته‌بندی
.IR name .
.
.TP
.B \-z
جلوگیری از تولید خروجی قالب‌بندی‌شده مستقل از دستگاه توسط
.IR \%troff .
.
.SH "کاربرد (USAGE)"
معماری سامانه
.I GNU roff
از الگوی پیاده‌سازی‌های مستقل از دستگاه
.I roff
پیروی می‌کند که شامل پیش‌پردازنده‌ها، بسته‌های ماکرو، درایورهای خروجی (یا همان «پس‌پردازنده‌ها»)، مجموعه‌ای از ابزارهای کمکی، و برنامه قالب‌بند هسته‌ای
.I \%troff
است.
برای آشنایی با نحوه کارکرد عمومی سامانه‌های حروفچینی به
.MR roff 7
مراجعه نمایید.
.PP
برنامه‌های پیشخوان در سامانه
.I GNU roff
کاربری آن را نسبت به نسخه‌های سنتی
.I roff
که نیازمند ساخت دستی خطوط لوله پیچیده یا استفاده از فایل‌های موقت بودند، بسیار آسان‌تر کرده‌اند.
توضیحات پیش‌رو اجزای تشکیل‌دهنده سامانه
.I GNU roff
را خلاصه کرده و اطلاعات اختصاصی
.I groff
را به مستندات
.MR roff 7
می‌افزاید.
.
.SS "شروع به کار (Getting started)"
کاربرانی که ترجیح می‌دهند با آزمون و خطای عملی یاد بگیرند یا به بازخورد سریع علاقه دارند، می‌توانند با یک سند ساده «سلام، دنیا!» کار خود را آغاز نمایند.
.PP
.EX
$ \c
.B echo \[dq]Hello, world!\[dq] | groff \-Tascii \
| sed \[aq]/\[ha]$/d\[aq]
Hello, world!
.EE
.PP
در دستور بالا از
.I sed
تنها برای حذف ۶۵ خط خالی اضافی استفاده شده است که در غیر این صورت صفحه ترمینال را پر می‌کردند.
(سامانه‌های
.I roff
در عصر پایانه‌های کاغذی با ۶۶ خط در هر صفحه طراحی شده بودند.)
.PP
کاربران امروزی ترجیح می‌دهند خروجی را در ترمینال‌های با قابلیت پشتیبانی از UTF-8 دریافت کنند:
.PP
.EX
$ \c
.B echo \[dq]Hello, world!\[dq] | groff \-Tutf8 \
| sed \[aq]/\[ha]$/d\[aq]
.EE
.PP
تولید خروجی در قالب‌های PDF، HTML یا DVI مربوط به \*[TeX] نیز به همان اندازه ساده است؛ تنها بخش دشوار، انتخاب برنامه نمایش‌دهنده مناسب برای مشاهده خروجی خواهد بود:
.PP
.EX
$ \c
.B echo \[dq]Hello, world!\[dq] | groff \-Tpdf > hello.pdf
$ \c
.B evince hello.pdf
$ \c
.B echo \[dq]Hello, world!\[dq] | groff \-Thtml > hello.html
$ \c
.B firefox hello.html
$ \c
.B echo \[dq]Hello, world!\[dq] | groff \-Tdvi > hello.dvi
$ \c
.B xdvi hello.html
.EE
.
.SS "استفاده از groff به عنوان REPL (Using groff as a REPL)"
علاقه‌مندان به برنامه‌نویسی می‌توانند از
.I groff
به صورت حلقه خواندن-ارزیابی-چاپ (REPL) استفاده کنند.
این کار برای سنجش درک خود از رفتار قالب‌بند یا دستوراتی که می‌پذیرد بسیار مفید است.
فعال‌سازی تمامی هشدارها با
.B \-ww
به دستیابی به این هدف کمک می‌کند:
.PP
.EX
$ \c
.B groff \-ww \-Tutf8
.B \[rs]# This is a comment.  Let\[aq]s define a register.
.B .nr a 1
.B \[rs]# Do integer arithmetic with operators evaluated left-to-right.
.B .nr b \[rs]n[a]+5/2
.ne 2v
.B \[rs]# Let\[aq]s get the result on the standard error stream.
.B .tm \[rs]n[b]
3
.B \[rs]# Now we\[aq]ll define a string.
.B .ds name Leslie\[rs]" This is another form of comment.
.B .nr b (\[rs]n[a] + (7/2))
.B \[rs]# Center the next two text input lines.
.B .ce 2
.B Hi, \[rs]*[name].
.B Your secret number is \[rs]n[b].
.B \[rs]# We will see that the division rounded toward zero.
.B It is
.B \[rs]# Here\[aq]s an if-else control structure.
.B .ie (\[rs]n[b] % 2) odd.
.B .el even.
.B \[rs]# This trick sets the page length to the current vertical
.B \[rs]# position, so that blank lines don\[aq]t spew when we\[aq]re \
done.
.B .pl \[rs]n[nl]u
.I <Control-D>
                           Hi, Leslie.
                    Your secret number is 4.
It is even.
.EE
.
.SS "اندازه و قالب کاغذ (Paper format)"
در
.IR GNU roff ،
ابعاد صفحه برای برنامه قالب‌بند
.I \%troff
و برای دستگاه‌های خروجی به صورت مجزا مدیریت می‌شوند.
در قالب‌بند، دستوراتی برای تعیین طول صفحه
.RB ( .pl )،
فاصله از لبه صفحه یا همان حاشیه چپ
.RB ( .po )،
و طول خط متن
.RB ( .ll )
به کار می‌روند.
حاشیه راست به طور صریح پیکربندی نمی‌شود؛ ترکیب فاصله از لبه و طول خط، اطلاعات لازم برای استخراج آن را فراهم می‌آورد.
.PP
بسته ماکروی
.IR papersize ،
که به صورت خودکار توسط
.I \%troff
بارگذاری می‌شود، رابطی کارآمد برای تنظیم ابعاد صفحه با نام‌های شناخته‌شده مانند
.RB \[lq] letter \[rq]
یا
.RB \[lq] A4 \[rq]
ارائه می‌دهد؛ به
.MR groff_tmac 5
مراجعه کنید.
مقدار پیش‌فرض در این سیستم
.RB \[lq] \%A4 \[rq]
است.
.PP
احترام به این ابعاد بر عهده هر بسته ماکرو است و برخی بسته‌ها سازوکارهای جایگزینی برای تنظیم آن ارائه می‌دهند.
.PP
برای هر دستگاه خروجی، اندازه محیط چاپ در فایل
.I DESC
مربوط به آن تعریف می‌شود.
اکثر درایورهای خروجی از گزینه
.B \-p
در خط فرمان برای بازنویسی ابعاد پیش‌فرض و از گزینه
.B \-l
برای حالت افقی (landscape) پشتیبانی می‌کنند.
به
.MR groff_font 5
جهت مشاهده دستور
.B papersize
مراجعه کنید.
صفحه راهنمای درایور خروجی، نظیر
.MR grops 1
نیز راهگشا است.
دستور
.I groff
از گزینه
.B \-P
برای انتقال گزینه‌ها به دستگاه‌های خروجی استفاده می‌کند؛ برای نمونه جهت تولید خروجی PostScript روی کاغذ A4 افقی:
.PP
.IP
.EX
groff \-Tps \-dpaper=a4l \-P\-pa4 \-P\-l \-ms foo.ms > foo.ps
.EE
.
.SS "پیشخوان (Front end)"
برنامه
.I groff
یک پوسته و رابط پیرامونی برای برنامه
.MR \%troff 1
است.
این ابزار امکان فعال‌سازی پیش‌پردازنده‌ها را از طریق گزینه‌های خط فرمان فراهم کرده و پس‌پردازنده مناسب را برای دستگاه خروجی انتخاب‌شده به طور خودکار اجرا می‌نماید.
بدین ترتیب، نیازی به ایجاد دستی خط لوله‌ها یا مدیریت فایل‌های موقت که در نسخه‌های سنتی
.MR roff 7
الزامی بود نخواهد بود.
می‌توان از ابزار
.MR grog 1
جهت حدس زدن گزینه‌های لازم برای پردازش یک سند استفاده کرد.
.
.SS "زبان حروفچینی (Language)"
ورودی یک سامانه
.I roff
شامل متن ساده است که با خطوط کنترلی و توالی‌های گریز (escape sequences) درآمیخته شده است.
این ترکیب، سندی را در یکی از زبان‌های خانواده
.I roff
می‌سازد؛ برای پیش‌زمینه تاریخی به
.MR roff 7
مراجعه کنید.
مروری کلی بر دستور زبان
.I GNU roff
از جمله فهرست کاملی از توالی‌های گریز، درخواست‌ها و رجیسترهای از پیش‌تعریف‌شده در
.MR groff 7
یافت می‌شود.
همچنین بخش‌های افزوده
.I GNU roff
به زبان سنتی AT&T
.I troff
در
.MR groff_diff 7
شرح داده شده‌اند.
.
.SS "پیش‌پردازنده‌ها (Preprocessors)"
یک پیش‌پردازنده، زبانی با کاربرد ویژه (دامنه خاص) را خوانده و خروجی‌هایی به زبان
.I roff
تولید می‌کند.
غالباً این ورودی‌ها در بخش‌های مشخصی از فایل ورودی (که با ماکروهای خاص هر پیش‌پردازنده محصور شده‌اند) قرار دارند و پیش‌پردازنده آن‌ها را جایگزین می‌نماید.
بنابراین پیش‌پردازنده‌ها علاوه بر زبان اختصاصی خود، زیرمجموعه‌ای از نحو
.I roff
را نیز درک می‌کنند.
سامانه
.I GNU roff
پیاده‌سازی‌های مجددی از پیش‌پردازنده‌های نام‌آشنای AT&T
.I troff
ارائه می‌دهد که قابلیت‌های گسترده‌تری داشته و برای قالب‌بندی نیازمند
.I troff
گنو هستند.
.PP
.RS
.TS
tab($);
Li Lx.
\%tbl$صفحه‌آرایی و چیدمان جدول‌ها؛
\%eqn$حروفچینی فرمول‌ها و عبارات ریاضی؛
\%pic$رسم تصاویر و نمودارها؛
\%refer$پردازش ارجاعات و کتاب‌شناسی؛
\%soelim$پیش‌پردازش و الحاق فایل‌های ورودی؛
\%grn$T{
رندر دیاگرام‌های
.MR gremlin 1 ؛
T}
\%chem$T{
رسم ساختارهای شیمیایی با استفاده از
.IR pic ؛
T}
gperl$T{
مقداردهی رجیسترها و رشته‌های
.I groff
با استفاده از
.MR perl 1 ؛
T}
glilypond$T{
جای‌گذاری نت‌های موسیقی
.I LilyPond ؛
و
T}
gpinyin$T{
تسهیل ورود متن چینی با نویسه‌های Hanyu Pinyin.
T}
.TE
.RE
.PP
یکی از پیش‌پردازنده‌های منحصربه‌فرد در
.I GNU roff
برنامه
.MR preconv 1
است که کدگذاری‌های گوناگون ورودی را به قالبی قابل‌درک برای
.I troff
گنو تبدیل می‌نماید.
در صورت استفاده، این ابزار پیش از تمامی پیش‌پردازنده‌های دیگر اجرا می‌شود.
.PP
اکثر پیش‌پردازنده‌ها محتوای خود را میان یک جفت نشانه (token) مشخص قرار می‌دهند.
این نشانه‌ها باید در ابتدای خط ورودی آمده و از نویسه نقطه کنترلی استفاده کنند.
فاصله‌ها یا تب‌ها نباید بلافاصله پس از نقطه یا پیش از پایان خط قرار گیرند.
عدم رعایت این نکات مانع از شناسایی بلوک توسط پیش‌پردازنده خواهد شد.
این نشانه‌ها در خروجی حفظ شده و سپس توسط
.I \%troff
به عنوان فراخوانی ماکرو تعبیر می‌گردند.
پیش‌پردازنده
.I \%ideal
هنوز در
.I groff
در دسترس نیست.
.PP
.TS
box, center, tab (^);
c | c | c
CfCR | CfCR | CfCR.
پیش‌پردازنده^نشانه آغازین^نشانه پایانی
=
\%chem^.cstart^.cend
\%eqn^.EQ^.EN
grap^.G1^.G2
\%grn^.GS^.GE
\%ideal^.IS^.IE
^^.IF
\%pic^.PS^.PE
^^.PF
^^.PY
\%refer^.R1^.R2
\%tbl^.TS^.TE
_
glilypond^.lilypond start^.lilypond stop
gperl^.Perl start^.Perl stop
gpinyin^.pinyin start^.pinyin stop
.TE
.
.SS "بسته‌های ماکرو (Macro packages)"
فایل‌های ماکرو، فایل‌های ورودی
.I roff
هستند که خود خروجی مستقیمی تولید نمی‌کنند، بلکه نگارش و قالب‌بندی سایر اسناد را تسهیل می‌نمایند.
هنگامی که یک فایل ماکرو در یک مسیر استاندارد نصب شده و برای استفاده عمومی طراحی شده باشد، به آن «بسته ماکرو» (macro package) می‌گویند.
.PP
بسته‌های ماکرو را می‌توان پیش از هر سندی با استفاده از گزینه
.B \-m
بارگذاری نمود.
سامانه
.I GNU roff
اکثر بسته‌های ماکروی مشهور AT&T
.I troff
را به شکلی کاملاً سازگار پیاده‌سازی و گسترش داده است.
این بسته‌ها به دلیل سنت خلاصه‌نویسی در روزهای آغازین یونیکس نام‌هایی تک‌حرفی یا دوحرفی دارند؛ به گونه‌ای که بسیاری از آن‌ها در زبان روزمره با حرف سوییچ
.I nroff
یا
.I troff
فراخوانی‌کننده خود شناخته می‌شوند (مانند «man» برگرفته از manual، یا بسته «s» که به نام
.I ms
یا حتی
.I \-ms
معروف است).
.PP
بسته‌های ماکرو وظایف گوناگونی را بر عهده دارند.
برخی بسته‌ها «همه‌منظوره و کامل» هستند که مدیریت صفحه‌آرایی، حاشیه‌ها و لغت‌نامه اختصاصی ساختار سند را بر عهده می‌گیرند؛ هر سند تنها می‌تواند از یکی از این بسته‌ها استفاده کند:
.
.TP
.I an
برای نگارش صفحات راهنما بر پایه قالب نگارش ۷ یونیکس (۱۹۷۹)؛ به
.MR groff_man 7
مراجعه کنید.
این بسته با گزینه
.B \-man
در خط فرمان فراخوانی می‌شود.
.
.TP
.I doc
برای نگارش صفحات راهنما بر پایه قالب 4.3BSD-Reno (۱۹۹۰)؛ به
.MR groff_mdoc 7
مراجعه کنید.
این بسته با گزینه
.B \-mdoc
در خط فرمان فراخوانی می‌شود.
.
.TP
.I e
مجموعه ماکروهای عمومی برکلی، توسعه‌یافته به عنوان جایگزینی برای بسته s شرکت AT&T؛ به
.MR groff_me 7
مراجعه کنید.
این بسته با گزینه
.B \-me
در خط فرمان فراخوانی می‌شود.
.
.TP
.I m
پیاده‌سازی نسل دوم بسته‌های اسناد عمومی شرکت AT&T و جانشین بسته s؛ به
.MR groff_mm 7
مراجعه کنید.
این بسته با گزینه
.B \-mm
در خط فرمان فراخوانی می‌شود.
.
.TP
.I om
(همواره با عنوان «mom» خوانده می‌شود) بسته ماکروی مدرنی است که توسط پیتر شافتر (Peter Schaffter) اختصاصاً برای
.I GNU roff
نگاشته شده است.
برای مستندات کامل به
.UR file:///usr/share/doc/groff-base/html/mom/toc.html
راهنمای HTML بسته mom
.UE
مراجعه کنید.
این بسته در خط فرمان با
.B \-mom
مشخص می‌شود.
.
.TP
.I s
قالب عمومی و اصیل اسناد در سیستم AT&T؛ به
.MR groff_ms 7
مراجعه کنید.
این بسته با گزینه
.B \-ms
در خط فرمان فراخوانی می‌شود.
.PP
سایر بسته‌ها ماهیت کمکی دارند؛ برای نمونه،
.I andoc
یک بسته پوششی در
.I GNU roff
است که به صورت خودکار تشخیص می‌دهد آیا یک صفحه راهنما از قالب
.I man
استفاده کرده یا
.IR mdoc ،
و بسته مربوطه را فراخوانی می‌کند.
این بسته در خط فرمان با
.B \-mandoc
تعیین می‌شود.
برنامه‌های مرورگر راهنما مانند
.MR man 1
از این ماکرو بهره می‌برند تا دیگر نیازی به پویش اولیه محتوای سند نداشته باشند.
.PP
بسیاری دیگر از فایل‌های ماکرو عملکردهای بسته‌های جامع را تکمیل می‌کنند یا برای اسناد بدون بسته ماکرو (که گاهی «خام» یا raw نامیده می‌شوند) به کار می‌روند؛ شرح آن‌ها در
.MR groff_tmac 5
آمده است.
.
.SS "قالب‌بندها (Formatters)"
قالب‌بند، برنامه‌ای است که زبان ورودی
.I roff
را تفسیر و پردازش می‌کند؛ این برنامه
.MR \%troff 1
نام دارد.
این ابزار تمامی قابلیت‌های برنامه‌های AT&T
.I troff
و
.I nroff
را به همراه افزوده‌های متعددی ارائه می‌دهد.
گزینه
.B \-C
در خط فرمان، برنامه
.I \%troff
را به «حالت سازگاری» (compatibility mode) می‌برد تا رفتار سیستم سنتی AT&T را با بالاترین دقت ممکن شبیه‌سازی کند.
.PP
اسکریپت پوسته
.MR \%nroff 1
رفتار سیستم سنتی AT&T
.I nroff
را شبیه‌سازی می‌نماید.
این اسکریپت تلاش می‌کند خروجی را بر پایه تنظیمات محلی (locale) کاربر کدگذاری کند و کاربر را از تعیین دستگاه خروجی با سوییچ
.B \-T
بی‌نیاز سازد؛ از این رو برای خروجی‌های پایانه‌ای بسیار کارآمد است.
.PP
برنامه
.I troff
گنو خروجی نهایی خود را در زبانی مستقل از دستگاه اما وابسته به تعاریف آن تولید می‌کند که جزئیات آن در
.MR groff_out 5
آمده است.
.
.SS "دستگاه‌های خروجی (Output devices)"
خروجی
.I \%troff
برای یک «دستگاه خروجی» خاص قالب‌بندی می‌شود که معمولاً با گزینه
.B \-T
در خط فرمان تعیین می‌گردد.
اگر این گزینه یا متغیر محیطی
.I \%GROFF_TYPESETTER
تعیین نشده باشند، دستگاه خروجی پیش‌فرض
.B \%ps
خواهد بود.
دستگاه‌های خروجی پشتیبانی‌شده به شرح زیر هستند:
.
.TP 9n
.B ascii
برای پایانه‌های مبتنی بر مجموعه نویسه‌ها و کدگذاری ISO 646 1991:IRV (معروف به US-ASCII).
.
.TP
.B cp1047
برای پایانه‌های مبتنی بر کدپیج ۱۰۴۷ شرکت IBM.
.
.TP
.B dvi
برای تولید خروجی قالب DVI سامانه حروفچینی TeX.
.
.TP
.B html
.TQ
.B xhtml
به ترتیب برای تولید خروجی در قالب‌های وب HTML و XHTML.
.
.TP
.B latin1
برای پایانه‌های مبتنی بر مجموعه نویسه و کدگذاری ISO Latin-1 (ISO 8859-1).
.
.TP
.B lbp
برای چاپگرهای لیزری سری CaPSL شرکت کانن (چاپگرهای سری LBP-4 و LBP-8).
.
.TP
.B lj4
برای چاپگرهای سازگار با پروتکل PCL5 و چاپگرهای سری HP LaserJet 4.
.
.TP
.B pdf
برای تولید اسناد قالب PDF.
.
.TP
.B ps
برای تولید اسناد و خروجی چاپ PostScript.
.
.TP
.B utf8
برای پایانه‌های متنی نوین با مجموعه نویسه‌های یونیکد (ISO 10646) در کدگذاری UTF-8.
.
.TP
.B X75
برای پیش‌نمایش در
.I \%gxditview
با تفکیک‌پذیری ۷۵ نقطه بر اینچ (dpi) و اندازه قلم پایه ۱۰ پوینت.
.
.TP
.B X75\-12
برای پیش‌نمایش در
.I \%gxditview
با تفکیک‌پذیری ۷۵ نقطه بر اینچ و اندازه قلم پایه ۱۲ پوینت.
.
.TP
.B X100
برای پیش‌نمایش در
.I \%gxditview
با تفکیک‌پذیری ۱۰۰ نقطه بر اینچ و اندازه قلم پایه ۱۰ پوینت.
.
.TP
.B X100\-12
برای پیش‌نمایش در
.I \%gxditview
با تفکیک‌پذیری ۱۰۰ نقطه بر اینچ و اندازه قلم پایه ۱۲ پوینت.
.
.SS "پس‌پردازنده‌ها (Postprocessors)"
هر برنامه‌ای که خروجی
.I troff
گنو را تفسیر نماید، یک پس‌پردازنده به شمار می‌رود.
پس‌پردازنده‌های ارائه‌شده توسط سامانه
.I GNU roff
در حقیقت «درایورهای خروجی» هستند که سند را برای مشاهده در مانیتور یا چاپ آماده می‌کنند.
البته ساخت پس‌پردازنده‌ها برای مقاصد دیگر (مانند چینش مجدد صفحات یا تحلیل آماری سند) نیز امکان‌پذیر است.
.PP
هر درایور خروجی از یک یا چند دستگاه خروجی پشتیبانی می‌کند و برای هر یک فایلی جهت توصیف دستگاه دارد.
دستگاه با استفاده از فرمان
.B postpro
در فایل توصیف خود، پس‌پردازنده اختصاصی‌اش را مشخص می‌سازد؛ به
.MR groff_font 5
مراجعه فرمایید.
گزینه
.B \-X
این انتخاب را نادیده گرفته و موجب می‌شود تا برنامه
.I \%gxditview
به عنوان درایور خروجی عمل کند.
.
.TP
.MR grodvi 1
فراهم‌کننده درایور دستگاه
.BR dvi .
.
.TP
.MR grohtml 1
فراهم‌کننده درایورهای دستگاه‌های
.B html
و
.BR xhtml .
.
.TP
.MR grolbp 1
فراهم‌کننده درایور دستگاه
.BR lbp .
.
.TP
.MR grolj4 1
فراهم‌کننده درایور دستگاه
.BR lj4 .
.
.TP
.MR gropdf 1
فراهم‌کننده درایور دستگاه
.BR pdf .
.
.TP
.MR grops 1
فراهم‌کننده درایور دستگاه
.BR ps .
.
.TP
.MR grotty 1
فراهم‌کننده درایورهای خروجی پایانه‌ای
.BR ascii ،
.BR cp1047 ،
.BR latin1
و
.BR utf8 .
.
.TP
.MR gxditview 1
فراهم‌کننده پیش‌نمایش برای
.BR X75 ،
.BR X75\-12 ،
.BR X100
و
.BR X100\-12 ،
و همچنین با قابلیت پیش‌نمایش خروجی‌های
.BR ps .
.
.SS "ابزارهای کمکی (Utilities)"
سامانه
.I GNU roff
شامل مجموعه‌ای از ابزارهای کمکی و جانبی است:
.
.TP
.MR gdiffmk 1
علامت‌گذاری تفاوت‌ها و تغییرات میان دو فایل ورودی
.IR roff .
.
.TP
.MR grog 1
حدس هوشمندانه فرمان و گزینه‌های
.I groff
که سند برای قالب‌بندی به آن‌ها نیاز دارد.
.PP
ابزارهای زیر فایل‌های توصیف قلم را ایجاد می‌کنند تا قالب‌بند بتواند هنگام تولید خروجی از آن قلم‌ها استفاده نماید:
.
.TP
.MR addftinfo 1
افزودن اطلاعات به فایل‌های توصیف قلم AT&T
.I troff
جهت استفاده در
.IR troff
گنو.
.
.TP
.MR afmtodit 1
تولید فایل‌های توصیف قلم برای قلم‌های PostScript Type 1.
.
.TP
.MR pfbtops 1
تبدیل قلم‌های PostScript Type 1 از قالب PFB (دودویی) به قالب متنی PFA جهت خوانده شدن توسط
.IR \%afmtodit .
.
.TP
.MR hpftodit 1
تولید فایل‌های توصیف قلم برای چاپگرهای سری HP LaserJet 4.
.
.TP
.MR tfmtodit 1
تولید فایل‌های توصیف قلم برای دستگاه خروجی DVI سامانه TeX.
.
.TP
.MR xtotroff 1
تولید فایل‌های توصیف قلم برای قلم‌های هسته سامانه X Window.
.PP
سه ابزار کمکی زیر نمودارهای طراحی‌شده با زبان‌های پیش‌پردازنده
.I roff
را به فایل‌های تصویری گرافیکی تبدیل می‌کنند:
.
.TP
.MR eqn2graph 1
تبدیل فرمول‌های
.I eqn
به تصویر برش‌خورده.
.
.TP
.MR grap2graph 1
تبدیل نمودارهای
.I grap
به تصویر برش‌خورده.
.
.TP
.MR pic2graph 1
تبدیل نمودارهای
.I pic
به تصویر برش‌خورده.
.PP
مجموعه‌ای دیگر از برنامه‌ها برای تعامل با پایگاه داده مراجع کتاب‌شناسی مورد استفاده در پیش‌پردازنده
.MR refer 1
طراحی شده‌اند:
.
.TP
.MR \%indxbib 1
تولید نمایه‌های معکوس برای پایگاه‌های کتاب‌شناسی به منظور افزایش چشمگیر سرعت جستجو.
.
.TP
.MR lkbib 1
جستجو در پایگاه‌های داده کتاب‌شناسی.
.
.TP
.MR \%lookbib 1
جستجوی تعاملی در پایگاه‌های داده مراجع.
.
.SH "وضعیت خروج (EXIT STATUS)"
دستور
.I groff
در صورت بروز خطا در تجزیه آرگومان‌ها با وضعیت خطا خارج می‌شود، و در صورت مشخص شدن گزینه‌های
.B \-h
یا
.B \-\-help
با موفقیت خاتمه می‌یابد.
در غیر این صورت،
.I groff
یک خط لوله را برای پردازش ورودی اجرا می‌کند؛ اگر تمام دستورات درون خط لوله با موفقیت پایان یابند،
.I groff
نیز با موفقیت خاتمه می‌یابد.
.PP
در صورت بروز خطا، کد خروج
.I groff
خلاصه‌ای بیتی از مشکلات پیش‌آمده را کدگذاری می‌کند:
اگر دستوری با وضعیت شکست خارج شود بیت ۰ (مقدار ۱) تنظیم می‌شود،
اگر دستوری با دریافت سیگنال پایان یابد بیت ۱ (مقدار ۲) تنظیم می‌شود،
و اگر دستوری قابل اجرا نباشد بیت ۲ (مقدار ۴) تنظیم می‌گردد.
(بنابراین، اگر هر سه مشکل رخ دهد، وضعیت خروج برابر با ۷ خواهد بود: ۱ + ۲ + ۴).
برای عیب‌یابی مشکلات خط لوله، می‌توانید دستور
.I groff
را با گزینه
.B \-V
مجدداً اجرا کرده و هر مرحله را جداگانه بررسی نمایید.
.
.SH "محیط (ENVIRONMENT)"
به طور معمول، نویسه جداکننده مسیرها در متغیرهای محیطی که به
.I PATH
ختم می‌شوند، دو‌نقطه (:) است؛ این مورد در سیستم‌های عامل دیگر (مانند ویندوز که از سمیکالن استفاده می‌کند) ممکن است متفاوت باشد.
.
.TP
.I GROFF_BIN_PATH
مسیر جستجو برای یافتن برنامه‌هایی که توسط
.I groff
اجرا می‌شوند، که پیش از
.I PATH
بررسی می‌گردد.
اگر تنظیم نشده باشد، دایرکتوری نصب فایل‌های اجرایی
.RB ( /usr/bin )
پیش از
.I PATH
جستجو می‌شود.
.
.TP
.I GROFF_COMMAND_PREFIX
می‌توان سامانه
.I GNU roff
را در زمان کامپایل به گونه‌ای پیکربندی کرد که پیشوندی به نام برنامه‌های دارای معادل در AT&T اضافه کند تا از تداخل نام جلوگیری شود.
پیش‌فرض خالی است، اما در صورت استفاده معمولاً حرف «g» است (برای نمونه
.IR gtroff ،
.IR gnroff ،
.IR geqn ،
.IR gpic ،
.IR gtbl
و غیره).
.
.TP
.I GROFF_ENCODING
مقدار این متغیر به گزینه
.B \-e
پیش‌پردازنده
.MR preconv 1
منتقل می‌شود تا کدگذاری فایل‌های ورودی را تعیین کند.
وجود این متغیر به معنای اعمال خودکار گزینه
.B \-k
است.
گزینه
.B \-K
در
.I groff
این متغیر را بازنویسی می‌کند.
.
.TP
.I GROFF_FONT_PATH
فهرست دایرکتوری‌ها برای جستجوی فایل‌های توصیف قلم و دستگاه‌ها؛ به
.MR \%troff 1
و
.MR groff_font 5
مراجعه کنید.
.
.TP
.I GROFF_TMAC_PATH
فهرست دایرکتوری‌ها برای جستجوی فایل‌های ماکرو؛ به
.MR \%troff 1
و
.MR groff_tmac 5
مراجعه کنید.
.
.TP
.I GROFF_TMPDIR
دایرکتوری ایجاد فایل‌های موقت.
اگر تنظیم نشده باشد، مقدار
.I \%TMPDIR
و در ویندوز
.I TMP
یا
.I TEMP
بررسی می‌شود؛ در غیر این صورت از
.I /tmp
استفاده می‌گردد.
دستورات
.MR \%refer 1 ،
.MR grohtml 1
و
.MR grops 1
از فایل‌های موقت بهره می‌برند.
.
.TP
.I GROFF_TYPESETTER
تعیین دستگاه خروجی پیش‌فرض؛ اگر تنظیم نشده باشد
.B ps
است.
گزینه
.B \-T
بر این متغیر اولویت دارد.
.
.TP
.I SOURCE_DATE_EPOCH
برچسب زمانی بر حسب ثانیه از مبدا یونیکس که به عنوان زمان ساخت سند استفاده می‌شود.
این زمان توسط
.MR gmtime 3
و
.MR asctime 3
به قالبی خوانا برای انسان تبدیل شده و در رجیسترهای سند قرار می‌گیرد.
.
.TP
.I TZ
منطقه زمانی جهت تبدیل زمان به قالب خوانا برای انسان؛ به
.MR tzset 3
مراجعه کنید.
در صورت استفاده از
.IR SOURCE_DATE_EPOCH ،
تبدیل همواره بر پایه ساعت هماهنگ جهانی (UTC) خواهد بود.
.
.SH "مثال‌ها (EXAMPLES)"
سامانه‌های
.I roff
بیش از هر چیز برای صفحه‌آرایی صفحات راهنما شناخته می‌شوند.
هنگامی که برنامه مرورگر
.MR man 1
یک صفحه راهنما را می‌یابد، دستوری مشابه زیر را اجرا می‌کند:
.PP
.RS
.EX
groff \-t \-man \-Tutf8 /usr/share/man/man1/groff.1
.EE
.RE
.PP
برنامه مرورگر خروجی را به یک صفحه‌بند (pager) منتقل می‌کند.
.PP
برای پردازش یک سند
.I roff
با استفاده از پیش‌پردازنده‌های
.I \%tbl
و
.I \%pic
و بسته ماکروی
.I me
به شیوه سنتی AT&T، کاربر ناچار به اجرای خط لوله‌ای به شکل زیر بود:
.PP
.IP
.EX
\%pic foo.me | \%tbl | \%troff \-me \-Tutf8 | grotty
.EE
.PP
با بهره‌گیری از
.IR groff ،
این زنجیره به یک دستور کوتاه و سرراست تبدیل می‌شود:
.PP
.IP
.EX
groff \-p \-t \-me \-T utf8 foo.me
.EE
.PP
راهکاری ساده‌تر نیز استفاده از
.MR grog 1
برای حدس زدن پیش‌پردازنده‌ها و ماکروهای مورد نیاز با استفاده از جایگزینی دستور پوسته است:
.PP
.IP
.EX
$(grog \-Tutf8 foo.me)
.EE
.PP
هر گزینه خط فرمان برای پس‌پردازنده باید با خط تیره‌های لازم مشخص شود، زیرا
.I groff
آرگومان‌ها را مستقیماً منتقل می‌کند؛ برای نمونه جهت ارسال عنوان پنجره به
.IR gxditview :
.PP
.RS
.EX
groff \-X \-P \-title \-P \[aq]trial run\[aq] mydoc.t
.EE
.RE
.PP
دستور بالا معادل است با:
.PP
.RS
.EX
groff \-X \-Z mydoc.t | gxditview \-title \[aq]trial run\[aq] \-
.EE
.RE
.
.SH "محدودیت‌ها (LIMITATIONS)"
هنگام مرور صفحه‌به‌صفحه خروجی برای دستگاه‌های
.BR ascii ،
.BR cp1047 ،
.BR latin1
و
.BR utf8 ،
برنامه‌هایی چون
.MR more 1
و
.MR less 1
ممکن است برای پردازش صحیح توالی‌های گریز ترمینال (جهت برجسته‌سازی یا ایتالیک) نیازمند گزینه‌های خاصی باشند؛ به
.MR grotty 1
مراجعه فرمایید.
.PP
در میزبان‌های EBCDIC (مانند OS/390 Unix)، دستگاه‌های خروجی
.B ascii
و
.B latin1
در دسترس نیستند.
به طور متقابل، دستگاه خروجی
.B cp1047
در سیستم‌های مبتنی بر استانداردهای کدگذاری ISO 646 یا ISO 8859 موجود نمی‌باشد.
.
.SH "دایرکتوری‌های نصب (INSTALLATION DIRECTORIES)"
سامانه
.I GNU roff
بسته به پیکربندی زمان کامپایل، فایل‌ها را در مسیرهای مختلفی ذخیره می‌کند.
در این نصب، مسیرهای زیر مورد استفاده قرار گرفته‌اند:
.
.TP
.I /etc/X11/app-defaults
دایرکتوری پیش‌فرض‌های برنامه برای
.MR gxditview 1 .
.
.TP
.I /usr/bin
دایرکتوری حاوی دستورات اجرایی
.IR groff .
.
.TP
.I /usr/share/groff/1.23.0/eign
فهرست واژه‌های متداول برای
.MR indxbib 1 .
.
.TP
.I /usr/share/groff/1.23.0
دایرکتوری فایل‌های داده و منابع سیستم.
.
.TP
.I /usr/dict/papers/Ind
نمایه پیش‌فرض برای ابزارهای
.MR lkbib 1
و
.MR refer 1 .
.
.TP
.I /usr/share/doc/groff-base
دایرکتوری مستندات و راهنماها.
.
.TP
.I /usr/share/doc/groff-base/examples
دایرکتوری مثال‌ها و نمونه‌ها.
.
.TP
.I /usr/share/groff/1.23.0/font
دایرکتوری قلم‌ها.
.
.TP
.I /usr/share/doc/groff-base/html
دایرکتوری مستندات به فرمت HTML.
.
.TP
.I /usr/lib/font
دایرکتوری قدیمی قلم‌ها.
.
.TP
.I /usr/share/groff/site-font
دایرکتوری قلم‌های محلی سیستم.
.
.TP
.I /usr/share/groff/site-tmac
دایرکتوری بسته‌های ماکروی محلی سیستم (فایل‌های
.IR tmac ).
.
.TP
.I /usr/share/groff/1.23.0/tmac
دایرکتوری رسمی بسته‌های ماکرو (فایل‌های
.IR tmac ).
.
.TP
.I /usr/share/groff/1.23.0/oldfont
دایرکتوری قلم‌ها جهت سازگاری با نگارش‌های قدیمی‌تر
.IR groff ؛
به
.MR grops 1
مراجعه کنید.
.
.TP
.I /usr/share/doc/groff-base/pdf
دایرکتوری مستندات به فرمت PDF.
.
.SS "دایرکتوری ماکروهای groff"
بیشتر فایل‌های ماکروی ارائه‌شده با سامانه
.I GNU roff
در مسیر
.I /usr/share/groff/1.23.0/tmac
قرار دارند.
به طور کلی چندین مسیر برای یافتن فایل‌های ماکرو پیموده می‌شود؛ به
.MR \%troff 1
مراجعه فرمایید.
جهت مشاهده فهرست بسته‌های ماکروی موجود به
.MR groff_tmac 5
مراجعه کنید.
.
.SS "دایرکتوری توصیف قلم و دستگاه‌های groff"
فایل‌های توصیف قلم و دستگاه‌های ارائه‌شده با سامانه
.I GNU roff
در مسیر
.I /usr/share/groff/1.23.0/font
ذخیره شده‌اند.
به طور کلی چندین مسیر برای یافتن مشخصات دستگاه و قلم‌ها پیموده می‌شود؛ به
.MR \%troff 1
مراجعه کنید.
برای درک ساختار و قالب این فایل‌ها به
.MR groff_font 5
مراجعه نمایید.
.
.SH "دسترسی (AVAILABILITY)"
پیوندهای دریافت انتشارها، مخزن سورس‌کد، فهرست‌های رایانامه‌ای گفتگو، سامانه پیگیری باگ‌ها و اطلاعات تکمیلی در صفحه رسمی
.UR http://www.gnu.org/software/groff
.I groff
در وبگاه پروژه گنو
.UE
در دسترس است.
.PP
یک پیاده‌سازی آزاد از پیش‌پردازنده
.I grap
که توسط تد فیبر
.RI ( "Ted Faber" )
نوشته شده است، در پایگاه وب
.UR http://www.lunabase.org/~faber/Vault/software/grap
پیش‌پردازنده grap
.UE
موجود می‌باشد.
سامانه
.I groff
تنها از این نسخه
.I grap
پشتیبانی می‌کند.
.
.SH "نویسندگان (AUTHORS)"
سامانه
.I groff
(شامل پیشخوان و کل سامانه حروفچینی) در اصل توسط جیمز کلارک
.RI ( "James Clark" )
طراحی و پیاده‌سازی شده است.
مشارکت‌کنندگان در این سند شامل کلارک،
ترنت ای. فیشر
.RI ( "Trent A. Fisher" )،
ورنر لمبرگ
.RI ( "Werner Lemberg" )،
برند وارکن
.RI ( "Bernd Warken" )
و
جی. برندن رابینسون
.RI ( "G. Branden Robinson" )
هستند.
.
.SH "همچنین ببینید (SEE ALSO)"
کتاب
.I "Groff: The GNU Implementation of troff"
نوشته ترنت ای. فیشر و ورنر لمبرگ، راهنمای جامع و مرجع اصلی
.I groff
است.
می‌توانید آن را به صورت تعاملی با دستور
.B info groff
مطالعه نمایید.
.
.TP
مقدمه، تاریخچه و مطالعه بیشتر:
.MR roff 7
.
.TP
نمایش‌دهنده اسناد groff (و اسناد مستقل از دستگاه troff در AT&T):
.MR gxditview 1
.
.TP
پیش‌پردازنده‌ها:
.MR \%chem 1 ،
.MR \%eqn 1 ،
.MR \%neqn 1 ،
.MR glilypond 1 ،
.MR \%grn 1 ،
.MR preconv 1 ،
.MR gperl 1 ،
.MR \%pic 1 ،
.MR gpinyin 1 ،
.MR \%refer 1 ،
.MR \%soelim 1 ،
.MR \%tbl 1
.
.TP
بسته‌های ماکرو و ابزارهای مرتبط:
.MR groff_hdtbl 7 ،
.MR groff_man 7 ،
.MR groff_man_style 7 ،
.MR groff_mdoc 7 ،
.MR groff_me 7 ،
.MR groff_mm 7 ،
.MR groff_mmse 7
(تنها در محیط‌های زبان سوئدی)،
.MR mmroff 1 ،
.MR groff_mom 7 ،
.MR pdfmom 1 ،
.MR groff_ms 7 ،
.MR groff_rfc1345 7 ،
.MR groff_trace 7 ،
.MR groff_www 7
.
.TP
ابزارهای مدیریت پایگاه‌های داده کتاب‌شناسی:
.MR \%indxbib 1 ،
.MR lkbib 1 ،
.MR \%lookbib 1
.
.TP
زبان، قراردادها و افزوده‌های گنو:
.MR groff 7 ،
.MR groff_char 7 ،
.MR groff_diff 7 ،
.MR groff_font 5 ،
.MR groff_tmac 5
.
.TP
زبان خروجی میانی:
.MR groff_out 5
.
.TP
برنامه قالب‌بند هسته:
.MR \%troff 1
.
.TP
پوسته‌ها و اجراکننده‌های قالب‌بند:
.MR \%nroff 1 ،
.MR pdfroff 1
.
.TP
پس‌پردازنده‌ها برای دستگاه‌های خروجی:
.MR grodvi 1 ،
.MR grohtml 1 ،
.MR grolbp 1 ،
.MR grolj4 1 ،
.MR gropdf 1 ،
.MR grops 1 ،
.MR grotty 1
.
.TP
ابزارهای پشتیبانی از قلم‌ها:
.MR addftinfo 1 ،
.MR afmtodit 1 ،
.MR hpftodit 1 ،
.MR pfbtops 1 ،
.MR tfmtodit 1 ،
.MR xtotroff 1
.
.TP
ابزارهای تبدیل اشکال و نمودارها به تصویر گرافیکی:
.MR eqn2graph 1 ،
.MR grap2graph 1 ،
.MR pic2graph 1
.
.TP
ابزار نشانه‌گذاری تغییرات و تفاوت‌ها:
.MR gdiffmk 1
.
.TP
ابزار حدس هوشمند گزینه‌های groff:
.MR grog 1