{"title":"Bekerja dengan Git dan GitHub","version":"4.0","locale":"id","docname":"internals/contributing/writing-code/working-with-git","url":"/id/4.0/internals/contributing/writing-code/working-with-git/","canonical":"https://djangodocs.dev/id/4.0/internals/contributing/writing-code/working-with-git/","summary":"This section explains how the community can contribute code to Django via pull requests. If you're interested in how mergers handle them, see Memperbaiki kode .…","html":"

Bekerja dengan Git dan GitHubLink to this heading#

\n

This section explains how the community can contribute code to Django via pull\nrequests. If you're interested in how mergers handle\nthem, see Memperbaiki kode.

\n

Dibawah ini, kami akan menunjukkan bagaimana membuat pull request GitHub mengandung perubahan untuk tiket Trac #xxxxx. Dengan membuat pull request sepenuhnya siap, anda akan membuat pekerjaan peninjau lebih mudah, berarti bahwa pekerjaan anda lebih mungkin digabungkan kedalam Django.

\n

Anda dapat juga menunggah tambalan tradisional ke Trac, tetapi dia kurang praktis untuk peninjauan.

\n
\n

Memasang GitLink to this heading#

\n

Django menggunakan Git untuk kendali sumbernya. Anda dapat mengunduh Git download, tetapi itu terkadang lebih mudah memasang dengan pengelola paket sistem operasi anda.

\n

Git repository Django disimpan di GitHub, dan itu dianjurkan bahwa anda juga bekerja menggunakan GitHub.

\n

After installing Git, the first thing you should do is set up your name and\nemail:

\n
Code
$ git config --global user.name "Your Real Name"\n$ git config --global user.email "you@email.com"\n
\n

Catat bahwa user.name harus nama asli anda, bukan nama pendek GitHub. GitHub harus tahu surel anda gunakan di bidang user.email, karena ini akan digunakan untuk menghubungkan perbaikan anda ke akun GitHub anda.

\n
\n
\n

Mengatur gudang lokalLink to this heading#

\n

Ketika anda telah membuat akun GitHub anda, dengan nama pendek "GitHub_nick" dan forked Django's repository, buat salinan lokal dari fork anda:

\n
Code
git clone https://github.com/GitHub_nick/django.git\n
\n

Ini akan membuat pelipat baru "django", mengandung kloning dari gudang GitHub anda. Sisa dari perintah git pada halaman ini butuh dijalankan dalam pelipat kloning, jadi ganti ke itu sekarang:

\n
Code
cd django\n
\n

Gudang GitHub anda akan dipanggil "origin" dalam Git.

\n

You should also set up django/django as an "upstream" remote (that is, tell\ngit that the reference Django repository was the source of your fork of it):

\n
Code
git remote add upstream https://github.com/django/django.git\ngit fetch upstream\n
\n

Anda dapat juga menambahkan terpencil lainnya dengan cara yang sama, sebagai contoh:

\n
Code
git remote add akaariai https://github.com/akaariai/django.git\n
\n
\n
\n

Bekerja pada tiketLink to this heading#

\n

When working on a ticket, create a new branch for the work, and base that work\non upstream/main:

\n
Code
git checkout -b ticket_xxxxx upstream/main\n
\n

Bendera -b membuat cabang baru untuk anda secara lokal. Jangan ragu-ragu membuat cabang-cabang baru bahkan untu hal-hal terkecil - itulah apa mereka ada.

\n

Jika malahan anda sedang bekerja untuk perbaikan pada cabang 1.4, anda akan melakukan:

\n
Code
git checkout -b ticket_xxxxx_1_4 upstream/stable/1.4.x\n
\n

Anggap pekerjaan dibawah pada cabang ticket_xxxxx. Buat beberapa perubahan dan perbaiki mereka:

\n
Code
git commit\n
\n

When writing the commit message, follow the commit message\nguidelines to ease the work of the merger. If you're\nuncomfortable with English, try at least to describe precisely what the commit\ndoes.

\n

Jika anda butuh melakukan tambahan pekerjaan pada cabang anda, perbaikan sesering yang diperlukan:

\n
Code
git commit -m 'Added two more tests for edge cases'\n
\n
\n

Menerbitkan pekerjaanLink to this heading#

\n

Anda dapat menerbitkan pekerjaan anda pada GitHub dengan menjalankan:

\n
Code
git push origin ticket_xxxxx\n
\n

Ketika anda pergi ke halaman GitHub, anda akan melihat cabang baru telah dibuat.

\n

Jika anda sedang bekerja pada tiket Trac, anda harus menyebutkan dalam tiket yang pekerjaan anda tersedia dari cabang ticket_xxxxx dari gudang GitHub. Sertakan sebuah tautan pada cabang anda.

\n

Catat bahwa cabang diatas dipanggil "topic branch" di bahasa Git. Anda bebas menulis kembali riwayat dari cabang ini, dengan menggunakan git rebase sebagai contoh. Orang lain tidak harus dasarkan pekerjaan mereka pada cabang seperti itu, karena kloningan mereka akan menjadi rusak ketika anda menyunting perbaikan.

\n

There are also "public branches". These are branches other people are supposed\nto fork, so the history of these branches should never change. Good examples\nof public branches are the main and stable/A.B.x branches in the\ndjango/django repository.

\n

Ketika anda berpikir pekerjaan anda siap untuk ditarik ke Django, anda harus membuat sebuah pull request pada GitHub. Pull request baik artinya:

\n\n

Rangkaian percobaan harus dilewati dan dokumentasi harus dibangun tanpa peringatan.

\n

Sekali anda telah membuat pull request anda, anda harus menambahkan sebuah komentar di tiket Trac terkait menjelaskan apa yang telah anda lakukan. Khususnya, anda harus catat lingkungan dimana anda menjalankan percobaan, sebagai contoh: "semua percobaan lolos dibawah SQLite dan MySQL".

\n

Pull requests at GitHub have only two states: open and closed. The merger who\nwill deal with your pull request has only two options: merge it or close it.\nFor this reason, it isn't useful to make a pull request until the code is ready\nfor merging -- or sufficiently close that a merger will finish it themselves.

\n
\n
\n

Rebase cabang-cabangLink to this heading#

\n

Di contoh diatas, anda membuat dua perbaikan, perbaikan "Fixed ticket_xxxxx" dan perbaikan "Added two more tests".

\n

Kami tidak ingin memiliki seluruh riwayat dari pengolahan pekerjaan anda di gudang anda. Perbaikan anda "Added two more tests" akan menjadi kebisingan yang tidak membantu. Malahan, kami bukan hanya mempunyai satu perbaikan mengandung semua pekerjaan anda.

\n

Untuk bekerja kembali riwayat dari cabang anda anda dapat melumatkan perbaikan kedalam satu dengan menggunakan rebase interaktif:

\n
Code
git rebase -i HEAD~2\n
\n

HEAD~2 diatas adalah tangan cepat untuk dua perbaikan terakhir. Perintah diatas akan membuka sebuah penyunting menunjukkan dua perbaikan, diawali dengan kata "pick".

\n

Rubah "pick" pada baris kedua pada "squash" sebagai gantinya. Ini akan menjaga perbaikan pertama, dan melumat perbaikan kedua kedalam yang pertama. Simpan dan hemtikan penyunting. Jendela penyunting kedua harus terbuka, jadi anda dapat menaruh kata lain pesan perbaikan untuk perbaikan sekarang dimana dia menyertakan kedua langkah-langkah anda.

\n

Anda dapat juga menggunakan pilihan "edit" di rebase. Cara ini anda dapat merubah perbaikan tunggal, sebagai contoh untuk memperbaiki salah ketik dalam docstring:

\n
Code
git rebase -i HEAD~3\n# Choose edit, pick, pick for the commits\n# Now you are able to rework the commit (use git add normally to add changes)\n# When finished, commit work with "--amend" and continue\ngit commit --amend\n# Reword the commit message if needed\ngit rebase --continue\n# The second and third commits should be applied.\n
\n

Jika topik cabang anda sudah diterbitkan pada GitHub, sebagai contoh jika anda sedang membuat perubahan kecil untuk diambil ke tinjauan akun, anda akan butuh mendorong-paksa perubahan:

\n
Code
git push -f origin ticket_xxxxx\n
\n

Catat bahwa ini akan menulis kembali riwayat dari ticket_xxxxx - jika anda memeriksa campuran commit sebelum dan sesudah tindakan pada GitHub anda akan menyadari bahwa campuran commit tidak cocok lagi. Ini dapat diterima, ketika cabang adalah cabang topik, dan tidak seorangpun harus mendasarkan pekerjaannya pada itu.

\n
\n
\n

Setelah upstream telah berubahLink to this heading#

\n

Ketika hulu (django/django) telah berubah, anda harus rebase pekerjaan anda. Untuk melakukan ini, gunakan:

\n
Code
git fetch upstream\ngit rebase\n
\n

The work is automatically rebased using the branch you forked on, in the\nexample case using upstream/main.

\n

Perintah rebase memindahkan semua perbaikan lokal sementara, berlakukan perbaikan upstream, dan kemudian berlakukan perbaikan lokal anda pada pekerjaan.

\n

Jika ada pertentangan penggabungan, anda akan butuh menyelesaikan mereka dan kemudian menggunakan git rebase --continue. Pada tiap titik anda dapat menggunakan git rebase --abort untuk mengembalikan ke keadaan asli.

\n

Catat bahwa anda ingin rebase pada upstream, bukan merge upstream.

\n

Alasan untuk ini adalah dengan rebase, perbaikan anda akan selalu on top of pekerjaan upstream, bukan mixed in with perubahan di upstream. Cara ini cabang anda akan mengandung hanya perbaikan terhubung pada topiknya, yang membuat pelumatan lebiih mudah.

\n
\n
\n

Setelah meninjauLink to this heading#

\n

Itu tidak biasa mendapatkan setiap jumlah bukan sepele dari kode kedalam inti tanpa perubahan diminta oleh peninjau. Di kasus ini, itu adalah sering ide bagus untuk menambahkan perubahan sebagai perbaikan menaik pada pekerjaan anda. Ini mengizinkan peninjau dengan mudah memeriksa perubahan apa anda telah lakukan.

\n

Dalam kasus ini, melakukan perubahan diwajibkan oleh peninjau. Perbaikan sesering kebutuhan. Sebelum menerbitkan perubahan, bangun tingkatan baru pekerjaan anda. Jika anda menambahkan dua perbaikan, anda harus menjalankan:

\n
Code
git rebase -i HEAD~2\n
\n

Lumatkan perbaikan kedua kedalam yang pertama. Tulis sebuah pesan perbaikan bersama baris:

\n
Code
Made changes asked in review by <reviewer>\n\n- Fixed whitespace errors in foobar\n- Reworded the docstring of bar()\n
\n

Akhirnya, kirim kerjaan anda kembali ke gudang GitHub. Sejak anda tidak menyentuk perbaikan umum selama tingkatan dasar baru, anda tidak butuh untuk paksa-kirim:

\n
Code
git push origin ticket_xxxxx\n
\n

Pull request anda sekarang harus mengandung perbaikan baru juga.

\n

Note that the merger is likely to squash the review commit into the previous\ncommit when committing the code.

\n
\n
\n
\n

Bekerja pada tambalanLink to this heading#

\n

Satu cara bahwa pengembang dapat menyumbang ke Django adalah dengan meninjau tambalan-tambalan. Tambalan-tambalan tersebut khususnya ada sebagai pull request pada GitHub dan dapat dengan mudah dipadukan ke dalam gudang lokal anda:

\n
Code
git checkout -b pull_xxxxx upstream/main\ncurl https://github.com/django/django/pull/xxxxx.patch | git am\n
\n

Ini akan membuat cabang baru dan kemudian memberlakukan perubahan dari pull request ke itu. Pada titik ini anda dapat menjalankan percobaan atau melakukan apapun lainnya anda butuhkan untuk menyelidiki kualitas tambalan.

\n

For more detail on working with pull requests see the\nguidelines for mergers.

\n
\n
\n

RingkasanLink to this heading#

\n\n
","rootId":"working-with-git-and-github","toc":[{"title":"Memasang Git","anchor":"installing-git","children":[]},{"title":"Mengatur gudang lokal","anchor":"setting-up-local-repository","children":[]},{"title":"Bekerja pada tiket","anchor":"working-on-a-ticket","children":[{"title":"Menerbitkan pekerjaan","anchor":"publishing-work","children":[]},{"title":"Rebase cabang-cabang","anchor":"rebasing-branches","children":[]},{"title":"Setelah upstream telah berubah","anchor":"after-upstream-has-changed","children":[]},{"title":"Setelah meninjau","anchor":"after-review","children":[]}]},{"title":"Bekerja pada tambalan","anchor":"working-on-a-patch","children":[]},{"title":"Ringkasan","anchor":"summary","children":[]}],"breadcrumbs":[{"docname":"internals/index","title":"Dalam Django","url":"/id/4.0/internals/"},{"docname":"internals/contributing/index","title":"Membantu untuk Django","url":"/id/4.0/internals/contributing/"},{"docname":"internals/contributing/writing-code/index","title":"Penulisan kode","url":"/id/4.0/internals/contributing/writing-code/"}],"prev":{"docname":"internals/contributing/writing-code/submitting-patches","title":"Mengajukan tambalan","url":"/id/4.0/internals/contributing/writing-code/submitting-patches/"},"next":{"docname":"internals/contributing/writing-code/javascript","title":"JavaScript","url":"/id/4.0/internals/contributing/writing-code/javascript/"},"formats":{"html":"/id/4.0/internals/contributing/writing-code/working-with-git/","markdown":"/id/4.0/internals/contributing/writing-code/working-with-git.md","json":"/id/4.0/internals/contributing/writing-code/working-with-git.json"},"source":"https://github.com/django/django/blob/stable/4.0.x/docs/internals/contributing/writing-code/working-with-git.txt","official":"https://docs.djangoproject.com/id/4.0/internals/contributing/writing-code/working-with-git/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}