'\" t
.\"     Title: xmlstarlet
.\"    Author: Mikhail Grushinskiy
.\" Generator: DocBook XSL-NS Stylesheets v1.76.1 <http://docbook.sf.net>
.\"      Date: 08/26/2012
.\"    Manual: XMLStarlet Manual
.\"    Source: Version 1.4.0
.\"  Language: English
.\"
.TH "XMLSTARLET" "1" "08/26/2012" "Version 1.4.0" "XMLStarlet Manual"
.\" -----------------------------------------------------------------
.\" * 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)"
xmlstarlet \- جعبه‌ابزار خط فرمانی XML/XSLT
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBxml\fR\ 'u
\fBxml\fR [\fIoptions\fR...] {\fIcommand\fR} [\fIcmd\-options\fR...]
.SH "مقدمه (INTRODUCTION)"
.PP
XMLStarlet مجموعه‌ای از ابزارهای خط فرمانی است که می‌توان از آن‌ها برای تبدیل، پرس‌وجو، اعتبارسنجی و ویرایش اسناد و فایل‌های XML با استفاده از دستورهای سادهٔ پوسته بهره برد؛ مشابه روشی که برای فایل‌های متنی ساده با دستورهای UNIX مانند grep، sed، awk، diff، patch، join و غیره انجام می‌شود\&. این مجموعه از ابزارهای خط فرمانی هم توسط کسانی که در خط فرمان پوستهٔ UNIX با اسناد XML فراوانی سر و کار دارند و هم برای پردازش خودکار XML در اسکریپت‌های پوسته قابل استفاده است\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-\-version\fR
.RS 4
نمایش نسخهٔ
xmlstarlet\&.
.RE
.PP
\fB\-\-help\fR
.RS 4
نمایش راهنما\&.
.RE
.SH "دستورها (COMMANDS)"
.PP
\fBxml\fR
\fIcommand\fR
\fB\-\-help\fR
برای راهنمای مختص هر دستور
.PP
دستورهای در دسترس عبارت‌اند از:
.PP
\fBed (یا edit)\fR
.RS 4
ویرایش/به‌روزرسانی سند(های) XML\&.
.RE
.PP
\fBsel (یا select)\fR
.RS 4
انتخاب داده یا پرس‌وجو از سند(های) XML (مانند XPATH و غیره)\&.
.RE
.PP
\fBtr (یا transform)\fR
.RS 4
تبدیل سند(های) XML با استفاده از XSLT\&.
.RE
.PP
\fBval (یا validate)\fR
.RS 4
اعتبارسنجی سند(های) XML (از نظر well\-formed/DTD/XSD/RelaxNG)\&.
.RE
.PP
\fBfo (یا format)\fR
.RS 4
قالب‌بندی سند(های) XML\&.
.RE
.PP
\fBel (یا elements)\fR
.RS 4
نمایش ساختار عنصرهای سند XML\&.
.RE
.PP
\fBc14n (یا canonic)\fR
.RS 4
متعارف‌سازی XML (canonicalization)\&.
.RE
.PP
\fBls (یا list)\fR
.RS 4
فهرست کردن دایرکتوری در قالب XML\&.
.RE
.PP
\fBesc (یا escape)\fR
.RS 4
گریز دادن (escape) نویسه‌های ویژهٔ XML\&.
.RE
.PP
\fBunesc (یا unescape)\fR
.RS 4
بازگردانی (unescape) نویسه‌های ویژهٔ XML\&.
.RE
.PP
\fBpyx (یا xmln)\fR
.RS 4
تبدیل XML به قالب PYX (بر پایهٔ ESIS \- ISO 8879)\&.
.RE
.PP
\fBp2x (یا depyx)\fR
.RS 4
تبدیل PYX به XML\&.
.RE
.SH "مراجع (REFERENCES)"
.PP
XMLStarlet یک جعبه‌ابزار خط فرمانی برای پرس‌وجو، ویرایش، بررسی و تبدیل اسناد XML است (برای اطلاعات بیشتر به http://xmlstar\&.sourceforge\&.net مراجعه کنید)\&.
.SH "گزارش باگ‌ها (BUGS)"
.PP
گزارش باگ‌ها را به فهرست پستی،
xmlstar\-devel@lists\&.sourceforge\&.net
یا سامانهٔ رهگیری باگ ارسال کنید:
\m[blue]\fB\%http://sourceforge.net/tracker/?group_id=66612&atid=515106\fR\m[]\&.
.SH "نویسندگان (AUTHORS)"
.PP
\fBMikhail Grushinskiy\fR
.RS 4
سازندهٔ XMLStarlet\&.
.RE
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.br
حق نشر \(co 2012
.br