.TH EXTRACT 1 "Aug 7, 2012" "libextractor 1.0.0"
.\" $Id
.SH "نام (NAME)"
extract \- استخراج فراداده (میتادیتا) از فایل‌های مختلف با libextractor
.SH "خلاصه دستور (SYNOPSIS)"
.B extract
[
.B \-bgihLmnvV
]
[
.B \-l
.I library
]
[
.B \-p
.I type
]
[
.B \-x
.I type
]
.I file
\&...
.br
.SH "توضیحات (DESCRIPTION)"
این صفحه راهنما نسخه 1.0.0 از دستور
.B extract
را مستند می‌کند.
.PP
دستور
.B extract
هر فایل مشخص‌شده در فهرست آرگومان‌ها را بررسی می‌کند تا اطلاعات فراداده (متا) را از آن استخراج کند. هر فایل به کتابخانه‌های استخراج فراداده از
.I libextractor
ارائه می‌شود.
.PP
کتابخانه libextractor فراداده‌ها (که با عنوان کلمات کلیدی نیز شناخته می‌شوند) را به انواع مختلف دسته‌بندی می‌کند. فهرست کاملی از تمام انواع را می‌توان با گزینه
.B \-L
به دست آورد.

.SH "گزینه‌ها (OPTIONS)"
.TP 8
.B \-b
نمایش خروجی در قالب BiBTeX.
.TP 8
.B \-g
استفاده از خروجی مناسب grep (قرار دادن تمام کلمات کلیدی هر فایل در یک خط واحد). از گزینه پرگویی (verbose) برای چاپ ابتدا نام فایل و سپس کلمات کلیدی استفاده کنید. با دوبار تعیین گزینه پرگویی، نوع کلمات کلیدی نیز نمایش داده می‌شود. این گزینه نوع کلمات کلیدی یا فراداده‌های غیرمتنی را چاپ نمی‌کند.
.TP 8
.B \-h
چاپ خلاصه کوتاهی از گزینه‌ها.
.TP 8
.B \-i
اجرای افزونه‌ها در فرآیند اصلی (درون-پردازشی / in-process) جهت اشکال‌زدایی. به‌طور پیش‌فرض، هر افزونه در پردازه مجزای خود اجرا می‌شود.
.TP 8
.BI \-l " libraries"
استفاده از کتابخانه‌های مشخص‌شده برای استخراج کلمات کلیدی. قالب کلی کتابخانه‌ها به‌صورت
.I [[\-]LIBRARYNAME[:[\-]LIBRARYNAME]*]
است که در آن LIBRARYNAME یک کتابخانه سازگار با libextractor و معمولاً به‌فرم
.I jpeg
می‌باشد. علامت منفی قبل از نام کتابخانه نشان می‌دهد که این کتابخانه باید از فهرست موجود حذف شود. برای اجرای تنها چند افزونه منتخب، از
.B \-l
در ترکیب با
.B \-n
استفاده کنید.
.TP 8
.B \-L
چاپ فهرست تمام انواع شناخته‌شده کلمات کلیدی.
.TP 8
.B \-m
بارگذاری فایل در حافظه و انجام استخراج از حافظه (برای اشکال‌زدایی).
.TP 8
.B \-n
عدم استفاده از مجموعه پیش‌فرض استخراج‌کننده‌ها (معمولاً همه استخراج‌کننده‌های استاندارد، در حال حاضر mp3، ogg، jpg، gif، png، tiff، real، html، pdf و mime-types) و استفاده تنها از استخراج‌کننده‌های تعیین‌شده با گزینه
.BR \-l .
.TP
.BI \-p " type"
چاپ تنها کلمات کلیدی منطبق بر نوع مشخص‌شده. به‌طور پیش‌فرض، تمام کلمات کلیدی یافت‌شده که تکراری نیستند چاپ می‌شوند.
.TP 8
.B \-v
چاپ شماره نسخه و خروج.
.TP 8
.B \-V
حالت پرگو (verbose). این گزینه می‌تواند چندین بار برای افزایش بیشتر جزئیات مشخص شود.
.TP 8
.BI \-x " type"
مستثنی کردن کلمات کلیدی از نوع مشخص‌شده از خروجی. به‌طور پیش‌فرض، تمام کلمات کلیدی یافت‌شده که تکراری نیستند چاپ می‌شوند.
.SH "همچنین ببینید (SEE ALSO)"
.BR libextractor (3)
\- توضیحات کتابخانه libextractor
.br
.SH "مثال‌ها (EXAMPLES)"
.nf
$ extract test/test.jpg
comment \- (C) 2001 by Christian Grothoff, using gimp 1.2 1
mimetype \- image/jpeg

$ extract \-V \-x comment test/test.jpg
Keywords for file test/test.jpg:
mimetype \- image/jpeg

$ extract \-p comment test/test.jpg
comment \- (C) 2001 by Christian Grothoff, using gimp 1.2 1

$ extract \-nV \-l png.so \-p comment test/test.jpg test/test.png
Keywords for file test/test.jpg:
Keywords for file test/test.png:
comment \- Testing keyword extraction
.fi

.SH "ملاحظات قانونی (LEGAL NOTICE)"
ابزار extract و کتابخانه libextractor تحت مجوز GPL منتشر شده‌اند. libextractor یکی از بسته‌های GNU است.

.SH "اشکالات (BUGS)"
تعدادی از قالب‌های فایل (در حدود ۱۰ به توان ۳) هنوز شناسایی نمی‌شوند...

.SH "نویسندگان (AUTHORS)"
دستور
.B extract
در ابتدا توسط Christian Grothoff <christian@grothoff.org> و Vidyut Samanta <vids@cs.ucla.edu> نوشته شده است. برای تماس با نگهدارنده(های) فعلی از <libextractor@gnu.org> استفاده کنید.

.SH "دسترسی (AVAILABILITY)"
می‌توانید آخرین نسخه ارائه‌شده توسط نویسنده اصلی را از نشانی http://www.gnu.org/software/libextractor دریافت کنید.