.\" Halibut version 1.3
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.TH "halibut" "1" "2004\(hy04\(hy08" "Halibut" "Simon\ Tatham"
.SH "نام (NAME)"
.PP
\fBhalibut\fP \- ابزار قالب‌بندی مستندات چندفرمت
.SH "خلاصه دستور (SYNOPSIS)"
.PP
.nf
\fBhalibut\fP\ [\fIگزینه‌ها\fP]\ \fIfile1.but\fP\ [\fIfile2.but\fP\ ...]
.fi
.SH "توضیحات (DESCRIPTION)"
.PP
دستور \fBhalibut\fP مجموعه‌ای از فایل‌های ورودی مشخص‌شده را می‌خواند، آن‌ها را در قالب یک سند ترکیب می‌کند و آن سند را در یک یا چند فرمت خروجی می‌دهد.
.PP
گزینه‌های خط فرمان موجود می‌توانند فرمت‌های خروجی Halibut را پیکربندی کرده و جنبه‌های دیگر عملکرد آن را تنظیم نمایند.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های خط فرمان پشتیبانی‌شده توسط \fBhalibut\fP عبارتند از:
.IP "\fB--text\fP[\fB=\fP\fIfilename\fP]"
باعث تولید یک فایل خروجی با فرمت متن ساده (plain text) می‌شود. اگر پارامتر اختیاری \fIfilename\fP ارائه شود، فایل متنی خروجی با همان نام ذخیره خواهد شد. در غیر این صورت، نام فایل متنی خروجی همان نامی خواهد بود که در فایل‌های ورودی مشخص شده است، یا اگر نامی تعیین نشده باشد، \fBoutput.txt\fP در نظر گرفته می‌شود.
.IP "\fB--html\fP[\fB=\fP\fIfilename\fP]"
باعث تولید یک یا چند فایل خروجی در قالب HTML می‌شود. اگر پارامتر اختیاری \fIfilename\fP مشخص شود، دقیقاً یک فایل خروجی HTML با همان نام تولید می‌شود که شامل کل سند خواهد بود. در غیر این صورت ممکن است یک یا چند فایل HTML به عنوان خروجی تولید شوند؛ این مورد و نام فایل‌ها بر اساس آنچه در فایل‌های ورودی مشخص شده تعیین می‌شوند، یا اگر هیچ نامی تعیین نشده باشد مجموعه‌ای از نام‌های پیش‌فرض که با \fBContents.html\fP شروع می‌شوند استفاده خواهند شد.
.IP "\fB--chm\fP[\fB=\fP\fIfilename\fP]"
باعث تولید فایل خروجی در قالب راهنمای اچ‌تی‌ام‌ال ویندوز (Windows HTML Help) می‌شود. اگر پارامتر اختیاری \fIfilename\fP ارائه شود، فایل راهنمای خروجی با همان نام ذخیره خواهد شد. در غیر این صورت، نام فایل بر اساس فایل‌های ورودی یا در صورت عدم تعیین، \fBoutput.chm\fP خواهد بود.
.IP "\fB--winhelp\fP[\fB=\fP\fIfilename\fP]"
باعث تولید فایل خروجی در فرمت قدیمی راهنمای ویندوز (Windows Help) می‌شود. اگر پارامتر اختیاری \fIfilename\fP ارائه شود، فایل راهنمای خروجی با همان نام ذخیره خواهد شد. در غیر این صورت نام فایل بر اساس فایل‌های ورودی یا \fBoutput.hlp\fP خواهد بود.
.RS
.PP
فایل راهنمای خروجی باید به پسوند \fB.hlp\fP ختم شود؛ اگر چنین نباشد، پسوند \fB.hlp\fP به آن اضافه خواهد شد. یک فایل فهرست ثانویه نیز در کنار فایل راهنمای اصلی ایجاد می‌شود که نام آن مشابه بوده ولی به پسوند \fB.cnt\fP ختم می‌شود (مثلاً \fBoutput.cnt\fP اگر فایل اصلی \fBoutput.hlp\fP باشد).
.RE
.IP "\fB--man\fP[\fB=\fP\fIfilename\fP]"
باعث تولید فایل خروجی در قالب صفحات راهنمای یونیکس (\fBman\fP) می‌شود. اگر پارامتر اختیاری \fIfilename\fP ارائه شود، صفحه راهنمای خروجی با همان نام ذخیره خواهد شد. در غیر این صورت نام بر اساس فایل‌های ورودی یا \fBoutput.1\fP خواهد بود.
.IP "\fB--info\fP[\fB=\fP\fIfilename\fP]"
باعث تولید فایل خروجی \fBinfo\fP می‌شود. اگر پارامتر اختیاری \fIfilename\fP ارائه شود، فایل \fBinfo\fP با همان نام ذخیره خواهد شد. در غیر این صورت، نام فایل طبق فایل‌های ورودی یا \fBoutput.info\fP خواهد بود.
.RS
.PP
به‌طور پیش‌فرض، مگر اینکه با استفاده از دستورالعمل \fB\ecfg{info-max-file-size}{0}\fP به گونه دیگری تنظیم شود، خروجی \fBinfo\fP به چندین فایل تقسیم می‌شود. فایل اصلی نام مشخص‌شده شما را خواهد داشت و فایل‌های وابسته پسوندهای \fB-1\fP، \fB-2\fP و غیره خواهند داشت.
.RE
.IP "\fB--pdf\fP[\fB=\fP\fIfilename\fP]"
باعث تولید یک فایل خروجی در قالب PDF می‌شود. اگر پارامتر اختیاری \fIfilename\fP ارائه شود، فایل PDF خروجی با همان نام ذخیره خواهد شد. در غیر این صورت، نام فایل PDF طبق فایل‌های ورودی یا \fBoutput.pdf\fP خواهد بود.
.IP "\fB--ps\fP[\fB=\fP\fIfilename\fP]"
باعث تولید یک فایل خروجی در قالب پست‌اسکریپت (PostScript) می‌شود. اگر پارامتر اختیاری \fIfilename\fP ارائه شود، فایل پست‌اسکریپت خروجی با همان نام ذخیره خواهد شد. در غیر این صورت، نام فایل طبق فایل‌های ورودی یا \fBoutput.ps\fP خواهد بود.
.IP "\fB-C\fP\fIword\fP\fB:\fP\fIword\fP[\fB:\fP\fIword\fP...]"
یک دستورالعمل پیکربندی به ورودی‌های پردازش‌شده توسط Halibut اضافه می‌کند. استفاده از این گزینه دقیقاً معادل افزودن یک فایل ورودی اضافی به خط فرمان است که شامل دستورالعمل \fB\ecfg{\fP\fIword\fP\fB}{\fP\fIword\fP\fB}{\fP\fIword\fP...\fB}\fP باشد.
.IP "\fB--input-charset=\fP\fIcharset\fP"
مجموعه نویسه‌های فرضی فایل‌های ورودی را از حالت پیش‌فرض ASCII تغییر می‌دهد.
.IP "\fB--list-charsets\fP"
فهرست مجموعه‌های نویسه شناخته‌شده برای Halibut را نمایش می‌دهد.
.IP "\fB--list-fonts\fP"
فهرست قلم‌های شناخته‌شده برای Halibut (به‌صورت درونی یا از طریق ارسال فایل ورودی) را نمایش می‌دهد.
.IP "\fB--precise\fP"
باعث می‌شود هنگامی که Halibut با خطایی در فایل ورودی مواجه شد، علاوه بر شماره سطر، شماره ستون را نیز گزارش کند.
.IP "\fB--help\fP"
خلاصه‌ای از گزینه‌های خط فرمان برنامه را نمایش می‌دهد.
.IP "\fB--version\fP"
شماره نسخه Halibut را گزارش می‌کند.
.IP "\fB--licence\fP"
مجوز برنامه (MIT) را نمایش می‌دهد.
.SH "اطلاعات بیشتر (MORE INFORMATION)"
.PP
برای اطلاعات بیشتر درباره Halibut، از جمله جزئیات کامل فرمت فایل‌های ورودی، به کتابچه راهنمای کامل آن مراجعه کنید. اگر این راهنما به‌صورت محلی روی سیستم شما نصب نشده است، می‌توانید آن را در وب‌سایت Halibut بیابید:
.PP
\fBhttps://www.chiark.greenend.org.uk/~sgtatham/halibut\fP
.SH "اشکالات (BUGS)"
.PP
این صفحه راهنما چندان کامل و جامع نیست.