HXREF(1)                        HTML-XML-utils                        HXREF(1)

نام (NAME)
       hxref - تولید ارجاعات متقابل درون و بین فایل‌های HTML

خلاصه دستور (SYNOPSIS)
       hxref [ -x ] [ -l ] [ -b base ] [ -i index ] [ -- ] [ input [ output ]
       ]

توضیحات (DESCRIPTION)
       دستور hxref عناصر درون‌خطی (inline) را به عناصر DFN با محتوای یکسان
       پیوند می‌دهد.  این دستور در صورت نیاز، ویژگی‌های ID را اضافه می‌کند.
       چنانچه محتوای یک DFN یا عنصر دیگر مناسب نباشد، می‌توان از ویژگی TITLE
       برای ارائه اصطلاح مورد استفاده در مقایسه‌ها بهره برد.

       در اینجا یک مثال آورده شده است:

           <p>A <dfn>b-box</dfn> is defined to be...
           <p>For every b there is a <em>b-box</em>...

       خروجی hxref مشابه زیر خواهد بود:

           <p>A <dfn id="b-box">b-box</dfn> is defined to be...
           <p>For every b there is a <a href="#b-box"><em>b-box</em></a>...


گزینه‌ها (OPTIONS)
       گزینه‌های زیر پشتیبانی می‌شوند:

       -x        استفاده از قواعد XML: عناصر خالی با یک اسلش در انتها نوشته
                 می‌شوند: <IMG />

       -b base   پیشوند URLهای تولیدشده را تعیین می‌کند. به‌طور پیش‌فرض base خالی
                 است که منجر به تولید URLهایی مانند "#b-box" در بالا می‌شود.
                 اگر base برای مثال روی "http://xyz" تنظیم شود، URLها شبیه به
                 "http://xyz/#b-box" خواهند بود.

       -i index  به hxref دستور می‌دهد پیش از جستجوی اصطلاحات در سند، آن‌ها را
                 از یک فایل پایگاه‌داده بخواند و پس از آن اصطلاحات یافت‌شده را
                 در همان فایل ذخیره کند. عناصر DFN در سند بر اصطلاحات یافت‌شده
                 در index اولویت دارند. این قابلیت به hxref اجازه می‌دهد تا
                 چندین بار روی فایل‌های مختلف اجرا شود تا فایل‌ها به یکدیگر
                 ارجاع دهند.  ممکن است برای برطرف کردن تمام ارجاعات متقابل،
                 اجرای دوباره دستورها لازم باشد.

       -l        تلاش برای استفاده از اطلاعات وابسته به زبان برای تطبیق
                 نمونه‌ها با تعاریف آن‌ها. در حال حاضر تنها از زبان انگلیسی
                 پشتیبانی می‌شود و تنها قواعد اعمال‌شده عبارتند از جستجو بدون
                 "s" پایانی (تطبیق "trees" با "tree")، بدون "es" پایانی (تطبیق
                 "bosses" با "boss") و جایگزینی "ies" پایانی با "y" (تطبیق
                 "bounties" با "bounty").  hxref زبان را از ویژگی‌های "lang" و
                 "xml:lang" درون سند تشخیص می‌دهد.

عملوندها (OPERANDS)
       عملوندهای زیر پشتیبانی می‌شوند:

       input     نام یک فایل HTML. در صورت عدم ارائه، ورودی استاندارد خوانده
                 می‌شود.  نام ویژه "-" نیز نشان‌دهنده ورودی استاندارد است.
                 input می‌تواند یک URL باشد.

       output    فایلی که خروجی در آن نوشته می‌شود. در صورت عدم ارائه، از خروجی
                 استاندارد استفاده می‌شود. این عملوند نباید یک URL باشد.

عیب‌یابی (DIAGNOSTICS)
       مقدارهای خروج زیر بازگردانده می‌شوند:

       0         اتمام موفقیت‌آمیز.

       > 0       خطایی در تجزیه فایل HTML رخ داده است.  hxref تلاش خواهد کرد
                 تا خطا را تصحیح کرده و در هر صورت خروجی را تولید کند.

همچنین ببینید (SEE ALSO)
       asc2xml(1), hxindex(1), hxnormalize(1), hxnum(1), hxtoc(1), xml2asc(1)

اشکالات (BUGS)
       بازیابی خطا برای HTML نامعتبر بسیار ابتدایی است.

       برنامه ویژگی‌های ID را تولید می‌کند، اما تگ‌های <a name=...> را تولید
       نمی‌کند؛ بنابراین پیوندها تنها در مرورگرهایی کار می‌کنند که ویژگی‌های ID
       را به رسمیت می‌شناسند.

       قواعد تطبیق جمع در انگلیسی ابتدایی هستند. هیچ واژه‌نامه‌ای استفاده
       نمی‌شود؛ مثلاً "bees" به عنوان حالت جمع "be" در نظر گرفته خواهد شد.

       در حال حاضر راهی برای تعیین زبان پیش‌فرض سند در مواردی که عنصر ریشه
       ویژگی "lang" یا "xml:lang" ندارد وجود ندارد.

       hxref ابتدا تلاش می‌کند تا با تشکیل ID از حروف و ارقام یافت‌شده در محتوای
       عنصر، ویژگی‌های ID «خوانا» تولید کند و در صورتی که تعداد کافی پیدا نکند،
       به تولید IDهای تصادفی متوسل می‌شود. با این حال، الگوریتم این نسخه
       ابتدایی بوده و تنها برای حروف و ارقام ASCII نتایج معقولی ارائه می‌دهد.

7.x                               10 Jul 2011                         HXREF(1)