git-hub - Trực tuyến trên Đám mây

CHƯƠNG TRÌNH:

TÊN

git-hub - Giao diện dòng lệnh Git tới GitHub

TỔNG HỢP

git trung tâm [tùy chọn toàn cầu] [tùy chọn] [đối số]

MÔ TẢ

git trung tâm là một giao diện dòng lệnh đơn giản cho github, cho phép hầu hết các tác vụ GitHub hữu ích
(như tạo và liệt kê các vấn đề hoặc yêu cầu kéo) được truy cập trực tiếp thông qua git
dòng lệnh.

Để sử dụng lệnh này, bạn có thể cần phải tạo cấu hình ban đầu để có được
ủy quyền từ GitHub. Để làm điều này, bạn có thể sử dụng thiết lập chỉ huy. Xem
CẤU HÌNH để biết thêm các tùy chọn cấu hình.

GLOBAL LỰA CHỌN

-NS, --Cứu giúp
Hiển thị trợ giúp này và thoát.

--phiên bản
Hiển thị số phiên bản của chương trình và thoát.

-v, --dài dòng
Chi tiết hơn (có thể được chỉ định nhiều lần để có thêm chi tiết)

-S, --im lặng
Ít dài dòng hơn (có thể được chỉ định nhiều lần để bớt dài dòng hơn)

HÀNG

thiết lập Lệnh này thực hiện thiết lập ban đầu để kết nối với GitHub. Về cơ bản nó yêu cầu
GitHub cho một mã thông báo ủy quyền và lưu trữ nó trong biến cấu hình
trung tâm.oauthtoken để sử dụng trong tương lai, do đó bạn không cần phải nhập mật khẩu của mình mỗi lần (hoặc
lưu trữ nó trong cấu hình). Tên người dùng cũng được lưu trữ để sử dụng trong tương lai
hub.tên người dùng Biến đổi. Nếu URL cơ sở được chỉ định, nó sẽ được lưu trữ trong trung tâm.baseurl
quá.

-u TÊN TÀI KHOẢN, --username = USERNAME
Tên người dùng (tên đăng nhập) của GitHub, sẽ được lưu trữ trong biến cấu hình
hub.tên người dùng. Nếu một e-mail được cung cấp, thì một tên người dùng phù hợp với e-mail đó
sẽ được tìm kiếm và sử dụng thay thế, nếu được tìm thấy (để điều này hoạt động, e-mail
phải là một phần của hồ sơ công khai).

-p MẬT KHẨU MỞ KHÓA, --password = MẬT KHẨU
Mật khẩu của GitHub (sẽ không được lưu trữ).

-b url, --baseurl = URL
URL cơ sở của GitHub để sử dụng để truy cập API. Đặt điều này khi bạn API GitHub là
ở một vị trí khác với vị trí mặc định (Máy chủ doanh nghiệp thường sử dụng
https://host/api/v3).

--toàn cầu
Lưu trữ cài đặt trong cấu hình chung (xem tùy chọn --global trong git
cấu hình(1) để biết chi tiết).

--hệ thống
Lưu trữ cài đặt trong cấu hình hệ thống (xem - tùy chọn hệ thống trong git
cấu hình(1) để biết chi tiết).

nhân bản REPO [ĐIỂM]
Lệnh này được sử dụng để sao chép REPO, một kho lưu trữ GitHub, điểm đến thư mục
(mặc định là tên của dự án được nhân bản). Nếu kho lưu trữ được chỉ định
in / hình thức, REPO sẽ được sử dụng làm ngược dòng và một ngã ba cá nhân
sẽ được tra cứu. Nếu không tìm thấy, một nhánh mới sẽ được tạo. Trong cả hai trường hợp,
fork sẽ được nhân bản thay vì kho lưu trữ ngược dòng.

giá như được chỉ định là REPO, sau đó là cấu hình hub.tên người dùng được sử dụng
as và kho lưu trữ mẹ được tra cứu trên GitHub để xác định
kho lưu trữ ngược dòng.

Kho lưu trữ ngược dòng cũng được thêm vào dưới dạng điều khiển từ xa theo tên Thượng nguồn (trừ khi
- hình tam giác được sử dụng, trong trường hợp đó điều khiển từ xa được gọi là ngã ba theo mặc định) và
trung tâm.upstream biến cấu hình được đặt (xem CẤU HÌNH), trừ khi chỉ
đã được sử dụng và kho lưu trữ kết quả không thực sự là một ngã ba, trong trường hợp đó
không thể tự động xác định kho lưu trữ ngược dòng.

-r TÊN, --remote = NAME
Sử dụng TÊN làm tên kho lưu trữ từ xa ngược dòng thay vì tên mặc định
('ngã ba' nếu - hình tam giác được sử dụng, "ngược dòng" nếu không).

-NS, - hình tam giác
Sử dụng Git's hình tam giác quy trình làm việc cấu hình. Tùy chọn này sao chép từ
kho lưu trữ cha mẹ / ngược dòng thay vì sao chép fork và thêm fork dưới dạng
một kho lưu trữ từ xa. Sau đó đặt điều khiển từ xa.pushdefault Tùy chọn Git và
hub.forkremote tùy chọn git-hub đến ngã ba.

Tác động của việc này khiến kho lưu trữ ngược dòng được sử dụng theo mặc định khi bạn
kéo nhưng sử dụng nĩa của bạn khi bạn đẩy, đó thường là những gì bạn muốn
khi sử dụng các yêu cầu kéo của GitHub.

Git phiên bản 1.8.3 hoặc mới hơn là cần thiết để sử dụng tùy chọn này (và 1.8.4 hoặc mới hơn
được khuyến nghị do một số vấn đề trong 1.8.3 liên quan đến điều này).

Tùy chọn này có thể trở thành tùy chọn mặc định trong tương lai. Để đặt nó làm mặc định
bạn có thể đặt tùy chọn trung tâm.triangular. Thấy CẤU HÌNH để biết thêm chi tiết.

GIT DÒNG VÔ TÍNH LỰA CHỌN
Bất kỳ tiêu chuẩn nào git nhân bản tùy chọn có thể được thông qua. Không phải tất cả chúng đều có thể làm
cảm giác khi sao chép repo GitHub được sử dụng với công cụ này.

vấn đề Lệnh này được sử dụng để quản lý các vấn đề GitHub thông qua một tập hợp các lệnh con. Không
lệnh con được chỉ định, Được sử dụng.

Hiển thị danh sách các vấn đề đang mở.

-NS, - đóng cửa
Thay vào đó, hãy hiển thị các vấn đề đã đóng.

-NS, --được tạo bởi tôi
Chỉ hiển thị các vấn đề do tôi tạo ra

-MỘT, --Giao cho tôi
Chỉ hiển thị các vấn đề được giao cho tôi

hiển thị VẤN ĐỀ [PHÁT HÀNH ...]
Hiển thị các vấn đề được xác định bởi VẤN ĐỀ.

mới Tạo một vấn đề mới.

-m Bột ngọt, --message = MSG
Tên vấn đề (và mô tả). Dòng đầu tiên được sử dụng làm vấn đề
tiêu đề và bất kỳ văn bản nào sau một dòng trống được sử dụng làm phần nội dung tùy chọn.
Nếu tùy chọn này không được sử dụng, mặc định GIT_EDITOR được mở ra để viết
một.

-l NHÃN MÁC, --label = LABEL
Đính kèm LABEL vấn đề (có thể được chỉ định nhiều lần để đặt
nhiều nhãn).

-a NGƯỜI SỬ DỤNG, --assign = USER
Chỉ định một người dùng cho vấn đề. USER phải là tên đăng nhập GitHub hợp lệ.

-M ID, --milestone = ID
Gán cột mốc được xác định bởi ID số cho vấn đề.

cập nhật VẤN ĐỀ
Tương tự như mới nhưng cập nhật một vấn đề hiện có được xác định bởi VẤN ĐỀ.

Một phím tắt thuận tiện để đóng một vấn đề được cung cấp bởi gần lệnh phụ.

-m Bột ngọt, --message = MSG
Tiêu đề vấn đề mới (và mô tả). Dòng đầu tiên được sử dụng làm
tiêu đề vấn đề và bất kỳ văn bản nào sau một dòng trống được sử dụng làm tùy chọn
thân hình.

-e, --chỉnh sửa tin nhắn
Mở mặc định GIT_EDITOR để chỉnh sửa tiêu đề hiện tại (và
Mô tả vấn đề.

-ồ, --mở ra
Mở lại sự cố.

-NS, --gần
Đóng vấn đề.

-l NHÃN MÁC, --label = LABEL
Nếu một hoặc nhiều nhãn được chỉ định, chúng sẽ thay thế hiện tại
phát hành nhãn. Nếu không thì các nhãn không thay đổi. Nếu một trong những
nhãn trống, nhãn sẽ bị xóa (vì vậy bạn có thể sử dụng -l '' đến
xóa nhãn của một vấn đề.

-a NGƯỜI SỬ DỤNG, --assign = USER
Chỉ định một người dùng cho vấn đề. USER phải là tên đăng nhập GitHub hợp lệ.

-M ID, --milestone = ID
Gán cột mốc được xác định bởi ID số cho vấn đề.

bình luận VẤN ĐỀ
Thêm nhận xét mới cho một vấn đề hiện có được xác định bởi VẤN ĐỀ.

-m Bột ngọt, --message = MSG
Bình luận để được thêm vào vấn đề. Nếu tùy chọn này không được sử dụng,
mặc định GIT_EDITOR được mở để viết bình luận.

gần VẤN ĐỀ
Bí danh cho cập nhật --gần. (+ bình luận if --thông điệp or --chỉnh sửa tin nhắn is
được chỉ định). Đóng vấn đề được xác định bởi VẤN ĐỀ.

-m Bột ngọt, --message = MSG
Thêm nhận xét vào vấn đề trước khi đóng nó.

-e, --chỉnh sửa tin nhắn
Mở mặc định GIT_EDITOR viết một bình luận để được thêm vào
vấn đề trước khi đóng nó.

kéo Lệnh này được sử dụng để quản lý các yêu cầu kéo GitHub. Kể từ khi yêu cầu kéo trong GitHub
cũng là các vấn đề, hầu hết các lệnh con được lặp lại từ vấn đề lệnh cho
sự tiện lợi. Chỉ và mới các lệnh thực sự khác nhau và đính kèm và
nổi loạn được thêm.

Hiển thị danh sách các yêu cầu kéo đang mở.

- đóng cửa
Thay vào đó, hãy hiển thị các yêu cầu kéo đã đóng.

hiển thị KÉO [SỰ LÔI KÉO ...]
Bí danh cho vấn đề hiển thị.

thanh toán KÉO hữu ích. Cảm ơn !
Kiểm tra nhánh từ xa (đầu) của yêu cầu kéo. Lệnh này đầu tiên
lấy cái đầu tham chiếu từ yêu cầu kéo và sau đó gọi tiêu chuẩn
git thanh toán lệnh và bất kỳ đối số bổ sung nào sẽ được chuyển đến git thanh toán
nguyên trạng, sau khi tham chiếu vừa được tìm nạp. Hãy nhớ điều này tạo ra một
thanh toán tách rời theo mặc định, sử dụng -b nếu bạn muốn tạo một chi nhánh mới
dựa trên yêu cầu kéo. Mời các bạn xem qua git thanh toán giúp đỡ để biết thêm
chi tiết.

mới [CÁI ĐẦU]
Tạo một yêu cầu kéo mới. Nếu như TRỤ được chỉ định, nó sẽ được sử dụng làm
chi nhánh (hoặc git ref) nơi các thay đổi của bạn được triển khai. Nếu không
nhánh hiện tại được sử dụng. Nếu nhánh được sử dụng làm đầu không được đẩy đến
điều khiển từ xa, một lần đẩy sẽ được tự động thực hiện trước khi tạo lực kéo
yêu cầu.

Kho lưu trữ để đưa ra yêu cầu kéo từ được lấy từ trung tâm.forkrepo
cấu hình, mặc định là hub.username / dự án phần>.

-m Bột ngọt, --message = MSG
Kéo tiêu đề yêu cầu (và mô tả). Dòng đầu tiên được sử dụng làm
kéo tiêu đề yêu cầu và bất kỳ văn bản nào sau một dòng trống được sử dụng làm
cơ thể tùy chọn. Nếu tùy chọn này không được sử dụng, mặc định GIT_EDITOR is
đã mở. Nếu chi nhánh HEAD có mô tả phù hợp (xem git địa điể̀m chọn lựa
--Chỉnh sửa Mô tả), mô tả đó sẽ được sử dụng làm mặc định
thông báo trong trình chỉnh sửa và nếu không, thông báo của lần cam kết cuối cùng sẽ
được sử dụng thay thế.

-b CƠ SỞ, --base = BASE
Chi nhánh (hoặc git ref) mà bạn muốn các thay đổi của mình được đưa vào. Theo mặc định,
chi nhánh theo dõi (chi nhánh. .merge biến cấu hình) được sử dụng
hoặc cấu hình trung tâm.pullbase nếu không theo dõi một chi nhánh từ xa. Nếu như
không có gì hiện tại, nó mặc định là chủ. Kho lưu trữ để sử dụng làm
cơ sở được lấy từ trung tâm.upstream cấu hình.

-c TÊN, --create-branch = NAME
Tạo một chi nhánh từ xa mới với (với tên TÊN) là người đứng đầu thực sự cho
yêu cầu kéo thay vì sử dụng tên HEAD được chuyển thành TRỤ. Điều này
rất hữu ích để tạo một yêu cầu kéo cho một bản sửa lỗi nóng mà bạn đã cam kết
HEAD thông thường của bạn mà không cần tạo chi nhánh trước.

-NS, --lực đẩy
Buộc các hoạt động đẩy. Sử dụng cẩn thận!

đính kèm VẤN ĐỀ [CÁI ĐẦU]
Chuyển đổi vấn đề được xác định bởi VẤN ĐỀ cho một yêu cầu kéo bằng cách đính kèm các cam kết
với nó. Chi nhánh (hoặc git ref) nơi các thay đổi của bạn được triển khai có thể được
được chỉ định tùy chọn với TRỤ (nếu không thì nhánh hiện tại được sử dụng). Cái này
lệnh con rất giống với mới mệnh lệnh phụ, vui lòng tham khảo nó cho
biết thêm chi tiết.

Xin lưu ý rằng bạn chỉ có thể đính kèm cam kết cho các vấn đề nếu bạn có quyền truy cập cam kết
vào kho lưu trữ hoặc nếu bạn được chỉ định vấn đề.

-m Bột ngọt, --message = MSG
Thêm nhận xét vào vấn đề / yêu cầu kéo mới.

-e, --chỉnh sửa tin nhắn
Mở mặc định GIT_EDITOR viết một bình luận để được thêm vào
vấn đề / yêu cầu kéo mới. Thông báo mặc định được lấy từ
--thông điệp tùy chọn nếu có, nếu không thì mô tả chi nhánh hoặc
thông báo cam kết đầu tiên được sử dụng như với mới lệnh phụ.

-b CƠ SỞ, --base = BASE
Nhánh cơ sở đưa ra yêu cầu kéo. Nếu tùy chọn này không
hiện tại, sau đó nhánh cơ sở được lấy từ cấu hình
trung tâm.pullbase (hoặc chỉ chủ nếu cấu hình đó không có
một trong hai). Kho lưu trữ để sử dụng làm cơ sở được lấy từ
trung tâm.upstream cấu hình.

-c TÊN, --create-branch = NAME
Tạo một chi nhánh từ xa mới với (với tên TÊN) là người đứng đầu thực sự cho
yêu cầu kéo thay vì sử dụng tên HEAD được chuyển thành TRỤ. Điều này
rất hữu ích để tạo một yêu cầu kéo cho một bản sửa lỗi nóng mà bạn đã cam kết
HEAD thông thường của bạn mà không cần tạo chi nhánh trước.

-NS, --lực đẩy
Buộc các hoạt động đẩy. Sử dụng cẩn thận!

nổi loạn KÉO
Đóng một yêu cầu kéo được xác định bởi KÉO bằng cách phục hồi chi nhánh cơ sở của nó
(được chỉ định trong yêu cầu kéo) thay vì hợp nhất như của GitHub đi Nút ™
sẽ làm.

Nếu hoạt động thành công, một bình luận sẽ được đăng để thông báo về
HEAD cam kết của chi nhánh đã được phục hồi và yêu cầu kéo sẽ được
khép kín.

Loại URL được sử dụng để tìm nạp và đẩy có thể được chỉ định thông qua
trung tâm.pullurltype biến cấu hình (xem CẤU HÌNH để biết thêm chi tiết).
Lý tưởng nhất là bản sao làm việc của bạn nên giữ nguyên, nếu mọi thứ suôn sẻ.

Các hoạt động được thực hiện bởi lệnh con này gần như sau:

1. kho chứa git

2. tìm nạp git đầu kéo

3. kiểm tra git -b tmp FETCH_HEAD

4. git pull --rebase cơ sở kéo

5. đẩy git cơ sở kéo

6. thanh toán git người già

7. git chi nhánh -D tmp

8. git stash pop

If trung tâm.forcerebase được đặt thành "true" (mặc định), --lực lượng sẽ được chuyển cho
rebase (không nên nhầm lẫn với tùy chọn lệnh này --lực đẩy cái nào sẽ
buộc đẩy), ngược lại (nếu là "false") thì một rebase thông thường được thực hiện.
Khi rebase bị ép buộc, tất cả các cam kết trong yêu cầu kéo là
cam kết lại, vì vậy siêu dữ liệu Người cam kết và Ngày cam kết được cập nhật trong
cam kết, hiển thị người đã thực hiện rebase và thời gian của
rebase thay vì các giá trị ban đầu để cung cấp nhiều thông tin hữu ích hơn.
Như một tác dụng phụ, hàm băm của các cam kết sẽ thay đổi.

Nếu xung đột được tìm thấy, lệnh sẽ bị gián đoạn, tương tự như cách git
nổi loạn sẽ làm. Người dùng nên --Huỷ bỏ sự phục hồi, --nhảy các
cam kết xung đột hoặc giải quyết xung đột và --tiếp tục. Khi sử dụng một trong những
những hành động này, bạn phải bỏ qua KÉO tranh luận.

-m Bột ngọt, --message = MSG
Sử dụng thông báo này cho nhận xét thay vì mặc định. Chỉ định một
hộp tin nhắn rỗng (-NS'') để bỏ qua hoàn toàn bình luận.

-e, --chỉnh sửa tin nhắn
Mở mặc định GIT_EDITOR để viết bình luận.

--lực đẩy
Buộc các hoạt động đẩy. Sử dụng cẩn thận!

-P, --tạm ngừng
Tạm dừng rebase ngay trước khi kết quả được đẩy và vấn đề là
đã hợp nhất. Để tiếp tục khôi phục yêu cầu kéo (đẩy các thay đổi
ngược dòng và đóng vấn đề), chỉ cần sử dụng --tiếp tục hoạt động. Cái này
đặc biệt hữu ích để thử nghiệm.

-bạn, --stash-bao gồm-không theo dõi
Vượt qua --bao gồm-không theo dõi tùy chọn để lưu trữ. Nếu sử dụng tất cả không được theo dõi
các tệp cũng được lưu trữ và sau đó được dọn dẹp bằng git clean, để lại
thư mục làm việc ở trạng thái rất sạch, tránh xung đột
khi kiểm tra yêu cầu kéo để rebase.

-một, --dọn dẹp tất cả
Vượt qua --tất cả các tùy chọn để lưu trữ. Giống như --stash-bao gồm-không theo dõi
nhưng các tệp bị bỏ qua được lưu trữ và làm sạch ngoài
các tệp không được kiểm soát, loại bỏ hoàn toàn khả năng
xung đột khi kiểm tra yêu cầu kéo để rebase.

-NS, --xóa chi nhánh
Xóa nhánh yêu cầu kéo nếu rebase thành công. Đây là
tương tự như nhấn nút "Xóa chi nhánh" (TM) trong giao diện web
sau khi hợp nhất.

Hành động:

--tiếp tục
Tiếp tục tái cơ sở đang diễn ra.

--Huỷ bỏ
Hủy bỏ một cơ sở lại đang diễn ra.

--nhảy Bỏ qua bản vá hiện tại trong một cơ sở lại đang diễn ra và tiếp tục.

cập nhật KÉO
Bí danh cho vấn đề cập nhật.

bình luận KÉO
Bí danh cho vấn đề bình luận.

gần KÉO
Bí danh cho vấn đề gần.

CẤU HÌNH

Chương trình này sử dụng các phương tiện cấu hình git để lấy cấu hình của nó. đó là
các phím cấu hình git được sử dụng:

hub.tên người dùng
Tên người dùng GitHub của bạn. [vỡ nợ: hiện hành OS tên truy nhập]

trung tâm.oauthtoken cần phải
Đây là mã thông báo ủy quyền nhận được thông qua thiết lập chỉ huy. Ngay cả khi được yêu cầu,
bạn không cần phải đặt biến này theo cách thủ công. Sử dụng thiết lập lệnh thay thế.

trung tâm.upstream cần phải
Kho lưu trữ phước lành được sử dụng để lấy các vấn đề từ đó và thực hiện các yêu cầu kéo tới. Các
định dạng là /. Tùy chọn này có thể được đặt tự động bởi nhân bản
lệnh và không thực sự được yêu cầu bởi nó hoặc thiết lập chỉ huy.

trung tâm.forkrepo
Ngã ba kho lưu trữ may mắn của bạn. Định dạng là /. Dùng để đặt đầu
cho các yêu cầu kéo của bạn. [vỡ nợ: /(Thượng nguồn phần)]

hub.forkremote
Tên từ xa để truy cập ngã ba của bạn. Dùng để đẩy cành cây trước khi tạo lực kéo
lời yêu cầu. [vỡ nợ: nguồn gốc]

trung tâm.pullbase
Nhánh từ xa mặc định (hoặc tham chiếu git) mà bạn muốn các thay đổi của mình được kéo vào khi
tạo một yêu cầu kéo. [vỡ nợ: chủ]

hub.urltype
Loại URL để sử dụng khi cần một URL từ API GitHub (ví dụ: khi 'pull
rebase 'được sử dụng). Tại thời điểm viết bài, nó có thể là ssh_url or bản sao_url cho
HTTP). Xem tài liệu API của GitHub [1] để biết thêm chi tiết hoặc các tùy chọn. [vỡ nợ:
ssh_url]

trung tâm.baseurl
URL cơ sở của GitHub để sử dụng để truy cập API. Đặt điều này khi bạn sử dụng API GitHub
một vị trí khác với vị trí mặc định (Máy chủ doanh nghiệp thường sử dụng
https://host/api/v3). Điều này sẽ được thêm vào trước tất cả các lệnh gọi API GitHub và nó phải
là một URL đầy đủ, không chỉ là một cái gì đó như "www.example.com/api/v3/".

trung tâm.forcerebase
Nếu được đặt thành "true", --lực lượng sẽ được chuyển đến rebase. Nếu được đặt thành "false" a
rebase thường xuyên được thực hiện. Xem kéo nổi loạn lệnh cho detils. [vỡ nợ:
đúng]

trung tâm.triangular
Làm cho - hình tam giác cho nhân bản nếu được đặt thành "true" (giá trị boolean). Nhìn thấy nhân bản
tài liệu để biết chi tiết.

[1] https://developer.github.com/v3/pulls/#get-a-single-pull-request

Sử dụng git-hub trực tuyến bằng các dịch vụ onworks.net