.de d \" begin display
.sp
.in +4
.nf
..
.de e \" end display
.in -4
.fi
.sp
..
.TH "HXADDID" "1" "10 Jul 2011" "7.x" "HTML-XML-utils"
.SH "نام (NAME)"
hxaddid \- افزودن شناسه (ID) به عناصر انتخاب‌شده در پرونده‌های HTML یا XML
.SH "خلاصه دستور (SYNOPSIS)"
.B hxaddid
.RB "[\| " \-x " \|]"
.RB "[\-\-]"
.IR elem|.class|elem.class
.RI "[\| " file-or-URL " \|]"
.SH "توضیحات (DESCRIPTION)"
.LP
دستور
.B hxaddid 
یک پروندهٔ HTML یا XML را در خروجی استاندارد کپی می‌کند، در حالی که شناسه‌های عنصر (ID) را به عناصر یا کلاس‌های مشخص‌شده اضافه می‌نماید.
.LP
به‌عنوان مثال، به ازای ورودی زیر:
.d
<p>A paragraph without an ID</p>
.e
دستور
.d
hxaddid p
.e
خروجی زیر را تولید خواهد کرد:
.d
<p id="a-paragraph">A paragraph without an ID</p>
.e
.LP
اگر کلاسی را با استفاده از \fB.class\fP مشخص کنید، شناسه‌ها تنها به عناصری اضافه می‌شوند که حاوی آن کلاس باشند. و اگر یک عنصر و یک کلاس را با \fBelem.class\fP مشخص کنید، شناسه‌ها تنها به عناصر مشخص‌شده‌ای که حاوی آن کلاس باشند اضافه خواهند شد.
.LP
اگر دو عنصر به‌طور طبیعی شناسه یکسانی تولید کنند، شماره‌ای به نام شناسه افزوده می‌شود (با شروع از 0) تا اطمینان حاصل شود که شناسه‌ها یکتا هستند. شناسه‌ها به عناصر منطبقی که از پیش دارای شناسه هستند اضافه نمی‌شوند.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های زیر پشتیبانی می‌شوند:
.TP 10
.B \-x
استفاده از قواعد XML: عناصر خالی با یک اسلش در انتها نوشته می‌شوند: <IMG\ />. همچنین باعث می‌شود مطابقت نام عناصر با حساسیت به حروف کوچک و بزرگ انجام گیرد.
.SH "عملوندها (OPERANDS)"
عملوندهای زیر پشتیبانی می‌شوند:
.TP 10
.I elem
نام عنصری که باید انتخاب شود.
.TP 10
.I .class
نام کلاسی که باید انتخاب شود.
.TP 10
.I elem.class
نام عنصر دارای کلاسی که باید انتخاب شود.
.TP 10
.I file-or-URL
نام یا نشانی اینترنتی (URL) یک پروندهٔ HTML یا XHTML.
.SH "وضعیت خروج (EXIT STATUS)"
مقدارهای خروج زیر بازگردانده می‌شوند:
.TP 10
.B 0
اجرای موفقیت‌آمیز.
.TP
.B > 0
خطایی در تجزیهٔ یکی از پرونده‌های HTML یا XML رخ داده است.
.SH "محیط (ENVIRONMENT)"
برای استفاده از پیشکار (پروکسی) جهت دریافت پرونده‌های دوردست، متغیرهای محیطی
.B http_proxy
یا
.BR ftp_proxy
را تنظیم کنید.
برای نمونه:
.B http_proxy="http://localhost:8080"
.SH "اشکالات (BUGS)"
.LP
ورودی را UTF-8 فرض می‌کند. موجودیت‌های نویسه‌ای (character entities) را بسط نمی‌دهد؛ در عوض ورودی را از طریق خط لوله به
.BR hxunent (1)
و
.BR asc2xml (1)
هدایت کنید تا به UTF-8 تبدیل شود.
.LP
دستور
.B hxaddid
ابتدا تلاش می‌کند با استفاده از حروف و ارقام موجود در محتوای عنصر، شناسه‌های «خوانا» بسازد و در صورتی که نویسه‌های کافی نیابد، به ساخت شناسه‌های دلخواه روی می‌آورد. با این حال، الگوریتم در این نسخه ابتدایی است و تنها برای حروف و ارقام ASCII نتایج معقولی ارائه می‌دهد.
.LP
پرونده‌های دوردست (مشخص‌شده با URL) در حال حاضر تنها از طریق HTTP پشتیبانی می‌شوند. پرونده‌های محافظت‌شده با گذرواژه یا وابسته به کوکی‌های HTTP پشتیبانی نمی‌شوند. (می‌توانید از ابزارهایی مانند
.BR curl (1)
یا
.BR wget (1)
برای دریافت چنین پرونده‌هایی استفاده کنید.)
.SH "همچنین ببینید (SEE ALSO)"
.BR asc2xml (1),
.BR hxprune (1),
.BR hxnormalize (1),
.BR hxnum (1),
.BR hxtoc (1),
.BR hxunent (1),
.BR xml2asc (1),
.BR UTF-8 " (RFC 2279)"