.\" This manpage has been automatically generated by docbook2man .\" from a DocBook document. This tool can be found at: .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . .TH "JW" "1" "05 December 2025" "" "" .SH "نام (NAME)" jw, docbook2dvi, docbook2html, docbook2man, docbook2pdf, docbook2ps, docbook2rtf, docbook2tex, docbook2texi, docbook2txt \- پرونده‌های SGML را به فرمت‌های دیگر تبدیل می‌کند (پوشش‌دهنده Jade) .SH "خلاصه دستور (SYNOPSIS)" \fBjw\fR [ \fB-f \fIfrontend\fB\fR | \fB--frontend \fIfrontend\fB\fR ] [ \fB-b \fIbackend\fB\fR | \fB--backend \fIbackend\fB\fR ] [ \fB-c \fIfile\fB\fR | \fB--cat \fIfile\fB\fR ] [ \fB-n\fR | \fB--nostd\fR ] [ \fB-d \fIfile\fB|default|none\fR | \fB--dsl \fIfile\fB|default|none\fR ] [ \fB-l \fIfile\fB\fR | \fB--dcl \fIfile\fB\fR ] [ \fB-s \fIpath\fB\fR | \fB--sgmlbase \fIpath\fB\fR ] [ \fB-p \fIprogram\fB\fR | \fB--parser \fIprogram\fB\fR ] [ \fB-o \fIdirectory\fB\fR | \fB--output \fIdirectory\fB\fR ] [ \fB-V \fIvariable\fB[=\fIvalue\fB]\fR ] [ \fB-u\fR | \fB--nochunks\fR ] [ \fB-i \fIsection\fB\fR | \fB--include \fIsection\fB\fR ] [ \fB-w \fItype\fB|list\fR | \fB--warning \fItype\fB|list\fR ] [ \fB-e \fItype\fB|list\fR | \fB--error \fItype\fB|list\fR ] [ \fB-h\fR | \fB--help\fR ] [ \fB-v\fR | \fB--version\fR ] \fB\fISGML-file\fB\fR \fBdocbook2dvi\fR \fB\fISGML-file\fB\fR \fBdocbook2html\fR \fB\fISGML-file\fB\fR \fBdocbook2man\fR \fB\fISGML-file\fB\fR \fBdocbook2pdf\fR \fB\fISGML-file\fB\fR \fBdocbook2ps\fR \fB\fISGML-file\fB\fR \fBdocbook2rtf\fR \fB\fISGML-file\fB\fR \fBdocbook2tex\fR \fB\fISGML-file\fB\fR \fBdocbook2texi\fR \fB\fISGML-file\fB\fR \fBdocbook2txt\fR \fB\fISGML-file\fB\fR .SH "توضیحات (DESCRIPTION)" .PP اسکریپت شل \fBjw\fR امکان تبدیل یک پرونده DocBook (یا سایر قالب‌های مبتنی بر SGML) را به فرمت‌های دیگر (از جمله HTML، RTF، PS و PDF) با نحو ساده و قابل فهم فراهم می‌کند. این ابزار بخش عمده‌ای از پیچیدگی‌های Jade یا OpenJade را پنهان کرده و ویژگی‌های کارآمدی به آن اضافه می‌نماید. .PP اسکریپت‌های دیگر مانند \fBdocbook2html\fR، \fBdocbook2rtf\fR یا \fBdocbook2ps\fR روش‌های دیگری برای فراخوانی \fBjw\fR فراهم می‌کنند که ممکن است به خاطر سپردن آن‌ها ساده‌تر باشد. .PP در حال حاضر، jw پرونده‌های XML را پشتیبانی نمی‌کند و فقط SGML را مدیریت می‌نماید. .PP این ابزار فرض می‌کند که چندین مؤلفه دیگر از قبل روی سیستم نصب هستند. این فهرست شامل موارد زیر است: .TP 0.2i \(bu موجودیت‌های کاراکتری ISO برای SGML .TP 0.2i \(bu موتور DSSSL مربوط به James Clark با نام jade یا یک پارسر معادل مانند OpenJade .TP 0.2i \(bu تعریف نوع سند (DocBook DTD) از کنسرسیوم OASIS .TP 0.2i \(bu شیوه‌نامه‌های مدولار DocBook متعلق به Norman Walsh (یا مجموعه‌ای دیگر از شیوه‌نامه‌های DSSSL) .TP 0.2i \(bu مجموعه ماکروهای TeX برای jade نوشته Sebastian Rahtz به نام jadetex (برای موتورهای خروجی فرمت‌های چاپی مانند PDF، RTF یا PostScript) .TP 0.2i \(bu مفسر perl (برای بک‌اندهایی که از perl استفاده می‌کنند) .TP 0.2i \(bu ماژول SGMLSpm از CPAN (برای بک‌اندهایی که از sgmls استفاده می‌کنند) .TP 0.2i \(bu مرورگر متنی Lynx HTML (برای بک‌اند \fItxt\fR) .PP اسکریپت jw در حالت پایه به صورت زیر فراخوانی می‌شود: .nf jw mydoc.sgml .fi .PP که در آن \fImydoc.sgml\fR یک پرونده SGML است. .PP خط فرمان بالا از گزینه‌های پیش‌فرض استفاده می‌کند: تبدیل از DocBook (فرانت‌اند پیش‌فرض) به HTML (بک‌اند پیش‌فرض)، نتیجه را در زیرپوشه قرار نمی‌دهد (مگر اینکه در شیوه‌نامه‌ها طور دیگری مشخص شده باشد)، و غیره. .PP در این مثال، نام پرونده "mydoc" و پسوند ".sgml" می‌توانند با هر نام دیگری جایگزین شوند. پسوندهای رایج برای پرونده‌های SGML DocBook شامل ".sgml"، ".sgm"، ".docbook" و ".db" است. پرونده پردازش‌شده \fImydoc.sgml\fR می‌تواند در هر پوشه‌ای غیر از پوشه جاری قرار داشته باشد. .PP در اینجا تولید خروجی HTML انتخاب شده است. در عمل می‌توان از هر یک از بک‌اندهای موجود در زیرپوشه \fIbackends/\fR از پوشه توزیع DocBook-utils (معمولاً \fI/usr/share/sgml/docbook/utils-0.6.15\fR) استفاده کرد. به همین ترتیب، می‌توانید از هر فرانت‌اند تعریف‌شده در زیرپوشه \fIfrontends/\fR برای تبدیل از یک قالب ورودی دیگر استفاده کنید. .PP این دستور نمونه یک یا چند پرونده HTML با نام‌های دلخواه در پوشه جاری ایجاد می‌کند. این رفتار پیش‌فرض را می‌توان از طریق گزینه‌های خط فرمان یا شیوه‌نامه‌های سفارشی‌سازی تغییر داد. .SH "گزینه‌ها (OPTIONS)" .PP گزینه‌های زیر برای اسکریپت تبدیل معتبر هستند: .TP \fB -f \fIfrontend\fB | --frontend \fIfrontend\fB \fR امکان تعیین فرانت‌اندی غیر از مقدار پیش‌فرض \fIdocbook\fR را فراهم می‌کند. فهرست فرانت‌اندهای موجود در حال حاضر عبارت است از: .RS .TP \fB\fIdocbook\fB\fR تبدیل docbook با شیوه‌نامه‌های Norman Walsh. این فرانت‌اند در زیرپوشه‌های پوشه پایه SGML به دنبال پرونده‌ای با نام \fIhtml/docbook.dsl\fR یا \fIprint/docbook.dsl\fR (بسته به نوع بک‌اند: html یا print) می‌گردد. .RE .TP \fB -b \fIbackend\fB | --backend \fIbackend\fB \fR امکان تعیین بک‌اندی غیر از مقدار پیش‌فرض \fIHTML\fR را فراهم می‌کند. فهرست بک‌اندهای موجود در حال حاضر عبارت است از: .RS .TP \fB\fIdvi\fB\fR با فراخوانی \fBJade\fR یا \fBOpenJade\fR پرونده را به DVI (پرونده‌های مستقل از دستگاه - DeVice Independant) تبدیل می‌کند. .TP \fB\fIhtml\fB\fR با فراخوانی \fBJade\fR یا \fBOpenJade\fR پرونده را به HTML (زبان نشانه‌گذاری ابرمتن) تبدیل می‌کند. .TP \fB\fIman\fB\fR با فراخوانی docbook2man یک مدخل refentry را به صفحه راهنمای یونیکس (manual page) تبدیل می‌کند. به غیر از DocBook با سایر انواع اسناد SGML کار نمی‌کند. .TP \fB\fIpdf\fB\fR با فراخوانی \fBJade\fR یا \fBOpenJade\fR پرونده را به PDF (قالب سند قابل حمل - Portable Document Format) تبدیل می‌کند. .TP \fB\fIps\fB\fR با فراخوانی \fBJade\fR یا \fBOpenJade\fR پرونده را به PostScript تبدیل می‌کند. .TP \fB\fIrtf\fB\fR با فراخوانی \fBJade\fR یا \fBOpenJade\fR پرونده را به RTF (قالب متن غنی - Rich Text Format) تبدیل می‌کند. پرونده خروجی را می‌توان در \fBMS Word\fR یا برنامه‌های جایگزین آن در لینوکس وارد کرد. .TP \fB\fItex\fB\fR با فراخوانی \fBJade\fR یا \fBOpenJade\fR پرونده را به TeX تبدیل می‌کند. .TP \fB\fItexi\fB\fR با فراخوانی docbook2texi پرونده را به صفحات GNU TeXinfo تبدیل می‌کند. به غیر از DocBook با سایر انواع اسناد SGML کار نمی‌کند. .TP \fB\fItxt\fB\fR با فراخوانی \fBJade\fR یا \fBOpenJade\fR و سپس \fBLynx\fR پرونده را به یک پرونده متنی ساده تبدیل می‌کند. .RE .TP \fB -c \fIfile\fB | --cat \fIfile\fB \fR امکان استفاده از یک کاتالوگ باز SGML اضافی (SGML Open Catalog) را فراهم می‌کند که پرونده‌های دیگری مانند شیوه‌نامه‌های سفارشی، تطبیق‌های مربوط به تعاریف نوع سند DocBook، موجودیت‌های کاراکتری خاص و غیره را فهرست می‌نماید. این کاتالوگ به فهرست کاتالوگ‌های تعیین‌شده توسط اسکریپت افزوده می‌شود (گزینه \fB--nostd\fR در زیر را ببینید). .TP \fB -n | --nostd \fR از کاتالوگ‌های استاندارد SGML Open استفاده نمی‌کند. در حالت عادی، فهرست کاتالوگ‌های استاندارد به این صورت تعیین می‌شود: .RS .TP 0.2i \(bu اگر کاتالوگ متمرکز وجود داشته باشد، از آن استفاده می‌شود. کاتالوگ متمرکز فهرستی از تمام کاتالوگ‌های مورد نیاز است که معمولاً در \fI/etc/sgml\fR قرار دارد. نام آن توسط فرانت‌اند ارائه می‌شود؛ برای مثال فرانت‌اند \fIdocbook\fR مقدار \fI/etc/sgml/sgml-docbook.cat\fR را برمی‌گرداند. .TP 0.2i \(bu در غیر این صورت، تمام پرونده‌های با نام \fIcatalog\fR از زیرپوشه‌های پوشه پایه SGML (معمولاً \fI/usr/share/sgml\fR) انتخاب می‌شوند. .RE این گزینه در ترکیب با گزینه \fB--cat\fR برای استفاده انحصاری از کاتالوگ‌های مشخص‌شده در خط فرمان کاربرد دارد. .TP \fB -d \fIfile\fB|default|none | --dsl \fIfile\fB|default|none \fR امکان استفاده از یک شیوه‌نامه سفارشی به جای شیوه‌نامه پیش‌فرض را فراهم می‌کند. .PP می‌توان یک «هدف» (target) با پیشوند علامت هش "#" به انتهای نام پرونده اضافه کرد. در نتیجه، تنها بخش متناظر از شیوه‌نامه اجرا می‌شود («مشخصه شیوه»ای که «شناسه» آن برابر با نام هدف باشد). کاربرد رایج این سازوکار، تعریف اهداف "#html" و "#print" برای فعال‌سازی بخش مربوطه در یک شیوه‌نامه جایگزین مشترک برای تبدیل‌های HTML و چاپی است. .PP با جایگزینی نام پرونده با "default"، از شیوه‌نامه پیش‌فرض ارائه‌شده توسط فرانت‌اند استفاده می‌شود. برای مثال، فرانت‌اند \fIdocbook\fR مسیر \fI\&./docbook.dsl#html\fR (یا \fI\&./docbook.dsl#print\fR) را در پوشه پایه SGML برمی‌گرداند. .PP با جایگزینی نام پرونده با "none"، هیچ شیوه‌نامه جایگزینی (حتی شیوه‌نامه پیش‌فرض) استفاده نمی‌شود. شیوه‌نامه‌ای که در این حالت استفاده می‌شود نیز توسط فرانت‌اند تعیین می‌گردد. برای مثال، فرانت‌اند \fIdocbook\fR پرونده \fIhtml/docbook.dsl\fR (یا \fIprint/docbook.dsl\fR) متعلق به Norman Walsh را از زیرپوشه‌های پایه SGML پیدا کرده و برمی‌گرداند. .PP اگر هیچ گزینه --dsl مشخص نشود، مقدار پیش‌فرض "--dsl default" اعمال خواهد شد. .TP \fB -l \fIfile\fB | --dcl \fIfile\fB \fR امکان استفاده از یک اعلان SGML سفارشی به جای اعلان پیش‌فرض را فراهم می‌کند. نام پرونده اعلان پیش‌فرض SGML برای پرونده‌های SGML تنظیم نشده و برای پرونده‌های XML برابر با \fIxml.dcl\fR در پوشه پایه SGML است. .TP \fB -s \fIpath\fB | --sgmlbase \fIpath\fB \fR امکان تعیین مسیر دیگری برای پوشه پایه SGML را فراهم می‌کند. این پوشه‌ای است که تمام DTDها، شیوه‌نامه‌ها، موجودیت‌ها و سایر فایل‌های SGML در زیر آن نصب شده‌اند. مقدار پیش‌فرض آن \fI/usr/share/sgml\fR است. .TP \fB -p \fIprogram\fB | --parser \fIprogram\fB \fR در صورت نصب چند پردازشگر، پردازشگر مورد استفاده (\fBJade\fR یا \fBOpenJade\fR) را مشخص می‌کند. اگر این گزینه تعیین نشود، اسکریپت ابتدا Jade و سپس \fBOpenJade\fR را امتحان می‌کند. .TP \fB -o \fIdirectory\fB | --output \fIdirectory\fB \fR پوشه خروجی را برای ذخیره تمامی پرونده‌های تولیدشده تنظیم می‌کند. اگر شیوه‌نامه‌ها زیرپوشه‌ای برای ذخیره پرونده‌های خروجی تعریف کرده باشند، زیرپوشه تعریف‌شده درون پوشه مشخص‌شده با این گزینه قرار خواهد گرفت. .TP \fB -V \fIvariable\fB=[\fIvalue\fB] \fR یک متغیر را تنظیم می‌کند (در صورت مشخص شدن مقدار، مقداردهی می‌شود). .TP \fB -u | --nochunks \fR تنها یک پرونده بزرگ خروجی تولید می‌کند. این گزینه فقط هنگام تولید خروجی HTML مفید است، زیرا خروجی HTML معمولاً به چندین پرونده تقسیم می‌شود. این گزینه تنظیمات احتمالی انجام‌شده در شیوه‌نامه‌ها را بازنویسی (override) می‌کند. .TP \fB -i \fIsection\fB | --include \fIsection\fB \fR یک بخش نشانه‌گذاری‌شده (marked section) در SGML را به عنوان "include" علامت‌گذاری می‌کند. یک بخش نشانه‌گذاری‌شده SGML نوعی بخش شرطی در سند است. اگر به صورت "ignore" تعریف شود نادیده گرفته می‌شود و در غیر این صورت پردازش خواهد شد. نمونه‌ای از چنین بخش نشانه‌گذاری‌شده‌ای: .PP .nf ]> ... ... .fi .TP \fB -w \fItype\fB|list | --warning \fItype\fB|list \fR نمایش انواع هشدارهای مشخص‌شده را فعال یا غیرفعال می‌کند. می‌توان چندین گزینه -w را در خط فرمان وارد کرد. انواع هشدارهایی که با "no-" شروع می‌شوند هشدارهای مربوطه را غیرفعال کرده و سایر انواع، آن‌ها را فعال می‌نمایند. .PP اگر نوع هشدار با "list" جایگزین شود، فهرستی از انواع هشدارهای مجاز نمایش داده می‌شود. .TP \fB -e \fItype\fB|list | --error \fItype\fB|list \fR انواع خطاهای مشخص‌شده را غیرفعال می‌کند. می‌توان چندین گزینه -e را در خط فرمان وارد کرد. تمام انواع خطاها با "no-" شروع می‌شوند. .PP اگر نوع خطا با "list" جایگزین شود، فهرستی از انواع خطاهای مجاز نمایش داده می‌شود. .TP \fB -h | --help \fR یک پیام راهنمای کوتاه نمایش داده و خارج می‌شود. .TP \fB -v | --version \fR شناسه نگارش برنامه را چاپ کرده و خارج می‌شود. .SH "فایل‌ها (FILES)" .TP \fB\fI/etc/sgml/sgml-docbook.cat\fB\fR کاتالوگ باز متمرکز SGML. اگر فرانت‌اندی غیر از \fIdocbook\fR استفاده شود، ممکن است این نام تغییر کند. .TP \fB\fI/usr/share/sgml/docbook/utils-0.6.15 /backends\fB\fR بک‌اندهای مختلف .TP \fB\fI/usr/share/sgml/docbook/utils-0.6.15 /frontends\fB\fR فرانت‌اندهای مختلف .TP \fB\fI/usr/share/sgml/docbook/utils-0.6.15 /helpers\fB\fR اسکریپت‌های کمکی مختلف مانند docbook2man یا docbook2texi .SH "نویسندگان (AUTHORS)" .PP Eric Bischoff (اسکریپت شل jw و تعدادی از بک‌اندها)، Jochem Huhmann (بک‌اندهای \fIman\fR و \fItexi\fR) .SH "همچنین ببینید (SEE ALSO)" .PP \fBdocbook2man-spec.pl\fR(1), \fBdocbook2texi-spec.pl\fR(1), \fBinstall-catalog\fR(8), \fBnsgmls\fR(1), وبگاه docbook-utils به نشانی \&.