git-hub - Dalam talian dalam Awan

JADUAL:

NAMA

git-hub - Antara muka baris arahan Git ke GitHub

SINOPSIS

git hub [pilihan global] [pilihan] [hujah]

DESCRIPTION

pergi hab ialah antara muka baris arahan yang ringkas kepada github, membolehkan tugas GitHub yang paling berguna
(seperti membuat dan menyenaraikan permintaan tarik atau isu) untuk diakses terus melalui git
baris perintah.

Untuk menggunakan arahan ini, anda mungkin perlu membuat konfigurasi awal untuk mendapatkan
kebenaran daripada GitHub. Untuk melakukan ini, anda boleh menggunakan persediaan perintah. Lihat
CONFIGURATION bahagian untuk lebih banyak pilihan konfigurasi.

GLOBAL PILIHAN

-h, - membantu
Tunjukkan bantuan ini dan keluar.

--versi
Tunjukkan nombor versi program dan keluar.

-v, --verbose
Bersikap lebih bertele-tele (boleh dinyatakan beberapa kali untuk mendapatkan verbositi tambahan)

-ya, --senyap
Kurang bertele-tele (boleh dinyatakan beberapa kali untuk mendapatkan kurang verbosity)

PERINTAH

persediaan Perintah ini melakukan persediaan awal untuk menyambung ke GitHub. Ia pada dasarnya bertanya
GitHub untuk token kebenaran dan menyimpannya dalam pembolehubah konfigurasi
hub.oauthtoken untuk kegunaan masa hadapan supaya anda tidak perlu menaip kata laluan anda setiap kali (atau
simpannya dalam konfigurasi). Nama pengguna juga disimpan untuk kegunaan masa hadapan dalam
hub.nama pengguna pembolehubah. Jika URL asas ditentukan, ia disimpan dalam hub.baseurl
juga.

-u USERNAME, --username=USERNAME
Nama pengguna GitHub (nama log masuk), akan disimpan dalam pembolehubah konfigurasi
hub.nama pengguna. Jika e-mel disediakan, maka nama pengguna yang sepadan dengan e-mel tersebut
akan dicari dan digunakan sebaliknya, jika dijumpai (untuk ini berfungsi dengan e-mel
mestilah sebahagian daripada profil awam).

-p KATA LALUAN, --kata laluan=KATAlaluan
Kata laluan GitHub (tidak akan disimpan).

-b url, --baseurl=URL
URL asas GitHub untuk digunakan untuk mengakses API. Tetapkan ini apabila API GitHub anda
di lokasi lain selain daripada lalai (Pelayan perusahaan biasanya menggunakan
https://host/api/v3).

--global
Simpan tetapan dalam konfigurasi global (lihat --pilihan global dalam pergi
config(1) untuk maklumat lanjut).

--sistem
Simpan tetapan dalam konfigurasi sistem (lihat --pilihan sistem dalam pergi
config(1) untuk maklumat lanjut).

mengklon REPO [TANGAN]
Perintah ini digunakan untuk mengklon REPO, repositori GitHub, kepada a TANGAN direktori
(lalai kepada nama projek yang diklon). Jika repositori ditentukan
in / bentuk, yang REPO akan digunakan sebagai hulu dan garpu peribadi
akan dipandang tinggi. Jika tiada yang ditemui, garpu baharu akan dibuat. Dalam kedua-dua kes, yang
garpu akan diklon dan bukannya repositori huluan.

Kalaulah dinyatakan sebagai REPO, kemudian konfigurasi hub.nama pengguna digunakan
as , dan repositori induk dicari di GitHub untuk menentukan yang sebenar
repositori hulu.

Repositori huluan juga ditambah sebagai alat kawalan jauh dengan nama huluan (melainkan
--segi tiga digunakan, dalam hal ini alat kawalan jauh dipanggil garpu secara lalai) dan
hub.hulu pembolehubah konfigurasi ditetapkan (lihat CONFIGURATION), melainkan sahaja
telah digunakan dan repositori yang terhasil bukanlah garpu, dalam hal ini
adalah mustahil untuk menentukan repositori huluan secara automatik.

-r NAMA, --remote=NAME
Penggunaan NAMA sebagai nama repositori jauh huluan dan bukannya nama lalai
('garpu' jika --segi tiga digunakan, 'hulu' sebaliknya).

-t, --segi tiga
Gunakan Git's segi tiga aliran kerja konfigurasi. Pilihan ini mengklon daripada
repositori induk/hulu bukannya mengkloning garpu, dan menambah garpu sebagai
repositori jauh. Kemudian menetapkan remote.pushdefault Pilihan Git dan
hub.forkremote pilihan git-hub ke garpu.

Kesan ini mempunyai repositori huluan yang digunakan secara lalai apabila anda
tarik tetapi menggunakan garpu anda apabila anda menolak, yang biasanya anda mahukan
apabila menggunakan permintaan tarik GitHub.

Git versi 1.8.3 atau lebih baharu diperlukan untuk menggunakan pilihan ini (dan 1.8.4 atau lebih baharu
disyorkan kerana beberapa isu dalam 1.8.3 yang berkaitan dengan ini).

Pilihan ini mungkin menjadi lalai pada masa hadapan. Untuk menjadikannya lalai
anda boleh menetapkan pilihan hub.segi tiga. Lihat CONFIGURATION untuk maklumat lanjut.

GIT KLON PILIHAN
Mana-mana standard pergi mengklon pilihan boleh dilalui. Tidak semua daripada mereka mungkin membuat
rasa apabila mengklon repo GitHub untuk digunakan dengan alat ini walaupun.

isu Perintah ini digunakan untuk mengurus isu GitHub melalui set subperintah. Adakah tidak
subperintah ditentukan, senarai digunakan.

senarai Tunjukkan senarai isu terbuka.

-c, --ditutup
Tunjukkan isu tertutup sebaliknya.

-C, --dicipta-oleh-saya
Tunjukkan hanya isu yang dibuat oleh saya

-A, --ditugaskan-kepada-saya
Tunjukkan hanya isu yang diberikan kepada saya

Menunjukkan ISU [ISU ...]
Tunjukkan isu yang dikenal pasti oleh ISU.

baru Buat isu baharu.

-m MSG, --mesej=MSG
Tajuk isu (dan huraian). Baris pertama digunakan sebagai isu
tajuk dan sebarang teks selepas baris kosong digunakan sebagai badan pilihan.
Jika pilihan ini tidak digunakan, pilihan lalai GIT_EDITOR dibuka untuk menulis
one.

-l LABEL, --label=LABEL
Lampirkan LABEL kepada isu (boleh ditentukan beberapa kali untuk ditetapkan
berbilang label).

-a PENGGUNA, --assign=USER
Tetapkan pengguna kepada isu tersebut. PENGGUNA mestilah nama log masuk GitHub yang sah.

-M ID, --milestone=ID
Tetapkan peristiwa penting yang dikenal pasti oleh ID nombor kepada isu itu.

maklumat ISU
Sama seperti baru tetapi kemas kini isu sedia ada yang dikenal pasti oleh ISU.

Jalan pintas yang mudah untuk menutup isu disediakan oleh rapat subperintah.

-m MSG, --mesej=MSG
Tajuk isu baharu (dan huraian). Baris pertama digunakan sebagai
tajuk keluaran dan sebarang teks selepas baris kosong digunakan sebagai pilihan
badan.

-e, --edit-mesej
Buka lalai GIT_EDITOR untuk mengedit tajuk semasa (dan
penerangan) tentang isu tersebut.

-o, --buka
Buka semula isu tersebut.

-c, --tutup
Tutup isu.

-l LABEL, --label=LABEL
Jika satu atau lebih label dinyatakan, ia akan menggantikan arus
mengeluarkan label. Jika tidak, label tidak berubah. Jika salah satu daripada
label kosong, label akan dikosongkan (supaya anda boleh menggunakan -l'' kepada
kosongkan label sesuatu isu.

-a PENGGUNA, --assign=USER
Tetapkan pengguna kepada isu tersebut. PENGGUNA mestilah nama log masuk GitHub yang sah.

-M ID, --milestone=ID
Tetapkan peristiwa penting yang dikenal pasti oleh ID nombor kepada isu itu.

komen ISU
Tambahkan ulasan baharu pada isu sedia ada yang dikenal pasti oleh ISU.

-m MSG, --mesej=MSG
Komen untuk ditambahkan pada isu tersebut. Jika pilihan ini tidak digunakan,
lalai GIT_EDITOR dibuka untuk menulis komen.

rapat ISU
Alias ​​untuk maklumat --tutup. (+ komen if --mesej or --edit-mesej is
ditentukan). Menutup isu yang dikenal pasti oleh ISU.

-m MSG, --mesej=MSG
Tambahkan ulasan pada isu sebelum menutupnya.

-e, --edit-mesej
Buka lalai GIT_EDITOR untuk menulis ulasan untuk ditambahkan pada
isu sebelum menutupnya.

tarik Perintah ini digunakan untuk mengurus permintaan tarik GitHub. Sejak permintaan tarik dalam GitHub
juga merupakan isu, kebanyakan subperintah diulang daripada isu perintah untuk
kemudahan. Hanya yang senarai and baru arahan benar-benar berbeza, dan melampirkan and
melunaskan semula ditambah.

senarai Tunjukkan senarai permintaan tarik terbuka.

--ditutup
Sebaliknya, tunjukkan permintaan tarik tertutup.

Menunjukkan PULL [TARIK ...]
Alias ​​untuk isu Menunjukkan.

checkout PULL ...
Semak cawangan jauh (kepala) permintaan tarik. Perintah ini dahulu
mengambil kepala rujukan daripada permintaan tarik dan kemudian memanggil standard
pergi checkout perintah dan sebarang hujah tambahan akan diserahkan kepada pergi checkout
apa adanya, selepas rujukan yang baru diambil. Ingat ini mewujudkan a
daftar keluar berasingan secara lalai, gunakan -b jika anda ingin membuat cawangan baru
berdasarkan permintaan tarik. Sila lihat pergi checkout membantu untuk lebih
butiran.

baru [KEPALA]
Buat permintaan tarik baharu. Jika KETUA ditentukan, ia akan digunakan sebagai
cawangan (atau git ref) tempat perubahan anda dilaksanakan. Jika tidak
cawangan semasa digunakan. Jika dahan yang digunakan sebagai kepala tidak ditolak ke anda
jarak jauh garpu, tolakan akan dilakukan secara automatik sebelum membuat tarikan
Permintaan.

Repositori untuk mengeluarkan permintaan tarik daripada diambil dari hub.forkrepo
konfigurasi, yang lalai kepada hub.username/ projek bahagian>.

-m MSG, --mesej=MSG
Tajuk permintaan tarik (dan huraian). Baris pertama digunakan sebagai
tarik tajuk permintaan dan sebarang teks selepas baris kosong digunakan sebagai
badan pilihan. Jika pilihan ini tidak digunakan, pilihan lalai GIT_EDITOR is
dibuka. Jika cawangan HEAD mempunyai penerangan yang betul (lihat pergi cawangan
--edit-huraian), perihalan itu akan digunakan sebagai lalai
mesej dalam editor dan jika tidak, mesej komit terakhir akan
digunakan sebaliknya.

-b ASAS, --base=BASE
Cawangan (atau git ref) yang anda mahu perubahan anda ditarik masuk. Secara lalainya
cawangan pengesanan (cawangan. .gabung pembolehubah konfigurasi) digunakan
atau konfigurasi hub.pullbase jika tidak menjejaki cawangan terpencil. Jika
tiada yang hadir, ia lalai kepada master. Repositori untuk digunakan sebagai
asas diambil daripada hub.hulu konfigurasi.

-c NAMA, --create-branch=NAME
Buat cawangan jauh baharu dengan (dengan nama NAMA) sebagai ketua sebenar untuk
permintaan tarik dan bukannya menggunakan nama HEAD diluluskan sebagai KETUA. ini
berguna untuk membuat permintaan tarik untuk pembaikan panas yang anda komited
HEAD biasa anda tanpa membuat cawangan terlebih dahulu.

-f, --tolak-paksa
Paksa operasi tolak. Gunakan dengan berhati-hati!

melampirkan ISU [KEPALA]
Tukar isu yang dikenal pasti oleh ISU kepada permintaan tarik dengan melampirkan komit
kepadanya. Cawangan (atau git ref) tempat perubahan anda dilaksanakan boleh
secara pilihan ditentukan dengan KETUA (jika tidak, cawangan semasa digunakan). ini
subperintah sangat serupa dengan baru subperintah, sila rujuk kepadanya untuk
maklumat lanjut.

Sila ambil perhatian bahawa anda hanya boleh melampirkan komitmen kepada isu jika anda mempunyai akses komit
ke repositori atau jika anda ditugaskan untuk isu tersebut.

-m MSG, --mesej=MSG
Tambahkan ulasan pada isu/permintaan tarik baharu.

-e, --edit-mesej
Buka lalai GIT_EDITOR untuk menulis ulasan untuk ditambahkan pada
isu/permintaan tarik baharu. Mesej lalai diambil daripada
--mesej pilihan jika ada, jika tidak penerangan cawangan atau
mesej komit pertama digunakan seperti dengan baru subperintah.

-b ASAS, --base=BASE
Cawangan asas yang mengeluarkan permintaan tarik. Jika pilihan ini tidak
hadir, maka cabang asas diambil daripada konfigurasi
hub.pullbase (atau hanya master jika konfigurasi itu tidak ada
sama ada). Repositori untuk digunakan sebagai pangkalan diambil dari
hub.hulu konfigurasi.

-c NAMA, --create-branch=NAME
Buat cawangan jauh baharu dengan (dengan nama NAMA) sebagai ketua sebenar untuk
permintaan tarik dan bukannya menggunakan nama HEAD diluluskan sebagai KETUA. ini
berguna untuk membuat permintaan tarik untuk pembaikan panas yang anda komited
HEAD biasa anda tanpa membuat cawangan terlebih dahulu.

-f, --tolak-paksa
Paksa operasi tolak. Gunakan dengan berhati-hati!

melunaskan semula PULL
Tutup permintaan tarik yang dikenal pasti oleh PULL dengan mengasaskan semula cawangan asasnya
(dinyatakan dalam permintaan tarik) dan bukannya bergabung sebagai GitHub Bergabung Butang™
akan lakukan.

Jika operasi berjaya, ulasan akan disiarkan memaklumkan yang baharu
KEPALA komit cawangan yang telah berasaskan semula dan permintaan tarik akan
tertutup.

Jenis URL yang digunakan untuk mengambil dan menolak boleh ditentukan melalui
hub.pullurltype pembolehubah konfigurasi (lihat CONFIGURATION untuk maklumat lanjut).
Salinan kerja anda harus kekal sama idealnya, jika semuanya berjalan lancar.

Operasi yang dilakukan oleh subperintah ini kira-kira ini:

1. git simpanan

2. git fetch kepala tarik

3. git checkout -b tmp FETCH_HEAD

4. git pull --rebase asas tarik

5.git tolak asas tarik

6. git checkout kepala tua

7. cawangan git -D tmp

8. git simpanan pop

If hub.forcerebase ditetapkan kepada "benar" (lalai), - kekuatan akan diserahkan kepada
rebase (jangan dikelirukan dengan pilihan arahan ini --tolak-paksa yang akan
paksa tolakan), jika tidak (jika "salah") pangkalan semula biasa dilakukan.
Apabila rebase dipaksa, semua komitmen dalam permintaan tarik adalah
komited semula, jadi metadata Committer dan CommitterDate dikemas kini dalam
commits, menunjukkan orang yang melakukan rebase dan masa
rebase dan bukannya nilai asal, jadi menyediakan maklumat yang lebih berguna.
Sebagai kesan sampingan, cincang komit akan berubah.

Jika konflik ditemui, arahan akan terganggu, sama seperti bagaimana pergi
melunaskan semula akan lakukan. Pengguna harus sama ada --menggugurkan kandungan pengasas semula, --langkau yang
bercanggah melakukan atau menyelesaikan konflik dan --sambung. Apabila menggunakan salah satu daripada
tindakan ini, anda perlu meninggalkan PULL hujah.

-m MSG, --mesej=MSG
Gunakan mesej ini untuk ulasan dan bukannya lalai. Nyatakan satu
mesej kosong (-m'') untuk meninggalkan komen sepenuhnya.

-e, --edit-mesej
Buka lalai GIT_EDITOR untuk menulis komen.

--tolak-paksa
Paksa operasi tolak. Gunakan dengan berhati-hati!

-p, --jeda
Jeda pangkalan semula sejurus sebelum keputusan ditolak dan isunya adalah
digabungkan. Untuk menyambung semula pengasingan semula permintaan tarik (tolak perubahan
huluan dan tutup isu), hanya gunakan --sambung tindakan. ini
amat berguna untuk ujian.

-u, --simpan-include-untracked
Melepasi --termasuk-tidak dijejaki pilihan untuk menyimpan. Jika digunakan semua tidak dijejaki
fail juga disimpan dan kemudian dibersihkan dengan git clean, meninggalkan
direktori kerja dalam keadaan yang sangat bersih, yang mengelakkan konflik
apabila menyemak permintaan tarik untuk pangkalan semula.

-A, --simpan-semua
Melepasi --semua pilihan untuk menyimpan. Adalah seperti --simpan-include-untracked
tetapi fail yang diabaikan disimpan dan dibersihkan sebagai tambahan kepada
fail yang tidak dijejaki, yang menghapuskan sepenuhnya kemungkinan
konflik apabila menyemak permintaan tarik untuk pangkalan semula.

-D, --padam-cawangan
Padamkan cawangan permintaan tarik jika pangkalan semula berjaya. Ini adalah
sama seperti menekan Butang "Padam Cawangan" (TM) dalam antara muka web
selepas bergabung.

Tindakan:

--sambung
Teruskan pangkalan semula yang berterusan.

--menggugurkan kandungan
Hentikan rebase yang berterusan.

--langkau Langkau tampung semasa dalam pangkalan semula yang sedang berjalan dan teruskan.

maklumat PULL
Alias ​​untuk isu maklumat.

komen PULL
Alias ​​untuk isu komen.

rapat PULL
Alias ​​untuk isu rapat.

CONFIGURATION

Program ini menggunakan kemudahan konfigurasi git untuk mendapatkan konfigurasinya. Ini adalah
kekunci konfigurasi git digunakan:

hub.nama pengguna
Nama pengguna GitHub anda. [lalai: semasa OS nama pengguna]

hub.oauthtoken dikehendaki
Ini ialah token kebenaran yang diperolehi melalui persediaan perintah. Walaupun diperlukan,
anda tidak perlu menetapkan pembolehubah ini secara manual. Menggunakan persediaan arahan sebaliknya.

hub.hulu dikehendaki
Repositori yang diberkati digunakan untuk mendapatkan isu daripada dan membuat permintaan tarik ke. The
format ialah /. Pilihan ini boleh ditetapkan secara automatik oleh mengklon
perintah dan tidak benar-benar diperlukan olehnya atau persediaan perintah.

hub.forkrepo
Garpu repositori anda yang diberkati. Formatnya ialah /. Digunakan untuk menetapkan kepala
untuk permintaan tarik anda. [lalai: /(hulu bahagian)]

hub.forkremote
Nama jauh untuk mengakses garpu anda. Digunakan untuk menolak dahan sebelum membuat tarikan
permintaan. [lalai: asal]

hub.pullbase
Cawangan terpencil lalai (atau rujukan git) anda mahu perubahan anda ditarik ke bila
mencipta permintaan tarik. [lalai: master]

hub.urltype
Jenis URL untuk digunakan apabila URL daripada API GitHub diperlukan (contohnya, apabila 'pull
rebase' digunakan). Pada masa penulisan boleh jadi ssh_url or clone_url khususnya
HTTP). Lihat dokumentasi API GitHub[1] untuk mendapatkan butiran atau pilihan lanjut. [lalai:
ssh_url]

hub.baseurl
URL asas GitHub untuk digunakan untuk mengakses API. Tetapkan ini apabila anda menggunakan API GitHub
lokasi lain selain daripada lalai (Pelayan perusahaan biasanya menggunakan
https://host/api/v3). Ini akan ditambah kepada semua panggilan API GitHub dan ia perlu
menjadi URL penuh, bukan hanya sesuatu seperti "www.example.com/api/v3/".

hub.forcerebase
Jika ditetapkan kepada "benar", - kekuatan akan diluluskan untuk pangkalan semula. Jika ditetapkan kepada "palsu" a
rebase biasa dilakukan. Lihat tarik melunaskan semula arahan untuk detils. [lalai:
benar]

hub.segi tiga
Membuat --segi tiga khususnya mengklon jika ditetapkan kepada "benar" (nilai boolean). Lihat mengklon
dokumentasi untuk perincian.

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

Gunakan git-hub dalam talian menggunakan perkhidmatan onworks.net