.\" 
.\" monodocs2html manual page.
.\" (C) 2006 Jonathan Pryor
.\" Author:
.\"   Jonathan Pryor (jonpryor@vt.edu)
.\"
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.TH "monodocs2html" 1
.SH "نام (NAME)"
monodocs2html \- ترجمه مستندات XML برنامه Monodoc به HTML
.SH "خلاصه دستور (SYNOPSIS)"
.B monodocs2html 
\-source:SOURCE_DIR \-dest:DEST_DIR
[OPTIONS]*
.SH "توضیحات (DESCRIPTION)"
دستور \fImonodocs2html\fR منسوخ شده و با \fBmdoc\fR(1) جایگزین گردیده است. به صفحه راهنمای
\fBmdoc-export-html\fR(1) مراجعه کنید.
.PP
برنامه
.I monodocs2html
ابزاری است که مستندات HTML را از فایل‌های XML مستندات Monodoc ایجاد می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.TP
.I \-dest:DEST_DIR
نوشتن فایل‌های HTML در دایرکتوری
.I DEST_DIR
\&.
.TP
.I \-dumptemplate
تخلیه قالب پیش‌فرض صفحه در خروجی استاندارد به طوری که بتوانید از آن به عنوان پایه‌ای برای یک قالب جدید جهت استفاده با گزینه
.I \-template
بهره ببرید.
.TP
.I \-ext:FILE_EXTENSION
.I FILE_EXTENSION
پسوند فایل برای فایل‌های تولیدشده است.
.Sp
مقدار پیش‌فرض
.I html
است.
.TP
.I \-?, \-help
نمایش اطلاعات آرگومان‌های برنامه.
.TP
.I \-onlytype:TYPE
تولید HTML تنها برای نوع
.I TYPE
\&.
.TP
.I \-source:SOURCE_DIR
.I SOURCE_DIR
دایرکتوری پایه‌ای است که حاوی مستندات XML برنامه Monodoc می‌باشد.
.Sp
این دایرکتوری باید شامل یک فایل
.I index.xml
\&، فایل‌های
.I namespace-name.xml
(یکی برای هر فضای نام)، و دایرکتوری‌های
.I namespace-name
(یکی برای هر فضای نام) باشد که این دایرکتوری‌ها فایل‌های
.I type.xml
حاوی مستندات monodoc را در خود جای داده‌اند.
.TP
.I \-template:TEMPLATE
تولید HTML با استفاده از قالب صفحه
.I TEMPLATE
\&.
.TP
.I \-V, \-version
نمایش اطلاعات نسخه و مجوز.
.SH "قالب الگو (TEMPLATE FORMAT)"
فایل الگو یک فایل XSLT است که باید سند XML ورودی زیر را پردازش کند:
.nf
	<Page>
	  <CollectionTitle>Collection Title</CollectionTitle>
	  <PageTitle>Page Title</PageTitle>
	  <Summary>Page Summary</Summary>
	  <Signature>Type Declaration</Signature>
	  <Remarks>Type Remarks</Remarks>
	  <Members>Type Members</Members>
	  <Copyright>Documentation Copyright</Copyright>
	</Page>
.fi
کد HTML تولیدشده همچنین از کلاس‌های CSS زیر استفاده می‌کند که باید به منظور قالب‌بندی مناسب خروجی تعریف شوند:
.RS
.ne 8
.TP
.I .CollectionTitle
.TP
.I .PageTitle
.TP
.I .Summary
.TP
.I .Signature
.TP
.I .Remarks
.TP
.I .Members
.TP
.I .Copyright
.TP
.I .Section
.TP
.I .SectionBox
.TP
.I .NamespaceName
.TP
.I .NamespaceSummary
.TP
.I .MemberName
.TP
.I .MemberSignature
.TP
.I .MemberBox
.TP
.I .Subsection
.TP
.I .SubsectionBox
.TP
.I .SignatureTable
.TP
.I .EnumerationsTable
.TP
.I .CodeExampleTable
.TP
.I .MembersListing
.TP
.I .TypesListing
.TP
.I .InnerSignatureTable
.TP
.I .TypePermissionsTable
.ne
.RE
.SH "پیوندهای HTML (HTML LINKS)"
تمامی اعضا در فایل HTML دارای یک صفت
.I id
هستند تا امکان پیوند دادن به یک عضو خاص فراهم شود. مقدار صفت
.I id
همان شناسه رشته‌ای (String ID) عضو مشخص‌شده است.
برای اطلاعات بیشتر بخش
.B STRING ID FORMAT
در صفحه راهنمای
.B monodocer
را مشاهده کنید.
.SH "فهرست‌های پستی (MAILING LISTS)"
.TP
برای جزئیات بیشتر به http://lists.ximian.com/mailman/listinfo/mono-docs-list مراجعه کنید.
.SH "وب‌گاه (WEB SITE)"
برای جزئیات بیشتر به http://www.mono-project.com مراجعه کنید