.de URL \\$2 \(laURL: \\$1 \(ra\\$3 .. .if \n[.g] .mso www.tmac .TH SSCONVERT 1 "2020-04-19" "gnumeric" "GNOME" .SH "نام (NAME)" ssconvert \- مبدل خط فرمانی قالب‌های صفحه‌گسترده .SH "خلاصه دستور (SYNOPSIS)" \fBssconvert\fR [\fIOPTIONS\fR] \fIinfile\fR \fIoutfile\fR .P \fBssconvert\fR [\fIOPTIONS\fR] \fB\-\-merge\-to\fR \fIoutfile\fR \fIinfile1\fR \fIinfile2\fR \fB...\fR .SH "توضیحات (DESCRIPTION)" دستور \fBssconvert\fR یک ابزار خط فرمانی برای تبدیل فایل‌های صفحه‌گسترده میان قالب‌های گوناگون صفحه‌گسترده است. این ابزار، برنامه‌ای مکمل برای \fBGnumeric\fR، نرم‌افزار قدرتمند صفحه‌گسترده ایجادشده توسط پروژه GNOME است. ابزار \fBssconvert\fR نام‌های فایل یا URIها را به عنوان \fIinfile\fR و \fIoutfile\fR می‌پذیرد. از URIهای ویژه \fIfd://0\fR و \fIfd://1\fR می‌توان به ترتیب برای ورودی استاندارد و خروجی استاندارد استفاده کرد. .SH "گزینه‌ها (OPTIONS)" این برنامه از ساختار معمول خط فرمان GNU پیروی می‌کند که در آن گزینه‌های تک‌حرفی با یک خط تیره یکتا (`-') و گزینه‌های طولانی‌تر با دو خط تیره (`--') آغاز می‌شوند. .SS "گزینه‌های اصلی (Main options)" .TP .B \-\-recalc محاسبه مجدد تمام سلول‌ها پیش از نوشتن نتیجه. .TP .B \-\-set \fICELL=CONTENTS\fR تنظیم مقدار \fICELL\fR روی \fICONTENTS\fR. برای قرار دادن یک عبارت در یک سلول، یک علامت = اضافه درج کنید؛ برای نمونه: \-\-set "A11==A10+1". این گزینه می‌تواند به هر تعداد بار که نیاز باشد تکرار شود. چنانچه کتاب‌کار برای محاسبه مجدد خودکار تنظیم شده باشد، پس از مقداردهی همه سلول‌ها، محاسبات آن مجدداً انجام خواهد شد. در غیر این صورت، می‌توان محاسبه مجدد را با \-\-recalc اجبار کرد. .TP .B \-v, \-\-verbose ارائه توضیحات کمی مفصل‌تر درباره روند کار. .TP .B \-\-list\-exporters فهرست کردن صادرکننده‌های دردسترس (قالب‌های فایلی که می‌توانند نوشته شوند). .TP .B \-T, \-\-export\-type=\fIID\fR مشخص کردن اینکه از کدام صادرکننده استفاده شود؛ برای مشاهده فهرست، به بخش زیر مراجعه کنید. این گزینه تنها زمانی ضروری است که قالب درست از روی نام فایل خروجی قابل تشخیص نباشد. فهرست قالب‌های صادراتی دردسترس را می‌توان با استفاده از گزینه \-\-list\-exporters تولید کرد. با این حال، هنگامی که صدور تصویر با استفاده از گزینه \-\-export\-graphs درخواست می‌شود، به جای آن باید فهرست قالب‌های تصویر بررسی شود. آن فهرست را می‌توان با استفاده از گزینه \-\-list\-image\-formats تولید کرد. .TP .B \-O, \-\-export\-options=\fIoptionsstring\fR مشخص کردن پارامترها برای صادرکننده انتخاب‌شده. \fIoptionsstring\fR فهرستی از جفت‌های \fIparameter\fR=\fIvalue\fR است که با فاصله از هم جدا شده‌اند. نام‌ها و مقادیر مجاز پارامترها مختص صادرکننده بوده و در ادامه مستند شده‌اند. می‌توان چندین پارامتر را مشخص کرد. .TP .B \-\-export\-graphs صدور نمودارهای (یا گراف‌های) داخل صفحه‌گسترده ورودی به فایل‌های تصویری شماره‌گذاری‌شده (به‌طور پیش‌فرض SVG). فهرست قالب‌های تصویر دردسترس را می‌توان با \-\-list\-image\-formats چاپ کرد. .TP .B \-\-list\-importers فهرست کردن واردکننده‌های دردسترس (قالب‌های فایلی که می‌توانند خوانده شوند). .B \-I, \-\-import\-type=\fIID\fR مشخص کردن اینکه از کدام واردکننده استفاده شود؛ برای مشاهده فهرست، به بخش زیر مراجعه کنید. این گزینه تنها زمانی ضروری است که قالب درست از روی نام فایل ورودی قابل تشخیص نباشد. .TP .B \-\-list\-image\-formats فهرست کردن قالب‌های تصویر دردسترس برای صدور نمودار. .TP .B \-E, \-\-import\-encoding=\fISTRING\fR مشخص کردن یک کدگذاری برای محتوای واردشده. .TP .B \-M, \-\-merge\-to=\fIFILENAME\fR ادغام مجموعه‌ای از کتاب‌های کار در یک کتاب‌کار. اندازه برگه به اندازه بزرگ‌ترین برگه در میان تمام کتاب‌های کار گسترش خواهد یافت. نام‌های موجود در دامنه کتاب‌های کار مجزا، در دامنه کتاب‌کار ادغام‌شده قرار خواهند گرفت. در صورت وجود تداخل در نام‌ها، عملیات ادغام لغو خواهد شد. .TP .B \-S, \-\-export\-file\-per\-sheet صدور یک فایل به ازای هر برگه در صورتی که صادرکننده در هر زمان تنها از یک برگه پشتیبانی کند. با نام فایل خروجی به عنوان یک الگو رفتار می‌شود که در آن، شماره برگه جایگزین %n، نام برگه جایگزین %s، و در صورت صدور نمودار، نام شیء برگه جایگزین %o می‌شود. اگر هیچ جایگزینی وجود نداشته باشد، مقدار پیش‌فرض ".%n" افزوده خواهد شد. .SS "گزینه‌های راهنما (Help options)" .TP .B \-\-version نمایش نسخه ssconvert. .TP .B \-h, \-\-help, \-\-usage نمایش یک پیام کوتاه درباره نحوه استفاده. .TP .B \-\-help\-all نمایش تمام گزینه‌های راهنما. .TP .B \-\-help\-libspreadsheet نمایش گزینه‌های Gnumeric. .SH "فهرست شناسه‌های واردکننده/صادرکننده (LIST OF IMPORTER/EXPORTER IDS)" شناسه‌های زیر می‌توانند هم برای وارد کردن (خواندن) و هم برای صادر کردن (نوشتن) استفاده شوند. .TP .B Gnumeric_XmlIO:sax قالب فایل XML متعلق به Gnumeric (*.gnumeric) .TP .B Gnumeric_OpenCalc:openoffice .URL "http://en.wikipedia.org/wiki/OpenDocument" "OpenDocument" یا .URL "http://en.wikipedia.org/wiki/OpenOffice.org_Calc" "OpenOffice Calc" قالب (*.sxc, *.ods). به عنوان یک صادرکننده، این همان ODF/OpenOffice بدون عناصر خارجی (*.ods) است. .TP .B Gnumeric_dif:dif .URL "http://en.wikipedia.org/wiki/Data_Interchange_Format" "Data Interchange Format" (*.dif) .TP .B Gnumeric_paradox:paradox .URL "http://en.wikipedia.org/wiki/Paradox_%28database%29" "Paradox database" یا فایل شاخص اصلی (*.db, *.px) .TP .B Gnumeric_stf:stf_assistant متنی (قابل پیکربندی) .TP .B Gnumeric_sylk:sylk .URL "http://en.wikipedia.org/wiki/Multiplan" "MultiPlan" .URL "http://en.wikipedia.org/wiki/SYmbolic_LinK_%28SYLK%29" "Symbolic Link (SYLK)" (*.slk) .TP .B Gnumeric_Excel:xlsx قالب Microsoft Excel (tm) 2007 ("Office Open XML"، .URL "http://en.wikipedia.org/wiki/XLSX" "OOXML" ).SH "فهرست شناسه‌های واردکننده مهم (LIST OF IMPORTANT IMPORTER IDS)" .TP .B Gnumeric_stf:stf_csvtab مقادیر جداشده با کاما یا تب (CSV/TSV) (*.csv) .TP .B Gnumeric_html:html قالب HTML (*.html, *.htm) .TP .B Gnumeric_Excel:excel مایکروسافت اکسل Microsoft Excel (tm) (*.xls) .TP .B Gnumeric_Excel:excel_xml مایکروسافت اکسل Microsoft Excel (tm) 2003 SpreadsheetML .SH "فهرست سایر شناسه‌های واردکننده (LIST OF OTHER IMPORTER IDS)" .TP .B Gnumeric_QPro:qpro .URL "http://en.wikipedia.org/wiki/Quattro_Pro" "Quattro Pro" (*.wb1, *.wb2, *.wb3) .TP .B Gnumeric_applix:applix ‏Applix (*.as) .TP .B Gnumeric_lotus:lotus .URL "http://en.wikipedia.org/wiki/Lotus_1-2-3" "Lotus 1-2-3" (*.wk1, *.wks, *.123) .TP .B Gnumeric_mps:mps .URL "http://en.wikipedia.org/wiki/MPS_%28format%29" "قالب MPS (Mathematical Programming System)" قالب فایل برنامه‌ریزی خطی و برنامه‌ریزی عدد صحیح مختلط (*.mps) .TP .B Gnumeric_oleo:oleo .URL "http://en.wikipedia.org/wiki/GNU_Oleo" "GNU Oleo" (*.oleo) .TP .B Gnumeric_plan_perfect:pln قالب PlanPerfect (PLN) .TP .B Gnumeric_psiconv:psiconv ‏Psion (*.psisheet) .TP .B Gnumeric_sc:sc ‏SC/xspread .TP .B Gnumeric_xbase:xbase .URL "http://en.wikipedia.org/wiki/XBase" "xBase" قالب فایل (*.dbf) .SH "فهرست شناسه‌های صادرکننده مهم (LIST OF IMPORTANT EXPORTER IDS)" .TP .B Gnumeric_OpenCalc:odf ‏ODF/OpenOffice به همراه عناصر خارجی (*.ods) .TP .B Gnumeric_glpk:glpk حل‌کننده برنامه‌ریزی خطی GLPK .TP .B Gnumeric_html:html40 ‏HTML 4.0 (*.html) .TP .B Gnumeric_html:html40frag قطعه‌کد HTML (*.html) .TP .B Gnumeric_html:xhtml ‏XHTML (*.html) .TP .B Gnumeric_html:xhtml_range محدوده XHTML - برای صدور به کلیپ‌بورد .TP .B Gnumeric_pdf:pdf_assistant قالب سند قابل‌حمل Portable Document Format (*.PDF) .TP .B Gnumeric_stf:stf_csv مقادیر جداشده با کاما (CSV) .TP .B Gnumeric_Excel:excel_dsf مایکروسافت اکسل Microsoft Excel (tm) 97/2000/XP & 5.0/95 .SH "فهرست سایر شناسه‌های صادرکننده (LIST OF OTHER EXPORTER IDS)" .TP .B Gnumeric_Excel:excel_biff7 مایکروسافت اکسل Microsoft Excel (tm) 5.0/95 .TP .B Gnumeric_Excel:excel_biff8 مایکروسافت اکسل Microsoft S Excel (tm) 97/2000/XP .TP .B Gnumeric_GnomeGlossary:po قالب فایل PO واژه‌نامه گنوم (Gnome Glossary) .TP .B Gnumeric_html:html32 ‏HTML 3.2 (*.html) .TP .B Gnumeric_html:latex ‏LaTeX 2e (*.tex) .TP .B Gnumeric_html:latex_table قطعه‌کد جدول LaTeX 2e (*.tex) .TP .B Gnumeric_html:roff قالب .URL "http://en.wikipedia.org/wiki/Troff" "TROFF" (*.me). .TP .B Gnumeric_lpsolve:lpsolve .URL "http://sourceforge.net/projects/lpsolve" "LPSolve" حل‌کننده برنامه‌ریزی خطی عدد صحیح مختلط (MILP) .SH "گزینه‌های صادرکننده قالب سند قابل‌حمل (*.pdf) (OPTIONS FOR THE PORTABLE DOCUMENT FORMAT (*.pdf) EXPORTER)" .TP .B sheet نام برگه کارپوشه برای انجام عملیات. می‌توانید با تکرار این گزینه چندین برگه را مشخص کنید. اگر گزینه \fBobject\fR تعیین شده باشد، این گزینه نادیده گرفته می‌شود. .TP .B active-sheet انتخاب برگه فعال برای انجام عملیات. مقدار این گزینه اهمیتی ندارد، اما درج علامت مساوی الزامی است. .TP .B object نام شیء برگه برای چاپ. در صورت مشخص شدن این گزینه، هرگونه گزینه \fBsheet\fR نادیده گرفته می‌شود. تنها نخستین \fBobject\fR مشخص‌شده صادر می‌شود. .TP .B paper اندازه کاغذ. مقادیر معتبر شامل "\fBA4\fR" برای ISO A4 و "\fBna_letter_8.5x11in\fR" برای US Letter است. اگر یک نمودار مشخص از طریق گزینه \fBobject\fR تعیین شده باشد، آن‌گاه اندازه کاغذ "\fBfit\fR" اندازه کاغذ را به اندازه همان نمودار کاهش می‌دهد. .\" FIXME Is there a convenient way to list all valid paper sizes? .\" It looks like at least the values from plugins/excel/ms-excel-read.c's .\" paper_size_table[] are supported..SH "گزینه‌ها برای صادرکننده متنی قابل پیکربندی (*.txt) (OPTIONS FOR THE CONFIGURABLE TEXT (*.txt) EXPORTER)" .\" Cf. "g_object_class_install_property" calls in src/stf-export.c .TP .B sheet نام برگه‌ای از کارپوشه که عملیات روی آن انجام می‌شود. با تکرار این گزینه می‌توانید چندین برگه را مشخص کنید. .TP .B active-sheet انتخاب برگهٔ فعال برای انجام عملیات. مقدار این گزینه اهمیتی ندارد، اما درج علامت مساوی الزامی است. .TP .B eol قاعدهٔ پایان خط (End Of Line)؛ نحوهٔ خاتمه یافتن خطوط. "\fBunix\fR" برای linefeed (تعویض سطر)، "\fBmac\fR" برای carriage return (بازگشت مکان‌نما)؛ "\fBwindows\fR" برای carriage return به‌همراه linefeed. .TP .B charset کدگذاری نویسه‌های خروجی. پیش‌فرض UTF-8 است. .TP .B locale لوکال (locale) مورد استفاده برای قالب‌بندی اعداد و تاریخ‌ها. پیش‌فرض، لوکال فعلی سیستم است که توسط \fBlocale\fR(1) گزارش می‌شود. برای مشاهدهٔ مقادیر مجاز، خروجی \fBlocale \-a\fR را بررسی کنید. .TP .B quote نویسه یا رشته‌ای که برای محصور کردن فیلدها در نقل‌قول استفاده می‌شود. پیش‌فرض "\fB\\"\fR" (علامت نقل‌قول / گیومه جفتی) است. .TP .B separator رشته‌ای که برای جداسازی فیلدها استفاده می‌شود. پیش‌فرض نویسهٔ فاصله است. .TP .B format نحوهٔ قالب‌بندی سلول‌ها. مقادیر مجاز: "\fBautomatic\fR" (اعمال قالب‌بندی خودکار؛ پیش‌فرض)، "\fBraw\fR" (خروجی‌دادن داده‌ها به‌صورت خام، بدون قالب‌بندی)، یا "\fBpreserve\fR" (حفظ قالب‌بندی سند منبع). این گزینه به تفاوت میان محتوای سلول و نحوهٔ قالب‌بندی آن محتوا مربوط می‌شود. سلولی را در یک سند ورودی Gnumeric در نظر بگیرید که در یک لوکال آمریکایی (US) به‌صورت "4/19/73" وارد شده، قالب آن روی "d-mmm-yyyy" تنظیم شده و بنابراین به‌صورت "19-Apr-1973" قالب‌بندی شده است. با مقدار پیش‌فرض \fBformat\fR یعنی "\fBautomatic\fR"، خروجی به‌صورت "1973/04/19" خواهد بود. با "\fBpreserve\fR"، قالب‌بندی حفظ شده و خروجی به‌صورت "19-Apr-1973" خواهد بود. با "\fBraw\fR"، خروجی به‌صورت "26773" (نمایش داخلی Gnumeric: تعداد روزها از زمان مبدأ یا epoch) خواهد بود. .TP .B transliterate-mode نحوهٔ مدیریت نویسه‌های غیرقابل‌نمایش؛ یعنی نویسه‌هایی که نمی‌توان آن‌ها را در مجموعه نویسه‌های انتخابی خروجی بازنمایی کرد. مقادیر مجاز: "\fBtransliterate\fR"، یا "\fBescape\fR". حالت نخست نویسه‌هایی را که نمی‌توان در مجموعه نویسه‌های خروجی نمایش داد، با تقریب زدن به یک یا چند نویسهٔ مجاز بازنویسی می‌کند. برای جزئیات بیشتر به \fBiconv\fR(1) مراجعه کنید. پیش‌فرض "\fBescape\fR" است که نویسهٔ غیرقابل‌نمایش را با یک توالی گریز (escape sequence) جایگزین می‌کند که نقطهٔ کد یونیکد را مشخص می‌سازد. .TP .B quoting-mode چه زمانی داده‌ها باید در نقل‌قول قرار گیرند؟ "\fBnever\fR"، "\fBauto\fR" (در صورت نیاز علامت نقل‌قول قرار می‌دهد)، یا "\fBalways\fR". پیش‌فرض "\fBauto\fR" است. .TP .B quoting-on-whitespace مشخص می‌کند که آیا وجود نویسهٔ فاصله در ابتدا یا انتهای مقدار، نقل‌قول را الزامی می‌کند یا خیر. پیش‌فرض \fBTRUE\fR است. .\".SH EXIT STATUS .\".SH RETURN VALUE .\".SH ERRORS .\".SH ENVIRONMENT .\".SH FILES .\".SH VERSIONS .\".SH CONFORMING TO .\".SH NOTES .\".SH BUGS .\".SH USAGE .SH "مثال‌ها (EXAMPLES)" برای تبدیل فایل Gnumeric با نام \fIfoo.gnumeric\fR به یک فایل با قالب Microsoft Excel(TM) با نام \fIfoo.xls\fR: .PP \fBssconvert\fR \fIfoo.gnumeric\fR \fIfoo.xls\fR .PP قالب صدور را می‌توان به‌صورت صریح مشخص کرد تا جایگزین مقدار پیش‌فرض (که بر اساس پسوند فایل تعیین می‌شود) شود: .PP \fBssconvert\fR \fB\-\-export\-type=\fRGnumeric_stf:stf_csv\fR \fIfoo.xls\fR \fIfoo.txt\fR .PP برای تبدیل فایل قالب اکسل \fIstatfuns.xls\fR به یک فایل متنی، با تعیین نقطه ویرگول به‌عنوان نویسهٔ جداکننده: .PP \fBssconvert\fR \fB-O 'separator=; format=raw'\fR \fIsamples/excel/statfuns.xls\fR \fIstatfuns.txt\fR .PP برای صادر کردن نمودارها از فایل ورودی \fIinput.gnumeric\fR به فایل‌های شماره‌گذاری‌شدهٔ SVG: .PP \fBssconvert\fR \fB\-\-export\-graphs\fR \fIinput.gnumeric\fR \fI'output.%n.svg'\fR .PP برای صادر کردن نمودارها از فایل ورودی \fIinput.gnumeric\fR به فایل‌های شماره‌گذاری‌شدهٔ PNG: .PP \fBssconvert\fR \fB\-\-export\-type=png\fR \fB\-\-export\-graphs\fR \fIinput.gnumeric\fR \fI'output.%n.png'\fR .PP.SH "مجوز (LICENSE)" \fBssconvert\fR تحت شرایط پروانه عمومی همگانی گنو (GPL)، نسخه ۲ یا ۳ منتشر شده است. برای دریافت اطلاعات پیرامون این پروانه، به کد منبع همراه نرم‌افزار نگاهی بیندازید یا مراجعه کنید به .URL "http://www.gnu.org" "صفحه پروژه GNU" . .SH "کپی‌رایت و تکثیر (COPYRIGHT)" حق تکثیر نرم‌افزار و کد منبع \fBGnumeric\fR همان‌طور که در کد منبع مستند شده است، در اختیار تک‌تک نویسندگان آن قرار دارد. .SH "نویسندگان (AUTHORS)" نویسنده اصلی \fBssconvert\fR Jody Goldberg است؛ \fBssconvert\fR بر پایه پایگاه کد \fBGnumeric\fR ساخته شده است. نسخه اولیه این صفحه راهنما توسط J.H.M. Dassen (Ray) نوشته شده است. .SH "همچنین ببینید (SEE ALSO)" .BR gnumeric(1), .BR ssdiff(1), .BR ssgrep(1), .BR ssindex(1) .URL "http://www.gnome.org/projects/gnumeric" "صفحه اصلی Gnumeric" . .URL "http://www.gnome.org" "صفحه پروژه GNOME" .