.\" Man page generated from reStructuredText.
.
.TH GRAMPS 1 "" "" "6.0.8"
.SH "نام (NAME)"
gramps \- سامانه برنامه‌نویسی مدیریت، تحلیل و پژوهش تبارشناسی.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBgramps\fP
[\fB\-?\fP | \fB\-\-help\fP]
[\fB\-\-usage\fP]
[\fB\-\-version\fP]
[\fB\-l\fP]
[\fB\-L\fP]
[\fB\-u\fP | \fB\-\-force\-unlock\fP]
[\fB\-O\fP | \fB\-\-open\fP=\fIDATABASE\fP [\fB\-f\fP | \fB\-\-format\fP=\fIFORMAT\fP]]
[\fB\-i\fP | \fB\-\-import\fP=\fIFILE\fP [\fB\-f\fP | \fB\-\-format\fP=\fIFORMAT\fP]]
[\fB\-\-remove\fP=\fIFAMILY_TREE_PATTERN\fP]
[\fB\-e\fP | \fB\-\-export\fP=\fIFILE\fP [\fB\-f\fP | \fB\-\-format\fP=\fIFORMAT\fP]]
[\fB\-a\fP | \fB\-\-action\fP=\fIACTION\fP]
[\fB\-p\fP | \fB\-\-options\fP=\fIOPTION\-STRING\fP]]
[\fIFILE\fP]
[\fB\-\-version\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
نرم‌افزار Gramps یک برنامه تبارشناسی آزاد و متن‌باز است.
این برنامه به زبان Python و با استفاده از رابط GTK+/GNOME نوشته شده است.
کار با Gramps برای هر کسی که پیش از این از سایر برنامه‌های تبارشناسی مانند ™Family Tree Maker،
‏™Personal Ancestral Files یا GNU Geneweb استفاده کرده باشد، آشنا خواهد بود.
این برنامه از وارد کردن (import) قالب بسیار پرطرفدار GEDCOM که تقریباً در تمامی نرم‌افزارهای تبارشناسی در سرتاسر جهان استفاده می‌شود، پشتیبانی می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \fBgramps\fP \fIFILE\fP
هنگامی که \fIFILE\fP (بدون هیچ گزینه‌ای) به عنوان نام شجره‌نامه یا دایرکتوری پایگاه داده شجره‌نامه داده شود، باز شده و یک نشست تعاملی آغاز می‌شود.
اگر \fIFILE\fP یک قالب فایل قابل فهم برای Gramps باشد، یک شجره‌نامه خالی بر اساس نام \fIFILE\fP ایجاد شده و داده‌ها درون آن وارد می‌شوند.
هر گزینه دیگری نادیده گرفته خواهد شد.
این روش اجرا برای به‌کارگیری gramps به عنوان گرداننده داده‌های تبارشناسی در مواردی مانند مرورگرهای وب مناسب است.
این شیوه فراخوانی می‌تواند هر قالب داده بومی gramps را بپذیرد؛ به زیر نگاه کنید.
.TP
.B \fB\-f\fP, \fB\-\-format\fP=\fIFORMAT\fP
به‌طور صریح قالب \fIFILE\fP داده‌شده با گزینه‌های پیشین \fB\-i\fP یا \fB\-e\fP را تعیین می‌کند.
اگر گزینه \fB\-f\fP برای یک \fIFILE\fP داده نشود، قالب آن فایل بر اساس پسوند یا نوع MIME حدس زده می‌شود.
.sp
قالب‌های موجود برای صدور (export) عبارتند از: \fBgramps\-xml\fP (اگر \fIFILE\fP به \fI\&.gramps\fP ختم شود حدس زده می‌شود)، \fBgedcom\fP (اگر \fIFILE\fP به \fI\&.ged\fP ختم شود حدس زده می‌شود)، یا هر فایل خروجی قابل دسترسی از طریق سامانه افزونه‌های Gramps.
.sp
قالب‌های موجود برای وارد کردن (import) عبارتند از: \fBgramps\-xml\fP، \fBgedcom\fP، \fBgramps\-pkg\fP (اگر \fIFILE\fP به \fI\&.gpkg\fP ختم شود حدس زده می‌شود) و \fBgeneweb\fP (اگر \fIFILE\fP به \fI\&.gw\fP ختم شود حدس زده می‌شود).
.sp
قالب‌های موجود برای صدور عبارتند از: \fBgramps\-xml\fP، \fBgedcom\fP،
\fBgramps\-pkg\fP، \fBwft\fP (اگر \fIFILE\fP به \fI\&.wft\fP ختم شود حدس زده می‌شود)،
\fBgeneweb\fP\&.
.TP
.B \fB\-l\fP
چاپ فهرستی از شجره‌نامه‌های شناخته‌شده.
.TP
.B \fB\-L\fP
چاپ فهرستی با جزئیات کامل از شجره‌نامه‌های شناخته‌شده.
.TP
.B \fB\-u\fP, \fB\-\-force\-unlock\fP
باز کردن قفل یک پایگاه داده قفل‌شده.
.TP
.B \fB\-O\fP, \fB\-\-open\fP=\fIDATABASE\fP
باز کردن \fIDATABASE\fP که باید یک دایرکتوری پایگاه داده موجود یا نام یک شجره‌نامه موجود باشد.
اگر هیچ گزینه عملیات، وارد کردن یا صدوری در خط فرمان داده نشود، یک نشست تعاملی با استفاده از آن پایگاه داده آغاز می‌شود.
.TP
.B \fB\-i\fP, \fB\-\-import\fP=\fIFILE\fP
وارد کردن داده‌ها از \fIFILE\fP\&.
اگر هیچ پایگاه داده‌ای مشخص نشده باشد، یک پایگاه داده خالی با نام Family Tree \fIx\fP (که در آن \fIx\fP یک شماره افزایشی است) ایجاد می‌شود.
.sp
هنگامی که بیش از یک فایل ورودی داده شود، پیش از هرکدام باید پرچم \fB\-i\fP قرار گیرد.
فایل‌ها به همان ترتیب مشخص‌شده وارد می‌شوند؛ برای نمونه،
\fB\-i\fP \fIFILE1\fP \fB\-i\fP \fIFILE2\fP
و
\fB\-i\fP \fIFILE2\fP \fB\-i\fP \fIFILE1\fP
ممکن است شناسه‌های (IDهای) gramps متفاوتی در پایگاه داده حاصل ایجاد کنند.
.TP
.B \fB\-e\fP, \fB\-\-export\fP=\fIFILE\fP
صدور داده‌ها به \fIFILE\fP\&.
برای \fBgramps\-xml\fP، \fBgedcom\fP، \fBwft\fP، \fBgramps\-pkg\fP و \fBgeneweb\fP،
مقدار \fIFILE\fP نام فایل حاصل خواهد بود.
.sp
هنگامی که بیش از یک فایل خروجی داده شود، پیش از هرکدام باید پرچم \fB\-e\fP قرار گیرد.
فایل‌ها یکی پس از دیگری و با ترتیب مشخص‌شده نوشته می‌شوند.
.TP
.B \fB\-a\fP, \fB\-\-action\fP=\fIACTION\fP
انجام \fIACTION\fP روی داده‌های واردشده.
این کار پس از تکمیل موفقیت‌آمیز تمام واردسازی‌ها انجام می‌شود.
عملیات‌های در دسترس کنونی عبارتند از \fBsummary\fP (مشابه Reports→View→Summary)، \fBcheck\fP (مشابه Tools→Database Processing→Check and Repair)، \fBreport\fP (تولید گزارش)، و \fBtool\fP (اجرای یک ابزار افزونه).
هر دو مورد \fBreport\fP و \fBtool\fP به \fIOPTION\-STRING\fP ارائه‌شده با پرچم \fB\-p\fP نیاز دارند.
.sp
مقدار \fIOPTION\-STRING\fP باید شرایط زیر را برآورده کند:
.INDENT 7.0
.IP \(bu 2
نباید شامل هیچ فاصله‌ای باشد.
.IP \(bu 2
اگر برخی آرگومان‌ها نیاز به فاصله داشته باشند، طبق قواعد شل باید کل رشته در علامت نقل‌قول قرار گیرد.
.IP \(bu 2
رشته گزینه‌ها فهرستی از جفت‌های نام و مقدار است (که با علامت مساوی از یکدیگر جدا می‌شوند).
.IP \(bu 2
جفت‌های نام و مقدار باید با ویرگول (کاما) از یکدیگر جدا شوند.
.UNINDENT
.sp
بیشتر گزینه‌های گزارش‌ها یا ابزارها مختص هر گزارش یا ابزار مشخص هستند.
با این وجود، برخی گزینه‌های مشترک نیز وجود دارد.
.INDENT 7.0
.TP
.B \fBname\fP=\fIname\fP
این گزینه اجباری مشخص می‌کند که کدام گزارش یا ابزار اجرا خواهد شد.
اگر \fIname\fP داده‌شده با هیچ گزارش یا ابزار موجودی همخوانی نداشته باشد، یک پیام خطا چاپ شده و پس از آن فهرستی از گزارش‌ها یا ابزارهای موجود (بسته به \fIACTION\fP) نمایش می‌یابد.
.TP
.B \fBshow\fP=\fBall\fP
فهرستی از نام تمام گزینه‌های موجود برای یک گزارش یا ابزار خاص را ارائه می‌دهد.
.TP
.B \fBshow\fP=\fIoptionname\fP
توضیحات عملکرد ارائه‌شده توسط \fIoptionname\fP و همچنین انواع و مقادیر قابل‌قبول برای این گزینه را چاپ می‌کند.
.UNINDENT
.sp
از گزینه‌های بالا برای آگاهی از همه موارد مربوط به یک گزارش مشخص استفاده کنید.
.sp
هنگامی که بیش از یک عمل خروجی داده شود، پیش از هرکدام باید پرچم \fB\-a\fP قرار گیرد.
این عملیات‌ها یکی پس از دیگری و با ترتیب مشخص‌شده انجام می‌شوند.
.TP
.B \fB\-d\fP, \fB\-\-debug\fP=\fILOGGER_NAME\fP
فعال‌سازی لاگ‌های اشکال‌زدایی (debug) برای توسعه و آزمایش.
برای جزئیات بیشتر به کد منبع مراجعه کنید..TP
.B \fB\-\-version\fP
چاپ شماره نسخه gramps و سپس خروج.
.UNINDENT
.SH "عملکرد (OPERATION)"
.sp
اگر نخستین آرگومان در خط فرمان با خط تیره شروع نشود (یعنی هیچ پرچمی نباشد)، gramps تلاش خواهد کرد تا فایلی با نام مشخص‌شده توسط نخستین آرگومان را باز کند و یک نشست تعاملی را آغاز نماید و باقی آرگومان‌های خط فرمان را نادیده بگیرد.
.sp
اگر پرچم \fB\-O\fP داده شود، آن‌گاه gramps سعی می‌کند پایگاه‌داده ارائه‌شده را باز کرده و سپس طبق دستورالعمل پارامترهای بعدی خط فرمان، با آن داده‌ها کار کند.
.sp
با پرچم \fB\-O\fP یا بدون آن، وارد کردن‌ها، صادر کردن‌ها و کنش‌های بعدی را می‌توان با استفاده از پرچم‌های \fB\-i\fP، \fB\-e\fP و \fB\-a\fP در خط فرمان مشخص کرد.
.sp
ترتیب گزینه‌های \fB\-i\fP، \fB\-e\fP یا \fB\-a\fP اهمیتی ندارد.
ترتیب واقعی پردازش آن‌ها همواره به این صورت است:
همه وارد کردن‌ها (در صورت وجود) → همه کنش‌ها (در صورت وجود) → همه صادر کردن‌ها (در صورت وجود).
اما باز کردن همیشه باید در ابتدا باشد!
.sp
اگر هیچ گزینه \fB\-O\fP یا \fB\-i\fP داده نشود،
gramps پنجره اصلی خود را باز کرده و نشست تعاملی معمول را با یک پایگاه‌داده خالی آغاز می‌کند، چرا که در هر صورت داده‌ای برای پردازش وجود ندارد.
.sp
اگر هیچ گزینه \fB\-e\fP یا \fB\-a\fP داده نشود،
gramps پنجره اصلی خود را باز کرده و نشست تعاملی معمول را با پایگاه‌داده حاصل از همه وارد کردن‌ها آغاز می‌کند.
این پایگاه‌داده در فایل \fIimport_db.grdb\fP در دایرکتوری \fI~/.gramps/import\fP قرار دارد.
.sp
هرگونه خطای رخ‌داده در حین وارد کردن، صادر کردن یا کنش،
یا در \fIstdout\fP (اگر استثناهایی باشند که توسط gramps مدیریت می‌شوند)
یا در \fIstderr\fP (اگر مدیریت‌نشده باشند) ارسال خواهد شد.
برای ذخیره پیام‌ها و خطاها در فایل‌ها از تغییرمسیرهای معمول پوسته برای \fIstdout\fP و \fIstderr\fP استفاده کنید.
.SH "مثال‌ها (EXAMPLES)"
.sp
برای باز کردن یک شجره‌نامه موجود و وارد کردن یک فایل xml به آن، می‌توان این دستور را وارد کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
gramps \-O \(aqMy Family Tree\(aq \-i ~/db3.gramps
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
دستور بالا شجره‌نامه بازشده را تغییر می‌دهد. برای انجام همین کار، اما با وارد کردن هر دو در یک شجره‌نامه موقت و شروع یک نشست تعاملی، می‌توان نوشت:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
gramps \-i \(aqMy Family Tree\(aq \-i ~/db3.gramps
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
برای وارد کردن چهار پایگاه‌داده (که قالب آن‌ها از روی نامشان قابل تشخیص است) و سپس بررسی پایگاه‌داده حاصل برای یافتن خطاها، می‌توان نوشت:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
gramps \-i file1.ged \-i file2.tgz \-i ~/db3.gramps \-i file4.wft \-a check
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
برای مشخص کردن صریح قالب‌ها در مثال بالا، گزینه‌های مناسب \fB\-f\fP را به انتهای نام فایل‌ها اضافه کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
gramps \-i file1.ged \-f gedcom \-i file2.tgz \-f gramps\-pkg \e
\-i ~/db3.gramps \-f gramps\-xml \-i file4.wft \-f wft \-a check
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
برای ذخیره پایگاه‌داده حاصل از همه وارد کردن‌ها، یک پرچم \fB\-e\fP را مشخص کنید (اگر نام فایل به gramps اجازه حدس زدن قالب را نمی‌دهد از \fB\-f\fP استفاده کنید):
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
gramps \-i file1.ged \-i file2.tgz \-e ~/new\-package \-f gramps\-pkg
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
برای وارد کردن سه پایگاه‌داده و آغاز یک نشست تعاملی gramps با نتیجه حاصل:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
gramps \-i file1.ged \-i file2.tgz \-i ~/db3.gramps
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
برای اجرای ابزار Verify از خط فرمان و ارسال خروجی آن به \fIstdout\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
gramps \-O \(aqMy Family Tree\(aq \-a tool \-p name= verify
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
در نهایت، برای آغاز یک نشست تعاملی معمولی وارد کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
gramps
.ft P
.fi
.UNINDENT
.UNINDENT.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.sp
این برنامه بررسی می‌کند که آیا این متغیرهای محیطی مقداردهی شده‌اند یا خیر:
.INDENT 0.0
.TP
.B \fBLANG\fP
مشخص می‌کند از کدام زبان استفاده شود.
برای نمونه، برای زبان لهستانی این متغیر باید روی \fIpl_PL.UTF\-8\fP تنظیم شود\&.
.TP
.B \fBGRAMPSHOME\fP
برنامه Gramps را وادار می‌کند تا از دایرکتوری مشخص‌شده برای نگهداری تنظیمات
برنامه و پایگاه‌های داده استفاده کند.
به‌طور پیش‌فرض، این متغیر تنظیم نشده است و gramps فرض می‌کند که پوشه
حاوی تمام پایگاه‌های داده و تنظیمات نمایه باید درون پوشه نمایه کاربر
(مشخص‌شده توسط متغیر محیطی \fIHOME\fP برای Linux یا
\fIUSERPROFILE\fP برای Windows 2000/XP) ایجاد شود.
.TP
.B \fBCONCEPTS\fP
از یک سیستم افزونه مبتنی بر Python پشتیبانی می‌کند که امکان افزودن ابزارهای ورود و خروج داده،
گزارش‌سازها، ابزارها و فیلترهای نمایش را بدون نیاز به تغییر در برنامه اصلی فراهم می‌سازد.
.sp
گزارش‌سازها علاوه بر تولید مستقیم خروجی برای چاپگر، قالب‌های خروجی دیگری مانند
\fILibreOffice\fP، \fIAbiWord\fP، \fIHTML\fP یا \fILaTeX\fP را نیز هدف قرار می‌دهند تا
به کاربران امکان دهند قالب را متناسب با نیازهای خود ویرایش کنند.
.UNINDENT
.SH "فایل‌ها (FILES)"
.INDENT 0.0
.INDENT 3.5
\fI${PREFIX}/bin/gramps\fP
.sp
\fI${PREFIX}/lib/python3/dist\-packages/gramps/\fP
.sp
\fI${PREFIX}/share/\fP
.sp
\fI${HOME}/.gramps\fP
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"
.sp
Donald Allingham <\fI\%don@gramps\-project.org\fP>
\fI\%https://www.gramps\-project.org\fP
.sp
این صفحه راهنما در ابتدا توسط:
Brandon L. Griffith <\fI\%brandon@debian.org\fP>
برای گنجانده شدن در سیستم Debian GNU/Linux نوشته شد.
.sp
این صفحه راهنما در حال حاضر توسط:
پروژه Gramps <\fI\%xxx@gramps\-project.org\fP>
نگهداری می‌شود.
.SH "مستندات (DOCUMENTATION)"
.sp
مستندات کاربر از طریق یک مرورگر وب در قالب راهنمای Gramps در دسترس است.
.sp
مستندات توسعه‌دهندگان را می‌توان در درگاه
\fI\%https://www.gramps\-project.org/wiki/index.php/Portal:Developers\fP
یافت.
.\" Generated by docutils manpage writer.
.