.TH OSAGE 1 "27 May 2009"
.SH "نام (NAME)"
osage \- فیلتری برای ترسیم گراف‌های خوشه‌بندی‌شده
.SH "خلاصه دستور (SYNOPSIS)"
\fBosage\fR
[\fB\-\fR(\fBG\fR|\fBN\fR|\fBE\fR)\fIname=value\fR]
[\fB\-T\fIlang\fR]
[\fB\-l\fIlibfile\fR]
[\fB\-o\fIoutfile\fR]
[\fB\-O\fR]
[\fB\-P\fR]
[\fB\-v\fR]
[\fB\-V\fR]
[files]
.SH "توضیحات (DESCRIPTION)"
دستور
.I osage
گراف‌های خوشه‌بندی‌شده را ترسیم می‌کند. این ابزار به عنوان ورودی هر گرافی با قالب
.I dot
را می‌پذیرد. این برنامه گراف را به صورت بازگشتی رسم می‌کند. در هر سطح، مجموعه‌ای از گره‌ها و مجموعه‌ای از زیرگراف‌های خوشه‌ای وجود خواهد داشت. بخش‌های داخلی هر زیرگراف خوشه‌ای ابتدا چیدمان می‌شوند، سپس زیرگراف‌های خوشه‌ای و گره‌های سطح فعلی نسبت به یکدیگر موقعیت‌یابی می‌شوند، به طوری که با هر زیرگراف خوشه‌ای مانند یک گره رفتار می‌شود.
.P
در هر سطح، گره‌ها و زیرگراف‌های خوشه‌ای به عنوان مستطیل‌هایی دیده می‌شوند که باید در کنار یکدیگر بسته‌بندی شوند. در حال حاضر، یال‌ها در طول بسته‌بندی نادیده گرفته می‌شوند. بسته‌بندی با استفاده از توابع استاندارد بسته‌بندی انجام می‌شود. به ویژه، ویژگی‌های گراف \fBpack\fP و \fBpackmode\fP چیدمان را کنترل می‌کنند. هر گراف و خوشه می‌تواند مقادیر خود را برای این ویژگی‌ها مشخص کند. همچنین به خاطر داشته باشید که یک خوشه، مقادیر ویژگی‌های خود را از گراف والدش به ارث می‌برد.
.P
پس از جای‌گیری تمام گره‌ها و خوشه‌ها، یال‌ها بر اساس مقدار ویژگی \fBsplines\fP مسیریابی می‌شوند.
.SH "قالب‌های خروجی (OUTPUT FORMATS)"
ابزار Osage از یک سازوکار افزونه (پلاگین) توسعه‌پذیر برای موتورهای رندر خروجی خود استفاده می‌کند، بنابراین برای مشاهده اینکه نسخه نصب‌شده osage شما از چه قالب‌های خروجی پشتیبانی می‌کند، می‌توانید از دستور «osage \-Txxx» (که در آن xxx یک قالب نامعتبر و ساختگی است) استفاده کرده و پیام هشدار را بررسی کنید.
همچنین، سازوکار افزونه از چندین پیاده‌سازی مختلف برای قالب‌های خروجی پشتیبانی می‌کند.
برای دیدن گونه‌های موجود، برای مثال از «osage \-Tpng:» استفاده کنید
و برای تحمیل یک گونه خاص، برای مثال از «osage \-Tpng:gd» استفاده نمایید.
.P
به طور سنتی، osage از موارد زیر پشتیبانی می‌کند:
\fB\-Tps\fP (PostScript)،
\fB\-Tsvg\fP \fB\-Tsvgz\fP (گرافیک برداری ساخت‌یافته SVG)،
\fB\-Tfig\fP (گرافیک XFIG)،
\fB\-Tmif\fP (گرافیک FrameMaker)،
\fB\-Thpgl\fP (پلاترهای قلمی HP)، و \fB\-Tpcl\fP (چاپگرهای Laserjet)،
\fB\-Tpng\fP \fB\-Tgif\fP (تصاویر بیت‌مپ)،
\fB\-Timap\fP (فایل‌های نقشه تصویر imagemap برای سرورهای httpd به ازای هر گره یا یالی که دارای ویژگی "href" غیرتهی باشد)،
\fB\-Tcmapx\fP (نقشه تصویر سمت کلاینت برای استفاده در html و xhtml).
قالب‌های خروجی کمتر رایج یا دارای کاربردهای خاص‌تر را می‌توانید در نشانی <https://www.graphviz.org/doc/info/output.html> بیابید.
.P
افزونه‌های جایگزین ارائه‌دهنده پشتیبانی برای یک قالب خروجی مشخص را می‌توان از پیام خطای ناشی از افزودن ':' به انتهای قالب پیدا کرد؛ مانند \fB\-Tpng:\fP
اولین افزونه فهرست‌شده همواره حالت پیش‌فرض است.
.SH "زبان فایل گراف (GRAPH FILE LANGUAGE)"
در اینجا خلاصه‌ای از ساختار زبان فایل‌های گراف، که معمولاً با پسوند \fB.gv\fR ذخیره می‌شوند، آورده شده است:
.PP
[\fBstrict\fR] (\fBgraph\fR|\fBdigraph\fR) \fIname\fP { \fIstatement\(hylist\fP }\fR
.br 
گراف سطح بالا است. اگر گراف به صورت \fBstrict\fR تعریف شود، ایجاد چندین یال بین یک جفت گره یکسان مجاز نخواهد بود.
اگر گرافی جهت‌دار باشد که با \fBdigraph\fR مشخص می‌شود،
عملگر یال (\fIedgeop\fR) باید "\->" باشد. اگر یک \fBgraph\fR بدون جهت باشد،
عملگر یال (\fIedgeop\fR) باید "\-\-" باشد.
عبارت‌ها (دستورات) می‌توانند به صورت‌های زیر باشند:
.PP
\fIname\fB=\fIval\fB;\fR
.br
\fBnode [\fIname\fB=\fIval\fB];\fR
.br
\fBedge [\fIname\fB=\fIval\fB];\fR
.br
ویژگی پیش‌فرض گراف، گره یا یال با نام \fIname\fP را روی \fIval\fP تنظیم می‌کند.
هر زیرگراف، گره یا یالی که پس از این دستور ظاهر شود، ویژگی‌های پیش‌فرض جدید را به ارث می‌برد.
.PP
\fBn0 [\fIname0=val0,name1=val1,...\fB];\fR
گره \fBn0\fP را (اگر از قبل وجود نداشته باشد) ایجاد می‌کند
و ویژگی‌های آن را بر اساس فهرست اختیاری تنظیم می‌نماید.
.PP
\fBn0 \fIedgeop\fR n1 \fIedgeop\fR \fI...\fB \fIedgeop\fR nn [\fIname0=val0,name1=val1,...\fB];\fR
.br
یال‌هایی بین گره‌های \fBn0\fP، \fBn1\fP، ...، \fBnn\fP ایجاد می‌کند و ویژگی‌های آن‌ها را بر اساس فهرست اختیاری تنظیم می‌نماید.
در صورت نیاز گره‌ها را نیز ایجاد می‌کند.
.PP
[\fBsubgraph \fIname\fB] { \fIstatement\(hylist \fB}\fR
.br
یک زیرگراف ایجاد می‌کند. از زیرگراف‌ها می‌توان به جای \fBn0\fP، ...، \fBnn\fP در دستورات بالا برای ایجاد یال استفاده کرد.
بخش [\fBsubgraph \fIname\fR] اختیاری است؛
اگر قید نشود، یک نام داخلی به زیرگراف اختصاص می‌یابد.
.PP
توضیحات (کامنت‌ها) می‌توانند به سبک C مانند /*...*/ یا به سبک ++C مانند //... باشند.

.PP
نام‌ها و مقادیر ویژگی‌ها، رشته‌های معمولی (به سبک C) هستند.
بخش‌های زیر ویژگی‌هایی را که چیدمان گراف را کنترل می‌کنند شرح می‌دهند.

.SH "ویژگی‌های گراف (GRAPH ATTRIBUTES)"
.PP
\fBsize="\fIx,y\fP"\fR کادر محدودکننده ترسیم را بر حسب اینچ تعیین می‌کند.
.PP
\fBpage="\fIx,y\fP"\fR واحد صفحه‌بندی PostScript را تنظیم می‌کند.
.PP
\fBratio=\fIf\fR نسبت ابعاد تصویر را روی \fIf\fP تنظیم می‌کند که می‌تواند یک عدد اعشاری یا یکی از کلیدواژه‌های \fBfill\fP، \fBcompress\fP یا \fBauto\fP باشد.
.PP
\fBpagedir=\fR[TBLR][TBLR] ترتیب اصلی و فرعی صفحه‌بندی را تعیین می‌کند.
.PP
\fBrotate=90\fR حالت افقی (landscape) را فعال می‌کند.
(\fBorientation=land\fR برای سازگاری با نسخه‌های پیشین است اما منسوخ شده است.)
.PP
\fBcenter=\fIn\fR مقدار غیر صفر، طرح ترسیم‌شده را در مرکز صفحه قرار می‌دهد.
.PP
\fBlayers="\fIid:id:id:id\fR" دنباله‌ای از شناسه‌های لایه برای دیاگرام‌های چندلایه (overlay) است. متغیر آرایه‌ای PostScript با نام \fIlayercolorseq\fR نحوه تخصیص رنگ‌ها به لایه‌ها را تعیین می‌کند. کمترین اندیس ۱ است و هر عنصر باید یک آرایه ۳ عنصری باشد تا به عنوان مختصات رنگ تفسیر شود.
.PP
\fBcolor=\fIcolorvalue\fR رنگ پیش‌زمینه را تنظیم می‌کند (و \fBbgcolor\fP برای پس‌زمینه).
.PP
\fBhref=\fI"url"\fR نشانی URL پیش‌فرض برای فایل‌های نقشه تصویر؛ در فایل‌های PostScript نشانی پایه برای تمام URLهای نسبی، طبق تعریف Acrobat Distiller نسخه ۳.۰ به بالا.
.PP
\fBURL=\fI"url"\fR ("URL" مترادفی برای "href" است.)
.PP
\fBstylesheet=\fI"file.css"\fR ارجاعی به یک شیوه‌نامه (stylesheet) در خروجی‌های \-Tsvg و \-Tsvgz درج می‌کند. توسط سایر قالب‌ها نادیده گرفته می‌شود.
.PP
\fBsplines\fR. اگر روی \fItrue\fR تنظیم شود، یال‌ها به صورت منحنی (spline) کشیده می‌شوند.
اگر روی \fIpolyline\fR تنظیم شود، یال‌ها به صورت چندخطی کشیده می‌شوند.
اگر روی \fIortho\fR تنظیم شود، یال‌ها به صورت چندخطی عمود بر هم (orthogonal) کشیده می‌شوند.
در تمامی این موارد، گره‌ها نباید هم‌پوشانی داشته باشند.
اگر \fBsplines=\fIfalse\fR یا \fBsplines=\fIline\fR باشد، یال‌ها به صورت پاره‌خط کشیده می‌شوند.
مقدار پیش‌فرض \fIfalse\fR است.

.SH "ویژگی‌های گره (NODE ATTRIBUTES)"
.PP
\fBheight=\fId\fR یا \fBwidth=\fId\fR حداقل ارتفاع یا عرض را تعیین می‌کند.
افزودن \fBfixedsize=true\fP این مقادیر را به اندازه واقعی و قطعی تبدیل می‌کند (برچسب‌های متنی نادیده گرفته می‌شوند).
.PP
\fBshape=record polygon epsf \fIbuiltin_polygon\fR
.br
مقداری برای \fIbuiltin_polygon\fR از میان موارد زیر است: \fBplaintext ellipse oval circle egg 
triangle box diamond trapezium parallelogram house hexagon octagon
note tab box3d component.\fR
(چندضلعی‌ها توسط ویژگی‌های گره زیر تعریف یا اصلاح می‌شوند:
\fBregular\fR، \fBperipheries\fR، \fBsides\fR، \fBorientation\fR،
\fBdistortion\fR و \fBskew\fR.) \fBepsf\fR از ویژگی \fBshapefile\fR گره به عنوان مسیر یک فایل خارجی EPSF استفاده می‌کند تا به طور خودکار برای شکل گره بارگذاری شود.
.PP
\fBlabel=\fItext\fR که در آن \fItext\fP می‌تواند شامل خطوط جدید اسکیپ‌شده مانند
\\\|n، \\\|l یا \\\|r برای ترازبندی وسط‌چین، چپ‌چین و راست‌چین باشد.
رشته '\\N' با نام گره جایگزین می‌شود.
رشته '\\G' با نام گراف جایگزین می‌شود.
برچسب‌های رکورد (Record) می‌توانند شامل فهرست‌های بازگشتی کادر باشند که با { | } جدا شده‌اند.
شناسه‌های درگاه (Port) در برچسب‌ها با علامت‌های < > مشخص می‌شوند.
در فایل گراف از دو نقطه استفاده کنید (مانند \fBnode0:port28\fR).
.PP
\fBfontsize=\fIn\fR اندازه قلم برچسب را روی \fIn\fP پوینت تنظیم می‌کند.
.PP
\fBfontname=\fIname\fR نام خانواده قلم برچسب را تعیین می‌کند.
.PP
\fBcolor=\fIcolorvalue\fR رنگ خط دور، و در صورت style=filled و مشخص نبودن \fBfillcolor\fR، رنگ پیش‌فرض داخل را تنظیم می‌کند.
.PP
\fBfillcolor=\fIcolorvalue\fR رنگ داخل را هنگامی که style=filled است تعیین می‌کند. اگر مشخص نشود، رنگ داخل به طور پیش‌فرض همان رنگ خط دور خواهد بود.
.PP
\fBfontcolor=\fIcolorvalue\fR رنگ متن برچسب را تنظیم می‌کند.
.PP
مقدار \fIcolorvalue\fP می‌تواند به صورت اعداد اعشاری "\fIh,s,v\fB"\fR (فام، اشباع، روشنایی) بین ۰ و ۱، یا نام رنگ‌های X11 مانند
\fBwhite black red green blue yellow magenta cyan\fR یا \fBburlywood\fR،
یا یک مقدار "\fI#rrggbb" (قرمز، سبز، آبی با ۲ کاراکتر هگزادسیمال برای هر کدام) باشد.
.PP
\fBstyle=filled solid dashed dotted bold invis\fP یا هر کد دلخواه Postscript.
.PP
\fBlayer=\fIid\fR یا \fIid:id\fR یا "all" لایه‌های فعال گره را مشخص می‌کند.
رشته خالی به معنی بدون لایه (نامرئی) است.
.PP
ویژگی‌های زیر فقط برای گره‌های با شکل چندضلعی اعمال می‌شوند:
.PP
\fBregular=\fIn\fR اگر \fIn\fR غیر صفر باشد، چندضلعی منتظم خواهد شد، یعنی نسبت به محور x و y متقارن می‌شود؛ در غیر این صورت چندضلعی نسبت ابعاد برچسب را به خود می‌گیرد.
چندضلعی‌های پیش‌ساخته (\fIbuiltin_polygons\fR) که از قبل منتظم نیستند با این ویژگی منتظم می‌شوند.
چندضلعی‌های پیش‌ساخته‌ای که از قبل منتظم هستند تغییری نمی‌کنند (یعنی نمی‌توان آن‌ها را نامتقارن کرد).
.PP
\fBperipheries=\fIn\fR تعداد خطوط پیرامونی رسم‌شده در اطراف چندضلعی را تعیین می‌کند. این مقدار جایگزین تعداد خطوط پیرامونی \fIbuiltin_polygons\fR می‌شود.
.PP
\fBsides=\fIn\fR تعداد اضلاع چندضلعی را تعیین می‌کند. \fIn\fR<3 منجر به یک بیضی می‌شود.
این ویژگی توسط \fIbuiltin_polygons\fR نادیده گرفته می‌شود.
.PP
\fBorientation=\fIf\fR جهت رأس اول چندضلعی را بر حسب درجه در خلاف جهت عقربه‌های ساعت نسبت به خط عمود تعیین می‌کند.
\fIf\fR می‌تواند یک عدد اعشاری باشد.
جهت برچسب‌ها تحت تأثیر این ویژگی قرار نمی‌گیرد.
این ویژگی به جهت اولیه \fIbuiltin_polygons\fR اضافه می‌شود.
.PP
\fBdistortion=\fIf\fR میزان پهن شدن بالا و باریک شدن پایین چندضلعی را (نسبت به جهت آن) تعیین می‌کند.
مقادیر اعشاری بین \-1 و 1+ پیشنهاد می‌شوند.
این ویژگی توسط \fIbuiltin_polygons\fR نادیده گرفته می‌شود.
.PP                                                            
\fBskew=\fIf\fR میزان جابه‌جایی بالای چندضلعی به سمت راست و جابه‌جایی پایین آن به سمت چپ را (نسبت به جهت آن) تعیین می‌کند.
مقادیر اعشاری بین \-1 و 1+ پیشنهاد می‌شوند.
این ویژگی توسط \fIbuiltin_polygons\fR نادیده گرفته می‌شود.
.PP
\fBhref=\fI"url"\fR نشانی url را برای گره در فایل‌های imagemap، PostScript و SVG تعیین می‌کند.
زیررشته‌های '\\N' و '\\G' به همان شیوه‌ای که برای ویژگی برچسب گره انجام می‌شد جایگزین می‌شوند.
علاوه بر این، زیررشته '\\L' با رشته برچسب گره جایگزین می‌شود.
.PP
\fBURL=\fI"url"\fR ("URL" مترادفی برای "href" است.)
.PP
\fBtarget=\fI"target"\fR یک رشته هدف برای نقشه‌های تصویر سمت کاربر و SVG است که در صورت داشتن URL برای گره‌ها مؤثر خواهد بود.
این رشته برای تعیین اینکه کدام پنجره مرورگر برای URL استفاده شود به کار می‌رود. تنظیم آن روی "_graphviz" در صورت عدم وجود، پنجره جدیدی باز می‌کند یا در صورت وجود، از آن دوباره استفاده می‌نماید.
اگر رشته هدف خالی باشد (حالت پیش‌فرض)، هیچ ویژگی target در خروجی گنجانده نمی‌شود.
زیررشته‌های '\\N' و '\\G' به همان شیوه ویژگی برچسب گره جایگزین می‌شوند.
علاوه بر این، زیررشته '\\L' با رشته برچسب گره جایگزین می‌شود.
.PP
\fBtooltip=\fI"tooltip"\fR یک رشته راهنمای متنی (tooltip) برای نقشه‌های تصویر سمت کاربر و SVG است که در صورت داشتن URL برای گره‌ها فعال می‌شود. رشته tooltip به طور پیش‌فرض همانند رشته برچسب است، اما این ویژگی به گره‌های بدون برچسب نیز اجازه می‌دهد راهنمای متنی داشته باشند و بدین ترتیب امکان رسم گراف‌های متراکم‌تر فراهم شود.
زیررشته‌های '\\N' و '\\G' به همان شیوه ویژگی برچسب گره جایگزین می‌شوند.
علاوه بر این، زیررشته '\\L' با رشته برچسب گره جایگزین می‌شود.

.SH "ویژگی‌های یال (EDGE ATTRIBUTES)"
.PP
\fBlabel=\fItext\fR که در آن \fItext\fR می‌تواند شامل خطوط جدید اسکیپ‌شده مانند
\\\|n، \\\|l یا \\\|r برای خطوط وسط‌چین، چپ‌چین یا راست‌چین باشد.
اگر زیررشته '\\T' در یک برچسب یافت شود، با نام گره مبدا (tail_node) جایگزین خواهد شد.
اگر زیررشته '\\H' در یک برچسب یافت شود، با نام گره مقصد (head_node) جایگزین خواهد شد.
اگر مقدار زیررشته '\\E' در یک برچسب یافت شود، با tail_node_name\->head_node_name جایگزین خواهد شد
(یا در گراف‌های بدون جهت با tail_node_name\-\-head_node_name).
اگر زیررشته '\\G' در یک برچسب یافت شود، با نام گراف جایگزین خواهد شد.
.PP
\fBfontsize=\fIn\fR اندازه قلم برچسب را روی \fIn\fP پوینت تنظیم می‌کند.
.PP
\fBfontname=\fIname\fR نام خانواده قلم برچسب را تعیین می‌کند.
.PP
\fBfontcolor=\fIcolorvalue\fR رنگ متن برچسب را مشخص می‌کند.
.PP
\fBstyle=solid dashed dotted bold invis\fP
.PP
\fBcolor=\fIcolorvalue\fR رنگ خط یال‌ها را مشخص می‌کند.
.PP
\fBcolor=\fIcolorvaluelist\fR فهرستی از \fIcolorvalue\fR که با ':' جدا شده‌اند، یال‌های موازی ایجاد می‌کند؛ یک یال برای هر رنگ.
.PP
\fBdir=forward back both none\fP جهت فلش را کنترل می‌کند.
.PP
\fBtailclip,headclip=false\fP برش شکل نقاط انتهایی را غیرفعال می‌کند.
.PP
\fBhref=\fI"url"\fR نشانی url را برای گره در فایل‌های imagemap، PostScript و SVG تعیین می‌کند.
زیررشته‌های '\\T'، '\\H'، '\\E' و '\\G' به همان شیوه‌ای که برای ویژگی برچسب یال انجام می‌شد جایگزین می‌شوند.
علاوه بر این، زیررشته '\\L' با رشته برچسب یال جایگزین می‌شود.
.PP
\fBURL=\fI"url"\fR ("URL" مترادفی برای "href" است.)
.PP
\fBtarget=\fI"target"\fR یک رشته هدف برای نقشه‌های تصویر سمت کاربر و SVG است که در صورت داشتن URL برای یال‌ها مؤثر خواهد بود.
اگر رشته هدف خالی باشد (حالت پیش‌فرض)، هیچ ویژگی target در خروجی گنجانده نمی‌شود.
زیررشته‌های '\\T'، '\\H'، '\\E' و '\\G' به همان شیوه ویژگی برچسب یال جایگزین می‌شوند.
علاوه بر این، زیررشته '\\L' با رشته برچسب یال جایگزین می‌شود.
.PP
\fBtooltip=\fI"tooltip"\fR یک رشته راهنمای متنی برای نقشه‌های تصویر سمت کاربر است که در صورت داشتن URL برای یال‌ها مؤثر واقع می‌شود. رشته راهنمای متنی به طور پیش‌فرض همانند رشته برچسب یال است.
زیررشته‌های '\\T'، '\\H'، '\\E' و '\\G' به همان شیوه ویژگی برچسب یال جایگزین می‌شوند.
علاوه بر این، زیررشته '\\L' با رشته برچسب یال جایگزین می‌شود.
.PP
\fBarrowhead,arrowtail=none, normal, inv, dot, odot, invdot, invodot,
tee, empty, invempty, open, halfopen, diamond, odiamond, box, obox, crow\fP.
.PP
\fBarrowsize\fP (norm_length=10,norm_width=5,
inv_length=6,inv_width=7,dot_radius=2) 
.PP
\fBheadlabel,taillabel=string\fP برای برچسب‌های درگاه (port).
\fBlabelfontcolor\fP، \fBlabelfontname\fP، \fBlabelfontsize\fP
برای برچسب‌های مقصد و مبدا.
زیررشته‌های '\\T'، '\\H'، '\\E' و '\\G' به همان شیوه ویژگی برچسب یال جایگزین می‌شوند.
علاوه بر این، زیررشته '\\L' با رشته برچسب یال جایگزین می‌شود.
.PP
\fBheadhref=\fI"url"\fR نشانی url را برای درگاه مقصد در فایل‌های imagemap، PostScript و SVG تنظیم می‌کند.
زیررشته‌های '\\T'، '\\H'، '\\E' و '\\G' به همان شیوه ویژگی برچسب یال جایگزین می‌شوند.
علاوه بر این، زیررشته '\\L' با رشته برچسب یال جایگزین می‌شود.
.PP
\fBheadURL=\fI"url"\fR ("headURL" مترادفی برای "headhref" است.)
.PP
\fBheadtarget=\fI"headtarget"\fR یک رشته هدف برای نقشه‌های تصویر سمت کاربر و SVG است که هنگام داشتن URL برای درگاه مقصد یال‌ها به کار می‌رود.
رشته headtarget برای تعیین اینکه کدام پنجره مرورگر برای URL استفاده شود به کار می‌رود. اگر این رشته خالی باشد (حالت پیش‌فرض)، مقدار headtarget همان مقدار target برای یال خواهد بود.
زیررشته‌های '\\T'، '\\H'، '\\E' و '\\G' به همان شیوه ویژگی برچسب یال جایگزین می‌شوند.
علاوه بر این، زیررشته '\\L' با رشته برچسب یال جایگزین می‌شود.
.PP
\fBheadtooltip=\fI"tooltip"\fR یک رشته راهنمای متنی برای نقشه‌های تصویر سمت کاربر است که در صورت داشتن URL برای درگاه مقصد مؤثر واقع می‌شود. رشته راهنمای متنی به طور پیش‌فرض همانند رشته headlabel است.
زیررشته‌های '\\T'، '\\H' و '\\E' به همان شیوه ویژگی برچسب یال جایگزین می‌شوند.
علاوه بر این، زیررشته '\\L' با رشته برچسب یال جایگزین می‌شود.
.PP
\fBtailhref=\fI"url"\fR نشانی url را برای درگاه مبدا در فایل‌های imagemap، PostScript و SVG تنظیم می‌کند.
زیررشته‌های '\\T'، '\\H'، '\\E' و '\\G' به همان شیوه ویژگی برچسب یال جایگزین می‌شوند.
علاوه بر این، زیررشته '\\L' با رشته برچسب یال جایگزین می‌شود.
.PP
\fBtailURL=\fI"url"\fR ("tailURL" مترادفی برای "tailhref" است.)
.PP
\fBtailtarget=\fI"tailtarget"\fR یک رشته هدف برای نقشه‌های تصویر سمت کاربر و SVG است که هنگام داشتن URL برای درگاه مبدا یال‌ها به کار می‌رود.
رشته tailtarget برای تعیین اینکه کدام پنجره مرورگر برای URL استفاده شود به کار می‌رود. اگر این رشته خالی باشد (حالت پیش‌فرض)، مقدار tailtarget همانند مقدار target برای یال در نظر گرفته می‌شود.
زیررشته‌های '\\T'، '\\H'، '\\E' و '\\G' به همان شیوه ویژگی برچسب یال جایگزین می‌شوند.
علاوه بر این، زیررشته '\\L' با رشته برچسب یال جایگزین می‌شود.
.PP
\fBtailtooltip=\fI"tooltip"\fR یک رشته راهنمای متنی برای نقشه‌های تصویر سمت کاربر است که در صورت داشتن URL برای درگاه مبدا مؤثر واقع می‌شود. رشته راهنمای متنی به طور پیش‌فرض همانند رشته taillabel است.
زیررشته‌های '\\T'، '\\H'، '\\E' و '\\G' به همان شیوه ویژگی برچسب یال جایگزین می‌شوند.
علاوه بر این، زیررشته '\\L' با رشته برچسب یال جایگزین می‌شود.
.PP
\fBlabeldistance\fP و \fPport_label_distance\fP فاصله را تعیین می‌کنند؛ همچنین
\fBlabelangle\fP (بر حسب درجه در خلاف جهت عقربه‌های ساعت).
.PP
\fBdecorate\fP خطی از یال به برچسب رسم می‌کند.
.PP
\fBsamehead,sametail\fP یال‌هایی را که دارای مقدار یکسانی هستند با استفاده از نقطه فرود میانگین به درگاه یکسانی هدایت می‌کنند.
.PP
\fBlayer=\fIid\fR یا \fIid:id\fR یا "all" لایه‌های فعال یال را تنظیم می‌کند.
رشته خالی به معنی بدون لایه (نامرئی) است.

.PP
\fB(ویژگی‌های ویژه neato)\fR
.br
\fBw=\fIf\fR وزن (ثابت فنر) یک یال را روی مقدار اعشاری داده‌شده تنظیم می‌کند. مقدار پیش‌فرض ۱.۰ است؛
مقادیر بزرگتر باعث می‌شوند یال تمایل بیشتری به طول بهینه خود داشته باشد.
.PP
\fBlen=\fIf\fR طول بهینه یک یال را تعیین می‌کند.
مقدار پیش‌فرض ۱.۰ است.
.SH "گزینه‌های خط فرمان (COMMAND LINE OPTIONS)"
\fB\-G\fP یک ویژگی پیش‌فرض برای گراف تنظیم می‌کند.
.br
\fB\-N\fP یک ویژگی پیش‌فرض برای گره تنظیم می‌کند.
.br
\fB\-E\fP یک ویژگی پیش‌فرض برای یال تنظیم می‌کند.
مثال: \fB\-Gsize="7,8" \-Nshape=box \-Efontsize=8\fR
.PP
\fB\-l\fIfile\fR فایل‌های کتابخانه سفارشی PostScript را بارگذاری می‌کند.
معمولاً این فایل‌ها اشکال یا سبک‌های سفارشی را تعریف می‌کنند.
اگر \fB\-l\fP به تنهایی داده شود، کتابخانه استاندارد نادیده گرفته می‌شود.
.PP
\fB\-T\fIlang\fR زبان خروجی را همان‌طور که در بالا توضیح داده شد تعیین می‌کند.
.PP
\fB\-O\fP نام فایل‌های خروجی را به طور خودکار بر اساس نام فایل ورودی و قالب \-T تولید می‌کند.
.PP
\fB\-o\fIfile\fR خروجی را در \fIfile\fP می‌نویسد.
.PP
\fB\-x\fP کاهش گراف (کاستن از حجم گراف).
.PP
\fB\-Lg\fP از شبکه چهارخانه‌ای (grid) استفاده نکن.
.PP
\fB\-LO\fP استفاده از نیروی جاذبه قدیمی.
.PP
\fB\-Ln\fIi\fR تعداد تکرارها را روی \fIi\fP تنظیم می‌کند.
.PP
\fB\-LU\fIi\fR ضریب مقیاس‌بندی‌نشده را روی \fIi\fP تنظیم می‌کند.
.PP
\fB\-LC\fIv\fR ضریب گسترش هم‌پوشانی را روی \fIv\fP تنظیم می‌کند.
.PP
\fB\-LT\fR[*]\fIv\fR دما (ضریب دما) را روی \fIv\fP تنظیم می‌کند.
.PP
\fB\-v\fP (حالت پرگو) اطلاعات مختلفی را که برای اشکال‌زدایی مفید است چاپ می‌کند.
.PP
\fB\-V\fP (نسخه) اطلاعات نسخه را چاپ کرده و خارج می‌شود.
.PP
\fB\-?\fP راهنمای نحوه استفاده را چاپ کرده و خارج می‌شود.
.SH "مثال‌ها (EXAMPLES)"
.nf
digraph test123 {
        pack=8
        subgraph cluster0 {
          packmode=array
          x y x0 y0 x1
          subgraph cluster1 {
            m n
          }
        }
        b [shape=box];
        c [label="hello\enworld",color=blue,fontsize=24,
             fontname="Palatino\-Italic",fontcolor=red,style=filled];
        a \-> z
        x \-> z
        a \-> b \-> c;
        a \-> {x y};
        edge [style=dashed,color=red];
        b \-> x;
}
.fi
.SH "نویسندگان (AUTHORS)"
Emden R. Gansner <erg@research.att.com>
.SH "همچنین ببینید (SEE ALSO)"
این صفحه راهنما تنها بخش کوچکی از اطلاعات مربوط به برنامه‌های چیدمان Graphviz را شامل می‌شود. کامل‌ترین اطلاعات را می‌توانید در نشانی <https://www.graphviz.org/documentation>، به ویژه در صفحات مرجع برخط بیابید. بیشتر این اسناد در زیرشاخه‌های \fIdoc\fP و \fIdoc/info\fP در توزیع‌های سورس و باینری نیز در دسترس هستند.
.PP
dot(1)