.TH Gource 1 .SH "نام (NAME)" gource \- بصری‌ساز نرم‌افزاری کنترل نسخه مبتنی بر OpenGL .SH "خلاصه دستور (SYNOPSIS)" \fIgource\fR [\fIگزینه‌ها\fR] [\fIمسیر\fR] .SH "توضیحات (DESCRIPTION)" \fIgource\fR یک ابزار بصری‌سازی سه‌بعدی مبتنی بر OpenGL برای مخازن کنترل نسخه سورس‌کد است. مخزن به صورت یک درخت نمایش داده می‌شود که در آن ریشه مخزن در مرکز قرار دارد، دایرکتوری‌ها شاخه‌ها و فایل‌ها برگ‌ها هستند. مشارکت‌کنندگان در سورس‌کد با ایجاد تغییر در فایل‌ها و دایرکتوری‌های خاص، ظاهر و ناپدید می‌شوند. .SH "نیازمندی‌ها (REQUIREMENTS)" \fIgource\fR برای اجرا به یک کارت گرافیک با پشتیبانی از OpenGL نیاز دارد. .SH "گزینه‌ها (OPTIONS)" .TP 8 \fB\-h, \-\-help\fR راهنما (برای راهنمای جامع‌تر از \fB\-H\fR استفاده کنید). .TP \fB\-WIDTHxHEIGHT, \-\-viewport WIDTHxHEIGHT\fR تنظیم اندازه درگاه دید (viewport). اگر گزینه \fB\-f\fR نیز مشخص شده باشد، تلاش می‌کند حالت ویدیویی را نیز بر همین اساس تنظیم کند. افزودن ! پنجره را غیرقابل تغییر اندازه می‌کند. .TP \fB\-f\fR حالت تمام‌صفحه. .TP \fB\-\-screen SCREEN\fR تنظیم شماره صفحه‌نمایش جهت نمایش برنامه. .TP \fB\-\-high\-dpi\fR درخواست صفحه‌نمایش با تراکم پیکسلی بالا (High DPI) هنگام ساخت پنجره. در برخی پلتفرم‌ها مانند MacOS، وضوح تصویر پنجره به جای پیکسل با واحد پوینت (Point) مشخص می‌شود. گزینه \fB\-\-high\-dpi\fR ممکن است برای دسترسی به برخی وضوح‌های بالاتر مورد نیاز باشد. برای مثال، درخواست یک پنجره 800x600 با تراکم بالا ممکن است پنجره‌ای با ابعاد 1600x1200 پیکسل ایجاد کند. .TP \fB\-\-window\-position XxY\fR موقعیت اولیه پنجره روی دسکتاپ (در محیط‌های چند مانیتوره). این گزینه تنظیم screen را بازنویسی می‌کند، بنابراین هر دو را هم‌زمان مشخص نکنید. .TP \fB\-\-frameless\fR پنجره بدون قاب و حاشیه. .TP \fB\-\-transparent\fR شفاف کردن پس‌زمینه (عمدتاً برای اسکرین‌شات‌ها کاربرد دارد). .TP \fB\-\-start\-date "YYYY\-MM\-DD hh:mm:ss +tz"\fR شروع از نخستین مدخل پس از تاریخ و زمان مشخص‌شده اختیاری. اگر اختلاف منطقه زمانی مشخص نشود، از منطقه زمانی محلی استفاده می‌شود. نمونه قالب‌های قابل قبول: .nf "2012-06-30" "2012-06-30 12:00" "2012-06-30 12:00:00 +12" .fi .TP \fB\-\-stop\-date "YYYY\-MM\-DD hh:mm:ss +tz"\fR توقف در آخرین مدخل پیش از تاریخ و زمان مشخص‌شده اختیاری. از قالبی مشابه \fB\-\-start\-date\fR استفاده می‌کند. .TP \fB\-p, \-\-start\-position POSITION\fR شروع از یک موقعیت خاص در گزارش لاگ (عددی بین 0.0 تا 1.0 یا مقدار 'random'). .TP \fB\-\-stop\-position POSITION\fR توقف (خروج) در یک موقعیت خاص در گزارش لاگ (با STDIN کار نمی‌کند). .TP \fB\-t, \-\-stop\-at\-time SECONDS\fR توقف (خروج) پس از تعداد ثانیه‌های مشخص‌شده. .TP \fB\-\-stop\-at\-end\fR توقف (خروج) در انتهای گزارش لاگ یا جریان ورودی. .TP \fB\-\-loop\fR تکرار و بازگشت به ابتدای گزارش لاگ پس از رسیدن به پایان آن. .TP \fB\-\-loop\-delay\-seconds SECONDS\fR میزان تأخیر به ثانیه پیش از شروع مجدد چرخه. .TP \fB\-a, \-\-auto\-skip\-seconds SECONDS\fR پرش خودکار به مدخل بعدی در صورت عدم وقوع هیچ رویدادی برای تعداد ثانیه‌های مشخص‌شده. .TP \fB\-s, \-\-seconds\-per\-day SECONDS\fR سرعت شبیه‌سازی بر حسب ثانیه به ازای هر روز. .TP \fB\-\-realtime\fR سرعت پخش بلادرنگ و واقعی. .TP \fB\-\-no\-time\-travel\fR در صورتی که زمان یک کامیت در گذشته باشد، از زمان آخرین کامیت استفاده شود. .TP \fB\-\-author\-time\fR استفاده از برچسب زمانی پدیدآورنده (Author) به جای برچسب زمانی ثبت‌کننده (Committer). .TP \fB\-c, \-\-time\-scale SCALE\fR تغییر مقیاس زمانی شبیه‌سازی. این گزینه بر سرعت حرکت آواتار کاربران تأثیر می‌گذارد. برای نمونه 0.5 برای نصف سرعت و 2 برای دو برابر سرعت. .TP \fB\-i, \-\-file\-idle\-time SECONDS\fR مدت‌زمان به ثانیه که فایل‌ها پیش از حذف در حالت غیرفعال باقی می‌مانند، یا 0 برای نامحدود. .TP \fB\-\-file\-idle\-time\-at\-end SECONDS\fR مدت‌زمان به ثانیه که فایل‌ها در انتهای شبیه‌سازی پیش از حذف در حالت غیرفعال باقی می‌مانند. .TP \fB\-e, \-\-elasticity FLOAT\fR میزان کشسانی و انعطاف‌پذیری گره‌ها. .TP \fB\-b, \-\-background\-colour FFFFFF\fR رنگ پس‌زمینه در قالب هگزادسیمال. .TP \fB\-\-background\-image IMAGE\fR تنظیم یک تصویر پس‌زمینه. .TP \fB\-\-title TITLE\fR تنظیم عنوان نمایش. .TP \fB\-\-font\-file FILE\fR مشخص کردن فایل فونت. با اکثر قالب‌های فونت پشتیبانی‌شده توسط FreeType مانند TTF و OTF کار می‌کند. .TP \fB\-\-font\-scale SCALE\fR تغییر مقیاس اندازه تمام قلم‌ها. .TP \fB\-\-font\-size SIZE\fR اندازه فونت استفاده‌شده برای تاریخ و عنوان. .TP \fB\-\-file\-font\-size SIZE\fR اندازه فونت نام فایل‌ها. .TP \fB\-\-dir\-font\-size SIZE\fR اندازه فونت نام دایرکتوری‌ها. .TP \fB\-\-user\-font\-size SIZE\fR اندازه فونت نام کاربران. .TP \fB\-\-font\-colour FFFFFF\fR رنگ فونت تاریخ و عنوان در قالب هگزادسیمال. .TP \fB\-\-key\fR نمایش راهنمای پسوند فایل‌ها. .TP \fB\-\-logo IMAGE\fR لوگو جهت نمایش در پیش‌زمینه. .TP \fB\-\-logo\-offset XxY\fR موقعیت آفست و جابه‌جایی لوگو. .TP \fB\-\-date\-format FORMAT\fR مشخص کردن قالب نمایش تاریخ (با قالب strftime). .TP \fB\-\-log\-command VCS\fR نمایش دستور لاگ استفاده‌شده توسط gource برای سیستم‌های کنترل نسخه (git، svn، hg، bzr، cvs2cl). .TP \fB\-\-log\-format VCS\fR مشخص کردن قالب گزارش لاگ ورودی (git، svn، hg، bzr، cvs2cl، custom). هنگام خواندن از STDIN الزامی است. .TP \fB\-\-git\-branch\fR دریافت لاگ گیت مربوط به شاخه‌ای غیر از شاخه جاری. .TP \fB\-\-follow\-user USER\fR دنبال کردن خودکار یک کاربر خاص توسط دوربین. .TP \fB\-\-highlight\-dirs\fR برجسته کردن نام تمامی دایرکتوری‌ها. .TP \fB\-\-highlight\-user USER\fR برجسته کردن نام یک کاربر خاص. .TP \fB\-\-highlight\-users\fR برجسته کردن نام تمامی کاربران. .TP \fB\-\-highlight\-colour FFFFFF\fR رنگ فونت کاربران برجسته‌شده در قالب هگزادسیمال. .TP \fB\-\-selection\-colour FFFFFF\fR رنگ فونت کاربران و فایل‌های انتخاب‌شده. .TP \fB\-\-filename\-colour FFFFFF\fR رنگ فونت نام فایل‌ها. .TP \fB\-\-dir\-colour FFFFFF\fR رنگ فونت دایرکتوری‌ها. .TP \fB\-\-dir\-name\-depth DEPTH\fR رسم نام دایرکتوری‌ها تا عمق مشخصی از ساختار درخت. .TP \fB\-\-dir\-name\-position FLOAT\fR موقعیت قرارگیری نام دایرکتوری در امتداد لبه (عددی بین 0.1 تا 1.0، مقدار پیش‌فرض 0.5 است). .TP \fB\-\-filename\-time SECONDS\fR مدت‌زمان نمایش نام فایل‌ها روی صفحه (بزرگ‌تر یا مساوی 2.0). .TP \fB\-\-file\-extensions\fR تنها نمایش پسوند فایل‌ها. .TP \fB\-\-file\-extension\-fallback\fR استفاده از نام فایل به عنوان پسوند در صورت خالی یا ناموجود بودن پسوند. .TP \fB\-\-file\-filter REGEX\fR فیلتر کردن و نادیده گرفتن مسیر فایل‌های منطبق بر عبارت باقاعده مشخص‌شده. .TP \fB\-\-file\-show\-filter REGEX\fR نمایش انحصاری مسیر فایل‌های منطبق بر عبارت باقاعده مشخص‌شده. .TP \fB\-\-user\-filter REGEX\fR فیلتر کردن و نادیده گرفتن نام کاربران منطبق بر عبارت باقاعده مشخص‌شده. .TP \fB\-\-user\-show\-filter REGEX\fR نمایش انحصاری نام کاربران منطبق بر عبارت باقاعده مشخص‌شده. .TP \fB\-\-user\-image\-dir DIRECTORY\fR دایرکتوری حاوی تصاویر کاربران با قالب jpg. یا png. (مانند "Full Name.png") جهت استفاده به عنوان آواتار. .TP \fB\-\-default\-user\-image IMAGE\fR مسیر تصویر با فرمت jpg. برای استفاده به عنوان تصویر پیش‌فرض کاربر. .TP \fB\-\-fixed\-user\-size\fR ثابت نگه‌داشتن اندازه تصویر کاربر در تمام طول شبیه‌سازی. .TP \fB\-\-colour\-images\fR رنگی کردن تصاویر کاربران. .TP \fB\-\-crop AXIS\fR برش نمای دید در امتداد یک محور (vertical یا horizontal). .TP \fB\-\-padding FLOAT\fR فاصله حاشیه (padding) نمای دوربین. .TP \fB\-\-multi\-sampling\fR فعال‌سازی نمونه‌برداری چندگانه (Multi-sampling). .TP \fB\-\-no\-vsync\fR غیرفعال‌سازی همگام‌سازی عمودی (V-Sync). .TP \fB\-\-bloom\-multiplier FLOAT\fR تنظیم میزان افکت درخشش (Bloom). .TP \fB\-\-bloom\-intensity FLOAT\fR تنظیم شدت افکت درخشش (Bloom). .TP \fB\-\-max\-files NUMBER\fR تنظیم حداکثر تعداد فایل‌ها یا مقدار 0 برای نامحدود. فایل‌های مازاد دور ریخته خواهند شد. .TP \fB\-\-max\-file\-lag SECONDS\fR حداکثر زمان مجاز برای ظاهر شدن فایل‌های یک کامیت. برای حالت نامحدود از مقدار \-1 استفاده کنید. .TP \fB\-\-max\-user\-speed UNITS\fR حداکثر سرعت جابه‌جایی کاربران بر حسب واحد در ثانیه. .TP \fB\-\-user\-friction SECONDS\fR مدت‌زمان مورد نیاز برای متوقف شدن کامل کاربران. .TP \fB\-\-user\-scale SCALE\fR تغییر مقیاس آواتار کاربران. .TP \fB\-\-camera\-mode MODE\fR حالت دوربین (overview یا track). .TP \fB\-\-disable\-auto\-rotate\fR غیرفعال کردن چرخش خودکار دوربین. .TP \fB\-\-disable\-input\fR غیرفعال کردن ورودی‌های صفحه‌کلید و ماوس. .TP \fB\-\-hide DISPLAY_ELEMENT\fR مخفی کردن یک یا چند مورد از عناصر نمایشی فهرست زیر: .nf bloom \- افکت درخشش date \- تاریخ جاری dirnames \- نام دایرکتوری‌ها files \- آیکون‌های فایل‌ها filenames \- نام فایل‌ها mouse \- نشانگر ماوس progress \- نوار پیشرفت root \- دایرکتوری ریشه درخت tree \- ساختار درختی متحرک users \- آواتار کاربران usernames \- نام کاربران .fi عناصر چندگانه را با کاما جدا کنید (مانند "mouse,progress"). .TP \fB\-\-hash\-seed SEED\fR تغییر مقدار بذر (seed) تابع درهم‌سازی. .TP \fB\-\-caption\-file FILE\fR فایل زیرنویس/توضیحات (بخش قالب گزارش عنوان را ببینید). .TP \fB\-\-caption\-size SIZE\fR اندازه عنوان. .TP \fB\-\-caption\-colour FFFFFF\fR رنگ عنوان در قالب هگزادسیمال. .TP \fB\-\-caption\-duration SECONDS\fR مدت‌زمان نمایش عنوان. .TP \fB\-\-caption\-offset X\fR آفست افقی عنوان (0 برای وسط‌چین کردن عناوین). .TP \fB\-o, \-\-output\-ppm\-stream FILE\fR خروجی دادن یک جریان تصویر PPM به یک فایل (برای خروجی استاندارد از '\-' استفاده کنید). این گزینه به‌طور خودکار نوار پیشرفت را در ابتدا مخفی کرده و گزینه 'stop\-at\-end' را فعال می‌کند مگر اینکه رفتار دیگری مشخص شده باشد. .TP \fB\-r, \-\-output\-framerate FPS\fR نرخ فریم خروجی (25، 30، 60). همراه با \fB\-\-output\-ppm\-stream\fR استفاده می‌شود. .TP \fB\-\-output\-custom\-log FILE\fR خروجی دادن یک فایل لاگ با قالب سفارشی (برای خروجی استاندارد از '\-' استفاده کنید). .TP \fB\-\-load\-config CONFIG_FILE\fR بارگذاری یک فایل پیکربندی. .TP \fB\-\-save\-config CONFIG_FILE\fR ذخیره یک فایل پیکربندی حاوی گزینه‌های جاری. .TP \fB\-\-path PATH\fR .TP \fBpath\fR یک دایرکتوری کنترل نسخه پشتیبانی‌شده، یک فایل لاگ از پیش تولیدشده (دستورات لاگ یا قالب گزارش سفارشی را ببینید)، یک فایل پیکربندی Gource یا '-' جهت خواندن از STDIN. اگر مسیر مشخص نشود، gource تلاش می‌کند لاگ را از دایرکتوری جاری بخواند. .SS "مثال‌های Git، Bazaar، Mercurial و SVN" مشاهده لاگ مخزن در مسیر جاری: .ti 10 \fIgource\fR مشاهده لاگ پروژه‌ای در دایرکتوری مشخص‌شده: .ti 10 \fIgource\fR my\-project\-dir برای پروژه‌های بزرگ، تولید لاگ تاریخچه پروژه ممکن است زمان زیادی ببرد. برای سیستم‌های کنترل نسخه متمرکز مانند SVN، تولید لاگ باعث بارگذاری روی سرور مرکزی می‌شود. در این موارد، ممکن است بخواهید یک نسخه از لاگ را برای استفاده‌های بعدی ذخیره کنید. می‌توانید با استفاده از گزینه \fB\-\-log\-command VCS\fR یک لاگ با قالب اختصاصی سیستم کنترل نسخه تولید کنید: .ti 10 cd my\-svn\-project .ti 10 \`\fIgource\fR \-\-log\-command svn\` > my\-svn\-project.log .ti 10 \fIgource\fR my\-svn\-project.log همچنین می‌توانید ترتیبی دهید که Gource یک نسخه از فایل لاگ را در قالب اختصاصی خود بنویسد: .ti 10 \fIgource\fR \-\-output\-custom\-log my\-project\-custom.log .SS "پشتیبانی از CVS" از 'cvs2cl' برای تولید لاگ استفاده کرده و سپس آن را به Gource ارسال کنید: .ti 10 cvs2cl \-\-chrono \-\-stdout \-\-xml \-g\-q > my\-cvs\-project.log .ti 10 gource my\-cvs\-project.log .SS "قالب گزارش سفارشی (Custom Log Format)" اگر می‌خواهید از Gource با سیستمی غیر از موارد پشتیبانی‌شده استفاده کنید، یک قالب گزارش سفارشی تفکیک‌شده با خط عمودی ('|') وجود دارد: .nf .ti 10 timestamp - برچسب زمانی یونیکس یا ISO 8601 از زمان وقوع به‌روزرسانی. .ti 10 username - نام کاربری که به‌روزرسانی را انجام داده است. .ti 10 type - یک کاراکتر برای نوع به‌روزرسانی - (A)فزوده، (M)تغییر یا (D)حذف. .ti 10 file - مسیر فایل به‌روزشده. .ti 10 colour - رنگ فایل در قالب هگزادسیمال (FFFFFF). اختیاری. .fi .SS "قالب گزارش عنوان (Caption Log Format)" نرم‌افزار Gource می‌تواند با تعیین یک فایل عنوان (با استفاده از \fB\-\-caption\-file\fR) در قالب تفکیک‌شده با خط عمودی ('|') زیر، عناوین و زیرنویس‌ها را در طول خط زمانی نمایش دهد: .nf .ti 10 timestamp - برچسب زمانی یونیکس یا ISO 8601 از زمان نمایش عنوان. .ti 10 caption - متن عنوان .fi .SS "ضبط ویدیوها (Recording Videos)" راهنمای صفحه خانگی را برای نمونه‌های ضبط ویدیو با Gource مشاهده کنید: .ti 10 https://github.com/acaudwell/Gource/wiki/Videos .SS "اطلاعات بیشتر (More Information)" برای راهنماها و نمونه‌های استفاده از Gource با سیستم‌های مختلف کنترل نسخه، به صفحه خانگی Gource مراجعه کنید: .ti 10 http://gource.io .SH "رابط کاربری (INTERFACE)" زمان نمایش‌داده‌شده در گوشه بالای سمت چپ صفحه در ابتدا از نخستین مدخل لاگ خوانده‌شده تنظیم می‌شود و بر اساس سرعت شبیه‌سازی (\fB\-\-seconds\-per\-day\fR) افزایش می‌یابد. فشردن کلید SPACE در هر زمان شبیه‌سازی را متوقف/از سر می‌گیرد. در حالت توقف می‌توانید از ماوس برای بررسی جزئیات فایل‌ها و کاربران مجزا استفاده کنید. کلید TAB به ترتیب میان کاربران مرئی فعلی حرکت و آن‌ها را انتخاب می‌کند. حالت دوربین (ردیابی فعالیت‌ها یا نمایش کل درخت کد) را می‌توان با کلیک دکمه وسط ماوس تغییر داد. می‌توانید کلید چپ ماوس را برای کنترل دستی دوربین بکشید. کلید راست ماوس نمای دید را می‌چرخاند. دستورات تعاملی صفحه‌کلید: .sp .nf .ti 10 (V) تغییر حالت دوربین .ti 10 (C) نمایش لوگوی Gource .ti 10 (K) تغییر وضعیت راهنمای پسوند فایل‌ها .ti 10 (M) تغییر وضعیت نمایش نشانگر ماوس .ti 10 (N) پرش به جلو در زمان تا مدخل بعدی لاگ .ti 10 (S) تصادفی‌سازی رنگ‌ها .ti 10 (D) تغییر حالت نمایش نام دایرکتوری‌ها .ti 10 (F) تغییر حالت نمایش نام فایل‌ها .ti 10 (U) تغییر حالت نمایش نام کاربران .ti 10 (G) تغییر وضعیت نمایش کاربران .ti 10 (T) تغییر وضعیت نمایش یال‌های درخت دایرکتوری .ti 10 (R) تغییر وضعیت نمایش یال‌های دایرکتوری ریشه .ti 10 (<>) تنظیم مقیاس زمانی / سرعت حرکت آواتار کاربران .ti 10 (+-) تنظیم سرعت شبیه‌سازی .ti 10 (Keypad +-) تنظیم بزرگ‌نمایی دوربین .ti 10 (TAB) پیمایش میان کاربران مرئی .ti 10 (F12) تصویربرداری از صفحه (اسکرین‌شات) .ti 10 (Alt+Enter) تغییر وضعیت تمام‌صفحه .ti 10 (ESC) خروج .fi .SH "نویسنده (AUTHOR)" .nf Written by Andrew Caudwell Project Homepage: http://gource.io .fi .SH "حق نشر (COPYRIGHT)" .nf Copyright (C) 2009 Andrew Caudwell (acaudwell@gmail.com) This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . .fi .SH "قدردانی‌ها (ACKNOWLEDGEMENTS)" .nf Catalyst IT (catalyst.net.nz) جهت حمایت از توسعه Gource! .fi