نام (NAME)

ctan-o-mat - اعتبارسنجی و آپلود بسته‌های TeX به شبکه جامع آرشیو TeX (CTAN)

خلاصه دستور (SYNOPSIS)

ctan-o-mat [گزینه‌ها] [<پیکربندی بسته>]

توضیحات (DESCRIPTION)

این برنامه می‌تواند برای خودکارسازی فرآیند آپلود یک بسته در شبکه جامع آرشیو TeX (Comprehensive TeX Archive Network - https://www.ctan.org) استفاده شود. توضیحات بسته از یک فایل پیکربندی خوانده می‌شود؛ بنابراین می‌توان آن را به سادگی و بدون نیاز به پر کردن مکرر یک فرم وب با همان اطلاعات قدیمی به‌روزرسانی کرد.

اطلاعات ارائه‌شده در هر صورت اعتبارسنجی می‌شوند. اگر اعتبارسنجی موفقیت‌آمیز باشد و فقط درخواست اعتبارسنجی نشده باشد، فایل آرشیو ارائه‌شده برای پردازش بیشتر توسط تیم CTAN در بخش ورودی (incoming) قرار می‌گیرد.

در هر حالت، هرگونه نتیجه و یافته در طول اعتبارسنجی در پایان پردازش گزارش می‌شود. توجه داشته باشید که اعتبارسنجی حالت پیش‌فرض است و برای ثبت و ارسال رسمی باید از گزینه خط فرمان مناسب استفاده شود.

برنامه ctan-o-mat نیازمند اتصال اینترنت به سرور CTAN است. حتی فرآیند اعتبارسنجی نیز ویژگی‌های شناخته‌شده و محدودیت‌های اولیه را از سرور دریافت می‌کند.

پیکربندی (CONFIGURATION)

پیکربندی پیش‌فرض از فایلی با نام مشابه پوشه جاری و پسوند ".pkg" خوانده می‌شود. این نام فایل را می‌توان از طریق خط فرمان تغییر داد.

پیکربندی به ویژگی‌هایی بستگی دارد که در حال حاضر توسط سرور CTAN پشتیبانی می‌شوند. از آنجا که این ویژگی‌ها ممکن است در طول زمان تغییر کنند، پیکربندی به صورت سخت‌کد در ctan-o-mat قرار نگرفته است. می‌توانید یک الگوی خالی از پیکربندی را با پارامتر خط فرمان "--init" درخواست کنید.

گزینه‌ها (OPTIONS)

-h
--help: نمایش این خلاصه کوتاه از نحوه استفاده و خروج از برنامه.
-i
--init: ایجاد یک الگوی خالی برای پیکربندی.
--list licenses: فهرست کردن مجوزهای شناخته‌شده CTAN در جریان خروجی استاندارد. هر مجوز به صورت یک خط نمایش داده می‌شود. این خط شامل فیلدهای کلید، نام و نشانگر رایگان بودن (free indicator) است. این فیلدها با نویسه تب (Tab) از یکدیگر جدا شده‌اند. پس از آن، برنامه بدون پردازش آرگومان‌های دیگر پایان می‌یابد.
--config <package configuration>
--pkg <package configuration>
--package <package configuration>: تنظیم فایل پیکربندی بسته.
-s
--submit: آپلود بسته ارسالی، اعتبارسنجی آن و ثبت رسمی در CTAN در صورت موفقیت‌آمیز بودن اعتبارسنجی.
-v
--verbose: چاپ اطلاعات بیشتر در طول پردازش (حالت پرگو / verbose).
--version: نمایش شماره نسخه برنامه و خروج.
--validate
-n
--noaction: عدم انجام آپلود نهایی. بسته اعتبارسنجی شده و پیام‌های حاصل چاپ می‌شوند.
<package>: این پارامتر نام یک پیکربندی بسته است که در یک فایل قرار دارد (بخش CONFIGURATION را ببینید). در صورت مشخص نشدن، نام پیکربندی بسته به صورت پیش‌فرض برابر با نام پوشه جاری به همراه ".pkg" خواهد بود.

محیط (ENVIRONMENT)

متغیرهای محیطی زیر توسط ctan-o-mat شناسایی می‌شوند.

CTAN_O_MAT_URL: مقدار این متغیر پیشوند URL برای سرور CTAN است که باید با آن ارتباط برقرار شود. مقدار پیش‌فرض "https://ctan.org/submit" است. نشانی اینترنتی کامل با الحاق "validate"، "upload" یا "fields" برای استفاده از CTAN REST API مربوطه ساخته می‌شود.

اتصال از طریق پروکسی (CONNECTING VIA PROXIES)

اگر نیاز به اتصال به اینترنت از طریق پروکسی دارید، این کار با تنظیم برخی متغیرهای محیطی قبل از اجرای ctan-o-mat امکان‌پذیر است. برای هدایت درخواست از طریق پروکسی، کافی است متغیر محیطی "http_proxy" را تعریف کنید تا به هاست پروکسی اشاره کند -- شامل پروتکل و پورت در صورت نیاز. توجه داشته باشید که نام این متغیر محیطی باید با حروف کوچک (lower case) باشد.

نویسنده (AUTHOR)

Gerd Neugebauer (gene@gerd-neugebauer.de)

اشکالات (BUGS)

•: این برنامه بدون اتصال فعال به اینترنت قابل استفاده نیست.