'\" t .\" Title: a2x .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets v1.79.1 .\" Date: 07/17/2024 .\" Manual: \ \& .\" Source: \ \& .\" Language: Persian .\" .TH "A2X" "1" "07/17/2024" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "نام (NAME)" a2x \- زنجیره ابزار تولید اسناد از فایل‌های منبع AsciiDoc .SH "خلاصه دستور (SYNOPSIS)" .sp \fBa2x\fR [\fIگزینه‌ها\fR] \fISOURCE_FILE\fR .SH "توضیحات (DESCRIPTION)" .sp یک مدیر زنجیره ابزار DocBook که فایل متنی AsciiDoc با نام \fISOURCE_FILE\fR را با استفاده از \fIasciidoc(1)\fR و برنامه‌های دیگر (بخش پیش‌نیازها را ببینید) به قالب‌های PDF، EPUB، DVI، PS، LaTeX، XHTML (تک‌صفحه‌ای یا چندبخشی)، صفحه راهنما (man page)، HTML Help یا متن ساده تبدیل می‌کند\&. \fISOURCE_FILE\fR همچنین می‌تواند یک فایل DocBook با پسوند \&.xml باشد\&. .SH "گزینه‌ها (OPTIONS)" .PP \fB\-a, \-\-attribute\fR=\fIATTRIBUTE\fR .RS 4 تنظیم مقدار صفت (attribute) برای asciidoc(1) (میان‌بری برای گزینهٔ \fB\-\-asciidoc\-opts\fR=\fI"\-a ATTRIBUTE"\fR)\&. این گزینه می‌تواند بیش از یک بار مشخص شود\&. .RE .PP \fB\-\-asciidoc\-opts\fR=\fIASCIIDOC_OPTS\fR .RS 4 گزینه‌های اضافی برای \fIasciidoc(1)\fR\&. این گزینه می‌تواند بیش از یک بار مشخص شود\&. .RE .PP \fB\-\-conf\-file\fR=\fICONF_FILE\fR .RS 4 بارگذاری فایل پیکربندی\&. بخش فایل‌های پیکربندی (CONF FILES) را ببینید\&. .RE .PP \fB\-D, \-\-destination\-dir\fR=\fIDESTINATION_DIR\fR .RS 4 پوشه خروجی\&. پیش‌فرض، پوشهٔ \fISOURCE_FILE\fR است\&. این گزینه فقط برای قالب‌های خروجی مبتنی بر HTML و صفحه راهنما (\fIchunked\fR، \fIepub\fR، \fIhtmlhelp\fR، \fIxhtml\fR، \fImanpage\fR) قابل اعمال است\&. .RE .PP \fB\-d, \-\-doctype\fR=\fIDOCTYPE\fR .RS 4 نوع سند DocBook: \fIarticle\fR، \fImanpage\fR یا \fIbook\fR\&. نوع سند پیش‌فرض \fIarticle\fR است مگر اینکه قالب \fImanpage\fR باشد (که در این صورت پیش‌فرض آن \fImanpage\fR خواهد بود)\&. .RE .PP \fB\-b, \-\-backend\fR=\fIBACKEND\fR .RS 4 \fIBACKEND\fR نام یک افزونهٔ پشتیبان (backend plugin) نصب‌شده است\&. هنگامی که این گزینه مشخص شود، \fIa2x\fR تلاش می‌کند فایلی به نام \fIa2x\-backend\&.py\fR را از پوشهٔ افزونهٔ \fIBACKEND\fR بارگذاری کند\&. سپس \fISOURCE_FILE\fR را با استفاده از تابعی سراسری به نام \fIto_BACKEND\fR که در \fIa2x\-backend\&.py\fR تعریف شده است، به یک فایل خروجی با قالب \fIBACKEND\fR تبدیل می‌کند\&. .RE .PP \fB\-f, \-\-format\fR=\fIFORMAT\fR .RS 4 قالب‌های خروجی: \fIchunked\fR، \fIdocbook\fR، \fIdvi\fR، \fIepub\fR، \fIhtmlhelp\fR، \fImanpage\fR، \fIpdf\fR (پیش‌فرض)، \fIps\fR، \fItex\fR، \fItext\fR، \fIxhtml\fR\&. مقدار صفت AsciiDoc با نام \fIa2x\-format\fR بر روی \fIFORMAT\fR تنظیم می‌شود\&. .RE .PP \fB\-h, \-\-help\fR .RS 4 چاپ نحو خط فرمان و گزینه‌های برنامه در stdout\&. .RE .PP \fB\-\-icons\fR .RS 4 استفاده از تصاویر آیکون هشدار (admonition) یا ناوبری در اسناد خروجی\&. رفتار پیش‌فرض، استفاده از متن به جای آیکون‌ها است\&. .RE .PP \fB\-\-icons\-dir\fR=\fIPATH\fR .RS 4 مسیری (نسبت به فایل‌های خروجی) حاوی آیکون‌های هشدار و ناوبری\&. پیش‌فرض images/icons است\&. در صورت استفاده از این گزینه، گزینهٔ \fI\-\-icons\fR به‌طور ضمنی فعال می‌شود\&. .RE .PP \fB\-k, \-\-keep\-artifacts\fR .RS 4 فایل‌های موقت ساخت (build) حذف نشوند\&. .RE .PP \fB\-\-lynx\fR .RS 4 استفاده از \fIlynx(1)\fR (در واقع: مرورگر متنی تعریف‌شده توسط متغیر پیکربندی LYNX) هنگام تولید خروجی با قالب متنی\&. رفتار پیش‌فرض، استفاده از \fIw3m(1)\fR (در واقع: مرورگر متنی تعریف‌شده توسط متغیر پیکربندی W3M) است\&. .RE .PP \fB\-L, \-\-no\-xmllint\fR .RS 4 عدم بررسی خروجی asciidoc با \fIxmllint(1)\fR\&. .RE .PP \fB\-\-\-epubcheck\fR .RS 4 بررسی خروجی EPUB با \fIepubcheck(1)\fR\&. .RE .PP \fB\-n, \-\-dry\-run\fR .RS 4 هیچ کاری انجام نشود؛ فقط آنچه قرار بود انجام شود چاپ شود\&. .RE .PP \fB\-r, \-\-resource\fR=\fIRESOURCE_SPEC\fR .RS 4 مشخص کردن یک منبع\&. این گزینه می‌تواند بیش از یک بار مشخص شود\&. برای جزئیات بیشتر بخش \fBمنابع (RESOURCES)\fR را ببینید\&. .RE .PP \fB\-m, \-\-resource\-manifest\fR=\fIFILE\fR .RS 4 \fIFILE\fR حاوی فهرستی از منابع است (یک منبع در هر خط)\&. ورودی‌های فایل مانیفست \fIFILE\fR دقیقاً مانند آرگومان‌های گزینهٔ \fB\-\-resource\fR قالب‌بندی می‌شوند\&. متغیرهای محیطی و علامت مدک برای پوشه خانگی مجاز هستند\&. .RE .PP \fB\-\-stylesheet\fR=\fISTYLESHEET\fR .RS 4 فهرستی جداشده با فاصله از یک یا چند نام فایل شیوه‌نامهٔ CSS که برای اعمال سبک به خروجی HTML تولیدشده توسط DocBook XSL Stylesheets استفاده می‌شوند\&. پیش‌فرض \fIdocbook\-xsl\&.css\fR است\&. شیوه‌نامه‌ها به ترتیب فهرست پردازش می‌شوند\&. شیوه‌نامه‌ها باید در یک مکان معتبر فایل منبع (resource file) قرار داشته باشند\&. برای قالب‌های HTML زیر اعمال می‌شود: \fIxhtml\fR، \fIepub\fR، \fIchunked\fR، \fIhtmlhelp\fR\&. .RE .PP \fB\-v, \-\-verbose\fR .RS 4 چاپ جزئیات عملیات در stderr\&. دومین گزینهٔ \fB\-v\fR گزینه پرحرف را برای دستورات زنجیره ابزار نیز اعمال می‌کند\&. .RE .PP \fB\-\-version\fR .RS 4 چاپ نسخهٔ برنامه در stdout\&. .RE .PP \fB\-\-xsltproc\-opts\fR=\fIXSLTPROC_OPTS\fR .RS 4 گزینه‌های اضافی برای \fIxsltproc(1)\fR\&. این گزینه می‌تواند بیش از یک بار مشخص شود\&. .RE .PP \fB\-\-xsl\-file\fR=\fIXSL_FILE\fR .RS 4 جایگزین کردن شیوه‌نامهٔ داخلی XSL با شیوه‌نامهٔ سفارشی XSL با نام \fIXSL_FILE\fR\&. .RE .PP \fB\-\-fop\fR .RS 4 استفاده از FOP برای تولید PDF\&. رفتار پیش‌فرض، استفاده از \fIdblatex(1)\fR است\&. در صورت استفاده از گزینهٔ \fI\-\-fop\-opts\fR گزینهٔ \fI\-\-fop\fR به‌طور ضمنی فعال می‌شود\&. .RE .PP \fB\-\-fop\-opts\fR=\fIFOP_OPTS\fR .RS 4 گزینه‌های اضافی برای \fIfop(1)\fR\&. اگر این گزینه مشخص شود، از FOP برای تولید PDF استفاده می‌شود\&. این گزینه می‌تواند بیش از یک بار مشخص شود\&. .RE .PP \fB\-\-dblatex\-opts\fR=\fIDBLATEX_OPTS\fR .RS 4 گزینه‌های اضافی برای \fIdblatex(1)\fR\&. این گزینه می‌تواند بیش از یک بار مشخص شود\&. .RE .PP \fB\-\-backend\-opts\fR=\fIBACKEND_OPTS\fR .RS 4 گزینه‌های مربوط به افزونهٔ پشتیبان که توسط گزینهٔ \fI\-\-backend\fR مشخص شده است\&. این گزینه می‌تواند بیش از یک بار مشخص شود\&. .RE .sp گزینه‌ها همچنین می‌توانند درون فایل منبع AsciiDoc تنظیم شوند\&. اگر \fISOURCE_FILE\fR دارای یک خط توضیح (comment) باشد که با \fB// a2x:\fR شروع می‌شود، باقی‌ماندهٔ آن خط به‌عنوان گزینه‌های خط فرمان \fIa2x\fR در نظر گرفته خواهد شد\&. برای مثال: .sp .if n \{\ .RS 4 .\} .nf // a2x default options\&. // a2x: \-dbook \-\-epubcheck // Suppress revision history in dblatex outputs\&. // a2x: \-\-dblatex\-opts "\-P latex\&.output\&.revhistory=0" .fi .if n \{\ .RE .\} .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} گزینه‌هایی که در چندین خط توضیح از این دست قرار دارند، به یکدیگر متصل خواهند شد\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} صفر یا چند نویسه فاصله (white space) می‌توانند بین \fB//\fR آغازین و \fBa2x:\fR قرار گیرند\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} گزینه‌های خط فرمان بر گزینه‌های تنظیم‌شده در فایل منبع اولویت دارند\&. .RE .SH "فایل‌های خروجی (OUTPUT FILES)" .sp فایل‌های خروجی در پوشه‌ای که توسط گزینهٔ \fB\-\-destination\-dir\fR مشخص شده است نوشته می‌شوند\&. اگر هیچ گزینهٔ \fB\-\-destination\-dir\fR مشخص نشده باشد، فایل‌های خروجی در پوشهٔ \fISOURCE_FILE\fR نوشته می‌شوند\&. .sp فایل‌های خروجی دارای همان نام \fISOURCE_FILE\fR هستند اما با پسوند فایل مناسب: \&.html برای \fIxhtml\fR؛ \&.epub برای \fIepub\fR؛ \&.hhp برای \fIhtmlhelp\fR؛ \&.pdf برای \fIpdf\fR؛ \&.text برای \fItext\fR؛ \&.xml برای \fIdocbook\fR\&. طبق قرارداد، صفحات راهنما (manpages) هیچ پسوند \&.man ندارند (فقط شماره بخش صفحه راهنما)\&. نام پوشه‌های HTML چندبخشی (chunked) دارای پسوند \&.chunked است؛ نام پوشه‌های HTML Help چندبخشی دارای پسوند \&.htmlhelp است\&. .sp فایل‌های موجود با همان نام بازنویسی می‌شوند\&. .sp علاوه بر تولید فایل‌های HTML، قالب‌های \fIxhtml\fR، \fIepub\fR، \fIchunked\fR و \fIhtmlhelp\fR اطمینان حاصل می‌کنند که فایل‌های منبع در مکان‌های صحیح پوشه مقصد کپی شوند\&. .SH "منابع (RESOURCES)" .sp منابع فایل‌هایی هستند (معمولاً CSS و تصاویر) که برای خروجی‌های مبتنی بر HTML (قالب‌های \fIxhtml\fR، \fIepub\fR، \fIchunked\fR، \fIhtmlhelp\fR) مورد نیاز هستند\&. \fIa2x\fR فایل‌های HTML تولیدشده را بررسی کرده و فهرستی از فایل‌های CSS و تصاویر مورد نیاز تهیه می‌کند\&. فایل‌های منبع اضافی را می‌توان به‌طور صریح با استفاده از گزینهٔ \fB\-\-resource\fR مشخص کرد\&. .sp \fIa2x\fR فایل‌های منبع را در مکان‌های زیر و به ترتیب زیر جستجو می‌کند: .sp .RS 4 .ie n \{\ \h'-04' 1.\h'+01'\c .\} .el \{\ .sp -1 .IP " 1." 4.2 .\} پوشهٔ \fISOURCE_FILE\fR\&. .RE .sp .RS 4 .ie n \{\ \h'-04' 2.\h'+01'\c .\} .el \{\ .sp -1 .IP " 2." 4.2 .\} پوشه‌های منابع مشخص‌شده توسط گزینهٔ \fB\-\-resource\fR (به‌صورت بازگشتی جستجو می‌شوند)\&. .RE .sp .RS 4 .ie n \{\ \h'-04' 3.\h'+01'\c .\} .el \{\ .sp -1 .IP " 3." 4.2 .\} پوشه‌های منابع مشخص‌شده توسط گزینهٔ \fB\-\-resource\-manifest\fR (به‌صورت بازگشتی و به ترتیبی که در فایل مانیفست آمده‌اند جستجو می‌شوند)\&. .RE .sp .RS 4 .ie n \{\ \h'-04' 4.\h'+01'\c .\} .el \{\ .sp -1 .IP " 4." 4.2 .\} پوشه‌های پیش‌فرض images و stylesheets در پوشه‌های فایل‌های پیکربندی \fIasciidoc(1)\fR (به‌صورت بازگشتی جستجو می‌شوند)\&. .RE .sp .RS 4 .ie n \{\ \h'-04' 5.\h'+01'\c .\} .el \{\ .sp -1 .IP " 5." 4.2 .\} پوشهٔ مقصد\&. .RE .sp هنگامی که یک فایل منبع پیدا شود، در پوشهٔ نسبی صحیح در مقصد کپی می‌شود\&. زیرپوشه‌های ناموجود در مقصد به‌طور خودکار ایجاد می‌شوند\&. .sp دو سازوکار مجزا برای مشخص کردن منابع اضافی وجود دارد: .sp .RS 4 .ie n \{\ \h'-04' 1.\h'+01'\c .\} .el \{\ .sp -1 .IP " 1." 4.2 .\} یک پوشهٔ منبع که برای فایل‌های منبع ناموجود به‌صورت بازگشتی جستجو می‌شود\&. .RE .sp .RS 4 .ie n \{\ \h'-04' 2.\h'+01'\c .\} .el \{\ .sp -1 .IP " 2." 4.2 .\} یک فایل منبع که در پوشهٔ مقصد خروجی کپی می‌شود\&. .RE .sp منابع با مقادیر گزینهٔ \fB\-\-resource\fR مشخص می‌شوند که می‌توانند یکی از قالب‌های زیر را داشته باشند: .sp .if n \{\ .RS 4 .\} .nf [=] \&.= .fi .if n \{\ .RE .\} .sp که در آن: .PP .RS 4 یک پوشه (مطلق یا نسبت به \fISOURCE_FILE\fR) را مشخص می‌کند که برای فایل‌های منبع ناموجود به‌صورت بازگشتی جستجو می‌شود\&. برای جلوگیری از ابهام، نام باید با یک نویسهٔ جداکننده پوشه خاتمه یابد\&. .RE .PP .RS 4 یک فایل منبع (مطلق یا نسبت به \fISOURCE_FILE\fR) را مشخص می‌کند که در کپی خواهد شد\&. اگر مشخص نشود، همانند خواهد بود\&. .RE .PP .RS 4 مقصد فایل منبع کپی‌شده را مشخص می‌کند\&. مسیر نسبت به پوشه مقصد است (مسیرهای مطلق مجاز نیستند)\&. مکان پوشه مقصد به \fIFORMAT\fR خروجی بستگی دارد (برای جزئیات به بخش \fBفایل‌های خروجی (OUTPUT FILES)\fR مراجعه کنید): .PP chunked, htmlhelp .RS 4 پوشه خروجی قطعه‌قطعه‌شده (chunked)\&. .RE .PP epub .RS 4 پوشه بایگانی‌شدهٔ OEBPS\&. .RE .PP xhtml .RS 4 پوشه خروجی \fBDESTINATION_DIR\fR\&. .RE .RE .PP \&.= .RS 4 هنگام افزودن منابع به فایل‌های EPUB، نوع MIME از روی پسوند استنباط می‌شود؛ اگر نوع MIME قابل تشخیص نباشد، خطایی رخ می‌دهد\&. ساختار منبع \&.= می‌تواند برای تعیین صریح نوع‌های MIME استفاده شود\&. پسوند نام فایل و نوع MIME متناظر است\&. .RE .sp مثال‌هایی از گزینهٔ منبع: .sp .if n \{\ .RS 4 .\} .nf \-\-resource \&.\&./images/ \-\-resource doc/README\&.txt=README\&.txt \-\-resource ~/images/tiger\&.png=images/tiger\&.png \-\-resource \&.ttf=application/x\-font\-ttf .fi .if n \{\ .RE .\} .SH "مثال‌ها (EXAMPLES)" .PP a2x \-f pdf doc/source\-highlight\-filter\&.txt .RS 4 تولید فایل doc/source\-highlight\-filter\&.pdf\&. .RE .PP a2x \-f xhtml \-D \&.\&./doc \-\-icons \-r \&.\&./images/ team\&.txt .RS 4 ایجاد فایل HTML به نام \&.\&./doc/team\&.html، استفاده از آیکون‌های هشدار و جستجوی بازگشتی در پوشهٔ \&.\&./images/ برای یافتن منابع ناموجود\&. .RE .PP a2x \-f manpage doc/asciidoc\&.1\&.txt .RS 4 تولید صفحه راهنمای doc/asciidoc\&.1\&. .RE .SH "پیش‌نیازها (REQUISITES)" .sp \fIa2x\fR از برنامه‌های زیر استفاده می‌کند: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBAsciidoc\fR: https://asciidoc\&.org .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBxsltproc\fR: (تمام قالب‌ها به جز متن): http://xmlsoft\&.org/XSLT .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBDocBook XSL Stylesheets\fR (تمام قالب‌ها به جز متن): https://github\&.com/docbook/xslt10\-stylesheets .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBdblatex\fR (قالب‌های pdf، dvi، ps، tex): http://dblatex\&.sourceforge\&.net .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBFOP\fR (قالب pdf \(em تولیدکنندهٔ جایگزین فایل PDF): https://xmlgraphics\&.apache\&.org/fop .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBw3m\fR (قالب متن): http://w3m\&.sourceforge\&.net/index\&.en\&.html .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBLynx\fR (قالب متن \(em تولیدکنندهٔ جایگزین فایل متنی): https://invisible\-island\&.net/lynx .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBepubcheck\fR (قالب epub \(em اعتبارسنج فایل EPUB): https://github\&.com/w3c/epubcheck .RE .sp همچنین آخرین فایل README را ببینید\&. .SH "فایل‌های پیکربندی (CONF FILES)" .sp یک فایل پیکربندی شامل کدهای اجرایی پایتون است که پارامترهای پیکربندی سراسری را در a2x\&.py بازنویسی می‌کند\&. فایل‌های پیکربندی اختیاری به ترتیب زیر بارگذاری می‌شوند: .sp .RS 4 .ie n \{\ \h'-04' 1.\h'+01'\c .\} .el \{\ .sp -1 .IP " 1." 4.2 .\} a2x\&.conf از پوشهٔ حاوی فایل اجرایی \fIa2x\&.py\fR\&. .RE .sp .RS 4 .ie n \{\ \h'-04' 2.\h'+01'\c .\} .el \{\ .sp -1 .IP " 2." 4.2 .\} a2x\&.conf از پوشهٔ پیکربندی سراسری AsciiDoc\&. در صورتی که نسخهٔ نصب‌شده به‌صورت محلی (غیر سراسری در سیستم) را اجرا می‌کنیم، از این مرحله صرف‌نظر می‌شود\&. .RE .sp .RS 4 .ie n \{\ \h'-04' 3.\h'+01'\c .\} .el \{\ .sp -1 .IP " 3." 4.2 .\} a2x\&.conf از پوشهٔ پیکربندی $HOME/\&.asciidoc در AsciiDoc\&. .RE .sp .RS 4 .ie n \{\ \h'-04' 4.\h'+01'\c .\} .el \{\ .sp -1 .IP " 4." 4.2 .\} فایل \fICONF_FILE\fR مشخص‌شده در گزینهٔ \fI\-\-conf\-file\fR\&. .RE .sp در اینجا مقادیر پیش‌فرض گزینه‌های فایل پیکربندی آمده است: .sp .if n \{\ .RS 4 .\} .nf # Optional environment variable dictionary passed to # executing programs\&. If set to None the existing # environment is used\&. ENV = None # External executables\&. ASCIIDOC = \*(Aqasciidoc\*(Aq XSLTPROC = \*(Aqxsltproc\*(Aq DBLATEX = \*(Aqdblatex\*(Aq # pdf generation\&. FOP = \*(Aqfop\*(Aq # pdf generation (\-\-fop option)\&. W3M = \*(Aqw3m\*(Aq # primary text file generator\&. LYNX = \*(Aqlynx\*(Aq # alternate text file generator\&. XMLLINT = \*(Aqxmllint\*(Aq # Set to \*(Aq\*(Aq to disable\&. EPUBCHECK = \*(Aqepubcheck\*(Aq # Set to \*(Aq\*(Aq to disable\&. # External executable default options\&. ASCIIDOC_OPTS = \*(Aq\*(Aq BACKEND_OPTS = \*(Aq\*(Aq DBLATEX_OPTS = \*(Aq\*(Aq FOP_OPTS = \*(Aq\*(Aq LYNX_OPTS = \*(Aq\-dump\*(Aq W3M_OPTS = \*(Aq\-dump \-cols 70 \-T text/html \-no\-graph\*(Aq XSLTPROC_OPTS = \*(Aq\*(Aq .fi .if n \{\ .RE .\} .sp توجه داشته باشید که امکان بازتعریف W3M و LYNX برای استفاده از مرورگرهای متنی متفاوت وجود دارد؛ به عنوان مثال \fIlinks\fR: http://links\&.twibright\&.com یا \fIelinks\fR: http://elinks\&.or\&.cz\&. متغیرهای LYNX_OPTS و W3M_OPTS می‌توانند برای ارسال گزینه‌ها به مرورگر انتخاب‌شده استفاده شوند\&. در صورت تعریف شدن، این متغیرها مقادیر پیش‌فرض مربوطه را که در بالا ذکر شد بازنویسی می‌کنند (بنابراین فراموش نکنید که گزینهٔ \fI\-dump\fR را در تعریف خود بگنجانید: این کار دست‌کم در مورد \fIw3m\fR، \fIlynx\fR، \fIlinks\fR و \fIelinks\fR برای ارسال متن قالب‌بندی‌شده به stdout الزامی است)\&. .SH "اشکالات (BUGS)" .sp فایل BUGS در توزیع AsciiDoc را ببینید\&. .SH "نویسندگان (AUTHORS)" .sp برنامهٔ a2x در ابتدا توسط Stuart Rackham نوشته شد\&. افراد زیادی در توسعه آن مشارکت داشته‌اند\&. .SH "منابع (RESOURCES)" .sp گیت‌هاب: https://github\&.com/asciidoc/asciidoc\-py3 .sp وب‌سایت اصلی: https://asciidoc\&.org .SH "همچنین ببینید (SEE ALSO)" .sp asciidoc(1) .SH "حق نشر (COPYING)" .sp Copyright (C) 2002\-2013 Stuart Rackham\&. .sp Copyright (C) 2013\-2022 AsciiDoc Contributors\&. .sp استفاده رایگان از این نرم‌افزار تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) منتشرشده توسط بنیاد نرم‌افزارهای آزاد (Free Software Foundation) مجاز است؛ یا نسخه ۲ مجوز، یا (به انتخاب شما) هر نسخهٔ بعدی\&. .sp این برنامه با این امید توزیع می‌شود که مفید باشد، اما بدون هیچ‌گونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف خاص\&. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید\&.