GRAMPS(1) 6.0.8 GRAMPS(1)

gramps - سامانه برنامه‌نویسی مدیریت، تحلیل و پژوهش تبارشناسی.

gramps [-? | --help] [--usage] [--version] [-l] [-L] [-u | --force-unlock] [-O | --open=DATABASE [-f | --format=FORMAT]] [-i | --import=FILE [-f | --format=FORMAT]] [--remove=FAMILY_TREE_PATTERN] [-e | --export=FILE [-f | --format=FORMAT]] [-a | --action=ACTION] [-p | --options=OPTION-STRING]] [FILE] [--version]

نرم‌افزار Gramps یک برنامه تبارشناسی آزاد و متن‌باز است. این برنامه به زبان Python و با استفاده از رابط GTK+/GNOME نوشته شده است. کار با Gramps برای هر کسی که پیش از این از سایر برنامه‌های تبارشناسی مانند ™Family Tree Maker، ‏™Personal Ancestral Files یا GNU Geneweb استفاده کرده باشد، آشنا خواهد بود. این برنامه از وارد کردن (import) قالب بسیار پرطرفدار GEDCOM که تقریباً در تمامی نرم‌افزارهای تبارشناسی در سرتاسر جهان استفاده می‌شود، پشتیبانی می‌کند.

هنگامی که FILE (بدون هیچ گزینه‌ای) به عنوان نام شجره‌نامه یا دایرکتوری پایگاه داده شجره‌نامه داده شود، باز شده و یک نشست تعاملی آغاز می‌شود. اگر FILE یک قالب فایل قابل فهم برای Gramps باشد، یک شجره‌نامه خالی بر اساس نام FILE ایجاد شده و داده‌ها درون آن وارد می‌شوند. هر گزینه دیگری نادیده گرفته خواهد شد. این روش اجرا برای به‌کارگیری gramps به عنوان گرداننده داده‌های تبارشناسی در مواردی مانند مرورگرهای وب مناسب است. این شیوه فراخوانی می‌تواند هر قالب داده بومی gramps را بپذیرد؛ به زیر نگاه کنید.
به‌طور صریح قالب FILE داده‌شده با گزینه‌های پیشین -i یا -e را تعیین می‌کند. اگر گزینه -f برای یک FILE داده نشود، قالب آن فایل بر اساس پسوند یا نوع MIME حدس زده می‌شود.

قالب‌های موجود برای صدور (export) عبارتند از: gramps-xml (اگر FILE به .gramps ختم شود حدس زده می‌شود)، gedcom (اگر FILE به .ged ختم شود حدس زده می‌شود)، یا هر فایل خروجی قابل دسترسی از طریق سامانه افزونه‌های Gramps.

قالب‌های موجود برای وارد کردن (import) عبارتند از: gramps-xml، gedcom، gramps-pkg (اگر FILE به .gpkg ختم شود حدس زده می‌شود) و geneweb (اگر FILE به .gw ختم شود حدس زده می‌شود).

قالب‌های موجود برای صدور عبارتند از: gramps-xml، gedcom، gramps-pkg، wft (اگر FILE به .wft ختم شود حدس زده می‌شود)، geneweb.

چاپ فهرستی از شجره‌نامه‌های شناخته‌شده.
چاپ فهرستی با جزئیات کامل از شجره‌نامه‌های شناخته‌شده.
باز کردن قفل یک پایگاه داده قفل‌شده.
باز کردن DATABASE که باید یک دایرکتوری پایگاه داده موجود یا نام یک شجره‌نامه موجود باشد. اگر هیچ گزینه عملیات، وارد کردن یا صدوری در خط فرمان داده نشود، یک نشست تعاملی با استفاده از آن پایگاه داده آغاز می‌شود.
وارد کردن داده‌ها از FILE. اگر هیچ پایگاه داده‌ای مشخص نشده باشد، یک پایگاه داده خالی با نام Family Tree x (که در آن x یک شماره افزایشی است) ایجاد می‌شود.

هنگامی که بیش از یک فایل ورودی داده شود، پیش از هرکدام باید پرچم -i قرار گیرد. فایل‌ها به همان ترتیب مشخص‌شده وارد می‌شوند؛ برای نمونه، -i FILE1 -i FILE2 و -i FILE2 -i FILE1 ممکن است شناسه‌های (IDهای) gramps متفاوتی در پایگاه داده حاصل ایجاد کنند.

صدور داده‌ها به FILE. برای gramps-xml، gedcom، wft، gramps-pkg و geneweb، مقدار FILE نام فایل حاصل خواهد بود.

هنگامی که بیش از یک فایل خروجی داده شود، پیش از هرکدام باید پرچم -e قرار گیرد. فایل‌ها یکی پس از دیگری و با ترتیب مشخص‌شده نوشته می‌شوند.

انجام ACTION روی داده‌های واردشده. این کار پس از تکمیل موفقیت‌آمیز تمام واردسازی‌ها انجام می‌شود. عملیات‌های در دسترس کنونی عبارتند از summary (مشابه Reports→View→Summary)، check (مشابه Tools→Database Processing→Check and Repair)، report (تولید گزارش)، و tool (اجرای یک ابزار افزونه). هر دو مورد report و tool به OPTION-STRING ارائه‌شده با پرچم -p نیاز دارند.

مقدار OPTION-STRING باید شرایط زیر را برآورده کند:

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

بیشتر گزینه‌های گزارش‌ها یا ابزارها مختص هر گزارش یا ابزار مشخص هستند. با این وجود، برخی گزینه‌های مشترک نیز وجود دارد.

این گزینه اجباری مشخص می‌کند که کدام گزارش یا ابزار اجرا خواهد شد. اگر name داده‌شده با هیچ گزارش یا ابزار موجودی همخوانی نداشته باشد، یک پیام خطا چاپ شده و پس از آن فهرستی از گزارش‌ها یا ابزارهای موجود (بسته به ACTION) نمایش می‌یابد.
فهرستی از نام تمام گزینه‌های موجود برای یک گزارش یا ابزار خاص را ارائه می‌دهد.
توضیحات عملکرد ارائه‌شده توسط optionname و همچنین انواع و مقادیر قابل‌قبول برای این گزینه را چاپ می‌کند.

از گزینه‌های بالا برای آگاهی از همه موارد مربوط به یک گزارش مشخص استفاده کنید.

هنگامی که بیش از یک عمل خروجی داده شود، پیش از هرکدام باید پرچم -a قرار گیرد. این عملیات‌ها یکی پس از دیگری و با ترتیب مشخص‌شده انجام می‌شوند.

فعال‌سازی لاگ‌های اشکال‌زدایی (debug) برای توسعه و آزمایش. برای جزئیات بیشتر به کد منبع مراجعه کنید..TP --version چاپ شماره نسخه gramps و سپس خروج.

اگر نخستین آرگومان در خط فرمان با خط تیره شروع نشود (یعنی هیچ پرچمی نباشد)، gramps تلاش خواهد کرد تا فایلی با نام مشخص‌شده توسط نخستین آرگومان را باز کند و یک نشست تعاملی را آغاز نماید و باقی آرگومان‌های خط فرمان را نادیده بگیرد.

اگر پرچم -O داده شود، آن‌گاه gramps سعی می‌کند پایگاه‌داده ارائه‌شده را باز کرده و سپس طبق دستورالعمل پارامترهای بعدی خط فرمان، با آن داده‌ها کار کند.

با پرچم -O یا بدون آن، وارد کردن‌ها، صادر کردن‌ها و کنش‌های بعدی را می‌توان با استفاده از پرچم‌های -i، -e و -a در خط فرمان مشخص کرد.

ترتیب گزینه‌های -i، -e یا -a اهمیتی ندارد. ترتیب واقعی پردازش آن‌ها همواره به این صورت است: همه وارد کردن‌ها (در صورت وجود) → همه کنش‌ها (در صورت وجود) → همه صادر کردن‌ها (در صورت وجود). اما باز کردن همیشه باید در ابتدا باشد!

اگر هیچ گزینه -O یا -i داده نشود، gramps پنجره اصلی خود را باز کرده و نشست تعاملی معمول را با یک پایگاه‌داده خالی آغاز می‌کند، چرا که در هر صورت داده‌ای برای پردازش وجود ندارد.

اگر هیچ گزینه -e یا -a داده نشود، gramps پنجره اصلی خود را باز کرده و نشست تعاملی معمول را با پایگاه‌داده حاصل از همه وارد کردن‌ها آغاز می‌کند. این پایگاه‌داده در فایل import_db.grdb در دایرکتوری ~/.gramps/import قرار دارد.

هرگونه خطای رخ‌داده در حین وارد کردن، صادر کردن یا کنش، یا در stdout (اگر استثناهایی باشند که توسط gramps مدیریت می‌شوند) یا در stderr (اگر مدیریت‌نشده باشند) ارسال خواهد شد. برای ذخیره پیام‌ها و خطاها در فایل‌ها از تغییرمسیرهای معمول پوسته برای stdout و stderr استفاده کنید.

برای باز کردن یک شجره‌نامه موجود و وارد کردن یک فایل xml به آن، می‌توان این دستور را وارد کرد:

gramps -O 'My Family Tree' -i ~/db3.gramps

دستور بالا شجره‌نامه بازشده را تغییر می‌دهد. برای انجام همین کار، اما با وارد کردن هر دو در یک شجره‌نامه موقت و شروع یک نشست تعاملی، می‌توان نوشت:

gramps -i 'My Family Tree' -i ~/db3.gramps

برای وارد کردن چهار پایگاه‌داده (که قالب آن‌ها از روی نامشان قابل تشخیص است) و سپس بررسی پایگاه‌داده حاصل برای یافتن خطاها، می‌توان نوشت:

gramps -i file1.ged -i file2.tgz -i ~/db3.gramps -i file4.wft -a check

برای مشخص کردن صریح قالب‌ها در مثال بالا، گزینه‌های مناسب -f را به انتهای نام فایل‌ها اضافه کنید:

gramps -i file1.ged -f gedcom -i file2.tgz -f gramps-pkg \
-i ~/db3.gramps -f gramps-xml -i file4.wft -f wft -a check

برای ذخیره پایگاه‌داده حاصل از همه وارد کردن‌ها، یک پرچم -e را مشخص کنید (اگر نام فایل به gramps اجازه حدس زدن قالب را نمی‌دهد از -f استفاده کنید):

gramps -i file1.ged -i file2.tgz -e ~/new-package -f gramps-pkg

برای وارد کردن سه پایگاه‌داده و آغاز یک نشست تعاملی gramps با نتیجه حاصل:

gramps -i file1.ged -i file2.tgz -i ~/db3.gramps

برای اجرای ابزار Verify از خط فرمان و ارسال خروجی آن به stdout:

gramps -O 'My Family Tree' -a tool -p name= verify

در نهایت، برای آغاز یک نشست تعاملی معمولی وارد کنید:

gramps

این برنامه بررسی می‌کند که آیا این متغیرهای محیطی مقداردهی شده‌اند یا خیر:

مشخص می‌کند از کدام زبان استفاده شود. برای نمونه، برای زبان لهستانی این متغیر باید روی pl_PL.UTF-8 تنظیم شود.
برنامه Gramps را وادار می‌کند تا از دایرکتوری مشخص‌شده برای نگهداری تنظیمات برنامه و پایگاه‌های داده استفاده کند. به‌طور پیش‌فرض، این متغیر تنظیم نشده است و gramps فرض می‌کند که پوشه حاوی تمام پایگاه‌های داده و تنظیمات نمایه باید درون پوشه نمایه کاربر (مشخص‌شده توسط متغیر محیطی HOME برای Linux یا USERPROFILE برای Windows 2000/XP) ایجاد شود.
از یک سیستم افزونه مبتنی بر Python پشتیبانی می‌کند که امکان افزودن ابزارهای ورود و خروج داده، گزارش‌سازها، ابزارها و فیلترهای نمایش را بدون نیاز به تغییر در برنامه اصلی فراهم می‌سازد.

گزارش‌سازها علاوه بر تولید مستقیم خروجی برای چاپگر، قالب‌های خروجی دیگری مانند LibreOffice، AbiWord، HTML یا LaTeX را نیز هدف قرار می‌دهند تا به کاربران امکان دهند قالب را متناسب با نیازهای خود ویرایش کنند.

${PREFIX}/bin/gramps

${PREFIX}/lib/python3/dist-packages/gramps/

${PREFIX}/share/

${HOME}/.gramps

Donald Allingham <don@gramps-project.org> https://www.gramps-project.org

این صفحه راهنما در ابتدا توسط: Brandon L. Griffith <brandon@debian.org> برای گنجانده شدن در سیستم Debian GNU/Linux نوشته شد.

این صفحه راهنما در حال حاضر توسط: پروژه Gramps <xxx@gramps-project.org> نگهداری می‌شود.

مستندات کاربر از طریق یک مرورگر وب در قالب راهنمای Gramps در دسترس است.

مستندات توسعه‌دهندگان را می‌توان در درگاه https://www.gramps-project.org/wiki/index.php/Portal:Developers یافت.