SSCONVERT(1) GNOME SSCONVERT(1)

ssconvert - مبدل خط فرمانی قالب‌های صفحه‌گسترده

ssconvert [OPTIONS] infile outfile

ssconvert [OPTIONS] --merge-to outfile infile1 infile2 ...

دستور ssconvert یک ابزار خط فرمانی برای تبدیل فایل‌های صفحه‌گسترده میان قالب‌های گوناگون صفحه‌گسترده است. این ابزار، برنامه‌ای مکمل برای Gnumeric، نرم‌افزار قدرتمند صفحه‌گسترده ایجادشده توسط پروژه GNOME است.

ابزار ssconvert نام‌های فایل یا URIها را به عنوان infile و outfile می‌پذیرد. از URIهای ویژه fd://0 و fd://1 می‌توان به ترتیب برای ورودی استاندارد و خروجی استاندارد استفاده کرد.

این برنامه از ساختار معمول خط فرمان GNU پیروی می‌کند که در آن گزینه‌های تک‌حرفی با یک خط تیره یکتا (`-') و گزینه‌های طولانی‌تر با دو خط تیره (`--') آغاز می‌شوند.

محاسبه مجدد تمام سلول‌ها پیش از نوشتن نتیجه.
تنظیم مقدار CELL روی CONTENTS. برای قرار دادن یک عبارت در یک سلول، یک علامت = اضافه درج کنید؛ برای نمونه: --set "A11==A10+1". این گزینه می‌تواند به هر تعداد بار که نیاز باشد تکرار شود. چنانچه کتاب‌کار برای محاسبه مجدد خودکار تنظیم شده باشد، پس از مقداردهی همه سلول‌ها، محاسبات آن مجدداً انجام خواهد شد. در غیر این صورت، می‌توان محاسبه مجدد را با --recalc اجبار کرد.
ارائه توضیحات کمی مفصل‌تر درباره روند کار.
فهرست کردن صادرکننده‌های دردسترس (قالب‌های فایلی که می‌توانند نوشته شوند).
مشخص کردن اینکه از کدام صادرکننده استفاده شود؛ برای مشاهده فهرست، به بخش زیر مراجعه کنید. این گزینه تنها زمانی ضروری است که قالب درست از روی نام فایل خروجی قابل تشخیص نباشد. فهرست قالب‌های صادراتی دردسترس را می‌توان با استفاده از گزینه --list-exporters تولید کرد. با این حال، هنگامی که صدور تصویر با استفاده از گزینه --export-graphs درخواست می‌شود، به جای آن باید فهرست قالب‌های تصویر بررسی شود. آن فهرست را می‌توان با استفاده از گزینه --list-image-formats تولید کرد.
مشخص کردن پارامترها برای صادرکننده انتخاب‌شده. optionsstring فهرستی از جفت‌های parameter=value است که با فاصله از هم جدا شده‌اند. نام‌ها و مقادیر مجاز پارامترها مختص صادرکننده بوده و در ادامه مستند شده‌اند. می‌توان چندین پارامتر را مشخص کرد.
صدور نمودارهای (یا گراف‌های) داخل صفحه‌گسترده ورودی به فایل‌های تصویری شماره‌گذاری‌شده (به‌طور پیش‌فرض SVG). فهرست قالب‌های تصویر دردسترس را می‌توان با --list-image-formats چاپ کرد.
فهرست کردن واردکننده‌های دردسترس (قالب‌های فایلی که می‌توانند خوانده شوند). -I, --import-type=ID مشخص کردن اینکه از کدام واردکننده استفاده شود؛ برای مشاهده فهرست، به بخش زیر مراجعه کنید. این گزینه تنها زمانی ضروری است که قالب درست از روی نام فایل ورودی قابل تشخیص نباشد.
فهرست کردن قالب‌های تصویر دردسترس برای صدور نمودار.
مشخص کردن یک کدگذاری برای محتوای واردشده.
ادغام مجموعه‌ای از کتاب‌های کار در یک کتاب‌کار. اندازه برگه به اندازه بزرگ‌ترین برگه در میان تمام کتاب‌های کار گسترش خواهد یافت. نام‌های موجود در دامنه کتاب‌های کار مجزا، در دامنه کتاب‌کار ادغام‌شده قرار خواهند گرفت. در صورت وجود تداخل در نام‌ها، عملیات ادغام لغو خواهد شد.
صدور یک فایل به ازای هر برگه در صورتی که صادرکننده در هر زمان تنها از یک برگه پشتیبانی کند. با نام فایل خروجی به عنوان یک الگو رفتار می‌شود که در آن، شماره برگه جایگزین %n، نام برگه جایگزین %s، و در صورت صدور نمودار، نام شیء برگه جایگزین %o می‌شود. اگر هیچ جایگزینی وجود نداشته باشد، مقدار پیش‌فرض ".%n" افزوده خواهد شد.

نمایش نسخه ssconvert.
نمایش یک پیام کوتاه درباره نحوه استفاده.
نمایش تمام گزینه‌های راهنما.
نمایش گزینه‌های Gnumeric.

شناسه‌های زیر می‌توانند هم برای وارد کردن (خواندن) و هم برای صادر کردن (نوشتن) استفاده شوند.

قالب فایل XML متعلق به Gnumeric (*.gnumeric)
OpenDocument ⟨URL: http://en.wikipedia.org/wiki/OpenDocument ⟩ یا OpenOffice Calc ⟨URL: http://en.wikipedia.org/wiki/OpenOffice.org_Calc ⟩ قالب (*.sxc, *.ods). به عنوان یک صادرکننده، این همان ODF/OpenOffice بدون عناصر خارجی (*.ods) است.
Data Interchange Format ⟨URL: http://en.wikipedia.org/wiki/Data_Interchange_Format ⟩ (*.dif)
Paradox database ⟨URL: http://en.wikipedia.org/wiki/Paradox_%28database%29 ⟩ یا فایل شاخص اصلی (*.db, *.px)
متنی (قابل پیکربندی)
MultiPlan ⟨URL: http://en.wikipedia.org/wiki/Multiplan ⟩ Symbolic Link (SYLK) ⟨URL: http://en.wikipedia.org/wiki/SYmbolic_LinK_%28SYLK%29 ⟩ (*.slk)
قالب Microsoft Excel (tm) 2007 ("Office Open XML"، OOXML ⟨URL: http://en.wikipedia.org/wiki/XLSX ⟩ ).SH "فهرست شناسه‌های واردکننده مهم (LIST OF IMPORTANT IMPORTER IDS)"
مقادیر جداشده با کاما یا تب (CSV/TSV) (*.csv)
قالب HTML (*.html, *.htm)
مایکروسافت اکسل Microsoft Excel (tm) (*.xls)
مایکروسافت اکسل Microsoft Excel (tm) 2003 SpreadsheetML

Quattro Pro ⟨URL: http://en.wikipedia.org/wiki/Quattro_Pro ⟩ (*.wb1, *.wb2, *.wb3)
‏Applix (*.as)
Lotus 1-2-3 ⟨URL: http://en.wikipedia.org/wiki/Lotus_1-2-3 ⟩ (*.wk1, *.wks, *.123)
قالب MPS (Mathematical Programming System) ⟨URL: http://en.wikipedia.org/wiki/MPS_%28format%29 ⟩ قالب فایل برنامه‌ریزی خطی و برنامه‌ریزی عدد صحیح مختلط (*.mps)
GNU Oleo ⟨URL: http://en.wikipedia.org/wiki/GNU_Oleo ⟩ (*.oleo)
قالب PlanPerfect (PLN)
‏Psion (*.psisheet)
‏SC/xspread
xBase ⟨URL: http://en.wikipedia.org/wiki/XBase ⟩ قالب فایل (*.dbf)

‏ODF/OpenOffice به همراه عناصر خارجی (*.ods)
حل‌کننده برنامه‌ریزی خطی GLPK
‏HTML 4.0 (*.html)
قطعه‌کد HTML (*.html)
‏XHTML (*.html)
محدوده XHTML - برای صدور به کلیپ‌بورد
قالب سند قابل‌حمل Portable Document Format (*.PDF)
مقادیر جداشده با کاما (CSV)
مایکروسافت اکسل Microsoft Excel (tm) 97/2000/XP & 5.0/95

مایکروسافت اکسل Microsoft Excel (tm) 5.0/95
مایکروسافت اکسل Microsoft S Excel (tm) 97/2000/XP
قالب فایل PO واژه‌نامه گنوم (Gnome Glossary)
‏HTML 3.2 (*.html)
‏LaTeX 2e (*.tex)
قطعه‌کد جدول LaTeX 2e (*.tex)
قالب TROFF ⟨URL: http://en.wikipedia.org/wiki/Troff ⟩ (*.me).
LPSolve ⟨URL: http://sourceforge.net/projects/lpsolve ⟩ حل‌کننده برنامه‌ریزی خطی عدد صحیح مختلط (MILP)

نام برگه کارپوشه برای انجام عملیات. می‌توانید با تکرار این گزینه چندین برگه را مشخص کنید. اگر گزینه object تعیین شده باشد، این گزینه نادیده گرفته می‌شود.
انتخاب برگه فعال برای انجام عملیات. مقدار این گزینه اهمیتی ندارد، اما درج علامت مساوی الزامی است.
نام شیء برگه برای چاپ. در صورت مشخص شدن این گزینه، هرگونه گزینه sheet نادیده گرفته می‌شود. تنها نخستین object مشخص‌شده صادر می‌شود.
اندازه کاغذ. مقادیر معتبر شامل "A4" برای ISO A4 و "na_letter_8.5x11in" برای US Letter است. اگر یک نمودار مشخص از طریق گزینه object تعیین شده باشد، آن‌گاه اندازه کاغذ "fit" اندازه کاغذ را به اندازه همان نمودار کاهش می‌دهد.
نام برگه‌ای از کارپوشه که عملیات روی آن انجام می‌شود. با تکرار این گزینه می‌توانید چندین برگه را مشخص کنید.
انتخاب برگهٔ فعال برای انجام عملیات. مقدار این گزینه اهمیتی ندارد، اما درج علامت مساوی الزامی است.
قاعدهٔ پایان خط (End Of Line)؛ نحوهٔ خاتمه یافتن خطوط. "unix" برای linefeed (تعویض سطر)، "mac" برای carriage return (بازگشت مکان‌نما)؛ "windows" برای carriage return به‌همراه linefeed.
کدگذاری نویسه‌های خروجی. پیش‌فرض UTF-8 است.
لوکال (locale) مورد استفاده برای قالب‌بندی اعداد و تاریخ‌ها. پیش‌فرض، لوکال فعلی سیستم است که توسط locale(1) گزارش می‌شود. برای مشاهدهٔ مقادیر مجاز، خروجی locale -a را بررسی کنید.
نویسه یا رشته‌ای که برای محصور کردن فیلدها در نقل‌قول استفاده می‌شود. پیش‌فرض "\"" (علامت نقل‌قول / گیومه جفتی) است.
رشته‌ای که برای جداسازی فیلدها استفاده می‌شود. پیش‌فرض نویسهٔ فاصله است.
نحوهٔ قالب‌بندی سلول‌ها. مقادیر مجاز: "automatic" (اعمال قالب‌بندی خودکار؛ پیش‌فرض)، "raw" (خروجی‌دادن داده‌ها به‌صورت خام، بدون قالب‌بندی)، یا "preserve" (حفظ قالب‌بندی سند منبع).

این گزینه به تفاوت میان محتوای سلول و نحوهٔ قالب‌بندی آن محتوا مربوط می‌شود.

سلولی را در یک سند ورودی Gnumeric در نظر بگیرید که در یک لوکال آمریکایی (US) به‌صورت "4/19/73" وارد شده، قالب آن روی "d-mmm-yyyy" تنظیم شده و بنابراین به‌صورت "19-Apr-1973" قالب‌بندی شده است.

با مقدار پیش‌فرض format یعنی "automatic"، خروجی به‌صورت "1973/04/19" خواهد بود. با "preserve"، قالب‌بندی حفظ شده و خروجی به‌صورت "19-Apr-1973" خواهد بود. با "raw"، خروجی به‌صورت "26773" (نمایش داخلی Gnumeric: تعداد روزها از زمان مبدأ یا epoch) خواهد بود.

نحوهٔ مدیریت نویسه‌های غیرقابل‌نمایش؛ یعنی نویسه‌هایی که نمی‌توان آن‌ها را در مجموعه نویسه‌های انتخابی خروجی بازنمایی کرد. مقادیر مجاز: "transliterate"، یا "escape". حالت نخست نویسه‌هایی را که نمی‌توان در مجموعه نویسه‌های خروجی نمایش داد، با تقریب زدن به یک یا چند نویسهٔ مجاز بازنویسی می‌کند. برای جزئیات بیشتر به iconv(1) مراجعه کنید. پیش‌فرض "escape" است که نویسهٔ غیرقابل‌نمایش را با یک توالی گریز (escape sequence) جایگزین می‌کند که نقطهٔ کد یونیکد را مشخص می‌سازد.
چه زمانی داده‌ها باید در نقل‌قول قرار گیرند؟ "never"، "auto" (در صورت نیاز علامت نقل‌قول قرار می‌دهد)، یا "always". پیش‌فرض "auto" است.
مشخص می‌کند که آیا وجود نویسهٔ فاصله در ابتدا یا انتهای مقدار، نقل‌قول را الزامی می‌کند یا خیر. پیش‌فرض TRUE است.

برای تبدیل فایل Gnumeric با نام foo.gnumeric به یک فایل با قالب Microsoft Excel(TM) با نام foo.xls:

ssconvert foo.gnumeric foo.xls

قالب صدور را می‌توان به‌صورت صریح مشخص کرد تا جایگزین مقدار پیش‌فرض (که بر اساس پسوند فایل تعیین می‌شود) شود:

ssconvert --export-type=Gnumeric_stf:stf_csv foo.xls foo.txt

برای تبدیل فایل قالب اکسل statfuns.xls به یک فایل متنی، با تعیین نقطه ویرگول به‌عنوان نویسهٔ جداکننده:

ssconvert -O 'separator=; format=raw' samples/excel/statfuns.xls statfuns.txt

برای صادر کردن نمودارها از فایل ورودی input.gnumeric به فایل‌های شماره‌گذاری‌شدهٔ SVG:

ssconvert --export-graphs input.gnumeric 'output.%n.svg'

برای صادر کردن نمودارها از فایل ورودی input.gnumeric به فایل‌های شماره‌گذاری‌شدهٔ PNG:

ssconvert --export-type=png --export-graphs input.gnumeric 'output.%n.png'

ssconvert تحت شرایط پروانه عمومی همگانی گنو (GPL)، نسخه ۲ یا ۳ منتشر شده است. برای دریافت اطلاعات پیرامون این پروانه، به کد منبع همراه نرم‌افزار نگاهی بیندازید یا مراجعه کنید به صفحه پروژه GNU ⟨URL: http://www.gnu.org ⟩.

حق تکثیر نرم‌افزار و کد منبع Gnumeric همان‌طور که در کد منبع مستند شده است، در اختیار تک‌تک نویسندگان آن قرار دارد.

نویسنده اصلی ssconvert Jody Goldberg <jody@gnome.org> است؛ ssconvert بر پایه پایگاه کد Gnumeric ساخته شده است.

نسخه اولیه این صفحه راهنما توسط J.H.M. Dassen (Ray) <jdassen@debian.org> نوشته شده است.

gnumeric(1), ssdiff(1), ssgrep(1), ssindex(1)

صفحه اصلی Gnumeric ⟨URL: http://www.gnome.org/projects/gnumeric ⟩.

صفحه پروژه GNOME ⟨URL: http://www.gnome.org ⟩.

2020-04-19 gnumeric