'\" t .\" Manual page created with latex2man on Fri Jan 16 09:16:13 2026 .\" NOTE: This file is generated, DO NOT EDIT. .de Vb .ft CW .nf .. .de Ve .ft R .fi .. .TH "LATEX2MAN" "1" "2026/01/16" "Documentation Tools " "Documentation Tools " .SH "نام (NAME)" latex2man \- ابزاری برای ترجمه صفحه‌های راهنمای یونیکس نوشته‌شده با LaTeX به قالب قابل‌فهم برای man .PP همچنین می‌توان کدهای HTML، TexInfo یا LaTeX را تولید کرد. با استفاده از قابلیت متن شرطی می‌توان از تولید بخش‌هایی از متن جلوگیری کرد (برای این منظور، تولید LaTeX می‌تواند به کار رود). .PP .SH "خلاصه دستور (SYNOPSIS)" .PP latex2man [\fB\-t\fP\fItransfile\fP] [\fB\-c\fP\fICSSfile\fP] [\fB\-HMTL\fP] [\fB\-h\fP] [\fB\-V\fP] [\fB\-C\fP\fIname\fP] [\fB\-a\fP\fIchar\fP] \fIinfile\fP \fIoutfile\fP .PP .SH "توضیحات (DESCRIPTION)" ابزار Latex2man فایل \fIinfile\fP را می‌خواند و در \fIoutfile\fP\& می‌نویسد. ورودی باید یک سند LaTeX باشد که از بسته latex2man در LaTeX استفاده می‌کند. ابزار Latex2man آن سند را با استفاده از بسته ماکروی \fB\-man\fP به قالب \fItroff\fP(1) ترجمه می‌کند. .PP با استفاده از گزینه \fB\-H\fP می‌توان به‌جای \fItroff\fP(1)\&، کد HTML تولید کرد. با این گزینه می‌توانید به‌طور اختیاری یک \fICSSfile\fP را به‌عنوان آرگومان مشخص کنید. شیوه‌نامه‌های آبشاری (CSS) به شما امکان می‌دهند تا ظاهر صفحه HTML حاصل را کنترل کنید. برای آگاهی از نام کلاس‌های CSS که به‌عنوان صفت (attribute) در تگ‌های HTML قرار می‌گیرند، به ادامه مطلب مراجعه کنید. .PP با استفاده از گزینه \fB\-T\fP می‌توان به‌جای \fItroff\fP(1)\&، کد TexInfo تولید کرد. .PP با استفاده از گزینه \fB\-M\fP، ورودی \fItroff\fP(1) تولید می‌شود. .PP با استفاده از گزینه \fB\-L\fP می‌توان به‌جای \fItroff\fP(1)\&، خروجی LaTeX تولید کرد. .PP .SH "گزینه‌ها (OPTIONS)" .TP \fB\-t\fP\fItransfile\fP ترجمه ماکروهای LaTeX تعریف‌شده توسط کاربر. .TP \fB\-c\fP\fICSSfile\fP اگر از \fB\-H\fP استفاده کنید، می‌توانید فایلی حاوی شیوه‌نامه‌های CSS را نیز تعیین نمایید. پیوند به فایل CSS با استفاده از نام فایل \fICSSfile\fP مشخص‌شده، درون خروجی HTML تولیدشده درج می‌شود. .TP \fB\-M\fP تولید خروجی مناسب برای دستور \fIman\fP(1) (پیش‌فرض). .TP \fB\-H\fP به‌جای تولید خروجی مناسب برای دستور \fIman\fP(1)، کد HTML تولید می‌شود (علیرغم نام دستور). .TP \fB\-T\fP به‌جای تولید خروجی مناسب برای دستور \fIman\fP(1)، کد TexInfo تولید می‌شود (علیرغم نام دستور). فایل \&.texi تولیدشده می‌تواند با \fImakeinfo\fP(1) پردازش شود (برای تولید یک فایل \&.info) که آن هم به نوبه خود می‌تواند با استفاده از \fIinstall\-info\fP(1)\& نصب گردد. برچسب‌های Info شامل @dircategory و @direntry فراهم شده‌اند. .TP \fB\-L\fP کد منبع LaTeX در \fIoutfile\fP\& نوشته می‌شود. این گزینه در ترکیب با گزینه \fB\-C\fP\fIname\fP کاربرد دارد. .TP \fB\-C\fP\fIname\fP نمایش متن شرطی برای \fIname\fP\&. اگر باید بیش از یک نام مشخص شود از نقل‌قول استفاده کنید: \fB\-C\fP\fI\&'name1 name2 ...\&'\fP .br نام‌های زیر به‌طور خودکار تعریف شده‌اند: .RS .TP .B * \fB\-H\fP مقدار HTML را تعریف می‌کند .TP .B * \fB\-T\fP مقدار TEXI را تعریف می‌کند .TP .B * \fB\-M\fP مقدار MAN را تعریف می‌کند .TP .B * \fB\-L\fP مقدار LATEX را تعریف می‌کند .RE .RS .PP .RE .TP \fB\-a\fP\fIchar\fP تنها در ترکیب با \-T استفاده می‌شود. .br پیش‌زمینه: .br سامانه TexInfo تمام فاصله‌های خالی را پیش از نخستین کلمه در یک خط جدید نادیده می‌گیرد. برای ایجاد مقداری فاصله اضافی پیش از آن کلمه (با استفاده از \\SP)، باید نویسه‌ای پیش از این فاصله اضافی چاپ شود. به‌طور پیش‌فرض این نویسه یک \&. (نقطه) است. آرگومان \fIchar\fP نویسه جایگزینی را برای آن نویسه اول تعیین می‌کند. دادن یک فاصله خالی به \fB\-a\fP تورفتگی خط را لغو می‌کند. .br نکته: آن \fIchar\fP تنها برای نخستین \\SP از یک دنباله چاپ می‌شود. .TP \fB\-h\fP نمایش متن راهنما. .TP \fB\-V\fP نمایش اطلاعات نگارش. .PP.SH "فایل‌ها (FILES)" .PP .TP latex2man.tex فایل LaTeX حاوی این صفحهٔ راهنما (Man\-page). .TP latex2man.inc فایلی که با \\input{..} خوانده می‌شود\&. .TP latex2man.sty بستهٔ LaTeX که محیط‌ها و دستورها را تعریف می‌کند. .TP latex2man.cfg فایل پیکربندی برای بستهٔ LaTeX ابزار Latex2man. .TP latex2man.css فایل حاوی نمونه‌تعاریف CSS. .TP latex2man.trans فایل حاوی نمونه‌ترجمه‌های ماکروهای LaTeX تعریف‌شده توسط کاربر. .TP fancyheadings.sty یک بستهٔ LaTeX مورد استفاده برای حروف‌چینی خطوط سرصفحه و پاصفحه. .TP fancyhdr.sty یک بستهٔ LaTeX مورد استفاده برای حروف‌چینی خطوط سرصفحه و پاصفحه. .TP rcsinfo.sty یک بستهٔ LaTeX مورد استفاده برای استخراج و استفاده از اطلاعات کنترل نسخهٔ RCS در اسناد LaTeX. .PP .TP \fBlatex2man.pdf\fP نسخهٔ PDF این سند. .PP .SH "همچنین ببینید (SEE ALSO)" .PP LaTeX,TexInfo, \fItroff\fP(1), \fIgroff\fP(1), \fImakeinfo\fP(1)\&. .PP .SH "دستورهای لاتک (LaTeX COMMANDS)" .PP بستهٔ LaTeX با نام latex2man برای نوشتن صفحات راهنما با LaTeX استفاده می‌شود\&. از آن‌جا که ما سند را به دیگر قالب‌های متنی ترجمه می‌کنیم، همهٔ قابلیت‌های LaTeX قابل ترجمه نیستند. .PP .SS "گزینه‌های بسته (PACKAGE OPTIONS)" بستهٔ latex2man گزینه‌های زیر را می‌پذیرد: .PP .TP fancy استفاده از بستهٔ LaTeX با نام fancyheadings\&. .TP fancyhdr استفاده از بستهٔ LaTeX با نام fancyhdr\&. .TP nofancy نه از بستهٔ LaTeX با نام fancyheadings و نه از fancyhdr استفاده نمی‌شود. .PP گزینهٔ پیش‌فرض را می‌توان در فایل latex2man.cfg مشخص کرد\&. .PP .SS "محیط‌های خاص بسته (PACKAGE SPECIFIC ENVIRONMENTS)" .PP محیط‌های زیر توسط این بسته ارائه می‌شوند: .TP \\begin{Name}{chapter}{name}{author}{info}{title} محیط Name پنج آرگومان می‌گیرد: ۱. فصل صفحهٔ راهنما، ۲. نام صفحهٔ راهنما، ۳. نویسنده، ۴. اطلاعاتی کوتاه دربارهٔ ابزار که در خط پاصفحهٔ صفحهٔ راهنما چاپ می‌شود، و ۵. متنی که به عنوان عنوان برای HTML و LaTeX استفاده می‌شود (برای خروجی صفحهٔ راهنما یا TeXinfo نادیده گرفته می‌شود). محیط Name باید نخستین محیط در سند باشد. پردازش با این محیط آغاز می‌شود. هر متنی پیش از آن نادیده گرفته می‌شود (استثنا: دستورهای setVersion و setDate). (توجه: تمام آرگومان‌های \\begin{Name} باید در یک خط نوشته شوند). .TP \\begin{Table}[width]{columns} محیط Table دو آرگومان می‌گیرد: نخستین آرگومانِ اختیاری پهنای ستون آخر را مشخص می‌کند، و دومی تعداد ستون‌ها را تعیین می‌کند. برای نمونه: .PP \\begin{Table}[2cm]{3} .br Here & am & I \\\\\\hline .br A 1 & A 2 & A 3 1 2 3 4 5 A 3 1 2 3 4 5 \\\\ .br B 1 & B 2 & B 3 \\\\ .br \\end{Table} .PP به‌صورت زیر حروف‌چینی خواهد شد: .PP .TS tab(&); l l lw(2cm). T{ Here T}&T{ am T}&T{ I T} _ T{ A 1 T}&T{ A 2 T}&T{ A 3 1 2 3 4 5 A 3 1 2 3 4 5 T} T{ B 1 T}&T{ B 2 T}&T{ B 3 T} .TE .PP اگر آرگومان اختیاری \fIwidth\fP داده نشود، همهٔ مدخل‌ها چپ‌چین حروف‌چینی می‌شوند. مقدار \fIwidth\fP طولی است که به‌صورت مطلق برحسب \fIcm\fP اندازه‌گیری می‌شود\&. در پردازش با LaTeX، ستون آخر به‌صورت یک ستون p{width} حروف‌چینی می‌شود. ترجمه به دستورهای \fItroff\fP(1) منجر به مشخصهٔ ستون lw(width) می‌شود. ترجمه به HTML و TexInfo پارامتر \fIwidth\fP را نادیده می‌گیرد. .PP می‌توان از \\hline استفاده کرد. .PP اگر صفحهٔ راهنما با \fItroff\fP(1) قالب‌بندی شود و جدول‌ها به کار رفته باشند، پیش‌پردازندهٔ \fItbl\fP(1) باید فراخوانی شود، که معمولاً با دادن گزینهٔ \fB\-t\fP به فراخوانی \fItroff\fP(1) انجام می‌گیرد\&. هنگام مشاهدهٔ صفحهٔ راهنمای تولیدشده با استفاده از \fIman\fP(1)، ابزار \fItbl\fP(1) به‌صورت خودکار فراخوانی می‌شود. .TP \\begin{Description} همانند \\begin{description} است. .TP \\begin{Description}[label] مشابه \\begin{description} است، با این تفاوت که برچسب‌های موارد حداقل هم‌اندازه با کلمهٔ (اختیاری) \fIlabel\fP خواهند بود\&. این تفاوت تنها در خروجی DVI و PDF قابل مشاهده است، نه در خروجی troff، TexInfo یا HTML. .RS .TP a |a \\begin{description} .TP ab |ab.TP abc |abc .RE .RS .PP .RS .RE .TP a |a \\begin{Description} .TP ab |ab .TP abc |abc .RE .RS .PP .RS .RE .TP a |a \\begin{Description}[aa] .TP ab |ab .TP abc |abc .RE .RS .PP .RE .PP .SS "محیط‌های LaTeX پذیرفته‌شده (ACCEPTED LaTeX ENVIRONMENTS)" .PP محیط‌های زیر پذیرفته می‌شوند: .TP .B * description .TP .B * enumerate .TP .B * itemize .TP .B * verbatim .TP .B * center .PP آن‌ها می‌توانند تو در تو باشند: .TP .B * Itemize و center تو در تو: .ce 100 یک خط وسط‌چین‌شده. .br خط وسط‌چین‌شدهٔ دیگر. .ce 0 .TP .B * موردی دیگر و enumerate تو در تو .RS .TP 1. a .TP 2. b .RE .RS .PP .RE .PP.SS "ماکروهای ویژه بسته (PACKAGE SPECIFIC MACROS)" .PP دستورهای زیر ارائه شده‌اند: .TP \\Opt{option} گزینه: \\Opt{\-o} به‌صورت \fB\-o\fP حروف‌چینی می‌شود\&. .TP \\Arg{argument} آرگومان: \\Arg{filename} به‌صورت \fIfilename\fP حروف‌چینی می‌شود\&. .TP \\OptArg{option}{argument} گزینه به همراه آرگومان: .br \\OptArg{\-o}{filename} به‌صورت \fB\-o\fP\fIfilename\fP حروف‌چینی می‌شود\&. .TP \\OptoArg{option}{argument} گزینه به همراه آرگومان اختیاری: .br \\OptoArg{\-o}{filename} به‌صورت \fB\-o\fP[\fIfilename\fP]\& حروف‌چینی می‌شود\&. .TP \\oOpt{option} گزینه اختیاری، برای مثال \\oOpt{\-o} به‌صورت [\fB\-o\fP]\& حروف‌چینی می‌شود\&. .TP \\oArg{argument} آرگومان اختیاری، برای مثال \\oArg{filename} به‌صورت [\fIfilename\fP]\& حروف‌چینی می‌شود\&. .TP \\oOptArg{option}{argument} گزینه اختیاری همراه با آرگومان، برای مثال .br \\oOptArg{\-o}{filename} به‌صورت [\fB\-o\fP\fIfilename\fP]\& حروف‌چینی می‌شود\&. .TP \\oOptoArg{option}{argument} گزینه اختیاری با آرگومان اختیاری، برای مثال .br \\oOptoArg{\-o}{filename} به‌صورت [\fB\-o\fP[\fIfilename\fP]]\& حروف‌چینی می‌شود\&. .TP \\File{filename} برای حروف‌چینی نام فایل‌ها استفاده می‌شود، برای مثال \\File{filename} به‌صورت filename\& حروف‌چینی می‌شود\&. .TP \\Prog{prog} برای حروف‌چینی نام برنامه‌ها استفاده می‌شود، برای مثال \\Prog{latex2man} به‌صورت latex2man\& حروف‌چینی می‌شود\&. .TP \\Cmd{command}{chapter} برای حروف‌چینی ارجاع‌ها به سایر دستورها استفاده می‌شود، برای مثال .br \\Cmd{latex2man}{1} به‌صورت \fIlatex2man\fP(1)\& حروف‌چینی می‌شود\&. .TP \\Bar به‌صورت |\& حروف‌چینی می‌شود\&. .TP \\Bs (BackSlash) به‌صورت \\\& حروف‌چینی می‌شود\&. .TP \\Tilde به‌صورت یک ~\& حروف‌چینی می‌شود\&. .TP \\Dots به‌صورت \&...\& حروف‌چینی می‌شود\&. .TP \\Bullet به‌صورت *\& حروف‌چینی می‌شود\&. .TP \\setVersion{\&.\&.} مقدار \&.. را به‌عنوان اطلاعات نسخه تنظیم می‌کند\&. .TP \\setVersionWord{\&.\&.} مقدار \&.. را برای کلمه \fIVersion:\fP در خط پاورقی تنظیم می‌کند\&. .br پیش‌فرض \\setVersionWord{Version:}\& است\&. .TP \\Version اطلاعات نسخه را برمی‌گرداند\&. .TP \\setDate{\&.\&.} مقدار \&.. را به‌عنوان اطلاعات تاریخ تنظیم می‌کند\&. .TP \\Date اطلاعات تاریخ را برمی‌گرداند\&. .TP \\Email{\&.\&.} برای مشخص کردن نشانی رایانامه (Email) استفاده می‌شود: .br \\Email{Juergen.Vollmer@informatik\-vollmer.de} به‌صورت زیر حروف‌چینی می‌شود: .br \fBJuergen.Vollmer@informatik\-vollmer.de\fP\&. .TP \\URL{\&.\&.} برای مشخص کردن یک نشانی وب (URL) استفاده می‌شود: \\URL{http://www.foo.de/\\Tilde vollmer} به‌صورت زیر حروف‌چینی می‌شود: .br \fBhttp://www.foo.de/~vollmer\fP\&. .TP \\LatexManEnd فایل ورودی تا زمان رسیدن به پایان فایل (end\-of\-file) یا .br \\LatexManEnd (در ابتدای یک سطر) خوانده و پردازش می‌شود\&. LaTeX این دستور را نادیده می‌گیرد\&. .TP \\Lbr, \\Rbr به‌صورت [ و ] حروف‌چینی می‌شوند (این متغیرها تنها در مواقع خاصی نیاز هستند، مانند .br \\item[FooBar\\LBr xx \\Lbr]\&. معمولاً همان [ ] کار خواهد کرد)\&. .TP \\LBr, \\RBr به‌صورت { و } حروف‌چینی می‌شوند (این متغیرها هنگام استفاده از { یا } به‌عنوان آرگومان‌های ماکروها مورد نیاز هستند)\&. .TP \\Circum به‌صورت ^\& حروف‌چینی می‌شود\&. .TP \\Percent به‌صورت %\& حروف‌چینی می‌شود\&. .TP \\TEXbr اگر با LaTeX پردازش شود، باعث شکست سطر می‌شود (یعنی معادل \\\\ است)\&. در خروجی latex2man این ماکرو نادیده گرفته می‌شود\&. .TP \\TEXIbr اگر خروجی TexInfo تولید شود، باعث شکست سطر می‌شود (یعنی معادل \\\\ است)، در غیر این صورت نادیده گرفته می‌شود\&. .TP \\MANbr اگر خروجی Man\-Page تولید شود، باعث شکست سطر می‌شود (یعنی معادل \\\\ است)، در غیر این صورت نادیده گرفته می‌شود\&. .TP \\HTMLbr اگر خروجی HTML تولید شود، باعث شکست سطر می‌شود (یعنی معادل \\\\ است)، در غیر این صورت نادیده گرفته می‌شود\&. .TP \\medskip یک سطر خالی\&. .TP \\SP مقداری فاصله خالی اضافی تولید می‌کند و در ابتدای سطرها نیز کار می‌کند\&. کد سطر دوم بدین صورت است: \\SP abc \\SP\\SP xx\\\\: .br abc \fB \fP\fB \fP\fB \fPxx .br \fB \fPabc \fB \fP\fB \fPxx .br \fB \fP\fB \fPabc \fB \fPxx .PP نکته: به دلیل برخی «مشکلات» در TexInfo، سطرهایی که با \\SP آغاز می‌شوند دارای یک \&. (نقطه) آغازین در خروجی TexInfo خواهند بود، \fB\-a\fP\fIchar\fP را ببینید\&. .PP.SS "ماکروهای پذیرفته‌شده از بسته RCSINFO (ACCEPTED MACROS FROM THE RCSINFO PACKAGE)" .PP .TP \\rcsInfo $Id ...$ در صورت استفاده از بستهٔ LaTeX به نام rcsinfo، از این دستور برای استخراج تاریخ صفحهٔ راهنما (Man\-page) استفاده می‌شود. .TP \\rcsInfoLongDate در صورت استفاده از بستهٔ LaTeX به نام rcsinfo، از این دستور برای حروف‌چینی تاریخ کدگذاری‌شده در رشتهٔ $Id ..$ استفاده می‌شود. .PP .SS "ماکروهای پذیرفته‌شده LaTeX (ACCEPTED LaTeX MACROS)" .PP دستورهای استاندارد LaTeX زیر پذیرفته می‌شوند: .TP \\section{\&.\&.} ماکروی section یک آرگومان می‌گیرد: نام بخش صفحهٔ راهنما (Man\-page). هر صفحهٔ راهنما از چندین بخش تشکیل شده است. معمولاً بخش‌های زیر در یک صفحهٔ راهنما وجود دارند: \fIName\fP (مدیریت ویژه به عنوان محیط، رک. به بالا)، \fISynopsis\fP، \fIDescription\fP، \fIOptions\fP، \fIFiles\fP، \fISee Also\fP، \fIDiagnostics\fP، \fIReturn Values\fP، \fIBugs\fP، \fIAuthor\fP، \fIversion\fP و غیره. .PP بخش \fISynopsis\fP باید نخستین بخش پس از محیط Name باشد. .PP نکته: در نام بخش‌ها از ماکروهای LaTeX استفاده نکنید. .TP \\subsection{\&.\&.} به خوبی کار می‌کند، همانند .TP \\subsubsection{\&.\&.} این دستور. .TP \\emph{\&.\&.} دستور \\emph{example} به صورت \fIexample\fP\& حروف‌چینی می‌شود. .TP \\textbf{\&.\&.} دستور \\textbf{example} به صورت \fBexample\fP\& حروف‌چینی می‌شود. .TP \\texttt{\&.\&.} دستور \\texttt{example} به صورت example\& حروف‌چینی می‌شود. .TP \\underline{\&.\&.} دستور \\underline{example} به صورت .ul example of underline \&. حروف‌چینی می‌شود. .TP \\date{\&.\&.} از \&.. به عنوان تاریخ استفاده می‌کند. .TP \\verb+..+ اما تنها + به عنوان جداکننده مجاز است. .TP $<$ به صورت <\& حروف‌چینی می‌شود. .TP $>$ به صورت >\& حروف‌چینی می‌شود. .TP $<=$ به صورت <=\& حروف‌چینی می‌شود. .TP $>=$ به صورت >=\& حروف‌چینی می‌شود. .TP $=$ به صورت =\& حروف‌چینی می‌شود. .TP $<>$ به صورت <>\& حروف‌چینی می‌شود. .TP $\\ge$ به صورت $>=$ حروف‌چینی می‌شود. .TP $\\le$ به صورت $<=$ حروف‌چینی می‌شود. .TP $\\leftarrow$ به صورت $<--$ حروف‌چینی می‌شود. .TP $\\Leftarrow$ به صورت $<==$ حروف‌چینی می‌شود. .TP $\\rightarrow$ به صورت $-->$ حروف‌چینی می‌شود. .TP $\\Rightarrow$ به صورت $==>$ حروف‌چینی می‌شود. .TP \\{ به صورت {\& حروف‌چینی می‌شود. .TP \\} به صورت }\& حروف‌چینی می‌شود. .TP \\$ به صورت $\& حروف‌چینی می‌شود. .TP \\$ به صورت $ حروف‌چینی می‌شود؛ باید درون آرگومان‌های ماکرو استفاده شود. .TP \\_ به صورت _\& حروف‌چینی می‌شود. .TP \\& به صورت &\& حروف‌چینی می‌شود. .TP \\# به صورت #\& حروف‌چینی می‌شود. .TP \\% به صورت %\& حروف‌چینی می‌شود. .TP \\, به صورت یک فاصلهٔ کوچک‌تر \- \- (بین دو \-) حروف‌چینی می‌شود .TP \\\- برای مشخص کردن پیوند خط فاصله (hyphenation) در یک کلمه استفاده می‌شود. .TP \\\\ به صورت شکست خط حروف‌چینی می‌شود یا نشان‌دهندهٔ پایان یک ستون در محیط Table است. .TP \\ (یک \\ به همراه یک فاصله) به صورت یک فاصله حروف‌چینی می‌شود، اگرچه نمی‌توان از آن در ابتدای خط برای ایجاد تورفتگی استفاده کرد (دستور \\SP را ببینید). .TP ~ به صورت یک فاصله حروف‌چینی می‌شود. .TP \\copyright به صورت (C)\& حروف‌چینی می‌شود. .TP \\noindent .TP \\hline درون یک محیط Table\&. .TP \\item درون محیط‌های itemize، enumerate یا description\&. .TP \\today 16 ژانویه 2026 (همچنین بستهٔ LaTeX به نام rcsinfo را ببینید). .TP \\ss,\\"a, ... \\ss = ß, \\"a= ä, \\"o= ö, \\"u= ü, \\"A= Ä, \\"O= Ö, \\"U= Ü. قرار دادن این ماکروها درون { و } در همه جا مجاز است، حتی درون سایر ماکروها؛ مانند: .Vb \\textbf{\\"a\\"o\\"u\\"A\\"O\\"U\\ss} \\textbf{\\"a}{\\"o}{\\"u}{\\"A}{\\"O}{\\"U}{\\ss}} \\textbf{äöüÄÖÜß} .Ve .PP \fBäöüÄÖÜß äöüÄÖÜß äöüÄÖÜß\fP .PP اگر این حروف در کدگذاری 8\-بیتی LATIN\-1 استفاده شوند، به حرف معادل در قالب خروجی مورد نظر ترجمه می‌شوند. به عنوان مثال Ä در HTML تبدیل به Ä و در texinfo تبدیل به @"A می‌شود. .TP \\input{\&.\&.} خواندن و پردازش نام فایل داده‌شده. .PP لطفاً توجه کنید: نام ماکروهای LaTeX و آرگومان‌های آن باید همگی در یک خط قرار گیرند. .PP.SS متن شرطی (CONDITIONAL TEXT) .PP latex2man ورودی LaTeX را پیش‌پردازش می‌کند تا امکان استفاده شرطی از متن فراهم شود. برای این منظور نوع خاصی از کامنت LaTeX استفاده می‌شود. .TP .B * %@% IF \fIcondition\fP %@% .TP .B * %@% ELSE %@% .TP .B * %@% END\-IF %@% .PP یک خط باید تنها شامل چنین کامنتی باشد و هیچ چیز دیگری در آن قرار نگیرد. \fIcondition\fP یک عبارت بولی شامل «نام‌ها» و عملگرها است. نام‌هایی که با گزینه \fB\-C\fP\fIname\fP داده می‌شوند دارای مقدار «true\&» هستند، در حالی که فرض می‌شود سایر نام‌های حاضر در عبارت «false\&» باشند. اگر ارزیابی عبارت بولی به مقدار «true\&» بیانجامد، متن بخش «then\&» استفاده شده و از متن بخش اختیاری «else\&» صرف‌نظر می‌شود (و بالعکس). ساختارهای IF/ELSE/END\-IF می‌توانند تودرتو باشند. به عنوان عملگرهای بولی موارد زیر مجاز هستند: .PP .TS tab(&); l l. T{ ||T}&T{ «یا»ی بولی T} T{ &&T}&T{ «و»ی بولی T} T{ ! T}&T{ نقیض .TE .PP استفاده از ( و ) برای گروه‌بندی مجاز است. .PP برای مثال: .br %@% IF abc %@% .br abc set .br %@% IF xyz %@% .br xyz set .br %@% ELSE %@% .br xyz NOT set .br %@% END\-IF %@% .br %@% ELSE %@% .br abc NOT set .br %@% IF xyz || !XYZ %@% .br xyz OR !XYZ set .br %@% ELSE %@% .br xyz OR !XYZ NOT set .br %@% END\-IF %@% .br %@% END\-IF %@% .PP این صفحه راهنما را از طریق latex2man با مثلاً \fB\-C\fP\fI\&'abc XYZ\&'\fP اجرا کنید و نگاهی به خروجی تولیدشده بیندازید. (در صورت اجرای ساده سند LaTeX با LaTeX، تمام خطوط در فایل \&.dvi نمایش داده می‌شوند). .br abc NOT set .br xyz OR !XYZ set .br .PP برای بررسی قابلیت متن شرطی، هنگامی که latex2man با گزینه‌های زیر فراخوانی شود .TP \fB\-C\fP\fIHTML\fP خط‌های 1a، 2b، 3b، و 4b؛ .TP \fB\-C\fP\fITEXI\fP خط‌های 1b، 2a، 3b، و 4b؛ .TP \fB\-C\fP\fIMAN\fP خط‌های 1b، 2b، 3a، و 4b؛ .TP \fB\-C\fP\fILATEX\fP خط‌های 1b، 2b، 3b، و 4a؛ .TP فراخوانی LaTeX بدون پیش‌پردازش تمام خطوط .PP باید نمایش داده شوند: .PP 1b. شرط HTML تنظیم نشده بود. .PP 2b. شرط TEXI تنظیم نشده بود. .PP 3a. این متن تنها هنگام مشاهده خروجی MAN ظاهر می‌شود .PP 4b. شرط LATEX تنظیم نشده بود. .PP.SS "ترجمه ماکروهای تعریف‌شده توسط کاربر (TRANSLATION OF USER DEFINED MACROS)" .PP فایل ترجمه ماکروی کاربر (مشخص‌شده با [\fB\-t\fP\fItransfile\fP]) حاوی دستورات Perl است که ترجمه ماکروهای LaTeX تعریف‌شده توسط کاربر را مشخص می‌کند. این ماکروها ممکن است بدون آرگومان، دارای یک یا دو آرگومان باشند. کدهای زیر مورد انتظار است: .PP .TP .B * کامنت‌ها با # شروع می‌شوند و تا انتهای خط ادامه دارند. .TP .B * برای یک ماکروی \\foo بدون آرگومان، کد زیر باید مشخص شود: .RS .TP ترجمه به Man\-Pages $manMacro{'foo'} = '...'; .TP ترجمه به HTML $htmlMacro{'foo'} = '...'; .TP ترجمه به TexInfo $texiMacro{'foo'} = '...'; .RE .RS .PP که در آن \&... ترجمه است. .PP .RE .TP .B * برای یک ماکروی \\foo{..} با یک آرگومان، کد زیر باید مشخص شود: .RS .TP ترجمه به Man\-Pages $manMacro1a{'foo'} = '...'; .br $manMacro1b{'foo'} = '...'; .TP ترجمه به HTML $htmlMacro1a{'foo'} = '...'; .br $htmlMacro1b{'foo'} = '...'; .RS .PP .RE .TP ترجمه به TexInfo $texiMacro1a{'foo'} = '...'; .br $texiMacro1b{'foo'} = '...'; .RE .RS .PP که در آن \&... ترجمه است. کد 1a پیش از آرگومان استفاده می‌شود، در حالی که 1b پس از قرار گرفتن آرگومان حروف‌چینی می‌شود. .PP .RE .TP .B * برای یک ماکروی \\foo{..}{..} با دو آرگومان، کد زیر باید مشخص شود: .RS .TP ترجمه به Man\-Pages $manMacro2a{'foo'} = '...'; .br $manMacro2b{'foo'} = '...'; .br $manMacro2c{'foo'} = '...'; .TP ترجمه به HTML $htmlMacro2a{'foo'} = '...'; .br $htmlMacro2b{'foo'} = '...'; .br $htmlMacro2c{'foo'} = '...'; .TP ترجمه به TexInfo $texiMacro2a{'foo'} = '...'; .br $texiMacro2b{'foo'} = '...'; .br $texiMacro2c{'foo'} = '...'; .RE .RS .PP که در آن \&... ترجمه است. کد 2a پیش از آرگومان اول، 2b بین دو آرگومان و 2c پس از قرار گرفتن آرگومان دوم حروف‌چینی می‌شود. .RE .TP .B * فایل latex2man.trans حاوی چند نمونه کد است. .PP.SS "محیط VERBATIM (VERBATIM ENVIRONMENT)" .PP .Vb This {is} \\texttt{a} $test$ _of_ verbatim and no @* TexInfo command .Ve .PP .SS "کارکرد زیربخش (SUBSECTION WORKS)" .PP این یک \\subsection\& است. .PP .SS "کارکرد زیر-زیربخش (Subsubsection works)" .PP این یک \\subsubsection\& است. .PP .SS "همچنان کارکرد زیر-زیربخش (Subsubsection still works)" .PP این یک \\subsubsection\& دیگر است. .PP .SS "نکات کلی (GENERAL REMARKS)" .PP .TP 1. خط‌های خالی به عنوان جداکننده‌های بند (پاراگراف) حروف‌چینی می‌شوند. .TP 2. آرگومان‌های دستورهای LaTeX نباید در چندین خط شکسته شوند. .TP 3. از تو در تو کردن فراخوانی ماکروها خودداری کنید. .TP 4. به‌جز محیط و ماکروهای ذکرشده، استفاده از سایر محیط‌ها یا ماکروهای LaTeX ترجمه نمی‌شود. استفاده از آن‌ها باعث ایجاد محتوای نامفهوم در خروجی خواهد شد. .TP 5. ابزار latex2man به نسخه Perl برابر یا بالاتر از 5.0004_03 نیاز دارد. .TP 6. اگر می‌خواهید سامانه را با Makefile توزیع‌شده نصب کنید، به GNU\-make نیاز دارید. اگر آن را ندارید، باید مراحل نشان‌داده‌شده در Makefile را به‌صورت دستی اجرا کنید. .PP .SH "نام‌های کلاس CSS (CSS CLASSNAMES)" .PP جدول زیر نام کلاس‌های CSS را نشان می‌دهد که به عنوان مشخصه در برچسب‌های HTML قرار خواهند گرفت. می‌توانید ویژگی‌های سبک CSS را در \fICSSfile\fP برای این کلاس‌ها مشخص کنید: .PP .TS tab(&); l l lw(8.5cm). T{ \fBبرچسب HTML\fP T}&T{ \fBکلاس\fP T}&T{ \fBسبک اعمال می‌شود به\fP T} T{ body T}&T{ T}&T{ بدنه صفحه HTML T} T{ h1 T}&T{ titlehead T}&T{ عنوان در بالای صفحه HTML که به عنوان یک آرگومان برای محیط \fIName\fP مشخص شده است T} T{ h4 T}&T{ authorhead T}&T{ نویسنده در بالای صفحه HTML که به عنوان یک آرگومان برای محیط \fIName\fP مشخص شده است T} T{ h4 T}&T{ datehead T}&T{ تاریخ در بالای صفحه HTML T} T{ h4 T}&T{ versionhead T}&T{ نسخه صفحه راهنما در بالای صفحه HTML که به عنوان یک آرگومان برای ماکروی \fIsetVersion\fP مشخص شده است T} T{ h2 T}&T{ sectionname T}&T{ یک عنوان بخش که به عنوان یک آرگومان برای ماکروی \fIsection\fP مشخص شده است T} T{ h4 T}&T{ subsectionname T}&T{ یک عنوان زیربخش که به عنوان یک آرگومان برای ماکروی \fIsubsection\fP مشخص شده است T} T{ h5 T}&T{ subsubsectionname T}&T{ یک عنوان زیر-زیربخش که به عنوان یک آرگومان برای ماکروی \fIsubsubsection\fP مشخص شده است T} T{ font T}&T{ progname T}&T{ یک نام برنامه که به عنوان یک آرگومان برای ماکروی \fIProg\fP مشخص شده است T} T{ font T}&T{ filename T}&T{ یک نام فایل که به عنوان یک آرگومان برای ماکروی \fIFile\fP مشخص شده است T} T{ font T}&T{ commandname T}&T{ یک نام دستور که به عنوان یک آرگومان برای ماکروی \fICmd\fP مشخص شده است T} T{ font T}&T{ textstyle T}&T{ تمام متنی که آرگومان هیچ ماکروی LaTeX یا latex2man نیست T} T{ font T}&T{ optstyle T}&T{ نام یک گزینه که به عنوان یک آرگومان برای ماکروهای \fIOpt\fP، \fIoOpt\fP، \fIOptArg\fP، \fIoOptArg\fP یا \fIoOptoArg\fP مشخص شده است T} T{ font T}&T{ argstyle T}&T{ نام یک آرگومان که به عنوان یک آرگومان برای ماکروهای \fIArg\fP، \fIoArg\fP، \fIOptArg\fP، \fIoOptArg\fP یا \fIoOptoArg\fP مشخص شده است T} T{ a, font T}&T{ urlstyle T}&T{ یک نشانی وب (URL) که به عنوان یک آرگومان برای ماکروی \fIURL\fP مشخص شده است T} T{ a, font T}&T{ urlstyle.link T}&T{ زیرکلاسِ کلاس urlstyle T} T{ a, font T}&T{ urlstyle.visited T}&T{ زیرکلاسِ کلاس urlstyle T} T{ a, font T}&T{ urlstyle.hover T}&T{ زیرکلاسِ کلاس urlstyle T} T{ a, font T}&T{ emailstyle T}&T{ یک ایمیل که به عنوان یک آرگومان برای ماکروی \fIEmail\fP مشخص شده است T} T{ a, font T}&T{ emailstyle.link T}&T{ زیرکلاسِ کلاس emailstyle T} T{ a, font T}&T{ emailstyle.visited T}&T{ زیرکلاسِ کلاس emailstyle T} T{ a, font T}&T{ emailstyle.hover T}&T{ زیرکلاسِ کلاس emailstyle T} T{ table T}&T{ tablestyle T}&T{ یک جدول که به عنوان محیط \fITable\fP مشخص شده است T} T{ tr T}&T{ rowstyle T}&T{ یک سطر از یک جدول که به عنوان محیط \fITable\fP مشخص شده است T} T{ td T}&T{ cellstyle T}&T{ یک سلول از یک جدول که به عنوان محیط \fITable\fP مشخص شده است T}.TE .PP .SH "برخی آزمون‌های رفع باگ (SOME BUG FIX TESTS)" .PP .TP نقطه (.) و \&' در ابتدای سطر اکنون نقطه (\&.) و \&' در ابتدای سطر در خروجی تولیدشده troff باید به‌درستی کار کنند، چرا که یک \\& اضافه شده است. بنابراین ماکروی \\Dot حذف شده است. .br با تشکر از \fBFrank.Schilder@Mathematik.Tu\-Ilmenau.De\fP\&. .br مورد آزمون ۱: .RS .TP \&'\\n\&' \&.\&.\&. .RE .RS .PP مورد آزمون ۲: .br \&.foobar مورد آزمون ۳: .br \&... .PP abc \&... abc \&. efg \&' 123 .PP .RE .TP % در verbatim یک % در محیط \\verb و verbatim به‌درستی در خروجی درج نمی‌شد. با تشکر از Aleksey Nogin \fBnogin@cs.caltech.edu\fP برای گزارش باگ و رفع آن. .PP % abc .PP .Vb % abc % .Ve .PP اما کامنت‌های پس از این را نادیده بگیرید: .PP .SH "نیازمندی‌ها (REQUIREMENTS)" .PP .TP Perl برنامه latex2man به نسخه 5.0004_03 یا بالاتر Perl نیاز دارد. .TP Make اگر می‌خواهید سیستم را با استفاده از Makefile ارائه‌شده نصب کنید، به GNU\-make نیاز دارید. اگر آن را ندارید، باید مراحل نشان‌داده‌شده در Makefile را به‌صورت دستی اجرا کنید. .TP LaTeX به LaTeX2e نیاز است. .PP .\" *********************************** start of \input{latex2man.inc} .SH "تغییرات (CHANGES)" لطفاً برای فهرست تغییرات و قدردانی از افرادی که در رفع باگ‌ها یا بهبودها مشارکت داشته‌اند، فایل \fBlatex2man\-CHANGES\fP را بررسی کنید. .PP .\" *********************************** end of \input{latex2man.inc} .SH "نسخه (VERSION)" .PP نسخه: 1.30 مورخ 2026/01/16\&. .PP .SH "مجوز و کپی‌رایت (LICENSE AND COPYRIGHT)" .PP .TP کپی‌رایت (C)1998, Dr. Jürgen Vollmer, Am Rennbuckel 21, D\-76185 Karlsruhe, Germany, .br \fBJuergen.Vollmer@informatik\-vollmer.de\fP .PP جدیدترین نسخه Latex2man را می‌توانید در صفحه خانگی من پیدا کنید: .br \fBhttp://www.informatik\-vollmer.de/software/latex2man.html\fP\&. .PP .TP مجوز این برنامه می‌تواند تحت شرایط مجوز عمومی پروژه لاتک (LaTeX Project Public License) توزیع‌شده از آرشیوهای CTAN در دایرکتوری macros/latex/base/lppl.txt بازتوزیع و/یا تغییر داده شود؛ چه نسخه ۱ این مجوز، یا هر نسخه بعدی آن. .PP .TP متفرقه اگر این نرم‌افزار را مفید یافتید، لطفاً یک کارت‌پستال از محلی که در آن زندگی می‌کنید برای من بفرستید. .PP.SH "نویسنده (AUTHOR)" .PP دکتر Jürgen Vollmer .br Am Rennbuckel 21 .br D\-76185 Karlsruhe .br ایمیل: \fBJuergen.Vollmer@informatik\-vollmer.de\fP .br وب: \fBhttp://www.informatik\-vollmer.de\fP\&. .PP .\" NOTE: This file is generated, DO NOT EDIT.