Gource(1) General Commands Manual Gource(1) نام (NAME) gource - بصری‌ساز نرم‌افزاری کنترل نسخه مبتنی بر OpenGL خلاصه دستور (SYNOPSIS) gource [گزینه‌ها] [مسیر] توضیحات (DESCRIPTION) gource یک ابزار بصری‌سازی سه‌بعدی مبتنی بر OpenGL برای مخازن کنترل نسخه سورس‌کد است. مخزن به صورت یک درخت نمایش داده می‌شود که در آن ریشه مخزن در مرکز قرار دارد، دایرکتوری‌ها شاخه‌ها و فایل‌ها برگ‌ها هستند. مشارکت‌کنندگان در سورس‌کد با ایجاد تغییر در فایل‌ها و دایرکتوری‌های خاص، ظاهر و ناپدید می‌شوند. نیازمندی‌ها (REQUIREMENTS) gource برای اجرا به یک کارت گرافیک با پشتیبانی از OpenGL نیاز دارد. گزینه‌ها (OPTIONS) -h, --help راهنما (برای راهنمای جامع‌تر از -H استفاده کنید). -WIDTHxHEIGHT, --viewport WIDTHxHEIGHT تنظیم اندازه درگاه دید (viewport). اگر گزینه -f نیز مشخص شده باشد، تلاش می‌کند حالت ویدیویی را نیز بر همین اساس تنظیم کند. افزودن ! پنجره را غیرقابل تغییر اندازه می‌کند. -f حالت تمام‌صفحه. --screen SCREEN تنظیم شماره صفحه‌نمایش جهت نمایش برنامه. --high-dpi درخواست صفحه‌نمایش با تراکم پیکسلی بالا (High DPI) هنگام ساخت پنجره. در برخی پلتفرم‌ها مانند MacOS، وضوح تصویر پنجره به جای پیکسل با واحد پوینت (Point) مشخص می‌شود. گزینه --high-dpi ممکن است برای دسترسی به برخی وضوح‌های بالاتر مورد نیاز باشد. برای مثال، درخواست یک پنجره 800x600 با تراکم بالا ممکن است پنجره‌ای با ابعاد 1600x1200 پیکسل ایجاد کند. --window-position XxY موقعیت اولیه پنجره روی دسکتاپ (در محیط‌های چند مانیتوره). این گزینه تنظیم screen را بازنویسی می‌کند، بنابراین هر دو را هم‌زمان مشخص نکنید. --frameless پنجره بدون قاب و حاشیه. --transparent شفاف کردن پس‌زمینه (عمدتاً برای اسکرین‌شات‌ها کاربرد دارد). --start-date "YYYY-MM-DD hh:mm:ss +tz" شروع از نخستین مدخل پس از تاریخ و زمان مشخص‌شده اختیاری. اگر اختلاف منطقه زمانی مشخص نشود، از منطقه زمانی محلی استفاده می‌شود. نمونه قالب‌های قابل قبول: "2012-06-30" "2012-06-30 12:00" "2012-06-30 12:00:00 +12" --stop-date "YYYY-MM-DD hh:mm:ss +tz" توقف در آخرین مدخل پیش از تاریخ و زمان مشخص‌شده اختیاری. از قالبی مشابه --start-date استفاده می‌کند. -p, --start-position POSITION شروع از یک موقعیت خاص در گزارش لاگ (عددی بین 0.0 تا 1.0 یا مقدار 'random'). --stop-position POSITION توقف (خروج) در یک موقعیت خاص در گزارش لاگ (با STDIN کار نمی‌کند). -t, --stop-at-time SECONDS توقف (خروج) پس از تعداد ثانیه‌های مشخص‌شده. --stop-at-end توقف (خروج) در انتهای گزارش لاگ یا جریان ورودی. --loop تکرار و بازگشت به ابتدای گزارش لاگ پس از رسیدن به پایان آن. --loop-delay-seconds SECONDS میزان تأخیر به ثانیه پیش از شروع مجدد چرخه. -a, --auto-skip-seconds SECONDS پرش خودکار به مدخل بعدی در صورت عدم وقوع هیچ رویدادی برای تعداد ثانیه‌های مشخص‌شده. -s, --seconds-per-day SECONDS سرعت شبیه‌سازی بر حسب ثانیه به ازای هر روز. --realtime سرعت پخش بلادرنگ و واقعی. --no-time-travel در صورتی که زمان یک کامیت در گذشته باشد، از زمان آخرین کامیت استفاده شود. --author-time استفاده از برچسب زمانی پدیدآورنده (Author) به جای برچسب زمانی ثبت‌کننده (Committer). -c, --time-scale SCALE تغییر مقیاس زمانی شبیه‌سازی. این گزینه بر سرعت حرکت آواتار کاربران تأثیر می‌گذارد. برای نمونه 0.5 برای نصف سرعت و 2 برای دو برابر سرعت. -i, --file-idle-time SECONDS مدت‌زمان به ثانیه که فایل‌ها پیش از حذف در حالت غیرفعال باقی می‌مانند، یا 0 برای نامحدود. --file-idle-time-at-end SECONDS مدت‌زمان به ثانیه که فایل‌ها در انتهای شبیه‌سازی پیش از حذف در حالت غیرفعال باقی می‌مانند. -e, --elasticity FLOAT میزان کشسانی و انعطاف‌پذیری گره‌ها. -b, --background-colour FFFFFF رنگ پس‌زمینه در قالب هگزادسیمال. --background-image IMAGE تنظیم یک تصویر پس‌زمینه. --title TITLE تنظیم عنوان نمایش. --font-file FILE مشخص کردن فایل فونت. با اکثر قالب‌های فونت پشتیبانی‌شده توسط FreeType مانند TTF و OTF کار می‌کند. --font-scale SCALE تغییر مقیاس اندازه تمام قلم‌ها. --font-size SIZE اندازه فونت استفاده‌شده برای تاریخ و عنوان. --file-font-size SIZE اندازه فونت نام فایل‌ها. --dir-font-size SIZE اندازه فونت نام دایرکتوری‌ها. --user-font-size SIZE اندازه فونت نام کاربران. --font-colour FFFFFF رنگ فونت تاریخ و عنوان در قالب هگزادسیمال. --key نمایش راهنمای پسوند فایل‌ها. --logo IMAGE لوگو جهت نمایش در پیش‌زمینه. --logo-offset XxY موقعیت آفست و جابه‌جایی لوگو. --date-format FORMAT مشخص کردن قالب نمایش تاریخ (با قالب strftime). --log-command VCS نمایش دستور لاگ استفاده‌شده توسط gource برای سیستم‌های کنترل نسخه (git، svn، hg، bzr، cvs2cl). --log-format VCS مشخص کردن قالب گزارش لاگ ورودی (git، svn، hg، bzr، cvs2cl، custom). هنگام خواندن از STDIN الزامی است. --git-branch دریافت لاگ گیت مربوط به شاخه‌ای غیر از شاخه جاری. --follow-user USER دنبال کردن خودکار یک کاربر خاص توسط دوربین. --highlight-dirs برجسته کردن نام تمامی دایرکتوری‌ها. --highlight-user USER برجسته کردن نام یک کاربر خاص. --highlight-users برجسته کردن نام تمامی کاربران. --highlight-colour FFFFFF رنگ فونت کاربران برجسته‌شده در قالب هگزادسیمال. --selection-colour FFFFFF رنگ فونت کاربران و فایل‌های انتخاب‌شده. --filename-colour FFFFFF رنگ فونت نام فایل‌ها. --dir-colour FFFFFF رنگ فونت دایرکتوری‌ها. --dir-name-depth DEPTH رسم نام دایرکتوری‌ها تا عمق مشخصی از ساختار درخت. --dir-name-position FLOAT موقعیت قرارگیری نام دایرکتوری در امتداد لبه (عددی بین 0.1 تا 1.0، مقدار پیش‌فرض 0.5 است). --filename-time SECONDS مدت‌زمان نمایش نام فایل‌ها روی صفحه (بزرگ‌تر یا مساوی 2.0). --file-extensions تنها نمایش پسوند فایل‌ها. --file-extension-fallback استفاده از نام فایل به عنوان پسوند در صورت خالی یا ناموجود بودن پسوند. --file-filter REGEX فیلتر کردن و نادیده گرفتن مسیر فایل‌های منطبق بر عبارت باقاعده مشخص‌شده. --file-show-filter REGEX نمایش انحصاری مسیر فایل‌های منطبق بر عبارت باقاعده مشخص‌شده. --user-filter REGEX فیلتر کردن و نادیده گرفتن نام کاربران منطبق بر عبارت باقاعده مشخص‌شده. --user-show-filter REGEX نمایش انحصاری نام کاربران منطبق بر عبارت باقاعده مشخص‌شده. --user-image-dir DIRECTORY دایرکتوری حاوی تصاویر کاربران با قالب jpg. یا png. (مانند "Full Name.png") جهت استفاده به عنوان آواتار. --default-user-image IMAGE مسیر تصویر با فرمت jpg. برای استفاده به عنوان تصویر پیش‌فرض کاربر. --fixed-user-size ثابت نگه‌داشتن اندازه تصویر کاربر در تمام طول شبیه‌سازی. --colour-images رنگی کردن تصاویر کاربران. --crop AXIS برش نمای دید در امتداد یک محور (vertical یا horizontal). --padding FLOAT فاصله حاشیه (padding) نمای دوربین. --multi-sampling فعال‌سازی نمونه‌برداری چندگانه (Multi-sampling). --no-vsync غیرفعال‌سازی همگام‌سازی عمودی (V-Sync). --bloom-multiplier FLOAT تنظیم میزان افکت درخشش (Bloom). --bloom-intensity FLOAT تنظیم شدت افکت درخشش (Bloom). --max-files NUMBER تنظیم حداکثر تعداد فایل‌ها یا مقدار 0 برای نامحدود. فایل‌های مازاد دور ریخته خواهند شد. --max-file-lag SECONDS حداکثر زمان مجاز برای ظاهر شدن فایل‌های یک کامیت. برای حالت نامحدود از مقدار -1 استفاده کنید. --max-user-speed UNITS حداکثر سرعت جابه‌جایی کاربران بر حسب واحد در ثانیه. --user-friction SECONDS مدت‌زمان مورد نیاز برای متوقف شدن کامل کاربران. --user-scale SCALE تغییر مقیاس آواتار کاربران. --camera-mode MODE حالت دوربین (overview یا track). --disable-auto-rotate غیرفعال کردن چرخش خودکار دوربین. --disable-input غیرفعال کردن ورودی‌های صفحه‌کلید و ماوس. --hide DISPLAY_ELEMENT مخفی کردن یک یا چند مورد از عناصر نمایشی فهرست زیر: bloom - افکت درخشش date - تاریخ جاری dirnames - نام دایرکتوری‌ها files - آیکون‌های فایل‌ها filenames - نام فایل‌ها mouse - نشانگر ماوس progress - نوار پیشرفت root - دایرکتوری ریشه درخت tree - ساختار درختی متحرک users - آواتار کاربران usernames - نام کاربران عناصر چندگانه را با کاما جدا کنید (مانند "mouse,progress"). --hash-seed SEED تغییر مقدار بذر (seed) تابع درهم‌سازی. --caption-file FILE فایل زیرنویس/توضیحات (بخش قالب گزارش عنوان را ببینید). --caption-size SIZE اندازه عنوان. --caption-colour FFFFFF رنگ عنوان در قالب هگزادسیمال. --caption-duration SECONDS مدت‌زمان نمایش عنوان. --caption-offset X آفست افقی عنوان (0 برای وسط‌چین کردن عناوین). -o, --output-ppm-stream FILE خروجی دادن یک جریان تصویر PPM به یک فایل (برای خروجی استاندارد از '-' استفاده کنید). این گزینه به‌طور خودکار نوار پیشرفت را در ابتدا مخفی کرده و گزینه 'stop-at-end' را فعال می‌کند مگر اینکه رفتار دیگری مشخص شده باشد. -r, --output-framerate FPS نرخ فریم خروجی (25، 30، 60). همراه با --output-ppm-stream استفاده می‌شود. --output-custom-log FILE خروجی دادن یک فایل لاگ با قالب سفارشی (برای خروجی استاندارد از '-' استفاده کنید). --load-config CONFIG_FILE بارگذاری یک فایل پیکربندی. --save-config CONFIG_FILE ذخیره یک فایل پیکربندی حاوی گزینه‌های جاری. --path PATH path یک دایرکتوری کنترل نسخه پشتیبانی‌شده، یک فایل لاگ از پیش تولیدشده (دستورات لاگ یا قالب گزارش سفارشی را ببینید)، یک فایل پیکربندی Gource یا '-' جهت خواندن از STDIN. اگر مسیر مشخص نشود، gource تلاش می‌کند لاگ را از دایرکتوری جاری بخواند. مثال‌های Git، Bazaar، Mercurial و SVN مشاهده لاگ مخزن در مسیر جاری: gource مشاهده لاگ پروژه‌ای در دایرکتوری مشخص‌شده: gource my-project-dir برای پروژه‌های بزرگ، تولید لاگ تاریخچه پروژه ممکن است زمان زیادی ببرد. برای سیستم‌های کنترل نسخه متمرکز مانند SVN، تولید لاگ باعث بارگذاری روی سرور مرکزی می‌شود. در این موارد، ممکن است بخواهید یک نسخه از لاگ را برای استفاده‌های بعدی ذخیره کنید. می‌توانید با استفاده از گزینه --log-command VCS یک لاگ با قالب اختصاصی سیستم کنترل نسخه تولید کنید: cd my-svn-project `gource --log-command svn` > my-svn-project.log gource my-svn-project.log همچنین می‌توانید ترتیبی دهید که Gource یک نسخه از فایل لاگ را در قالب اختصاصی خود بنویسد: gource --output-custom-log my-project-custom.log پشتیبانی از CVS از 'cvs2cl' برای تولید لاگ استفاده کرده و سپس آن را به Gource ارسال کنید: cvs2cl --chrono --stdout --xml -g-q > my-cvs-project.log gource my-cvs-project.log قالب گزارش سفارشی (Custom Log Format) اگر می‌خواهید از Gource با سیستمی غیر از موارد پشتیبانی‌شده استفاده کنید، یک قالب گزارش سفارشی تفکیک‌شده با خط عمودی ('|') وجود دارد: timestamp - برچسب زمانی یونیکس یا ISO 8601 از زمان وقوع به‌روزرسانی. username - نام کاربری که به‌روزرسانی را انجام داده است. type - یک کاراکتر برای نوع به‌روزرسانی - (A)فزوده، (M)تغییر یا (D)حذف. file - مسیر فایل به‌روزشده. colour - رنگ فایل در قالب هگزادسیمال (FFFFFF). اختیاری. قالب گزارش عنوان (Caption Log Format) نرم‌افزار Gource می‌تواند با تعیین یک فایل عنوان (با استفاده از --caption-file) در قالب تفکیک‌شده با خط عمودی ('|') زیر، عناوین و زیرنویس‌ها را در طول خط زمانی نمایش دهد: timestamp - برچسب زمانی یونیکس یا ISO 8601 از زمان نمایش عنوان. caption - متن عنوان ضبط ویدیوها (Recording Videos) راهنمای صفحه خانگی را برای نمونه‌های ضبط ویدیو با Gource مشاهده کنید: https://github.com/acaudwell/Gource/wiki/Videos اطلاعات بیشتر (More Information) برای راهنماها و نمونه‌های استفاده از Gource با سیستم‌های مختلف کنترل نسخه، به صفحه خانگی Gource مراجعه کنید: http://gource.io رابط کاربری (INTERFACE) زمان نمایش‌داده‌شده در گوشه بالای سمت چپ صفحه در ابتدا از نخستین مدخل لاگ خوانده‌شده تنظیم می‌شود و بر اساس سرعت شبیه‌سازی (--seconds-per-day) افزایش می‌یابد. فشردن کلید SPACE در هر زمان شبیه‌سازی را متوقف/از سر می‌گیرد. در حالت توقف می‌توانید از ماوس برای بررسی جزئیات فایل‌ها و کاربران مجزا استفاده کنید. کلید TAB به ترتیب میان کاربران مرئی فعلی حرکت و آن‌ها را انتخاب می‌کند. حالت دوربین (ردیابی فعالیت‌ها یا نمایش کل درخت کد) را می‌توان با کلیک دکمه وسط ماوس تغییر داد. می‌توانید کلید چپ ماوس را برای کنترل دستی دوربین بکشید. کلید راست ماوس نمای دید را می‌چرخاند. دستورات تعاملی صفحه‌کلید: (V) تغییر حالت دوربین (C) نمایش لوگوی Gource (K) تغییر وضعیت راهنمای پسوند فایل‌ها (M) تغییر وضعیت نمایش نشانگر ماوس (N) پرش به جلو در زمان تا مدخل بعدی لاگ (S) تصادفی‌سازی رنگ‌ها (D) تغییر حالت نمایش نام دایرکتوری‌ها (F) تغییر حالت نمایش نام فایل‌ها (U) تغییر حالت نمایش نام کاربران (G) تغییر وضعیت نمایش کاربران (T) تغییر وضعیت نمایش یال‌های درخت دایرکتوری (R) تغییر وضعیت نمایش یال‌های دایرکتوری ریشه (<>) تنظیم مقیاس زمانی / سرعت حرکت آواتار کاربران (+-) تنظیم سرعت شبیه‌سازی (Keypad +-) تنظیم بزرگ‌نمایی دوربین (TAB) پیمایش میان کاربران مرئی (F12) تصویربرداری از صفحه (اسکرین‌شات) (Alt+Enter) تغییر وضعیت تمام‌صفحه (ESC) خروج نویسنده (AUTHOR) Written by Andrew Caudwell Project Homepage: http://gource.io حق نشر (COPYRIGHT) 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 . قدردانی‌ها (ACKNOWLEDGEMENTS) Catalyst IT (catalyst.net.nz) جهت حمایت از توسعه Gource! Gource(1)