git-add - آنلاین در ابر

برنامه:

نام

git-add - محتویات فایل را به فهرست اضافه کنید

خلاصه

دستگاه گوارش اضافه کردن [--مختلف | -v] [--dry-run | -n] [--نیروی | -f] [--تعاملی | -i] [--patch | -پ]
[--ویرایش | -e] [--[نه-]همه | --[نه-]نادیده-حذف | [--به روز رسانی | -u]]
[--intent-to-add | -N] [--بازخوانی] [--نادیده-اشتباهات] [--نادیده-نگام شده]
[--] [ ...]

شرح

این دستور با استفاده از محتوای فعلی موجود در درخت کار، ایندکس را به روز می کند
محتوای مرحله‌بندی شده را برای کامیت بعدی آماده کنید. معمولاً محتوای فعلی را اضافه می کند
مسیرهای موجود به طور کلی، اما با برخی از گزینه ها می توان از آن برای افزودن محتوا نیز استفاده کرد
تنها بخشی از تغییرات ایجاد شده در فایل‌های درخت کاری اعمال می‌شود یا مسیرهایی را که انجام می‌دهند حذف کنید
دیگر در درخت کار وجود ندارد.

"شاخص" یک عکس فوری از محتوای درخت کار نگه می دارد و این همان عکس فوری است.
که به عنوان محتوای commit بعدی در نظر گرفته می شود. بنابراین پس از ایجاد هر گونه تغییر در
درخت کار می کند و قبل از اجرای دستور commit باید از دستور add برای افزودن استفاده کنید
هر فایل جدید یا اصلاح شده در فهرست

این دستور می تواند چندین بار قبل از یک commit انجام شود. فقط محتوای آن را اضافه می کند
فایل(های) مشخص شده در زمان اجرای دستور add. اگر تغییرات بعدی را می خواهید
در commit بعدی گنجانده شده است، سپس باید git add را دوباره اجرا کنید تا محتوای جدید را به آن اضافه کنید
شاخص.

دستور git status را می توان برای به دست آوردن خلاصه ای از فایل هایی که دارای تغییراتی هستند استفاده کرد
برای کامیت بعدی صحنه سازی می شوند.

دستور git add فایل های نادیده گرفته شده را به طور پیش فرض اضافه نمی کند. اگر هر فایل نادیده گرفته شده بود
به صراحت در خط فرمان مشخص شده است، git add با لیستی از فایل های نادیده گرفته شده با شکست مواجه می شود.
فایل های نادیده گرفته شده با بازگشت دایرکتوری یا globbing نام فایل انجام شده توسط Git (نقل قول
globs شما قبل از پوسته) بی سر و صدا نادیده گرفته خواهد شد. در دستگاه گوارش اضافه کردن می توان از دستور استفاده کرد
فایل های نادیده گرفته شده را با گزینه -f (force) اضافه کنید.

لطفا git-commit(1) برای راه های جایگزین برای افزودن محتوا به یک commit.

OPTIONS

...
فایل هایی برای افزودن محتوا از. Fileglobs (به عنوان مثال *.c) را می توان برای افزودن همه موارد تطبیق داده شد
فایل ها. همچنین یک نام دایرکتوری پیشرو (به عنوان مثال dir برای اضافه کردن dir/file1 و dir/file2) می تواند باشد
برای به روز رسانی فهرست برای مطابقت با وضعیت فعلی فهرست به عنوان یک کل داده می شود (مثلاً
مشخص کردن dir نه فقط یک فایل dir/file1 را که در درخت کاری اصلاح شده است، ضبط می کند
فایل dir/file2 به درخت کار اضافه شد، اما یک فایل dir/file3 نیز از آن حذف شد
درخت کار توجه داشته باشید که نسخه‌های قدیمی Git فایل‌های حذف شده را نادیده می‌گرفتند. استفاده کنید
اگر می‌خواهید فایل‌های اصلاح‌شده یا جدید را اضافه کنید اما فایل‌های حذف شده را نادیده بگیرید، گزینه --no-all.

-n، --dry-run
در واقع فایل(ها) را اضافه نکنید، فقط نشان دهید که آیا وجود دارند و/یا نادیده گرفته خواهند شد.

-v، -- پرحرف
پرحرف باشید

-f، -- نیرو
اجازه اضافه کردن فایل های نادیده گرفته شده را بدهید.

-i، --تعاملی
محتوای اصلاح شده در درخت کار را به صورت تعاملی به فهرست اضافه کنید. مسیر اختیاری
ممکن است آرگومان هایی برای محدود کردن عملیات به زیر مجموعه ای از درخت کار ارائه شود. دیدن
"حالت تعاملی" برای جزئیات.

-p، --patch
به صورت تعاملی تکه‌هایی از پچ را بین فهرست و درخت کار انتخاب کرده و آنها را اضافه کنید
به شاخص این به کاربر فرصتی می دهد تا قبل از اضافه کردن، تفاوت را بررسی کند
محتوای اصلاح شده در فهرست

این به طور موثر add --interactive را اجرا می کند، اما منوی دستور اولیه و را دور می زند
مستقیماً به دستور فرعی Patch می پرد. برای جزئیات به "حالت تعاملی" مراجعه کنید.

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

هدف این گزینه انتخاب و انتخاب خطوط پچ برای اعمال یا حتی انتخاب است
برای اصلاح محتویات خطوطی که باید مرحله بندی شوند. این می تواند سریعتر و انعطاف پذیرتر باشد
نسبت به استفاده از انتخابگر تعاملی hunk. با این حال، به راحتی می توان خود را گیج کرد و
یک وصله ایجاد کنید که روی ایندکس اعمال نمی شود. ویرایش پچ ها را در زیر ببینید.

-u، --به روز رسانی
فهرست را درست در جایی که از قبل دارای تطبیق ورودی است، به روز کنید . این حذف می کند
و همچنین ورودی های فهرست را برای مطابقت با درخت کار تغییر می دهد، اما هیچ فایل جدیدی اضافه نمی کند.

اگر نه هنگامی که از گزینه -u استفاده می شود، تمام فایل های ردیابی شده در کل استفاده می شود
درخت کار به روز می شود (نسخه های قدیمی Git برای محدود کردن به روز رسانی به فعلی استفاده می شود
دایرکتوری و زیر شاخه های آن).

-A، --همه، --بدون چشم پوشی-حذف
ایندکس را نه تنها در جایی که درخت کار دارای یک تطبیق فایل است، به روز کنید ولی
همچنین جایی که شاخص قبلاً یک ورودی دارد. این فهرست را اضافه، اصلاح و حذف می کند
ورودی هایی برای مطابقت با درخت کار.

اگر نه زمانی داده می شود که از گزینه -A استفاده می شود، همه فایل ها در کل درخت کار
به روز می شوند (نسخه های قدیمی Git برای محدود کردن به روز رسانی به فهرست فعلی و
زیر شاخه های آن).

--no-all، --نادیده گرفتن-حذف
با افزودن فایل‌های جدید ناشناخته به فهرست و فایل‌های اصلاح‌شده، فهرست را به‌روزرسانی کنید
در درخت کاری، اما فایل هایی که از درخت کاری حذف شده اند را نادیده بگیرید.
این گزینه در صورت عدم امکان عملیاتی نیست استفاده می شود.

این گزینه در درجه اول برای کمک به کاربرانی است که به نسخه های قدیمی Git عادت دارند
"git add ...» مترادف «git add --no-all» بود ...»، یعنی
فایل های حذف شده را نادیده گرفت.

-N، --intent-to-add
فقط این واقعیت را ثبت کنید که مسیر بعداً اضافه خواهد شد. یک ورودی برای مسیر است
بدون محتوا در فهرست قرار داده شده است. این برای نشان دادن، از جمله موارد دیگر، مفید است
محتوای بدون مرحله این گونه فایل ها با git diff و commit کردن آنها با git commit
-آ.

--تازه کردن
فایل(ها) را اضافه نکنید، بلکه فقط اطلاعات stat() آنها را در فهرست بازخوانی کنید.

--نادیده گرفتن-خطاها
اگر برخی از فایل‌ها به دلیل خطا در نمایه‌سازی آن‌ها اضافه نشدند، آن را لغو نکنید
عملیات، اما به اضافه کردن بقیه ادامه دهید. فرمان همچنان باید با غیر صفر خارج شود
وضعیت متغیر پیکربندی add.ignoreErrors را می توان روی true تنظیم کرد تا این مورد ایجاد شود
رفتار پیش فرض

--نادیده گرفتن-غایب
این گزینه را فقط می توان همراه با --dry-run استفاده کرد. با استفاده از این گزینه کاربر
می تواند بررسی کند که آیا هر یک از فایل های داده شده نادیده گرفته می شود، مهم نیست که قبلاً هستند یا خیر
در درخت کار وجود دارد یا نه.

--
از این گزینه می توان برای جدا کردن گزینه های خط فرمان از لیست فایل ها استفاده کرد.
(زمانی که نام فایل ممکن است با گزینه های خط فرمان اشتباه گرفته شود مفید است).

پیکربندی

متغیر پیکربندی اختیاری core.excludesFile مسیری به یک فایل را نشان می دهد
حاوی الگوهایی از نام فایل برای حذف از git-add، مشابه
$GIT_DIR/info/exclude. الگوهای موجود در فایل exclude علاوه بر الگوهای موجود در فایل استفاده می شود
اطلاعات / حذف دیدن gitignore(5).

مثال ها

· محتوا را از همه فایل های *.txt در فهرست اسناد و آن اضافه می کند
زیر شاخه ها:

$ git اضافه کردن Documentation/\*.txt

توجه داشته باشید که ستاره * از پوسته در این مثال نقل شده است. این اجازه می دهد تا
دستور شامل فایل های زیر شاخه های Documentation/ Director است.

· اضافه کردن محتوا از همه اسکریپت های git-*.sh را در نظر می گیرد:

$ git اضافه کردن git-*.sh

زیرا این مثال به پوسته اجازه می‌دهد ستاره را گسترش دهد (یعنی شما در حال لیست کردن ستاره هستید
فایل ها به صراحت)، subdir/git-foo.sh را در نظر نمی گیرد.

در ارتباط بودن MODE

هنگامی که فرمان وارد حالت تعاملی می شود، خروجی را نشان می دهد وضعیت
فرمان فرعی، و سپس وارد حلقه فرمان تعاملی خود می شود.

حلقه فرمان لیستی از دستورات فرعی موجود را نشان می دهد و یک اعلان "What now>" می دهد.
به طور کلی، زمانی که اعلان با یک تک به پایان می رسد >، شما می توانید تنها یکی از گزینه ها را انتخاب کنید
داده شده و return را تایپ کنید، مانند این:

*** دستورات ***
1: وضعیت 2: به روز رسانی 3: برگرداندن 4: اضافه کردن ردیابی نشده
5: پچ 6: تفاوت 7: خروج 8: کمک
الان چی > 1

شما همچنین می توانید s یا sta یا status را در بالا بگویید تا زمانی که انتخاب منحصر به فرد باشد.

حلقه فرمان اصلی دارای 6 فرمان فرعی (به علاوه کمک و خروج) است.

وضعیت
این تغییر بین HEAD و index را نشان می دهد (یعنی اگر بگویید چه چیزی متعهد می شود
git commit)، و بین ایندکس و فایل های درخت کاری (یعنی آنچه می توانید مرحله بندی کنید
قبل از git commit با استفاده از git add) برای هر مسیر. یک نمونه خروجی به نظر می رسد
این:

مسیر بدون صحنه صحنه سازی شده
1: باینری هیچ چیز foo.png
2: +403/-35 +1/-1 git-add--interactive.perl

نشان می‌دهد که foo.png تفاوت‌هایی با HEAD دارد (اما باینری است بنابراین تعداد خطوط
نمی توان نشان داد) و هیچ تفاوتی بین کپی نمایه شده و درخت کار وجود ندارد
نسخه (اگر نسخه درخت کار نیز متفاوت بود، دوتایی نشان داده می شد
در محل هیچ چی). فایل دیگر git-add--interactive.perl دارای 403 خط اضافه شده است
و 35 خط حذف می شود اگر آنچه در ایندکس وجود دارد را متعهد کنید، اما فایل درختی کار دارد
تغییرات بیشتر (یک اضافه و یک حذف).

به روز رسانی
این اطلاعات وضعیت را نشان می دهد و یک اعلان "Update>>" صادر می کند. هنگامی که اعلان
با دو به پایان می رسد >>، می توانید بیش از یک انتخاب، الحاق با
فضای خالی یا کاما همچنین می توانید محدوده ها را بگویید. به عنوان مثال "2-5 7,9" برای انتخاب 2,3,4,5,7,9،XNUMX،XNUMX،XNUMX،XNUMX،XNUMX
از لیست اگر عدد دوم در یک محدوده حذف شود، همه وصله‌های باقی‌مانده هستند
گرفته شده. به عنوان مثال "7-" برای انتخاب 7,8,9،XNUMX،XNUMX از لیست. می توانی بگویی * برای انتخاب همه چیز

سپس آنچه را که انتخاب کرده اید برجسته می شود *، مثل این:

مسیر بدون صحنه صحنه سازی شده
1: باینری هیچ چیز foo.png
* 2: +403/-35 +1/-1 git-add--interactive.perl

برای حذف انتخاب، پیشوند ورودی را با - مانند زیر وارد کنید:

به روز رسانی >> -2

پس از انتخاب، با یک خط خالی پاسخ دهید تا محتوای کار مرحله بندی شود
فایل های درختی برای مسیرهای انتخاب شده در فهرست.

برگرداندن
این رابط کاربری بسیار مشابهی دارد به روز رسانیو اطلاعات مرحله بندی شده برای مسیرهای انتخاب شده
به نسخه HEAD برگردانده می شوند. بازگرداندن مسیرهای جدید باعث می‌شود که آنها ردیابی نشوند.

ردیابی نشده اضافه کنید
این رابط کاربری بسیار مشابهی دارد به روز رسانی و برگرداندن، و به شما امکان می دهد مسیرهای ردیابی نشده را به آن اضافه کنید
شاخص

وصله
این به شما امکان می دهد یک مسیر از a را انتخاب کنید وضعیت مانند انتخاب پس از انتخاب مسیر،
تفاوت بین ایندکس و فایل درخت کار را نشان می دهد و از شما می پرسد که آیا شما
می‌خواهم تغییر هر کدام را به صحنه ببرم. می توانید یکی از گزینه های زیر را انتخاب کنید و
نوع بازگشت:

y - مرحله این قطعه
n - این هنک را صحنه سازی نکنید
q - ترک این قطعه یا هیچ یک از موارد باقی مانده را صحنه سازی نکنید
الف - مرحله این هانک و تمام هانک های بعدی در فایل
د - این هانک یا هر کدام از هانک های بعدی فایل را مرحله بندی نکنید
g - یک قسمت را برای رفتن انتخاب کنید
/ - جستجوی یک قطعه مطابق با regex داده شده
j - این هانک را بلاتکلیف رها کنید، به هانک بلاتکلیف بعدی نگاه کنید
ج - این قطعه را بلاتکلیف رها کنید، قسمت بعدی را ببینید
k - این هانک را بلاتکلیف رها کنید، به هانک بلاتکلیف قبلی مراجعه کنید
ک - این هانک را بلاتکلیف رها کنید، به هانک قبلی مراجعه کنید
s - قسمت فعلی را به قطعات کوچکتر تقسیم کنید
e - به صورت دستی قطعه فعلی را ویرایش کنید
? - کمک چاپ

پس از تعیین سرنوشت برای همه هنک ها، اگر هانکی انتخاب شده باشد، ایندکس
با قطعات انتخاب شده به روز می شود.

شما می توانید با تنظیم متغیر پیکربندی نیاز به تایپ بازگشت را در اینجا حذف کنید
interactive.singleKey به true.

تفاوت
این به شما امکان می دهد آنچه را که متعهد می شود (یعنی بین HEAD و index) مرور کنید.

ویرایش صفحات

فراخوانی git add -e یا انتخاب e از انتخابگر تعاملی hunk یک پچ را در آن باز می کند
ویرایشگر شما؛ پس از خروج ویرایشگر، نتیجه بر روی ایندکس اعمال می شود. شما آزادید که
تغییرات دلخواه را در پچ انجام دهید، اما توجه داشته باشید که برخی از تغییرات ممکن است گیج کننده باشند
نتایج، یا حتی منجر به ایجاد یک وصله که قابل اعمال نیست. اگر می خواهید سقط کنید
عملیات به طور کامل (یعنی مرحله هیچ چیز جدیدی در ایندکس نیست)، به سادگی تمام خطوط را حذف کنید
پچ لیست زیر برخی از چیزهای رایجی را که ممکن است در یک پچ ببینید و کدام را توضیح می دهد
عملیات ویرایش روی آنها معنا پیدا می کند.

محتوای اضافه شده
محتوای اضافه شده با خطوطی که با "+" شروع می شود نشان داده می شود. شما می توانید از مرحله بندی هر کدام جلوگیری کنید
خطوط اضافه با حذف آنها.

محتوای حذف شده
محتوای حذف شده با خطوطی که با "-" شروع می شوند نشان داده می شود. می توانید از مرحله بندی جلوگیری کنید
حذف آنها با تبدیل "-" به " " (فضا).

محتوای اصلاح شده
محتوای اصلاح شده با خطوط "-" (حذف محتوای قدیمی) و به دنبال آن نشان داده می شود
خطوط "+" (اضافه کردن محتوای جایگزین). می توانید از مرحله بندی اصلاح جلوگیری کنید
با تبدیل خطوط "-" به " "، و حذف خطوط "+". مراقب باشید که فقط اصلاح
نیمی از این جفت احتمالاً تغییرات گیج کننده ای را در شاخص ایجاد می کنند.

همچنین عملیات پیچیده تری نیز وجود دارد که می توان انجام داد. اما مراقب باشید که زیرا
پچ فقط به شاخص اعمال می شود و نه درخت کار، درخت کار ظاهر می شود
برای "لغو" تغییر در شاخص. به عنوان مثال، وارد کردن یک خط جدید به ایندکس که
نه در HEAD است و نه درخت کاری خط جدید را برای commit استیج نمی کند، اما
به نظر می رسد که خط در درخت کار برگردانده شده است.

از استفاده از این ساختارها خودداری کنید یا این کار را با احتیاط شدید انجام دهید.

حذف محتوای دست نخورده
ممکن است محتوایی که بین شاخص و درخت کار تفاوتی ندارد نشان داده شود
خطوط زمینه، با یک " " (فضا) شروع می شود. می توانید خطوط زمینه را برای حذف مرحله بندی کنید
با تبدیل فاصله به "-". در نتیجه فایل درختی کار ظاهر می شود
مطالب را دوباره اضافه کنید

اصلاح محتوای موجود
همچنین می توان خطوط زمینه را با قرار دادن آنها برای حذف (با تبدیل " " به
"-") و افزودن یک خط "+" با محتوای جدید. به طور مشابه، می توان خطوط "+" را تغییر داد
برای اضافات یا اصلاحات موجود در همه موارد، اصلاح جدید خواهد بود
به نظر می رسد در درخت کار برگردانده شده است.

مطالب جدید
همچنین می توانید محتوای جدیدی را که در پچ وجود ندارد اضافه کنید. به سادگی خطوط جدید اضافه کنید،
هر کدام با "+" شروع می شوند. اضافه شده در درخت کار برگردانده شده ظاهر می شود.

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

· اضافه کردن زمینه ("") یا حذف ("-") خطوط

· حذف زمینه یا خطوط حذف

· اصلاح محتویات زمینه یا خطوط حذف

با استفاده از خدمات onworks.net از git-add آنلاین استفاده کنید