'\" t
.\"     Title: testasciidoc
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net>
.\"      Date: 07/17/2024
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "TESTASCIIDOC" "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)"
testasciidoc \- اجرای آزمون‌های انطباق و سازگاری AsciiDoc مشخص‌شده در فایل پیکربندی\&.
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBtestasciidoc\fR [\fIOPTIONS\fR] \fICOMMAND\fR
.SH "توضیحات (DESCRIPTION)"
.sp
دستور testasciidoc آزمون‌های انطباق و سازگاری AsciiDoc را که در فایل پیکربندی مشخص شده‌اند اجرا می‌کند\&.
.SH "دستورات (COMMANDS)"
.sp
مجموعه ابزار testasciidoc دارای سه دستور مختلف است:
.sp
.if n \{\
.RS 4
.\}
.nf
testasciidoc list
testasciidoc run [\-n, \-\-number NUMBER] [\-b, \-\-backend BACKEND] [OPTIONS]
testasciidoc update [\-n, \-\-number NUMBER] [\-b, \-\-backend BACKEND] [OPTIONS]
.fi
.if n \{\
.RE
.\}
.sp
عملکرد این دستورات به شرح زیر است:
.PP
\fBlist\fR
.RS 4
فهرست کردن آزمون‌های تشخیصی موجود\&.
.RE
.PP
\fBrun\fR
.RS 4
اجرای آزمون‌ها (تولید مجدد موارد آزمون موقت و مقایسه آن‌ها با فایل‌های مرجع)\&.
.RE
.PP
\fBupdate\fR
.RS 4
تولید مجدد و به‌روزرسانی فایل‌های مرجع داده‌های آزمون\&. این دستور باید حداقل یک بار اجرا شود تا فایل‌های مرجع لازم جهت مقایسه در طول آزمون‌ها ایجاد شوند\&.
.RE
.sp
که در آن:
.PP
\fBNUMBER\fR
.RS 4
شماره اندیس مورد آزمون از خروجی دستور
testasciidoc list
است\&.
.RE
.PP
\fBBACKEND\fR
.RS 4
بک‌اند asciidoc مورد استفاده است\&.
.RE
.PP
\fBOPTIONS\fR
.RS 4
گزینه‌های فهرست‌شده در زیر هستند\&.
.RE
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-f, \-\-conf\-file\fR=\fICONF_FILE\fR
.RS 4
استفاده از فایل پیکربندی CONF_FILE؛ برای کسب اطلاعات بیشتر درباره ساختار و قالب فایل پیکربندی، به مستندات آزمون‌ها مراجعه کنید\&.
.RE
.PP
\fB\-\-force\fR
.RS 4
به‌روزرسانی تمام داده‌های آزمون و بازنویسی داده‌های موجود\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
testasciidoc list
.RS 4
فهرست کردن تمام اقدامات آزمایشی موجود برای اجرا یا به‌روزرسانی\&.
.RE
.PP
testasciidoc run
.RS 4
اجرای تمام اقدامات آزمایشی موجود\&.
.RE
.PP
testasciidoc run \-\-number 1 \-\-backend html5 \-\-conf\-file=/etc/asciidoc/testasciidoc\&.conf
.RS 4
اجرای مورد آزمون شماره ۱ برای بک‌اند html5 برنامه asciidoc با استفاده از فایل پیکربندی /etc/asciidoc/testasciidoc\&.conf\&.
.RE
.PP
testasciidoc update \-\-number 1 \-\-backend html5
.RS 4
تولید یا به‌روزرسانی فایل‌های مرجع استفاده‌شده برای اولین اقدام از موارد آزمون بک‌اند html5 برنامه asciidoc\&.
.RE
.SH "وضعیت خروج (EXIT STATUS)"
.PP
\fB0\fR
.RS 4
موفقیت‌آمیز\&.
.RE
.PP
\fB1\fR
.RS 4
شکست (خطای نحوی یا نحوه استفاده؛ خطای پیکربندی؛ شکست در پردازش سند؛ خطای پیش‌بینی‌نشده)\&.
.RE
.SH "اشکالات (BUGS)"
.sp
به فایل BUGS در توزیع AsciiDoc مراجعه کنید\&.
.SH "نویسندگان (AUTHORS)"
.sp
برنامه AsciiDoc در ابتدا توسط Stuart Rackham نوشته شده است\&. افراد بسیاری در توسعه آن مشارکت داشته‌اند\&.
.SH "منابع (RESOURCES)"
.sp
گیت‌هاب: https://github\&.com/asciidoc/asciidoc\-py3
.sp
وب‌سایت اصلی: https://asciidoc\&.org
.SH "همچنین ببینید (SEE ALSO)"
.sp
asciidoc(1), a2x(1)