'\" t .\" Title: clevercsv-detect .\" Author: G.J.J. van den Burg .\" Generator: Wilderness .\" Date: 2026-05-11 .\" Manual: Clevercsv Manual .\" Source: clevercsv 0.8.5 .\" Language: Persian .\" .TH "CLEVERCSV-DETECT" "1" "2026\-05\-11" "Clevercsv 0\&.8\&.5" "راهنمای Clevercsv" .\" ----------------------------------------------------------------- .\" * 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 .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "نام (NAME)" clevercsv-detect \- تشخیص خودکار گویش و جداکننده‌های فایل‌های CSV .SH "خلاصه دستور (SYNOPSIS)" .sp .nf \fIclevercsv detect [\-c | \-\-consistency] [\-e کدگذاری | \-\-encoding=کدگذاری] [\-n تعداد_نویسه‌ها | \-\-num\-chars=تعداد_نویسه‌ها] [ \-p | \-\-plain | \-j | \-\-json ] [\-\-no\-skip] [\-\-add\-runtime] <مسیر>\fR .fi .sp .SH "توضیحات (DESCRIPTION)" .sp تشخیص خودکار گویش (جداکننده، نویسه نقل‌قول و نویسه گریز) در فایل‌های CSV. .SH "گزینه‌ها (OPTIONS)" .sp .PP \-h, \-\-help .RS 4 نمایش این پیام راهنما و خروج. .RE .PP \-c, \-\-consistency .RS 4 به‌طور پیش‌فرض، گویش فایل‌های CSV با استفاده از یک فرآیند دومرحله‌ای تشخیص داده می‌شود. ابتدا، مجموعه‌ای از بررسی‌های سخت‌گیرانه برای ارزیابی مطابقت فایل با یک قالب بسیار پایه‌ای انجام می‌گیرد (برای نمونه، زمانی که تمام خانه‌های جدول در فایل از نوع عدد صحیح هستند). اگر هیچ‌یک از این بررسی‌ها موفقیت‌آمیز نباشد، از معیار سازگاری داده‌های ون دن برگ و همکاران (2019) برای تشخیص گویش استفاده می‌شود. با استفاده از این گزینه، می‌توانید فرآیند تشخیص را وادار کنید که همواره از معیار سازگاری داده‌ها استفاده کند. این قابلیت می‌تواند برای اهداف آزمایشی یا پژوهشی مفید باشد. .RE .PP \-e, \-\-encoding .RS 4 کدگذاری فایل CSV داده‌شده به‌طور خودکار با استفاده از chardet تشخیص داده می‌شود. اگرچه chardet دقت بسیار بالایی دارد، اما بی‌نقص نیست. در موارد نادری که در تشخیص کدگذاری فایل اشتباه رخ می‌دهد، می‌توانید با تعیین کدگذاری از طریق این گزینه، آن را بازنویسی کنید. علاوه بر این، هنگامی که چندین فایل CSV با کدگذاری مشخص دارید، می‌توانید با استفاده از این گزینه سرعت فرآیند تولید کد را افزایش دهید. .RE .PP \-n, \-\-num\-chars .RS 4 در فایل‌های بزرگ CSV، گاهی ممکن است به دلیل تعداد بالای گویش‌های محتمل، تشخیص گویش کمی کند باشد. برای رفع این مشکل، می‌توانید تعداد نویسه‌های مورد استفاده برای تشخیص را محدود کنید. .sp نکته‌ای که باید در نظر داشت این است که ممکن است CleverCSV برای استنباط صحیح گویش به خواندن تعداد مشخصی از نویسه‌ها نیاز داشته باشد. برای نمونه، در فایل ``imdb.csv`` در مخزن گیت‌هاب، گویش صحیح تنها پس از خواندن حداقل ۶۶ خط از فایل قابل تشخیص است. بنابراین، اگر امکان اجرای CleverCSV روی کل فایل وجود دارد، انجام این کار به‌طور کلی توصیه می‌شود. .RE .PP \-p, \-\-plain .RS 4 چاپ اجزای گویش در خطوط جداگانه. .RE .PP \-j, \-\-json .RS 4 چاپ گویش در خروجی استاندارد در قالب یک شیء JSON. این شیء همواره کلیدهای \*(Aqdelimiter\*(Aq، \*(Aqquotechar\*(Aq، \*(Aqescapechar\*(Aq و \*(Aqstrict\*(Aq را خواهد داشت. در صورت مشخص شدن \-\-add\-runtime، کلید \*(Aqruntime\*(Aq نیز اضافه خواهد شد. .RE .PP \-\-no\-skip .RS 4 امتیاز سازگاری داده‌ها که برای تشخیص گویش استفاده می‌شود شامل دو مؤلفه است: امتیاز الگو (pattern score) و امتیاز نوع (type score). امتیاز نوع بین ۰ و ۱ قرار دارد. هنگام محاسبه معیارهای سازگاری داده‌ها برای گویش‌های مختلف، اگر متوجه شویم که امتیاز الگو کمتر از بهترین امتیاز سازگاری داده‌های مشاهده‌شده تا آن لحظه است، از محاسبه امتیاز نوع صرف‌نظر می‌کنیم. با استفاده از این گزینه می‌توان این رفتار را غیرفعال کرد و امتیاز نوع را برای تمام گویش‌ها محاسبه نمود. این قابلیت بیشتر برای مقاصد اشکال‌زدایی و آزمایش مفید است. .RE .PP \-\-add\-runtime .RS 4 افزودن زمان اجرای فرآیند تشخیص به خروجی. .RE .PP <مسیر> .RS 4 مسیر فایل CSV. .RE .PP .sp .SH "CLEVERCSV" .sp بخشی از مجموعه‌ابزار CleverCSV.